@platforma-sdk/model 1.61.1 → 1.62.0

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  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"}
+{"version":3,"file":"internal.js","names":[],"sources":["../../src/render/internal.ts"],"sourcesContent":["import type { Optional } from \"utility-types\";\nimport type { Branded, StringifiedJson } 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} from \"@milaboratories/pl-model-common\";\nimport type { TreeNodeAccessor } from \"./accessor\";\nimport type { ServiceDispatch } from \"@milaboratories/pl-model-common\";\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  // 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, ServiceDispatch {\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":";;;;;;;;;;AAyBA,MAAa,sBAAsB;AACnC,MAAa,mBAAmB;AAuJhC,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/dist/services/block_services.cjs

@@ -0,0 +1,18 @@
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
+
+//#region src/services/block_services.ts
+/**
+* Services required by all V3 blocks by default.
+* Edit this when a new service should be available to all blocks.
+*
+* Standalone module to avoid circular dependencies between block_model.ts
+* and service type resolution.
+*/
+const BLOCK_SERVICE_FLAGS = { requiresPFrameSpec: true };
+const blockServiceNames = (0, _milaboratories_pl_model_common.resolveRequiredServices)(BLOCK_SERVICE_FLAGS);
+
+//#endregion
+exports.BLOCK_SERVICE_FLAGS = BLOCK_SERVICE_FLAGS;
+exports.blockServiceNames = blockServiceNames;
+//# sourceMappingURL=block_services.cjs.map

package/dist/services/block_services.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_services.cjs","names":[],"sources":["../../src/services/block_services.ts"],"sourcesContent":["import type { ServiceRequireFlags } from \"@milaboratories/pl-model-common\";\nimport { resolveRequiredServices } from \"@milaboratories/pl-model-common\";\n\n/**\n * Services required by all V3 blocks by default.\n * Edit this when a new service should be available to all blocks.\n *\n * Standalone module to avoid circular dependencies between block_model.ts\n * and service type resolution.\n */\nexport const BLOCK_SERVICE_FLAGS = {\n  requiresPFrameSpec: true,\n} as const satisfies Partial<ServiceRequireFlags>;\n\nexport type BlockServiceFlags = typeof BLOCK_SERVICE_FLAGS;\n\nexport const blockServiceNames = resolveRequiredServices(BLOCK_SERVICE_FLAGS);\n"],"mappings":";;;;;;;;;;;AAUA,MAAa,sBAAsB,EACjC,oBAAoB,MACrB;AAID,MAAa,iFAA4C,oBAAoB"}

package/dist/services/block_services.d.ts

@@ -0,0 +1,18 @@
+import * as _milaboratories_pl_model_common0 from "@milaboratories/pl-model-common";
+
+//#region src/services/block_services.d.ts
+/**
+ * Services required by all V3 blocks by default.
+ * Edit this when a new service should be available to all blocks.
+ *
+ * Standalone module to avoid circular dependencies between block_model.ts
+ * and service type resolution.
+ */
+declare const BLOCK_SERVICE_FLAGS: {
+  readonly requiresPFrameSpec: true;
+};
+type BlockServiceFlags = typeof BLOCK_SERVICE_FLAGS;
+declare const blockServiceNames: _milaboratories_pl_model_common0.ServiceName[];
+//#endregion
+export { BLOCK_SERVICE_FLAGS, BlockServiceFlags, blockServiceNames };
+//# sourceMappingURL=block_services.d.ts.map

package/dist/services/block_services.js

@@ -0,0 +1,16 @@
+import { resolveRequiredServices } from "@milaboratories/pl-model-common";
+
+//#region src/services/block_services.ts
+/**
+* Services required by all V3 blocks by default.
+* Edit this when a new service should be available to all blocks.
+*
+* Standalone module to avoid circular dependencies between block_model.ts
+* and service type resolution.
+*/
+const BLOCK_SERVICE_FLAGS = { requiresPFrameSpec: true };
+const blockServiceNames = resolveRequiredServices(BLOCK_SERVICE_FLAGS);
+
+//#endregion
+export { BLOCK_SERVICE_FLAGS, blockServiceNames };
+//# sourceMappingURL=block_services.js.map

package/dist/services/block_services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_services.js","names":[],"sources":["../../src/services/block_services.ts"],"sourcesContent":["import type { ServiceRequireFlags } from \"@milaboratories/pl-model-common\";\nimport { resolveRequiredServices } from \"@milaboratories/pl-model-common\";\n\n/**\n * Services required by all V3 blocks by default.\n * Edit this when a new service should be available to all blocks.\n *\n * Standalone module to avoid circular dependencies between block_model.ts\n * and service type resolution.\n */\nexport const BLOCK_SERVICE_FLAGS = {\n  requiresPFrameSpec: true,\n} as const satisfies Partial<ServiceRequireFlags>;\n\nexport type BlockServiceFlags = typeof BLOCK_SERVICE_FLAGS;\n\nexport const blockServiceNames = resolveRequiredServices(BLOCK_SERVICE_FLAGS);\n"],"mappings":";;;;;;;;;;AAUA,MAAa,sBAAsB,EACjC,oBAAoB,MACrB;AAID,MAAa,oBAAoB,wBAAwB,oBAAoB"}

package/dist/services/index.cjs

@@ -0,0 +1,2 @@
+const require_block_services = require('./block_services.cjs');
+const require_service_bridge = require('./service_bridge.cjs');

package/dist/services/index.d.ts

@@ -0,0 +1,3 @@
+import { BLOCK_SERVICE_FLAGS, BlockServiceFlags, blockServiceNames } from "./block_services.js";
+import { BlockDefaultModelServices, BlockDefaultUiServices, ModelServices, ResolveModelServices, ResolveUiServices, UiServices } from "./service_resolve.js";
+import { NodeServiceProxy, buildServices, createNodeServiceProxy } from "./service_bridge.js";

package/dist/services/index.js

@@ -0,0 +1,2 @@
+import { BLOCK_SERVICE_FLAGS, blockServiceNames } from "./block_services.js";
+import { buildServices, createNodeServiceProxy } from "./service_bridge.js";

package/dist/services/service_bridge.cjs

@@ -0,0 +1,35 @@
+
+//#region src/services/service_bridge.ts
+/**
+* Builds a lazy services object from ServiceDispatch and UiServiceRegistry.
+* Each service is instantiated on first access. Errors are cached to prevent
+* repeated factory calls on failure.
+*/
+function buildServices(dispatch, registry) {
+	return Object.create(null, Object.fromEntries(dispatch.getServiceNames().map((id) => {
+		let fetched = false;
+		let cached;
+		return [id, {
+			enumerable: true,
+			get() {
+				if (!fetched) {
+					fetched = true;
+					cached = registry.get(id);
+				}
+				return cached;
+			}
+		}];
+	})));
+}
+/**
+* Builds a NodeServiceProxy from a ServiceDispatch.
+* Each service method call is forwarded to dispatch.callServiceMethod.
+*/
+function createNodeServiceProxy(dispatch) {
+	return ((serviceId) => Object.freeze(Object.fromEntries(dispatch.getServiceMethods(serviceId).map((method) => [method, async (...args) => dispatch.callServiceMethod(serviceId, method, ...args)]))));
+}
+
+//#endregion
+exports.buildServices = buildServices;
+exports.createNodeServiceProxy = createNodeServiceProxy;
+//# sourceMappingURL=service_bridge.cjs.map

package/dist/services/service_bridge.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service_bridge.cjs","names":[],"sources":["../../src/services/service_bridge.ts"],"sourcesContent":["/**\n * Runtime service bridge — builds lazy service objects from dispatch + registry.\n * Used by the UI layer to provide typed service access.\n */\n\nimport type {\n  ServiceTypesLike,\n  InferServiceUi,\n  ServiceName,\n  ServiceDispatch,\n  UiServices as AllUiServices,\n} from \"@milaboratories/pl-model-common\";\nimport { UiServiceRegistry } from \"@milaboratories/pl-model-common\";\n\n// Makes a remote node service appear local.\n// Given a service ID, returns an object implementing the service's UI interface.\n// Provided by the desktop app (e.g. backed by Electron IPC).\nexport type NodeServiceProxy = <S extends ServiceTypesLike>(\n  serviceId: ServiceName<S>,\n) => InferServiceUi<S>;\n\n/**\n * Builds a lazy services object from ServiceDispatch and UiServiceRegistry.\n * Each service is instantiated on first access. Errors are cached to prevent\n * repeated factory calls on failure.\n */\nexport function buildServices<S extends Partial<AllUiServices> = Partial<AllUiServices>>(\n  dispatch: ServiceDispatch,\n  registry: UiServiceRegistry,\n): S {\n  return Object.create(\n    null,\n    Object.fromEntries(\n      dispatch.getServiceNames().map((id) => {\n        let fetched = false;\n        let cached: unknown;\n        return [\n          id,\n          {\n            enumerable: true,\n            get() {\n              if (!fetched) {\n                fetched = true;\n                cached = registry.get(id);\n              }\n              return cached;\n            },\n          },\n        ];\n      }),\n    ),\n  );\n}\n\n/**\n * Builds a NodeServiceProxy from a ServiceDispatch.\n * Each service method call is forwarded to dispatch.callServiceMethod.\n */\nexport function createNodeServiceProxy(dispatch: ServiceDispatch): NodeServiceProxy {\n  return ((serviceId: ServiceName) =>\n    Object.freeze(\n      Object.fromEntries(\n        dispatch\n          .getServiceMethods(serviceId)\n          .map((method) => [\n            method,\n            async (...args: unknown[]) => dispatch.callServiceMethod(serviceId, method, ...args),\n          ]),\n      ),\n    )) as NodeServiceProxy;\n}\n"],"mappings":";;;;;;;AA0BA,SAAgB,cACd,UACA,UACG;AACH,QAAO,OAAO,OACZ,MACA,OAAO,YACL,SAAS,iBAAiB,CAAC,KAAK,OAAO;EACrC,IAAI,UAAU;EACd,IAAI;AACJ,SAAO,CACL,IACA;GACE,YAAY;GACZ,MAAM;AACJ,QAAI,CAAC,SAAS;AACZ,eAAU;AACV,cAAS,SAAS,IAAI,GAAG;;AAE3B,WAAO;;GAEV,CACF;GACD,CACH,CACF;;;;;;AAOH,SAAgB,uBAAuB,UAA6C;AAClF,UAAS,cACP,OAAO,OACL,OAAO,YACL,SACG,kBAAkB,UAAU,CAC5B,KAAK,WAAW,CACf,QACA,OAAO,GAAG,SAAoB,SAAS,kBAAkB,WAAW,QAAQ,GAAG,KAAK,CACrF,CAAC,CACL,CACF"}

package/dist/services/service_bridge.d.ts

@@ -0,0 +1,18 @@
+import { InferServiceUi, ServiceDispatch, ServiceName, ServiceTypesLike, UiServiceRegistry, UiServices } from "@milaboratories/pl-model-common";
+
+//#region src/services/service_bridge.d.ts
+type NodeServiceProxy = <S extends ServiceTypesLike>(serviceId: ServiceName<S>) => InferServiceUi<S>;
+/**
+ * Builds a lazy services object from ServiceDispatch and UiServiceRegistry.
+ * Each service is instantiated on first access. Errors are cached to prevent
+ * repeated factory calls on failure.
+ */
+declare function buildServices<S extends Partial<UiServices> = Partial<UiServices>>(dispatch: ServiceDispatch, registry: UiServiceRegistry): S;
+/**
+ * Builds a NodeServiceProxy from a ServiceDispatch.
+ * Each service method call is forwarded to dispatch.callServiceMethod.
+ */
+declare function createNodeServiceProxy(dispatch: ServiceDispatch): NodeServiceProxy;
+//#endregion
+export { NodeServiceProxy, buildServices, createNodeServiceProxy };
+//# sourceMappingURL=service_bridge.d.ts.map

package/dist/services/service_bridge.js

@@ -0,0 +1,33 @@
+//#region src/services/service_bridge.ts
+/**
+* Builds a lazy services object from ServiceDispatch and UiServiceRegistry.
+* Each service is instantiated on first access. Errors are cached to prevent
+* repeated factory calls on failure.
+*/
+function buildServices(dispatch, registry) {
+	return Object.create(null, Object.fromEntries(dispatch.getServiceNames().map((id) => {
+		let fetched = false;
+		let cached;
+		return [id, {
+			enumerable: true,
+			get() {
+				if (!fetched) {
+					fetched = true;
+					cached = registry.get(id);
+				}
+				return cached;
+			}
+		}];
+	})));
+}
+/**
+* Builds a NodeServiceProxy from a ServiceDispatch.
+* Each service method call is forwarded to dispatch.callServiceMethod.
+*/
+function createNodeServiceProxy(dispatch) {
+	return ((serviceId) => Object.freeze(Object.fromEntries(dispatch.getServiceMethods(serviceId).map((method) => [method, async (...args) => dispatch.callServiceMethod(serviceId, method, ...args)]))));
+}
+
+//#endregion
+export { buildServices, createNodeServiceProxy };
+//# sourceMappingURL=service_bridge.js.map

package/dist/services/service_bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service_bridge.js","names":[],"sources":["../../src/services/service_bridge.ts"],"sourcesContent":["/**\n * Runtime service bridge — builds lazy service objects from dispatch + registry.\n * Used by the UI layer to provide typed service access.\n */\n\nimport type {\n  ServiceTypesLike,\n  InferServiceUi,\n  ServiceName,\n  ServiceDispatch,\n  UiServices as AllUiServices,\n} from \"@milaboratories/pl-model-common\";\nimport { UiServiceRegistry } from \"@milaboratories/pl-model-common\";\n\n// Makes a remote node service appear local.\n// Given a service ID, returns an object implementing the service's UI interface.\n// Provided by the desktop app (e.g. backed by Electron IPC).\nexport type NodeServiceProxy = <S extends ServiceTypesLike>(\n  serviceId: ServiceName<S>,\n) => InferServiceUi<S>;\n\n/**\n * Builds a lazy services object from ServiceDispatch and UiServiceRegistry.\n * Each service is instantiated on first access. Errors are cached to prevent\n * repeated factory calls on failure.\n */\nexport function buildServices<S extends Partial<AllUiServices> = Partial<AllUiServices>>(\n  dispatch: ServiceDispatch,\n  registry: UiServiceRegistry,\n): S {\n  return Object.create(\n    null,\n    Object.fromEntries(\n      dispatch.getServiceNames().map((id) => {\n        let fetched = false;\n        let cached: unknown;\n        return [\n          id,\n          {\n            enumerable: true,\n            get() {\n              if (!fetched) {\n                fetched = true;\n                cached = registry.get(id);\n              }\n              return cached;\n            },\n          },\n        ];\n      }),\n    ),\n  );\n}\n\n/**\n * Builds a NodeServiceProxy from a ServiceDispatch.\n * Each service method call is forwarded to dispatch.callServiceMethod.\n */\nexport function createNodeServiceProxy(dispatch: ServiceDispatch): NodeServiceProxy {\n  return ((serviceId: ServiceName) =>\n    Object.freeze(\n      Object.fromEntries(\n        dispatch\n          .getServiceMethods(serviceId)\n          .map((method) => [\n            method,\n            async (...args: unknown[]) => dispatch.callServiceMethod(serviceId, method, ...args),\n          ]),\n      ),\n    )) as NodeServiceProxy;\n}\n"],"mappings":";;;;;;AA0BA,SAAgB,cACd,UACA,UACG;AACH,QAAO,OAAO,OACZ,MACA,OAAO,YACL,SAAS,iBAAiB,CAAC,KAAK,OAAO;EACrC,IAAI,UAAU;EACd,IAAI;AACJ,SAAO,CACL,IACA;GACE,YAAY;GACZ,MAAM;AACJ,QAAI,CAAC,SAAS;AACZ,eAAU;AACV,cAAS,SAAS,IAAI,GAAG;;AAE3B,WAAO;;GAEV,CACF;GACD,CACH,CACF;;;;;;AAOH,SAAgB,uBAAuB,UAA6C;AAClF,UAAS,cACP,OAAO,OACL,OAAO,YACL,SACG,kBAAkB,UAAU,CAC5B,KAAK,WAAW,CACf,QACA,OAAO,GAAG,SAAoB,SAAS,kBAAkB,WAAW,QAAQ,GAAG,KAAK,CACrF,CAAC,CACL,CACF"}

package/dist/services/service_resolve.d.ts

@@ -0,0 +1,13 @@
+import { BlockServiceFlags } from "./block_services.js";
+import { ModelServices as ModelServices$1, ServiceNameLiterals, UiServices as UiServices$1 } from "@milaboratories/pl-model-common";
+
+//#region src/services/service_resolve.d.ts
+type FlagToName<Flag extends string> = Flag extends `requires${infer K}` ? K extends keyof ServiceNameLiterals ? ServiceNameLiterals[K] : never : never;
+type RequiredServiceNames<Flags> = { [K in keyof Flags & `requires${string}`]: Flags[K] extends true ? FlagToName<K & string> : never }[keyof Flags & `requires${string}`];
+type ResolveModelServices<Flags> = Pick<ModelServices$1, RequiredServiceNames<Flags> & keyof ModelServices$1>;
+type ResolveUiServices<Flags> = Pick<UiServices$1, RequiredServiceNames<Flags> & keyof UiServices$1>;
+type BlockDefaultModelServices = ResolveModelServices<BlockServiceFlags>;
+type BlockDefaultUiServices = ResolveUiServices<BlockServiceFlags>;
+//#endregion
+export { BlockDefaultModelServices, BlockDefaultUiServices, type ModelServices$1 as ModelServices, ResolveModelServices, ResolveUiServices, type UiServices$1 as UiServices };
+//# sourceMappingURL=service_resolve.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-sdk/model",
-  "version": "1.61.1",
+  "version": "1.62.0",
   "description": "Platforma.bio SDK / Block Model",
   "files": [
     "./dist/**/*",
@@ -31,10 +31,10 @@
     "utility-types": "^3.11.0",
     "zod": "~3.23.8",
     "@milaboratories/helpers": "1.14.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"
+    "@milaboratories/pl-model-common": "1.30.0",
+    "@milaboratories/pl-model-middle-layer": "1.16.1",
+    "@milaboratories/pl-error-like": "1.12.9",
+    "@milaboratories/ptabler-expression-js": "1.2.3"
   },
   "devDependencies": {
     "@vitest/coverage-istanbul": "^4.0.18",
@@ -42,10 +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-spec-driver": "1.2.0",
+    "@milaboratories/ts-builder": "1.3.0",
+    "@milaboratories/pf-driver": "1.3.0",
+    "@milaboratories/ts-configs": "1.2.2"
   },
   "scripts": {
     "build": "ts-builder build --target node",

package/src/block_model.ts

@@ -6,9 +6,12 @@ import type {
   BlockCodeKnownFeatureFlags,
   BlockConfigContainer,
 } from "@milaboratories/pl-model-common";
+import { resolveRequiredServices } from "@milaboratories/pl-model-common";
 import { getPlatformaInstance, isInUI, createAndRegisterRenderLambda } from "./internal";
 import type { DataModel } from "./block_migrations";
 import type { PlatformaV3 } from "./platforma";
+import type { BlockDefaultUiServices } from "./services/service_resolve";
+import { blockServiceNames, BLOCK_SERVICE_FLAGS } from "./services/block_services";
 import type { InferRenderFunctionReturn, RenderFunction } from "./render";
 import { BlockRenderCtx, PluginRenderCtx } from "./render";
 import type { PluginData, PluginModel, PluginOutputs, PluginParams } from "./plugin_model";
@@ -87,8 +90,10 @@ export type PluginRecord<
   Data extends PluginData = PluginData,
   Params extends PluginParams = undefined,
   Outputs extends PluginOutputs = PluginOutputs,
+  ModelServices = unknown,
+  UiServices = unknown,
 > = {
-  readonly model: PluginModel<Data, Params, Outputs>;
+  readonly model: PluginModel<Data, Params, Outputs, ModelServices, UiServices>;
   readonly inputs: ParamsInputErased;
 };
 
@@ -128,13 +133,17 @@ export class BlockModelV3<
     private readonly config: BlockModelV3Config<OutputsCfg, Data, Plugins, Transfers>,
   ) {}
 
-  public static readonly INITIAL_BLOCK_FEATURE_FLAGS: BlockCodeKnownFeatureFlags = {
+  public static readonly FEATURE_FLAGS = {
     supportsLazyState: true,
     supportsPframeQueryRanking: true,
     requiresUIAPIVersion: 3,
     requiresModelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,
     requiresCreatePTable: 2,
-  };
+    ...BLOCK_SERVICE_FLAGS,
+  } satisfies BlockCodeKnownFeatureFlags;
+
+  /** @deprecated Use FEATURE_FLAGS */
+  public static readonly INITIAL_BLOCK_FEATURE_FLAGS = BlockModelV3.FEATURE_FLAGS;
 
   /**
    * Creates a new BlockModelV3 builder with the specified data model.
@@ -164,7 +173,7 @@ export class BlockModelV3<
       subtitle: undefined,
       tags: undefined,
       enrichmentTargets: undefined,
-      featureFlags: { ...BlockModelV3.INITIAL_BLOCK_FEATURE_FLAGS },
+      featureFlags: { ...BlockModelV3.FEATURE_FLAGS },
       argsFunction: undefined,
       prerunArgsFunction: undefined,
       plugins: {},
@@ -228,7 +237,7 @@ export class BlockModelV3<
         ...this.config.outputs,
         [key]: createAndRegisterRenderLambda({
           handle: `block-output#${key}`,
-          lambda: () => cfgOrRf(new BlockRenderCtx<Args, Data>()),
+          lambda: () => cfgOrRf(new BlockRenderCtx<Args, Data>(blockServiceNames)),
           ...flags,
         }),
       },
@@ -324,7 +333,10 @@ export class BlockModelV3<
         ...this.config,
         // Replace the default sections callback with the user-provided one
         sections: createAndRegisterRenderLambda(
-          { handle: "sections", lambda: () => rf(new BlockRenderCtx<Args, Data>()) },
+          {
+            handle: "sections",
+            lambda: () => rf(new BlockRenderCtx<Args, Data>(blockServiceNames)),
+          },
           true,
         ),
       },
@@ -339,7 +351,7 @@ export class BlockModelV3<
       ...this.config,
       title: createAndRegisterRenderLambda({
         handle: "title",
-        lambda: () => rf(new BlockRenderCtx<Args, Data>()),
+        lambda: () => rf(new BlockRenderCtx<Args, Data>(blockServiceNames)),
       }),
     });
   }
@@ -351,7 +363,7 @@ export class BlockModelV3<
       ...this.config,
       subtitle: createAndRegisterRenderLambda({
         handle: "subtitle",
-        lambda: () => rf(new BlockRenderCtx<Args, Data>()),
+        lambda: () => rf(new BlockRenderCtx<Args, Data>(blockServiceNames)),
       }),
     });
   }
@@ -363,7 +375,7 @@ export class BlockModelV3<
       ...this.config,
       tags: createAndRegisterRenderLambda({
         handle: "tags",
-        lambda: () => rf(new BlockRenderCtx<Args, Data>()),
+        lambda: () => rf(new BlockRenderCtx<Args, Data>(blockServiceNames)),
       }),
     });
   }
@@ -418,6 +430,8 @@ export class BlockModelV3<
     PParams extends PluginParams,
     POutputs extends PluginOutputs,
     PTransferData,
+    PluginModelServices,
+    PluginUiServices,
   >(
     instance: PluginInstanceClass<
       PluginId &
@@ -432,7 +446,9 @@ export class BlockModelV3<
       PData,
       PParams,
       POutputs,
-      PTransferData
+      PTransferData,
+      PluginModelServices,
+      PluginUiServices
     >,
     params?: ParamsInput<PParams, Args, Data>,
   ): BlockModelV3<
@@ -440,7 +456,15 @@ export class BlockModelV3<
     OutputsCfg,
     Data,
     Href,
-    Plugins & { [K in PluginId]: PluginRecord<PData, PParams, POutputs> },
+    Plugins & {
+      [K in PluginId]: PluginRecord<
+        PData,
+        PParams,
+        POutputs,
+        PluginModelServices,
+        PluginUiServices
+      >;
+    },
     Omit<Transfers, PluginId>
   >;
   public plugin(
@@ -489,7 +513,14 @@ export class BlockModelV3<
   public done(
     ..._: keyof Transfers extends never ? [] : [never]
   ): PlatformaExtended<
-    PlatformaV3<Data, Args, InferOutputsFromLambdas<OutputsCfg>, Href, Plugins>
+    PlatformaV3<
+      Data,
+      Args,
+      InferOutputsFromLambdas<OutputsCfg>,
+      Href,
+      Plugins,
+      BlockDefaultUiServices
+    >
   > {
     if (this.config.argsFunction === undefined) throw new Error("Args rendering function not set.");
 
@@ -505,6 +536,8 @@ export class BlockModelV3<
 
     const { dataModel, argsFunction, prerunArgsFunction } = this.config;
 
+    const mergedServiceNames = resolveRequiredServices(this.config.featureFlags);
+
     function getPlugin(handle: PluginHandle): PluginRecord {
       const plugin = plugins[handle];
       if (!plugin) throw new Error(`Plugin model not found for '${handle}'`);
@@ -544,7 +577,7 @@ export class BlockModelV3<
       // Wrap plugin param lambdas: close over BlockRenderCtx creation
       const wrappedInputs: Record<string, () => unknown> = {};
       for (const [paramKey, paramFn] of Object.entries(inputs)) {
-        wrappedInputs[paramKey] = () => paramFn(new BlockRenderCtx());
+        wrappedInputs[paramKey] = () => paramFn(new BlockRenderCtx(mergedServiceNames));
       }
 
       // Register plugin outputs (in config pack, evaluated by middle layer)
@@ -554,7 +587,7 @@ export class BlockModelV3<
         const key = pluginOutputKey(handle, outputKey);
         pluginOutputs[key] = createAndRegisterRenderLambda({
           handle: key,
-          lambda: () => outputFn(new PluginRenderCtx(handle, wrappedInputs)),
+          lambda: () => outputFn(new PluginRenderCtx(handle, wrappedInputs, mergedServiceNames)),
           withStatus: outputFlags[outputKey]?.withStatus,
         });
       }

package/src/columns/column_collection_builder.test.ts

@@ -20,8 +20,8 @@ function createSpecFrameCtx() {
   return driver;
 }
 
-afterEach(() => {
-  for (const driver of drivers) driver.dispose();
+afterEach(async () => {
+  for (const driver of drivers) await driver.dispose();
   drivers.length = 0;
 });
 
@@ -166,6 +166,27 @@ describe("ColumnCollection.findColumns", () => {
     expect(results).toHaveLength(1);
     expect(results[0].spec.name).toBe("col2");
   });
+
+  test("include filters by exact name among disjoint-axis columns", () => {
+    const vdjAxis = sampleAxis("pl7.app/vdj/clonotypeKey");
+    const itemAxis = sampleAxis("item");
+
+    const vdjColumns = Array.from({ length: 10 }, (_, i) =>
+      createSnapshot(`vdj${i}`, createSpec(`pl7.app/vdj/col${i}`, { axesSpec: [vdjAxis] })),
+    );
+    const mockScore = createSnapshot("mock", createSpec("mock_score", { axesSpec: [itemAxis] }));
+
+    const builder = new ColumnCollectionBuilder(createSpecFrameCtx());
+    builder.addSource([...vdjColumns, mockScore]);
+
+    const collection = builder.build()!;
+    const results = collection.findColumns({
+      include: [{ name: [{ type: "exact", value: "mock_score" }] }],
+    });
+
+    expect(results).toHaveLength(1);
+    expect(results[0].spec.name).toBe("mock_score");
+  });
 });
 
 describe("dedup by native ID", () => {