@platforma-sdk/model 1.54.13 → 1.56.0

package/dist/block_storage_facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_storage_facade.js","sources":["../src/block_storage_facade.ts"],"sourcesContent":["/**\n * Block Storage Facade - Contract between bundled blocks and middle layer.\n *\n * ============================================================================\n * VERSIONING\n * ============================================================================\n *\n * Blocks declare their model API version via the `requiresModelAPIVersion` feature flag\n * (see BlockCodeKnownFeatureFlags). This determines how the middle layer manages block state:\n *\n * - Version 1: Legacy BlockModel - state is {args, uiState}, managed directly by middle layer\n * - Version 2: BlockModelV3 - uses blockStorage with VM-based callbacks (this facade)\n *\n * This facade (BlockStorageFacade) is used by blocks with `requiresModelAPIVersion: 2`.\n * The version number matches the model API version for clarity.\n *\n * ============================================================================\n * BACKWARD COMPATIBILITY WARNING\n * ============================================================================\n *\n * This file documents the FACADE between the SDK (bundled into blocks) and the\n * middle layer. Once a block is published, its SDK version is frozen. The middle\n * layer must support ALL previously released callback signatures indefinitely.\n *\n * RULES:\n * 1. NEVER change the signature of existing callbacks\n * 2. NEVER remove existing callbacks\n * 3. New callbacks CAN be added (old blocks won't register them, middle layer\n *    should handle missing callbacks gracefully)\n * 4. Callback return types can be EXTENDED (add optional fields) but not changed\n * 5. Callback parameter types should remain compatible (middle layer may need\n *    to handle both old and new formats)\n *\n * The facade consists of callbacks registered via `tryRegisterCallback()` with\n * the `__pl_` prefix. These are registered by the SDK when a block loads and\n * called by the middle layer to perform operations.\n *\n * ============================================================================\n * WHAT CAN BE CHANGED FREELY\n * ============================================================================\n *\n * - Middle layer code (lib/node/pl-middle-layer)\n * - SDK internal implementation (as long as callback contracts are preserved)\n * - SDK exports used ONLY by middle layer (not by blocks themselves)\n * - New SDK features that don't affect existing callbacks\n *\n * @module block_storage_facade\n */\n\nimport type { MutateStoragePayload } from \"./block_storage\";\nimport type { ConfigRenderLambda } from \"./bconfig\";\nimport { createRenderLambda, tryRegisterCallback } from \"./internal\";\nimport type { StringifiedJson } from \"@milaboratories/pl-model-common\";\n\n// =============================================================================\n// Facade Version\n// =============================================================================\n\n/**\n * The current facade version. This value is used for `requiresModelAPIVersion`\n * feature flag in BlockModelV3.\n */\nexport const BLOCK_STORAGE_FACADE_VERSION = 2;\n\n// =============================================================================\n// Facade Callback Names\n// =============================================================================\n\n/**\n * All facade callback names as constants.\n * These are the source of truth - the interface is derived from these.\n *\n * IMPORTANT: When adding a new callback:\n * 1. Add the constant here\n * 2. Add the callback signature to FacadeCallbackTypes below\n * 3. The BlockStorageFacade type will automatically include it\n */\nexport const BlockStorageFacadeCallbacks = {\n  StorageApplyUpdate: \"__pl_storage_applyUpdate\",\n  StorageDebugView: \"__pl_storage_debugView\",\n  StorageMigrate: \"__pl_storage_migrate\",\n  ArgsDerive: \"__pl_args_derive\",\n  PrerunArgsDerive: \"__pl_prerunArgs_derive\",\n  StorageInitial: \"__pl_storage_initial\",\n} as const;\n\n/**\n * Creates a map of lambda handles from a callbacks constant object.\n * Keys are the callback string values (e.g., '__pl_storage_applyUpdate').\n */\nfunction createFacadeHandles<T extends Record<string, string>>(\n  callbacks: T,\n): { [K in T[keyof T]]: ConfigRenderLambda } {\n  return Object.fromEntries(\n    Object.values(callbacks).map((handle) => [handle, createRenderLambda({ handle })]),\n  ) as { [K in T[keyof T]]: ConfigRenderLambda };\n}\n\n/**\n * Lambda handles for facade callbacks.\n * Used by the middle layer to invoke callbacks via executeSingleLambda().\n */\nexport const BlockStorageFacadeHandles = createFacadeHandles(BlockStorageFacadeCallbacks);\n\n// =============================================================================\n// Facade Interface (source of truth for callback signatures)\n// =============================================================================\n\n/**\n * The complete facade interface between bundled blocks (SDK) and middle layer.\n *\n * This interface defines ALL callbacks that a block registers. The middle layer\n * calls these callbacks to perform storage operations.\n *\n * ALL types are inlined to simplify versioning - when a callback changes,\n * the entire signature is visible in one place.\n *\n * BACKWARD COMPATIBILITY:\n * - This interface can only be EXTENDED, never shrunk\n * - Existing callback signatures MUST NOT change\n * - Middle layer should use Partial<BlockStorageFacade> when dealing with\n *   blocks of unknown version (older blocks may not have all callbacks)\n *\n * Each callback is documented with:\n * - Purpose and when it's called\n * - Parameter descriptions\n * - Return value description\n */\nexport interface BlockStorageFacade {\n  /**\n   * Apply state update to storage.\n   * Called when UI updates block state (setState) or plugin data.\n   * @param currentStorageJson - Current storage as JSON string\n   * @param payload - Update payload with operation type and value\n   * @returns Updated storage as JSON string\n   */\n  [BlockStorageFacadeCallbacks.StorageApplyUpdate]: (\n    currentStorageJson: StringifiedJson,\n    payload: MutateStoragePayload,\n  ) => StringifiedJson;\n\n  /**\n   * Get debug view of storage.\n   * Called by developer tools to inspect storage state.\n   * @param storageJson - Storage as JSON string (or undefined for new blocks)\n   * @returns JSON string containing StorageDebugView\n   */\n  [BlockStorageFacadeCallbacks.StorageDebugView]: (\n    storageJson: StringifiedJson | undefined,\n  ) => StringifiedJson;\n\n  /**\n   * Run storage migration.\n   * Called when block loads to migrate data to latest version.\n   * @param currentStorageJson - Current storage as JSON string (or undefined for new blocks)\n   * @returns Migration result - either error or success with new storage\n   */\n  [BlockStorageFacadeCallbacks.StorageMigrate]: (currentStorageJson: StringifiedJson | undefined) =>\n    | { error: string }\n    | {\n        error?: undefined;\n        newStorageJson: StringifiedJson;\n        info: string;\n      };\n\n  /**\n   * Derive args from storage.\n   * Called to get block configuration args from storage.\n   * @param storageJson - Storage as JSON string\n   * @returns Args derivation result - either error or derived value\n   */\n  [BlockStorageFacadeCallbacks.ArgsDerive]: (\n    storageJson: StringifiedJson,\n  ) => { error: string } | { error?: undefined; value: unknown };\n\n  /**\n   * Derive prerunArgs from storage.\n   * Called to get prerun args; falls back to args callback if not registered.\n   * @param storageJson - Storage as JSON string\n   * @returns Args derivation result - either error or derived value\n   */\n  [BlockStorageFacadeCallbacks.PrerunArgsDerive]: (\n    storageJson: StringifiedJson,\n  ) => { error: string } | { error?: undefined; value: unknown };\n\n  /**\n   * Get initial storage JSON for new blocks.\n   * Called when creating a new block to get complete initial storage.\n   * @returns Initial storage as JSON string\n   */\n  [BlockStorageFacadeCallbacks.StorageInitial]: () => StringifiedJson;\n}\n\n/** Register all facade callbacks at once. Ensures all required callbacks are provided. */\nexport function registerFacadeCallbacks(callbacks: BlockStorageFacade): void {\n  for (const key of Object.values(BlockStorageFacadeCallbacks)) {\n    tryRegisterCallback(key, callbacks[key] as (...args: any[]) => any);\n  }\n}\n"],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CG;AAOH;AACA;AACA;AAEA;;;AAGG;AACI,MAAM,4BAA4B,GAAG;AAE5C;AACA;AACA;AAEA;;;;;;;;AAQG;AACI,MAAM,2BAA2B,GAAG;AACzC,IAAA,kBAAkB,EAAE,0BAA0B;AAC9C,IAAA,gBAAgB,EAAE,wBAAwB;AAC1C,IAAA,cAAc,EAAE,sBAAsB;AACtC,IAAA,UAAU,EAAE,kBAAkB;AAC9B,IAAA,gBAAgB,EAAE,wBAAwB;AAC1C,IAAA,cAAc,EAAE,sBAAsB;;AAGxC;;;AAGG;AACH,SAAS,mBAAmB,CAC1B,SAAY,EAAA;AAEZ,IAAA,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CACtC;AAChD;AAEA;;;AAGG;MACU,yBAAyB,GAAG,mBAAmB,CAAC,2BAA2B;AA2FxF;AACM,SAAU,uBAAuB,CAAC,SAA6B,EAAA;IACnE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,2BAA2B,CAAC,EAAE;QAC5D,mBAAmB,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAA4B,CAAC;IACrE;AACF;;;;"}

package/dist/index.cjs

@@ -2,9 +2,11 @@
 
 var block_state_util = require('./block_state_util.cjs');
 var block_storage = require('./block_storage.cjs');
-var builder = require('./builder.cjs');
+var block_storage_facade = require('./block_storage_facade.cjs');
+var block_model_legacy = require('./block_model_legacy.cjs');
 var block_model = require('./block_model.cjs');
 var block_migrations = require('./block_migrations.cjs');
+var plugin_model = require('./plugin_model.cjs');
 var normalization = require('./bconfig/normalization.cjs');
 var types = require('./bconfig/types.cjs');
 var PFrameForGraphs = require('./components/PFrameForGraphs.cjs');
@@ -23,7 +25,7 @@ var label = require('./render/util/label.cjs');
 var axis_filtering = require('./render/util/axis_filtering.cjs');
 var column_collection = require('./render/util/column_collection.cjs');
 var future = require('./render/future.cjs');
-var sdk_info = require('./sdk_info.cjs');
+var version = require('./version.cjs');
 var raw_globals = require('./raw_globals.cjs');
 var filterToQuery = require('./filters/converters/filterToQuery.cjs');
 var filterUiToExpressionImpl = require('./filters/converters/filterUiToExpressionImpl.cjs');
@@ -45,30 +47,26 @@ exports.BLOCK_STORAGE_KEY = block_storage.BLOCK_STORAGE_KEY;
 exports.BLOCK_STORAGE_SCHEMA_VERSION = block_storage.BLOCK_STORAGE_SCHEMA_VERSION;
 exports.DATA_MODEL_DEFAULT_VERSION = block_storage.DATA_MODEL_DEFAULT_VERSION;
 exports.createBlockStorage = block_storage.createBlockStorage;
-exports.defaultBlockStorageHandlers = block_storage.defaultBlockStorageHandlers;
 exports.deriveDataFromStorage = block_storage.deriveDataFromStorage;
-exports.getFromStorage = block_storage.getFromStorage;
 exports.getPluginData = block_storage.getPluginData;
-exports.getPluginNames = block_storage.getPluginNames;
 exports.getStorageData = block_storage.getStorageData;
-exports.getStorageDataVersion = block_storage.getStorageDataVersion;
 exports.isBlockStorage = block_storage.isBlockStorage;
-exports.mergeBlockStorageHandlers = block_storage.mergeBlockStorageHandlers;
+exports.migrateBlockStorage = block_storage.migrateBlockStorage;
 exports.normalizeBlockStorage = block_storage.normalizeBlockStorage;
-exports.removePluginData = block_storage.removePluginData;
-exports.setPluginData = block_storage.setPluginData;
-exports.updateStorage = block_storage.updateStorage;
 exports.updateStorageData = block_storage.updateStorageData;
-exports.updateStorageDataVersion = block_storage.updateStorageDataVersion;
-exports.BlockModel = builder.BlockModel;
+exports.BLOCK_STORAGE_FACADE_VERSION = block_storage_facade.BLOCK_STORAGE_FACADE_VERSION;
+exports.BlockStorageFacadeCallbacks = block_storage_facade.BlockStorageFacadeCallbacks;
+exports.BlockStorageFacadeHandles = block_storage_facade.BlockStorageFacadeHandles;
+exports.registerFacadeCallbacks = block_storage_facade.registerFacadeCallbacks;
+exports.BlockModel = block_model_legacy.BlockModel;
 exports.BlockModelV3 = block_model.BlockModelV3;
 exports.DataModel = block_migrations.DataModel;
 exports.DataModelBuilder = block_migrations.DataModelBuilder;
 exports.DataUnrecoverableError = block_migrations.DataUnrecoverableError;
 exports.defaultRecover = block_migrations.defaultRecover;
-exports.defineDataVersions = block_migrations.defineDataVersions;
 exports.isDataUnrecoverableError = block_migrations.isDataUnrecoverableError;
 exports.makeDataVersioned = block_migrations.makeDataVersioned;
+exports.PluginModel = plugin_model.PluginModel;
 exports.downgradeCfgOrLambda = normalization.downgradeCfgOrLambda;
 exports.extractConfig = normalization.extractConfig;
 exports.isConfigLambda = types.isConfigLambda;
@@ -151,7 +149,8 @@ exports.deriveLabels = label.deriveLabels;
 exports.filterDataInfoEntries = axis_filtering.filterDataInfoEntries;
 exports.PColumnCollection = column_collection.PColumnCollection;
 exports.FutureRef = future.FutureRef;
-exports.CurrentSdkInfo = sdk_info.CurrentSdkInfo;
+exports.CurrentSdkInfo = version.CurrentSdkInfo;
+exports.PlatformaSDKVersion = version.PlatformaSDKVersion;
 exports.getPlatformaApiVersion = raw_globals.getPlatformaApiVersion;
 exports.getRawPlatformaInstance = raw_globals.getRawPlatformaInstance;
 exports.filterSpecToSpecQueryExpr = filterToQuery.filterSpecToSpecQueryExpr;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.d.ts

@@ -1,9 +1,14 @@
 export * from "./block_state_patch";
 export * from "./block_state_util";
 export * from "./block_storage";
-export * from "./builder";
+export * from "./block_storage_facade";
+export * from "./block_model_legacy";
 export { BlockModelV3 } from "./block_model";
-export { DataModel, DataModelBuilder, DataUnrecoverableError, isDataUnrecoverableError, defineDataVersions, defaultRecover, makeDataVersioned, } from "./block_migrations";
+export type { PluginInstance, ParamsInput } from "./block_model";
+export { DataModel, DataModelBuilder, DataUnrecoverableError, isDataUnrecoverableError, defaultRecover, makeDataVersioned, } from "./block_migrations";
+export type { LegacyV1State } from "./block_migrations";
+export { PluginModel } from "./plugin_model";
+export type { PluginRenderCtx } from "./plugin_model";
 export * from "./bconfig";
 export * from "./components";
 export * from "./config";
@@ -11,7 +16,7 @@ export * from "./pframe";
 export * from "./platforma";
 export * from "./ref_util";
 export * from "./render";
-export * from "./sdk_info";
+export * from "./version";
 export * from "./raw_globals";
 export * from "./block_api_v1";
 export * from "./block_api_v2";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAE9C,OAAO,KAAK,gBAAgB,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAE9C,OAAO,KAAK,gBAAgB,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,8 +1,10 @@
 export { OutputError, readOutput, wrapOutputs } from './block_state_util.js';
-export { BLOCK_STORAGE_KEY, BLOCK_STORAGE_SCHEMA_VERSION, DATA_MODEL_DEFAULT_VERSION, createBlockStorage, defaultBlockStorageHandlers, deriveDataFromStorage, getFromStorage, getPluginData, getPluginNames, getStorageData, getStorageDataVersion, isBlockStorage, mergeBlockStorageHandlers, normalizeBlockStorage, removePluginData, setPluginData, updateStorage, updateStorageData, updateStorageDataVersion } from './block_storage.js';
-export { BlockModel } from './builder.js';
+export { BLOCK_STORAGE_KEY, BLOCK_STORAGE_SCHEMA_VERSION, DATA_MODEL_DEFAULT_VERSION, createBlockStorage, deriveDataFromStorage, getPluginData, getStorageData, isBlockStorage, migrateBlockStorage, normalizeBlockStorage, updateStorageData } from './block_storage.js';
+export { BLOCK_STORAGE_FACADE_VERSION, BlockStorageFacadeCallbacks, BlockStorageFacadeHandles, registerFacadeCallbacks } from './block_storage_facade.js';
+export { BlockModel } from './block_model_legacy.js';
 export { BlockModelV3 } from './block_model.js';
-export { DataModel, DataModelBuilder, DataUnrecoverableError, defaultRecover, defineDataVersions, isDataUnrecoverableError, makeDataVersioned } from './block_migrations.js';
+export { DataModel, DataModelBuilder, DataUnrecoverableError, defaultRecover, isDataUnrecoverableError, makeDataVersioned } from './block_migrations.js';
+export { PluginModel } from './plugin_model.js';
 export { downgradeCfgOrLambda, extractConfig } from './bconfig/normalization.js';
 export { isConfigLambda } from './bconfig/types.js';
 export { createPFrameForGraphs, enrichCompatible, getAvailableWithLinkersAxes, isHiddenFromGraphColumn, isHiddenFromUIColumn } from './components/PFrameForGraphs.js';
@@ -21,7 +23,7 @@ export { Trace, TraceEntry, deriveLabels } from './render/util/label.js';
 export { filterDataInfoEntries } from './render/util/axis_filtering.js';
 export { PColumnCollection } from './render/util/column_collection.js';
 export { FutureRef } from './render/future.js';
-export { CurrentSdkInfo } from './sdk_info.js';
+export { CurrentSdkInfo, PlatformaSDKVersion } from './version.js';
 export { getPlatformaApiVersion, getRawPlatformaInstance } from './raw_globals.js';
 export { filterSpecToSpecQueryExpr } from './filters/converters/filterToQuery.js';
 export { convertFilterUiToExpressionImpl, convertFilterUiToExpressions } from './filters/converters/filterUiToExpressionImpl.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/package.json.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.54.13";
+var version = "1.56.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.map

package/dist/package.json.js

@@ -1,4 +1,4 @@
-var version = "1.54.13";
+var version = "1.56.0";
 
 export { version };
 //# sourceMappingURL=package.json.js.map

package/dist/platforma.d.ts

@@ -2,8 +2,9 @@ import type { BlockApiV1 } from "./block_api_v1";
 import type { BlockApiV2 } from "./block_api_v2";
 import type { BlockApiV3 } from "./block_api_v3";
 import type { BlockOutputsBase, BlockStateV3, DriverKit, OutputWithStatus } from "@milaboratories/pl-model-common";
-import type { SdkInfo } from "./sdk_info";
+import type { SdkInfo } from "./version";
 import type { BlockStatePatch } from "./block_state_patch";
+import type { PluginInstance } from "./block_model";
 /** Defines all methods to interact with the platform environment from within a block UI. @deprecated */
 export interface PlatformaV1<Args = unknown, Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>, UiState = unknown, Href extends `/${string}` = `/${string}`> extends BlockApiV1<Args, Outputs, UiState, Href>, DriverKit {
     /** Information about SDK version current platforma environment was compiled with. */
@@ -16,12 +17,14 @@ export interface PlatformaV2<Args = unknown, Outputs extends Record<string, Outp
     readonly sdkInfo: SdkInfo;
     readonly apiVersion: 2;
 }
-export interface PlatformaV3<Args = unknown, Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>, Data = unknown, Href extends `/${string}` = `/${string}`> extends BlockApiV3<Args, Outputs, Data, Href>, DriverKit {
+export interface PlatformaV3<Data = unknown, Args = unknown, Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>, Href extends `/${string}` = `/${string}`, Plugins extends Record<string, unknown> = Record<string, unknown>> extends BlockApiV3<Data, Args, Outputs, Href>, DriverKit {
     /** Information about SDK version current platforma environment was compiled with. */
     readonly sdkInfo: SdkInfo;
     readonly apiVersion: 3;
+    /** @internal Type brand for plugin type inference. Not used at runtime. */
+    readonly __pluginsBrand?: Plugins;
 }
-export type Platforma<Args = unknown, Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>, UiState = unknown, Href extends `/${string}` = `/${string}`> = PlatformaV1<Args, Outputs, UiState, Href> | PlatformaV2<Args, Outputs, UiState, Href> | PlatformaV3<Args, Outputs, UiState, Href>;
+export type Platforma<Args = unknown, Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>, UiStateOrData = unknown, Href extends `/${string}` = `/${string}`> = PlatformaV1<Args, Outputs, UiStateOrData, Href> | PlatformaV2<Args, Outputs, UiStateOrData, Href> | PlatformaV3<UiStateOrData, Args, Outputs, Href>;
 export type PlatformaExtended<Pl extends Platforma = Platforma> = Pl & {
     blockModelInfo: BlockModelInfo;
 };
@@ -39,6 +42,10 @@ export type InferHrefType<Pl extends Platforma> = Pl extends Platforma<unknown,
 export type PlatformaFactory = (config: {
     sdkVersion: string;
 }) => Platforma;
-export type InferBlockState<Pl extends Platforma> = BlockStateV3<InferOutputsType<Pl>, InferHrefType<Pl>>;
+export type InferBlockState<Pl extends Platforma> = BlockStateV3<InferDataType<Pl>, InferOutputsType<Pl>, InferHrefType<Pl>>;
 export type InferBlockStatePatch<Pl extends Platforma> = BlockStatePatch<InferArgsType<Pl>, InferOutputsType<Pl>, InferUiState<Pl>, InferHrefType<Pl>>;
+/** Extract plugin IDs as a string literal union from a Platforma type. */
+export type InferPluginNames<Pl> = Pl extends PlatformaV3<any, any, any, any, infer P> ? string & keyof P : never;
+/** Extract the Data type for a specific plugin by its ID. */
+export type InferPluginData<Pl, PluginId extends string> = Pl extends PlatformaV3<any, any, any, any, infer P> ? PluginId extends keyof P ? P[PluginId] extends PluginInstance<infer D, any, any> ? D : never : never : never;
 //# sourceMappingURL=platforma.d.ts.map

package/dist/platforma.d.ts.map

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

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":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,kDAAkD;AAClD,QAAA,MAAM,YAAY,eAAwB,CAAC;AAM3C;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IACvD,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAMD;;;GAGG;AACH,qBAAa,WAAW,CAAC,IAAI,GAAG,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAG,EAAE;IACvE,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE;SAAG,CAAC,IAAI,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;KAAE,CAAC;IAE/F,OAAO;IAUP;;;;OAIG;IACH,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE;QACpC,IAAI,EAAE,UAAU,CAAC;QACjB,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,EAAE;aAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAAE,CAAC;KACnE,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAIxB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE;QACnE,IAAI,EAAE,UAAU,CAAC;QACjB,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC;KAC5C,GAAG,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC;CAG7C;AAED;;;GAGG;AACH,cAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;gBAEU,KAAK,EAAE;QACjB,IAAI,EAAE,UAAU,CAAC;QACjB,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,EAAE;aAAG,CAAC,IAAI,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;SAAE,CAAC;KACvF;IAMD,+CAA+C;IAC/C,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC;CAO5D;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,cAAM,kBAAkB,CACtB,IAAI,EACJ,MAAM,GAAG,SAAS,EAClB,MAAM,GAAG,SAAS,EAClB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE;IAE5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IAEF,OAAO;IAYP;;;;OAIG;IACH,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE;QAC5E,IAAI,EAAE,UAAU,CAAC;QACjB,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC;QACnC,OAAO,CAAC,EAAE;aAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAAE,CAAC;KACpE,GAAG,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAIlC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,MAAM,EAAE,CAAC,EAChC,GAAG,EAAE,GAAG,EACR,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,GAC5C,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG;SAAG,CAAC,IAAI,GAAG,GAAG,CAAC;KAAE,CAAC;IAexE;;;;;;;;;;;;OAYG;IACH,KAAK,IAAI,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;CAO3D"}