@flowgram.ai/variable-core 0.1.0-alpha.7 → 0.1.0-alpha.8

package/dist/esm/index.js

@@ -16,7 +16,7 @@ import { ContainerModule } from "inversify";
 // src/variable-engine.ts
 import { Subject as Subject5 } from "rxjs";
 import { inject as inject2, injectable as injectable3, preDestroy } from "inversify";
-import { Disposable as Disposable6, DisposableCollection as DisposableCollection5 } from "@flowgram.ai/utils";
+import { Disposable as Disposable4, DisposableCollection as DisposableCollection5 } from "@flowgram.ai/utils";
 import { Emitter as Emitter3 } from "@flowgram.ai/utils";
 
 // src/utils/toDisposable.tsx
@@ -47,9 +47,121 @@ var createMemo = () => {
   return memo;
 };
 
+// src/scope/variable-table.ts
+import { Subject, merge, share, skip, switchMap } from "rxjs";
+import { DisposableCollection, Emitter } from "@flowgram.ai/utils";
+var VariableTable = class {
+  constructor(parentTable) {
+    this.parentTable = parentTable;
+    this.table = /* @__PURE__ */ new Map();
+    this.onDataChangeEmitter = new Emitter();
+    this.variables$ = new Subject();
+    // 监听变量列表中的单个变量变化
+    this.anyVariableChange$ = this.variables$.pipe(
+      switchMap(
+        (_variables) => merge(
+          ..._variables.map(
+            (_v) => _v.value$.pipe(
+              // 跳过 BehaviorSubject 第一个
+              skip(1)
+            )
+          )
+        )
+      ),
+      share()
+    );
+    this.onDataChange = this.onDataChangeEmitter.event;
+    this._version = 0;
+  }
+  /**
+   * 监听任意变量变化
+   * @param observer 监听器，变量变化时会吐出值
+   * @returns
+   */
+  onAnyVariableChange(observer) {
+    return subsToDisposable(this.anyVariableChange$.subscribe(observer));
+  }
+  /**
+   * 列表或者任意变量变化
+   * @param observer
+   */
+  onAnyChange(observer) {
+    const disposables = new DisposableCollection();
+    disposables.pushAll([this.onDataChange(observer), this.onAnyVariableChange(observer)]);
+    return disposables;
+  }
+  fireChange() {
+    var _a;
+    this._version++;
+    this.onDataChangeEmitter.fire();
+    (_a = this.parentTable) == null ? void 0 : _a.fireChange();
+  }
+  get version() {
+    return this._version;
+  }
+  get variables() {
+    return Array.from(this.table.values());
+  }
+  get variableKeys() {
+    return Array.from(this.table.keys());
+  }
+  /**
+   * 根据 keyPath 找到对应的变量，或 Property 节点
+   * @param keyPath
+   * @returns
+   */
+  getByKeyPath(keyPath) {
+    const [variableKey, ...propertyKeys] = keyPath || [];
+    if (!variableKey) {
+      return;
+    }
+    const variable = this.getVariableByKey(variableKey);
+    return propertyKeys.length ? variable == null ? void 0 : variable.getByKeyPath(propertyKeys) : variable;
+  }
+  /**
+   * 根据 key 值找到相应的变量
+   * @param key
+   * @returns
+   */
+  getVariableByKey(key) {
+    return this.table.get(key);
+  }
+  /**
+   * 往 variableTable 添加输出变量
+   * @param variable
+   */
+  addVariableToTable(variable) {
+    this.table.set(variable.key, variable);
+    if (this.parentTable) {
+      this.parentTable.addVariableToTable(variable);
+    }
+    this.variables$.next(this.variables);
+  }
+  /**
+   * 从 variableTable 中移除变量
+   * @param key
+   */
+  removeVariableFromTable(key) {
+    this.table.delete(key);
+    if (this.parentTable) {
+      this.parentTable.removeVariableFromTable(key);
+    }
+    this.variables$.next(this.variables);
+  }
+  dispose() {
+    this.variableKeys.forEach(
+      (_key) => {
+        var _a;
+        return (_a = this.parentTable) == null ? void 0 : _a.removeVariableFromTable(_key);
+      }
+    );
+    this.onDataChangeEmitter.dispose();
+  }
+};
+
 // src/scope/scope-chain.ts
 import { inject, injectable } from "inversify";
-import { DisposableCollection } from "@flowgram.ai/utils";
+import { DisposableCollection as DisposableCollection2 } from "@flowgram.ai/utils";
 
 // src/providers.ts
 var VariableEngineProvider = Symbol("DynamicVariableEngine");
@@ -58,7 +170,7 @@ var ContainerProvider = Symbol("ContainerProvider");
 // src/scope/scope-chain.ts
 var ScopeChain = class {
   constructor() {
-    this.toDispose = new DisposableCollection();
+    this.toDispose = new DisposableCollection2();
   }
   get variableEngine() {
     return this.variableEngineProvider();
@@ -109,7 +221,7 @@ var ASTKind = /* @__PURE__ */ ((ASTKind2) => {
   ASTKind2["VariableDeclarationList"] = "VariableDeclarationList";
   ASTKind2["KeyPathExpression"] = "KeyPathExpression";
   ASTKind2["EnumerateExpression"] = "EnumerateExpression";
-  ASTKind2["ExpressionList"] = "ExpressionList";
+  ASTKind2["WrapArrayExpression"] = "WrapArrayExpression";
   ASTKind2["ListNode"] = "ListNode";
   ASTKind2["DataNode"] = "DataNode";
   ASTKind2["MapNode"] = "MapNode";
@@ -151,21 +263,21 @@ var postConstructAST = () => (target, propertyKey) => {
 // src/ast/match.ts
 var ASTMatch;
 ((ASTMatch2) => {
-  ASTMatch2.isString = (node) => node?.kind === "String" /* String */;
-  ASTMatch2.isNumber = (node) => node?.kind === "Number" /* Number */;
-  ASTMatch2.isBoolean = (node) => node?.kind === "Boolean" /* Boolean */;
-  ASTMatch2.isInteger = (node) => node?.kind === "Integer" /* Integer */;
-  ASTMatch2.isObject = (node) => node?.kind === "Object" /* Object */;
-  ASTMatch2.isArray = (node) => node?.kind === "Array" /* Array */;
-  ASTMatch2.isMap = (node) => node?.kind === "Map" /* Map */;
-  ASTMatch2.isCustomType = (node) => node?.kind === "CustomType" /* CustomType */;
-  ASTMatch2.isVariableDeclaration = (node) => node?.kind === "VariableDeclaration" /* VariableDeclaration */;
-  ASTMatch2.isProperty = (node) => node?.kind === "Property" /* Property */;
-  ASTMatch2.isVariableDeclarationList = (node) => node?.kind === "VariableDeclarationList" /* VariableDeclarationList */;
-  ASTMatch2.isEnumerateExpression = (node) => node?.kind === "EnumerateExpression" /* EnumerateExpression */;
-  ASTMatch2.isKeyPathExpression = (node) => node?.kind === "KeyPathExpression" /* KeyPathExpression */;
+  ASTMatch2.isString = (node) => (node == null ? void 0 : node.kind) === "String" /* String */;
+  ASTMatch2.isNumber = (node) => (node == null ? void 0 : node.kind) === "Number" /* Number */;
+  ASTMatch2.isBoolean = (node) => (node == null ? void 0 : node.kind) === "Boolean" /* Boolean */;
+  ASTMatch2.isInteger = (node) => (node == null ? void 0 : node.kind) === "Integer" /* Integer */;
+  ASTMatch2.isObject = (node) => (node == null ? void 0 : node.kind) === "Object" /* Object */;
+  ASTMatch2.isArray = (node) => (node == null ? void 0 : node.kind) === "Array" /* Array */;
+  ASTMatch2.isMap = (node) => (node == null ? void 0 : node.kind) === "Map" /* Map */;
+  ASTMatch2.isCustomType = (node) => (node == null ? void 0 : node.kind) === "CustomType" /* CustomType */;
+  ASTMatch2.isVariableDeclaration = (node) => (node == null ? void 0 : node.kind) === "VariableDeclaration" /* VariableDeclaration */;
+  ASTMatch2.isProperty = (node) => (node == null ? void 0 : node.kind) === "Property" /* Property */;
+  ASTMatch2.isVariableDeclarationList = (node) => (node == null ? void 0 : node.kind) === "VariableDeclarationList" /* VariableDeclarationList */;
+  ASTMatch2.isEnumerateExpression = (node) => (node == null ? void 0 : node.kind) === "EnumerateExpression" /* EnumerateExpression */;
+  ASTMatch2.isKeyPathExpression = (node) => (node == null ? void 0 : node.kind) === "KeyPathExpression" /* KeyPathExpression */;
   function is(node, targetType) {
-    return node?.kind === targetType?.kind;
+    return (node == null ? void 0 : node.kind) === (targetType == null ? void 0 : targetType.kind);
   }
   ASTMatch2.is = is;
 })(ASTMatch || (ASTMatch = {}));
@@ -178,8 +290,8 @@ function updateChildNodeHelper({
   nextJSON
 }) {
   const currNode = getChildNode();
-  const isNewKind = currNode?.kind !== nextJSON?.kind;
-  const isNewKey = nextJSON?.key && nextJSON?.key !== currNode?.key;
+  const isNewKind = (currNode == null ? void 0 : currNode.kind) !== (nextJSON == null ? void 0 : nextJSON.kind);
+  const isNewKey = (nextJSON == null ? void 0 : nextJSON.key) && (nextJSON == null ? void 0 : nextJSON.key) !== (currNode == null ? void 0 : currNode.key);
   if (isNewKind || isNewKey) {
     if (currNode) {
       currNode.dispose();
@@ -194,7 +306,7 @@ function updateChildNodeHelper({
       this.fireChange();
     }
   } else if (nextJSON) {
-    currNode?.fromJSON(nextJSON);
+    currNode == null ? void 0 : currNode.fromJSON(nextJSON);
   }
   return currNode;
 }
@@ -228,12 +340,12 @@ import {
   debounceTime,
   distinctUntilChanged,
   map,
-  skip,
+  skip as skip2,
   tap
 } from "rxjs";
 import { nanoid } from "nanoid";
 import { shallowEqual } from "fast-equals";
-import { Disposable as Disposable2, DisposableCollection as DisposableCollection2 } from "@flowgram.ai/utils";
+import { Disposable as Disposable2, DisposableCollection as DisposableCollection3 } from "@flowgram.ai/utils";
 var ASTNode = class _ASTNode {
   /**
    * 构造函数
@@ -272,9 +384,10 @@ var ASTNode = class _ASTNode {
     /**
      * 删除节点处理事件列表
      */
-    this.toDispose = new DisposableCollection2(
+    this.toDispose = new DisposableCollection3(
       Disposable2.create(() => {
-        this.parent?.fireChange();
+        var _a;
+        (_a = this.parent) == null ? void 0 : _a.fireChange();
         this.children.forEach((child) => child.dispose());
       })
     );
@@ -370,6 +483,7 @@ var ASTNode = class _ASTNode {
    * 触发当前节点更新
    */
   fireChange() {
+    var _a;
     if (this.changeLocked || this.disposed) {
       return;
     }
@@ -380,7 +494,7 @@ var ASTNode = class _ASTNode {
     this._version++;
     this.value$.next(this);
     this.dispatchGlobalEvent({ type: "UpdateAST" });
-    this.parent?.fireChange();
+    (_a = this.parent) == null ? void 0 : _a.fireChange();
   }
   /**
    * 节点的版本值
@@ -415,7 +529,7 @@ var ASTNode = class _ASTNode {
           }
         ),
         // 默认跳过 BehaviorSubject 第一次触发
-        triggerOnInit ? tap(() => null) : skip(1),
+        triggerOnInit ? tap(() => null) : skip2(1),
         // 每个 animationFrame 内所有更新合并成一个
         debounceAnimation ? debounceTime(0, animationFrameScheduler) : tap(() => null)
       ).subscribe(observer)
@@ -451,17 +565,18 @@ var BaseType = class extends ASTNode {
     this.flags = 8 /* BasicType */;
   }
   /**
-   * 类型是否一致，节点有额外信息判断，请参考 extraTypeInfoEqual
+   * 类型是否一致
    * @param targetTypeJSON
    */
   isTypeEqual(targetTypeJSONOrKind) {
+    var _a;
     const targetTypeJSON = parseTypeJsonOrKind(targetTypeJSONOrKind);
-    if (targetTypeJSON?.kind === "Union" /* Union */) {
-      return (targetTypeJSON?.types || [])?.some(
+    if ((targetTypeJSON == null ? void 0 : targetTypeJSON.kind) === "Union" /* Union */) {
+      return (_a = (targetTypeJSON == null ? void 0 : targetTypeJSON.types) || []) == null ? void 0 : _a.some(
         (_subType) => this.isTypeEqual(_subType)
       );
     }
-    return this.kind === targetTypeJSON?.kind;
+    return this.kind === (targetTypeJSON == null ? void 0 : targetTypeJSON.kind);
   }
   /**
    * 可下钻类型需实现
@@ -470,6 +585,10 @@ var BaseType = class extends ASTNode {
   getByKeyPath(keyPath = []) {
     throw new Error(`Get By Key Path is not implemented for Type: ${this.kind}`);
   }
+  /**
+   * Get AST JSON for current base type
+   * @returns
+   */
   toJSON() {
     return {
       kind: this.kind
@@ -488,7 +607,8 @@ var ArrayType = class extends BaseType {
   }
   // items 类型是否可下钻
   get canDrilldownItems() {
-    return !!(this.items?.flags & 16 /* DrilldownType */);
+    var _a;
+    return !!(((_a = this.items) == null ? void 0 : _a.flags) & 16 /* DrilldownType */);
   }
   getByKeyPath(keyPath) {
     const [curr, ...rest] = keyPath || [];
@@ -500,11 +620,11 @@ var ArrayType = class extends BaseType {
   isTypeEqual(targetTypeJSONOrKind) {
     const targetTypeJSON = parseTypeJsonOrKind(targetTypeJSONOrKind);
     const isSuperEqual = super.isTypeEqual(targetTypeJSONOrKind);
-    if (targetTypeJSON?.weak || targetTypeJSON?.kind === "Union" /* Union */) {
+    if ((targetTypeJSON == null ? void 0 : targetTypeJSON.weak) || (targetTypeJSON == null ? void 0 : targetTypeJSON.kind) === "Union" /* Union */) {
       return isSuperEqual;
     }
     return targetTypeJSON && isSuperEqual && // 弱比较，只需要比较 Kind 即可
-    (targetTypeJSON?.weak || this.customStrongEqual(targetTypeJSON));
+    ((targetTypeJSON == null ? void 0 : targetTypeJSON.weak) || this.customStrongEqual(targetTypeJSON));
   }
   /**
    * Array 强比较
@@ -512,15 +632,17 @@ var ArrayType = class extends BaseType {
    * @returns
    */
   customStrongEqual(targetTypeJSON) {
+    var _a;
     if (!this.items) {
-      return !targetTypeJSON?.items;
+      return !(targetTypeJSON == null ? void 0 : targetTypeJSON.items);
     }
-    return this.items?.isTypeEqual(targetTypeJSON.items);
+    return (_a = this.items) == null ? void 0 : _a.isTypeEqual(targetTypeJSON.items);
   }
   toJSON() {
+    var _a;
     return {
       kind: "Array" /* Array */,
-      items: this.items?.toJSON()
+      items: (_a = this.items) == null ? void 0 : _a.toJSON()
     };
   }
 };
@@ -582,11 +704,11 @@ var MapType = class extends BaseType {
   isTypeEqual(targetTypeJSONOrKind) {
     const targetTypeJSON = parseTypeJsonOrKind(targetTypeJSONOrKind);
     const isSuperEqual = super.isTypeEqual(targetTypeJSONOrKind);
-    if (targetTypeJSON?.weak || targetTypeJSON?.kind === "Union" /* Union */) {
+    if ((targetTypeJSON == null ? void 0 : targetTypeJSON.weak) || (targetTypeJSON == null ? void 0 : targetTypeJSON.kind) === "Union" /* Union */) {
       return isSuperEqual;
     }
     return targetTypeJSON && isSuperEqual && // 弱比较，只需要比较 Kind 即可
-    (targetTypeJSON?.weak || this.customStrongEqual(targetTypeJSON));
+    ((targetTypeJSON == null ? void 0 : targetTypeJSON.weak) || this.customStrongEqual(targetTypeJSON));
   }
   /**
    * Map 强比较
@@ -594,15 +716,17 @@ var MapType = class extends BaseType {
    * @returns
    */
   customStrongEqual(targetTypeJSON) {
+    var _a, _b;
     const { keyType = "String" /* String */, valueType } = targetTypeJSON;
-    const isValueTypeEqual = !valueType && !this.valueType || this.valueType?.isTypeEqual(valueType);
-    return isValueTypeEqual && this.keyType?.isTypeEqual(keyType);
+    const isValueTypeEqual = !valueType && !this.valueType || ((_a = this.valueType) == null ? void 0 : _a.isTypeEqual(valueType));
+    return isValueTypeEqual && ((_b = this.keyType) == null ? void 0 : _b.isTypeEqual(keyType));
   }
   toJSON() {
+    var _a, _b;
     return {
       kind: "Map" /* Map */,
-      keyType: this.keyType?.toJSON(),
-      valueType: this.valueType?.toJSON()
+      keyType: (_a = this.keyType) == null ? void 0 : _a.toJSON(),
+      valueType: (_b = this.valueType) == null ? void 0 : _b.toJSON()
     };
   }
 };
@@ -638,7 +762,7 @@ var ObjectType = class extends BaseType {
     });
     removedKeys.forEach((key) => {
       const property = this.propertyTable.get(key);
-      property?.dispose();
+      property == null ? void 0 : property.dispose();
       this.propertyTable.delete(key);
       this.fireChange();
     });
@@ -662,12 +786,13 @@ var ObjectType = class extends BaseType {
    * @returns
    */
   getByKeyPath(keyPath) {
+    var _a;
     const [curr, ...restKeyPath] = keyPath;
     const property = this.propertyTable.get(curr);
     if (!restKeyPath.length) {
       return property;
     }
-    if (property?.type && property?.type?.flags & 16 /* DrilldownType */) {
+    if ((property == null ? void 0 : property.type) && ((_a = property == null ? void 0 : property.type) == null ? void 0 : _a.flags) & 16 /* DrilldownType */) {
       return property.type.getByKeyPath(restKeyPath);
     }
     return void 0;
@@ -675,11 +800,11 @@ var ObjectType = class extends BaseType {
   isTypeEqual(targetTypeJSONOrKind) {
     const targetTypeJSON = parseTypeJsonOrKind(targetTypeJSONOrKind);
     const isSuperEqual = super.isTypeEqual(targetTypeJSONOrKind);
-    if (targetTypeJSON?.weak || targetTypeJSON?.kind === "Union" /* Union */) {
+    if ((targetTypeJSON == null ? void 0 : targetTypeJSON.weak) || (targetTypeJSON == null ? void 0 : targetTypeJSON.kind) === "Union" /* Union */) {
       return isSuperEqual;
     }
     return targetTypeJSON && isSuperEqual && // 弱比较，只需要比较 Kind 即可
-    (targetTypeJSON?.weak || this.customStrongEqual(targetTypeJSON));
+    ((targetTypeJSON == null ? void 0 : targetTypeJSON.weak) || this.customStrongEqual(targetTypeJSON));
   }
   /**
    * Object 类型强比较
@@ -692,8 +817,9 @@ var ObjectType = class extends BaseType {
     const targetPropertyKeys = targetProperties.map((_target) => _target.key);
     const isKeyStrongEqual = !xor(sourcePropertyKeys, targetPropertyKeys).length;
     return isKeyStrongEqual && targetProperties.every((targetProperty) => {
+      var _a;
       const sourceProperty = this.propertyTable.get(targetProperty.key);
-      return sourceProperty && sourceProperty.key === targetProperty.key && sourceProperty.type?.isTypeEqual(targetProperty?.type);
+      return sourceProperty && sourceProperty.key === targetProperty.key && ((_a = sourceProperty.type) == null ? void 0 : _a.isTypeEqual(targetProperty == null ? void 0 : targetProperty.type));
     });
   }
 };
@@ -711,13 +837,14 @@ var CustomType = class extends BaseType {
     }
   }
   isTypeEqual(targetTypeJSONOrKind) {
+    var _a;
     const targetTypeJSON = parseTypeJsonOrKind(targetTypeJSONOrKind);
-    if (targetTypeJSON?.kind === "Union" /* Union */) {
-      return (targetTypeJSON?.types || [])?.some(
+    if ((targetTypeJSON == null ? void 0 : targetTypeJSON.kind) === "Union" /* Union */) {
+      return (_a = (targetTypeJSON == null ? void 0 : targetTypeJSON.types) || []) == null ? void 0 : _a.some(
         (_subType) => this.isTypeEqual(_subType)
       );
     }
-    return targetTypeJSON?.kind === this.kind && targetTypeJSON?.typeName === this.typeName;
+    return (targetTypeJSON == null ? void 0 : targetTypeJSON.kind) === this.kind && (targetTypeJSON == null ? void 0 : targetTypeJSON.typeName) === this.typeName;
   }
 };
 CustomType.kind = "CustomType" /* CustomType */;
@@ -726,11 +853,11 @@ CustomType.kind = "CustomType" /* CustomType */;
 import {
   distinctUntilChanged as distinctUntilChanged2,
   map as map2,
-  switchMap,
+  switchMap as switchMap2,
   combineLatest,
   of,
-  Subject,
-  share
+  Subject as Subject2,
+  share as share2
 } from "rxjs";
 import { shallowEqual as shallowEqual2 } from "fast-equals";
 
@@ -756,7 +883,7 @@ var BaseExpression = class extends ASTNode {
      * 引用变量
      */
     this._refs = [];
-    this.refreshRefs$ = new Subject();
+    this.refreshRefs$ = new Subject2();
     /**
      * 监听引用变量变化
      * 监听 [a.b.c] -> [a.b]
@@ -764,14 +891,14 @@ var BaseExpression = class extends ASTNode {
     this.refs$ = this.refreshRefs$.pipe(
       map2(() => this.getRefFields()),
       distinctUntilChanged2(shallowEqual2),
-      switchMap(
-        (refs) => !refs?.length ? of([]) : combineLatest(
+      switchMap2(
+        (refs) => !(refs == null ? void 0 : refs.length) ? of([]) : combineLatest(
           refs.map(
             (ref) => ref ? ref.value$ : of(void 0)
           )
         )
       ),
-      share()
+      share2()
     );
     this.toDispose.push(
       subsToDisposable(
@@ -805,29 +932,6 @@ var BaseExpression = class extends ASTNode {
   }
 };
 
-// src/ast/expression/expression-list.ts
-var ExpressionList = class extends ASTNode {
-  fromJSON({ expressions }) {
-    this.expressions = expressions.map((_expression, idx) => {
-      const prevExpression = this.expressions[idx];
-      if (prevExpression.kind !== _expression.kind) {
-        prevExpression.dispose();
-        this.fireChange();
-        return this.createChildNode(_expression);
-      }
-      prevExpression.fromJSON(_expression);
-      return prevExpression;
-    });
-  }
-  toJSON() {
-    return {
-      kind: "ExpressionList" /* ExpressionList */,
-      properties: this.expressions.map((_expression) => _expression.toJSON())
-    };
-  }
-};
-ExpressionList.kind = "ExpressionList" /* ExpressionList */;
-
 // src/ast/expression/keypath-expression.ts
 import { shallowEqual as shallowEqual3 } from "fast-equals";
 var KeyPathExpression = class extends BaseExpression {
@@ -892,8 +996,9 @@ var EnumerateExpression = class extends BaseExpression {
     return this._enumerateFor;
   }
   get returnType() {
-    const childReturnType = this.enumerateFor?.returnType;
-    if (childReturnType?.kind === "Array" /* Array */) {
+    var _a;
+    const childReturnType = (_a = this.enumerateFor) == null ? void 0 : _a.returnType;
+    if ((childReturnType == null ? void 0 : childReturnType.kind) === "Array" /* Array */) {
       return childReturnType.items;
     }
     return void 0;
@@ -905,9 +1010,10 @@ var EnumerateExpression = class extends BaseExpression {
     this.updateChildNodeByKey("_enumerateFor", expression);
   }
   toJSON() {
+    var _a;
     return {
       kind: "EnumerateExpression" /* EnumerateExpression */,
-      enumerateFor: this.enumerateFor?.toJSON()
+      enumerateFor: (_a = this.enumerateFor) == null ? void 0 : _a.toJSON()
     };
   }
 };
@@ -922,7 +1028,7 @@ function getAllRefs(ast) {
   return getAllChildren(ast).filter((_child) => _child.flags & 4 /* Expression */).map((_child) => _child.refs).flat().filter(Boolean);
 }
 function checkRefCycle(curr, refNodes) {
-  if (intersection(curr.scope.coverScopes, refNodes.map((_ref) => _ref?.scope).filter(Boolean)).length === 0) {
+  if (intersection(curr.scope.coverScopes, refNodes.map((_ref) => _ref == null ? void 0 : _ref.scope).filter(Boolean)).length === 0) {
     return false;
   }
   const visited = /* @__PURE__ */ new Set();
@@ -955,9 +1061,10 @@ var KeyPathExpressionV2 = class extends BaseExpression {
       }),
       subsToDisposable(
         this.refs$.subscribe((_type) => {
+          var _a, _b;
           const [ref] = this._refs;
-          if (this.prevRefTypeHash !== ref?.type?.hash) {
-            this.prevRefTypeHash = ref?.type?.hash;
+          if (this.prevRefTypeHash !== ((_a = ref == null ? void 0 : ref.type) == null ? void 0 : _a.hash)) {
+            this.prevRefTypeHash = (_b = ref == null ? void 0 : ref.type) == null ? void 0 : _b.hash;
             this.updateChildNodeByKey("_returnType", this.getReturnTypeJSONByRef(ref));
           }
         })
@@ -998,7 +1105,8 @@ var KeyPathExpressionV2 = class extends BaseExpression {
     }
   }
   getReturnTypeJSONByRef(_ref) {
-    return _ref?.type?.toJSON();
+    var _a;
+    return (_a = _ref == null ? void 0 : _ref.type) == null ? void 0 : _a.toJSON();
   }
   toJSON() {
     return {
@@ -1009,8 +1117,50 @@ var KeyPathExpressionV2 = class extends BaseExpression {
 };
 KeyPathExpressionV2.kind = "KeyPathExpression" /* KeyPathExpression */;
 
-// src/ast/declaration/variable-declaration.ts
-import { Disposable as Disposable3 } from "@flowgram.ai/utils";
+// src/ast/expression/wrap-array-expression.ts
+var WrapArrayExpression = class extends BaseExpression {
+  get wrapFor() {
+    return this._wrapFor;
+  }
+  get returnType() {
+    return this._returnType;
+  }
+  refreshReturnType() {
+    var _a, _b;
+    const childReturnTypeJSON = (_b = (_a = this.wrapFor) == null ? void 0 : _a.returnType) == null ? void 0 : _b.toJSON();
+    this.updateChildNodeByKey("_returnType", {
+      kind: "Array" /* Array */,
+      items: childReturnTypeJSON
+    });
+  }
+  getRefFields() {
+    return [];
+  }
+  fromJSON({ wrapFor: expression }) {
+    this.updateChildNodeByKey("_wrapFor", expression);
+  }
+  toJSON() {
+    var _a;
+    return {
+      kind: "WrapArrayExpression" /* WrapArrayExpression */,
+      wrapFor: (_a = this.wrapFor) == null ? void 0 : _a.toJSON()
+    };
+  }
+  init() {
+    this.toDispose.push(
+      this.subscribe(this.refreshReturnType, {
+        selector: (curr) => {
+          var _a;
+          return (_a = curr.wrapFor) == null ? void 0 : _a.returnType;
+        }
+      })
+    );
+  }
+};
+WrapArrayExpression.kind = "WrapArrayExpression" /* WrapArrayExpression */;
+__decorateClass([
+  postConstructAST()
+], WrapArrayExpression.prototype, "init", 1);
 
 // src/ast/declaration/base-variable-field.ts
 import { shallowEqual as shallowEqual5 } from "fast-equals";
@@ -1030,7 +1180,8 @@ var BaseVariableField = class extends ASTNode {
     return this._meta;
   }
   get type() {
-    return this._initializer?.returnType || this._type;
+    var _a;
+    return ((_a = this._initializer) == null ? void 0 : _a.returnType) || this._type;
   }
   get initializer() {
     return this._initializer;
@@ -1062,7 +1213,8 @@ var BaseVariableField = class extends ASTNode {
    * @returns
    */
   getByKeyPath(keyPath) {
-    if (this.type?.flags & 16 /* DrilldownType */) {
+    var _a;
+    if (((_a = this.type) == null ? void 0 : _a.flags) & 16 /* DrilldownType */) {
       return this.type.getByKeyPath(keyPath);
     }
     return void 0;
@@ -1080,11 +1232,12 @@ var BaseVariableField = class extends ASTNode {
    * @returns
    */
   toJSON() {
+    var _a, _b;
     return {
       kind: this.kind,
       key: this.key,
-      type: this.type?.toJSON(),
-      initializer: this.initializer?.toJSON(),
+      type: (_a = this.type) == null ? void 0 : _a.toJSON(),
+      initializer: (_b = this.initializer) == null ? void 0 : _b.toJSON(),
       meta: this._meta
     };
   }
@@ -1095,13 +1248,6 @@ var VariableDeclaration = class extends BaseVariableField {
   constructor(params) {
     super(params);
     this._order = 0;
-    this.scope.output.addVariableToTable(this);
-    this.toDispose.push(
-      Disposable3.create(() => {
-        this.scope.output.setHasChanges();
-        this.scope.output.removeVariableFromTable(this.key);
-      })
-    );
   }
   get order() {
     return this._order;
@@ -1116,7 +1262,9 @@ var VariableDeclaration = class extends BaseVariableField {
   updateOrder(order = 0) {
     if (order !== this._order) {
       this._order = order;
-      this.scope.output.setHasChanges();
+      this.dispatchGlobalEvent({
+        type: "ReSortVariableDeclarations"
+      });
       this.fireChange();
     }
   }
@@ -1138,8 +1286,9 @@ var VariableDeclarationList = class extends ASTNode {
     const prev = [...this.declarations || []];
     this.declarations = (declarations || []).map(
       (declaration, idx) => {
+        var _a, _b;
         const order = (startOrder || 0) + idx;
-        const declarationKey = declaration.key || this.declarations?.[idx]?.key;
+        const declarationKey = declaration.key || ((_b = (_a = this.declarations) == null ? void 0 : _a[idx]) == null ? void 0 : _b.key);
         const existDeclaration = this.declarationTable.get(declarationKey);
         if (declarationKey) {
           removedKeys.delete(declarationKey);
@@ -1161,7 +1310,7 @@ var VariableDeclarationList = class extends ASTNode {
     );
     removedKeys.forEach((key) => {
       const declaration = this.declarationTable.get(key);
-      declaration?.dispose();
+      declaration == null ? void 0 : declaration.dispose();
       this.declarationTable.delete(key);
     });
     this.dispatchGlobalEvent({
@@ -1287,7 +1436,8 @@ var MapNode = class extends ASTNode {
    * @param key
    */
   remove(key) {
-    this.get(key)?.dispose();
+    var _a;
+    (_a = this.get(key)) == null ? void 0 : _a.dispose();
     this.map.delete(key);
     this.fireChange();
   }
@@ -1321,9 +1471,9 @@ var ASTRegisters = class {
     this.registerAST(Property);
     this.registerAST(VariableDeclaration);
     this.registerAST(VariableDeclarationList);
-    this.registerAST(KeyPathExpression);
+    this.registerAST(KeyPathExpressionV2);
     this.registerAST(EnumerateExpression);
-    this.registerAST(ExpressionList);
+    this.registerAST(WrapArrayExpression);
     this.registerAST(MapNode);
     this.registerAST(DataNode);
   }
@@ -1333,6 +1483,7 @@ var ASTRegisters = class {
    * @returns
    */
   createAST(json, { parent, scope }) {
+    var _a;
     const Registry = this.astMap.get(json.kind);
     if (!Registry) {
       throw Error(`ASTKind: ${String(json.kind)} can not find its ASTNode Registry`);
@@ -1344,14 +1495,14 @@ var ASTRegisters = class {
         scope,
         parent
       },
-      injector?.() || {}
+      (injector == null ? void 0 : injector()) || {}
     );
     node.changeLocked = true;
     node.fromJSON(omit(json, ["key", "kind"]));
     node.changeLocked = false;
     if (Reflect.hasMetadata(POST_CONSTRUCT_AST_SYMBOL, node)) {
       const postConstructKey = Reflect.getMetadata(POST_CONSTRUCT_AST_SYMBOL, node);
-      node[postConstructKey]?.();
+      (_a = node[postConstructKey]) == null ? void 0 : _a.call(node);
     }
     return node;
   }
@@ -1426,116 +1577,13 @@ var ASTFactory;
     kind: "KeyPathExpression" /* KeyPathExpression */,
     ...json
   });
+  ASTFactory2.createWrapArrayExpression = (json) => ({
+    kind: "WrapArrayExpression" /* WrapArrayExpression */,
+    ...json
+  });
   ASTFactory2.create = (targetType, json) => ({ kind: targetType.kind, ...json });
 })(ASTFactory || (ASTFactory = {}));
 
-// src/scope/variable-table.ts
-import { Subject as Subject2, merge, share as share2, skip as skip2, switchMap as switchMap2 } from "rxjs";
-import { Emitter } from "@flowgram.ai/utils";
-import { DisposableCollection as DisposableCollection3 } from "@flowgram.ai/utils";
-var VariableTable = class {
-  constructor(parentTable) {
-    this.parentTable = parentTable;
-    this.table = /* @__PURE__ */ new Map();
-    this.onDataChangeEmitter = new Emitter();
-    this.variables$ = new Subject2();
-    // 监听变量列表中的单个变量变化
-    this.anyVariableChange$ = this.variables$.pipe(
-      switchMap2(
-        (_variables) => merge(
-          ..._variables.map(
-            (_v) => _v.value$.pipe(
-              // 跳过 BehaviorSubject 第一个
-              skip2(1)
-            )
-          )
-        )
-      ),
-      share2()
-    );
-    this.onDataChange = this.onDataChangeEmitter.event;
-    this._version = 0;
-  }
-  /**
-   * 监听任意变量变化
-   * @param observer 监听器，变量变化时会吐出值
-   * @returns
-   */
-  onAnyVariableChange(observer) {
-    return subsToDisposable(this.anyVariableChange$.subscribe(observer));
-  }
-  /**
-   * 列表或者任意变量变化
-   * @param observer
-   */
-  onAnyChange(observer) {
-    const disposables = new DisposableCollection3();
-    disposables.pushAll([this.onDataChange(observer), this.onAnyVariableChange(observer)]);
-    return disposables;
-  }
-  fireChange() {
-    this._version++;
-    this.onDataChangeEmitter.fire();
-    this.parentTable?.fireChange();
-  }
-  get version() {
-    return this._version;
-  }
-  get variables() {
-    return Array.from(this.table.values());
-  }
-  get variableKeys() {
-    return Array.from(this.table.keys());
-  }
-  /**
-   * 根据 keyPath 找到对应的变量，或 Property 节点
-   * @param keyPath
-   * @returns
-   */
-  getByKeyPath(keyPath) {
-    const [variableKey, ...propertyKeys] = keyPath || [];
-    if (!variableKey) {
-      return;
-    }
-    const variable = this.getVariableByKey(variableKey);
-    return propertyKeys.length ? variable?.getByKeyPath(propertyKeys) : variable;
-  }
-  /**
-   * 根据 key 值找到相应的变量
-   * @param key
-   * @returns
-   */
-  getVariableByKey(key) {
-    return this.table.get(key);
-  }
-  /**
-   * 往 variableTable 添加输出变量
-   * @param variable
-   */
-  addVariableToTable(variable) {
-    this.table.set(variable.key, variable);
-    if (this.parentTable) {
-      this.parentTable.addVariableToTable(variable);
-    }
-    this.variables$.next(this.variables);
-  }
-  /**
-   * 从 variableTable 中移除变量
-   * @param key
-   */
-  removeVariableFromTable(key) {
-    this.table.delete(key);
-    if (this.parentTable) {
-      this.parentTable.removeVariableFromTable(key);
-    }
-    this.variables$.next(this.variables);
-  }
-  dispose() {
-    this.variableKeys.forEach((_key) => this.parentTable?.removeVariableFromTable(_key));
-    this.onDataChangeEmitter.dispose();
-  }
-};
-
 // src/scope/datas/scope-output-data.ts
 var ScopeOutputData = class {
   constructor(scope) {
@@ -1544,7 +1592,7 @@ var ScopeOutputData = class {
     this._hasChanges = false;
     this.variableTable = new VariableTable(scope.variableEngine.globalVariableTable);
     this.scope.toDispose.pushAll([
-      // AST 根节点更新时，检查在这次 AST 变化期间节点是否有变化
+      // When root AST node is updated, check if there are any changes during this AST change
       this.scope.ast.subscribe(() => {
         if (this._hasChanges) {
           this.memo.clear();
@@ -1553,6 +1601,21 @@ var ScopeOutputData = class {
           this._hasChanges = false;
         }
       }),
+      this.scope.event.on("DisposeAST", (_action) => {
+        var _a;
+        if (((_a = _action.ast) == null ? void 0 : _a.kind) === "VariableDeclaration" /* VariableDeclaration */) {
+          this.removeVariableFromTable(_action.ast.key);
+        }
+      }),
+      this.scope.event.on("NewAST", (_action) => {
+        var _a;
+        if (((_a = _action.ast) == null ? void 0 : _a.kind) === "VariableDeclaration" /* VariableDeclaration */) {
+          this.addVariableToTable(_action.ast);
+        }
+      }),
+      this.scope.event.on("ReSortVariableDeclarations", () => {
+        this._hasChanges = true;
+      }),
       this.variableTable
     ]);
   }
@@ -1569,7 +1632,7 @@ var ScopeOutputData = class {
     return this.variableTable.onAnyVariableChange.bind(this.variableTable);
   }
   /**
-   * 作用域输出变量
+   * Scope Output Variable Declarations
    */
   get variables() {
     return this.memo(
@@ -1578,7 +1641,7 @@ var ScopeOutputData = class {
     );
   }
   /**
-   * 输出的变量 keys
+   * Output Variable Keys
    */
   get variableKeys() {
     return this.memo("variableKeys", () => this.variableTable.variableKeys);
@@ -1590,10 +1653,6 @@ var ScopeOutputData = class {
     this.variableTable.addVariableToTable(variable);
     this._hasChanges = true;
   }
-  // 标记为发生了变化，用于变量排序变化的场景
-  setHasChanges() {
-    this._hasChanges = true;
-  }
   removeVariableFromTable(key) {
     this.variableTable.removeVariableFromTable(key);
     this._hasChanges = true;
@@ -1601,7 +1660,9 @@ var ScopeOutputData = class {
   getVariableByKey(key) {
     return this.variableTable.getVariableByKey(key);
   }
-  // 通知覆盖作用域更新可用变量
+  /**
+   *
+   */
   notifyCoversChange() {
     this.scope.coverScopes.forEach((scope) => scope.available.refresh());
   }
@@ -1619,7 +1680,7 @@ import {
 } from "rxjs";
 import { flatten } from "lodash";
 import { shallowEqual as shallowEqual7 } from "fast-equals";
-import { Disposable as Disposable5 } from "@flowgram.ai/utils";
+import { Disposable as Disposable3 } from "@flowgram.ai/utils";
 import { Emitter as Emitter2 } from "@flowgram.ai/utils";
 var ScopeAvailableData = class {
   constructor(scope) {
@@ -1665,7 +1726,7 @@ var ScopeAvailableData = class {
       this.onAnyVariableChange(() => {
         this.onDataChangeEmitter.fire(this._variables);
       }),
-      Disposable5.create(() => {
+      Disposable3.create(() => {
         this.refresh$.complete();
         this.refresh$.unsubscribe();
       })
@@ -1772,7 +1833,7 @@ var Scope = class {
     this.ast = this.variableEngine.astRegisters.createAST(
       {
         kind: "MapNode" /* MapNode */,
-        key: this.id
+        key: String(this.id)
       },
       {
         scope: this
@@ -1791,13 +1852,13 @@ var Scope = class {
   get depScopes() {
     return this.memo(
       "deps",
-      () => this.variableEngine.chain.getDeps(this).filter((_scope) => Boolean(_scope) && !_scope?.disposed)
+      () => this.variableEngine.chain.getDeps(this).filter((_scope) => Boolean(_scope) && !(_scope == null ? void 0 : _scope.disposed))
     );
   }
   get coverScopes() {
     return this.memo(
       "covers",
-      () => this.variableEngine.chain.getCovers(this).filter((_scope) => Boolean(_scope) && !_scope?.disposed)
+      () => this.variableEngine.chain.getCovers(this).filter((_scope) => Boolean(_scope) && !(_scope == null ? void 0 : _scope.disposed))
     );
   }
   dispose() {
@@ -1825,7 +1886,7 @@ var VariableEngine = class {
     this.onScopeChange = this.onScopeChangeEmitter.event;
     this.toDispose.pushAll([
       chain,
-      Disposable6.create(() => {
+      Disposable4.create(() => {
         this.getAllScopes().forEach((scope) => scope.dispose());
         this.globalVariableTable.dispose();
       })
@@ -1843,13 +1904,21 @@ var VariableEngine = class {
   }
   // 移除作用域
   removeScopeById(scopeId) {
-    this.getScopeById(scopeId)?.dispose();
+    var _a;
+    (_a = this.getScopeById(scopeId)) == null ? void 0 : _a.dispose();
   }
-  // 获取 Scope，如果 Scope 存在且类型相同，则会直接使用
-  createScope(id, meta) {
+  /**
+   * Get Scope, if Scope exists and type is same, will use it directly
+   * @param id scope id
+   * @param meta scope meta, defined by user
+   * @param ScopeConstructor scope constructor, default is Scope. you can extends Scope to create your own scope
+   * @returns
+   */
+  createScope(id, meta, options = {}) {
+    const { ScopeConstructor = Scope } = options;
     let scope = this.getScopeById(id);
     if (!scope) {
-      scope = new Scope({ variableEngine: this, meta, id });
+      scope = new ScopeConstructor({ variableEngine: this, meta, id });
       this.scopeMap.set(id, scope);
       this.onScopeChangeEmitter.fire({ type: "add", scope });
       scope.toDispose.pushAll([
@@ -1920,7 +1989,8 @@ var VariableFieldKeyRenameService = class {
     this.onDisposeInList = this.disposeInListEmitter.event;
   }
   handleFieldListChange(ast, prev, next) {
-    if (!ast || !prev?.length || !next?.length) {
+    var _a, _b;
+    if (!ast || !(prev == null ? void 0 : prev.length) || !(next == null ? void 0 : next.length)) {
       this.notifyFieldsDispose(prev, next);
       return;
     }
@@ -1938,7 +2008,7 @@ var VariableFieldKeyRenameService = class {
           return;
         }
         existFieldChanged = true;
-        if (prevField.type?.kind === nextField.type?.kind) {
+        if (((_a = prevField.type) == null ? void 0 : _a.kind) === ((_b = nextField.type) == null ? void 0 : _b.kind)) {
           renameNodeInfo = { before: prevField, after: nextField };
         }
       }
@@ -1958,13 +2028,15 @@ var VariableFieldKeyRenameService = class {
       this.variableEngine.onGlobalEvent(
         "VariableListChange",
         (_action) => {
-          this.handleFieldListChange(_action.ast, _action.payload?.prev, _action.payload?.next);
+          var _a, _b;
+          this.handleFieldListChange(_action.ast, (_a = _action.payload) == null ? void 0 : _a.prev, (_b = _action.payload) == null ? void 0 : _b.next);
         }
       ),
       this.variableEngine.onGlobalEvent(
         "ObjectPropertiesChange",
         (_action) => {
-          this.handleFieldListChange(_action.ast, _action.payload?.prev, _action.payload?.next);
+          var _a, _b;
+          this.handleFieldListChange(_action.ast, (_a = _action.payload) == null ? void 0 : _a.prev, (_b = _action.payload) == null ? void 0 : _b.next);
         }
       )
     ]);
@@ -2000,7 +2072,10 @@ import { createContext, useContext } from "react";
 var ScopeContext = createContext(null);
 var ScopeProvider = ScopeContext.Provider;
 var useScopeContext = () => useContext(ScopeContext);
-var useCurrentScope = () => useContext(ScopeContext)?.scope;
+var useCurrentScope = () => {
+  var _a;
+  return (_a = useContext(ScopeContext)) == null ? void 0 : _a.scope;
+};
 
 // src/react/hooks/useScopeAvailable.ts
 import { useEffect } from "react";
@@ -2053,7 +2128,6 @@ export {
   CustomType,
   DataNode,
   EnumerateExpression,
-  ExpressionList,
   IntegerType,
   KeyPathExpression,
   KeyPathExpressionV2,
@@ -2074,7 +2148,7 @@ export {
   VariableEngine,
   VariableEngineProvider,
   VariableFieldKeyRenameService,
-  VariableTable,
+  WrapArrayExpression,
   injectToAST,
   isMatchAST,
   postConstructAST,