@knotx/core 0.2.12 → 0.2.14

package/dist/definition.d.cts

@@ -1,4 +1,4 @@
 import 'jsonschema';
 import 'rxjs';
-export { C as Container, E as Edge, s as EdgeOperation, q as EdgeOperationPipe, u as EdgeOperatorFunction, m as EdgeProps, e as EdgeRenderType, H as HorizontalAlignment, a as IEngineRuntime, b as IPlugin, h as IPluginInfo, i as IPluginToolInfo, I as IRecord, c as Layer, L as LayerComponent, N as Node, k as NodeMeasured, r as NodeOperation, p as NodeOperationPipe, t as NodeOperatorFunction, j as NodePosition, l as NodeProps, d as NodeRenderType, P as Plugin, o as PluginConfigs, f as PluginData, g as PluginTools, n as Position, R as RenderType, V as VerticalAlignment } from './shared/core.Cwp_TTTs.cjs';
+export { C as Container, E as Edge, t as EdgeOperation, r as EdgeOperationPipe, v as EdgeOperatorFunction, n as EdgeProps, e as EdgeRenderType, h as EngineTools, H as HorizontalAlignment, a as IEngineRuntime, b as IPlugin, i as IPluginInfo, j as IPluginToolInfo, I as IRecord, c as Layer, L as LayerComponent, N as Node, l as NodeMeasured, s as NodeOperation, q as NodeOperationPipe, u as NodeOperatorFunction, k as NodePosition, m as NodeProps, d as NodeRenderType, P as Plugin, p as PluginConfigs, f as PluginData, g as PluginTools, o as Position, R as RenderType, V as VerticalAlignment } from './shared/core.B-u2ysAC.cjs';
 import '@knotx/data';

package/dist/definition.d.mts

@@ -1,4 +1,4 @@
 import 'jsonschema';
 import 'rxjs';
-export { C as Container, E as Edge, s as EdgeOperation, q as EdgeOperationPipe, u as EdgeOperatorFunction, m as EdgeProps, e as EdgeRenderType, H as HorizontalAlignment, a as IEngineRuntime, b as IPlugin, h as IPluginInfo, i as IPluginToolInfo, I as IRecord, c as Layer, L as LayerComponent, N as Node, k as NodeMeasured, r as NodeOperation, p as NodeOperationPipe, t as NodeOperatorFunction, j as NodePosition, l as NodeProps, d as NodeRenderType, P as Plugin, o as PluginConfigs, f as PluginData, g as PluginTools, n as Position, R as RenderType, V as VerticalAlignment } from './shared/core.Cwp_TTTs.mjs';
+export { C as Container, E as Edge, t as EdgeOperation, r as EdgeOperationPipe, v as EdgeOperatorFunction, n as EdgeProps, e as EdgeRenderType, h as EngineTools, H as HorizontalAlignment, a as IEngineRuntime, b as IPlugin, i as IPluginInfo, j as IPluginToolInfo, I as IRecord, c as Layer, L as LayerComponent, N as Node, l as NodeMeasured, s as NodeOperation, q as NodeOperationPipe, u as NodeOperatorFunction, k as NodePosition, m as NodeProps, d as NodeRenderType, P as Plugin, p as PluginConfigs, f as PluginData, g as PluginTools, o as Position, R as RenderType, V as VerticalAlignment } from './shared/core.B-u2ysAC.mjs';
 import '@knotx/data';

package/dist/definition.d.ts

@@ -1,4 +1,4 @@
 import 'jsonschema';
 import 'rxjs';
-export { C as Container, E as Edge, s as EdgeOperation, q as EdgeOperationPipe, u as EdgeOperatorFunction, m as EdgeProps, e as EdgeRenderType, H as HorizontalAlignment, a as IEngineRuntime, b as IPlugin, h as IPluginInfo, i as IPluginToolInfo, I as IRecord, c as Layer, L as LayerComponent, N as Node, k as NodeMeasured, r as NodeOperation, p as NodeOperationPipe, t as NodeOperatorFunction, j as NodePosition, l as NodeProps, d as NodeRenderType, P as Plugin, o as PluginConfigs, f as PluginData, g as PluginTools, n as Position, R as RenderType, V as VerticalAlignment } from './shared/core.Cwp_TTTs.js';
+export { C as Container, E as Edge, t as EdgeOperation, r as EdgeOperationPipe, v as EdgeOperatorFunction, n as EdgeProps, e as EdgeRenderType, h as EngineTools, H as HorizontalAlignment, a as IEngineRuntime, b as IPlugin, i as IPluginInfo, j as IPluginToolInfo, I as IRecord, c as Layer, L as LayerComponent, N as Node, l as NodeMeasured, s as NodeOperation, q as NodeOperationPipe, u as NodeOperatorFunction, k as NodePosition, m as NodeProps, d as NodeRenderType, P as Plugin, p as PluginConfigs, f as PluginData, g as PluginTools, o as Position, R as RenderType, V as VerticalAlignment } from './shared/core.B-u2ysAC.js';
 import '@knotx/data';

package/dist/index.cjs

@@ -92,17 +92,17 @@ class InteractionManager {
 }
 
 var __defProp$3 = Object.defineProperty;
-var __getOwnPropSymbols$1 = Object.getOwnPropertySymbols;
-var __hasOwnProp$1 = Object.prototype.hasOwnProperty;
-var __propIsEnum$1 = Object.prototype.propertyIsEnumerable;
+var __getOwnPropSymbols$2 = Object.getOwnPropertySymbols;
+var __hasOwnProp$2 = Object.prototype.hasOwnProperty;
+var __propIsEnum$2 = Object.prototype.propertyIsEnumerable;
 var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues$1 = (a, b) => {
+var __spreadValues$2 = (a, b) => {
   for (var prop in b || (b = {}))
-    if (__hasOwnProp$1.call(b, prop))
+    if (__hasOwnProp$2.call(b, prop))
       __defNormalProp$3(a, prop, b[prop]);
-  if (__getOwnPropSymbols$1)
-    for (var prop of __getOwnPropSymbols$1(b)) {
-      if (__propIsEnum$1.call(b, prop))
+  if (__getOwnPropSymbols$2)
+    for (var prop of __getOwnPropSymbols$2(b)) {
+      if (__propIsEnum$2.call(b, prop))
         __defNormalProp$3(a, prop, b[prop]);
     }
   return a;
@@ -112,7 +112,7 @@ function getLayerRenders(plugin) {
   const components = [];
   let isRenderConsumed = false;
   for (const [name, layer] of Object.entries((_a = Reflect.get(plugin, utils.getSymbol("layer"))) != null ? _a : {})) {
-    components.push(__spreadValues$1({
+    components.push(__spreadValues$2({
       plugin: plugin.name,
       name: `${plugin.name}:${name}`,
       render: wrapRender(Reflect.get(plugin, name), plugin)
@@ -137,7 +137,24 @@ function wrapRender(render, plugin) {
 }
 
 var __defProp$2 = Object.defineProperty;
+var __defProps$1 = Object.defineProperties;
+var __getOwnPropDescs$1 = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols$1 = Object.getOwnPropertySymbols;
+var __hasOwnProp$1 = Object.prototype.hasOwnProperty;
+var __propIsEnum$1 = Object.prototype.propertyIsEnumerable;
 var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues$1 = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp$1.call(b, prop))
+      __defNormalProp$2(a, prop, b[prop]);
+  if (__getOwnPropSymbols$1)
+    for (var prop of __getOwnPropSymbols$1(b)) {
+      if (__propIsEnum$1.call(b, prop))
+        __defNormalProp$2(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps$1 = (a, b) => __defProps$1(a, __getOwnPropDescs$1(b));
 var __publicField$2 = (obj, key, value) => __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
 class Engine {
   constructor(options) {
@@ -154,7 +171,39 @@ class Engine {
     __publicField$2(this, "edgeRenderers$", new rxjs.BehaviorSubject(/* @__PURE__ */ new Map()));
     __publicField$2(this, "_pluginDataContainer", {});
     __publicField$2(this, "_pluginToolsContainer", {});
-    __publicField$2(this, "toolParamsValidator", new jsonschema.Validator());
+    __publicField$2(this, "engineTools", new Map([
+      {
+        type: "function",
+        name: "listPlugins",
+        description: "List all plugins",
+        parameters: {}
+      },
+      {
+        type: "function",
+        name: "listPluginTools",
+        description: "List all tools of a plugin",
+        parameters: {
+          type: "object",
+          properties: {
+            pluginName: { type: "string" }
+          },
+          required: ["pluginName"]
+        }
+      },
+      {
+        type: "function",
+        name: "getNodes",
+        description: "Get all nodes",
+        parameters: {}
+      },
+      {
+        type: "function",
+        name: "getEdges",
+        description: "Get all edges",
+        parameters: {}
+      }
+    ].map((tool) => [tool.name, tool])));
+    __publicField$2(this, "toolParametersValidator", new jsonschema.Validator());
     var _a;
     this.runtime = (_a = options.runtime) != null ? _a : {};
     this.container$.next(options.container);
@@ -303,18 +352,26 @@ class Engine {
   endInteraction(pluginId, type) {
     this.interactionManager.endInteraction(pluginId, type);
   }
-  callTool(pluginName, toolName, ...args) {
-    const toolDefinition = lodashEs.get(this, ["_pluginToolsContainer", pluginName, toolName]);
+  callTool(pluginNameOrEngineToolName, ...args) {
+    let toolDefinition;
+    let toolDisplayName;
+    if (this.engineTools.has(pluginNameOrEngineToolName)) {
+      toolDefinition = __spreadProps$1(__spreadValues$1({}, this.engineTools.get(pluginNameOrEngineToolName)), { func: this[pluginNameOrEngineToolName].bind(this) });
+      toolDisplayName = toolDefinition.name;
+    } else {
+      toolDefinition = lodashEs.get(this, ["_pluginToolsContainer", pluginNameOrEngineToolName, args == null ? void 0 : args[0]]);
+      toolDisplayName = `${pluginNameOrEngineToolName}.${args == null ? void 0 : args[0]}`;
+    }
     const tool = toolDefinition == null ? void 0 : toolDefinition.func;
     if (!tool || typeof tool !== "function") {
-      throw new Error(`Tool ${String(toolName)} not found in plugin ${pluginName}`);
+      throw new Error(`Tool ${String(toolDisplayName)} not found`);
     }
-    const params = args[0];
-    const validator = this.toolParamsValidator.validate(params, toolDefinition.params);
+    const parameters = args[args.length - 1];
+    const validator = this.toolParametersValidator.validate(parameters, toolDefinition.parameters);
     if (validator.errors.length > 0) {
-      throw new Error(`Invalid tool params: ${validator.errors.map((e) => e.stack).join(", ")}`);
+      throw new Error(`Invalid tool parameters: ${validator.errors.map((e) => e.stack).join(", ")}`);
     }
-    return tool(params);
+    return tool(parameters);
   }
   listPlugins() {
     return Array.from(this.plugins$.value.values()).map((plugin) => ({
@@ -322,35 +379,16 @@ class Engine {
       description: plugin.description
     }));
   }
-  listPluginTools(pluginName) {
+  listPluginTools({ pluginName }) {
     return Object.entries(lodashEs.get(this, ["_pluginToolsContainer", pluginName]) || {}).map(([toolName, toolDefinition]) => ({
       type: "function",
       name: toolName,
       description: toolDefinition.description,
-      parameters: toolDefinition.params
+      parameters: toolDefinition.parameters
     }));
   }
   listEngineTools() {
-    return [
-      {
-        type: "function",
-        name: "listPlugins",
-        description: "List all plugins",
-        parameters: {}
-      },
-      {
-        type: "function",
-        name: "listPluginTools",
-        description: "List all tools of a plugin",
-        parameters: {
-          type: "object",
-          properties: {
-            pluginName: { type: "string" }
-          },
-          required: ["pluginName"]
-        }
-      }
-    ];
+    return Array.from(this.engineTools.values());
   }
   destroy() {
     this.plugins$.value.forEach((plugin) => {
@@ -441,9 +479,12 @@ const _Runtime = class _Runtime {
       type,
       value: contextValue
     };
-    const result = handler();
-    this.currentContext = void 0;
-    return result;
+    try {
+      const result = handler();
+      return result;
+    } finally {
+      this.currentContext = void 0;
+    }
   }
   /**
    * 值处理器

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { I as IRecord, C as Container, P as Plugin, N as Node, E as Edge, a as IEngineRuntime, R as RenderType, L as LayerComponent, b as IPlugin, c as Layer, d as NodeRenderType, e as EdgeRenderType, f as PluginData, g as PluginTools, h as IPluginInfo, i as IPluginToolInfo } from './shared/core.Cwp_TTTs.cjs';
-export { B as BasePlugin, s as EdgeOperation, q as EdgeOperationPipe, u as EdgeOperatorFunction, m as EdgeProps, H as HorizontalAlignment, k as NodeMeasured, r as NodeOperation, p as NodeOperationPipe, t as NodeOperatorFunction, j as NodePosition, l as NodeProps, o as PluginConfigs, n as Position, V as VerticalAlignment } from './shared/core.Cwp_TTTs.cjs';
+import { R as RenderType, I as IRecord, a as IEngineRuntime, N as Node, E as Edge, C as Container, L as LayerComponent, b as IPlugin, P as Plugin, c as Layer, d as NodeRenderType, e as EdgeRenderType, f as PluginData, g as PluginTools, h as EngineTools, i as IPluginInfo, j as IPluginToolInfo } from './shared/core.B-u2ysAC.cjs';
+export { B as BasePlugin, t as EdgeOperation, r as EdgeOperationPipe, v as EdgeOperatorFunction, n as EdgeProps, H as HorizontalAlignment, l as NodeMeasured, s as NodeOperation, q as NodeOperationPipe, u as NodeOperatorFunction, k as NodePosition, m as NodeProps, p as PluginConfigs, o as Position, V as VerticalAlignment } from './shared/core.B-u2ysAC.cjs';
 import { Schema } from 'jsonschema';
 import { BehaviorSubject } from 'rxjs';
 import { DataManager, DataOperationPipe, DataOperation } from '@knotx/data';
@@ -93,6 +93,14 @@ interface EngineOptions<TNode extends IRecord = IRecord, TEdge extends IRecord =
     edges?: Edge<TEdge>[];
     runtime?: IEngineRuntime;
 }
+declare module '@knotx/core' {
+    interface EngineTools {
+        listPlugins: Engine['listPlugins'];
+        listPluginTools: Engine['listPluginTools'];
+        getNodes: Engine['getNodes'];
+        getEdges: Engine['getEdges'];
+    }
+}
 declare class Engine<TRenderType extends RenderType = RenderType, TNode extends IRecord = IRecord, TEdge extends IRecord = IRecord> {
     readonly runtime: IEngineRuntime;
     readonly interactionManager: InteractionManager;
@@ -107,7 +115,8 @@ declare class Engine<TRenderType extends RenderType = RenderType, TNode extends
     private edgeRenderers$;
     private _pluginDataContainer;
     private _pluginToolsContainer;
-    private toolParamsValidator;
+    private engineTools;
+    private toolParametersValidator;
     get container(): Container;
     set container(value: Container);
     get nodes(): Node<TNode>[];
@@ -135,7 +144,7 @@ declare class Engine<TRenderType extends RenderType = RenderType, TNode extends
     resetPluginData<T extends keyof PluginData>(pluginName: T): void;
     registerPluginTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, property: TP, data: {
         description: string;
-        params: Schema;
+        parameters: Schema;
         func: PluginTools[T][TP];
     }): void;
     resetPluginTool<T extends keyof PluginTools>(pluginName: T): void;
@@ -144,9 +153,12 @@ declare class Engine<TRenderType extends RenderType = RenderType, TNode extends
     canInteract(pluginId: string, type: string, autoStartPriority?: InteractionPriority): boolean;
     startInteraction(pluginId: string, type: string, priority: InteractionPriority): void;
     endInteraction(pluginId: string, type: string): void;
-    callTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, toolName: TP, ...args: Parameters<PluginTools[T][TP]>): any;
+    callTool<T extends keyof EngineTools>(engineToolName: T, ...args: Parameters<EngineTools[T]>): ReturnType<EngineTools[T]>;
+    callTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, toolName: TP, ...args: Parameters<PluginTools[T][TP]>): ReturnType<PluginTools[T][TP]>;
     listPlugins(): IPluginInfo[];
-    listPluginTools(pluginName: string): IPluginToolInfo[];
+    listPluginTools({ pluginName }: {
+        pluginName: string;
+    }): IPluginToolInfo[];
     listEngineTools(): IPluginToolInfo[];
     destroy(): void;
 }
@@ -214,4 +226,4 @@ declare function use<T, TContext>(hook: () => {
     __contextValue__: TContext;
 }, context: TContext): T;
 
-export { Container, Edge, EdgeRenderType, Engine, type EngineOptions, IEngineRuntime, IPlugin, IPluginInfo, IPluginToolInfo, IRecord, type Interaction, InteractionManager, InteractionPriority, Layer, LayerComponent, Node, NodeRenderType, Plugin, PluginData, PluginTools, RenderType, Runtime, getLayerRenders, use };
+export { Container, Edge, EdgeRenderType, Engine, type EngineOptions, type EngineTools, IEngineRuntime, IPlugin, IPluginInfo, IPluginToolInfo, IRecord, type Interaction, InteractionManager, InteractionPriority, Layer, LayerComponent, Node, NodeRenderType, Plugin, PluginData, PluginTools, RenderType, Runtime, getLayerRenders, use };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { I as IRecord, C as Container, P as Plugin, N as Node, E as Edge, a as IEngineRuntime, R as RenderType, L as LayerComponent, b as IPlugin, c as Layer, d as NodeRenderType, e as EdgeRenderType, f as PluginData, g as PluginTools, h as IPluginInfo, i as IPluginToolInfo } from './shared/core.Cwp_TTTs.mjs';
-export { B as BasePlugin, s as EdgeOperation, q as EdgeOperationPipe, u as EdgeOperatorFunction, m as EdgeProps, H as HorizontalAlignment, k as NodeMeasured, r as NodeOperation, p as NodeOperationPipe, t as NodeOperatorFunction, j as NodePosition, l as NodeProps, o as PluginConfigs, n as Position, V as VerticalAlignment } from './shared/core.Cwp_TTTs.mjs';
+import { R as RenderType, I as IRecord, a as IEngineRuntime, N as Node, E as Edge, C as Container, L as LayerComponent, b as IPlugin, P as Plugin, c as Layer, d as NodeRenderType, e as EdgeRenderType, f as PluginData, g as PluginTools, h as EngineTools, i as IPluginInfo, j as IPluginToolInfo } from './shared/core.B-u2ysAC.mjs';
+export { B as BasePlugin, t as EdgeOperation, r as EdgeOperationPipe, v as EdgeOperatorFunction, n as EdgeProps, H as HorizontalAlignment, l as NodeMeasured, s as NodeOperation, q as NodeOperationPipe, u as NodeOperatorFunction, k as NodePosition, m as NodeProps, p as PluginConfigs, o as Position, V as VerticalAlignment } from './shared/core.B-u2ysAC.mjs';
 import { Schema } from 'jsonschema';
 import { BehaviorSubject } from 'rxjs';
 import { DataManager, DataOperationPipe, DataOperation } from '@knotx/data';
@@ -93,6 +93,14 @@ interface EngineOptions<TNode extends IRecord = IRecord, TEdge extends IRecord =
     edges?: Edge<TEdge>[];
     runtime?: IEngineRuntime;
 }
+declare module '@knotx/core' {
+    interface EngineTools {
+        listPlugins: Engine['listPlugins'];
+        listPluginTools: Engine['listPluginTools'];
+        getNodes: Engine['getNodes'];
+        getEdges: Engine['getEdges'];
+    }
+}
 declare class Engine<TRenderType extends RenderType = RenderType, TNode extends IRecord = IRecord, TEdge extends IRecord = IRecord> {
     readonly runtime: IEngineRuntime;
     readonly interactionManager: InteractionManager;
@@ -107,7 +115,8 @@ declare class Engine<TRenderType extends RenderType = RenderType, TNode extends
     private edgeRenderers$;
     private _pluginDataContainer;
     private _pluginToolsContainer;
-    private toolParamsValidator;
+    private engineTools;
+    private toolParametersValidator;
     get container(): Container;
     set container(value: Container);
     get nodes(): Node<TNode>[];
@@ -135,7 +144,7 @@ declare class Engine<TRenderType extends RenderType = RenderType, TNode extends
     resetPluginData<T extends keyof PluginData>(pluginName: T): void;
     registerPluginTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, property: TP, data: {
         description: string;
-        params: Schema;
+        parameters: Schema;
         func: PluginTools[T][TP];
     }): void;
     resetPluginTool<T extends keyof PluginTools>(pluginName: T): void;
@@ -144,9 +153,12 @@ declare class Engine<TRenderType extends RenderType = RenderType, TNode extends
     canInteract(pluginId: string, type: string, autoStartPriority?: InteractionPriority): boolean;
     startInteraction(pluginId: string, type: string, priority: InteractionPriority): void;
     endInteraction(pluginId: string, type: string): void;
-    callTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, toolName: TP, ...args: Parameters<PluginTools[T][TP]>): any;
+    callTool<T extends keyof EngineTools>(engineToolName: T, ...args: Parameters<EngineTools[T]>): ReturnType<EngineTools[T]>;
+    callTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, toolName: TP, ...args: Parameters<PluginTools[T][TP]>): ReturnType<PluginTools[T][TP]>;
     listPlugins(): IPluginInfo[];
-    listPluginTools(pluginName: string): IPluginToolInfo[];
+    listPluginTools({ pluginName }: {
+        pluginName: string;
+    }): IPluginToolInfo[];
     listEngineTools(): IPluginToolInfo[];
     destroy(): void;
 }
@@ -214,4 +226,4 @@ declare function use<T, TContext>(hook: () => {
     __contextValue__: TContext;
 }, context: TContext): T;
 
-export { Container, Edge, EdgeRenderType, Engine, type EngineOptions, IEngineRuntime, IPlugin, IPluginInfo, IPluginToolInfo, IRecord, type Interaction, InteractionManager, InteractionPriority, Layer, LayerComponent, Node, NodeRenderType, Plugin, PluginData, PluginTools, RenderType, Runtime, getLayerRenders, use };
+export { Container, Edge, EdgeRenderType, Engine, type EngineOptions, type EngineTools, IEngineRuntime, IPlugin, IPluginInfo, IPluginToolInfo, IRecord, type Interaction, InteractionManager, InteractionPriority, Layer, LayerComponent, Node, NodeRenderType, Plugin, PluginData, PluginTools, RenderType, Runtime, getLayerRenders, use };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { I as IRecord, C as Container, P as Plugin, N as Node, E as Edge, a as IEngineRuntime, R as RenderType, L as LayerComponent, b as IPlugin, c as Layer, d as NodeRenderType, e as EdgeRenderType, f as PluginData, g as PluginTools, h as IPluginInfo, i as IPluginToolInfo } from './shared/core.Cwp_TTTs.js';
-export { B as BasePlugin, s as EdgeOperation, q as EdgeOperationPipe, u as EdgeOperatorFunction, m as EdgeProps, H as HorizontalAlignment, k as NodeMeasured, r as NodeOperation, p as NodeOperationPipe, t as NodeOperatorFunction, j as NodePosition, l as NodeProps, o as PluginConfigs, n as Position, V as VerticalAlignment } from './shared/core.Cwp_TTTs.js';
+import { R as RenderType, I as IRecord, a as IEngineRuntime, N as Node, E as Edge, C as Container, L as LayerComponent, b as IPlugin, P as Plugin, c as Layer, d as NodeRenderType, e as EdgeRenderType, f as PluginData, g as PluginTools, h as EngineTools, i as IPluginInfo, j as IPluginToolInfo } from './shared/core.B-u2ysAC.js';
+export { B as BasePlugin, t as EdgeOperation, r as EdgeOperationPipe, v as EdgeOperatorFunction, n as EdgeProps, H as HorizontalAlignment, l as NodeMeasured, s as NodeOperation, q as NodeOperationPipe, u as NodeOperatorFunction, k as NodePosition, m as NodeProps, p as PluginConfigs, o as Position, V as VerticalAlignment } from './shared/core.B-u2ysAC.js';
 import { Schema } from 'jsonschema';
 import { BehaviorSubject } from 'rxjs';
 import { DataManager, DataOperationPipe, DataOperation } from '@knotx/data';
@@ -93,6 +93,14 @@ interface EngineOptions<TNode extends IRecord = IRecord, TEdge extends IRecord =
     edges?: Edge<TEdge>[];
     runtime?: IEngineRuntime;
 }
+declare module '@knotx/core' {
+    interface EngineTools {
+        listPlugins: Engine['listPlugins'];
+        listPluginTools: Engine['listPluginTools'];
+        getNodes: Engine['getNodes'];
+        getEdges: Engine['getEdges'];
+    }
+}
 declare class Engine<TRenderType extends RenderType = RenderType, TNode extends IRecord = IRecord, TEdge extends IRecord = IRecord> {
     readonly runtime: IEngineRuntime;
     readonly interactionManager: InteractionManager;
@@ -107,7 +115,8 @@ declare class Engine<TRenderType extends RenderType = RenderType, TNode extends
     private edgeRenderers$;
     private _pluginDataContainer;
     private _pluginToolsContainer;
-    private toolParamsValidator;
+    private engineTools;
+    private toolParametersValidator;
     get container(): Container;
     set container(value: Container);
     get nodes(): Node<TNode>[];
@@ -135,7 +144,7 @@ declare class Engine<TRenderType extends RenderType = RenderType, TNode extends
     resetPluginData<T extends keyof PluginData>(pluginName: T): void;
     registerPluginTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, property: TP, data: {
         description: string;
-        params: Schema;
+        parameters: Schema;
         func: PluginTools[T][TP];
     }): void;
     resetPluginTool<T extends keyof PluginTools>(pluginName: T): void;
@@ -144,9 +153,12 @@ declare class Engine<TRenderType extends RenderType = RenderType, TNode extends
     canInteract(pluginId: string, type: string, autoStartPriority?: InteractionPriority): boolean;
     startInteraction(pluginId: string, type: string, priority: InteractionPriority): void;
     endInteraction(pluginId: string, type: string): void;
-    callTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, toolName: TP, ...args: Parameters<PluginTools[T][TP]>): any;
+    callTool<T extends keyof EngineTools>(engineToolName: T, ...args: Parameters<EngineTools[T]>): ReturnType<EngineTools[T]>;
+    callTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, toolName: TP, ...args: Parameters<PluginTools[T][TP]>): ReturnType<PluginTools[T][TP]>;
     listPlugins(): IPluginInfo[];
-    listPluginTools(pluginName: string): IPluginToolInfo[];
+    listPluginTools({ pluginName }: {
+        pluginName: string;
+    }): IPluginToolInfo[];
     listEngineTools(): IPluginToolInfo[];
     destroy(): void;
 }
@@ -214,4 +226,4 @@ declare function use<T, TContext>(hook: () => {
     __contextValue__: TContext;
 }, context: TContext): T;
 
-export { Container, Edge, EdgeRenderType, Engine, type EngineOptions, IEngineRuntime, IPlugin, IPluginInfo, IPluginToolInfo, IRecord, type Interaction, InteractionManager, InteractionPriority, Layer, LayerComponent, Node, NodeRenderType, Plugin, PluginData, PluginTools, RenderType, Runtime, getLayerRenders, use };
+export { Container, Edge, EdgeRenderType, Engine, type EngineOptions, type EngineTools, IEngineRuntime, IPlugin, IPluginInfo, IPluginToolInfo, IRecord, type Interaction, InteractionManager, InteractionPriority, Layer, LayerComponent, Node, NodeRenderType, Plugin, PluginData, PluginTools, RenderType, Runtime, getLayerRenders, use };

package/dist/index.js

@@ -92,17 +92,17 @@ class InteractionManager {
 }
 
 var __defProp$3 = Object.defineProperty;
-var __getOwnPropSymbols$1 = Object.getOwnPropertySymbols;
-var __hasOwnProp$1 = Object.prototype.hasOwnProperty;
-var __propIsEnum$1 = Object.prototype.propertyIsEnumerable;
+var __getOwnPropSymbols$2 = Object.getOwnPropertySymbols;
+var __hasOwnProp$2 = Object.prototype.hasOwnProperty;
+var __propIsEnum$2 = Object.prototype.propertyIsEnumerable;
 var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues$1 = (a, b) => {
+var __spreadValues$2 = (a, b) => {
   for (var prop in b || (b = {}))
-    if (__hasOwnProp$1.call(b, prop))
+    if (__hasOwnProp$2.call(b, prop))
       __defNormalProp$3(a, prop, b[prop]);
-  if (__getOwnPropSymbols$1)
-    for (var prop of __getOwnPropSymbols$1(b)) {
-      if (__propIsEnum$1.call(b, prop))
+  if (__getOwnPropSymbols$2)
+    for (var prop of __getOwnPropSymbols$2(b)) {
+      if (__propIsEnum$2.call(b, prop))
         __defNormalProp$3(a, prop, b[prop]);
     }
   return a;
@@ -112,7 +112,7 @@ function getLayerRenders(plugin) {
   const components = [];
   let isRenderConsumed = false;
   for (const [name, layer] of Object.entries((_a = Reflect.get(plugin, getSymbol("layer"))) != null ? _a : {})) {
-    components.push(__spreadValues$1({
+    components.push(__spreadValues$2({
       plugin: plugin.name,
       name: `${plugin.name}:${name}`,
       render: wrapRender(Reflect.get(plugin, name), plugin)
@@ -137,7 +137,24 @@ function wrapRender(render, plugin) {
 }
 
 var __defProp$2 = Object.defineProperty;
+var __defProps$1 = Object.defineProperties;
+var __getOwnPropDescs$1 = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols$1 = Object.getOwnPropertySymbols;
+var __hasOwnProp$1 = Object.prototype.hasOwnProperty;
+var __propIsEnum$1 = Object.prototype.propertyIsEnumerable;
 var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues$1 = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp$1.call(b, prop))
+      __defNormalProp$2(a, prop, b[prop]);
+  if (__getOwnPropSymbols$1)
+    for (var prop of __getOwnPropSymbols$1(b)) {
+      if (__propIsEnum$1.call(b, prop))
+        __defNormalProp$2(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps$1 = (a, b) => __defProps$1(a, __getOwnPropDescs$1(b));
 var __publicField$2 = (obj, key, value) => __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
 class Engine {
   constructor(options) {
@@ -154,7 +171,39 @@ class Engine {
     __publicField$2(this, "edgeRenderers$", new BehaviorSubject(/* @__PURE__ */ new Map()));
     __publicField$2(this, "_pluginDataContainer", {});
     __publicField$2(this, "_pluginToolsContainer", {});
-    __publicField$2(this, "toolParamsValidator", new Validator());
+    __publicField$2(this, "engineTools", new Map([
+      {
+        type: "function",
+        name: "listPlugins",
+        description: "List all plugins",
+        parameters: {}
+      },
+      {
+        type: "function",
+        name: "listPluginTools",
+        description: "List all tools of a plugin",
+        parameters: {
+          type: "object",
+          properties: {
+            pluginName: { type: "string" }
+          },
+          required: ["pluginName"]
+        }
+      },
+      {
+        type: "function",
+        name: "getNodes",
+        description: "Get all nodes",
+        parameters: {}
+      },
+      {
+        type: "function",
+        name: "getEdges",
+        description: "Get all edges",
+        parameters: {}
+      }
+    ].map((tool) => [tool.name, tool])));
+    __publicField$2(this, "toolParametersValidator", new Validator());
     var _a;
     this.runtime = (_a = options.runtime) != null ? _a : {};
     this.container$.next(options.container);
@@ -303,18 +352,26 @@ class Engine {
   endInteraction(pluginId, type) {
     this.interactionManager.endInteraction(pluginId, type);
   }
-  callTool(pluginName, toolName, ...args) {
-    const toolDefinition = get(this, ["_pluginToolsContainer", pluginName, toolName]);
+  callTool(pluginNameOrEngineToolName, ...args) {
+    let toolDefinition;
+    let toolDisplayName;
+    if (this.engineTools.has(pluginNameOrEngineToolName)) {
+      toolDefinition = __spreadProps$1(__spreadValues$1({}, this.engineTools.get(pluginNameOrEngineToolName)), { func: this[pluginNameOrEngineToolName].bind(this) });
+      toolDisplayName = toolDefinition.name;
+    } else {
+      toolDefinition = get(this, ["_pluginToolsContainer", pluginNameOrEngineToolName, args == null ? void 0 : args[0]]);
+      toolDisplayName = `${pluginNameOrEngineToolName}.${args == null ? void 0 : args[0]}`;
+    }
     const tool = toolDefinition == null ? void 0 : toolDefinition.func;
     if (!tool || typeof tool !== "function") {
-      throw new Error(`Tool ${String(toolName)} not found in plugin ${pluginName}`);
+      throw new Error(`Tool ${String(toolDisplayName)} not found`);
     }
-    const params = args[0];
-    const validator = this.toolParamsValidator.validate(params, toolDefinition.params);
+    const parameters = args[args.length - 1];
+    const validator = this.toolParametersValidator.validate(parameters, toolDefinition.parameters);
     if (validator.errors.length > 0) {
-      throw new Error(`Invalid tool params: ${validator.errors.map((e) => e.stack).join(", ")}`);
+      throw new Error(`Invalid tool parameters: ${validator.errors.map((e) => e.stack).join(", ")}`);
     }
-    return tool(params);
+    return tool(parameters);
   }
   listPlugins() {
     return Array.from(this.plugins$.value.values()).map((plugin) => ({
@@ -322,35 +379,16 @@ class Engine {
       description: plugin.description
     }));
   }
-  listPluginTools(pluginName) {
+  listPluginTools({ pluginName }) {
     return Object.entries(get(this, ["_pluginToolsContainer", pluginName]) || {}).map(([toolName, toolDefinition]) => ({
       type: "function",
       name: toolName,
       description: toolDefinition.description,
-      parameters: toolDefinition.params
+      parameters: toolDefinition.parameters
     }));
   }
   listEngineTools() {
-    return [
-      {
-        type: "function",
-        name: "listPlugins",
-        description: "List all plugins",
-        parameters: {}
-      },
-      {
-        type: "function",
-        name: "listPluginTools",
-        description: "List all tools of a plugin",
-        parameters: {
-          type: "object",
-          properties: {
-            pluginName: { type: "string" }
-          },
-          required: ["pluginName"]
-        }
-      }
-    ];
+    return Array.from(this.engineTools.values());
   }
   destroy() {
     this.plugins$.value.forEach((plugin) => {
@@ -441,9 +479,12 @@ const _Runtime = class _Runtime {
       type,
       value: contextValue
     };
-    const result = handler();
-    this.currentContext = void 0;
-    return result;
+    try {
+      const result = handler();
+      return result;
+    } finally {
+      this.currentContext = void 0;
+    }
   }
   /**
    * 值处理器

package/dist/shared/{core.Cwp_TTTs.d.cts → core.B-u2ysAC.d.cts}

@@ -117,6 +117,8 @@ interface PluginData {
  */
 interface PluginTools {
 }
+interface EngineTools {
+}
 interface IPluginInfo {
     name: string;
     description?: string;
@@ -143,4 +145,4 @@ interface IEngineRuntime {
     };
 }
 
-export { BasePlugin as B, type Container as C, type Edge as E, type HorizontalAlignment as H, type IRecord as I, type LayerComponent as L, type Node as N, type Plugin as P, type RenderType as R, type VerticalAlignment as V, type IEngineRuntime as a, type IPlugin as b, Layer as c, type NodeRenderType as d, type EdgeRenderType as e, type PluginData as f, type PluginTools as g, type IPluginInfo as h, type IPluginToolInfo as i, type NodePosition as j, type NodeMeasured as k, type NodeProps as l, type EdgeProps as m, type Position as n, type PluginConfigs as o, type NodeOperationPipe as p, type EdgeOperationPipe as q, type NodeOperation as r, type EdgeOperation as s, type NodeOperatorFunction as t, type EdgeOperatorFunction as u };
+export { BasePlugin as B, type Container as C, type Edge as E, type HorizontalAlignment as H, type IRecord as I, type LayerComponent as L, type Node as N, type Plugin as P, type RenderType as R, type VerticalAlignment as V, type IEngineRuntime as a, type IPlugin as b, Layer as c, type NodeRenderType as d, type EdgeRenderType as e, type PluginData as f, type PluginTools as g, type EngineTools as h, type IPluginInfo as i, type IPluginToolInfo as j, type NodePosition as k, type NodeMeasured as l, type NodeProps as m, type EdgeProps as n, type Position as o, type PluginConfigs as p, type NodeOperationPipe as q, type EdgeOperationPipe as r, type NodeOperation as s, type EdgeOperation as t, type NodeOperatorFunction as u, type EdgeOperatorFunction as v };

package/dist/shared/{core.Cwp_TTTs.d.mts → core.B-u2ysAC.d.mts}

@@ -117,6 +117,8 @@ interface PluginData {
  */
 interface PluginTools {
 }
+interface EngineTools {
+}
 interface IPluginInfo {
     name: string;
     description?: string;
@@ -143,4 +145,4 @@ interface IEngineRuntime {
     };
 }
 
-export { BasePlugin as B, type Container as C, type Edge as E, type HorizontalAlignment as H, type IRecord as I, type LayerComponent as L, type Node as N, type Plugin as P, type RenderType as R, type VerticalAlignment as V, type IEngineRuntime as a, type IPlugin as b, Layer as c, type NodeRenderType as d, type EdgeRenderType as e, type PluginData as f, type PluginTools as g, type IPluginInfo as h, type IPluginToolInfo as i, type NodePosition as j, type NodeMeasured as k, type NodeProps as l, type EdgeProps as m, type Position as n, type PluginConfigs as o, type NodeOperationPipe as p, type EdgeOperationPipe as q, type NodeOperation as r, type EdgeOperation as s, type NodeOperatorFunction as t, type EdgeOperatorFunction as u };
+export { BasePlugin as B, type Container as C, type Edge as E, type HorizontalAlignment as H, type IRecord as I, type LayerComponent as L, type Node as N, type Plugin as P, type RenderType as R, type VerticalAlignment as V, type IEngineRuntime as a, type IPlugin as b, Layer as c, type NodeRenderType as d, type EdgeRenderType as e, type PluginData as f, type PluginTools as g, type EngineTools as h, type IPluginInfo as i, type IPluginToolInfo as j, type NodePosition as k, type NodeMeasured as l, type NodeProps as m, type EdgeProps as n, type Position as o, type PluginConfigs as p, type NodeOperationPipe as q, type EdgeOperationPipe as r, type NodeOperation as s, type EdgeOperation as t, type NodeOperatorFunction as u, type EdgeOperatorFunction as v };

package/dist/shared/{core.Cwp_TTTs.d.ts → core.B-u2ysAC.d.ts}

@@ -117,6 +117,8 @@ interface PluginData {
  */
 interface PluginTools {
 }
+interface EngineTools {
+}
 interface IPluginInfo {
     name: string;
     description?: string;
@@ -143,4 +145,4 @@ interface IEngineRuntime {
     };
 }
 
-export { BasePlugin as B, type Container as C, type Edge as E, type HorizontalAlignment as H, type IRecord as I, type LayerComponent as L, type Node as N, type Plugin as P, type RenderType as R, type VerticalAlignment as V, type IEngineRuntime as a, type IPlugin as b, Layer as c, type NodeRenderType as d, type EdgeRenderType as e, type PluginData as f, type PluginTools as g, type IPluginInfo as h, type IPluginToolInfo as i, type NodePosition as j, type NodeMeasured as k, type NodeProps as l, type EdgeProps as m, type Position as n, type PluginConfigs as o, type NodeOperationPipe as p, type EdgeOperationPipe as q, type NodeOperation as r, type EdgeOperation as s, type NodeOperatorFunction as t, type EdgeOperatorFunction as u };
+export { BasePlugin as B, type Container as C, type Edge as E, type HorizontalAlignment as H, type IRecord as I, type LayerComponent as L, type Node as N, type Plugin as P, type RenderType as R, type VerticalAlignment as V, type IEngineRuntime as a, type IPlugin as b, Layer as c, type NodeRenderType as d, type EdgeRenderType as e, type PluginData as f, type PluginTools as g, type EngineTools as h, type IPluginInfo as i, type IPluginToolInfo as j, type NodePosition as k, type NodeMeasured as l, type NodeProps as m, type EdgeProps as n, type Position as o, type PluginConfigs as p, type NodeOperationPipe as q, type EdgeOperationPipe as r, type NodeOperation as s, type EdgeOperation as t, type NodeOperatorFunction as u, type EdgeOperatorFunction as v };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knotx/core",
-  "version": "0.2.12",
+  "version": "0.2.14",
   "description": "Core for Knotx",
   "author": "boenfu",
   "license": "MIT",
@@ -46,14 +46,14 @@
     "jsonschema": "^1.5.0",
     "lodash-es": "^4.17.21",
     "rxjs": "^7.8.1",
-    "@knotx/data": "0.2.11",
-    "@knotx/utils": "0.2.11"
+    "@knotx/data": "0.2.13",
+    "@knotx/utils": "0.2.13"
   },
   "devDependencies": {
     "@types/lodash-es": "^4.17.12",
-    "@knotx/build-config": "0.2.11",
-    "@knotx/eslint-config": "0.2.11",
-    "@knotx/typescript-config": "0.2.11"
+    "@knotx/build-config": "0.2.13",
+    "@knotx/eslint-config": "0.2.13",
+    "@knotx/typescript-config": "0.2.13"
   },
   "scripts": {
     "build": "unbuild",