@knotx/decorators 0.2.5 → 0.2.7

package/dist/index.cjs

@@ -312,78 +312,6 @@ function createInjectProxy(...presets) {
 }
 const inject = createInjectProxy();
 
-function observable() {
-  return function(_, context) {
-    if (context.static || typeof context.name !== "string") {
-      return;
-    }
-    context.addInitializer(function() {
-      const behaviorKey = getPropertyBehaviorSubjectKey(context.name);
-      if (createBehaviorSubject(this, behaviorKey, this[context.name])) {
-        subscribeEngine.call(this, (engine) => {
-          Reflect.defineProperty(this, context.name, {
-            get() {
-              return core.Runtime.getInstance().getValue(engine, {
-                paths: [],
-                matcher: () => this[behaviorKey]
-              });
-            },
-            set(value) {
-              this[behaviorKey].next(value);
-            }
-          });
-        });
-      }
-    });
-  };
-}
-
-function config() {
-  return function(_, context) {
-    if (context.static) {
-      return;
-    }
-    observable()(_, context);
-    context.addInitializer(function() {
-      const updateConfig = (config2) => {
-        this[context.name] = config2;
-      };
-      mergePluginHookFunction.call(this, "onInit", updateConfig);
-      mergePluginHookFunction.call(this, "onConfigChange", updateConfig);
-    });
-  };
-}
-
-function OnInit(_, context) {
-  context.addInitializer(function() {
-    mergePluginHookFunction.call(this, "onInit", this[context.name]);
-  });
-}
-function OnDestroy(_, context) {
-  context.addInitializer(function() {
-    mergePluginHookFunction.call(this, "onDestroy", this[context.name]);
-  });
-}
-function OnConfigChange(_, context) {
-  context.addInitializer(function() {
-    mergePluginHookFunction.call(this, "onConfigChange", this[context.name]);
-  });
-}
-
-function register(property) {
-  return function(_, context) {
-    if (context.static) {
-      return;
-    }
-    observable()(_, context);
-    context.addInitializer(function() {
-      subscribeEngine.call(this, (engine) => {
-        engine.registerPluginData(this.name, property, this[getPropertyBehaviorSubjectKey(context.name)]);
-      });
-    });
-  };
-}
-
 function layer(layer2, offset) {
   return function(_, context) {
     if (context.static) {
@@ -562,6 +490,95 @@ function nodeType(type) {
   };
 }
 
+function observable() {
+  return function(_, context) {
+    if (context.static || typeof context.name !== "string") {
+      return;
+    }
+    context.addInitializer(function() {
+      const behaviorKey = getPropertyBehaviorSubjectKey(context.name);
+      if (createBehaviorSubject(this, behaviorKey, this[context.name])) {
+        subscribeEngine.call(this, (engine) => {
+          Reflect.defineProperty(this, context.name, {
+            get() {
+              return core.Runtime.getInstance().getValue(engine, {
+                paths: [],
+                matcher: () => this[behaviorKey]
+              });
+            },
+            set(value) {
+              this[behaviorKey].next(value);
+            }
+          });
+        });
+      }
+    });
+  };
+}
+
+function config() {
+  return function(_, context) {
+    if (context.static) {
+      return;
+    }
+    observable()(_, context);
+    context.addInitializer(function() {
+      const updateConfig = (config2) => {
+        this[context.name] = config2;
+      };
+      mergePluginHookFunction.call(this, "onInit", updateConfig);
+      mergePluginHookFunction.call(this, "onConfigChange", updateConfig);
+    });
+  };
+}
+
+function OnInit(_, context) {
+  context.addInitializer(function() {
+    mergePluginHookFunction.call(this, "onInit", this[context.name]);
+  });
+}
+function OnDestroy(_, context) {
+  context.addInitializer(function() {
+    mergePluginHookFunction.call(this, "onDestroy", this[context.name]);
+  });
+}
+function OnConfigChange(_, context) {
+  context.addInitializer(function() {
+    mergePluginHookFunction.call(this, "onConfigChange", this[context.name]);
+  });
+}
+
+function register(property) {
+  return function(_, context) {
+    if (context.static) {
+      return;
+    }
+    observable()(_, context);
+    context.addInitializer(function() {
+      subscribeEngine.call(this, (engine) => {
+        engine.registerPluginData(this.name, property, this[getPropertyBehaviorSubjectKey(context.name)]);
+      });
+    });
+  };
+}
+
+function tool(description, params) {
+  return function(_, context) {
+    if (context.static) {
+      return;
+    }
+    context.addInitializer(function() {
+      subscribeEngine.call(this, (engine) => {
+        engine.registerPluginTool(this.name, context.name, {
+          description,
+          params,
+          func: this[context.name].bind(this)
+        });
+      });
+    });
+  };
+}
+
 exports.OnConfigChange = OnConfigChange;
 exports.OnDestroy = OnDestroy;
 exports.OnInit = OnInit;
@@ -578,3 +595,4 @@ exports.nodeType = nodeType;
 exports.observable = observable;
 exports.panel = panel;
 exports.register = register;
+exports.tool = tool;

package/dist/index.d.cts

@@ -1,4 +1,5 @@
-import { BasePlugin, RenderType, IPlugin, EdgeOperatorFunction, EdgeOperationPipe, EdgeRenderType, Engine, PluginData, Layer, VerticalAlignment, HorizontalAlignment, Container, NodeOperatorFunction, NodeOperationPipe, NodeRenderType } from '@knotx/core';
+import { BasePlugin, RenderType, IPlugin, EdgeOperatorFunction, EdgeOperationPipe, EdgeRenderType, Engine, PluginData, Layer, VerticalAlignment, HorizontalAlignment, Container, NodeOperatorFunction, NodeOperationPipe, NodeRenderType, PluginTools } from '@knotx/core';
+import { Schema } from 'jsonschema';
 
 interface IInternalPlugin<TPluginName extends string = string, TRenderType extends RenderType = RenderType> extends IPlugin<TPluginName, any, TRenderType> {
 }
@@ -231,23 +232,6 @@ type InjectDecorator = InjectDecoratorInjectableDataType & InjectDecoratorInject
  */
 declare const inject: InjectDecorator;
 
-/**
- * 注册插件属性装饰器
- *
- * 用于将插件的属性注册到引擎中，使其他插件可以通过 inject 访问该属性
- * 支持装饰字段和 getter，当装饰字段时，属性值变化会自动通知订阅者
- *
- * @param property 要注册的属性名
- * @returns 类字段或 getter 装饰器函数
- * @example
- * ```
- * // 注册字段
- * @register('canUndo')
- * canUndo = false
- * ```
- */
-declare function register<K extends string, TN extends keyof PluginData, TP extends keyof PluginData[TN]>(property: TP): (_: any, context: CFDC<K, PluginData[TN][TP], TN>) => void;
-
 declare function layer<K extends string>(layer: Layer, offset?: number): (_: any, context: CMDC<K, () => void>) => void;
 
 /**
@@ -374,4 +358,79 @@ declare function OnConfigChange<K extends string, TPluginConfig extends Record<s
 
 declare function observable<K extends string, T>(): (_: any, context: CFDC<K, T>) => void;
 
-export { type InjectDecorator, type InjectDecoratorCallableDataType, type InjectDecoratorCallableMethodType, type InjectDecoratorCallablePluginDataType, type InjectDecoratorInjectableDataType, type InjectDecoratorInjectableMethodType, type InjectDecoratorInjectablePluginDataType, type InjectDecoratorInjectableType, type InjectWithContext, type Injectable, type InjectableDataKey, type InjectableMethodKey, OnConfigChange, OnDestroy, OnInit, type PanelOffset, type PanelPosition, config, createPanelWrapper, edgeOperator, edgePipe, edgeType, inject, layer, nodeOperator, nodePipe, nodeType, observable, panel, register };
+/**
+ * 注册插件属性装饰器
+ *
+ * 用于将插件的属性注册到引擎中，使其他插件可以通过 inject 访问该属性
+ * 支持装饰字段和 getter，当装饰字段时，属性值变化会自动通知订阅者
+ *
+ * @param property 要注册的属性名
+ * @returns 类字段或 getter 装饰器函数
+ * @example
+ * ```
+ * // 注册字段
+ * @register('canUndo')
+ * canUndo = false
+ * ```
+ */
+declare function register<K extends string, TN extends keyof PluginData, TP extends keyof PluginData[TN]>(property: TP): (_: any, context: CFDC<K, PluginData[TN][TP], TN>) => void;
+
+/**
+ * 工具函数参数定义
+ */
+interface ToolParams {
+    description: string;
+    params: Schema;
+}
+/**
+ * 从JSONSchema推断参数类型的辅助类型
+ */
+type InferParamsFromSchema<T extends Schema> = T extends {
+    type: 'object';
+    properties: infer P;
+    required?: infer R;
+} ? {
+    [K in keyof P as K extends Extract<R extends string[] ? R[number] : never, string> ? K : never]: InferSchemaType<P[K]>;
+} & {
+    [K in keyof P as K extends Extract<R extends string[] ? R[number] : never, string> ? never : K]?: InferSchemaType<P[K]>;
+} : T extends {
+    type: 'array';
+    items: infer I;
+} ? Array<InferSchemaType<I>> : T extends {
+    type: 'string';
+} ? string : T extends {
+    type: 'number';
+} ? number : T extends {
+    type: 'boolean';
+} ? boolean : T extends {
+    type: 'null';
+} ? null : T extends {
+    type: 'integer';
+} ? number : any;
+/**
+ * 从 JSONSchema 推断类型的辅助类型
+ */
+type InferSchemaType<T> = T extends Schema ? InferParamsFromSchema<T> : any;
+/**
+ * 工具函数装饰器
+ *
+ * 用于装饰插件中的工具函数，使其能被 engine 和其他 plugin 调用
+ *
+ * @param description 工具函数描述
+ * @param params 工具函数参数
+ * @returns 方法装饰器函数
+ * @example
+ * ```
+ * class MyPlugin extends BasePlugin {
+ *   @tool('calculateDistance')
+ *   calculateDistance(params: { x1: number, y1: number, x2: number, y2: number }): number {
+ *     const dx = params.x2 - params.x1;
+ *     const dy = params.y2 - params.y1;
+ *     return Math.sqrt(dx * dx + dy * dy);
+ *   }
+ * }
+ * ```
+ */
+declare function tool<TN extends keyof PluginTools, TP extends keyof PluginTools[TN], TS extends Schema>(description: string, params: TS): (_: any, context: CMDC<Extract<TP, string>, PluginTools[TN][TP], TN>) => void;
+
+export { type InferParamsFromSchema, type InferSchemaType, type InjectDecorator, type InjectDecoratorCallableDataType, type InjectDecoratorCallableMethodType, type InjectDecoratorCallablePluginDataType, type InjectDecoratorInjectableDataType, type InjectDecoratorInjectableMethodType, type InjectDecoratorInjectablePluginDataType, type InjectDecoratorInjectableType, type InjectWithContext, type Injectable, type InjectableDataKey, type InjectableMethodKey, OnConfigChange, OnDestroy, OnInit, type PanelOffset, type PanelPosition, type ToolParams, config, createPanelWrapper, edgeOperator, edgePipe, edgeType, inject, layer, nodeOperator, nodePipe, nodeType, observable, panel, register, tool };

package/dist/index.d.mts

@@ -1,4 +1,5 @@
-import { BasePlugin, RenderType, IPlugin, EdgeOperatorFunction, EdgeOperationPipe, EdgeRenderType, Engine, PluginData, Layer, VerticalAlignment, HorizontalAlignment, Container, NodeOperatorFunction, NodeOperationPipe, NodeRenderType } from '@knotx/core';
+import { BasePlugin, RenderType, IPlugin, EdgeOperatorFunction, EdgeOperationPipe, EdgeRenderType, Engine, PluginData, Layer, VerticalAlignment, HorizontalAlignment, Container, NodeOperatorFunction, NodeOperationPipe, NodeRenderType, PluginTools } from '@knotx/core';
+import { Schema } from 'jsonschema';
 
 interface IInternalPlugin<TPluginName extends string = string, TRenderType extends RenderType = RenderType> extends IPlugin<TPluginName, any, TRenderType> {
 }
@@ -231,23 +232,6 @@ type InjectDecorator = InjectDecoratorInjectableDataType & InjectDecoratorInject
  */
 declare const inject: InjectDecorator;
 
-/**
- * 注册插件属性装饰器
- *
- * 用于将插件的属性注册到引擎中，使其他插件可以通过 inject 访问该属性
- * 支持装饰字段和 getter，当装饰字段时，属性值变化会自动通知订阅者
- *
- * @param property 要注册的属性名
- * @returns 类字段或 getter 装饰器函数
- * @example
- * ```
- * // 注册字段
- * @register('canUndo')
- * canUndo = false
- * ```
- */
-declare function register<K extends string, TN extends keyof PluginData, TP extends keyof PluginData[TN]>(property: TP): (_: any, context: CFDC<K, PluginData[TN][TP], TN>) => void;
-
 declare function layer<K extends string>(layer: Layer, offset?: number): (_: any, context: CMDC<K, () => void>) => void;
 
 /**
@@ -374,4 +358,79 @@ declare function OnConfigChange<K extends string, TPluginConfig extends Record<s
 
 declare function observable<K extends string, T>(): (_: any, context: CFDC<K, T>) => void;
 
-export { type InjectDecorator, type InjectDecoratorCallableDataType, type InjectDecoratorCallableMethodType, type InjectDecoratorCallablePluginDataType, type InjectDecoratorInjectableDataType, type InjectDecoratorInjectableMethodType, type InjectDecoratorInjectablePluginDataType, type InjectDecoratorInjectableType, type InjectWithContext, type Injectable, type InjectableDataKey, type InjectableMethodKey, OnConfigChange, OnDestroy, OnInit, type PanelOffset, type PanelPosition, config, createPanelWrapper, edgeOperator, edgePipe, edgeType, inject, layer, nodeOperator, nodePipe, nodeType, observable, panel, register };
+/**
+ * 注册插件属性装饰器
+ *
+ * 用于将插件的属性注册到引擎中，使其他插件可以通过 inject 访问该属性
+ * 支持装饰字段和 getter，当装饰字段时，属性值变化会自动通知订阅者
+ *
+ * @param property 要注册的属性名
+ * @returns 类字段或 getter 装饰器函数
+ * @example
+ * ```
+ * // 注册字段
+ * @register('canUndo')
+ * canUndo = false
+ * ```
+ */
+declare function register<K extends string, TN extends keyof PluginData, TP extends keyof PluginData[TN]>(property: TP): (_: any, context: CFDC<K, PluginData[TN][TP], TN>) => void;
+
+/**
+ * 工具函数参数定义
+ */
+interface ToolParams {
+    description: string;
+    params: Schema;
+}
+/**
+ * 从JSONSchema推断参数类型的辅助类型
+ */
+type InferParamsFromSchema<T extends Schema> = T extends {
+    type: 'object';
+    properties: infer P;
+    required?: infer R;
+} ? {
+    [K in keyof P as K extends Extract<R extends string[] ? R[number] : never, string> ? K : never]: InferSchemaType<P[K]>;
+} & {
+    [K in keyof P as K extends Extract<R extends string[] ? R[number] : never, string> ? never : K]?: InferSchemaType<P[K]>;
+} : T extends {
+    type: 'array';
+    items: infer I;
+} ? Array<InferSchemaType<I>> : T extends {
+    type: 'string';
+} ? string : T extends {
+    type: 'number';
+} ? number : T extends {
+    type: 'boolean';
+} ? boolean : T extends {
+    type: 'null';
+} ? null : T extends {
+    type: 'integer';
+} ? number : any;
+/**
+ * 从 JSONSchema 推断类型的辅助类型
+ */
+type InferSchemaType<T> = T extends Schema ? InferParamsFromSchema<T> : any;
+/**
+ * 工具函数装饰器
+ *
+ * 用于装饰插件中的工具函数，使其能被 engine 和其他 plugin 调用
+ *
+ * @param description 工具函数描述
+ * @param params 工具函数参数
+ * @returns 方法装饰器函数
+ * @example
+ * ```
+ * class MyPlugin extends BasePlugin {
+ *   @tool('calculateDistance')
+ *   calculateDistance(params: { x1: number, y1: number, x2: number, y2: number }): number {
+ *     const dx = params.x2 - params.x1;
+ *     const dy = params.y2 - params.y1;
+ *     return Math.sqrt(dx * dx + dy * dy);
+ *   }
+ * }
+ * ```
+ */
+declare function tool<TN extends keyof PluginTools, TP extends keyof PluginTools[TN], TS extends Schema>(description: string, params: TS): (_: any, context: CMDC<Extract<TP, string>, PluginTools[TN][TP], TN>) => void;
+
+export { type InferParamsFromSchema, type InferSchemaType, type InjectDecorator, type InjectDecoratorCallableDataType, type InjectDecoratorCallableMethodType, type InjectDecoratorCallablePluginDataType, type InjectDecoratorInjectableDataType, type InjectDecoratorInjectableMethodType, type InjectDecoratorInjectablePluginDataType, type InjectDecoratorInjectableType, type InjectWithContext, type Injectable, type InjectableDataKey, type InjectableMethodKey, OnConfigChange, OnDestroy, OnInit, type PanelOffset, type PanelPosition, type ToolParams, config, createPanelWrapper, edgeOperator, edgePipe, edgeType, inject, layer, nodeOperator, nodePipe, nodeType, observable, panel, register, tool };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { BasePlugin, RenderType, IPlugin, EdgeOperatorFunction, EdgeOperationPipe, EdgeRenderType, Engine, PluginData, Layer, VerticalAlignment, HorizontalAlignment, Container, NodeOperatorFunction, NodeOperationPipe, NodeRenderType } from '@knotx/core';
+import { BasePlugin, RenderType, IPlugin, EdgeOperatorFunction, EdgeOperationPipe, EdgeRenderType, Engine, PluginData, Layer, VerticalAlignment, HorizontalAlignment, Container, NodeOperatorFunction, NodeOperationPipe, NodeRenderType, PluginTools } from '@knotx/core';
+import { Schema } from 'jsonschema';
 
 interface IInternalPlugin<TPluginName extends string = string, TRenderType extends RenderType = RenderType> extends IPlugin<TPluginName, any, TRenderType> {
 }
@@ -231,23 +232,6 @@ type InjectDecorator = InjectDecoratorInjectableDataType & InjectDecoratorInject
  */
 declare const inject: InjectDecorator;
 
-/**
- * 注册插件属性装饰器
- *
- * 用于将插件的属性注册到引擎中，使其他插件可以通过 inject 访问该属性
- * 支持装饰字段和 getter，当装饰字段时，属性值变化会自动通知订阅者
- *
- * @param property 要注册的属性名
- * @returns 类字段或 getter 装饰器函数
- * @example
- * ```
- * // 注册字段
- * @register('canUndo')
- * canUndo = false
- * ```
- */
-declare function register<K extends string, TN extends keyof PluginData, TP extends keyof PluginData[TN]>(property: TP): (_: any, context: CFDC<K, PluginData[TN][TP], TN>) => void;
-
 declare function layer<K extends string>(layer: Layer, offset?: number): (_: any, context: CMDC<K, () => void>) => void;
 
 /**
@@ -374,4 +358,79 @@ declare function OnConfigChange<K extends string, TPluginConfig extends Record<s
 
 declare function observable<K extends string, T>(): (_: any, context: CFDC<K, T>) => void;
 
-export { type InjectDecorator, type InjectDecoratorCallableDataType, type InjectDecoratorCallableMethodType, type InjectDecoratorCallablePluginDataType, type InjectDecoratorInjectableDataType, type InjectDecoratorInjectableMethodType, type InjectDecoratorInjectablePluginDataType, type InjectDecoratorInjectableType, type InjectWithContext, type Injectable, type InjectableDataKey, type InjectableMethodKey, OnConfigChange, OnDestroy, OnInit, type PanelOffset, type PanelPosition, config, createPanelWrapper, edgeOperator, edgePipe, edgeType, inject, layer, nodeOperator, nodePipe, nodeType, observable, panel, register };
+/**
+ * 注册插件属性装饰器
+ *
+ * 用于将插件的属性注册到引擎中，使其他插件可以通过 inject 访问该属性
+ * 支持装饰字段和 getter，当装饰字段时，属性值变化会自动通知订阅者
+ *
+ * @param property 要注册的属性名
+ * @returns 类字段或 getter 装饰器函数
+ * @example
+ * ```
+ * // 注册字段
+ * @register('canUndo')
+ * canUndo = false
+ * ```
+ */
+declare function register<K extends string, TN extends keyof PluginData, TP extends keyof PluginData[TN]>(property: TP): (_: any, context: CFDC<K, PluginData[TN][TP], TN>) => void;
+
+/**
+ * 工具函数参数定义
+ */
+interface ToolParams {
+    description: string;
+    params: Schema;
+}
+/**
+ * 从JSONSchema推断参数类型的辅助类型
+ */
+type InferParamsFromSchema<T extends Schema> = T extends {
+    type: 'object';
+    properties: infer P;
+    required?: infer R;
+} ? {
+    [K in keyof P as K extends Extract<R extends string[] ? R[number] : never, string> ? K : never]: InferSchemaType<P[K]>;
+} & {
+    [K in keyof P as K extends Extract<R extends string[] ? R[number] : never, string> ? never : K]?: InferSchemaType<P[K]>;
+} : T extends {
+    type: 'array';
+    items: infer I;
+} ? Array<InferSchemaType<I>> : T extends {
+    type: 'string';
+} ? string : T extends {
+    type: 'number';
+} ? number : T extends {
+    type: 'boolean';
+} ? boolean : T extends {
+    type: 'null';
+} ? null : T extends {
+    type: 'integer';
+} ? number : any;
+/**
+ * 从 JSONSchema 推断类型的辅助类型
+ */
+type InferSchemaType<T> = T extends Schema ? InferParamsFromSchema<T> : any;
+/**
+ * 工具函数装饰器
+ *
+ * 用于装饰插件中的工具函数，使其能被 engine 和其他 plugin 调用
+ *
+ * @param description 工具函数描述
+ * @param params 工具函数参数
+ * @returns 方法装饰器函数
+ * @example
+ * ```
+ * class MyPlugin extends BasePlugin {
+ *   @tool('calculateDistance')
+ *   calculateDistance(params: { x1: number, y1: number, x2: number, y2: number }): number {
+ *     const dx = params.x2 - params.x1;
+ *     const dy = params.y2 - params.y1;
+ *     return Math.sqrt(dx * dx + dy * dy);
+ *   }
+ * }
+ * ```
+ */
+declare function tool<TN extends keyof PluginTools, TP extends keyof PluginTools[TN], TS extends Schema>(description: string, params: TS): (_: any, context: CMDC<Extract<TP, string>, PluginTools[TN][TP], TN>) => void;
+
+export { type InferParamsFromSchema, type InferSchemaType, type InjectDecorator, type InjectDecoratorCallableDataType, type InjectDecoratorCallableMethodType, type InjectDecoratorCallablePluginDataType, type InjectDecoratorInjectableDataType, type InjectDecoratorInjectableMethodType, type InjectDecoratorInjectablePluginDataType, type InjectDecoratorInjectableType, type InjectWithContext, type Injectable, type InjectableDataKey, type InjectableMethodKey, OnConfigChange, OnDestroy, OnInit, type PanelOffset, type PanelPosition, type ToolParams, config, createPanelWrapper, edgeOperator, edgePipe, edgeType, inject, layer, nodeOperator, nodePipe, nodeType, observable, panel, register, tool };

package/dist/index.js

@@ -310,78 +310,6 @@ function createInjectProxy(...presets) {
 }
 const inject = createInjectProxy();
 
-function observable() {
-  return function(_, context) {
-    if (context.static || typeof context.name !== "string") {
-      return;
-    }
-    context.addInitializer(function() {
-      const behaviorKey = getPropertyBehaviorSubjectKey(context.name);
-      if (createBehaviorSubject(this, behaviorKey, this[context.name])) {
-        subscribeEngine.call(this, (engine) => {
-          Reflect.defineProperty(this, context.name, {
-            get() {
-              return Runtime.getInstance().getValue(engine, {
-                paths: [],
-                matcher: () => this[behaviorKey]
-              });
-            },
-            set(value) {
-              this[behaviorKey].next(value);
-            }
-          });
-        });
-      }
-    });
-  };
-}
-
-function config() {
-  return function(_, context) {
-    if (context.static) {
-      return;
-    }
-    observable()(_, context);
-    context.addInitializer(function() {
-      const updateConfig = (config2) => {
-        this[context.name] = config2;
-      };
-      mergePluginHookFunction.call(this, "onInit", updateConfig);
-      mergePluginHookFunction.call(this, "onConfigChange", updateConfig);
-    });
-  };
-}
-
-function OnInit(_, context) {
-  context.addInitializer(function() {
-    mergePluginHookFunction.call(this, "onInit", this[context.name]);
-  });
-}
-function OnDestroy(_, context) {
-  context.addInitializer(function() {
-    mergePluginHookFunction.call(this, "onDestroy", this[context.name]);
-  });
-}
-function OnConfigChange(_, context) {
-  context.addInitializer(function() {
-    mergePluginHookFunction.call(this, "onConfigChange", this[context.name]);
-  });
-}
-
-function register(property) {
-  return function(_, context) {
-    if (context.static) {
-      return;
-    }
-    observable()(_, context);
-    context.addInitializer(function() {
-      subscribeEngine.call(this, (engine) => {
-        engine.registerPluginData(this.name, property, this[getPropertyBehaviorSubjectKey(context.name)]);
-      });
-    });
-  };
-}
-
 function layer(layer2, offset) {
   return function(_, context) {
     if (context.static) {
@@ -560,4 +488,93 @@ function nodeType(type) {
   };
 }
 
-export { OnConfigChange, OnDestroy, OnInit, config, createPanelWrapper, edgeOperator, edgePipe, edgeType, inject, layer, nodeOperator, nodePipe, nodeType, observable, panel, register };
+function observable() {
+  return function(_, context) {
+    if (context.static || typeof context.name !== "string") {
+      return;
+    }
+    context.addInitializer(function() {
+      const behaviorKey = getPropertyBehaviorSubjectKey(context.name);
+      if (createBehaviorSubject(this, behaviorKey, this[context.name])) {
+        subscribeEngine.call(this, (engine) => {
+          Reflect.defineProperty(this, context.name, {
+            get() {
+              return Runtime.getInstance().getValue(engine, {
+                paths: [],
+                matcher: () => this[behaviorKey]
+              });
+            },
+            set(value) {
+              this[behaviorKey].next(value);
+            }
+          });
+        });
+      }
+    });
+  };
+}
+
+function config() {
+  return function(_, context) {
+    if (context.static) {
+      return;
+    }
+    observable()(_, context);
+    context.addInitializer(function() {
+      const updateConfig = (config2) => {
+        this[context.name] = config2;
+      };
+      mergePluginHookFunction.call(this, "onInit", updateConfig);
+      mergePluginHookFunction.call(this, "onConfigChange", updateConfig);
+    });
+  };
+}
+
+function OnInit(_, context) {
+  context.addInitializer(function() {
+    mergePluginHookFunction.call(this, "onInit", this[context.name]);
+  });
+}
+function OnDestroy(_, context) {
+  context.addInitializer(function() {
+    mergePluginHookFunction.call(this, "onDestroy", this[context.name]);
+  });
+}
+function OnConfigChange(_, context) {
+  context.addInitializer(function() {
+    mergePluginHookFunction.call(this, "onConfigChange", this[context.name]);
+  });
+}
+
+function register(property) {
+  return function(_, context) {
+    if (context.static) {
+      return;
+    }
+    observable()(_, context);
+    context.addInitializer(function() {
+      subscribeEngine.call(this, (engine) => {
+        engine.registerPluginData(this.name, property, this[getPropertyBehaviorSubjectKey(context.name)]);
+      });
+    });
+  };
+}
+
+function tool(description, params) {
+  return function(_, context) {
+    if (context.static) {
+      return;
+    }
+    context.addInitializer(function() {
+      subscribeEngine.call(this, (engine) => {
+        engine.registerPluginTool(this.name, context.name, {
+          description,
+          params,
+          func: this[context.name].bind(this)
+        });
+      });
+    });
+  };
+}
+
+export { OnConfigChange, OnDestroy, OnInit, config, createPanelWrapper, edgeOperator, edgePipe, edgeType, inject, layer, nodeOperator, nodePipe, nodeType, observable, panel, register, tool };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knotx/decorators",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Decorators for Knotx",
   "author": "boenfu",
   "license": "MIT",
@@ -28,19 +28,20 @@
     "dist"
   ],
   "peerDependencies": {
-    "@knotx/jsx": "0.2.5"
+    "@knotx/jsx": "0.2.7"
   },
   "dependencies": {
+    "jsonschema": "^1.5.0",
     "lodash-es": "^4.17.21",
     "rxjs": "^7.8.1",
-    "@knotx/core": "0.2.5"
+    "@knotx/core": "0.2.7"
   },
   "devDependencies": {
     "@types/lodash-es": "^4.14.12",
-    "@knotx/build-config": "0.2.5",
-    "@knotx/eslint-config": "0.2.5",
-    "@knotx/jsx": "0.2.5",
-    "@knotx/typescript-config": "0.2.5"
+    "@knotx/build-config": "0.2.7",
+    "@knotx/eslint-config": "0.2.7",
+    "@knotx/jsx": "0.2.7",
+    "@knotx/typescript-config": "0.2.7"
   },
   "scripts": {
     "build": "unbuild",