@flowgram.ai/variable-core 0.2.16 → 0.2.17

package/dist/esm/index.js

@@ -70,29 +70,41 @@ var VariableTable = class {
       ),
       share()
     );
+    /**
+     * @deprecated use onListOrAnyVarChange instead
+     */
     this.onDataChange = this.onDataChangeEmitter.event;
     this._version = 0;
   }
   /**
-   * 监听任意变量变化
-   * @param observer 监听器，变量变化时会吐出值
+   * listen to any variable update in list
+   * @param observer
    * @returns
    */
   onAnyVariableChange(observer) {
     return subsToDisposable(this.anyVariableChange$.subscribe(observer));
   }
   /**
-   * 列表或者任意变量变化
+   * listen to variable list change
    * @param observer
+   * @returns
    */
-  onAnyChange(observer) {
+  onVariableListChange(observer) {
+    return subsToDisposable(this.variables$.subscribe(observer));
+  }
+  /**
+   * listen to variable list change + any variable update in list
+   * @param observer
+   */
+  onListOrAnyVarChange(observer) {
     const disposables = new DisposableCollection();
-    disposables.pushAll([this.onDataChange(observer), this.onAnyVariableChange(observer)]);
+    disposables.pushAll([this.onVariableListChange(observer), this.onAnyVariableChange(observer)]);
     return disposables;
   }
   fireChange() {
     this._version++;
     this.onDataChangeEmitter.fire();
+    this.variables$.next(this.variables);
     this.parentTable?.fireChange();
   }
   get version() {
@@ -134,7 +146,6 @@ var VariableTable = class {
     if (this.parentTable) {
       this.parentTable.addVariableToTable(variable);
     }
-    this.variables$.next(this.variables);
   }
   /**
    * 从 variableTable 中移除变量
@@ -145,12 +156,14 @@ var VariableTable = class {
     if (this.parentTable) {
       this.parentTable.removeVariableFromTable(key);
     }
-    this.variables$.next(this.variables);
   }
   dispose() {
     this.variableKeys.forEach(
       (_key) => this.parentTable?.removeVariableFromTable(_key)
     );
+    this.parentTable?.fireChange();
+    this.variables$.complete();
+    this.variables$.unsubscribe();
     this.onDataChangeEmitter.dispose();
   }
 };
@@ -1126,9 +1139,11 @@ var WrapArrayExpression = class extends BaseExpression {
     };
   }
   init() {
+    this.refreshReturnType = this.refreshReturnType.bind(this);
     this.toDispose.push(
       this.subscribe(this.refreshReturnType, {
-        selector: (curr) => curr.wrapFor?.returnType
+        selector: (curr) => curr.wrapFor?.returnType,
+        triggerOnInit: true
       })
     );
   }
@@ -1152,6 +1167,9 @@ var BaseVariableField = class extends ASTNode {
   get parentFields() {
     return getParentFields(this);
   }
+  get keyPath() {
+    return this.parentFields.reverse().map((_field) => _field.key);
+  }
   get meta() {
     return this._meta;
   }
@@ -1161,6 +1179,9 @@ var BaseVariableField = class extends ASTNode {
   get initializer() {
     return this._initializer;
   }
+  get hash() {
+    return `[${this._version}]${this.keyPath.join(".")}`;
+  }
   /**
    * 解析 VariableDeclarationJSON 从而生成变量声明节点
    */
@@ -1593,12 +1614,30 @@ var ScopeOutputData = class {
   get globalVariableTable() {
     return this.scope.variableEngine.globalVariableTable;
   }
+  /**
+   * @deprecated use onListOrAnyVarChange instead
+   */
   get onDataChange() {
     return this.variableTable.onDataChange.bind(this.variableTable);
   }
+  /**
+   * listen to variable list change
+   */
+  get onVariableListChange() {
+    return this.variableTable.onVariableListChange.bind(this.variableTable);
+  }
+  /**
+   * listen to any variable update in list
+   */
   get onAnyVariableChange() {
     return this.variableTable.onAnyVariableChange.bind(this.variableTable);
   }
+  /**
+   * listen to variable list change + any variable update in list
+   */
+  get onListOrAnyVarChange() {
+    return this.variableTable.onListOrAnyVarChange.bind(this.variableTable);
+  }
   /**
    * Scope Output Variable Declarations
    */
@@ -1644,7 +1683,9 @@ import {
   merge as merge2,
   share as share3,
   skip as skip3,
-  switchMap as switchMap3
+  startWith,
+  switchMap as switchMap3,
+  tap as tap2
 } from "rxjs";
 import { flatten } from "lodash";
 import { shallowEqual as shallowEqual7 } from "fast-equals";
@@ -1680,19 +1721,29 @@ var ScopeAvailableData = class {
       ),
       share3()
     );
+    /**
+     * @deprecated
+     */
     this.onDataChangeEmitter = new Emitter2();
+    this.onListOrAnyVarChangeEmitter = new Emitter2();
     /**
-     * 监听变量列表变化 + 任意子变量变化
+     * @deprecated use available.onListOrAnyVarChange instead
      */
     this.onDataChange = this.onDataChangeEmitter.event;
+    /**
+     * listen to variable list change + any variable drilldown change
+     */
+    this.onListOrAnyVarChange = this.onListOrAnyVarChangeEmitter.event;
     this.scope.toDispose.pushAll([
       this.onVariableListChange((_variables) => {
         this._variables = _variables;
         this.memo.clear();
         this.onDataChangeEmitter.fire(this._variables);
+        this.onListOrAnyVarChangeEmitter.fire(this._variables);
       }),
       this.onAnyVariableChange(() => {
         this.onDataChangeEmitter.fire(this._variables);
+        this.onListOrAnyVarChangeEmitter.fire(this._variables);
       }),
       Disposable3.create(() => {
         this.refresh$.complete();
@@ -1711,15 +1762,15 @@ var ScopeAvailableData = class {
     this.refresh$.next();
   }
   /**
-   * 监听任意变量变化
-   * @param observer 监听器，变量变化时会吐出值
+   * listen to any variable update in list
+   * @param observer
    * @returns
    */
   onAnyVariableChange(observer) {
     return subsToDisposable(this.anyVariableChange$.subscribe(observer));
   }
   /**
-   * 监听变量列表变化
+   * listen to variable list change
    * @param observer
    * @returns
    */
@@ -1755,6 +1806,20 @@ var ScopeAvailableData = class {
     }
     return this.globalVariableTable.getByKeyPath(keyPath);
   }
+  /**
+   * Track Variable Change (Includes type update and children update) By KeyPath
+   * @returns
+   */
+  trackByKeyPath(keyPath = [], cb, opts) {
+    const { triggerOnInit = true } = opts || {};
+    return subsToDisposable(
+      merge2(this.anyVariableChange$, this.variables$).pipe(
+        triggerOnInit ? startWith() : tap2(() => null),
+        map3(() => this.getByKeyPath(keyPath)),
+        distinctUntilChanged3((_prevNode, _node) => _prevNode?.hash !== _node?.hash)
+      ).subscribe(cb)
+    );
+  }
 };
 
 // src/scope/datas/scope-event-data.ts
@@ -1838,6 +1903,33 @@ var Scope = class {
   get disposed() {
     return this.toDispose.disposed;
   }
+  setVar(arg1, arg2) {
+    if (typeof arg1 === "string" && arg2 !== void 0) {
+      return this.ast.set(arg1, arg2);
+    }
+    if (typeof arg1 === "object" && arg2 === void 0) {
+      return this.ast.set("outputs", arg1);
+    }
+    throw new Error("Invalid arguments");
+  }
+  /**
+   * Retrieves a variable from the Scope by key.
+   *
+   * @param key - The key of the variable to retrieve. Defaults to 'outputs'.
+   * @returns The value of the variable, or undefined if not found.
+   */
+  getVar(key = "outputs") {
+    return this.ast.get(key);
+  }
+  /**
+   * Clears a variable from the Scope by key.
+   *
+   * @param key - The key of the variable to clear. Defaults to 'outputs'.
+   * @returns The updated AST node.
+   */
+  clearVar(key = "outputs") {
+    return this.ast.remove(key);
+  }
 };
 
 // src/variable-engine.ts
@@ -2062,7 +2154,7 @@ function useAvailableVariables() {
   const refresh = useRefresh2();
   useEffect2(() => {
     if (!scope) {
-      const disposable2 = variableEngine.globalVariableTable.onAnyChange(() => {
+      const disposable2 = variableEngine.globalVariableTable.onListOrAnyVarChange(() => {
         refresh();
       });
       return () => disposable2.dispose();