@platforma-sdk/model 1.54.10 → 1.55.0

package/dist/plugin_model.cjs

@@ -0,0 +1,171 @@
+'use strict';
+
+/**
+ * PluginModel - Builder for creating plugin types with data model and outputs.
+ *
+ * Plugins are UI components with their own model logic and persistent state.
+ * Block developers register plugin instances via BlockModelV3.plugin() method.
+ *
+ * @module plugin_model
+ */
+/** Symbol for internal builder creation method */
+const FROM_BUILDER = Symbol("fromBuilder");
+// =============================================================================
+// Plugin Type
+// =============================================================================
+/**
+ * Configured plugin instance returned by PluginModelFactory.create().
+ * Contains the plugin's name, data model, and output definitions.
+ */
+class PluginModel {
+    /** Globally unique plugin name */
+    name;
+    /** Data model instance for this plugin */
+    dataModel;
+    /** Output definitions - functions that compute outputs from plugin context */
+    outputs;
+    constructor(input) {
+        this.name = input.name;
+        this.dataModel = input.dataModel;
+        this.outputs = input.outputs;
+    }
+    /**
+     * Internal method for creating PluginModel from factory.
+     * Uses Symbol key to prevent external access.
+     * @internal
+     */
+    static [FROM_BUILDER](input) {
+        return new this(input);
+    }
+    /**
+     * Creates a new PluginModelBuilder for building plugin definitions.
+     *
+     * @param options.name - Globally unique plugin name
+     * @param options.data - Factory function that creates the data model from config
+     * @returns PluginModelBuilder for chaining output definitions
+     *
+     * @example
+     * const dataModelChain = new DataModelBuilder().from<MyData>(DATA_MODEL_DEFAULT_VERSION);
+     *
+     * const myPlugin = PluginModel.define<MyData, MyParams, MyConfig>({
+     *   name: 'myPlugin' as PluginName,
+     *   data: (cfg) => dataModelChain.init(() => ({ value: cfg.defaultValue })),
+     * })
+     *   .output('computed', (ctx) => ctx.data.value * ctx.params.multiplier)
+     *   .build();
+     */
+    static define(options) {
+        return PluginModelBuilder[FROM_BUILDER](options);
+    }
+}
+/**
+ * Plugin factory returned by PluginModelBuilder.build().
+ * Call create() with config to get a configured PluginModel instance.
+ */
+class PluginModelFactory {
+    name;
+    data;
+    outputs;
+    constructor(input) {
+        this.name = input.name;
+        this.data = input.data;
+        this.outputs = input.outputs;
+    }
+    /** Create a configured PluginModel instance */
+    create(config) {
+        return PluginModel[FROM_BUILDER]({
+            name: this.name,
+            dataModel: this.data(config),
+            outputs: this.outputs,
+        });
+    }
+}
+// =============================================================================
+// Plugin Model Builder
+// =============================================================================
+/**
+ * Builder for creating PluginType with type-safe output definitions.
+ *
+ * Use `PluginModel.define()` to create a builder instance.
+ *
+ * @typeParam Data - Plugin's persistent data type
+ * @typeParam Params - Params derived from block's RenderCtx (optional)
+ * @typeParam Config - Static configuration passed to plugin factory (optional)
+ * @typeParam Outputs - Accumulated output types
+ *
+ * @example
+ * const dataModelChain = new DataModelBuilder().from<TableData>(DATA_MODEL_DEFAULT_VERSION);
+ *
+ * const dataTable = PluginModel.define<TableData, TableParams, TableConfig>({
+ *     name: 'dataTable' as PluginName,
+ *     data: (cfg) => {
+ *       return dataModelChain.init(() => ({ state: createInitialState(cfg.ops) }));
+ *     },
+ *   })
+ *   .output('model', (ctx) => createTableModel(ctx))
+ *   .build();
+ */
+class PluginModelBuilder {
+    name;
+    data;
+    outputs;
+    constructor(input) {
+        this.name = input.name;
+        this.data = input.data;
+        this.outputs =
+            input.outputs ??
+                {};
+    }
+    /**
+     * Internal method for creating PluginModelBuilder.
+     * Uses Symbol key to prevent external access.
+     * @internal
+     */
+    static [FROM_BUILDER](input) {
+        return new this(input);
+    }
+    /**
+     * Adds an output to the plugin.
+     *
+     * @param key - Output name
+     * @param fn - Function that computes the output value from plugin context
+     * @returns PluginModel with the new output added
+     *
+     * @example
+     * .output('model', (ctx) => createModel(ctx.params.columns, ctx.data.state))
+     * .output('isReady', (ctx) => ctx.params.columns !== undefined)
+     */
+    output(key, fn) {
+        return new PluginModelBuilder({
+            name: this.name,
+            data: this.data,
+            outputs: {
+                ...this.outputs,
+                [key]: fn,
+            },
+        });
+    }
+    /**
+     * Finalizes the plugin definition and returns a ConfigurablePluginModel.
+     *
+     * @returns Callable plugin factory that accepts config and returns PluginModel
+     *
+     * @example
+     * const myPlugin = new PluginModelBuilder('myPlugin', () => dataModel)
+     *   .output('value', (ctx) => ctx.data.value)
+     *   .build();
+     *
+     * // Later, call create() with config to get a configured instance:
+     * const configured = myPlugin.create({ defaultValue: 'test' });
+     */
+    build() {
+        return new PluginModelFactory({
+            name: this.name,
+            data: this.data,
+            outputs: this.outputs,
+        });
+    }
+}
+
+exports.PluginModel = PluginModel;
+//# sourceMappingURL=plugin_model.cjs.map

package/dist/plugin_model.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin_model.cjs","sources":["../src/plugin_model.ts"],"sourcesContent":["/**\n * PluginModel - Builder for creating plugin types with data model and outputs.\n *\n * Plugins are UI components with their own model logic and persistent state.\n * Block developers register plugin instances via BlockModelV3.plugin() method.\n *\n * @module plugin_model\n */\n\nimport type { DataModel } from \"./block_migrations\";\nimport type { PluginName } from \"./block_storage\";\nimport type { ResultPool } from \"./render\";\n\n/** Symbol for internal builder creation method */\nconst FROM_BUILDER = Symbol(\"fromBuilder\");\n\n// =============================================================================\n// Plugin Render Context\n// =============================================================================\n\n/**\n * Context passed to plugin output functions.\n * Provides access to plugin's persistent data, params derived from block context,\n * and the result pool for accessing workflow outputs.\n */\nexport interface PluginRenderCtx<Data, Params = undefined> {\n  /** Plugin's persistent data */\n  readonly data: Data;\n  /** Params derived from block's RenderCtx */\n  readonly params: Params;\n  /** Result pool for accessing workflow outputs */\n  readonly resultPool: ResultPool;\n}\n\n// =============================================================================\n// Plugin Type\n// =============================================================================\n\n/**\n * Configured plugin instance returned by PluginModelFactory.create().\n * Contains the plugin's name, data model, and output definitions.\n */\nexport class PluginModel<Data = unknown, Params = undefined, Outputs = {}> {\n  /** Globally unique plugin name */\n  readonly name: PluginName;\n  /** Data model instance for this plugin */\n  readonly dataModel: DataModel<Data>;\n  /** Output definitions - functions that compute outputs from plugin context */\n  readonly outputs: { [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K] };\n\n  private constructor(input: {\n    name: PluginName;\n    dataModel: DataModel<Data>;\n    outputs: { [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K] };\n  }) {\n    this.name = input.name;\n    this.dataModel = input.dataModel;\n    this.outputs = input.outputs;\n  }\n\n  /**\n   * Internal method for creating PluginModel from factory.\n   * Uses Symbol key to prevent external access.\n   * @internal\n   */\n  static [FROM_BUILDER]<D, P, O>(input: {\n    name: PluginName;\n    dataModel: DataModel<D>;\n    outputs: { [K in keyof O]: (ctx: PluginRenderCtx<D, P>) => O[K] };\n  }): PluginModel<D, P, O> {\n    return new this<D, P, O>(input);\n  }\n\n  /**\n   * Creates a new PluginModelBuilder for building plugin definitions.\n   *\n   * @param options.name - Globally unique plugin name\n   * @param options.data - Factory function that creates the data model from config\n   * @returns PluginModelBuilder for chaining output definitions\n   *\n   * @example\n   * const dataModelChain = new DataModelBuilder().from<MyData>(DATA_MODEL_DEFAULT_VERSION);\n   *\n   * const myPlugin = PluginModel.define<MyData, MyParams, MyConfig>({\n   *   name: 'myPlugin' as PluginName,\n   *   data: (cfg) => dataModelChain.init(() => ({ value: cfg.defaultValue })),\n   * })\n   *   .output('computed', (ctx) => ctx.data.value * ctx.params.multiplier)\n   *   .build();\n   */\n  static define<Data, Params = undefined, Config = undefined>(options: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n  }): PluginModelBuilder<Data, Params, Config> {\n    return PluginModelBuilder[FROM_BUILDER]<Data, Params, Config>(options);\n  }\n}\n\n/**\n * Plugin factory returned by PluginModelBuilder.build().\n * Call create() with config to get a configured PluginModel instance.\n */\nclass PluginModelFactory<Data, Params, Config, Outputs> {\n  private readonly name: PluginName;\n  private readonly data: (config?: Config) => DataModel<Data>;\n  private readonly outputs: {\n    [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K];\n  };\n\n  constructor(input: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    outputs: { [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K] };\n  }) {\n    this.name = input.name;\n    this.data = input.data;\n    this.outputs = input.outputs;\n  }\n\n  /** Create a configured PluginModel instance */\n  create(config?: Config): PluginModel<Data, Params, Outputs> {\n    return PluginModel[FROM_BUILDER]<Data, Params, Outputs>({\n      name: this.name,\n      dataModel: this.data(config),\n      outputs: this.outputs,\n    });\n  }\n}\n\n// =============================================================================\n// Plugin Model Builder\n// =============================================================================\n\n/**\n * Builder for creating PluginType with type-safe output definitions.\n *\n * Use `PluginModel.define()` to create a builder instance.\n *\n * @typeParam Data - Plugin's persistent data type\n * @typeParam Params - Params derived from block's RenderCtx (optional)\n * @typeParam Config - Static configuration passed to plugin factory (optional)\n * @typeParam Outputs - Accumulated output types\n *\n * @example\n * const dataModelChain = new DataModelBuilder().from<TableData>(DATA_MODEL_DEFAULT_VERSION);\n *\n * const dataTable = PluginModel.define<TableData, TableParams, TableConfig>({\n *     name: 'dataTable' as PluginName,\n *     data: (cfg) => {\n *       return dataModelChain.init(() => ({ state: createInitialState(cfg.ops) }));\n *     },\n *   })\n *   .output('model', (ctx) => createTableModel(ctx))\n *   .build();\n */\nclass PluginModelBuilder<\n  Data,\n  Params = undefined,\n  Config = undefined,\n  Outputs extends Record<string, unknown> = {},\n> {\n  private readonly name: PluginName;\n  private readonly data: (config?: Config) => DataModel<Data>;\n  private readonly outputs: {\n    [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K];\n  };\n\n  private constructor(input: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    outputs?: { [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K] };\n  }) {\n    this.name = input.name;\n    this.data = input.data;\n    this.outputs =\n      input.outputs ??\n      ({} as { [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K] });\n  }\n\n  /**\n   * Internal method for creating PluginModelBuilder.\n   * Uses Symbol key to prevent external access.\n   * @internal\n   */\n  static [FROM_BUILDER]<D, P, C, O extends Record<string, unknown> = {}>(input: {\n    name: PluginName;\n    data: (config?: C) => DataModel<D>;\n    outputs?: { [K in keyof O]: (ctx: PluginRenderCtx<D, P>) => O[K] };\n  }): PluginModelBuilder<D, P, C, O> {\n    return new this<D, P, C, O>(input);\n  }\n\n  /**\n   * Adds an output to the plugin.\n   *\n   * @param key - Output name\n   * @param fn - Function that computes the output value from plugin context\n   * @returns PluginModel with the new output added\n   *\n   * @example\n   * .output('model', (ctx) => createModel(ctx.params.columns, ctx.data.state))\n   * .output('isReady', (ctx) => ctx.params.columns !== undefined)\n   */\n  output<const Key extends string, T>(\n    key: Key,\n    fn: (ctx: PluginRenderCtx<Data, Params>) => T,\n  ): PluginModelBuilder<Data, Params, Config, Outputs & { [K in Key]: T }> {\n    return new PluginModelBuilder<Data, Params, Config, Outputs & { [K in Key]: T }>({\n      name: this.name,\n      data: this.data,\n      outputs: {\n        ...this.outputs,\n        [key]: fn,\n      } as {\n        [K in keyof (Outputs & { [P in Key]: T })]: (\n          ctx: PluginRenderCtx<Data, Params>,\n        ) => (Outputs & { [P in Key]: T })[K];\n      },\n    });\n  }\n\n  /**\n   * Finalizes the plugin definition and returns a ConfigurablePluginModel.\n   *\n   * @returns Callable plugin factory that accepts config and returns PluginModel\n   *\n   * @example\n   * const myPlugin = new PluginModelBuilder('myPlugin', () => dataModel)\n   *   .output('value', (ctx) => ctx.data.value)\n   *   .build();\n   *\n   * // Later, call create() with config to get a configured instance:\n   * const configured = myPlugin.create({ defaultValue: 'test' });\n   */\n  build(): PluginModelFactory<Data, Params, Config, Outputs> {\n    return new PluginModelFactory<Data, Params, Config, Outputs>({\n      name: this.name,\n      data: this.data,\n      outputs: this.outputs,\n    });\n  }\n}\n"],"names":[],"mappings":";;AAAA;;;;;;;AAOG;AAMH;AACA,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC;AAoB1C;AACA;AACA;AAEA;;;AAGG;MACU,WAAW,CAAA;;AAEb,IAAA,IAAI;;AAEJ,IAAA,SAAS;;AAET,IAAA,OAAO;AAEhB,IAAA,WAAA,CAAoB,KAInB,EAAA;AACC,QAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;AACtB,QAAA,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS;AAChC,QAAA,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO;IAC9B;AAEA;;;;AAIG;AACH,IAAA,QAAQ,YAAY,CAAC,CAAU,KAI9B,EAAA;AACC,QAAA,OAAO,IAAI,IAAI,CAAU,KAAK,CAAC;IACjC;AAEA;;;;;;;;;;;;;;;;AAgBG;IACH,OAAO,MAAM,CAA+C,OAG3D,EAAA;AACC,QAAA,OAAO,kBAAkB,CAAC,YAAY,CAAC,CAAuB,OAAO,CAAC;IACxE;AACD;AAED;;;AAGG;AACH,MAAM,kBAAkB,CAAA;AACL,IAAA,IAAI;AACJ,IAAA,IAAI;AACJ,IAAA,OAAO;AAIxB,IAAA,WAAA,CAAY,KAIX,EAAA;AACC,QAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;AACtB,QAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;AACtB,QAAA,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO;IAC9B;;AAGA,IAAA,MAAM,CAAC,MAAe,EAAA;AACpB,QAAA,OAAO,WAAW,CAAC,YAAY,CAAC,CAAwB;YACtD,IAAI,EAAE,IAAI,CAAC,IAAI;AACf,YAAA,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;AACtB,SAAA,CAAC;IACJ;AACD;AAED;AACA;AACA;AAEA;;;;;;;;;;;;;;;;;;;;;AAqBG;AACH,MAAM,kBAAkB,CAAA;AAML,IAAA,IAAI;AACJ,IAAA,IAAI;AACJ,IAAA,OAAO;AAIxB,IAAA,WAAA,CAAoB,KAInB,EAAA;AACC,QAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;AACtB,QAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;AACtB,QAAA,IAAI,CAAC,OAAO;AACV,YAAA,KAAK,CAAC,OAAO;AACZ,gBAAA,EAAmF;IACxF;AAEA;;;;AAIG;AACH,IAAA,QAAQ,YAAY,CAAC,CAAkD,KAItE,EAAA;AACC,QAAA,OAAO,IAAI,IAAI,CAAa,KAAK,CAAC;IACpC;AAEA;;;;;;;;;;AAUG;IACH,MAAM,CACJ,GAAQ,EACR,EAA6C,EAAA;QAE7C,OAAO,IAAI,kBAAkB,CAAoD;YAC/E,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;AACf,YAAA,OAAO,EAAE;gBACP,GAAG,IAAI,CAAC,OAAO;gBACf,CAAC,GAAG,GAAG,EAAE;AAKV,aAAA;AACF,SAAA,CAAC;IACJ;AAEA;;;;;;;;;;;;AAYG;IACH,KAAK,GAAA;QACH,OAAO,IAAI,kBAAkB,CAAgC;YAC3D,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;AACtB,SAAA,CAAC;IACJ;AACD;;;;"}

package/dist/plugin_model.d.ts

@@ -0,0 +1,162 @@
+/**
+ * PluginModel - Builder for creating plugin types with data model and outputs.
+ *
+ * Plugins are UI components with their own model logic and persistent state.
+ * Block developers register plugin instances via BlockModelV3.plugin() method.
+ *
+ * @module plugin_model
+ */
+import type { DataModel } from "./block_migrations";
+import type { PluginName } from "./block_storage";
+import type { ResultPool } from "./render";
+/** Symbol for internal builder creation method */
+declare const FROM_BUILDER: unique symbol;
+/**
+ * Context passed to plugin output functions.
+ * Provides access to plugin's persistent data, params derived from block context,
+ * and the result pool for accessing workflow outputs.
+ */
+export interface PluginRenderCtx<Data, Params = undefined> {
+    /** Plugin's persistent data */
+    readonly data: Data;
+    /** Params derived from block's RenderCtx */
+    readonly params: Params;
+    /** Result pool for accessing workflow outputs */
+    readonly resultPool: ResultPool;
+}
+/**
+ * Configured plugin instance returned by PluginModelFactory.create().
+ * Contains the plugin's name, data model, and output definitions.
+ */
+export declare class PluginModel<Data = unknown, Params = undefined, Outputs = {}> {
+    /** Globally unique plugin name */
+    readonly name: PluginName;
+    /** Data model instance for this plugin */
+    readonly dataModel: DataModel<Data>;
+    /** Output definitions - functions that compute outputs from plugin context */
+    readonly outputs: {
+        [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K];
+    };
+    private constructor();
+    /**
+     * Internal method for creating PluginModel from factory.
+     * Uses Symbol key to prevent external access.
+     * @internal
+     */
+    static [FROM_BUILDER]<D, P, O>(input: {
+        name: PluginName;
+        dataModel: DataModel<D>;
+        outputs: {
+            [K in keyof O]: (ctx: PluginRenderCtx<D, P>) => O[K];
+        };
+    }): PluginModel<D, P, O>;
+    /**
+     * Creates a new PluginModelBuilder for building plugin definitions.
+     *
+     * @param options.name - Globally unique plugin name
+     * @param options.data - Factory function that creates the data model from config
+     * @returns PluginModelBuilder for chaining output definitions
+     *
+     * @example
+     * const dataModelChain = new DataModelBuilder().from<MyData>(DATA_MODEL_DEFAULT_VERSION);
+     *
+     * const myPlugin = PluginModel.define<MyData, MyParams, MyConfig>({
+     *   name: 'myPlugin' as PluginName,
+     *   data: (cfg) => dataModelChain.init(() => ({ value: cfg.defaultValue })),
+     * })
+     *   .output('computed', (ctx) => ctx.data.value * ctx.params.multiplier)
+     *   .build();
+     */
+    static define<Data, Params = undefined, Config = undefined>(options: {
+        name: PluginName;
+        data: (config?: Config) => DataModel<Data>;
+    }): PluginModelBuilder<Data, Params, Config>;
+}
+/**
+ * Plugin factory returned by PluginModelBuilder.build().
+ * Call create() with config to get a configured PluginModel instance.
+ */
+declare class PluginModelFactory<Data, Params, Config, Outputs> {
+    private readonly name;
+    private readonly data;
+    private readonly outputs;
+    constructor(input: {
+        name: PluginName;
+        data: (config?: Config) => DataModel<Data>;
+        outputs: {
+            [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K];
+        };
+    });
+    /** Create a configured PluginModel instance */
+    create(config?: Config): PluginModel<Data, Params, Outputs>;
+}
+/**
+ * Builder for creating PluginType with type-safe output definitions.
+ *
+ * Use `PluginModel.define()` to create a builder instance.
+ *
+ * @typeParam Data - Plugin's persistent data type
+ * @typeParam Params - Params derived from block's RenderCtx (optional)
+ * @typeParam Config - Static configuration passed to plugin factory (optional)
+ * @typeParam Outputs - Accumulated output types
+ *
+ * @example
+ * const dataModelChain = new DataModelBuilder().from<TableData>(DATA_MODEL_DEFAULT_VERSION);
+ *
+ * const dataTable = PluginModel.define<TableData, TableParams, TableConfig>({
+ *     name: 'dataTable' as PluginName,
+ *     data: (cfg) => {
+ *       return dataModelChain.init(() => ({ state: createInitialState(cfg.ops) }));
+ *     },
+ *   })
+ *   .output('model', (ctx) => createTableModel(ctx))
+ *   .build();
+ */
+declare class PluginModelBuilder<Data, Params = undefined, Config = undefined, Outputs extends Record<string, unknown> = {}> {
+    private readonly name;
+    private readonly data;
+    private readonly outputs;
+    private constructor();
+    /**
+     * Internal method for creating PluginModelBuilder.
+     * Uses Symbol key to prevent external access.
+     * @internal
+     */
+    static [FROM_BUILDER]<D, P, C, O extends Record<string, unknown> = {}>(input: {
+        name: PluginName;
+        data: (config?: C) => DataModel<D>;
+        outputs?: {
+            [K in keyof O]: (ctx: PluginRenderCtx<D, P>) => O[K];
+        };
+    }): PluginModelBuilder<D, P, C, O>;
+    /**
+     * Adds an output to the plugin.
+     *
+     * @param key - Output name
+     * @param fn - Function that computes the output value from plugin context
+     * @returns PluginModel with the new output added
+     *
+     * @example
+     * .output('model', (ctx) => createModel(ctx.params.columns, ctx.data.state))
+     * .output('isReady', (ctx) => ctx.params.columns !== undefined)
+     */
+    output<const Key extends string, T>(key: Key, fn: (ctx: PluginRenderCtx<Data, Params>) => T): PluginModelBuilder<Data, Params, Config, Outputs & {
+        [K in Key]: T;
+    }>;
+    /**
+     * Finalizes the plugin definition and returns a ConfigurablePluginModel.
+     *
+     * @returns Callable plugin factory that accepts config and returns PluginModel
+     *
+     * @example
+     * const myPlugin = new PluginModelBuilder('myPlugin', () => dataModel)
+     *   .output('value', (ctx) => ctx.data.value)
+     *   .build();
+     *
+     * // Later, call create() with config to get a configured instance:
+     * const configured = myPlugin.create({ defaultValue: 'test' });
+     */
+    build(): PluginModelFactory<Data, Params, Config, Outputs>;
+}
+export {};
+//# sourceMappingURL=plugin_model.d.ts.map

package/dist/plugin_model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin_model.d.ts","sourceRoot":"","sources":["../src/plugin_model.ts"],"names":[],"mappings":"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"}

package/dist/plugin_model.js

@@ -0,0 +1,169 @@
+/**
+ * PluginModel - Builder for creating plugin types with data model and outputs.
+ *
+ * Plugins are UI components with their own model logic and persistent state.
+ * Block developers register plugin instances via BlockModelV3.plugin() method.
+ *
+ * @module plugin_model
+ */
+/** Symbol for internal builder creation method */
+const FROM_BUILDER = Symbol("fromBuilder");
+// =============================================================================
+// Plugin Type
+// =============================================================================
+/**
+ * Configured plugin instance returned by PluginModelFactory.create().
+ * Contains the plugin's name, data model, and output definitions.
+ */
+class PluginModel {
+    /** Globally unique plugin name */
+    name;
+    /** Data model instance for this plugin */
+    dataModel;
+    /** Output definitions - functions that compute outputs from plugin context */
+    outputs;
+    constructor(input) {
+        this.name = input.name;
+        this.dataModel = input.dataModel;
+        this.outputs = input.outputs;
+    }
+    /**
+     * Internal method for creating PluginModel from factory.
+     * Uses Symbol key to prevent external access.
+     * @internal
+     */
+    static [FROM_BUILDER](input) {
+        return new this(input);
+    }
+    /**
+     * Creates a new PluginModelBuilder for building plugin definitions.
+     *
+     * @param options.name - Globally unique plugin name
+     * @param options.data - Factory function that creates the data model from config
+     * @returns PluginModelBuilder for chaining output definitions
+     *
+     * @example
+     * const dataModelChain = new DataModelBuilder().from<MyData>(DATA_MODEL_DEFAULT_VERSION);
+     *
+     * const myPlugin = PluginModel.define<MyData, MyParams, MyConfig>({
+     *   name: 'myPlugin' as PluginName,
+     *   data: (cfg) => dataModelChain.init(() => ({ value: cfg.defaultValue })),
+     * })
+     *   .output('computed', (ctx) => ctx.data.value * ctx.params.multiplier)
+     *   .build();
+     */
+    static define(options) {
+        return PluginModelBuilder[FROM_BUILDER](options);
+    }
+}
+/**
+ * Plugin factory returned by PluginModelBuilder.build().
+ * Call create() with config to get a configured PluginModel instance.
+ */
+class PluginModelFactory {
+    name;
+    data;
+    outputs;
+    constructor(input) {
+        this.name = input.name;
+        this.data = input.data;
+        this.outputs = input.outputs;
+    }
+    /** Create a configured PluginModel instance */
+    create(config) {
+        return PluginModel[FROM_BUILDER]({
+            name: this.name,
+            dataModel: this.data(config),
+            outputs: this.outputs,
+        });
+    }
+}
+// =============================================================================
+// Plugin Model Builder
+// =============================================================================
+/**
+ * Builder for creating PluginType with type-safe output definitions.
+ *
+ * Use `PluginModel.define()` to create a builder instance.
+ *
+ * @typeParam Data - Plugin's persistent data type
+ * @typeParam Params - Params derived from block's RenderCtx (optional)
+ * @typeParam Config - Static configuration passed to plugin factory (optional)
+ * @typeParam Outputs - Accumulated output types
+ *
+ * @example
+ * const dataModelChain = new DataModelBuilder().from<TableData>(DATA_MODEL_DEFAULT_VERSION);
+ *
+ * const dataTable = PluginModel.define<TableData, TableParams, TableConfig>({
+ *     name: 'dataTable' as PluginName,
+ *     data: (cfg) => {
+ *       return dataModelChain.init(() => ({ state: createInitialState(cfg.ops) }));
+ *     },
+ *   })
+ *   .output('model', (ctx) => createTableModel(ctx))
+ *   .build();
+ */
+class PluginModelBuilder {
+    name;
+    data;
+    outputs;
+    constructor(input) {
+        this.name = input.name;
+        this.data = input.data;
+        this.outputs =
+            input.outputs ??
+                {};
+    }
+    /**
+     * Internal method for creating PluginModelBuilder.
+     * Uses Symbol key to prevent external access.
+     * @internal
+     */
+    static [FROM_BUILDER](input) {
+        return new this(input);
+    }
+    /**
+     * Adds an output to the plugin.
+     *
+     * @param key - Output name
+     * @param fn - Function that computes the output value from plugin context
+     * @returns PluginModel with the new output added
+     *
+     * @example
+     * .output('model', (ctx) => createModel(ctx.params.columns, ctx.data.state))
+     * .output('isReady', (ctx) => ctx.params.columns !== undefined)
+     */
+    output(key, fn) {
+        return new PluginModelBuilder({
+            name: this.name,
+            data: this.data,
+            outputs: {
+                ...this.outputs,
+                [key]: fn,
+            },
+        });
+    }
+    /**
+     * Finalizes the plugin definition and returns a ConfigurablePluginModel.
+     *
+     * @returns Callable plugin factory that accepts config and returns PluginModel
+     *
+     * @example
+     * const myPlugin = new PluginModelBuilder('myPlugin', () => dataModel)
+     *   .output('value', (ctx) => ctx.data.value)
+     *   .build();
+     *
+     * // Later, call create() with config to get a configured instance:
+     * const configured = myPlugin.create({ defaultValue: 'test' });
+     */
+    build() {
+        return new PluginModelFactory({
+            name: this.name,
+            data: this.data,
+            outputs: this.outputs,
+        });
+    }
+}
+
+export { PluginModel };
+//# sourceMappingURL=plugin_model.js.map

package/dist/plugin_model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin_model.js","sources":["../src/plugin_model.ts"],"sourcesContent":["/**\n * PluginModel - Builder for creating plugin types with data model and outputs.\n *\n * Plugins are UI components with their own model logic and persistent state.\n * Block developers register plugin instances via BlockModelV3.plugin() method.\n *\n * @module plugin_model\n */\n\nimport type { DataModel } from \"./block_migrations\";\nimport type { PluginName } from \"./block_storage\";\nimport type { ResultPool } from \"./render\";\n\n/** Symbol for internal builder creation method */\nconst FROM_BUILDER = Symbol(\"fromBuilder\");\n\n// =============================================================================\n// Plugin Render Context\n// =============================================================================\n\n/**\n * Context passed to plugin output functions.\n * Provides access to plugin's persistent data, params derived from block context,\n * and the result pool for accessing workflow outputs.\n */\nexport interface PluginRenderCtx<Data, Params = undefined> {\n  /** Plugin's persistent data */\n  readonly data: Data;\n  /** Params derived from block's RenderCtx */\n  readonly params: Params;\n  /** Result pool for accessing workflow outputs */\n  readonly resultPool: ResultPool;\n}\n\n// =============================================================================\n// Plugin Type\n// =============================================================================\n\n/**\n * Configured plugin instance returned by PluginModelFactory.create().\n * Contains the plugin's name, data model, and output definitions.\n */\nexport class PluginModel<Data = unknown, Params = undefined, Outputs = {}> {\n  /** Globally unique plugin name */\n  readonly name: PluginName;\n  /** Data model instance for this plugin */\n  readonly dataModel: DataModel<Data>;\n  /** Output definitions - functions that compute outputs from plugin context */\n  readonly outputs: { [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K] };\n\n  private constructor(input: {\n    name: PluginName;\n    dataModel: DataModel<Data>;\n    outputs: { [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K] };\n  }) {\n    this.name = input.name;\n    this.dataModel = input.dataModel;\n    this.outputs = input.outputs;\n  }\n\n  /**\n   * Internal method for creating PluginModel from factory.\n   * Uses Symbol key to prevent external access.\n   * @internal\n   */\n  static [FROM_BUILDER]<D, P, O>(input: {\n    name: PluginName;\n    dataModel: DataModel<D>;\n    outputs: { [K in keyof O]: (ctx: PluginRenderCtx<D, P>) => O[K] };\n  }): PluginModel<D, P, O> {\n    return new this<D, P, O>(input);\n  }\n\n  /**\n   * Creates a new PluginModelBuilder for building plugin definitions.\n   *\n   * @param options.name - Globally unique plugin name\n   * @param options.data - Factory function that creates the data model from config\n   * @returns PluginModelBuilder for chaining output definitions\n   *\n   * @example\n   * const dataModelChain = new DataModelBuilder().from<MyData>(DATA_MODEL_DEFAULT_VERSION);\n   *\n   * const myPlugin = PluginModel.define<MyData, MyParams, MyConfig>({\n   *   name: 'myPlugin' as PluginName,\n   *   data: (cfg) => dataModelChain.init(() => ({ value: cfg.defaultValue })),\n   * })\n   *   .output('computed', (ctx) => ctx.data.value * ctx.params.multiplier)\n   *   .build();\n   */\n  static define<Data, Params = undefined, Config = undefined>(options: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n  }): PluginModelBuilder<Data, Params, Config> {\n    return PluginModelBuilder[FROM_BUILDER]<Data, Params, Config>(options);\n  }\n}\n\n/**\n * Plugin factory returned by PluginModelBuilder.build().\n * Call create() with config to get a configured PluginModel instance.\n */\nclass PluginModelFactory<Data, Params, Config, Outputs> {\n  private readonly name: PluginName;\n  private readonly data: (config?: Config) => DataModel<Data>;\n  private readonly outputs: {\n    [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K];\n  };\n\n  constructor(input: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    outputs: { [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K] };\n  }) {\n    this.name = input.name;\n    this.data = input.data;\n    this.outputs = input.outputs;\n  }\n\n  /** Create a configured PluginModel instance */\n  create(config?: Config): PluginModel<Data, Params, Outputs> {\n    return PluginModel[FROM_BUILDER]<Data, Params, Outputs>({\n      name: this.name,\n      dataModel: this.data(config),\n      outputs: this.outputs,\n    });\n  }\n}\n\n// =============================================================================\n// Plugin Model Builder\n// =============================================================================\n\n/**\n * Builder for creating PluginType with type-safe output definitions.\n *\n * Use `PluginModel.define()` to create a builder instance.\n *\n * @typeParam Data - Plugin's persistent data type\n * @typeParam Params - Params derived from block's RenderCtx (optional)\n * @typeParam Config - Static configuration passed to plugin factory (optional)\n * @typeParam Outputs - Accumulated output types\n *\n * @example\n * const dataModelChain = new DataModelBuilder().from<TableData>(DATA_MODEL_DEFAULT_VERSION);\n *\n * const dataTable = PluginModel.define<TableData, TableParams, TableConfig>({\n *     name: 'dataTable' as PluginName,\n *     data: (cfg) => {\n *       return dataModelChain.init(() => ({ state: createInitialState(cfg.ops) }));\n *     },\n *   })\n *   .output('model', (ctx) => createTableModel(ctx))\n *   .build();\n */\nclass PluginModelBuilder<\n  Data,\n  Params = undefined,\n  Config = undefined,\n  Outputs extends Record<string, unknown> = {},\n> {\n  private readonly name: PluginName;\n  private readonly data: (config?: Config) => DataModel<Data>;\n  private readonly outputs: {\n    [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K];\n  };\n\n  private constructor(input: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    outputs?: { [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K] };\n  }) {\n    this.name = input.name;\n    this.data = input.data;\n    this.outputs =\n      input.outputs ??\n      ({} as { [K in keyof Outputs]: (ctx: PluginRenderCtx<Data, Params>) => Outputs[K] });\n  }\n\n  /**\n   * Internal method for creating PluginModelBuilder.\n   * Uses Symbol key to prevent external access.\n   * @internal\n   */\n  static [FROM_BUILDER]<D, P, C, O extends Record<string, unknown> = {}>(input: {\n    name: PluginName;\n    data: (config?: C) => DataModel<D>;\n    outputs?: { [K in keyof O]: (ctx: PluginRenderCtx<D, P>) => O[K] };\n  }): PluginModelBuilder<D, P, C, O> {\n    return new this<D, P, C, O>(input);\n  }\n\n  /**\n   * Adds an output to the plugin.\n   *\n   * @param key - Output name\n   * @param fn - Function that computes the output value from plugin context\n   * @returns PluginModel with the new output added\n   *\n   * @example\n   * .output('model', (ctx) => createModel(ctx.params.columns, ctx.data.state))\n   * .output('isReady', (ctx) => ctx.params.columns !== undefined)\n   */\n  output<const Key extends string, T>(\n    key: Key,\n    fn: (ctx: PluginRenderCtx<Data, Params>) => T,\n  ): PluginModelBuilder<Data, Params, Config, Outputs & { [K in Key]: T }> {\n    return new PluginModelBuilder<Data, Params, Config, Outputs & { [K in Key]: T }>({\n      name: this.name,\n      data: this.data,\n      outputs: {\n        ...this.outputs,\n        [key]: fn,\n      } as {\n        [K in keyof (Outputs & { [P in Key]: T })]: (\n          ctx: PluginRenderCtx<Data, Params>,\n        ) => (Outputs & { [P in Key]: T })[K];\n      },\n    });\n  }\n\n  /**\n   * Finalizes the plugin definition and returns a ConfigurablePluginModel.\n   *\n   * @returns Callable plugin factory that accepts config and returns PluginModel\n   *\n   * @example\n   * const myPlugin = new PluginModelBuilder('myPlugin', () => dataModel)\n   *   .output('value', (ctx) => ctx.data.value)\n   *   .build();\n   *\n   * // Later, call create() with config to get a configured instance:\n   * const configured = myPlugin.create({ defaultValue: 'test' });\n   */\n  build(): PluginModelFactory<Data, Params, Config, Outputs> {\n    return new PluginModelFactory<Data, Params, Config, Outputs>({\n      name: this.name,\n      data: this.data,\n      outputs: this.outputs,\n    });\n  }\n}\n"],"names":[],"mappings":"AAAA;;;;;;;AAOG;AAMH;AACA,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC;AAoB1C;AACA;AACA;AAEA;;;AAGG;MACU,WAAW,CAAA;;AAEb,IAAA,IAAI;;AAEJ,IAAA,SAAS;;AAET,IAAA,OAAO;AAEhB,IAAA,WAAA,CAAoB,KAInB,EAAA;AACC,QAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;AACtB,QAAA,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS;AAChC,QAAA,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO;IAC9B;AAEA;;;;AAIG;AACH,IAAA,QAAQ,YAAY,CAAC,CAAU,KAI9B,EAAA;AACC,QAAA,OAAO,IAAI,IAAI,CAAU,KAAK,CAAC;IACjC;AAEA;;;;;;;;;;;;;;;;AAgBG;IACH,OAAO,MAAM,CAA+C,OAG3D,EAAA;AACC,QAAA,OAAO,kBAAkB,CAAC,YAAY,CAAC,CAAuB,OAAO,CAAC;IACxE;AACD;AAED;;;AAGG;AACH,MAAM,kBAAkB,CAAA;AACL,IAAA,IAAI;AACJ,IAAA,IAAI;AACJ,IAAA,OAAO;AAIxB,IAAA,WAAA,CAAY,KAIX,EAAA;AACC,QAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;AACtB,QAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;AACtB,QAAA,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO;IAC9B;;AAGA,IAAA,MAAM,CAAC,MAAe,EAAA;AACpB,QAAA,OAAO,WAAW,CAAC,YAAY,CAAC,CAAwB;YACtD,IAAI,EAAE,IAAI,CAAC,IAAI;AACf,YAAA,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;AACtB,SAAA,CAAC;IACJ;AACD;AAED;AACA;AACA;AAEA;;;;;;;;;;;;;;;;;;;;;AAqBG;AACH,MAAM,kBAAkB,CAAA;AAML,IAAA,IAAI;AACJ,IAAA,IAAI;AACJ,IAAA,OAAO;AAIxB,IAAA,WAAA,CAAoB,KAInB,EAAA;AACC,QAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;AACtB,QAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;AACtB,QAAA,IAAI,CAAC,OAAO;AACV,YAAA,KAAK,CAAC,OAAO;AACZ,gBAAA,EAAmF;IACxF;AAEA;;;;AAIG;AACH,IAAA,QAAQ,YAAY,CAAC,CAAkD,KAItE,EAAA;AACC,QAAA,OAAO,IAAI,IAAI,CAAa,KAAK,CAAC;IACpC;AAEA;;;;;;;;;;AAUG;IACH,MAAM,CACJ,GAAQ,EACR,EAA6C,EAAA;QAE7C,OAAO,IAAI,kBAAkB,CAAoD;YAC/E,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;AACf,YAAA,OAAO,EAAE;gBACP,GAAG,IAAI,CAAC,OAAO;gBACf,CAAC,GAAG,GAAG,EAAE;AAKV,aAAA;AACF,SAAA,CAAC;IACJ;AAEA;;;;;;;;;;;;AAYG;IACH,KAAK,GAAA;QACH,OAAO,IAAI,kBAAkB,CAAgC;YAC3D,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;AACtB,SAAA,CAAC;IACJ;AACD;;;;"}

package/dist/render/api.cjs

@@ -387,30 +387,30 @@ class RenderCtxBase {
     constructor() {
         this.ctx = internal.getCfgRenderCtx();
     }
-    _dataCache;
+    dataCache;
     get data() {
-        if (this._dataCache === undefined) {
+        if (this.dataCache === undefined) {
             const raw = this.ctx.data;
             const value = typeof raw === "function" ? raw() : raw;
-            this._dataCache = { v: value ? JSON.parse(value) : {} };
+            this.dataCache = { v: value ? JSON.parse(value) : {} };
         }
-        return this._dataCache.v;
+        return this.dataCache.v;
     }
     // lazy rendering because this feature is rarely used
-    _activeArgsCache;
+    activeArgsCache;
     /**
      * Returns args snapshot the block was executed for (i.e. when "Run" button was pressed).
      * Returns undefined, if block was never executed or stopped mid-way execution, so that the result was cleared.
      * */
     get activeArgs() {
-        if (this._activeArgsCache === undefined) {
+        if (this.activeArgsCache === undefined) {
             const raw = this.ctx.activeArgs;
             const value = typeof raw === "function" ? raw() : raw;
-            this._activeArgsCache = {
+            this.activeArgsCache = {
                 v: value ? JSON.parse(value) : undefined,
             };
         }
-        return this._activeArgsCache.v;
+        return this.activeArgsCache.v;
     }
     // /** Can be used to determine features provided by the desktop instance. */
     // public get featureFlags() {
@@ -514,36 +514,35 @@ class RenderCtxBase {
 }
 /** Main entry point to the API available within model lambdas (like outputs, sections, etc..) for v3+ blocks */
 class RenderCtx extends RenderCtxBase {
-    _argsCache;
+    argsCache;
     get args() {
-        if (this._argsCache === undefined) {
+        if (this.argsCache === undefined) {
             const raw = this.ctx.args;
             const value = typeof raw === "function" ? raw() : raw;
-            // args can be undefined when derivation fails (e.g., validation error in args())
-            this._argsCache = { v: value === undefined ? undefined : JSON.parse(value) };
+            this.argsCache = { v: value === undefined ? undefined : JSON.parse(value) };
         }
-        return this._argsCache.v;
+        return this.argsCache.v;
     }
 }
 /** Render context for legacy v1/v2 blocks - provides backward compatibility */
 class RenderCtxLegacy extends RenderCtxBase {
-    _argsCache;
+    argsCache;
     get args() {
-        if (this._argsCache === undefined) {
+        if (this.argsCache === undefined) {
             const raw = this.ctx.args;
             const value = typeof raw === "function" ? raw() : raw;
-            this._argsCache = { v: JSON.parse(value) };
+            this.argsCache = { v: JSON.parse(value) };
         }
-        return this._argsCache.v;
+        return this.argsCache.v;
     }
-    _uiStateCache;
+    uiStateCache;
     get uiState() {
-        if (this._uiStateCache === undefined) {
+        if (this.uiStateCache === undefined) {
             const raw = this.ctx.uiState;
             const value = typeof raw === "function" ? raw() : raw;
-            this._uiStateCache = { v: value ? JSON.parse(value) : {} };
+            this.uiStateCache = { v: value ? JSON.parse(value) : {} };
         }
-        return this._uiStateCache.v;
+        return this.uiStateCache.v;
     }
 }