@platforma-sdk/model 1.57.2 → 1.58.0

package/dist/plugin_model.cjs

@@ -10,9 +10,6 @@
  */
 /** 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.
@@ -24,18 +21,21 @@ class PluginModel {
     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;
+    /** Feature flags declared by this plugin */
+    featureFlags;
+    constructor(options) {
+        this.name = options.name;
+        this.dataModel = options.dataModel;
+        this.outputs = options.outputs;
+        this.featureFlags = options.featureFlags;
     }
     /**
      * Internal method for creating PluginModel from factory.
      * Uses Symbol key to prevent external access.
      * @internal
      */
-    static [FROM_BUILDER](input) {
-        return new this(input);
+    static [FROM_BUILDER](options) {
+        return new PluginModel(options);
     }
     /**
      * Creates a new PluginModelBuilder for building plugin definitions.
@@ -47,7 +47,7 @@ class PluginModel {
      * @example
      * const dataModelChain = new DataModelBuilder().from<MyData>(DATA_MODEL_DEFAULT_VERSION);
      *
-     * const myPlugin = PluginModel.define<MyData, MyParams, MyConfig>({
+     * const myPlugin = PluginModel.define({
      *   name: 'myPlugin' as PluginName,
      *   data: (cfg) => dataModelChain.init(() => ({ value: cfg.defaultValue })),
      * })
@@ -58,18 +58,16 @@ class PluginModel {
         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;
+    featureFlags;
+    constructor(options) {
+        this.name = options.name;
+        this.data = options.data;
+        this.outputs = options.outputs;
+        this.featureFlags = options.featureFlags;
     }
     /** Create a configured PluginModel instance */
     create(config) {
@@ -77,12 +75,10 @@ class PluginModelFactory {
             name: this.name,
             dataModel: this.data(config),
             outputs: this.outputs,
+            featureFlags: this.featureFlags,
         });
     }
 }
-// =============================================================================
-// Plugin Model Builder
-// =============================================================================
 /**
  * Builder for creating PluginType with type-safe output definitions.
  *
@@ -109,20 +105,22 @@ class PluginModelBuilder {
     name;
     data;
     outputs;
-    constructor(input) {
-        this.name = input.name;
-        this.data = input.data;
+    featureFlags;
+    constructor(options) {
+        this.name = options.name;
+        this.data = options.data;
         this.outputs =
-            input.outputs ??
+            options.outputs ??
                 {};
+        this.featureFlags = options.featureFlags;
     }
     /**
      * Internal method for creating PluginModelBuilder.
      * Uses Symbol key to prevent external access.
      * @internal
      */
-    static [FROM_BUILDER](input) {
-        return new this(input);
+    static [FROM_BUILDER](options) {
+        return new PluginModelBuilder(options);
     }
     /**
      * Adds an output to the plugin.
@@ -139,6 +137,7 @@ class PluginModelBuilder {
         return new PluginModelBuilder({
             name: this.name,
             data: this.data,
+            featureFlags: this.featureFlags,
             outputs: {
                 ...this.outputs,
                 [key]: fn,
@@ -163,6 +162,7 @@ class PluginModelBuilder {
             name: this.name,
             data: this.data,
             outputs: this.outputs,
+            featureFlags: this.featureFlags,
         });
     }
 }

package/dist/plugin_model.cjs.map

@@ -1 +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 { PluginRenderCtx } from \"./render\";\n\n/** Symbol for internal builder creation method */\nconst FROM_BUILDER = Symbol(\"fromBuilder\");\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;AAE1C;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;;;;"}
+{"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 { BlockCodeKnownFeatureFlags } from \"@milaboratories/pl-model-common\";\nimport type { DataModel } from \"./block_migrations\";\nimport type { PluginName } from \"./block_storage\";\nimport type { PluginFactoryLike } from \"./plugin_handle\";\nimport type { PluginRenderCtx } from \"./render\";\n\n/** Symbol for internal builder creation method */\nconst FROM_BUILDER = Symbol(\"fromBuilder\");\n\nexport type PluginData = Record<string, unknown>;\nexport type PluginParams = undefined | Record<string, unknown>;\nexport type PluginOutputs = Record<string, unknown>;\nexport type PluginConfig = undefined | Record<string, unknown>;\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<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n> {\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: {\n    [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n  };\n  /** Feature flags declared by this plugin */\n  readonly featureFlags?: BlockCodeKnownFeatureFlags;\n\n  private constructor(options: {\n    name: PluginName;\n    dataModel: DataModel<Data>;\n    outputs: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }) {\n    this.name = options.name;\n    this.dataModel = options.dataModel;\n    this.outputs = options.outputs;\n    this.featureFlags = options.featureFlags;\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]<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n  >(options: {\n    name: PluginName;\n    dataModel: DataModel<Data>;\n    outputs: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModel<Data, Params, Outputs> {\n    return new PluginModel<Data, Params, Outputs>(options);\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({\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<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Config extends PluginConfig,\n  >(options: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelBuilder<Data, Params, {}, Config> {\n    return PluginModelBuilder[FROM_BUILDER](options);\n  }\n}\n\n/** Plugin factory returned by PluginModelBuilder.build(). */\nexport interface PluginFactory<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  Config extends PluginConfig = undefined,\n> extends PluginFactoryLike {\n  create(config?: Config): PluginModel<Data, Params, Outputs>;\n  /**\n   * @internal Phantom field for structural type extraction.\n   * Enables InferFactoryData/InferFactoryOutputs to work via PluginFactoryLike.\n   */\n  readonly __types?: { data: Data; params: Params; outputs: Outputs; config: Config };\n}\n\nclass PluginModelFactory<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  Config extends PluginConfig = undefined,\n> implements PluginFactory<Data, Params, Outputs, Config> {\n  private readonly name: PluginName;\n  private readonly data: (config?: Config) => DataModel<Data>;\n  private readonly outputs: {\n    [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n  };\n  private readonly featureFlags?: BlockCodeKnownFeatureFlags;\n\n  constructor(options: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    outputs: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }) {\n    this.name = options.name;\n    this.data = options.data;\n    this.outputs = options.outputs;\n    this.featureFlags = options.featureFlags;\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      featureFlags: this.featureFlags,\n    });\n  }\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 extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  Config extends PluginConfig = undefined,\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<PluginFactoryLike<Data, Params>>) => Outputs[K];\n  };\n  private readonly featureFlags?: BlockCodeKnownFeatureFlags;\n\n  private constructor(options: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    outputs?: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }) {\n    this.name = options.name;\n    this.data = options.data;\n    this.outputs =\n      options.outputs ??\n      ({} as {\n        [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n      });\n    this.featureFlags = options.featureFlags;\n  }\n\n  /**\n   * Internal method for creating PluginModelBuilder.\n   * Uses Symbol key to prevent external access.\n   * @internal\n   */\n  static [FROM_BUILDER]<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    Config extends PluginConfig,\n  >(options: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    outputs?: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelBuilder<Data, Params, Outputs, Config> {\n    return new PluginModelBuilder(options);\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<PluginFactoryLike<Data, Params>>) => T,\n  ): PluginModelBuilder<Data, Params, Outputs & { [K in Key]: T }, Config> {\n    return new PluginModelBuilder<Data, Params, Outputs & { [K in Key]: T }, Config>({\n      name: this.name,\n      data: this.data,\n      featureFlags: this.featureFlags,\n      outputs: {\n        ...this.outputs,\n        [key]: fn,\n      } as {\n        [K in keyof (Outputs & { [P in Key]: T })]: (\n          ctx: PluginRenderCtx<PluginFactoryLike<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(): PluginFactory<Data, Params, Outputs, Config> {\n    return new PluginModelFactory<Data, Params, Outputs, Config>({\n      name: this.name,\n      data: this.data,\n      outputs: this.outputs,\n      featureFlags: this.featureFlags,\n    });\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/plugin_model.d.ts

@@ -6,37 +6,46 @@
  *
  * @module plugin_model
  */
+import type { BlockCodeKnownFeatureFlags } from "@milaboratories/pl-model-common";
 import type { DataModel } from "./block_migrations";
 import type { PluginName } from "./block_storage";
+import type { PluginFactoryLike } from "./plugin_handle";
 import type { PluginRenderCtx } from "./render";
 /** Symbol for internal builder creation method */
 declare const FROM_BUILDER: unique symbol;
+export type PluginData = Record<string, unknown>;
+export type PluginParams = undefined | Record<string, unknown>;
+export type PluginOutputs = Record<string, unknown>;
+export type PluginConfig = undefined | Record<string, unknown>;
 /**
  * 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 = {}> {
+export declare class PluginModel<Data extends PluginData = PluginData, Params extends PluginParams = undefined, Outputs extends PluginOutputs = PluginOutputs> {
     /** 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];
+        [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];
     };
+    /** Feature flags declared by this plugin */
+    readonly featureFlags?: BlockCodeKnownFeatureFlags;
     private constructor();
     /**
      * Internal method for creating PluginModel from factory.
      * Uses Symbol key to prevent external access.
      * @internal
      */
-    static [FROM_BUILDER]<D, P, O>(input: {
+    static [FROM_BUILDER]<Data extends PluginData, Params extends PluginParams, Outputs extends PluginOutputs>(options: {
         name: PluginName;
-        dataModel: DataModel<D>;
+        dataModel: DataModel<Data>;
         outputs: {
-            [K in keyof O]: (ctx: PluginRenderCtx<D, P>) => O[K];
+            [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];
         };
-    }): PluginModel<D, P, O>;
+        featureFlags?: BlockCodeKnownFeatureFlags;
+    }): PluginModel<Data, Params, Outputs>;
     /**
      * Creates a new PluginModelBuilder for building plugin definitions.
      *
@@ -47,35 +56,32 @@ export declare class PluginModel<Data = unknown, Params = undefined, Outputs = {
      * @example
      * const dataModelChain = new DataModelBuilder().from<MyData>(DATA_MODEL_DEFAULT_VERSION);
      *
-     * const myPlugin = PluginModel.define<MyData, MyParams, MyConfig>({
+     * const myPlugin = PluginModel.define({
      *   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: {
+    static define<Data extends PluginData, Params extends PluginParams, Config extends PluginConfig>(options: {
         name: PluginName;
         data: (config?: Config) => DataModel<Data>;
-    }): PluginModelBuilder<Data, Params, Config>;
+        featureFlags?: BlockCodeKnownFeatureFlags;
+    }): 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 */
+/** Plugin factory returned by PluginModelBuilder.build(). */
+export interface PluginFactory<Data extends PluginData = PluginData, Params extends PluginParams = undefined, Outputs extends PluginOutputs = PluginOutputs, Config extends PluginConfig = undefined> extends PluginFactoryLike {
     create(config?: Config): PluginModel<Data, Params, Outputs>;
+    /**
+     * @internal Phantom field for structural type extraction.
+     * Enables InferFactoryData/InferFactoryOutputs to work via PluginFactoryLike.
+     */
+    readonly __types?: {
+        data: Data;
+        params: Params;
+        outputs: Outputs;
+        config: Config;
+    };
 }
 /**
  * Builder for creating PluginType with type-safe output definitions.
@@ -99,23 +105,25 @@ declare class PluginModelFactory<Data, Params, Config, Outputs> {
  *   .output('model', (ctx) => createTableModel(ctx))
  *   .build();
  */
-declare class PluginModelBuilder<Data, Params = undefined, Config = undefined, Outputs extends Record<string, unknown> = {}> {
+declare class PluginModelBuilder<Data extends PluginData = PluginData, Params extends PluginParams = undefined, Outputs extends PluginOutputs = PluginOutputs, Config extends PluginConfig = undefined> {
     private readonly name;
     private readonly data;
     private readonly outputs;
+    private readonly featureFlags?;
     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: {
+    static [FROM_BUILDER]<Data extends PluginData, Params extends PluginParams, Outputs extends PluginOutputs, Config extends PluginConfig>(options: {
         name: PluginName;
-        data: (config?: C) => DataModel<D>;
+        data: (config?: Config) => DataModel<Data>;
         outputs?: {
-            [K in keyof O]: (ctx: PluginRenderCtx<D, P>) => O[K];
+            [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];
         };
-    }): PluginModelBuilder<D, P, C, O>;
+        featureFlags?: BlockCodeKnownFeatureFlags;
+    }): PluginModelBuilder<Data, Params, Outputs, Config>;
     /**
      * Adds an output to the plugin.
      *
@@ -127,9 +135,9 @@ declare class PluginModelBuilder<Data, Params = undefined, Config = undefined, O
      * .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 & {
+    output<const Key extends string, T>(key: Key, fn: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => T): PluginModelBuilder<Data, Params, Outputs & {
         [K in Key]: T;
-    }>;
+    }, Config>;
     /**
      * Finalizes the plugin definition and returns a ConfigurablePluginModel.
      *
@@ -143,7 +151,7 @@ declare class PluginModelBuilder<Data, Params = undefined, Config = undefined, O
      * // Later, call create() with config to get a configured instance:
      * const configured = myPlugin.create({ defaultValue: 'test' });
      */
-    build(): PluginModelFactory<Data, Params, Config, Outputs>;
+    build(): PluginFactory<Data, Params, Outputs, Config>;
 }
 export {};
 //# sourceMappingURL=plugin_model.d.ts.map

package/dist/plugin_model.d.ts.map

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

package/dist/plugin_model.js

@@ -8,9 +8,6 @@
  */
 /** 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.
@@ -22,18 +19,21 @@ class PluginModel {
     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;
+    /** Feature flags declared by this plugin */
+    featureFlags;
+    constructor(options) {
+        this.name = options.name;
+        this.dataModel = options.dataModel;
+        this.outputs = options.outputs;
+        this.featureFlags = options.featureFlags;
     }
     /**
      * Internal method for creating PluginModel from factory.
      * Uses Symbol key to prevent external access.
      * @internal
      */
-    static [FROM_BUILDER](input) {
-        return new this(input);
+    static [FROM_BUILDER](options) {
+        return new PluginModel(options);
     }
     /**
      * Creates a new PluginModelBuilder for building plugin definitions.
@@ -45,7 +45,7 @@ class PluginModel {
      * @example
      * const dataModelChain = new DataModelBuilder().from<MyData>(DATA_MODEL_DEFAULT_VERSION);
      *
-     * const myPlugin = PluginModel.define<MyData, MyParams, MyConfig>({
+     * const myPlugin = PluginModel.define({
      *   name: 'myPlugin' as PluginName,
      *   data: (cfg) => dataModelChain.init(() => ({ value: cfg.defaultValue })),
      * })
@@ -56,18 +56,16 @@ class PluginModel {
         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;
+    featureFlags;
+    constructor(options) {
+        this.name = options.name;
+        this.data = options.data;
+        this.outputs = options.outputs;
+        this.featureFlags = options.featureFlags;
     }
     /** Create a configured PluginModel instance */
     create(config) {
@@ -75,12 +73,10 @@ class PluginModelFactory {
             name: this.name,
             dataModel: this.data(config),
             outputs: this.outputs,
+            featureFlags: this.featureFlags,
         });
     }
 }
-// =============================================================================
-// Plugin Model Builder
-// =============================================================================
 /**
  * Builder for creating PluginType with type-safe output definitions.
  *
@@ -107,20 +103,22 @@ class PluginModelBuilder {
     name;
     data;
     outputs;
-    constructor(input) {
-        this.name = input.name;
-        this.data = input.data;
+    featureFlags;
+    constructor(options) {
+        this.name = options.name;
+        this.data = options.data;
         this.outputs =
-            input.outputs ??
+            options.outputs ??
                 {};
+        this.featureFlags = options.featureFlags;
     }
     /**
      * Internal method for creating PluginModelBuilder.
      * Uses Symbol key to prevent external access.
      * @internal
      */
-    static [FROM_BUILDER](input) {
-        return new this(input);
+    static [FROM_BUILDER](options) {
+        return new PluginModelBuilder(options);
     }
     /**
      * Adds an output to the plugin.
@@ -137,6 +135,7 @@ class PluginModelBuilder {
         return new PluginModelBuilder({
             name: this.name,
             data: this.data,
+            featureFlags: this.featureFlags,
             outputs: {
                 ...this.outputs,
                 [key]: fn,
@@ -161,6 +160,7 @@ class PluginModelBuilder {
             name: this.name,
             data: this.data,
             outputs: this.outputs,
+            featureFlags: this.featureFlags,
         });
     }
 }

package/dist/plugin_model.js.map

@@ -1 +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 { PluginRenderCtx } from \"./render\";\n\n/** Symbol for internal builder creation method */\nconst FROM_BUILDER = Symbol(\"fromBuilder\");\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;AAE1C;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;;;;"}
+{"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 { BlockCodeKnownFeatureFlags } from \"@milaboratories/pl-model-common\";\nimport type { DataModel } from \"./block_migrations\";\nimport type { PluginName } from \"./block_storage\";\nimport type { PluginFactoryLike } from \"./plugin_handle\";\nimport type { PluginRenderCtx } from \"./render\";\n\n/** Symbol for internal builder creation method */\nconst FROM_BUILDER = Symbol(\"fromBuilder\");\n\nexport type PluginData = Record<string, unknown>;\nexport type PluginParams = undefined | Record<string, unknown>;\nexport type PluginOutputs = Record<string, unknown>;\nexport type PluginConfig = undefined | Record<string, unknown>;\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<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n> {\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: {\n    [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n  };\n  /** Feature flags declared by this plugin */\n  readonly featureFlags?: BlockCodeKnownFeatureFlags;\n\n  private constructor(options: {\n    name: PluginName;\n    dataModel: DataModel<Data>;\n    outputs: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }) {\n    this.name = options.name;\n    this.dataModel = options.dataModel;\n    this.outputs = options.outputs;\n    this.featureFlags = options.featureFlags;\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]<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n  >(options: {\n    name: PluginName;\n    dataModel: DataModel<Data>;\n    outputs: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModel<Data, Params, Outputs> {\n    return new PluginModel<Data, Params, Outputs>(options);\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({\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<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Config extends PluginConfig,\n  >(options: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelBuilder<Data, Params, {}, Config> {\n    return PluginModelBuilder[FROM_BUILDER](options);\n  }\n}\n\n/** Plugin factory returned by PluginModelBuilder.build(). */\nexport interface PluginFactory<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  Config extends PluginConfig = undefined,\n> extends PluginFactoryLike {\n  create(config?: Config): PluginModel<Data, Params, Outputs>;\n  /**\n   * @internal Phantom field for structural type extraction.\n   * Enables InferFactoryData/InferFactoryOutputs to work via PluginFactoryLike.\n   */\n  readonly __types?: { data: Data; params: Params; outputs: Outputs; config: Config };\n}\n\nclass PluginModelFactory<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  Config extends PluginConfig = undefined,\n> implements PluginFactory<Data, Params, Outputs, Config> {\n  private readonly name: PluginName;\n  private readonly data: (config?: Config) => DataModel<Data>;\n  private readonly outputs: {\n    [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n  };\n  private readonly featureFlags?: BlockCodeKnownFeatureFlags;\n\n  constructor(options: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    outputs: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }) {\n    this.name = options.name;\n    this.data = options.data;\n    this.outputs = options.outputs;\n    this.featureFlags = options.featureFlags;\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      featureFlags: this.featureFlags,\n    });\n  }\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 extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  Config extends PluginConfig = undefined,\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<PluginFactoryLike<Data, Params>>) => Outputs[K];\n  };\n  private readonly featureFlags?: BlockCodeKnownFeatureFlags;\n\n  private constructor(options: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    outputs?: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }) {\n    this.name = options.name;\n    this.data = options.data;\n    this.outputs =\n      options.outputs ??\n      ({} as {\n        [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n      });\n    this.featureFlags = options.featureFlags;\n  }\n\n  /**\n   * Internal method for creating PluginModelBuilder.\n   * Uses Symbol key to prevent external access.\n   * @internal\n   */\n  static [FROM_BUILDER]<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    Config extends PluginConfig,\n  >(options: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    outputs?: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelBuilder<Data, Params, Outputs, Config> {\n    return new PluginModelBuilder(options);\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<PluginFactoryLike<Data, Params>>) => T,\n  ): PluginModelBuilder<Data, Params, Outputs & { [K in Key]: T }, Config> {\n    return new PluginModelBuilder<Data, Params, Outputs & { [K in Key]: T }, Config>({\n      name: this.name,\n      data: this.data,\n      featureFlags: this.featureFlags,\n      outputs: {\n        ...this.outputs,\n        [key]: fn,\n      } as {\n        [K in keyof (Outputs & { [P in Key]: T })]: (\n          ctx: PluginRenderCtx<PluginFactoryLike<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(): PluginFactory<Data, Params, Outputs, Config> {\n    return new PluginModelFactory<Data, Params, Outputs, Config>({\n      name: this.name,\n      data: this.data,\n      outputs: this.outputs,\n      featureFlags: this.featureFlags,\n    });\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/render/api.cjs

@@ -549,14 +549,19 @@ class RenderCtxLegacy extends RenderCtxBase {
 /**
  * Render context for plugin output functions.
  * Reads plugin data from blockStorage and derives params from pre-wrapped input callbacks.
+ *
+ * Parameterized on the factory-like phantom F so that getPluginData returns
+ * InferFactoryData<F> directly — no casts needed for the data getter.
+ *
+ * @typeParam F - PluginFactoryLike phantom carrying data/params/outputs types
  */
 class PluginRenderCtx {
     ctx;
-    pluginId;
+    handle;
     wrappedInputs;
-    constructor(pluginId, wrappedInputs) {
+    constructor(handle, wrappedInputs) {
         this.ctx = internal.getCfgRenderCtx();
-        this.pluginId = pluginId;
+        this.handle = handle;
         this.wrappedInputs = wrappedInputs;
     }
     dataCache;
@@ -564,8 +569,7 @@ class PluginRenderCtx {
     get data() {
         if (this.dataCache === undefined) {
             const raw = this.ctx.blockStorage();
-            const pluginData = block_storage.getPluginData(plModelCommon.parseJson(raw), this.pluginId);
-            this.dataCache = { v: pluginData };
+            this.dataCache = { v: block_storage.getPluginData(plModelCommon.parseJson(raw), this.handle) };
         }
         return this.dataCache.v;
     }