@platforma-sdk/model 1.61.1 → 1.62.0

package/dist/components/PlDataTable/createPlDataTable/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/PlDataTable/createPlDataTable/index.ts"],"sourcesContent":["import type { RenderCtxBase } from \"../../../render\";\nimport type { PlDataTableModel } from \"../typesV5\";\nimport { createPlDataTableOptionsV2, createPlDataTableV2 } from \"./createPlDataTableV2\";\nimport { createPlDataTableV3 } from \"./createPlDataTableV3\";\nimport type { createPlDataTableOptionsV3 } from \"./createPlDataTableV3\";\n\nexport function createPlDataTable<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  options: { version: \"v2\" } & createPlDataTableOptionsV2,\n): ReturnType<typeof createPlDataTableV2>;\nexport function createPlDataTable<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  options: { version?: \"v3\" } & createPlDataTableOptionsV3,\n): ReturnType<typeof createPlDataTableV3>;\nexport function createPlDataTable<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  options:\n    | ({ version: \"v2\" } & createPlDataTableOptionsV2)\n    | ({ version?: \"v3\" } & createPlDataTableOptionsV3),\n): PlDataTableModel | undefined {\n  if (options.version === \"v2\") {\n    return createPlDataTableV2(ctx, options.columns, options.tableState, options.options);\n  } else {\n    // default version is last (v3 at the moment)\n    return createPlDataTableV3(ctx, options);\n  }\n}\n"],"mappings":";;;;AAcA,SAAgB,kBACd,KACA,SAG8B;AAC9B,KAAI,QAAQ,YAAY,KACtB,QAAO,oBAAoB,KAAK,QAAQ,SAAS,QAAQ,YAAY,QAAQ,QAAQ;KAGrF,QAAO,oBAAoB,KAAK,QAAQ"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/PlDataTable/createPlDataTable/index.ts"],"sourcesContent":["import { Services, type RequireServices } from \"@milaboratories/pl-model-common\";\nimport type { RenderCtxBase } from \"../../../render\";\nimport type { PlDataTableModel } from \"../typesV5\";\nimport { createPlDataTableOptionsV2, createPlDataTableV2 } from \"./createPlDataTableV2\";\nimport { createPlDataTableV3 } from \"./createPlDataTableV3\";\nimport type { createPlDataTableOptionsV3 } from \"./createPlDataTableV3\";\n\nexport function createPlDataTable<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  options: { version: \"v2\" } & createPlDataTableOptionsV2,\n): ReturnType<typeof createPlDataTableV2>;\nexport function createPlDataTable<A, U, S extends RequireServices<typeof Services.PFrameSpec>>(\n  ctx: RenderCtxBase<A, U, S>,\n  options: { version?: \"v3\" } & createPlDataTableOptionsV3,\n): ReturnType<typeof createPlDataTableV3>;\nexport function createPlDataTable<A, U, S extends RequireServices<typeof Services.PFrameSpec>>(\n  ctx: RenderCtxBase<A, U, S>,\n  options:\n    | ({ version: \"v2\" } & createPlDataTableOptionsV2)\n    | ({ version?: \"v3\" } & createPlDataTableOptionsV3),\n): PlDataTableModel | undefined {\n  if (options.version === \"v2\") {\n    return createPlDataTableV2(ctx, options.columns, options.tableState, options.options);\n  } else {\n    // default version is last (v3 at the moment)\n    return createPlDataTableV3(ctx, options);\n  }\n}\n"],"mappings":";;;;AAeA,SAAgB,kBACd,KACA,SAG8B;AAC9B,KAAI,QAAQ,YAAY,KACtB,QAAO,oBAAoB,KAAK,QAAQ,SAAS,QAAQ,YAAY,QAAQ,QAAQ;KAGrF,QAAO,oBAAoB,KAAK,QAAQ"}

package/dist/index.cjs

@@ -21,6 +21,7 @@ const require_types = require('./bconfig/types.cjs');
 const require_normalization = require('./bconfig/normalization.cjs');
 require('./bconfig/index.cjs');
 const require_block_model_legacy = require('./block_model_legacy.cjs');
+const require_block_services = require('./services/block_services.cjs');
 const require_plugin_model = require('./plugin_model.cjs');
 const require_block_model = require('./block_model.cjs');
 const require_axes = require('./pframe_utils/axes.cjs');
@@ -53,10 +54,13 @@ const require_raw_globals = require('./raw_globals.cjs');
 const require_converter = require('./annotations/converter.cjs');
 require('./annotations/index.cjs');
 const require_index$9 = require('./pframe_utils/index.cjs');
+const require_service_bridge = require('./services/service_bridge.cjs');
+require('./services/index.cjs');
 const require_env_value = require('./env_value.cjs');
 
 exports.Args = require_actions.Args;
 exports.ArrayColumnProvider = require_column_snapshot_provider.ArrayColumnProvider;
+exports.BLOCK_SERVICE_FLAGS = require_block_services.BLOCK_SERVICE_FLAGS;
 exports.BLOCK_STORAGE_FACADE_VERSION = require_block_storage_facade.BLOCK_STORAGE_FACADE_VERSION;
 exports.BlockModel = require_block_model_legacy.BlockModel;
 exports.BlockModelV3 = require_block_model.BlockModelV3;
@@ -104,6 +108,8 @@ exports.TreeNodeAccessor = require_accessor.TreeNodeAccessor;
 exports.UiState = require_actions.UiState;
 exports.allPColumnsReady = require_pcolumn_data.allPColumnsReady;
 exports.and = require_actions.and;
+exports.blockServiceNames = require_block_services.blockServiceNames;
+exports.buildServices = require_service_bridge.buildServices;
 exports.collectCtxColumnSnapshotProviders = require_ctx_column_sources.collectCtxColumnSnapshotProviders;
 exports.columnSelectorsToPredicate = require_column_selector.columnSelectorsToPredicate;
 exports.compileAnnotationScript = require_filters_ui.compileAnnotationScript;
@@ -116,6 +122,7 @@ exports.convertOrParsePColumnData = require_pcolumn_data.convertOrParsePColumnDa
 exports.createBlockStorage = require_block_storage.createBlockStorage;
 exports.createColumnSnapshot = require_column_snapshot.createColumnSnapshot;
 exports.createDefaultPTableParams = require_state_migration.createDefaultPTableParams;
+exports.createNodeServiceProxy = require_service_bridge.createNodeServiceProxy;
 exports.createPFrameForGraphs = require_PFrameForGraphs.createPFrameForGraphs;
 exports.createPlDataTable = require_index$5.createPlDataTable;
 exports.createPlDataTableSheet = require_createPlDataTableSheet.createPlDataTableSheet;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { BlockStatePatch, Patch, Unionize } from "./block_state_patch.js";
 import { OutputError, readOutput, wrapOutputs } from "./block_state_util.js";
-import { InferFactoryData, InferFactoryOutputs, InferFactoryParams, InferPluginHandle, PluginFactoryLike, PluginHandle, isPluginOutputKey, pluginOutputKey, pluginOutputPrefix } from "./plugin_handle.js";
+import { InferFactoryData, InferFactoryModelServices, InferFactoryOutputs, InferFactoryParams, InferFactoryUiServices, InferPluginHandle, PluginFactoryLike, PluginHandle, isPluginOutputKey, pluginOutputKey, pluginOutputPrefix } from "./plugin_handle.js";
 import { DataModel, DataModelBuilder } from "./block_migrations.js";
 import { BlockStorage, BlockStorageSchemaVersion, MigrateBlockStorageConfig, MigrationFailure, MigrationResult, MigrationSuccess, MutateStoragePayload, PluginName, PluginRegistry, VersionedData, createBlockStorage, deriveDataFromStorage, getPluginData, getStorageData, isBlockStorage, migrateBlockStorage, normalizeBlockStorage, updateStorageData } from "./block_storage.js";
 import { Cfg, CfgAnd, CfgBlobContent, CfgBlobContentAsJson, CfgBlobContentAsString, CfgDownloadedBlobContent, CfgExtractArchiveAndGetURL, CfgFlatten, CfgGetFromCtx, CfgGetJsonField, CfgGetResourceField, CfgImmediate, CfgImportProgress, CfgIsEmpty, CfgIsolate, CfgLastLogs, CfgLogHandle, CfgMakeArray, CfgMakeObject, CfgMapArrayValues, CfgMapRecordValues, CfgMapResourceFields, CfgNot, CfgOnDemandBlobContent, CfgOr, CfgProgressLog, CfgProgressLogWithInfo, CfgResourceValueAsJson } from "./config/model.js";
@@ -20,6 +20,8 @@ import { BLOCK_STORAGE_FACADE_VERSION, BlockStorageFacade, BlockStorageFacadeCal
 import { BlockApiV1, CancelSubscription } from "./block_api_v1.js";
 import { BlockApiV2 } from "./block_api_v2.js";
 import { CurrentSdkInfo, PlatformaSDKVersion, SdkInfo } from "./version.js";
+import { BLOCK_SERVICE_FLAGS, BlockServiceFlags, blockServiceNames } from "./services/block_services.js";
+import { BlockDefaultModelServices, BlockDefaultUiServices, ModelServices, ResolveModelServices, ResolveUiServices, UiServices } from "./services/service_resolve.js";
 import { CommonFieldTraverseOps, CommonTraversalOps, FieldTraversalStep, FieldType, GetFieldStep, ResourceTraversalOps, ResourceType } from "./render/traversal_ops.js";
 import { PColumnDataUniversal, internal_d_exports } from "./render/internal.js";
 import { ExtractFutureRefType, FutureRef } from "./render/future.js";
@@ -69,7 +71,9 @@ import { fromPlOption, fromPlRef } from "./ref_util.js";
 import { getPlatformaApiVersion, getRawPlatformaInstance } from "./raw_globals.js";
 import { getAllRelatedColumns, getRelatedColumns } from "./pframe_utils/columns.js";
 import { getAxisUniqueValues, getColumnOrAxisValueLabelsId, getColumnSpecById, getColumnUniqueValues, getColumnsFull, getRequestColumnsFromSelectedSources, getSingleColumnData, getUniqueSourceValuesWithLabels } from "./pframe_utils/index.js";
+import { NodeServiceProxy, buildServices, createNodeServiceProxy } from "./services/service_bridge.js";
+import "./services/index.js";
 import { getEnvironmentValue } from "./env_value.js";
 export * from "@milaboratories/pl-model-common";
 export * from "@milaboratories/pl-error-like";
-export { ActAnd, ActExtractArchiveAndGetURL, ActFlatten, ActGetBlobContent, ActGetBlobContentAsJson, ActGetBlobContentAsString, ActGetDownloadedBlobContent, ActGetField, ActGetFromCtx, ActGetImmediate, ActGetLastLogs, ActGetLogHandle, ActGetOnDemandBlobContent, ActGetProgressLog, ActGetProgressLogWithInfo, ActGetResourceField, ActGetResourceValueAsJson, ActImportProgress, ActIsEmpty, ActIsolate, ActMakeArray, ActMakeObject, ActMapArrayValues, ActMapRecordValues, ActMapResourceFields, ActNot, ActOr, ActionResult, AnchoredBuildOptions, AnchoredColumnCollection, AnchoredFindColumnsOptions, AndFilter, AnnotationFilter, AnnotationMode, AnnotationScript, AnnotationScript2, AnnotationScriptUi, AnnotationSpec, AnnotationSpecUi, AnnotationStep, AnnotationStepUi, AnyForm, Args, ArrayColumnProvider, AxesVault, AxisLabelProvider, BLOCK_STORAGE_FACADE_VERSION, BlockApiV1, BlockApiV2, BlockConfig, BlockConfigV3, BlockConfigV4, BlockModel, BlockModelInfo, BlockModelV3, BlockRenderCtx, BlockStatePatch, type BlockStorage, BlockStorageFacade, BlockStorageFacadeCallbacks, BlockStorageFacadeHandles, type BlockStorageSchemaVersion, BuildOptions, CancelSubscription, Cfg, CfgAnd, CfgBlobContent, CfgBlobContentAsJson, CfgBlobContentAsString, CfgDownloadedBlobContent, CfgExtractArchiveAndGetURL, CfgFlatten, CfgGetFromCtx, CfgGetJsonField, CfgGetResourceField, CfgImmediate, CfgImportProgress, CfgIsEmpty, CfgIsolate, CfgLastLogs, CfgLogHandle, CfgMakeArray, CfgMakeObject, CfgMapArrayValues, CfgMapRecordValues, CfgMapResourceFields, CfgNot, CfgOnDemandBlobContent, CfgOr, CfgProgressLog, CfgProgressLogWithInfo, CfgRenderingMode, CfgResourceValueAsJson, Checked, ColumnCollection, ColumnCollectionBuilder, ColumnData, ColumnDataStatus, ColumnMatch, ColumnProvider, ColumnSelectorInput, ColumnSnapshot, ColumnSnapshotProvider, ColumnSource, CommonFieldTraverseOps, CommonTraversalOps, ConfAction, ConfigRenderLambda, ConfigRenderLambdaFlags, ConfigResult, CurrentSdkInfo, DataModel, DataModelBuilder, DeriveHref, DeriveLabelsOptions, Entry, ExpressionSpec, ExtractAction, ExtractFunctionHandleReturn, ExtractFutureRefType, FieldTraversalStep, FieldType, FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, FilterSpecUi, FilterUi, FilterUiOfType, FilterUiType, FindColumnsOptions, FormField, FutureRef, GetFieldStep, InferArgsType, InferBlockState, InferBlockStatePatch, InferDataType, InferFactoryData, InferFactoryOutputs, InferFactoryParams, InferHrefType, InferOutputType, InferOutputsFromConfigs, InferOutputsFromLambdas, InferOutputsType, InferPluginData, InferPluginHandle, InferPluginHandles, InferPluginNames, InferRenderFunctionReturn, InferUiState, InferVarTypeSafe, IsNA, It, internal_d_exports as JsRenderInternal, DeriveLabelsOptions as LabelDerivationOps, Log10, MainOutputs, MatchQualifications, MatchVariant, MatchingMode, type MigrateBlockStorageConfig, type MigrationFailure, type MigrationResult, type MigrationSuccess, type MutateStoragePayload, NotFilter, NumericalComparisonFilter, OptionalPlResourceEntry, OrFilter, OutputColumnProvider, OutputColumnProviderOpts, OutputError, PColumnCollection, PColumnDataUniversal, PColumnEntryUniversal, PColumnEntryWithLabel, PColumnKeyList, PColumnLazyUniversal, PColumnLazyWithLabel, PColumnPredicate, PColumnResourceMapData, PColumnResourceMapEntry, PFrameImpl, POCExtractAction, PTableKey, PTableParamsV2, type ParamsInput, Patch, PatternFilter, PatternPredicate, PatternPredicateContainSubsequence, PatternPredicateEquals, PlDataTableFilters, PlDataTableFiltersWithMeta, PlDataTableGridStateCore, PlDataTableModel, PlDataTableSheet, PlDataTableSheetState, PlDataTableStateV2, PlDataTableStateV2CacheEntry, PlDataTableStateV2Normalized, PlMultiSequenceAlignmentColorSchemeOption, PlMultiSequenceAlignmentModel, PlMultiSequenceAlignmentSettings, PlMultiSequenceAlignmentWidget, PlResourceEntry, PlSelectionModel, PlTableColumnId, PlTableColumnIdJson, Platforma, PlatformaApiVersion, PlatformaExtended, PlatformaFactory, PlatformaSDKVersion, PlatformaV1, PlatformaV2, PlatformaV3, type PluginConfig, type PluginData, PluginDataModel, PluginDataModelBuilder, type PluginDataModelVersions, type PluginFactory, PluginFactoryLike, PluginHandle, PluginInstance, PluginModel, type PluginName, type PluginOutputs, type PluginParams, type PluginRecord, type PluginRegistry, PluginRenderCtx, PrimitiveOrConfig, PrimitiveToCfg, RT_BINARY_PARTITIONED, RT_BINARY_SUPER_PARTITIONED, RT_JSON_PARTITIONED, RT_JSON_SUPER_PARTITIONED, RT_PARQUET_PARTITIONED, RT_PARQUET_SUPER_PARTITIONED, RT_RESOURCE_MAP, RT_RESOURCE_MAP_PARTITIONED, RelaxedAxisSelector, RelaxedColumnSelector, RelaxedRecord, RelaxedStringMatchers, RenderCtx, RenderCtxBase, RenderCtxLegacy, RenderFunction, RenderFunctionLegacy, ResolveCfgType, ResourceTraversalOps, ResourceType, ResultPool, ResultPoolColumnSnapshotProvider, SdkInfo, SimplifiedPColumnSpec, SimplifiedUniversalPColumnEntry, SnapshotColumnProvider, SortedCumulativeSum, Entry as SpecExtractorResult, StagingOutputs, StdCtx, StdCtxArgsOnly, StringMatcher, Trace, TransformedColumn, TreeNodeAccessor, TypeField, TypeFieldRecord, TypeForm, TypeToLiteral, TypedConfig, TypedConfigOrConfigLambda, TypedConfigOrString, UiState, Unionize, UniversalColumnOption, UnwrapFutureRef, ValueRank, type VersionedData, WithLabel, allPColumnsReady, and, collectCtxColumnSnapshotProviders, columnSelectorsToPredicate, compileAnnotationScript, compileFilter, compileFilters, convertFilterSpecsToExpressionSpecs, convertFilterUiToExpressionImpl, convertFilterUiToExpressions, convertOrParsePColumnData, createBlockStorage, createColumnSnapshot, createDefaultPTableParams, createPFrameForGraphs, createPlDataTable, createPlDataTableSheet, createPlDataTableStateV2, createPlDataTableV2, createPlDataTableV3, createPlSelectionModel, createReadyColumnData, createRowSelectionColumn, deriveDataFromStorage, deriveDistinctLabels, deriveLabels, distillFilterSpec, downgradeCfgOrLambda, enrichCompatible, extractArchiveAndGetURL, extractConfig, filterDataInfoEntries, filterSpecToSpecQueryExpr, flatten, fromPlOption, fromPlRef, getAllRelatedColumns, getAvailableWithLinkersAxes, getAxisUniqueValues, getBlobContent, getBlobContentAsJson, getBlobContentAsString, getColumnOrAxisValueLabelsId, getColumnSpecById, getColumnUniqueValues, getColumnsFull, getDownloadedBlobContent, getEnvironmentValue, getFromCfg, getImmediate, getImportProgress, getJsonField, getLastLogs, getLogHandle, getOnDemandBlobContent, getPartitionKeysList, getPlatformaApiVersion, getPluginData, getProgressLog, getProgressLogWithInfo, getRawPlatformaInstance, getRelatedColumns, getRequestColumnsFromSelectedSources, getResourceField, getResourceValueAsJson, getSingleColumnData, getStorageData, getUniquePartitionKeys, getUniqueSourceValuesWithLabels, ifDef, isBlockStorage, isColumnHidden, isColumnOptional, isColumnSnapshotProvider, isConfigLambda, isEmpty, isHiddenFromGraphColumn, isHiddenFromUIColumn, isPColumnReady, isPluginOutputKey, isolate, makeArray, makeObject, mapArrayValues, mapRecordValues, mapResourceFields, matchColumn, matchColumnSelectors, migrateBlockStorage, normalizeBlockStorage, normalizeSelectors, not, or, parsePColumnData, parseResourceMap, pluginOutputKey, pluginOutputPrefix, readOutput, registerFacadeCallbacks, toColumnSnapshotProvider, unreachable, updateStorageData, upgradePlDataTableStateV2, wrapOutputs, writeLabelsToSpecs };
+export { ActAnd, ActExtractArchiveAndGetURL, ActFlatten, ActGetBlobContent, ActGetBlobContentAsJson, ActGetBlobContentAsString, ActGetDownloadedBlobContent, ActGetField, ActGetFromCtx, ActGetImmediate, ActGetLastLogs, ActGetLogHandle, ActGetOnDemandBlobContent, ActGetProgressLog, ActGetProgressLogWithInfo, ActGetResourceField, ActGetResourceValueAsJson, ActImportProgress, ActIsEmpty, ActIsolate, ActMakeArray, ActMakeObject, ActMapArrayValues, ActMapRecordValues, ActMapResourceFields, ActNot, ActOr, ActionResult, AnchoredBuildOptions, AnchoredColumnCollection, AnchoredFindColumnsOptions, AndFilter, AnnotationFilter, AnnotationMode, AnnotationScript, AnnotationScript2, AnnotationScriptUi, AnnotationSpec, AnnotationSpecUi, AnnotationStep, AnnotationStepUi, AnyForm, Args, ArrayColumnProvider, AxesVault, AxisLabelProvider, BLOCK_SERVICE_FLAGS, BLOCK_STORAGE_FACADE_VERSION, BlockApiV1, BlockApiV2, BlockConfig, BlockConfigV3, BlockConfigV4, BlockDefaultModelServices, BlockDefaultUiServices, BlockModel, BlockModelInfo, BlockModelV3, BlockRenderCtx, BlockServiceFlags, BlockStatePatch, type BlockStorage, BlockStorageFacade, BlockStorageFacadeCallbacks, BlockStorageFacadeHandles, type BlockStorageSchemaVersion, BuildOptions, CancelSubscription, Cfg, CfgAnd, CfgBlobContent, CfgBlobContentAsJson, CfgBlobContentAsString, CfgDownloadedBlobContent, CfgExtractArchiveAndGetURL, CfgFlatten, CfgGetFromCtx, CfgGetJsonField, CfgGetResourceField, CfgImmediate, CfgImportProgress, CfgIsEmpty, CfgIsolate, CfgLastLogs, CfgLogHandle, CfgMakeArray, CfgMakeObject, CfgMapArrayValues, CfgMapRecordValues, CfgMapResourceFields, CfgNot, CfgOnDemandBlobContent, CfgOr, CfgProgressLog, CfgProgressLogWithInfo, CfgRenderingMode, CfgResourceValueAsJson, Checked, ColumnCollection, ColumnCollectionBuilder, ColumnData, ColumnDataStatus, ColumnMatch, ColumnProvider, ColumnSelectorInput, ColumnSnapshot, ColumnSnapshotProvider, ColumnSource, CommonFieldTraverseOps, CommonTraversalOps, ConfAction, ConfigRenderLambda, ConfigRenderLambdaFlags, ConfigResult, CurrentSdkInfo, DataModel, DataModelBuilder, DeriveHref, DeriveLabelsOptions, Entry, ExpressionSpec, ExtractAction, ExtractFunctionHandleReturn, ExtractFutureRefType, FieldTraversalStep, FieldType, FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, FilterSpecUi, FilterUi, FilterUiOfType, FilterUiType, FindColumnsOptions, FormField, FutureRef, GetFieldStep, InferArgsType, InferBlockState, InferBlockStatePatch, InferDataType, InferFactoryData, InferFactoryModelServices, InferFactoryOutputs, InferFactoryParams, InferFactoryUiServices, InferHrefType, InferOutputType, InferOutputsFromConfigs, InferOutputsFromLambdas, InferOutputsType, InferPluginData, InferPluginHandle, InferPluginHandles, InferPluginNames, InferRenderFunctionReturn, InferUiState, InferVarTypeSafe, IsNA, It, internal_d_exports as JsRenderInternal, DeriveLabelsOptions as LabelDerivationOps, Log10, MainOutputs, MatchQualifications, MatchVariant, MatchingMode, type MigrateBlockStorageConfig, type MigrationFailure, type MigrationResult, type MigrationSuccess, ModelServices, type MutateStoragePayload, NodeServiceProxy, NotFilter, NumericalComparisonFilter, OptionalPlResourceEntry, OrFilter, OutputColumnProvider, OutputColumnProviderOpts, OutputError, PColumnCollection, PColumnDataUniversal, PColumnEntryUniversal, PColumnEntryWithLabel, PColumnKeyList, PColumnLazyUniversal, PColumnLazyWithLabel, PColumnPredicate, PColumnResourceMapData, PColumnResourceMapEntry, PFrameImpl, POCExtractAction, PTableKey, PTableParamsV2, type ParamsInput, Patch, PatternFilter, PatternPredicate, PatternPredicateContainSubsequence, PatternPredicateEquals, PlDataTableFilters, PlDataTableFiltersWithMeta, PlDataTableGridStateCore, PlDataTableModel, PlDataTableSheet, PlDataTableSheetState, PlDataTableStateV2, PlDataTableStateV2CacheEntry, PlDataTableStateV2Normalized, PlMultiSequenceAlignmentColorSchemeOption, PlMultiSequenceAlignmentModel, PlMultiSequenceAlignmentSettings, PlMultiSequenceAlignmentWidget, PlResourceEntry, PlSelectionModel, PlTableColumnId, PlTableColumnIdJson, Platforma, PlatformaApiVersion, PlatformaExtended, PlatformaFactory, PlatformaSDKVersion, PlatformaV1, PlatformaV2, PlatformaV3, type PluginConfig, type PluginData, PluginDataModel, PluginDataModelBuilder, type PluginDataModelVersions, type PluginFactory, PluginFactoryLike, PluginHandle, PluginInstance, PluginModel, type PluginName, type PluginOutputs, type PluginParams, type PluginRecord, type PluginRegistry, PluginRenderCtx, PrimitiveOrConfig, PrimitiveToCfg, RT_BINARY_PARTITIONED, RT_BINARY_SUPER_PARTITIONED, RT_JSON_PARTITIONED, RT_JSON_SUPER_PARTITIONED, RT_PARQUET_PARTITIONED, RT_PARQUET_SUPER_PARTITIONED, RT_RESOURCE_MAP, RT_RESOURCE_MAP_PARTITIONED, RelaxedAxisSelector, RelaxedColumnSelector, RelaxedRecord, RelaxedStringMatchers, RenderCtx, RenderCtxBase, RenderCtxLegacy, RenderFunction, RenderFunctionLegacy, ResolveCfgType, ResolveModelServices, ResolveUiServices, ResourceTraversalOps, ResourceType, ResultPool, ResultPoolColumnSnapshotProvider, SdkInfo, SimplifiedPColumnSpec, SimplifiedUniversalPColumnEntry, SnapshotColumnProvider, SortedCumulativeSum, Entry as SpecExtractorResult, StagingOutputs, StdCtx, StdCtxArgsOnly, StringMatcher, Trace, TransformedColumn, TreeNodeAccessor, TypeField, TypeFieldRecord, TypeForm, TypeToLiteral, TypedConfig, TypedConfigOrConfigLambda, TypedConfigOrString, UiServices, UiState, Unionize, UniversalColumnOption, UnwrapFutureRef, ValueRank, type VersionedData, WithLabel, allPColumnsReady, and, blockServiceNames, buildServices, collectCtxColumnSnapshotProviders, columnSelectorsToPredicate, compileAnnotationScript, compileFilter, compileFilters, convertFilterSpecsToExpressionSpecs, convertFilterUiToExpressionImpl, convertFilterUiToExpressions, convertOrParsePColumnData, createBlockStorage, createColumnSnapshot, createDefaultPTableParams, createNodeServiceProxy, createPFrameForGraphs, createPlDataTable, createPlDataTableSheet, createPlDataTableStateV2, createPlDataTableV2, createPlDataTableV3, createPlSelectionModel, createReadyColumnData, createRowSelectionColumn, deriveDataFromStorage, deriveDistinctLabels, deriveLabels, distillFilterSpec, downgradeCfgOrLambda, enrichCompatible, extractArchiveAndGetURL, extractConfig, filterDataInfoEntries, filterSpecToSpecQueryExpr, flatten, fromPlOption, fromPlRef, getAllRelatedColumns, getAvailableWithLinkersAxes, getAxisUniqueValues, getBlobContent, getBlobContentAsJson, getBlobContentAsString, getColumnOrAxisValueLabelsId, getColumnSpecById, getColumnUniqueValues, getColumnsFull, getDownloadedBlobContent, getEnvironmentValue, getFromCfg, getImmediate, getImportProgress, getJsonField, getLastLogs, getLogHandle, getOnDemandBlobContent, getPartitionKeysList, getPlatformaApiVersion, getPluginData, getProgressLog, getProgressLogWithInfo, getRawPlatformaInstance, getRelatedColumns, getRequestColumnsFromSelectedSources, getResourceField, getResourceValueAsJson, getSingleColumnData, getStorageData, getUniquePartitionKeys, getUniqueSourceValuesWithLabels, ifDef, isBlockStorage, isColumnHidden, isColumnOptional, isColumnSnapshotProvider, isConfigLambda, isEmpty, isHiddenFromGraphColumn, isHiddenFromUIColumn, isPColumnReady, isPluginOutputKey, isolate, makeArray, makeObject, mapArrayValues, mapRecordValues, mapResourceFields, matchColumn, matchColumnSelectors, migrateBlockStorage, normalizeBlockStorage, normalizeSelectors, not, or, parsePColumnData, parseResourceMap, pluginOutputKey, pluginOutputPrefix, readOutput, registerFacadeCallbacks, toColumnSnapshotProvider, unreachable, updateStorageData, upgradePlDataTableStateV2, wrapOutputs, writeLabelsToSpecs };

package/dist/index.js

@@ -20,6 +20,7 @@ import { isConfigLambda } from "./bconfig/types.js";
 import { downgradeCfgOrLambda, extractConfig } from "./bconfig/normalization.js";
 import "./bconfig/index.js";
 import { BlockModel } from "./block_model_legacy.js";
+import { BLOCK_SERVICE_FLAGS, blockServiceNames } from "./services/block_services.js";
 import { PluginDataModel, PluginDataModelBuilder, PluginInstance, PluginModel } from "./plugin_model.js";
 import { BlockModelV3 } from "./block_model.js";
 import { enrichCompatible, getAvailableWithLinkersAxes } from "./pframe_utils/axes.js";
@@ -52,10 +53,12 @@ import { getPlatformaApiVersion, getRawPlatformaInstance } from "./raw_globals.j
 import { convertFilterSpecsToExpressionSpecs } from "./annotations/converter.js";
 import "./annotations/index.js";
 import { getAxisUniqueValues, getColumnOrAxisValueLabelsId, getColumnSpecById, getColumnUniqueValues, getColumnsFull, getRequestColumnsFromSelectedSources, getSingleColumnData, getUniqueSourceValuesWithLabels } from "./pframe_utils/index.js";
+import { buildServices, createNodeServiceProxy } from "./services/service_bridge.js";
+import "./services/index.js";
 import { getEnvironmentValue } from "./env_value.js";
 
 export * from "@milaboratories/pl-model-common"
 
 export * from "@milaboratories/pl-error-like"
 
-export { Args, ArrayColumnProvider, BLOCK_STORAGE_FACADE_VERSION, BlockModel, BlockModelV3, BlockRenderCtx, BlockStorageFacadeCallbacks, BlockStorageFacadeHandles, ColumnCollectionBuilder, CurrentSdkInfo, DataModel, DataModelBuilder, FutureRef, It, internal_exports as JsRenderInternal, MainOutputs, OutputColumnProvider, OutputError, PColumnCollection, PFrameImpl, PlatformaSDKVersion, PluginDataModel, PluginDataModelBuilder, PluginInstance, PluginModel, PluginRenderCtx, RT_BINARY_PARTITIONED, RT_BINARY_SUPER_PARTITIONED, RT_JSON_PARTITIONED, RT_JSON_SUPER_PARTITIONED, RT_PARQUET_PARTITIONED, RT_PARQUET_SUPER_PARTITIONED, RT_RESOURCE_MAP, RT_RESOURCE_MAP_PARTITIONED, RenderCtxBase, RenderCtxLegacy, ResultPool, ResultPoolColumnSnapshotProvider, SnapshotColumnProvider, StagingOutputs, TreeNodeAccessor, UiState, allPColumnsReady, and, collectCtxColumnSnapshotProviders, columnSelectorsToPredicate, compileAnnotationScript, compileFilter, compileFilters, convertFilterSpecsToExpressionSpecs, convertFilterUiToExpressionImpl, convertFilterUiToExpressions, convertOrParsePColumnData, createBlockStorage, createColumnSnapshot, createDefaultPTableParams, createPFrameForGraphs, createPlDataTable, createPlDataTableSheet, createPlDataTableStateV2, createPlDataTableV2, createPlDataTableV3, createPlSelectionModel, createReadyColumnData, createRowSelectionColumn, deriveDataFromStorage, deriveDistinctLabels, deriveLabels, distillFilterSpec, downgradeCfgOrLambda, enrichCompatible, extractArchiveAndGetURL, extractConfig, filterDataInfoEntries, filterSpecToSpecQueryExpr, flatten, fromPlOption, fromPlRef, getAllRelatedColumns, getAvailableWithLinkersAxes, getAxisUniqueValues, getBlobContent, getBlobContentAsJson, getBlobContentAsString, getColumnOrAxisValueLabelsId, getColumnSpecById, getColumnUniqueValues, getColumnsFull, getDownloadedBlobContent, getEnvironmentValue, getFromCfg, getImmediate, getImportProgress, getJsonField, getLastLogs, getLogHandle, getOnDemandBlobContent, getPartitionKeysList, getPlatformaApiVersion, getPluginData, getProgressLog, getProgressLogWithInfo, getRawPlatformaInstance, getRelatedColumns, getRequestColumnsFromSelectedSources, getResourceField, getResourceValueAsJson, getSingleColumnData, getStorageData, getUniquePartitionKeys, getUniqueSourceValuesWithLabels, ifDef, isBlockStorage, isColumnHidden, isColumnOptional, isColumnSnapshotProvider, isConfigLambda, isEmpty, isHiddenFromGraphColumn, isHiddenFromUIColumn, isPColumnReady, isPluginOutputKey, isolate, makeArray, makeObject, mapArrayValues, mapRecordValues, mapResourceFields, matchColumn, matchColumnSelectors, migrateBlockStorage, normalizeBlockStorage, normalizeSelectors, not, or, parsePColumnData, parseResourceMap, pluginOutputKey, pluginOutputPrefix, readOutput, registerFacadeCallbacks, toColumnSnapshotProvider, unreachable, updateStorageData, upgradePlDataTableStateV2, wrapOutputs, writeLabelsToSpecs };
+export { Args, ArrayColumnProvider, BLOCK_SERVICE_FLAGS, BLOCK_STORAGE_FACADE_VERSION, BlockModel, BlockModelV3, BlockRenderCtx, BlockStorageFacadeCallbacks, BlockStorageFacadeHandles, ColumnCollectionBuilder, CurrentSdkInfo, DataModel, DataModelBuilder, FutureRef, It, internal_exports as JsRenderInternal, MainOutputs, OutputColumnProvider, OutputError, PColumnCollection, PFrameImpl, PlatformaSDKVersion, PluginDataModel, PluginDataModelBuilder, PluginInstance, PluginModel, PluginRenderCtx, RT_BINARY_PARTITIONED, RT_BINARY_SUPER_PARTITIONED, RT_JSON_PARTITIONED, RT_JSON_SUPER_PARTITIONED, RT_PARQUET_PARTITIONED, RT_PARQUET_SUPER_PARTITIONED, RT_RESOURCE_MAP, RT_RESOURCE_MAP_PARTITIONED, RenderCtxBase, RenderCtxLegacy, ResultPool, ResultPoolColumnSnapshotProvider, SnapshotColumnProvider, StagingOutputs, TreeNodeAccessor, UiState, allPColumnsReady, and, blockServiceNames, buildServices, collectCtxColumnSnapshotProviders, columnSelectorsToPredicate, compileAnnotationScript, compileFilter, compileFilters, convertFilterSpecsToExpressionSpecs, convertFilterUiToExpressionImpl, convertFilterUiToExpressions, convertOrParsePColumnData, createBlockStorage, createColumnSnapshot, createDefaultPTableParams, createNodeServiceProxy, createPFrameForGraphs, createPlDataTable, createPlDataTableSheet, createPlDataTableStateV2, createPlDataTableV2, createPlDataTableV3, createPlSelectionModel, createReadyColumnData, createRowSelectionColumn, deriveDataFromStorage, deriveDistinctLabels, deriveLabels, distillFilterSpec, downgradeCfgOrLambda, enrichCompatible, extractArchiveAndGetURL, extractConfig, filterDataInfoEntries, filterSpecToSpecQueryExpr, flatten, fromPlOption, fromPlRef, getAllRelatedColumns, getAvailableWithLinkersAxes, getAxisUniqueValues, getBlobContent, getBlobContentAsJson, getBlobContentAsString, getColumnOrAxisValueLabelsId, getColumnSpecById, getColumnUniqueValues, getColumnsFull, getDownloadedBlobContent, getEnvironmentValue, getFromCfg, getImmediate, getImportProgress, getJsonField, getLastLogs, getLogHandle, getOnDemandBlobContent, getPartitionKeysList, getPlatformaApiVersion, getPluginData, getProgressLog, getProgressLogWithInfo, getRawPlatformaInstance, getRelatedColumns, getRequestColumnsFromSelectedSources, getResourceField, getResourceValueAsJson, getSingleColumnData, getStorageData, getUniquePartitionKeys, getUniqueSourceValuesWithLabels, ifDef, isBlockStorage, isColumnHidden, isColumnOptional, isColumnSnapshotProvider, isConfigLambda, isEmpty, isHiddenFromGraphColumn, isHiddenFromUIColumn, isPColumnReady, isPluginOutputKey, isolate, makeArray, makeObject, mapArrayValues, mapRecordValues, mapResourceFields, matchColumn, matchColumnSelectors, migrateBlockStorage, normalizeBlockStorage, normalizeSelectors, not, or, parsePColumnData, parseResourceMap, pluginOutputKey, pluginOutputPrefix, readOutput, registerFacadeCallbacks, toColumnSnapshotProvider, unreachable, updateStorageData, upgradePlDataTableStateV2, wrapOutputs, writeLabelsToSpecs };

package/dist/package.cjs

@@ -1,6 +1,6 @@
 
 //#region package.json
-var version = "1.61.1";
+var version = "1.62.0";
 
 //#endregion
 Object.defineProperty(exports, 'version', {

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "1.61.1";
+var version = "1.62.0";
 
 //#endregion
 export { version };

package/dist/platforma.d.ts

@@ -5,7 +5,7 @@ import { BlockApiV2 } from "./block_api_v2.js";
 import { BlockApiV3 } from "./block_api_v3.js";
 import { SdkInfo } from "./version.js";
 import { PluginRecord } from "./block_model.js";
-import { BlockCodeKnownFeatureFlags, BlockOutputsBase, BlockStateV3, DriverKit, OutputWithStatus } from "@milaboratories/pl-model-common";
+import { BlockCodeKnownFeatureFlags, BlockOutputsBase, BlockStateV3, DriverKit, OutputWithStatus, ServiceDispatch, UiServices as UiServices$1 } from "@milaboratories/pl-model-common";
 
 //#region src/platforma.d.ts
 /** Defines all methods to interact with the platform environment from within a block UI. @deprecated */
@@ -20,12 +20,16 @@ interface PlatformaV2<Args = unknown, Outputs extends Record<string, OutputWithS
   readonly sdkInfo: SdkInfo;
   readonly apiVersion: 2;
 }
-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 {
+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>, UiServices extends Partial<UiServices$1> = Partial<UiServices$1>> extends BlockApiV3<Data, Args, Outputs, Href>, DriverKit {
   /** Information about SDK version current platforma environment was compiled with. */
   readonly sdkInfo: SdkInfo;
   readonly apiVersion: 3;
+  /** Service dispatch — lists available services, their methods, and invokes them. */
+  readonly serviceDispatch: ServiceDispatch;
   /** @internal Type brand for plugin type inference. Not used at runtime. */
   readonly __pluginsBrand?: Plugins;
+  /** @internal Type brand for UI service type inference. Not used at runtime. */
+  readonly __uiServicesBrand?: UiServices;
 }
 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>;
 type PlatformaExtended<Pl extends Platforma = Platforma> = Pl & {
@@ -58,8 +62,8 @@ type InferPluginData<Pl, PluginId extends string> = Pl extends PlatformaV3<unkno
  * Uses the same brand structure as InferPluginHandle — only data/params/outputs, no config —
  * because PluginRecord doesn't carry Config (lost after factory.create()).
  */
-type InferPluginHandles<T extends Record<string, unknown>> = { readonly [K in keyof T]: T[K] extends PluginRecord<infer Data, infer Params, infer Outputs> ? {
-  handle: PluginHandle<PluginFactoryLike<Data, Params, Outputs>>;
+type InferPluginHandles<T extends Record<string, unknown>> = { readonly [K in keyof T]: T[K] extends PluginRecord<infer Data, infer Params, infer Outputs, infer ModelServices, infer UiServices> ? {
+  handle: PluginHandle<PluginFactoryLike<Data, Params, Outputs, ModelServices, UiServices>>;
 } : never };
 //#endregion
 export { BlockModelInfo, InferArgsType, InferBlockState, InferBlockStatePatch, InferDataType, InferHrefType, InferOutputsType, InferPluginData, InferPluginHandles, InferPluginNames, InferUiState, Platforma, PlatformaApiVersion, PlatformaExtended, PlatformaFactory, PlatformaV1, PlatformaV2, PlatformaV3 };

package/dist/plugin_handle.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin_handle.cjs","names":[],"sources":["../src/plugin_handle.ts"],"sourcesContent":["/**\n * PluginHandle — Opaque branded handle and output key utilities for plugin instances.\n *\n * Extracted into its own module to break circular dependencies:\n * both block_storage.ts and plugin_model.ts can import from here\n * without depending on each other.\n *\n * @module plugin_handle\n */\n\nimport type { Branded } from \"@milaboratories/helpers\";\n\n/**\n * Phantom-only base type for constraining PluginHandle's type parameter.\n *\n * PluginFactory has create() → PluginInstance with function properties, making it invariant\n * under strictFunctionTypes. PluginFactoryLike exposes only the covariant `__types` phantom,\n * avoiding the contravariance chain. Handles only need `__types` for type extraction.\n *\n * PluginFactory extends PluginFactoryLike, so every concrete factory satisfies this constraint.\n */\nexport interface PluginFactoryLike<\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>,\n  Outputs extends Record<string, unknown> = Record<string, unknown>,\n> {\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n  };\n}\n\n/** Extract the Data type from a PluginFactoryLike phantom. */\nexport type InferFactoryData<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer D, any, any> ? D : Record<string, unknown>\n>;\n\n/** Extract the Params type from a PluginFactoryLike phantom. */\nexport type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, infer P, any> ? P : undefined\n>;\n\n/** Extract the Outputs type from a PluginFactoryLike phantom. */\nexport type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, any, infer O> ? O : Record<string, unknown>\n>;\n\n/**\n * Derive a typed PluginHandle from a PluginFactory type.\n * Normalizes the brand to only data/params/outputs (strips config) so handles\n * from InferPluginHandles match handles from InferPluginHandle.\n */\nexport type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer Data, infer Params, infer Outputs>\n    ? PluginHandle<PluginFactoryLike<Data, Params, Outputs>>\n    : PluginHandle\n>;\n\n/**\n * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.\n * Branded with factory phantom `F` for type-safe data/outputs extraction.\n * Constrained with PluginFactoryLike (not PluginFactory) to avoid variance issues.\n */\nexport type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;\n\nconst PLUGIN_OUTPUT_PREFIX = \"plugin-output#\";\n\n/** Construct the output key for a plugin output in the block outputs map. */\nexport function pluginOutputKey<F extends PluginFactoryLike>(\n  handle: PluginHandle<F>,\n  outputKey: string,\n): string {\n  return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;\n}\n\n/** Check whether an output key belongs to a plugin (vs block-level output). */\nexport function isPluginOutputKey(key: string): boolean {\n  return key.startsWith(PLUGIN_OUTPUT_PREFIX);\n}\n\n/** Get the prefix used for all outputs of a specific plugin instance. */\nexport function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string {\n  return pluginOutputKey(handle, \"\");\n}\n"],"mappings":";;AAkEA,MAAM,uBAAuB;;AAG7B,SAAgB,gBACd,QACA,WACQ;AACR,QAAO,GAAG,uBAAuB,OAAO,GAAG;;;AAI7C,SAAgB,kBAAkB,KAAsB;AACtD,QAAO,IAAI,WAAW,qBAAqB;;;AAI7C,SAAgB,mBAAgD,QAAiC;AAC/F,QAAO,gBAAgB,QAAQ,GAAG"}
+{"version":3,"file":"plugin_handle.cjs","names":[],"sources":["../src/plugin_handle.ts"],"sourcesContent":["/**\n * PluginHandle — Opaque branded handle and output key utilities for plugin instances.\n *\n * Extracted into its own module to break circular dependencies:\n * both block_storage.ts and plugin_model.ts can import from here\n * without depending on each other.\n *\n * @module plugin_handle\n */\n\nimport type { Branded } from \"@milaboratories/helpers\";\n\n/**\n * Phantom-only base type for constraining PluginHandle's type parameter.\n *\n * PluginFactory has create() → PluginInstance with function properties, making it invariant\n * under strictFunctionTypes. PluginFactoryLike exposes only the covariant `__types` phantom,\n * avoiding the contravariance chain. Handles only need `__types` for type extraction.\n *\n * PluginFactory extends PluginFactoryLike, so every concrete factory satisfies this constraint.\n */\nexport interface PluginFactoryLike<\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>,\n  Outputs extends Record<string, unknown> = Record<string, unknown>,\n  ModelServices = unknown,\n  UiServices = unknown,\n> {\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n    modelServices: ModelServices;\n    uiServices: UiServices;\n  };\n}\n\n/** Extract the Data type from a PluginFactoryLike phantom. */\nexport type InferFactoryData<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer D, any, any, any, any> ? D : Record<string, unknown>\n>;\n\n/** Extract the Params type from a PluginFactoryLike phantom. */\nexport type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, infer P, any, any, any> ? P : undefined\n>;\n\n/** Extract the Outputs type from a PluginFactoryLike phantom. */\nexport type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, any, infer O, any, any> ? O : Record<string, unknown>\n>;\n\n/** Extract the pre-resolved model services type from a PluginFactoryLike phantom. */\nexport type InferFactoryModelServices<F extends PluginFactoryLike> =\n  F extends PluginFactoryLike<any, any, any, infer ModelServices, any> ? ModelServices : {};\n\n/** Extract the pre-resolved UI services type from a PluginFactoryLike phantom. */\nexport type InferFactoryUiServices<F extends PluginFactoryLike> =\n  F extends PluginFactoryLike<any, any, any, any, infer UiServices> ? UiServices : {};\n\n/**\n * Derive a typed PluginHandle from a PluginFactory type.\n * Normalizes the brand to data/params/outputs/services (strips config) so handles\n * from InferPluginHandles match handles from InferPluginHandle.\n */\nexport type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<\n    infer Data,\n    infer Params,\n    infer Outputs,\n    infer ModelServices,\n    infer UiServices\n  >\n    ? PluginHandle<PluginFactoryLike<Data, Params, Outputs, ModelServices, UiServices>>\n    : PluginHandle\n>;\n\n/**\n * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.\n * Branded with factory phantom `F` for type-safe data/outputs extraction.\n * Constrained with PluginFactoryLike (not PluginFactory) to avoid variance issues.\n */\nexport type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;\n\nconst PLUGIN_OUTPUT_PREFIX = \"plugin-output#\";\n\n/** Construct the output key for a plugin output in the block outputs map. */\nexport function pluginOutputKey<F extends PluginFactoryLike>(\n  handle: PluginHandle<F>,\n  outputKey: string,\n): string {\n  return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;\n}\n\n/** Check whether an output key belongs to a plugin (vs block-level output). */\nexport function isPluginOutputKey(key: string): boolean {\n  return key.startsWith(PLUGIN_OUTPUT_PREFIX);\n}\n\n/** Get the prefix used for all outputs of a specific plugin instance. */\nexport function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string {\n  return pluginOutputKey(handle, \"\");\n}\n"],"mappings":";;AAoFA,MAAM,uBAAuB;;AAG7B,SAAgB,gBACd,QACA,WACQ;AACR,QAAO,GAAG,uBAAuB,OAAO,GAAG;;;AAI7C,SAAgB,kBAAkB,KAAsB;AACtD,QAAO,IAAI,WAAW,qBAAqB;;;AAI7C,SAAgB,mBAAgD,QAAiC;AAC/F,QAAO,gBAAgB,QAAQ,GAAG"}

package/dist/plugin_handle.d.ts

@@ -10,25 +10,31 @@ import { Branded } from "@milaboratories/helpers";
  *
  * PluginFactory extends PluginFactoryLike, so every concrete factory satisfies this constraint.
  */
-interface PluginFactoryLike<Data extends Record<string, unknown> = Record<string, unknown>, Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>, Outputs extends Record<string, unknown> = Record<string, unknown>> {
+interface PluginFactoryLike<Data extends Record<string, unknown> = Record<string, unknown>, Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>, Outputs extends Record<string, unknown> = Record<string, unknown>, ModelServices = unknown, UiServices = unknown> {
   readonly __types?: {
     data: Data;
     params: Params;
     outputs: Outputs;
+    modelServices: ModelServices;
+    uiServices: UiServices;
   };
 }
 /** Extract the Data type from a PluginFactoryLike phantom. */
-type InferFactoryData<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<infer D, any, any> ? D : Record<string, unknown>>;
+type InferFactoryData<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<infer D, any, any, any, any> ? D : Record<string, unknown>>;
 /** Extract the Params type from a PluginFactoryLike phantom. */
-type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<any, infer P, any> ? P : undefined>;
+type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<any, infer P, any, any, any> ? P : undefined>;
 /** Extract the Outputs type from a PluginFactoryLike phantom. */
-type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<any, any, infer O> ? O : Record<string, unknown>>;
+type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<any, any, infer O, any, any> ? O : Record<string, unknown>>;
+/** Extract the pre-resolved model services type from a PluginFactoryLike phantom. */
+type InferFactoryModelServices<F extends PluginFactoryLike> = F extends PluginFactoryLike<any, any, any, infer ModelServices, any> ? ModelServices : {};
+/** Extract the pre-resolved UI services type from a PluginFactoryLike phantom. */
+type InferFactoryUiServices<F extends PluginFactoryLike> = F extends PluginFactoryLike<any, any, any, any, infer UiServices> ? UiServices : {};
 /**
  * Derive a typed PluginHandle from a PluginFactory type.
- * Normalizes the brand to only data/params/outputs (strips config) so handles
+ * Normalizes the brand to data/params/outputs/services (strips config) so handles
  * from InferPluginHandles match handles from InferPluginHandle.
  */
-type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<infer Data, infer Params, infer Outputs> ? PluginHandle<PluginFactoryLike<Data, Params, Outputs>> : PluginHandle>;
+type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<infer Data, infer Params, infer Outputs, infer ModelServices, infer UiServices> ? PluginHandle<PluginFactoryLike<Data, Params, Outputs, ModelServices, UiServices>> : PluginHandle>;
 /**
  * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.
  * Branded with factory phantom `F` for type-safe data/outputs extraction.
@@ -42,5 +48,5 @@ declare function isPluginOutputKey(key: string): boolean;
 /** Get the prefix used for all outputs of a specific plugin instance. */
 declare function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string;
 //#endregion
-export { InferFactoryData, InferFactoryOutputs, InferFactoryParams, InferPluginHandle, PluginFactoryLike, PluginHandle, isPluginOutputKey, pluginOutputKey, pluginOutputPrefix };
+export { InferFactoryData, InferFactoryModelServices, InferFactoryOutputs, InferFactoryParams, InferFactoryUiServices, InferPluginHandle, PluginFactoryLike, PluginHandle, isPluginOutputKey, pluginOutputKey, pluginOutputPrefix };
 //# sourceMappingURL=plugin_handle.d.ts.map

package/dist/plugin_handle.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin_handle.js","names":[],"sources":["../src/plugin_handle.ts"],"sourcesContent":["/**\n * PluginHandle — Opaque branded handle and output key utilities for plugin instances.\n *\n * Extracted into its own module to break circular dependencies:\n * both block_storage.ts and plugin_model.ts can import from here\n * without depending on each other.\n *\n * @module plugin_handle\n */\n\nimport type { Branded } from \"@milaboratories/helpers\";\n\n/**\n * Phantom-only base type for constraining PluginHandle's type parameter.\n *\n * PluginFactory has create() → PluginInstance with function properties, making it invariant\n * under strictFunctionTypes. PluginFactoryLike exposes only the covariant `__types` phantom,\n * avoiding the contravariance chain. Handles only need `__types` for type extraction.\n *\n * PluginFactory extends PluginFactoryLike, so every concrete factory satisfies this constraint.\n */\nexport interface PluginFactoryLike<\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>,\n  Outputs extends Record<string, unknown> = Record<string, unknown>,\n> {\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n  };\n}\n\n/** Extract the Data type from a PluginFactoryLike phantom. */\nexport type InferFactoryData<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer D, any, any> ? D : Record<string, unknown>\n>;\n\n/** Extract the Params type from a PluginFactoryLike phantom. */\nexport type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, infer P, any> ? P : undefined\n>;\n\n/** Extract the Outputs type from a PluginFactoryLike phantom. */\nexport type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, any, infer O> ? O : Record<string, unknown>\n>;\n\n/**\n * Derive a typed PluginHandle from a PluginFactory type.\n * Normalizes the brand to only data/params/outputs (strips config) so handles\n * from InferPluginHandles match handles from InferPluginHandle.\n */\nexport type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer Data, infer Params, infer Outputs>\n    ? PluginHandle<PluginFactoryLike<Data, Params, Outputs>>\n    : PluginHandle\n>;\n\n/**\n * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.\n * Branded with factory phantom `F` for type-safe data/outputs extraction.\n * Constrained with PluginFactoryLike (not PluginFactory) to avoid variance issues.\n */\nexport type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;\n\nconst PLUGIN_OUTPUT_PREFIX = \"plugin-output#\";\n\n/** Construct the output key for a plugin output in the block outputs map. */\nexport function pluginOutputKey<F extends PluginFactoryLike>(\n  handle: PluginHandle<F>,\n  outputKey: string,\n): string {\n  return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;\n}\n\n/** Check whether an output key belongs to a plugin (vs block-level output). */\nexport function isPluginOutputKey(key: string): boolean {\n  return key.startsWith(PLUGIN_OUTPUT_PREFIX);\n}\n\n/** Get the prefix used for all outputs of a specific plugin instance. */\nexport function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string {\n  return pluginOutputKey(handle, \"\");\n}\n"],"mappings":";AAkEA,MAAM,uBAAuB;;AAG7B,SAAgB,gBACd,QACA,WACQ;AACR,QAAO,GAAG,uBAAuB,OAAO,GAAG;;;AAI7C,SAAgB,kBAAkB,KAAsB;AACtD,QAAO,IAAI,WAAW,qBAAqB;;;AAI7C,SAAgB,mBAAgD,QAAiC;AAC/F,QAAO,gBAAgB,QAAQ,GAAG"}
+{"version":3,"file":"plugin_handle.js","names":[],"sources":["../src/plugin_handle.ts"],"sourcesContent":["/**\n * PluginHandle — Opaque branded handle and output key utilities for plugin instances.\n *\n * Extracted into its own module to break circular dependencies:\n * both block_storage.ts and plugin_model.ts can import from here\n * without depending on each other.\n *\n * @module plugin_handle\n */\n\nimport type { Branded } from \"@milaboratories/helpers\";\n\n/**\n * Phantom-only base type for constraining PluginHandle's type parameter.\n *\n * PluginFactory has create() → PluginInstance with function properties, making it invariant\n * under strictFunctionTypes. PluginFactoryLike exposes only the covariant `__types` phantom,\n * avoiding the contravariance chain. Handles only need `__types` for type extraction.\n *\n * PluginFactory extends PluginFactoryLike, so every concrete factory satisfies this constraint.\n */\nexport interface PluginFactoryLike<\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>,\n  Outputs extends Record<string, unknown> = Record<string, unknown>,\n  ModelServices = unknown,\n  UiServices = unknown,\n> {\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n    modelServices: ModelServices;\n    uiServices: UiServices;\n  };\n}\n\n/** Extract the Data type from a PluginFactoryLike phantom. */\nexport type InferFactoryData<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer D, any, any, any, any> ? D : Record<string, unknown>\n>;\n\n/** Extract the Params type from a PluginFactoryLike phantom. */\nexport type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, infer P, any, any, any> ? P : undefined\n>;\n\n/** Extract the Outputs type from a PluginFactoryLike phantom. */\nexport type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, any, infer O, any, any> ? O : Record<string, unknown>\n>;\n\n/** Extract the pre-resolved model services type from a PluginFactoryLike phantom. */\nexport type InferFactoryModelServices<F extends PluginFactoryLike> =\n  F extends PluginFactoryLike<any, any, any, infer ModelServices, any> ? ModelServices : {};\n\n/** Extract the pre-resolved UI services type from a PluginFactoryLike phantom. */\nexport type InferFactoryUiServices<F extends PluginFactoryLike> =\n  F extends PluginFactoryLike<any, any, any, any, infer UiServices> ? UiServices : {};\n\n/**\n * Derive a typed PluginHandle from a PluginFactory type.\n * Normalizes the brand to data/params/outputs/services (strips config) so handles\n * from InferPluginHandles match handles from InferPluginHandle.\n */\nexport type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<\n    infer Data,\n    infer Params,\n    infer Outputs,\n    infer ModelServices,\n    infer UiServices\n  >\n    ? PluginHandle<PluginFactoryLike<Data, Params, Outputs, ModelServices, UiServices>>\n    : PluginHandle\n>;\n\n/**\n * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.\n * Branded with factory phantom `F` for type-safe data/outputs extraction.\n * Constrained with PluginFactoryLike (not PluginFactory) to avoid variance issues.\n */\nexport type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;\n\nconst PLUGIN_OUTPUT_PREFIX = \"plugin-output#\";\n\n/** Construct the output key for a plugin output in the block outputs map. */\nexport function pluginOutputKey<F extends PluginFactoryLike>(\n  handle: PluginHandle<F>,\n  outputKey: string,\n): string {\n  return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;\n}\n\n/** Check whether an output key belongs to a plugin (vs block-level output). */\nexport function isPluginOutputKey(key: string): boolean {\n  return key.startsWith(PLUGIN_OUTPUT_PREFIX);\n}\n\n/** Get the prefix used for all outputs of a specific plugin instance. */\nexport function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string {\n  return pluginOutputKey(handle, \"\");\n}\n"],"mappings":";AAoFA,MAAM,uBAAuB;;AAG7B,SAAgB,gBACd,QACA,WACQ;AACR,QAAO,GAAG,uBAAuB,OAAO,GAAG;;;AAI7C,SAAgB,kBAAkB,KAAsB;AACtD,QAAO,IAAI,WAAW,qBAAqB;;;AAI7C,SAAgB,mBAAgD,QAAiC;AAC/F,QAAO,gBAAgB,QAAQ,GAAG"}

package/dist/plugin_model.cjs

@@ -180,23 +180,22 @@ function buildPluginDataModel(state, configInitFn) {
 var PluginInstance = class PluginInstance {
 	id;
 	transferVersion;
-	/** @internal Phantom for type inference of Data/Params/Outputs; never set at runtime. */
+	/** @internal Phantom for type inference; never set at runtime. */
 	__instanceTypes;
-	factory;
-	config;
-	constructor(id, factory, transferVersion, config) {
+	/** Bound closure that creates the PluginModel. Config is captured at factory.create() time. */
+	createPluginModel;
+	constructor(id, createPluginModel, transferVersion) {
 		this.id = id;
-		this.factory = factory;
+		this.createPluginModel = createPluginModel;
 		this.transferVersion = transferVersion;
-		this.config = config;
 	}
-	/** @internal */
+	/** @internal Accepts concrete Config — binds it into a closure, avoiding Config variance issues. */
 	static [FROM_BUILDER](id, factory, transferVersion, config) {
-		return new PluginInstance(id, factory, transferVersion, config);
+		return new PluginInstance(id, () => factory[CREATE_PLUGIN_MODEL](config), transferVersion);
 	}
 	/** @internal Create a PluginModel from this instance. Used by BlockModelV3.plugin(). */
 	[CREATE_PLUGIN_MODEL]() {
-		return this.factory[CREATE_PLUGIN_MODEL](this.config);
+		return this.createPluginModel();
 	}
 };
 /**
@@ -235,14 +234,14 @@ var PluginModel = class PluginModel {
 	static define(options) {
 		if (options.data instanceof PluginDataModel) {
 			const pdm = options.data;
-			return PluginModelBuilder[FROM_BUILDER]({
+			return PluginModelInitialBuilder.create({
 				name: options.name,
 				dataFn: () => pdm.dataModel,
 				getDefaultDataFn: (config) => pdm.getDefaultData(config),
 				featureFlags: options.featureFlags
 			});
 		}
-		return PluginModelBuilder[FROM_BUILDER]({
+		return PluginModelInitialBuilder.create({
 			name: options.name,
 			dataFn: options.data,
 			featureFlags: options.featureFlags
@@ -408,6 +407,33 @@ var PluginModelBuilder = class PluginModelBuilder {
 		});
 	}
 };
+/**
+* Initial builder returned by PluginModel.define(). Extends PluginModelBuilder with .params().
+* Once .params() or .output() is called, transitions to PluginModelBuilder (no second .params()).
+*/
+var PluginModelInitialBuilder = class PluginModelInitialBuilder extends PluginModelBuilder {
+	/** @internal */
+	static create(options) {
+		return new PluginModelInitialBuilder(options);
+	}
+	/**
+	* Sets the Params type for this plugin — the shape of data derived from the block's
+	* render context and passed into plugin output functions via `ctx.params`.
+	* Must be called before .output(). Available only on the initial builder.
+	*
+	* @example
+	* .params<{ title: string }>()
+	* .output('displayText', (ctx) => ctx.params.title)
+	*/
+	params() {
+		return PluginModelBuilder[FROM_BUILDER]({
+			name: this.name,
+			dataFn: this.dataFn,
+			getDefaultDataFn: this.getDefaultDataFn,
+			featureFlags: this.featureFlags
+		});
+	}
+};
 
 //#endregion
 exports.CREATE_PLUGIN_MODEL = CREATE_PLUGIN_MODEL;

package/dist/plugin_model.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin_model.cjs","names":["DATA_MODEL_LEGACY_VERSION","DataModelBuilder"],"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, OutputWithStatus } from \"@milaboratories/pl-model-common\";\nimport {\n  type DataModel,\n  DataModelBuilder,\n  type DataRecoverFn,\n  type DataVersioned,\n  type TransferTarget,\n} from \"./block_migrations\";\nimport { type PluginName, DATA_MODEL_LEGACY_VERSION } 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\n/** Symbol for internal plugin model creation — not accessible to external consumers */\nexport const CREATE_PLUGIN_MODEL = Symbol(\"createPluginModel\");\n\n/** Sentinel for PluginInstance without transferAt — no transfer possible. */\nconst NO_TRANSFER_VERSION = \"\";\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 * Plugin data model with typed migration chain and config-aware initialization.\n *\n * @typeParam Data - Current (latest) plugin data type\n * @typeParam Versions - Map of version keys to their data types (accumulated by the chain)\n * @typeParam Config - Config type passed to init function (undefined if none)\n */\nexport class PluginDataModel<\n  Data extends PluginData,\n  Versions extends Record<string, unknown> = {},\n  Config = undefined,\n> {\n  readonly dataModel: DataModel<Data>;\n  private readonly configInitFn: (config?: Config) => Data;\n\n  /** @internal Phantom field to anchor the Versions type parameter. */\n  declare readonly __versions?: Versions;\n\n  private constructor(dataModel: DataModel<Data>, configInitFn: (config?: Config) => Data) {\n    this.dataModel = dataModel;\n    this.configInitFn = configInitFn;\n  }\n\n  /** @internal */\n  static [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>, Config>(\n    dataModel: DataModel<Data>,\n    configInitFn: (config?: Config) => Data,\n  ): PluginDataModel<Data, Versions, Config> {\n    return new PluginDataModel<Data, Versions, Config>(dataModel, configInitFn);\n  }\n\n  /** Create fresh data with optional config. */\n  getDefaultData(config?: Config): DataVersioned<Data> {\n    const data = this.configInitFn(config);\n    return { version: this.dataModel.version, data };\n  }\n}\n\n/** Internal state for plugin data model chain. */\ntype PluginChainState = {\n  initialVersion: string;\n  migrations: Array<{ toVersion: string; fn: (data: unknown) => unknown }>;\n  recoverFn?: (version: string, data: unknown) => unknown;\n  recoverAtIndex?: number;\n};\n\n/** Version → persisted data shape for each migration step (third generic of `PluginModel.define` when `data` is a `PluginDataModel`). */\nexport type PluginDataModelVersions<\n  M extends PluginDataModel<PluginData, Record<string, unknown>, unknown>,\n> = M extends PluginDataModel<PluginData, infer Versions, unknown> ? Versions : never;\n\n/**\n * Builder for creating PluginDataModel with type-safe migrations.\n * Mirrors DataModelBuilder — same .from(), .migrate(), .recover(), .init() chain.\n *\n * @example\n * const pluginData = new PluginDataModelBuilder()\n *   .from<TableData>(\"v1\")\n *   .migrate<FilteredTableData>(\"v2\", (v1) => ({ ...v1, filters: [] }))\n *   .init<TableConfig>((config?) => ({\n *     state: createDefaultState(config?.ops),\n *     filters: [],\n *   }));\n */\nexport class PluginDataModelBuilder {\n  from<Data extends PluginData, const V extends string>(\n    version: V,\n  ): PluginDataModelInitialChain<Data, Record<V, Data>> {\n    return PluginDataModelInitialChain[FROM_BUILDER]<Data, Record<V, Data>>({\n      initialVersion: version,\n      migrations: [],\n    });\n  }\n}\n\n/**\n * Chain returned by .migrate(). Supports .migrate(), .recover(), .init().\n * No .upgradeLegacy() — that is only available on the initial chain.\n */\nexport class PluginDataModelChain<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n> {\n  protected constructor(protected readonly state: PluginChainState) {}\n\n  /** @internal */\n  static [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>>(\n    state: PluginChainState,\n  ): PluginDataModelChain<Data, Versions> {\n    return new PluginDataModelChain(state);\n  }\n\n  /**\n   * Add a migration step transforming data from the current version to the next.\n   */\n  migrate<Next extends PluginData, const NextV extends string>(\n    version: NextV,\n    fn: (current: Data) => Next,\n  ): PluginDataModelChain<Next, Versions & Record<NextV, Next>> {\n    return PluginDataModelChain[FROM_BUILDER]<Next, Versions & Record<NextV, Next>>({\n      ...this.state,\n      migrations: [\n        ...this.state.migrations,\n        { toVersion: version, fn: fn as (data: unknown) => unknown },\n      ],\n    });\n  }\n\n  /**\n   * Set a recovery handler for unknown or legacy versions.\n   * Can only be called once — the returned chain has no recover() method.\n   */\n  recover(fn: DataRecoverFn<Data>): PluginDataModelWithRecover<Data, Versions> {\n    return PluginDataModelWithRecover[FROM_BUILDER]<Data, Versions>({\n      ...this.state,\n      recoverFn: fn as (version: string, data: unknown) => unknown,\n      recoverAtIndex: this.state.migrations.length,\n    });\n  }\n\n  /** Finalize the PluginDataModel. */\n  init<Config = undefined>(fn: (config?: Config) => Data): PluginDataModel<Data, Versions, Config> {\n    return buildPluginDataModel(this.state, fn);\n  }\n}\n\n/**\n * Initial chain returned by new PluginDataModelBuilder().from().\n * Extends PluginDataModelChain with .upgradeLegacy() — available only before\n * any .migrate() calls, matching the block's DataModelInitialChain pattern.\n */\nexport class PluginDataModelInitialChain<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n> extends PluginDataModelChain<Data, Versions> {\n  /** @internal */\n  static override [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>>(\n    state: PluginChainState,\n  ): PluginDataModelInitialChain<Data, Versions> {\n    return new PluginDataModelInitialChain(state);\n  }\n\n  /**\n   * Handle data from a previous plugin type occupying this slot.\n   * Prepends a migration from DATA_MODEL_LEGACY_VERSION to the initial version.\n   * When a plugin type changes, the old data arrives with DATA_MODEL_LEGACY_VERSION —\n   * this function transforms it into the initial version, then the normal chain runs.\n   *\n   * Must be called right after .from() — not available after .migrate().\n   * Mutually exclusive with recover().\n   *\n   * @param fn - Transform from old plugin's raw data to this plugin's initial data type\n   */\n  upgradeLegacy(fn: (data: unknown) => Data): PluginDataModelWithRecover<Data, Versions> {\n    return PluginDataModelWithRecover[FROM_BUILDER]<Data, Versions>({\n      ...this.state,\n      migrations: [\n        { toVersion: this.state.initialVersion, fn: fn as (data: unknown) => unknown },\n        ...this.state.migrations,\n      ],\n      initialVersion: DATA_MODEL_LEGACY_VERSION,\n    });\n  }\n}\n\n/**\n * Chain after .recover() — supports .migrate(), .init(). No second recover().\n */\nexport class PluginDataModelWithRecover<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n> {\n  private constructor(private readonly state: PluginChainState) {}\n\n  /** @internal */\n  static [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>>(\n    state: PluginChainState,\n  ): PluginDataModelWithRecover<Data, Versions> {\n    return new PluginDataModelWithRecover(state);\n  }\n\n  migrate<Next extends PluginData, const NextV extends string>(\n    version: NextV,\n    fn: (current: Data) => Next,\n  ): PluginDataModelWithRecover<Next, Versions & Record<NextV, Next>> {\n    return PluginDataModelWithRecover[FROM_BUILDER]<Next, Versions & Record<NextV, Next>>({\n      ...this.state,\n      migrations: [\n        ...this.state.migrations,\n        { toVersion: version, fn: fn as (data: unknown) => unknown },\n      ],\n    });\n  }\n\n  init<Config = undefined>(fn: (config?: Config) => Data): PluginDataModel<Data, Versions, Config> {\n    return buildPluginDataModel(this.state, fn);\n  }\n}\n\n/**\n * Builds a PluginDataModel by replaying the stored chain state through DataModelBuilder.\n * @internal\n */\nfunction buildPluginDataModel<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n  Config,\n>(\n  state: PluginChainState,\n  configInitFn: (config?: Config) => Data,\n): PluginDataModel<Data, Versions, Config> {\n  // Build inner DataModel by replaying migrations through DataModelBuilder chain.\n  // Uses `any` internally — type safety is maintained by the public chain types.\n  let chain: any = new DataModelBuilder().from(state.initialVersion);\n\n  for (let i = 0; i < state.migrations.length; i++) {\n    if (state.recoverFn !== undefined && state.recoverAtIndex === i) {\n      chain = chain.recover(state.recoverFn);\n    }\n    chain = chain.migrate(state.migrations[i].toVersion, state.migrations[i].fn);\n  }\n\n  // If recover was placed at or after the last migration\n  if (state.recoverFn !== undefined && state.recoverAtIndex === state.migrations.length) {\n    chain = chain.recover(state.recoverFn);\n  }\n\n  const dataModel: DataModel<Data> = chain.init(() => configInitFn());\n\n  return PluginDataModel[FROM_BUILDER]<Data, Versions, Config>(dataModel, configInitFn);\n}\n\n/**\n * A named plugin instance created by `factory.create({ pluginId, ... })`.\n * Passed to both `.transfer()` (on migration chain) and `.plugin()` (on BlockModelV3).\n * Implements TransferTarget so the migration chain can accept it.\n *\n * @typeParam Id - Plugin instance ID literal type\n * @typeParam Data - Plugin data type\n * @typeParam Params - Plugin params type\n * @typeParam Outputs - Plugin outputs type\n * @typeParam TransferData - Type of data entering the plugin via transfer (never if no transfer)\n */\nexport class PluginInstance<\n  Id extends string = string,\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  TransferData = never,\n> implements TransferTarget<Id, TransferData> {\n  readonly id: Id;\n  readonly transferVersion: string;\n  /** @internal Phantom for type inference of Data/Params/Outputs; never set at runtime. */\n  readonly __instanceTypes?: { data: Data; params: Params; outputs: Outputs };\n  private readonly factory: PluginModelFactory<Data, Params, Outputs, any, any>;\n  private readonly config: any;\n\n  private constructor(\n    id: Id,\n    factory: PluginModelFactory<Data, Params, Outputs, any, any>,\n    transferVersion: string,\n    config?: any,\n  ) {\n    this.id = id;\n    this.factory = factory;\n    this.transferVersion = transferVersion;\n    this.config = config;\n  }\n\n  /** @internal */\n  static [FROM_BUILDER]<\n    Id extends string,\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    TransferData,\n  >(\n    id: Id,\n    factory: PluginModelFactory<Data, Params, Outputs, any, any>,\n    transferVersion: string,\n    config?: any,\n  ): PluginInstance<Id, Data, Params, Outputs, TransferData> {\n    return new PluginInstance(id, factory, transferVersion, config);\n  }\n\n  /** @internal Create a PluginModel from this instance. Used by BlockModelV3.plugin(). */\n  [CREATE_PLUGIN_MODEL](): PluginModel<Data, Params, Outputs> {\n    return this.factory[CREATE_PLUGIN_MODEL](this.config);\n  }\n}\n\n/**\n * Configured plugin instance returned by PluginModelFactory[CREATE_PLUGIN_MODEL]().\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  /** Per-output flags (e.g. withStatus) */\n  readonly outputFlags: Record<string, { withStatus: boolean }>;\n  /** Feature flags declared by this plugin */\n  readonly featureFlags?: BlockCodeKnownFeatureFlags;\n  /** Create fresh default data. Config (if any) is captured at creation time. */\n  readonly getDefaultData: () => DataVersioned<Data>;\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    outputFlags: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n    getDefaultData: () => DataVersioned<Data>;\n  }) {\n    this.name = options.name;\n    this.dataModel = options.dataModel;\n    this.outputs = options.outputs;\n    this.outputFlags = options.outputFlags;\n    this.featureFlags = options.featureFlags;\n    this.getDefaultData = options.getDefaultData;\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    outputFlags: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n    getDefaultData: () => DataVersioned<Data>;\n  }): PluginModel<Data, Params, Outputs> {\n    return new PluginModel<Data, Params, Outputs>(options);\n  }\n\n  /**\n   * Creates a new PluginModelBuilder with a PluginDataModel (supports transfer / config).\n   *\n   * @example\n   * const pluginData = new PluginDataModelBuilder().from<TableData>(\"v1\")\n   *   .migrate<FilteredTableData>(\"v2\", (v1) => ({ ...v1, filters: [] }))\n   *   .init<TableConfig>((config?) => ({\n   *     state: createDefaultState(config?.ops),\n   *     filters: [],\n   *   }));\n   *\n   * const myPlugin = PluginModel.define({\n   *   name: 'myPlugin' as PluginName,\n   *   data: pluginData,\n   * }).build();\n   */\n  static define<\n    Data extends PluginData,\n    Params extends PluginParams = undefined,\n    Versions extends Record<string, unknown> = {},\n    Config extends PluginConfig = undefined,\n  >(options: {\n    name: PluginName;\n    data: PluginDataModel<Data, Versions, Config>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelBuilder<Data, Params, {}, Config, Versions>;\n  /**\n   * Creates a new PluginModelBuilder with a data model factory function (backward compatible).\n   *\n   * @example\n   * const myPlugin = PluginModel.define({\n   *   name: 'myPlugin' as PluginName,\n   *   data: (cfg) => dataModelChain.init(() => ({ value: cfg.defaultValue })),\n   * }).build();\n   */\n  static define<\n    Data extends PluginData,\n    Params extends PluginParams = undefined,\n    Config extends PluginConfig = undefined,\n  >(options: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelBuilder<Data, Params, {}, Config, {}>;\n  static define(options: {\n    name: PluginName;\n    data: PluginDataModel<any, any, any> | ((config?: any) => DataModel<any>);\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelBuilder {\n    if (options.data instanceof PluginDataModel) {\n      const pdm = options.data;\n      return PluginModelBuilder[FROM_BUILDER]({\n        name: options.name,\n        dataFn: () => pdm.dataModel,\n        getDefaultDataFn: (config: any) => pdm.getDefaultData(config),\n        featureFlags: options.featureFlags,\n      });\n    }\n    return PluginModelBuilder[FROM_BUILDER]({\n      name: options.name,\n      dataFn: options.data,\n      featureFlags: options.featureFlags,\n    });\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  Versions extends Record<string, unknown> = {},\n> extends PluginFactoryLike<Data, Params, Outputs> {\n  /** Create a named plugin instance, optionally with transfer at a specific version. */\n  create<const Id extends string, const V extends string & keyof Versions = never>(options: {\n    pluginId: Id;\n    transferAt?: V;\n    config?: Config;\n  }): PluginInstance<Id, Data, Params, Outputs, Versions[V]>;\n\n  /**\n   * @internal Phantom field for structural type extraction.\n   * Enables InferFactoryData/InferFactoryOutputs to work via PluginFactoryLike.\n   */\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n    config: Config;\n    versions: Versions;\n  };\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  Versions extends Record<string, unknown> = {},\n> implements PluginFactory<Data, Params, Outputs, Config, Versions> {\n  private readonly name: PluginName;\n  private readonly dataFn: (config?: Config) => DataModel<Data>;\n  private readonly getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n  readonly outputs: {\n    [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n  };\n  private readonly outputFlags: Record<string, { withStatus: boolean }>;\n  private readonly featureFlags?: BlockCodeKnownFeatureFlags;\n\n  private constructor(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    outputFlags: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }) {\n    this.name = options.name;\n    this.dataFn = options.dataFn;\n    this.getDefaultDataFn = options.getDefaultDataFn;\n    this.outputs = options.outputs;\n    this.outputFlags = options.outputFlags;\n    this.featureFlags = options.featureFlags;\n  }\n\n  /** @internal */\n  static [FROM_BUILDER]<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    Config extends PluginConfig,\n    Versions extends Record<string, unknown>,\n  >(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    outputFlags: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelFactory<Data, Params, Outputs, Config, Versions> {\n    return new PluginModelFactory(options);\n  }\n\n  create<const Id extends string, const V extends string & keyof Versions = never>(options: {\n    pluginId: Id;\n    transferAt?: V;\n    config?: Config;\n  }): PluginInstance<Id, Data, Params, Outputs, Versions[V]> {\n    const transferVersion = options.transferAt ?? NO_TRANSFER_VERSION;\n    return PluginInstance[FROM_BUILDER]<Id, Data, Params, Outputs, Versions[V]>(\n      options.pluginId as Id,\n      this as any,\n      transferVersion,\n      options.config,\n    );\n  }\n\n  /** @internal Create a PluginModel from config. Config is captured in getDefaultData closure. */\n  [CREATE_PLUGIN_MODEL](config?: Config): PluginModel<Data, Params, Outputs> {\n    const dataModel = this.dataFn(config);\n    const getDefaultDataFn = this.getDefaultDataFn;\n    return PluginModel[FROM_BUILDER]<Data, Params, Outputs>({\n      name: this.name,\n      dataModel,\n      outputs: this.outputs,\n      outputFlags: this.outputFlags,\n      featureFlags: this.featureFlags,\n      getDefaultData: getDefaultDataFn\n        ? () => getDefaultDataFn(config)\n        : () => dataModel.getDefaultData(),\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 * @typeParam Versions - Version map from PluginDataModel (empty for function-based data)\n *\n * @example\n * const dataTable = PluginModel.define({\n *     name: 'dataTable' as PluginName,\n *     data: pluginDataModel,\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  Versions extends Record<string, unknown> = {},\n> {\n  private readonly name: PluginName;\n  private readonly dataFn: (config?: Config) => DataModel<Data>;\n  private readonly getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n  private readonly outputs: {\n    [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n  };\n  private readonly outputFlags: Record<string, { withStatus: boolean }>;\n  private readonly featureFlags?: BlockCodeKnownFeatureFlags;\n\n  private constructor(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs?: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    outputFlags?: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }) {\n    this.name = options.name;\n    this.dataFn = options.dataFn;\n    this.getDefaultDataFn = options.getDefaultDataFn;\n    this.outputs =\n      options.outputs ??\n      ({} as {\n        [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n      });\n    this.outputFlags = options.outputFlags ?? {};\n    this.featureFlags = options.featureFlags;\n  }\n\n  /** @internal */\n  static [FROM_BUILDER]<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    Config extends PluginConfig,\n    Versions extends Record<string, unknown> = {},\n  >(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs?: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    outputFlags?: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelBuilder<Data, Params, Outputs, Config, Versions> {\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, Versions> {\n    return new PluginModelBuilder<Data, Params, Outputs & { [K in Key]: T }, Config, Versions>({\n      name: this.name,\n      dataFn: this.dataFn,\n      getDefaultDataFn: this.getDefaultDataFn,\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      outputFlags: { ...this.outputFlags, [key]: { withStatus: false } },\n    });\n  }\n\n  /**\n   * Adds an output wrapped with status information to the plugin.\n   *\n   * The UI receives the full {@link OutputWithStatus} object instead of an unwrapped value,\n   * allowing it to distinguish between pending, success, and error states.\n   *\n   * @param key - Output name\n   * @param fn - Function that computes the output value from plugin context\n   * @returns PluginModel with the new status-wrapped output added\n   *\n   * @example\n   * .outputWithStatus('table', (ctx) => {\n   *   const pCols = ctx.params.pFrame?.getPColumns();\n   *   if (pCols === undefined) return undefined;\n   *   return createPlDataTableV2(ctx, pCols, ctx.data.tableState);\n   * })\n   */\n  outputWithStatus<const Key extends string, T>(\n    key: Key,\n    fn: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => T,\n  ): PluginModelBuilder<\n    Data,\n    Params,\n    Outputs & { [K in Key]: OutputWithStatus<T> },\n    Config,\n    Versions\n  > {\n    return new PluginModelBuilder<\n      Data,\n      Params,\n      Outputs & { [K in Key]: OutputWithStatus<T> },\n      Config,\n      Versions\n    >({\n      name: this.name,\n      dataFn: this.dataFn,\n      getDefaultDataFn: this.getDefaultDataFn,\n      featureFlags: this.featureFlags,\n      outputs: {\n        ...this.outputs,\n        [key]: fn,\n      } as {\n        [K in keyof (Outputs & { [P in Key]: OutputWithStatus<T> })]: (\n          ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>,\n        ) => (Outputs & { [P in Key]: OutputWithStatus<T> })[K];\n      },\n      outputFlags: { ...this.outputFlags, [key]: { withStatus: true } },\n    });\n  }\n\n  /**\n   * Finalizes the plugin definition and returns a PluginFactory.\n   *\n   * @returns Plugin factory that creates named plugin instances via .create()\n   *\n   * @example\n   * const myPlugin = PluginModel.define({ ... })\n   *   .output('value', (ctx) => ctx.data.value)\n   *   .build();\n   *\n   * // Create a named instance:\n   * const table = myPlugin.create({ pluginId: 'mainTable', config: { ... } });\n   */\n  build(): PluginFactory<Data, Params, Outputs, Config, Versions> {\n    return PluginModelFactory[FROM_BUILDER]<Data, Params, Outputs, Config, Versions>({\n      name: this.name,\n      dataFn: this.dataFn,\n      getDefaultDataFn: this.getDefaultDataFn,\n      outputs: this.outputs,\n      outputFlags: this.outputFlags,\n      featureFlags: this.featureFlags,\n    });\n  }\n}\n"],"mappings":";;;;;AAsBA,MAAM,eAAe,OAAO,cAAc;;AAG1C,MAAa,sBAAsB,OAAO,oBAAoB;;AAG9D,MAAM,sBAAsB;;;;;;;;AAc5B,IAAa,kBAAb,MAAa,gBAIX;CACA,AAAS;CACT,AAAiB;CAKjB,AAAQ,YAAY,WAA4B,cAAyC;AACvF,OAAK,YAAY;AACjB,OAAK,eAAe;;;CAItB,QAAQ,cACN,WACA,cACyC;AACzC,SAAO,IAAI,gBAAwC,WAAW,aAAa;;;CAI7E,eAAe,QAAsC;EACnD,MAAM,OAAO,KAAK,aAAa,OAAO;AACtC,SAAO;GAAE,SAAS,KAAK,UAAU;GAAS;GAAM;;;;;;;;;;;;;;;;AA8BpD,IAAa,yBAAb,MAAoC;CAClC,KACE,SACoD;AACpD,SAAO,4BAA4B,cAAqC;GACtE,gBAAgB;GAChB,YAAY,EAAE;GACf,CAAC;;;;;;;AAQN,IAAa,uBAAb,MAAa,qBAGX;CACA,AAAU,YAAY,AAAmB,OAAyB;EAAzB;;;CAGzC,QAAQ,cACN,OACsC;AACtC,SAAO,IAAI,qBAAqB,MAAM;;;;;CAMxC,QACE,SACA,IAC4D;AAC5D,SAAO,qBAAqB,cAAoD;GAC9E,GAAG,KAAK;GACR,YAAY,CACV,GAAG,KAAK,MAAM,YACd;IAAE,WAAW;IAAa;IAAkC,CAC7D;GACF,CAAC;;;;;;CAOJ,QAAQ,IAAqE;AAC3E,SAAO,2BAA2B,cAA8B;GAC9D,GAAG,KAAK;GACR,WAAW;GACX,gBAAgB,KAAK,MAAM,WAAW;GACvC,CAAC;;;CAIJ,KAAyB,IAAwE;AAC/F,SAAO,qBAAqB,KAAK,OAAO,GAAG;;;;;;;;AAS/C,IAAa,8BAAb,MAAa,oCAGH,qBAAqC;;CAE7C,QAAiB,cACf,OAC6C;AAC7C,SAAO,IAAI,4BAA4B,MAAM;;;;;;;;;;;;;CAc/C,cAAc,IAAyE;AACrF,SAAO,2BAA2B,cAA8B;GAC9D,GAAG,KAAK;GACR,YAAY,CACV;IAAE,WAAW,KAAK,MAAM;IAAoB;IAAkC,EAC9E,GAAG,KAAK,MAAM,WACf;GACD,gBAAgBA;GACjB,CAAC;;;;;;AAON,IAAa,6BAAb,MAAa,2BAGX;CACA,AAAQ,YAAY,AAAiB,OAAyB;EAAzB;;;CAGrC,QAAQ,cACN,OAC4C;AAC5C,SAAO,IAAI,2BAA2B,MAAM;;CAG9C,QACE,SACA,IACkE;AAClE,SAAO,2BAA2B,cAAoD;GACpF,GAAG,KAAK;GACR,YAAY,CACV,GAAG,KAAK,MAAM,YACd;IAAE,WAAW;IAAa;IAAkC,CAC7D;GACF,CAAC;;CAGJ,KAAyB,IAAwE;AAC/F,SAAO,qBAAqB,KAAK,OAAO,GAAG;;;;;;;AAQ/C,SAAS,qBAKP,OACA,cACyC;CAGzC,IAAI,QAAa,IAAIC,2CAAkB,CAAC,KAAK,MAAM,eAAe;AAElE,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,WAAW,QAAQ,KAAK;AAChD,MAAI,MAAM,cAAc,UAAa,MAAM,mBAAmB,EAC5D,SAAQ,MAAM,QAAQ,MAAM,UAAU;AAExC,UAAQ,MAAM,QAAQ,MAAM,WAAW,GAAG,WAAW,MAAM,WAAW,GAAG,GAAG;;AAI9E,KAAI,MAAM,cAAc,UAAa,MAAM,mBAAmB,MAAM,WAAW,OAC7E,SAAQ,MAAM,QAAQ,MAAM,UAAU;CAGxC,MAAM,YAA6B,MAAM,WAAW,cAAc,CAAC;AAEnE,QAAO,gBAAgB,cAAsC,WAAW,aAAa;;;;;;;;;;;;;AAcvF,IAAa,iBAAb,MAAa,eAMiC;CAC5C,AAAS;CACT,AAAS;;CAET,AAAS;CACT,AAAiB;CACjB,AAAiB;CAEjB,AAAQ,YACN,IACA,SACA,iBACA,QACA;AACA,OAAK,KAAK;AACV,OAAK,UAAU;AACf,OAAK,kBAAkB;AACvB,OAAK,SAAS;;;CAIhB,QAAQ,cAON,IACA,SACA,iBACA,QACyD;AACzD,SAAO,IAAI,eAAe,IAAI,SAAS,iBAAiB,OAAO;;;CAIjE,CAAC,uBAA2D;AAC1D,SAAO,KAAK,QAAQ,qBAAqB,KAAK,OAAO;;;;;;;AAQzD,IAAa,cAAb,MAAa,YAIX;;CAEA,AAAS;;CAET,AAAS;;CAET,AAAS;;CAIT,AAAS;;CAET,AAAS;;CAET,AAAS;CAET,AAAQ,YAAY,SASjB;AACD,OAAK,OAAO,QAAQ;AACpB,OAAK,YAAY,QAAQ;AACzB,OAAK,UAAU,QAAQ;AACvB,OAAK,cAAc,QAAQ;AAC3B,OAAK,eAAe,QAAQ;AAC5B,OAAK,iBAAiB,QAAQ;;;;;;;CAQhC,QAAQ,cAIN,SASqC;AACrC,SAAO,IAAI,YAAmC,QAAQ;;CA+CxD,OAAO,OAAO,SAIS;AACrB,MAAI,QAAQ,gBAAgB,iBAAiB;GAC3C,MAAM,MAAM,QAAQ;AACpB,UAAO,mBAAmB,cAAc;IACtC,MAAM,QAAQ;IACd,cAAc,IAAI;IAClB,mBAAmB,WAAgB,IAAI,eAAe,OAAO;IAC7D,cAAc,QAAQ;IACvB,CAAC;;AAEJ,SAAO,mBAAmB,cAAc;GACtC,MAAM,QAAQ;GACd,QAAQ,QAAQ;GAChB,cAAc,QAAQ;GACvB,CAAC;;;AAgCN,IAAM,qBAAN,MAAM,mBAM8D;CAClE,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAS;CAGT,AAAiB;CACjB,AAAiB;CAEjB,AAAQ,YAAY,SASjB;AACD,OAAK,OAAO,QAAQ;AACpB,OAAK,SAAS,QAAQ;AACtB,OAAK,mBAAmB,QAAQ;AAChC,OAAK,UAAU,QAAQ;AACvB,OAAK,cAAc,QAAQ;AAC3B,OAAK,eAAe,QAAQ;;;CAI9B,QAAQ,cAMN,SAS8D;AAC9D,SAAO,IAAI,mBAAmB,QAAQ;;CAGxC,OAAiF,SAItB;EACzD,MAAM,kBAAkB,QAAQ,cAAc;AAC9C,SAAO,eAAe,cACpB,QAAQ,UACR,MACA,iBACA,QAAQ,OACT;;;CAIH,CAAC,qBAAqB,QAAqD;EACzE,MAAM,YAAY,KAAK,OAAO,OAAO;EACrC,MAAM,mBAAmB,KAAK;AAC9B,SAAO,YAAY,cAAqC;GACtD,MAAM,KAAK;GACX;GACA,SAAS,KAAK;GACd,aAAa,KAAK;GAClB,cAAc,KAAK;GACnB,gBAAgB,yBACN,iBAAiB,OAAO,SACxB,UAAU,gBAAgB;GACrC,CAAC;;;;;;;;;;;;;;;;;;;;;;AAuBN,IAAM,qBAAN,MAAM,mBAMJ;CACA,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAGjB,AAAiB;CACjB,AAAiB;CAEjB,AAAQ,YAAY,SASjB;AACD,OAAK,OAAO,QAAQ;AACpB,OAAK,SAAS,QAAQ;AACtB,OAAK,mBAAmB,QAAQ;AAChC,OAAK,UACH,QAAQ,WACP,EAAE;AAGL,OAAK,cAAc,QAAQ,eAAe,EAAE;AAC5C,OAAK,eAAe,QAAQ;;;CAI9B,QAAQ,cAMN,SAS8D;AAC9D,SAAO,IAAI,mBAAmB,QAAQ;;;;;;;;;;;;;CAcxC,OACE,KACA,IACiF;AACjF,SAAO,IAAI,mBAAgF;GACzF,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,kBAAkB,KAAK;GACvB,cAAc,KAAK;GACnB,SAAS;IACP,GAAG,KAAK;KACP,MAAM;IACR;GAKD,aAAa;IAAE,GAAG,KAAK;KAAc,MAAM,EAAE,YAAY,OAAO;IAAE;GACnE,CAAC;;;;;;;;;;;;;;;;;;;CAoBJ,iBACE,KACA,IAOA;AACA,SAAO,IAAI,mBAMT;GACA,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,kBAAkB,KAAK;GACvB,cAAc,KAAK;GACnB,SAAS;IACP,GAAG,KAAK;KACP,MAAM;IACR;GAKD,aAAa;IAAE,GAAG,KAAK;KAAc,MAAM,EAAE,YAAY,MAAM;IAAE;GAClE,CAAC;;;;;;;;;;;;;;;CAgBJ,QAAgE;AAC9D,SAAO,mBAAmB,cAAuD;GAC/E,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,kBAAkB,KAAK;GACvB,SAAS,KAAK;GACd,aAAa,KAAK;GAClB,cAAc,KAAK;GACpB,CAAC"}
+{"version":3,"file":"plugin_model.cjs","names":["DATA_MODEL_LEGACY_VERSION","DataModelBuilder"],"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, OutputWithStatus } from \"@milaboratories/pl-model-common\";\nimport type { ResolveModelServices, ResolveUiServices } from \"./services/service_resolve\";\nimport {\n  type DataModel,\n  DataModelBuilder,\n  type DataRecoverFn,\n  type DataVersioned,\n  type TransferTarget,\n} from \"./block_migrations\";\nimport { type PluginName, DATA_MODEL_LEGACY_VERSION } 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\n/** Output function signature for plugin render context. */\ntype PluginOutputFn<\n  Data extends PluginData,\n  Params extends PluginParams,\n  ModelServices,\n  UiServices,\n  T,\n> = (\n  ctx: PluginRenderCtx<\n    PluginFactoryLike<Data, Params, Record<string, unknown>, ModelServices, UiServices>\n  >,\n) => T;\n\n/** Mapped output functions for a plugin's outputs. */\ntype PluginOutputFns<\n  Data extends PluginData,\n  Params extends PluginParams,\n  Outputs extends PluginOutputs,\n  ModelServices,\n  UiServices,\n> = {\n  [K in keyof Outputs]: PluginOutputFn<Data, Params, ModelServices, UiServices, Outputs[K]>;\n};\n\n/** Symbol for internal plugin model creation — not accessible to external consumers */\nexport const CREATE_PLUGIN_MODEL = Symbol(\"createPluginModel\");\n\n/** Sentinel for PluginInstance without transferAt — no transfer possible. */\nconst NO_TRANSFER_VERSION = \"\";\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 * Plugin data model with typed migration chain and config-aware initialization.\n *\n * @typeParam Data - Current (latest) plugin data type\n * @typeParam Versions - Map of version keys to their data types (accumulated by the chain)\n * @typeParam Config - Config type passed to init function (undefined if none)\n */\nexport class PluginDataModel<\n  Data extends PluginData,\n  Versions extends Record<string, unknown> = {},\n  Config = undefined,\n> {\n  readonly dataModel: DataModel<Data>;\n  private readonly configInitFn: (config?: Config) => Data;\n\n  /** @internal Phantom field to anchor the Versions type parameter. */\n  declare readonly __versions?: Versions;\n\n  private constructor(dataModel: DataModel<Data>, configInitFn: (config?: Config) => Data) {\n    this.dataModel = dataModel;\n    this.configInitFn = configInitFn;\n  }\n\n  /** @internal */\n  static [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>, Config>(\n    dataModel: DataModel<Data>,\n    configInitFn: (config?: Config) => Data,\n  ): PluginDataModel<Data, Versions, Config> {\n    return new PluginDataModel<Data, Versions, Config>(dataModel, configInitFn);\n  }\n\n  /** Create fresh data with optional config. */\n  getDefaultData(config?: Config): DataVersioned<Data> {\n    const data = this.configInitFn(config);\n    return { version: this.dataModel.version, data };\n  }\n}\n\n/** Internal state for plugin data model chain. */\ntype PluginChainState = {\n  initialVersion: string;\n  migrations: Array<{ toVersion: string; fn: (data: unknown) => unknown }>;\n  recoverFn?: (version: string, data: unknown) => unknown;\n  recoverAtIndex?: number;\n};\n\n/** Version → persisted data shape for each migration step (third generic of `PluginModel.define` when `data` is a `PluginDataModel`). */\nexport type PluginDataModelVersions<\n  M extends PluginDataModel<PluginData, Record<string, unknown>, unknown>,\n> = M extends PluginDataModel<PluginData, infer Versions, unknown> ? Versions : never;\n\n/**\n * Builder for creating PluginDataModel with type-safe migrations.\n * Mirrors DataModelBuilder — same .from(), .migrate(), .recover(), .init() chain.\n *\n * @example\n * const pluginData = new PluginDataModelBuilder()\n *   .from<TableData>(\"v1\")\n *   .migrate<FilteredTableData>(\"v2\", (v1) => ({ ...v1, filters: [] }))\n *   .init<TableConfig>((config?) => ({\n *     state: createDefaultState(config?.ops),\n *     filters: [],\n *   }));\n */\nexport class PluginDataModelBuilder {\n  from<Data extends PluginData, const V extends string>(\n    version: V,\n  ): PluginDataModelInitialChain<Data, Record<V, Data>> {\n    return PluginDataModelInitialChain[FROM_BUILDER]<Data, Record<V, Data>>({\n      initialVersion: version,\n      migrations: [],\n    });\n  }\n}\n\n/**\n * Chain returned by .migrate(). Supports .migrate(), .recover(), .init().\n * No .upgradeLegacy() — that is only available on the initial chain.\n */\nexport class PluginDataModelChain<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n> {\n  protected constructor(protected readonly state: PluginChainState) {}\n\n  /** @internal */\n  static [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>>(\n    state: PluginChainState,\n  ): PluginDataModelChain<Data, Versions> {\n    return new PluginDataModelChain(state);\n  }\n\n  /**\n   * Add a migration step transforming data from the current version to the next.\n   */\n  migrate<Next extends PluginData, const NextV extends string>(\n    version: NextV,\n    fn: (current: Data) => Next,\n  ): PluginDataModelChain<Next, Versions & Record<NextV, Next>> {\n    return PluginDataModelChain[FROM_BUILDER]<Next, Versions & Record<NextV, Next>>({\n      ...this.state,\n      migrations: [\n        ...this.state.migrations,\n        { toVersion: version, fn: fn as (data: unknown) => unknown },\n      ],\n    });\n  }\n\n  /**\n   * Set a recovery handler for unknown or legacy versions.\n   * Can only be called once — the returned chain has no recover() method.\n   */\n  recover(fn: DataRecoverFn<Data>): PluginDataModelWithRecover<Data, Versions> {\n    return PluginDataModelWithRecover[FROM_BUILDER]<Data, Versions>({\n      ...this.state,\n      recoverFn: fn as (version: string, data: unknown) => unknown,\n      recoverAtIndex: this.state.migrations.length,\n    });\n  }\n\n  /** Finalize the PluginDataModel. */\n  init<Config = undefined>(fn: (config?: Config) => Data): PluginDataModel<Data, Versions, Config> {\n    return buildPluginDataModel(this.state, fn);\n  }\n}\n\n/**\n * Initial chain returned by new PluginDataModelBuilder().from().\n * Extends PluginDataModelChain with .upgradeLegacy() — available only before\n * any .migrate() calls, matching the block's DataModelInitialChain pattern.\n */\nexport class PluginDataModelInitialChain<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n> extends PluginDataModelChain<Data, Versions> {\n  /** @internal */\n  static override [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>>(\n    state: PluginChainState,\n  ): PluginDataModelInitialChain<Data, Versions> {\n    return new PluginDataModelInitialChain(state);\n  }\n\n  /**\n   * Handle data from a previous plugin type occupying this slot.\n   * Prepends a migration from DATA_MODEL_LEGACY_VERSION to the initial version.\n   * When a plugin type changes, the old data arrives with DATA_MODEL_LEGACY_VERSION —\n   * this function transforms it into the initial version, then the normal chain runs.\n   *\n   * Must be called right after .from() — not available after .migrate().\n   * Mutually exclusive with recover().\n   *\n   * @param fn - Transform from old plugin's raw data to this plugin's initial data type\n   */\n  upgradeLegacy(fn: (data: unknown) => Data): PluginDataModelWithRecover<Data, Versions> {\n    return PluginDataModelWithRecover[FROM_BUILDER]<Data, Versions>({\n      ...this.state,\n      migrations: [\n        { toVersion: this.state.initialVersion, fn: fn as (data: unknown) => unknown },\n        ...this.state.migrations,\n      ],\n      initialVersion: DATA_MODEL_LEGACY_VERSION,\n    });\n  }\n}\n\n/**\n * Chain after .recover() — supports .migrate(), .init(). No second recover().\n */\nexport class PluginDataModelWithRecover<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n> {\n  private constructor(private readonly state: PluginChainState) {}\n\n  /** @internal */\n  static [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>>(\n    state: PluginChainState,\n  ): PluginDataModelWithRecover<Data, Versions> {\n    return new PluginDataModelWithRecover(state);\n  }\n\n  migrate<Next extends PluginData, const NextV extends string>(\n    version: NextV,\n    fn: (current: Data) => Next,\n  ): PluginDataModelWithRecover<Next, Versions & Record<NextV, Next>> {\n    return PluginDataModelWithRecover[FROM_BUILDER]<Next, Versions & Record<NextV, Next>>({\n      ...this.state,\n      migrations: [\n        ...this.state.migrations,\n        { toVersion: version, fn: fn as (data: unknown) => unknown },\n      ],\n    });\n  }\n\n  init<Config = undefined>(fn: (config?: Config) => Data): PluginDataModel<Data, Versions, Config> {\n    return buildPluginDataModel(this.state, fn);\n  }\n}\n\n/**\n * Builds a PluginDataModel by replaying the stored chain state through DataModelBuilder.\n * @internal\n */\nfunction buildPluginDataModel<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n  Config,\n>(\n  state: PluginChainState,\n  configInitFn: (config?: Config) => Data,\n): PluginDataModel<Data, Versions, Config> {\n  // Build inner DataModel by replaying migrations through DataModelBuilder chain.\n  // Uses `any` internally — type safety is maintained by the public chain types.\n  let chain: any = new DataModelBuilder().from(state.initialVersion);\n\n  for (let i = 0; i < state.migrations.length; i++) {\n    if (state.recoverFn !== undefined && state.recoverAtIndex === i) {\n      chain = chain.recover(state.recoverFn);\n    }\n    chain = chain.migrate(state.migrations[i].toVersion, state.migrations[i].fn);\n  }\n\n  // If recover was placed at or after the last migration\n  if (state.recoverFn !== undefined && state.recoverAtIndex === state.migrations.length) {\n    chain = chain.recover(state.recoverFn);\n  }\n\n  const dataModel: DataModel<Data> = chain.init(() => configInitFn());\n\n  return PluginDataModel[FROM_BUILDER]<Data, Versions, Config>(dataModel, configInitFn);\n}\n\n/**\n * A named plugin instance created by `factory.create({ pluginId, ... })`.\n * Passed to both `.transfer()` (on migration chain) and `.plugin()` (on BlockModelV3).\n * Implements TransferTarget so the migration chain can accept it.\n *\n * @typeParam Id - Plugin instance ID literal type\n * @typeParam Data - Plugin data type\n * @typeParam Params - Plugin params type\n * @typeParam Outputs - Plugin outputs type\n * @typeParam TransferData - Type of data entering the plugin via transfer (never if no transfer)\n */\nexport class PluginInstance<\n  Id extends string = string,\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  TransferData = never,\n  ModelServices = unknown,\n  UiServices = unknown,\n> implements TransferTarget<Id, TransferData> {\n  readonly id: Id;\n  readonly transferVersion: string;\n  /** @internal Phantom for type inference; never set at runtime. */\n  readonly __instanceTypes?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n    modelServices: ModelServices;\n    uiServices: UiServices;\n  };\n  /** Bound closure that creates the PluginModel. Config is captured at factory.create() time. */\n  private readonly createPluginModel: () => PluginModel<\n    Data,\n    Params,\n    Outputs,\n    ModelServices,\n    UiServices\n  >;\n\n  private constructor(\n    id: Id,\n    createPluginModel: () => PluginModel<Data, Params, Outputs, ModelServices, UiServices>,\n    transferVersion: string,\n  ) {\n    this.id = id;\n    this.createPluginModel = createPluginModel;\n    this.transferVersion = transferVersion;\n  }\n\n  /** @internal Accepts concrete Config — binds it into a closure, avoiding Config variance issues. */\n  static [FROM_BUILDER]<\n    Id extends string,\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    TransferData,\n    Config extends PluginConfig = PluginConfig,\n    ModelServices = unknown,\n    UiServices = unknown,\n  >(\n    id: Id,\n    factory: PluginModelFactory<\n      Data,\n      Params,\n      Outputs,\n      Config,\n      Record<string, unknown>,\n      ModelServices,\n      UiServices\n    >,\n    transferVersion: string,\n    config?: Config,\n  ): PluginInstance<Id, Data, Params, Outputs, TransferData, ModelServices, UiServices> {\n    return new PluginInstance(id, () => factory[CREATE_PLUGIN_MODEL](config), transferVersion);\n  }\n\n  /** @internal Create a PluginModel from this instance. Used by BlockModelV3.plugin(). */\n  [CREATE_PLUGIN_MODEL](): PluginModel<Data, Params, Outputs, ModelServices, UiServices> {\n    return this.createPluginModel();\n  }\n}\n\n/**\n * Configured plugin instance returned by PluginModelFactory[CREATE_PLUGIN_MODEL]().\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  ModelServices = {},\n  UiServices = {},\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: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n  /** Per-output flags (e.g. withStatus) */\n  readonly outputFlags: Record<string, { withStatus: boolean }>;\n  /** Feature flags declared by this plugin */\n  readonly featureFlags?: BlockCodeKnownFeatureFlags;\n  /** Create fresh default data. Config (if any) is captured at creation time. */\n  readonly getDefaultData: () => DataVersioned<Data>;\n\n  private constructor(options: {\n    name: PluginName;\n    dataModel: DataModel<Data>;\n    outputs: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n    outputFlags: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n    getDefaultData: () => DataVersioned<Data>;\n  }) {\n    this.name = options.name;\n    this.dataModel = options.dataModel;\n    this.outputs = options.outputs;\n    this.outputFlags = options.outputFlags;\n    this.featureFlags = options.featureFlags;\n    this.getDefaultData = options.getDefaultData;\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    ModelServices = {},\n    UiServices = {},\n  >(options: {\n    name: PluginName;\n    dataModel: DataModel<Data>;\n    outputs: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n    outputFlags: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n    getDefaultData: () => DataVersioned<Data>;\n  }): PluginModel<Data, Params, Outputs, ModelServices, UiServices> {\n    return new PluginModel<Data, Params, Outputs, ModelServices, UiServices>(options);\n  }\n\n  /**\n   * Creates a new PluginModelBuilder with a PluginDataModel (supports transfer / config).\n   *\n   * @example\n   * const pluginData = new PluginDataModelBuilder().from<TableData>(\"v1\")\n   *   .migrate<FilteredTableData>(\"v2\", (v1) => ({ ...v1, filters: [] }))\n   *   .init<TableConfig>((config?) => ({\n   *     state: createDefaultState(config?.ops),\n   *     filters: [],\n   *   }));\n   *\n   * const myPlugin = PluginModel.define({\n   *   name: 'myPlugin' as PluginName,\n   *   data: pluginData,\n   * }).build();\n   */\n  static define<\n    Data extends PluginData,\n    Params extends PluginParams = undefined,\n    Versions extends Record<string, unknown> = {},\n    Config extends PluginConfig = undefined,\n    Flags extends BlockCodeKnownFeatureFlags = {},\n  >(options: {\n    name: PluginName;\n    data: PluginDataModel<Data, Versions, Config>;\n    featureFlags?: Flags;\n  }): PluginModelInitialBuilder<\n    Data,\n    Params,\n    Config,\n    Versions,\n    ResolveModelServices<Flags>,\n    ResolveUiServices<Flags>\n  >;\n  /**\n   * Creates a new PluginModelBuilder with a data model factory function (backward compatible).\n   *\n   * @example\n   * const myPlugin = PluginModel.define({\n   *   name: 'myPlugin' as PluginName,\n   *   data: (cfg) => dataModelChain.init(() => ({ value: cfg.defaultValue })),\n   * }).build();\n   */\n  static define<\n    Data extends PluginData,\n    Params extends PluginParams = undefined,\n    Config extends PluginConfig = undefined,\n    Flags extends BlockCodeKnownFeatureFlags = {},\n  >(options: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    featureFlags?: Flags;\n  }): PluginModelInitialBuilder<\n    Data,\n    Params,\n    Config,\n    {},\n    ResolveModelServices<Flags>,\n    ResolveUiServices<Flags>\n  >;\n  static define(options: {\n    name: PluginName;\n    data: PluginDataModel<any, any, any> | ((config?: any) => DataModel<any>);\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelInitialBuilder {\n    if (options.data instanceof PluginDataModel) {\n      const pdm = options.data;\n      return PluginModelInitialBuilder.create({\n        name: options.name,\n        dataFn: () => pdm.dataModel,\n        getDefaultDataFn: (config: any) => pdm.getDefaultData(config),\n        featureFlags: options.featureFlags,\n      });\n    }\n    return PluginModelInitialBuilder.create({\n      name: options.name,\n      dataFn: options.data,\n      featureFlags: options.featureFlags,\n    });\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  Versions extends Record<string, unknown> = {},\n  ModelServices = {},\n  UiServices = {},\n> extends PluginFactoryLike<Data, Params, Outputs, ModelServices, UiServices> {\n  /** Create a named plugin instance, optionally with transfer at a specific version. */\n  create<const Id extends string, const V extends string & keyof Versions = never>(options: {\n    pluginId: Id;\n    transferAt?: V;\n    config?: Config;\n  }): PluginInstance<Id, Data, Params, Outputs, Versions[V], ModelServices, UiServices>;\n\n  /**\n   * @internal Phantom field for structural type extraction.\n   * Enables InferFactoryData/InferFactoryOutputs to work via PluginFactoryLike.\n   */\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n    modelServices: ModelServices;\n    uiServices: UiServices;\n    config: Config;\n    versions: Versions;\n  };\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  Versions extends Record<string, unknown> = {},\n  ModelServices = {},\n  UiServices = {},\n> implements PluginFactory<Data, Params, Outputs, Config, Versions, ModelServices, UiServices> {\n  private readonly name: PluginName;\n  private readonly dataFn: (config?: Config) => DataModel<Data>;\n  private readonly getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n  readonly outputs: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n  private readonly outputFlags: Record<string, { withStatus: boolean }>;\n  private readonly featureFlags?: BlockCodeKnownFeatureFlags;\n\n  private constructor(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n    outputFlags: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }) {\n    this.name = options.name;\n    this.dataFn = options.dataFn;\n    this.getDefaultDataFn = options.getDefaultDataFn;\n    this.outputs = options.outputs;\n    this.outputFlags = options.outputFlags;\n    this.featureFlags = options.featureFlags;\n  }\n\n  /** @internal */\n  static [FROM_BUILDER]<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    Config extends PluginConfig,\n    Versions extends Record<string, unknown>,\n    ModelServices = {},\n    UiServices = {},\n  >(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n    outputFlags: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelFactory<Data, Params, Outputs, Config, Versions, ModelServices, UiServices> {\n    return new PluginModelFactory(options);\n  }\n\n  create<const Id extends string, const V extends string & keyof Versions = never>(options: {\n    pluginId: Id;\n    transferAt?: V;\n    config?: Config;\n  }): PluginInstance<Id, Data, Params, Outputs, Versions[V], ModelServices, UiServices> {\n    const transferVersion = options.transferAt ?? NO_TRANSFER_VERSION;\n    return PluginInstance[FROM_BUILDER]<\n      Id,\n      Data,\n      Params,\n      Outputs,\n      Versions[V],\n      Config,\n      ModelServices,\n      UiServices\n    >(options.pluginId as Id, this, transferVersion, options.config);\n  }\n\n  /** @internal Create a PluginModel from config. Config is captured in getDefaultData closure. */\n  [CREATE_PLUGIN_MODEL](\n    config?: Config,\n  ): PluginModel<Data, Params, Outputs, ModelServices, UiServices> {\n    const dataModel = this.dataFn(config);\n    const getDefaultDataFn = this.getDefaultDataFn;\n    return PluginModel[FROM_BUILDER]<Data, Params, Outputs, ModelServices, UiServices>({\n      name: this.name,\n      dataModel,\n      outputs: this.outputs,\n      outputFlags: this.outputFlags,\n      featureFlags: this.featureFlags,\n      getDefaultData: getDefaultDataFn\n        ? () => getDefaultDataFn(config)\n        : () => dataModel.getDefaultData(),\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 * @typeParam Versions - Version map from PluginDataModel (empty for function-based data)\n *\n * @example\n * const dataTable = PluginModel.define({\n *     name: 'dataTable' as PluginName,\n *     data: pluginDataModel,\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  Versions extends Record<string, unknown> = {},\n  ModelServices = {},\n  UiServices = {},\n> {\n  protected readonly name: PluginName;\n  protected readonly dataFn: (config?: Config) => DataModel<Data>;\n  protected readonly getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n  private readonly outputs: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n  private readonly outputFlags: Record<string, { withStatus: boolean }>;\n  protected readonly featureFlags?: BlockCodeKnownFeatureFlags;\n\n  protected constructor(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs?: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n    outputFlags?: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }) {\n    this.name = options.name;\n    this.dataFn = options.dataFn;\n    this.getDefaultDataFn = options.getDefaultDataFn;\n    this.outputs =\n      options.outputs ?? ({} as PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>);\n    this.outputFlags = options.outputFlags ?? {};\n    this.featureFlags = options.featureFlags;\n  }\n\n  /** @internal */\n  static [FROM_BUILDER]<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    Config extends PluginConfig,\n    Versions extends Record<string, unknown> = {},\n    ModelServices = {},\n    UiServices = {},\n  >(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs?: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n    outputFlags?: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelBuilder<Data, Params, Outputs, Config, Versions, ModelServices, UiServices> {\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: (\n      ctx: PluginRenderCtx<\n        PluginFactoryLike<Data, Params, Record<string, unknown>, ModelServices, UiServices>\n      >,\n    ) => T,\n  ): PluginModelBuilder<\n    Data,\n    Params,\n    Outputs & { [K in Key]: T },\n    Config,\n    Versions,\n    ModelServices,\n    UiServices\n  > {\n    return new PluginModelBuilder<\n      Data,\n      Params,\n      Outputs & { [K in Key]: T },\n      Config,\n      Versions,\n      ModelServices,\n      UiServices\n    >({\n      name: this.name,\n      dataFn: this.dataFn,\n      getDefaultDataFn: this.getDefaultDataFn,\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<\n            PluginFactoryLike<Data, Params, Record<string, unknown>, ModelServices, UiServices>\n          >,\n        ) => (Outputs & { [P in Key]: T })[K];\n      },\n      outputFlags: { ...this.outputFlags, [key]: { withStatus: false } },\n    });\n  }\n\n  /**\n   * Adds an output wrapped with status information to the plugin.\n   *\n   * The UI receives the full {@link OutputWithStatus} object instead of an unwrapped value,\n   * allowing it to distinguish between pending, success, and error states.\n   *\n   * @param key - Output name\n   * @param fn - Function that computes the output value from plugin context\n   * @returns PluginModel with the new status-wrapped output added\n   *\n   * @example\n   * .outputWithStatus('table', (ctx) => {\n   *   const pCols = ctx.params.pFrame?.getPColumns();\n   *   if (pCols === undefined) return undefined;\n   *   return createPlDataTableV2(ctx, pCols, ctx.data.tableState);\n   * })\n   */\n  outputWithStatus<const Key extends string, T>(\n    key: Key,\n    fn: (\n      ctx: PluginRenderCtx<\n        PluginFactoryLike<Data, Params, Record<string, unknown>, ModelServices, UiServices>\n      >,\n    ) => T,\n  ): PluginModelBuilder<\n    Data,\n    Params,\n    Outputs & { [K in Key]: OutputWithStatus<T> },\n    Config,\n    Versions,\n    ModelServices,\n    UiServices\n  > {\n    return new PluginModelBuilder<\n      Data,\n      Params,\n      Outputs & { [K in Key]: OutputWithStatus<T> },\n      Config,\n      Versions,\n      ModelServices,\n      UiServices\n    >({\n      name: this.name,\n      dataFn: this.dataFn,\n      getDefaultDataFn: this.getDefaultDataFn,\n      featureFlags: this.featureFlags,\n      outputs: {\n        ...this.outputs,\n        [key]: fn,\n      } as {\n        [K in keyof (Outputs & { [P in Key]: OutputWithStatus<T> })]: (\n          ctx: PluginRenderCtx<\n            PluginFactoryLike<Data, Params, Record<string, unknown>, ModelServices, UiServices>\n          >,\n        ) => (Outputs & { [P in Key]: OutputWithStatus<T> })[K];\n      },\n      outputFlags: { ...this.outputFlags, [key]: { withStatus: true } },\n    });\n  }\n\n  /**\n   * Finalizes the plugin definition and returns a PluginFactory.\n   *\n   * @returns Plugin factory that creates named plugin instances via .create()\n   *\n   * @example\n   * const myPlugin = PluginModel.define({ ... })\n   *   .output('value', (ctx) => ctx.data.value)\n   *   .build();\n   *\n   * // Create a named instance:\n   * const table = myPlugin.create({ pluginId: 'mainTable', config: { ... } });\n   */\n  build(): PluginFactory<Data, Params, Outputs, Config, Versions, ModelServices, UiServices> {\n    return PluginModelFactory[FROM_BUILDER]<\n      Data,\n      Params,\n      Outputs,\n      Config,\n      Versions,\n      ModelServices,\n      UiServices\n    >({\n      name: this.name,\n      dataFn: this.dataFn,\n      getDefaultDataFn: this.getDefaultDataFn,\n      outputs: this.outputs,\n      outputFlags: this.outputFlags,\n      featureFlags: this.featureFlags,\n    });\n  }\n}\n\n/**\n * Initial builder returned by PluginModel.define(). Extends PluginModelBuilder with .params().\n * Once .params() or .output() is called, transitions to PluginModelBuilder (no second .params()).\n */\nclass PluginModelInitialBuilder<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Config extends PluginConfig = undefined,\n  Versions extends Record<string, unknown> = {},\n  ModelServices = {},\n  UiServices = {},\n> extends PluginModelBuilder<Data, Params, {}, Config, Versions, ModelServices, UiServices> {\n  /** @internal */\n  static create<\n    Data extends PluginData,\n    Config extends PluginConfig,\n    Versions extends Record<string, unknown> = {},\n    ModelServices = {},\n    UiServices = {},\n  >(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelInitialBuilder<Data, undefined, Config, Versions, ModelServices, UiServices> {\n    return new PluginModelInitialBuilder(options);\n  }\n\n  /**\n   * Sets the Params type for this plugin — the shape of data derived from the block's\n   * render context and passed into plugin output functions via `ctx.params`.\n   * Must be called before .output(). Available only on the initial builder.\n   *\n   * @example\n   * .params<{ title: string }>()\n   * .output('displayText', (ctx) => ctx.params.title)\n   */\n  params<P extends PluginParams>(): PluginModelBuilder<\n    Data,\n    P,\n    {},\n    Config,\n    Versions,\n    ModelServices,\n    UiServices\n  > {\n    return PluginModelBuilder[FROM_BUILDER]<\n      Data,\n      P,\n      {},\n      Config,\n      Versions,\n      ModelServices,\n      UiServices\n    >({\n      name: this.name,\n      dataFn: this.dataFn,\n      getDefaultDataFn: this.getDefaultDataFn,\n      featureFlags: this.featureFlags,\n    });\n  }\n}\n"],"mappings":"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"}