@platforma-sdk/model 1.60.2 → 1.61.1

package/dist/render/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","names":[],"sources":["../../src/render/internal.ts"],"sourcesContent":["import type { Optional } from \"utility-types\";\nimport type {\n  Branded,\n  DiscoverColumnsRequest,\n  DiscoverColumnsResponse,\n  StringifiedJson,\n} from \"@milaboratories/pl-model-common\";\nimport type { CommonFieldTraverseOps, FieldTraversalStep, ResourceType } from \"./traversal_ops\";\nimport type {\n  ArchiveFormat,\n  AnyFunction,\n  Option,\n  PColumn,\n  PColumnValues,\n  PFrameDef,\n  PFrameHandle,\n  PObject,\n  PObjectSpec,\n  PSpecPredicate,\n  PTableDef,\n  PTableDefV2,\n  PTableHandle,\n  ResultCollection,\n  ValueOrError,\n  DataInfo,\n  RangeBytes,\n  PColumnSpec,\n} from \"@milaboratories/pl-model-common\";\nimport type { TreeNodeAccessor } from \"./accessor\";\n\nexport const StagingAccessorName = \"staging\";\nexport const MainAccessorName = \"main\";\n\nexport type AccessorHandle = Branded<string, \"AccessorHandle\">;\nexport type FutureHandle = Branded<string, \"FutureHandle\">;\n\nexport type PColumnDataUniversal<TreeEntry = TreeNodeAccessor> =\n  | TreeEntry\n  | DataInfo<TreeEntry>\n  | PColumnValues;\n\nexport interface GlobalCfgRenderCtxMethods<AHandle = AccessorHandle, FHandle = FutureHandle> {\n  //\n  // Root accessor creation\n  //\n\n  getAccessorHandleByName(name: string): AHandle | undefined;\n\n  //\n  // Basic resource accessor actions\n  //\n\n  resolveWithCommon(\n    handle: AHandle,\n    commonOptions: CommonFieldTraverseOps,\n    ...steps: (FieldTraversalStep | string)[]\n  ): AHandle | undefined;\n\n  getResourceType(handle: AHandle): ResourceType;\n\n  getInputsLocked(handle: AHandle): boolean;\n\n  getOutputsLocked(handle: AHandle): boolean;\n\n  getIsReadyOrError(handle: AHandle): boolean;\n\n  getIsFinal(handle: AHandle): boolean;\n\n  getError(handle: AHandle): AHandle | undefined;\n\n  listInputFields(handle: AHandle): string[];\n\n  listOutputFields(handle: AHandle): string[];\n\n  listDynamicFields(handle: AHandle): string[];\n\n  getKeyValueBase64(handle: AHandle, key: string): string | undefined;\n\n  getKeyValueAsString(handle: AHandle, key: string): string | undefined;\n\n  getDataBase64(handle: AHandle): string | undefined;\n\n  getDataAsString(handle: AHandle): string | undefined;\n\n  /** If not final returns undefined */\n  parsePObjectCollection(\n    handle: AHandle,\n    errorOnUnknownField: boolean,\n    prefix: string,\n    ...resolvePath: string[]\n  ): Record<string, PObject<AHandle>> | undefined;\n\n  //\n  // Blob\n  //\n\n  getBlobContentAsBase64(handle: AHandle, range?: RangeBytes): FHandle; // string | undefined\n\n  getBlobContentAsString(handle: AHandle, range?: RangeBytes): FHandle; // string | undefined\n\n  getDownloadedBlobContentHandle(handle: AHandle): FHandle; // LocalBlobHandleAndSize | undefined;\n\n  getOnDemandBlobContentHandle(handle: AHandle): FHandle; // RemoteBlobHandleAndSize | undefined;\n\n  //\n  // Blobs to URLs\n  //\n\n  extractArchiveAndGetURL(handle: AHandle, format: ArchiveFormat): FHandle;\n\n  //\n  // Import progress\n  //\n\n  getImportProgress(handle: AHandle): FHandle; // ImportProgress;\n\n  //\n  // Logs\n  //\n\n  getLastLogs(handle: AHandle, nLines: number): FHandle; // string | undefined;\n\n  getProgressLog(handle: AHandle, patternToSearch: string): FHandle; // string | undefined;\n\n  getProgressLogWithInfo(handle: AHandle, patternToSearch: string): FHandle; // ProgressLogWithInfo | undefined;\n\n  getLogHandle(handle: AHandle): FHandle; // AnyLogHandle | undefined;\n\n  //\n  // Blocks\n  //\n\n  /** @deprecated at some point will stop working and will return dummy values */\n  getBlockLabel(blockId: string): string;\n\n  //\n  // Result Pool\n  //\n\n  getDataFromResultPool(): ResultCollection<PObject<AHandle>>;\n\n  getDataWithErrorsFromResultPool(): ResultCollection<\n    Optional<PObject<ValueOrError<AHandle, Error>>, \"id\">\n  >;\n\n  getSpecsFromResultPool(): ResultCollection<PObjectSpec>;\n\n  getSpecFromResultPoolByRef(blockId: string, exportName: string): PObjectSpec | undefined;\n\n  getDataFromResultPoolByRef(blockId: string, exportName: string): PObject<AHandle> | undefined;\n\n  calculateOptions(predicate: PSpecPredicate): Option[];\n\n  //\n  // PFrame / PTable\n  //\n\n  createPFrame(def: PFrameDef<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>): PFrameHandle;\n\n  createPTable(def: PTableDef<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>): PTableHandle;\n\n  createPTableV2(\n    def: PTableDefV2<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>,\n  ): PTableHandle;\n\n  //\n  // Spec Frames (synchronous WASM-based PFrame for spec-level operations)\n  //\n\n  createSpecFrame(specs: Record<string, PColumnSpec>): string;\n\n  specFrameDiscoverColumns(\n    handle: string,\n    request: DiscoverColumnsRequest,\n  ): DiscoverColumnsResponse;\n\n  specFrameDispose(handle: string): void;\n\n  //\n  // Computable\n  //\n\n  getCurrentUnstableMarker(): string | undefined;\n\n  //\n  // Logging\n  //\n\n  logInfo(message: string): void;\n\n  logWarn(message: string): void;\n\n  logError(message: string): void;\n}\n\nexport const GlobalCfgRenderCtxFeatureFlags = {\n  explicitColumnsSupport: true as const,\n  inlineColumnsSupport: true as const,\n  activeArgs: true as const,\n  pTablePartitionFiltersSupport: true as const,\n  pFrameInSetFilterSupport: true as const,\n};\n\nexport interface GlobalCfgRenderCtx extends GlobalCfgRenderCtxMethods {\n  //\n  // State: Args, UI State, Active Args\n  //\n  // Old runtime injects these values as strings, new runtime injects them as functions\n  // that return strings, if block declares supportsLazyState flag.\n  // If function not called in lazy state API, then resulting output will not depend on these values,\n  // and thus will not be recalculated on corresponding state change.\n  //\n\n  readonly args: string | (() => string);\n  /** @deprecated Use `data` instead. Optional for backward compatibility - falls back to `data` if not injected. */\n  readonly uiState?: string | (() => string);\n  readonly data: string | (() => string);\n  readonly activeArgs: undefined | string | (() => string | undefined);\n\n  readonly blockStorage: () => StringifiedJson;\n\n  // Note: strings below are used because, anyway, using strings is the only way\n  // to get data inside the QuickJS context, as it is implemented now. With this\n  // approach deserialization can be lazily postponed until it is actually needed.\n  readonly callbackRegistry: Record<string, AnyFunction>;\n  readonly featureFlags?: typeof GlobalCfgRenderCtxFeatureFlags;\n}\n\nexport type FutureAwait = {\n  __awaited_futures__: FutureHandle[];\n};\n\nexport function isFutureAwait(obj: unknown): obj is FutureAwait {\n  return typeof obj === \"object\" && obj !== null && \"__awaited_futures__\" in obj;\n}\n\nfunction addAllFutureAwaits(set: Set<string>, visited: Set<unknown>, node: unknown) {\n  if (visited.has(node)) return;\n  visited.add(node);\n\n  const type = typeof node;\n  if (type === \"object\") {\n    if (isFutureAwait(node)) node.__awaited_futures__.forEach((a) => set.add(a));\n    else if (Array.isArray(node))\n      for (const nested of node) addAllFutureAwaits(set, visited, nested);\n    else\n      for (const [, nested] of Object.entries(node as object))\n        if (nested !== node) addAllFutureAwaits(set, visited, nested);\n  }\n}\n\nexport function getAllFutureAwaits(obj: unknown): Set<string> {\n  const set = new Set<string>();\n  addAllFutureAwaits(set, new Set(), obj);\n  return set;\n}\n"],"mappings":";;;;;;;;;;AA8BA,MAAa,sBAAsB;AACnC,MAAa,mBAAmB;AAoKhC,MAAa,iCAAiC;CAC5C,wBAAwB;CACxB,sBAAsB;CACtB,YAAY;CACZ,+BAA+B;CAC/B,0BAA0B;CAC3B;AA+BD,SAAgB,cAAc,KAAkC;AAC9D,QAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,yBAAyB;;AAG7E,SAAS,mBAAmB,KAAkB,SAAuB,MAAe;AAClF,KAAI,QAAQ,IAAI,KAAK,CAAE;AACvB,SAAQ,IAAI,KAAK;AAGjB,KADa,OAAO,SACP,UACX;MAAI,cAAc,KAAK,CAAE,MAAK,oBAAoB,SAAS,MAAM,IAAI,IAAI,EAAE,CAAC;WACnE,MAAM,QAAQ,KAAK,CAC1B,MAAK,MAAM,UAAU,KAAM,oBAAmB,KAAK,SAAS,OAAO;MAEnE,MAAK,MAAM,GAAG,WAAW,OAAO,QAAQ,KAAe,CACrD,KAAI,WAAW,KAAM,oBAAmB,KAAK,SAAS,OAAO;;;AAIrE,SAAgB,mBAAmB,KAA2B;CAC5D,MAAM,sBAAM,IAAI,KAAa;AAC7B,oBAAmB,qBAAK,IAAI,KAAK,EAAE,IAAI;AACvC,QAAO"}
+{"version":3,"file":"internal.js","names":[],"sources":["../../src/render/internal.ts"],"sourcesContent":["import type { Optional } from \"utility-types\";\nimport type {\n  AxesId,\n  AxesSpec,\n  Branded,\n  DiscoverColumnsRequest,\n  DiscoverColumnsResponse,\n  PTableColumnId,\n  PTableColumnSpec,\n  SingleAxisSelector,\n  StringifiedJson,\n} from \"@milaboratories/pl-model-common\";\nimport type { CommonFieldTraverseOps, FieldTraversalStep, ResourceType } from \"./traversal_ops\";\nimport type {\n  ArchiveFormat,\n  AnyFunction,\n  Option,\n  PColumn,\n  PColumnValues,\n  PFrameDef,\n  PFrameHandle,\n  PObject,\n  PObjectSpec,\n  PSpecPredicate,\n  PTableDef,\n  PTableDefV2,\n  PTableHandle,\n  ResultCollection,\n  ValueOrError,\n  DataInfo,\n  RangeBytes,\n  PColumnSpec,\n} from \"@milaboratories/pl-model-common\";\nimport type { TreeNodeAccessor } from \"./accessor\";\n\nexport const StagingAccessorName = \"staging\";\nexport const MainAccessorName = \"main\";\n\nexport type AccessorHandle = Branded<string, \"AccessorHandle\">;\nexport type FutureHandle = Branded<string, \"FutureHandle\">;\n\nexport type PColumnDataUniversal<TreeEntry = TreeNodeAccessor> =\n  | TreeEntry\n  | DataInfo<TreeEntry>\n  | PColumnValues;\n\nexport interface GlobalCfgRenderCtxMethods<AHandle = AccessorHandle, FHandle = FutureHandle> {\n  //\n  // Root accessor creation\n  //\n\n  getAccessorHandleByName(name: string): AHandle | undefined;\n\n  //\n  // Basic resource accessor actions\n  //\n\n  resolveWithCommon(\n    handle: AHandle,\n    commonOptions: CommonFieldTraverseOps,\n    ...steps: (FieldTraversalStep | string)[]\n  ): AHandle | undefined;\n\n  getResourceType(handle: AHandle): ResourceType;\n\n  getInputsLocked(handle: AHandle): boolean;\n\n  getOutputsLocked(handle: AHandle): boolean;\n\n  getIsReadyOrError(handle: AHandle): boolean;\n\n  getIsFinal(handle: AHandle): boolean;\n\n  getError(handle: AHandle): AHandle | undefined;\n\n  listInputFields(handle: AHandle): string[];\n\n  listOutputFields(handle: AHandle): string[];\n\n  listDynamicFields(handle: AHandle): string[];\n\n  getKeyValueBase64(handle: AHandle, key: string): string | undefined;\n\n  getKeyValueAsString(handle: AHandle, key: string): string | undefined;\n\n  getDataBase64(handle: AHandle): string | undefined;\n\n  getDataAsString(handle: AHandle): string | undefined;\n\n  /** If not final returns undefined */\n  parsePObjectCollection(\n    handle: AHandle,\n    errorOnUnknownField: boolean,\n    prefix: string,\n    ...resolvePath: string[]\n  ): Record<string, PObject<AHandle>> | undefined;\n\n  //\n  // Blob\n  //\n\n  getBlobContentAsBase64(handle: AHandle, range?: RangeBytes): FHandle; // string | undefined\n\n  getBlobContentAsString(handle: AHandle, range?: RangeBytes): FHandle; // string | undefined\n\n  getDownloadedBlobContentHandle(handle: AHandle): FHandle; // LocalBlobHandleAndSize | undefined;\n\n  getOnDemandBlobContentHandle(handle: AHandle): FHandle; // RemoteBlobHandleAndSize | undefined;\n\n  //\n  // Blobs to URLs\n  //\n\n  extractArchiveAndGetURL(handle: AHandle, format: ArchiveFormat): FHandle;\n\n  //\n  // Import progress\n  //\n\n  getImportProgress(handle: AHandle): FHandle; // ImportProgress;\n\n  //\n  // Logs\n  //\n\n  getLastLogs(handle: AHandle, nLines: number): FHandle; // string | undefined;\n\n  getProgressLog(handle: AHandle, patternToSearch: string): FHandle; // string | undefined;\n\n  getProgressLogWithInfo(handle: AHandle, patternToSearch: string): FHandle; // ProgressLogWithInfo | undefined;\n\n  getLogHandle(handle: AHandle): FHandle; // AnyLogHandle | undefined;\n\n  //\n  // Blocks\n  //\n\n  /** @deprecated at some point will stop working and will return dummy values */\n  getBlockLabel(blockId: string): string;\n\n  //\n  // Result Pool\n  //\n\n  getDataFromResultPool(): ResultCollection<PObject<AHandle>>;\n\n  getDataWithErrorsFromResultPool(): ResultCollection<\n    Optional<PObject<ValueOrError<AHandle, Error>>, \"id\">\n  >;\n\n  getSpecsFromResultPool(): ResultCollection<PObjectSpec>;\n\n  getSpecFromResultPoolByRef(blockId: string, exportName: string): PObjectSpec | undefined;\n\n  getDataFromResultPoolByRef(blockId: string, exportName: string): PObject<AHandle> | undefined;\n\n  calculateOptions(predicate: PSpecPredicate): Option[];\n\n  //\n  // PFrame / PTable\n  //\n\n  createPFrame(def: PFrameDef<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>): PFrameHandle;\n\n  createPTable(def: PTableDef<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>): PTableHandle;\n\n  createPTableV2(\n    def: PTableDefV2<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>,\n  ): PTableHandle;\n\n  //\n  // Spec Frames (synchronous WASM-based PFrame for spec-level operations)\n  //\n\n  createSpecFrame(specs: Record<string, PColumnSpec>): string;\n\n  specFrameDiscoverColumns(\n    handle: string,\n    request: DiscoverColumnsRequest,\n  ): DiscoverColumnsResponse;\n\n  disposeSpecFrame(handle: string): void;\n\n  /** Expand index-based parentAxes in AxesSpec to resolved AxisId parents in AxesId. */\n  expandAxes(spec: AxesSpec): AxesId;\n\n  /** Collapse resolved AxisId parents back to index-based parentAxes in AxesSpec. */\n  collapseAxes(ids: AxesId): AxesSpec;\n\n  /** Find the index of an axis matching the given selector. Returns -1 if not found. */\n  findAxis(spec: AxesSpec, selector: SingleAxisSelector): number;\n\n  /** Find the flat index of a table column matching the given selector. Returns -1 if not found. */\n  findTableColumn(tableSpec: PTableColumnSpec[], selector: PTableColumnId): number;\n\n  //\n  // Computable\n  //\n\n  getCurrentUnstableMarker(): string | undefined;\n\n  //\n  // Logging\n  //\n\n  logInfo(message: string): void;\n\n  logWarn(message: string): void;\n\n  logError(message: string): void;\n}\n\nexport const GlobalCfgRenderCtxFeatureFlags = {\n  explicitColumnsSupport: true as const,\n  inlineColumnsSupport: true as const,\n  activeArgs: true as const,\n  pTablePartitionFiltersSupport: true as const,\n  pFrameInSetFilterSupport: true as const,\n};\n\nexport interface GlobalCfgRenderCtx extends GlobalCfgRenderCtxMethods {\n  //\n  // State: Args, UI State, Active Args\n  //\n  // Old runtime injects these values as strings, new runtime injects them as functions\n  // that return strings, if block declares supportsLazyState flag.\n  // If function not called in lazy state API, then resulting output will not depend on these values,\n  // and thus will not be recalculated on corresponding state change.\n  //\n\n  readonly args: string | (() => string);\n  /** @deprecated Use `data` instead. Optional for backward compatibility - falls back to `data` if not injected. */\n  readonly uiState?: string | (() => string);\n  readonly data: string | (() => string);\n  readonly activeArgs: undefined | string | (() => string | undefined);\n\n  readonly blockStorage: () => StringifiedJson;\n\n  // Note: strings below are used because, anyway, using strings is the only way\n  // to get data inside the QuickJS context, as it is implemented now. With this\n  // approach deserialization can be lazily postponed until it is actually needed.\n  readonly callbackRegistry: Record<string, AnyFunction>;\n  readonly featureFlags?: typeof GlobalCfgRenderCtxFeatureFlags;\n}\n\nexport type FutureAwait = {\n  __awaited_futures__: FutureHandle[];\n};\n\nexport function isFutureAwait(obj: unknown): obj is FutureAwait {\n  return typeof obj === \"object\" && obj !== null && \"__awaited_futures__\" in obj;\n}\n\nfunction addAllFutureAwaits(set: Set<string>, visited: Set<unknown>, node: unknown) {\n  if (visited.has(node)) return;\n  visited.add(node);\n\n  const type = typeof node;\n  if (type === \"object\") {\n    if (isFutureAwait(node)) node.__awaited_futures__.forEach((a) => set.add(a));\n    else if (Array.isArray(node))\n      for (const nested of node) addAllFutureAwaits(set, visited, nested);\n    else\n      for (const [, nested] of Object.entries(node as object))\n        if (nested !== node) addAllFutureAwaits(set, visited, nested);\n  }\n}\n\nexport function getAllFutureAwaits(obj: unknown): Set<string> {\n  const set = new Set<string>();\n  addAllFutureAwaits(set, new Set(), obj);\n  return set;\n}\n"],"mappings":";;;;;;;;;;AAmCA,MAAa,sBAAsB;AACnC,MAAa,mBAAmB;AAgLhC,MAAa,iCAAiC;CAC5C,wBAAwB;CACxB,sBAAsB;CACtB,YAAY;CACZ,+BAA+B;CAC/B,0BAA0B;CAC3B;AA+BD,SAAgB,cAAc,KAAkC;AAC9D,QAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,yBAAyB;;AAG7E,SAAS,mBAAmB,KAAkB,SAAuB,MAAe;AAClF,KAAI,QAAQ,IAAI,KAAK,CAAE;AACvB,SAAQ,IAAI,KAAK;AAGjB,KADa,OAAO,SACP,UACX;MAAI,cAAc,KAAK,CAAE,MAAK,oBAAoB,SAAS,MAAM,IAAI,IAAI,EAAE,CAAC;WACnE,MAAM,QAAQ,KAAK,CAC1B,MAAK,MAAM,UAAU,KAAM,oBAAmB,KAAK,SAAS,OAAO;MAEnE,MAAK,MAAM,GAAG,WAAW,OAAO,QAAQ,KAAe,CACrD,KAAI,WAAW,KAAM,oBAAmB,KAAK,SAAS,OAAO;;;AAIrE,SAAgB,mBAAmB,KAA2B;CAC5D,MAAM,sBAAM,IAAI,KAAa;AAC7B,oBAAmB,qBAAK,IAAI,KAAK,EAAE,IAAI;AACvC,QAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-sdk/model",
-  "version": "1.60.2",
+  "version": "1.61.1",
   "description": "Platforma.bio SDK / Block Model",
   "files": [
     "./dist/**/*",
@@ -30,11 +30,11 @@
     "fast-json-patch": "^3.1.1",
     "utility-types": "^3.11.0",
     "zod": "~3.23.8",
-    "@milaboratories/pl-model-common": "1.28.0",
-    "@milaboratories/pl-error-like": "1.12.9",
-    "@milaboratories/ptabler-expression-js": "1.2.1",
     "@milaboratories/helpers": "1.14.0",
-    "@milaboratories/pl-model-middle-layer": "1.15.0"
+    "@milaboratories/pl-model-common": "1.29.0",
+    "@milaboratories/pl-model-middle-layer": "1.16.0",
+    "@milaboratories/ptabler-expression-js": "1.2.2",
+    "@milaboratories/pl-error-like": "1.12.9"
   },
   "devDependencies": {
     "@vitest/coverage-istanbul": "^4.0.18",
@@ -42,9 +42,10 @@
     "typescript": "~5.9.3",
     "vitest": "^4.0.18",
     "@milaboratories/build-configs": "1.5.2",
+    "@milaboratories/pf-spec-driver": "1.1.0",
+    "@milaboratories/pf-driver": "1.2.0",
     "@milaboratories/ts-configs": "1.2.2",
-    "@milaboratories/ts-builder": "1.3.0",
-    "@milaboratories/pf-driver": "1.1.1"
+    "@milaboratories/ts-builder": "1.3.0"
   },
   "scripts": {
     "build": "ts-builder build --target node",

package/src/block_model.ts

@@ -549,11 +549,13 @@ export class BlockModelV3<
 
       // Register plugin outputs (in config pack, evaluated by middle layer)
       const outputs = model.outputs as Record<string, (ctx: PluginRenderCtx) => unknown>;
+      const { outputFlags } = model;
       for (const [outputKey, outputFn] of Object.entries(outputs)) {
         const key = pluginOutputKey(handle, outputKey);
         pluginOutputs[key] = createAndRegisterRenderLambda({
           handle: key,
           lambda: () => outputFn(new PluginRenderCtx(handle, wrappedInputs)),
+          withStatus: outputFlags[outputKey]?.withStatus,
         });
       }
     }

package/src/columns/column_collection_builder.test.ts

@@ -5,44 +5,26 @@ import type {
   SUniversalPColumnId,
 } from "@milaboratories/pl-model-common";
 import { AnchoredIdDeriver } from "@milaboratories/pl-model-common";
+import { SpecDriver } from "@milaboratories/pf-spec-driver";
 
-import { describe, expect, test } from "vitest";
+import { afterEach, describe, expect, test } from "vitest";
 import type { ColumnSnapshotProvider } from "./column_snapshot_provider";
 import type { ColumnSnapshot } from "./column_snapshot";
 import { ColumnCollectionBuilder } from "./column_collection_builder";
 
-// --- Mock SpecFrameCtx ---
+const drivers: SpecDriver[] = [];
 
 function createSpecFrameCtx() {
-  const frames = new Map<string, Record<string, PColumnSpec>>();
-  let nextId = 0;
-
-  return {
-    createSpecFrame: (specs: Record<string, PColumnSpec>) => {
-      const handle = `frame-${nextId++}`;
-      frames.set(handle, specs);
-      return handle;
-    },
-    specFrameDiscoverColumns: (handle: string, _request: any) => {
-      const specs = frames.get(handle)!;
-      return {
-        hits: Object.entries(specs).map(([columnId, spec]) => ({
-          hit: { columnId: columnId as PObjectId, spec },
-          mappingVariants: [
-            {
-              qualifications: { forQueries: [], forHit: [] },
-              distinctiveQualifications: { forQueries: [], forHit: [] },
-            },
-          ],
-        })),
-      };
-    },
-    specFrameDispose: (handle: string) => {
-      frames.delete(handle);
-    },
-  };
+  const driver = new SpecDriver();
+  drivers.push(driver);
+  return driver;
 }
 
+afterEach(() => {
+  for (const driver of drivers) driver.dispose();
+  drivers.length = 0;
+});
+
 // --- Helpers ---
 
 /** Default axis used when none specified — WASM requires at least one axis. */
@@ -173,15 +155,16 @@ describe("ColumnCollection.findColumns", () => {
     expect(collection.findColumns()).toHaveLength(2);
   });
 
-  test("exclude throws not implemented", () => {
+  test("exclude filters out matching columns", () => {
     const s1 = createSnapshot("id1", createSpec("col1"));
+    const s2 = createSnapshot("id2", createSpec("col2"));
     const builder = new ColumnCollectionBuilder(createSpecFrameCtx());
-    builder.addSource([s1]);
+    builder.addSource([s1, s2]);
 
     const collection = builder.build()!;
-    expect(() => collection.findColumns({ exclude: { name: "col1" } })).toThrow(
-      /not yet implemented/i,
-    );
+    const results = collection.findColumns({ exclude: { name: "col1" } });
+    expect(results).toHaveLength(1);
+    expect(results[0].spec.name).toBe("col2");
   });
 });
 
@@ -377,15 +360,16 @@ describe("AnchoredColumnCollection", () => {
     expect(matches[0].variants).toBeDefined();
   });
 
-  test("findColumns exclude throws not implemented", () => {
-    const snap = createSnapshot("id1", createSpec("col1", { axesSpec: [sampleAxis("sample")] }));
+  test("findColumns exclude filters out matching columns", () => {
+    const snap1 = createSnapshot("id1", createSpec("col1", { axesSpec: [sampleAxis("sample")] }));
+    const snap2 = createSnapshot("id2", createSpec("col2", { axesSpec: [sampleAxis("sample")] }));
     const builder = new ColumnCollectionBuilder(createSpecFrameCtx());
-    builder.addSource([snap]);
+    builder.addSource([snap1, snap2]);
 
     const collection = builder.build({ anchors: { main: anchorSpec } })!;
-    expect(() => collection.findColumns({ exclude: { name: "col1" } })).toThrow(
-      /not yet implemented/i,
-    );
+    const results = collection.findColumns({ exclude: { name: "col1" } });
+    expect(results).toHaveLength(1);
+    expect(results[0].column.spec.name).toBe("col2");
   });
 
   test("allowPartialColumnList with anchors tracks completeness", () => {

package/src/columns/column_collection_builder.ts

@@ -2,6 +2,7 @@ import type {
   AxisQualification,
   ColumnAxesWithQualifications,
   DiscoverColumnsConstraints,
+  DiscoverColumnsStepInfo,
   MultiColumnSelector,
   NativePObjectId,
   PColumnSpec,
@@ -23,7 +24,7 @@ import type { GlobalCfgRenderCtxMethods } from "../render/internal";
 /** Subset of render context methods needed for spec frame operations. */
 type SpecFrameCtx = Pick<
   GlobalCfgRenderCtxMethods,
-  "createSpecFrame" | "specFrameDiscoverColumns" | "specFrameDispose"
+  "createSpecFrame" | "specFrameDiscoverColumns" | "disposeSpecFrame"
 >;
 
 // --- FindColumnsOptions ---
@@ -79,6 +80,8 @@ export interface ColumnMatch {
   readonly originalId: PObjectId;
   /** Match variants — different paths/qualifications that reach this column. */
   readonly variants: MatchVariant[];
+  /** Linker steps traversed to reach this hit; empty for direct matches. */
+  readonly path: DiscoverColumnsStepInfo[];
 }
 
 /** Qualifications needed for both query (already-integrated) columns and the hit column. */
@@ -253,24 +256,23 @@ class ColumnCollectionImpl implements ColumnCollection {
   }
 
   findColumns(options?: FindColumnsOptions): ColumnSnapshot<PObjectId>[] {
-    const columnFilter = options?.include ? toMultiColumnSelectors(options.include) : [];
+    const includeColumns = options?.include ? toMultiColumnSelectors(options.include) : undefined;
+    const excludeColumns = options?.exclude ? toMultiColumnSelectors(options.exclude) : undefined;
 
     const response = this.ctx.specFrameDiscoverColumns(this.specFrameHandle, {
-      columnFilter,
+      includeColumns,
+      excludeColumns,
       axes: [],
+      maxHops: 0,
       constraints: PLAIN_CONSTRAINTS,
     });
 
     // Map hits back to snapshots
-    let results = response.hits
+    const results = response.hits
       .map((hit) => this.columns.get(hit.hit.columnId as PObjectId))
       .filter((col): col is ColumnSnapshot<PObjectId> => col !== undefined)
       .map((col) => this.toSnapshot(col));
 
-    if (options?.exclude) {
-      throw new Error("Exclude filter is not yet implemented for plain ColumnCollection");
-    }
-
     return results;
   }
 
@@ -336,16 +338,19 @@ class AnchoredColumnCollectionImpl implements AnchoredColumnCollection {
   findColumns(options?: AnchoredFindColumnsOptions): ColumnMatch[] {
     const mode = options?.mode ?? "enrichment";
     const constraints = matchingModeToConstraints(mode);
-    const columnFilter = options?.include ? toMultiColumnSelectors(options.include) : [];
+    const includeColumns = options?.include ? toMultiColumnSelectors(options.include) : undefined;
+    const excludeColumns = options?.exclude ? toMultiColumnSelectors(options.exclude) : undefined;
 
     const response = this.ctx.specFrameDiscoverColumns(this.specFrameHandle, {
-      columnFilter,
+      includeColumns,
+      excludeColumns,
       constraints,
       axes: this.anchorAxes,
+      maxHops: options?.maxHops ?? 4,
     });
 
     // Map hits back to ColumnMatch entries
-    let results = response.hits
+    const results = response.hits
       .map((hit) => {
         const origId = hit.hit.columnId as PObjectId;
         const col = this.columns.get(origId);
@@ -360,14 +365,11 @@ class AnchoredColumnCollectionImpl implements AnchoredColumnCollection {
               distinctiveQualifications: v.distinctiveQualifications,
             }),
           ),
+          path: hit.path,
         } satisfies ColumnMatch;
       })
       .filter((m): m is ColumnMatch => m !== undefined);
 
-    if (options?.exclude) {
-      throw new Error("Exclude filter is not yet implemented for AnchoredColumnCollection");
-    }
-
     return results;
   }
 

package/src/columns/column_selector.ts

@@ -1,9 +1,10 @@
 import type {
+  AxisValueType,
+  ColumnValueType,
   MultiAxisSelector,
   MultiColumnSelector,
   PColumnSpec,
   StringMatcher,
-  ValueType,
 } from "@milaboratories/pl-model-common";
 
 export type { StringMatcher } from "@milaboratories/pl-model-common";
@@ -19,7 +20,7 @@ export type RelaxedRecord = Record<string, RelaxedStringMatchers>;
 /** Relaxed axis selector — accepts plain strings where strict requires StringMatcher[]. */
 export interface RelaxedAxisSelector {
   name?: RelaxedStringMatchers;
-  type?: ValueType | ValueType[];
+  type?: AxisValueType | AxisValueType[];
   domain?: RelaxedRecord;
   contextDomain?: RelaxedRecord;
   annotations?: RelaxedRecord;
@@ -28,7 +29,7 @@ export interface RelaxedAxisSelector {
 /** Relaxed column selector — convenient hand-written form. */
 export interface RelaxedColumnSelector {
   name?: RelaxedStringMatchers;
-  type?: ValueType | ValueType[];
+  type?: ColumnValueType | ColumnValueType[];
   domain?: RelaxedRecord;
   contextDomain?: RelaxedRecord;
   annotations?: RelaxedRecord;
@@ -57,7 +58,7 @@ function normalizeRecord(input: RelaxedRecord): Record<string, StringMatcher[]>
   return result;
 }
 
-function normalizeTypes(input: ValueType | ValueType[]): ValueType[] {
+function normalizeTypes<T>(input: T | T[]): T[] {
   return Array.isArray(input) ? input : [input];
 }
 
@@ -140,7 +141,7 @@ function matchAxisSelector(
   selector: MultiAxisSelector,
 ): boolean {
   if (selector.name !== undefined && !matchStringValue(axis.name, selector.name)) return false;
-  if (selector.type !== undefined && !selector.type.includes(axis.type as ValueType)) return false;
+  if (selector.type !== undefined && !selector.type.includes(axis.type)) return false;
   if (selector.domain !== undefined && !matchRecordField(axis.domain, selector.domain))
     return false;
   if (

package/src/index.ts

@@ -36,6 +36,7 @@ export {
   PluginInstance,
   PluginModel,
   type PluginFactory,
+  type PluginDataModelVersions,
 } from "./plugin_model";
 export * from "./bconfig";
 export * from "./components";

package/src/platforma.ts

@@ -149,6 +149,6 @@ export type InferPluginData<Pl, PluginId extends string> =
  */
 export type InferPluginHandles<T extends Record<string, unknown>> = {
   readonly [K in keyof T]: T[K] extends PluginRecord<infer Data, infer Params, infer Outputs>
-    ? PluginHandle<PluginFactoryLike<Data, Params, Outputs>>
+    ? { handle: PluginHandle<PluginFactoryLike<Data, Params, Outputs>> }
     : never;
 };

package/src/plugin_model.ts

@@ -7,7 +7,7 @@
  * @module plugin_model
  */
 
-import type { BlockCodeKnownFeatureFlags } from "@milaboratories/pl-model-common";
+import type { BlockCodeKnownFeatureFlags, OutputWithStatus } from "@milaboratories/pl-model-common";
 import {
   type DataModel,
   DataModelBuilder,
@@ -79,6 +79,11 @@ type PluginChainState = {
   recoverAtIndex?: number;
 };
 
+/** Version → persisted data shape for each migration step (third generic of `PluginModel.define` when `data` is a `PluginDataModel`). */
+export type PluginDataModelVersions<
+  M extends PluginDataModel<PluginData, Record<string, unknown>, unknown>,
+> = M extends PluginDataModel<PluginData, infer Versions, unknown> ? Versions : never;
+
 /**
  * Builder for creating PluginDataModel with type-safe migrations.
  * Mirrors DataModelBuilder — same .from(), .migrate(), .recover(), .init() chain.
@@ -280,8 +285,8 @@ export class PluginInstance<
 > implements TransferTarget<Id, TransferData> {
   readonly id: Id;
   readonly transferVersion: string;
-  /** @internal */
-  readonly __transferBrand?: TransferData;
+  /** @internal Phantom for type inference of Data/Params/Outputs; never set at runtime. */
+  readonly __instanceTypes?: { data: Data; params: Params; outputs: Outputs };
   private readonly factory: PluginModelFactory<Data, Params, Outputs, any, any>;
   private readonly config: any;
 
@@ -336,6 +341,8 @@ export class PluginModel<
   readonly outputs: {
     [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];
   };
+  /** Per-output flags (e.g. withStatus) */
+  readonly outputFlags: Record<string, { withStatus: boolean }>;
   /** Feature flags declared by this plugin */
   readonly featureFlags?: BlockCodeKnownFeatureFlags;
   /** Create fresh default data. Config (if any) is captured at creation time. */
@@ -347,12 +354,14 @@ export class PluginModel<
     outputs: {
       [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];
     };
+    outputFlags: Record<string, { withStatus: boolean }>;
     featureFlags?: BlockCodeKnownFeatureFlags;
     getDefaultData: () => DataVersioned<Data>;
   }) {
     this.name = options.name;
     this.dataModel = options.dataModel;
     this.outputs = options.outputs;
+    this.outputFlags = options.outputFlags;
     this.featureFlags = options.featureFlags;
     this.getDefaultData = options.getDefaultData;
   }
@@ -372,6 +381,7 @@ export class PluginModel<
     outputs: {
       [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];
     };
+    outputFlags: Record<string, { withStatus: boolean }>;
     featureFlags?: BlockCodeKnownFeatureFlags;
     getDefaultData: () => DataVersioned<Data>;
   }): PluginModel<Data, Params, Outputs> {
@@ -485,6 +495,7 @@ class PluginModelFactory<
   readonly outputs: {
     [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];
   };
+  private readonly outputFlags: Record<string, { withStatus: boolean }>;
   private readonly featureFlags?: BlockCodeKnownFeatureFlags;
 
   private constructor(options: {
@@ -494,12 +505,14 @@ class PluginModelFactory<
     outputs: {
       [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];
     };
+    outputFlags: Record<string, { withStatus: boolean }>;
     featureFlags?: BlockCodeKnownFeatureFlags;
   }) {
     this.name = options.name;
     this.dataFn = options.dataFn;
     this.getDefaultDataFn = options.getDefaultDataFn;
     this.outputs = options.outputs;
+    this.outputFlags = options.outputFlags;
     this.featureFlags = options.featureFlags;
   }
 
@@ -517,6 +530,7 @@ class PluginModelFactory<
     outputs: {
       [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];
     };
+    outputFlags: Record<string, { withStatus: boolean }>;
     featureFlags?: BlockCodeKnownFeatureFlags;
   }): PluginModelFactory<Data, Params, Outputs, Config, Versions> {
     return new PluginModelFactory(options);
@@ -544,6 +558,7 @@ class PluginModelFactory<
       name: this.name,
       dataModel,
       outputs: this.outputs,
+      outputFlags: this.outputFlags,
       featureFlags: this.featureFlags,
       getDefaultData: getDefaultDataFn
         ? () => getDefaultDataFn(config)
@@ -584,6 +599,7 @@ class PluginModelBuilder<
   private readonly outputs: {
     [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];
   };
+  private readonly outputFlags: Record<string, { withStatus: boolean }>;
   private readonly featureFlags?: BlockCodeKnownFeatureFlags;
 
   private constructor(options: {
@@ -593,6 +609,7 @@ class PluginModelBuilder<
     outputs?: {
       [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];
     };
+    outputFlags?: Record<string, { withStatus: boolean }>;
     featureFlags?: BlockCodeKnownFeatureFlags;
   }) {
     this.name = options.name;
@@ -603,6 +620,7 @@ class PluginModelBuilder<
       ({} as {
         [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];
       });
+    this.outputFlags = options.outputFlags ?? {};
     this.featureFlags = options.featureFlags;
   }
 
@@ -620,6 +638,7 @@ class PluginModelBuilder<
     outputs?: {
       [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];
     };
+    outputFlags?: Record<string, { withStatus: boolean }>;
     featureFlags?: BlockCodeKnownFeatureFlags;
   }): PluginModelBuilder<Data, Params, Outputs, Config, Versions> {
     return new PluginModelBuilder(options);
@@ -653,6 +672,57 @@ class PluginModelBuilder<
           ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>,
         ) => (Outputs & { [P in Key]: T })[K];
       },
+      outputFlags: { ...this.outputFlags, [key]: { withStatus: false } },
+    });
+  }
+
+  /**
+   * Adds an output wrapped with status information to the plugin.
+   *
+   * The UI receives the full {@link OutputWithStatus} object instead of an unwrapped value,
+   * allowing it to distinguish between pending, success, and error states.
+   *
+   * @param key - Output name
+   * @param fn - Function that computes the output value from plugin context
+   * @returns PluginModel with the new status-wrapped output added
+   *
+   * @example
+   * .outputWithStatus('table', (ctx) => {
+   *   const pCols = ctx.params.pFrame?.getPColumns();
+   *   if (pCols === undefined) return undefined;
+   *   return createPlDataTableV2(ctx, pCols, ctx.data.tableState);
+   * })
+   */
+  outputWithStatus<const Key extends string, T>(
+    key: Key,
+    fn: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => T,
+  ): PluginModelBuilder<
+    Data,
+    Params,
+    Outputs & { [K in Key]: OutputWithStatus<T> },
+    Config,
+    Versions
+  > {
+    return new PluginModelBuilder<
+      Data,
+      Params,
+      Outputs & { [K in Key]: OutputWithStatus<T> },
+      Config,
+      Versions
+    >({
+      name: this.name,
+      dataFn: this.dataFn,
+      getDefaultDataFn: this.getDefaultDataFn,
+      featureFlags: this.featureFlags,
+      outputs: {
+        ...this.outputs,
+        [key]: fn,
+      } as {
+        [K in keyof (Outputs & { [P in Key]: OutputWithStatus<T> })]: (
+          ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>,
+        ) => (Outputs & { [P in Key]: OutputWithStatus<T> })[K];
+      },
+      outputFlags: { ...this.outputFlags, [key]: { withStatus: true } },
     });
   }
 
@@ -675,6 +745,7 @@ class PluginModelBuilder<
       dataFn: this.dataFn,
       getDefaultDataFn: this.getDefaultDataFn,
       outputs: this.outputs,
+      outputFlags: this.outputFlags,
       featureFlags: this.featureFlags,
     });
   }

package/src/render/api.ts

@@ -1,6 +1,8 @@
 import type {
   AnchoredPColumnSelector,
   AnyFunction,
+  AxesId,
+  AxesSpec,
   AxisId,
   DataInfo,
   DiscoverColumnsRequest,
@@ -17,6 +19,8 @@ import type {
   PObjectId,
   PObjectSpec,
   PSpecPredicate,
+  PTableColumnId,
+  PTableColumnSpec,
   PTableDef,
   PTableDefV2,
   PTableHandle,
@@ -25,6 +29,7 @@ import type {
   PlRef,
   ResolveAnchorsOptions,
   ResultCollection,
+  SingleAxisSelector,
   SUniversalPColumnId,
   ValueOrError,
 } from "@milaboratories/pl-model-common";
@@ -727,8 +732,24 @@ export abstract class RenderCtxBase<Args = unknown, Data = unknown> {
     return this.ctx.specFrameDiscoverColumns(handle, request);
   }
 
-  public specFrameDispose(handle: string): void {
-    this.ctx.specFrameDispose(handle);
+  public disposeSpecFrame(handle: string): void {
+    this.ctx.disposeSpecFrame(handle);
+  }
+
+  public expandAxes(spec: AxesSpec): AxesId {
+    return this.ctx.expandAxes(spec);
+  }
+
+  public collapseAxes(ids: AxesId): AxesSpec {
+    return this.ctx.collapseAxes(ids);
+  }
+
+  public findAxis(spec: AxesSpec, selector: SingleAxisSelector): number {
+    return this.ctx.findAxis(spec, selector);
+  }
+
+  public findTableColumn(tableSpec: PTableColumnSpec[], selector: PTableColumnId): number {
+    return this.ctx.findTableColumn(tableSpec, selector);
   }
 
   public getCurrentUnstableMarker(): string | undefined {
@@ -798,26 +819,28 @@ export class RenderCtxLegacy<Args = unknown, UiState = unknown> extends RenderCt
  *
  * @typeParam F - PluginFactoryLike phantom carrying data/params/outputs types
  */
-export class PluginRenderCtx<F extends PluginFactoryLike = PluginFactoryLike> {
-  private readonly ctx: GlobalCfgRenderCtx;
+export class PluginRenderCtx<F extends PluginFactoryLike = PluginFactoryLike> extends RenderCtxBase<
+  unknown,
+  InferFactoryData<F>
+> {
   private readonly handle: PluginHandle<F>;
   private readonly wrappedInputs: Record<string, () => unknown>;
 
   constructor(handle: PluginHandle<F>, wrappedInputs: Record<string, () => unknown>) {
-    this.ctx = getCfgRenderCtx();
+    super();
     this.handle = handle;
     this.wrappedInputs = wrappedInputs;
   }
 
-  private dataCache?: { v: InferFactoryData<F> };
+  private pluginDataCache?: { v: InferFactoryData<F> };
 
   /** Plugin's persistent data from blockStorage.__plugins.{pluginId}.__data */
-  public get data(): InferFactoryData<F> {
-    if (this.dataCache === undefined) {
+  public override get data(): InferFactoryData<F> {
+    if (this.pluginDataCache === undefined) {
       const raw = this.ctx.blockStorage();
-      this.dataCache = { v: getPluginData(parseJson(raw), this.handle) };
+      this.pluginDataCache = { v: getPluginData(parseJson(raw), this.handle) };
     }
-    return this.dataCache.v;
+    return this.pluginDataCache.v;
   }
 
   private paramsCache?: { v: InferFactoryParams<F> };
@@ -833,9 +856,6 @@ export class PluginRenderCtx<F extends PluginFactoryLike = PluginFactoryLike> {
     }
     return this.paramsCache.v;
   }
-
-  /** Result pool — same as block, from cfgRenderCtx methods */
-  public readonly resultPool = new ResultPool();
 }
 
 /** @deprecated Use BlockRenderCtx instead */