chore(engine, render): 🤖 update $CTX define

affects: engine, render

Author: hlerenow

packages/engine/src/component/CustomSchemaForm/components/Setters/FunctionSetter/defaultDts.ts

@@ -41,25 +41,29 @@ type ContextType = {
   getGlobalState?: () => Record<any, any>;
   /** 更新全局状态 */
   updateGlobalState?: (newState: any) => void;
-  /** 存储当前节点的数据，不具有响应性 **/
+  /** 存储当前节点的数据，不具有响应性, 可能不是最新的值 **/
   staticVar?: Record<string | number, any>;
+  /** 获取当前节点的静态变量，不具有响应性 */
   getStaticVar?: () => Record<string, any>;
-  getStaticVarById?: (nodeId: string) => Record<string, any>;
+  getStaticVarById?: (/** 节点 id */ nodeId: string) => Record<string, any>;
   methods?: Record<string, (...arg: any) => any>;
+  /** 获取当前节点的方法，不具有响应性 */
   getMethods?: () => Record<string, (...arg: any) => any>;
-  getMethodsById?: (nodeId: string) => Record<string, (...arg: any) => any>;
+  getMethodsById?: (/** 节点 id */ nodeId: string) => Record<string, (...arg: any) => any>;
   /** 当前节点状态 **/
   state?: Record<any, any>;
   /** 更新当前节点状态 */
   updateState?: (newState: any) => void;
+  /** 获取当前节点状态最新 */
   getState?: () => Record<any, any>;
-  getStateById?: (nodeId: string) => Record<any, any>;
-  updateStateById?: (nodeId: string, newState: Record<any, any>) => void;
+  getStateById?: (/** 节点 id */ nodeId: string) => Record<any, any>;
+  updateStateById?: (/** 节点 id */ nodeId: string, newState: Record<any, any>) => void;
+  /** 一次性返回最新的 state 以及更新的方法 */
   getStateObj?: () => {
     state?: Record<any, any>;
     updateState?: (newState: any) => void;
   };
-  getStateObjById?: (nodeId: string) => {
+  getStateObjById?: (/** 节点 id */ nodeId: string) => {
     state?: Record<any, any>;
     updateState?: (newState: any) => void;
   };
@@ -73,14 +77,20 @@ type ContextType = {
   >;
   /** 循环数据 */
   loopData?: Record<any, any>;
-  /** 组件节点的 Ref */
-  nodeRefs?: { get: (nodeId: string) => any };
+  /** 组件节点的 Ref, 可以通过 current 直接调用节点提供的方法，需要判断是否在存在 */
+  nodeRefs?: { get: (/** 节点 id */ nodeId: string) => { current?: any } };
+  /** 运行时全局的 store 管理 */
   storeManager?: StoreManager;
   /** 第三方辅助库 */
   thirdLibs?: Record<string, any>;
 };
 
 /** 渲染上下文 */
 declare global {
+  /** 运行时上下文
+   * @deprecated
+   */
   const $$context: ContextType;
+  /** 运行时上下文 */
+  const $CTX: ContextType;
 }

packages/engine/src/component/CustomSchemaForm/components/Setters/FunctionSetter/index.tsx

@@ -64,7 +64,7 @@ export const FunctionSetter: CSetter<any> = ({
       onDidMount={(editor) => {
         editorRef.current = editor;
       }}
-      initialValue={props.value?.value ?? (initialValue || '')}
+      initialValue={props.value?.value ?? (initialValue || 'function run() {\n}')}
       language={'javascript'}
       options={{
         automaticLayout: true,

packages/render/src/util/index.ts

@@ -51,6 +51,7 @@ export const runExpression = (expStr: string, context: any) => {
       return `const ${key} = $$context['${key}'];`;
     });
     const executeCode = `
+    $CTX = $$context;
     ${contextVar.join('\n')}
     return ${expStr};
     `;
@@ -100,6 +101,7 @@ export const convertCodeStringToFunction = (params: {
     var extraParams = $$$__args__$$$.pop();
     var __$$storeManager__ = extraParams.storeManager;
     var $$context =  extraParams.$$context;
+    var $CTX =  extraParams.$$context;
     var $$response =  extraParams.$$response;
     var $$actionVariableSpace = extraParams.actionVariableSpace;
     $$context.stateManager = __$$storeManager__.getStateSnapshot();