@platforma-sdk/model 1.79.24 → 1.80.0

package/dist/columns/column_recipes/types.d.ts

@@ -0,0 +1,101 @@
+import { ColumnUniversalId, PColumnSpec, PObjectId, SpecOverrides, SpecQuery as SpecQuery$1 } from "@milaboratories/pl-model-common";
+
+//#region src/columns/column_recipes/types.d.ts
+/**
+ * Stable identifier of a recipe: either the canonical {@link PObjectId} of a
+ * leaf or a {@link ColumnUniversalId} encoding `Overridden / Discovered /
+ * Filtered` layers on top of it.
+ *
+ * Recipes are equivalent as value-objects iff their `id`s match (structurally,
+ * after canonicalization).
+ */
+type ColumnRecipeId = ColumnUniversalId;
+/**
+ * Aggregate data status of a recipe: the "worst" status across every
+ * PObjectId the recipe references (the leaf itself plus any refs inside
+ * overrides/discovery).
+ *
+ * "All or nothing" semantics: spec/query built from a recipe are meaningful
+ * only when every referenced column is `present`.
+ */
+type ColumnFieldStatus = "resolving" | "absent" | "present";
+/**
+ * Resolution status of a recipe — whether the recipe is meaningful in the
+ * active render ctx. Aggregates spec readiness (the recipe can be
+ * constructed/used) and data readiness (the underlying leaves can be read).
+ *
+ *  - `present`:  spec + data readable end-to-end.
+ *  - `resolving`: more accessor inputs may still arrive — recheck later.
+ *  - `absent`:   every relevant accessor is `inputsLocked`; nothing more will
+ *                appear. Used at boundaries to throw early instead of silently
+ *                producing an empty/broken recipe.
+ *
+ * Distinct from {@link ColumnFieldStatus}: that one is the leaf's data field
+ * status only. {@link ColumnResolutionStatus} also folds in spec/registry
+ * readiness, so the recipe interface exposes both.
+ */
+type ColumnResolutionStatus = "present" | "resolving" | "absent";
+/**
+ * Base contract of a column recipe — an immutable description of HOW to
+ * obtain a column, not the column itself.
+ *
+ * A recipe is a value-object. The only transformation exposed via the
+ * interface is {@link withSpecs}: it overlays overrides on the spec.
+ * `withDiscovery` / `withAxisFilters` are intentionally absent — discovered
+ * and filtered recipes are built only via their own factory constructors
+ * from a leaf recipe; nothing further can be stacked on top of Discovered
+ * or Filtered.
+ *
+ * Invariant: `withSpecs` never nests. A recipe is either bare or wrapped
+ * in exactly one Overridden layer. Repeated `withSpecs` merges the new
+ * overrides into the existing ones, keeping the same depth.
+ *
+ * A recipe intentionally exposes no `getSpecOverrides / getDiscovery /
+ * getAxisFilters` getters: those encoding pieces are details of the id.
+ * Consumers that need to decompose call utilities from `pl-model-common`
+ * over `recipe.id`.
+ */
+interface ColumnRecipe<ID extends ColumnRecipeId = ColumnRecipeId> {
+  /** Canonical recipe identifier. */
+  readonly id: ID;
+  /** PObjectIds referenced by this recipe (leaf + any nested refs). */
+  getReferencedIds(): PObjectId[];
+  /**
+   * Final spec — built via `pframespec` from id + base spec of the source.
+   * No partial JS logic: the result matches what the engine returns when
+   * executing {@link getQuery}.
+   *
+   * Always returns a value: the recipe factories validate all referenced
+   * specs at construction time and return `undefined` from the factory if
+   * anything is missing. A constructed recipe is by contract spec-complete.
+   */
+  getSpec(): PColumnSpec;
+  /**
+   * IR describing how to obtain the column — a {@link SpecQuery} from
+   * `pl-model-common`. The recipe builds the description; execution belongs
+   * to the layer above (pframespec/engine).
+   *
+   * The return is parameterized with default `C = PObjectId`. Concrete
+   * recipes may narrow the parameter (e.g. `SpecQuery<ColumnRecipeId>`) if
+   * they need to thread nested id variants.
+   */
+  getQuery(): SpecQuery$1;
+  /**
+   * Aggregate status across ALL PObjectIds this recipe reaches: own leaf +
+   * refs from overrides + the parent chain of discovery.
+   *
+   * Rule: `absent ▸ resolving ▸ present` ("worst wins").
+   */
+  getDataStatus(): ColumnFieldStatus;
+  /**
+   * Apply overrides on the spec. Always returns a new recipe.
+   *
+   * Flat-merge invariant: if `self` is already Overridden, the implementation
+   * merges `overrides` with the existing ones and returns the same depth
+   * (one Overridden wrapper). No `Overridden<Overridden<...>>`.
+   */
+  withSpecs(overrides: SpecOverrides): ColumnRecipe;
+}
+//#endregion
+export { ColumnFieldStatus, ColumnRecipe, ColumnRecipeId, ColumnResolutionStatus, type SpecQuery$1 as SpecQuery };
+//# sourceMappingURL=types.d.ts.map

package/dist/columns/column_recipes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/columns/column_recipes/types.ts"],"mappings":";;;;AAkBA;;;;AAA8C;AAU9C;;KAVY,cAAA,GAAiB,iBAAiB;;AAUjB;AAiB7B;;;;AAAkC;AAsBlC;KAvCY,iBAAA;;;;;;;;;;;;;;;;KAiBA,sBAAA;;;;;;;;;;;;;;;AAkEuC;;;;;;UA5ClC,YAAA,YAAwB,cAAA,GAAiB,cAAA;;WAE/C,EAAA,EAAI,EAAA;;EAGb,gBAAA,IAAoB,SAAA;;;;;;;;;;EAWpB,OAAA,IAAW,WAAA;;;;;;;;;;EAWX,QAAA,IAAY,WAAA;;;;;;;EAQZ,aAAA,IAAiB,iBAAA;;;;;;;;EASjB,SAAA,CAAU,SAAA,EAAW,aAAA,GAAgB,YAAA;AAAA"}

package/dist/columns/columns_collection.cjs

@@ -0,0 +1,124 @@
+const require_internal = require("../internal.cjs");
+const require_accessor = require("../render/accessor.cjs");
+const require_internal$1 = require("../render/internal.cjs");
+const require_get_services = require("../services/get_services.cjs");
+const require_index = require("./column_recipes/index.cjs");
+const require_index$1 = require("./column_providers/index.cjs");
+let es_toolkit = require("es-toolkit");
+//#region src/columns/columns_collection.ts
+/**
+* Build a {@link ColumnsCollection} from sandbox-side source descriptors.
+* Resolves the `columnsCollection` driver (either from `deps.driver` or via
+* `getService("columnsCollection")`) and asks the host to mint a fresh
+* handle covering the supplied sources. Pass `sources === undefined` to
+* fall back to the active render ctx (main outputs + prerun + result pool).
+*
+* `sources` accepts {@link ColumnsSourceShorthand} string literals
+* (`"result_pool"`, `"current_block"`) for the common ctx-derived sources.
+*/
+function ColumnsCollection(sources, deps) {
+	const driver = deps?.driver ?? require_get_services.getService("columnsCollection", { ctx: deps?.ctx });
+	const serialized = sources ? sources.flatMap((s) => toSerializedSources(s, deps?.ctx)) : defaultCtxSources(deps?.ctx);
+	return new ColumnsCollectionImpl(driver.create(serialized), driver);
+}
+function isColumnsCollection(value) {
+	return value instanceof ColumnsCollectionImpl;
+}
+/**
+* Sandbox proxy over the host-side `ColumnsCollection` driver. The driver
+* owns all column-set state; this object only carries an opaque
+* {@link CollectionHandle} plus a reference to the driver service.
+*
+* Construct via {@link ColumnsCollection} — the bare constructor is a
+* trivial `(handle, driver)` pair so that `addSource` / `discover` / `filter`
+* can rebind a freshly-minted handle without going through source
+* serialisation again.
+*
+* Every method returning a `ColumnsCollection` mints a fresh handle on the
+* host — the host VM bridge pins it to the active render ctx, so the sandbox
+* never has to manage refcounts.
+*/
+var ColumnsCollectionImpl = class ColumnsCollectionImpl {
+	handle;
+	driver;
+	constructor(handle, driver) {
+		this.handle = handle;
+		this.driver = driver;
+	}
+	isEmpty() {
+		return this.driver.isEmpty(this.handle);
+	}
+	isFinal() {
+		return this.driver.isFinal(this.handle);
+	}
+	getColumnIds() {
+		return this.driver.getColumns(this.handle);
+	}
+	getColumns() {
+		return this.getColumnIds().map((id) => require_index.ColumnRecipe(id)).filter((c) => !(0, es_toolkit.isNil)(c));
+	}
+	addSource(source) {
+		return new ColumnsCollectionImpl(this.driver.addSource(this.handle, toSerializedSources(source)), this.driver);
+	}
+	discover(options) {
+		return new ColumnsCollectionImpl(this.driver.discover(this.handle, options), this.driver);
+	}
+	filter(options) {
+		return new ColumnsCollectionImpl(this.driver.filter(this.handle, options), this.driver);
+	}
+};
+function toSerializedSources(source, ctx) {
+	if (source === "result_pool") return [{ kind: "result_pool" }];
+	if (source === "current_block") return currentBlockSources(ctx);
+	if (source instanceof ColumnsCollectionImpl) return [{
+		kind: "collection",
+		handle: source.handle
+	}];
+	if (source instanceof require_accessor.TreeNodeAccessor) return [{
+		kind: "accessor",
+		accessor: source.handle,
+		path: source.resolvePath
+	}];
+	if (isColumnArray(source)) return [{
+		kind: "ids",
+		ids: source.columns.map((c) => c.id),
+		isFinal: source.isFinal
+	}];
+	if (require_index$1.isColumnProvider(source)) return [{
+		kind: "ids",
+		ids: source.getColumns().map((c) => c.id),
+		isFinal: source.isFinal()
+	}];
+	throw new Error("ColumnsCollection: unrecognised ColumnsSource shape");
+}
+function isColumnArray(source) {
+	if (typeof source !== "object" || source === null) return false;
+	const s = source;
+	return Array.isArray(s.columns) && typeof s.isFinal === "boolean";
+}
+function currentBlockSources(ctx) {
+	const renderCtx = ctx ?? require_internal.getCfgRenderCtx();
+	const sources = [];
+	const outputs = renderCtx.getAccessorHandleByName(require_internal$1.MainAccessorName);
+	if (outputs !== void 0) sources.push({
+		kind: "accessor",
+		accessor: outputs,
+		path: [require_internal$1.MainAccessorName]
+	});
+	const prerun = renderCtx.getAccessorHandleByName(require_internal$1.StagingAccessorName);
+	if (prerun !== void 0) sources.push({
+		kind: "accessor",
+		accessor: prerun,
+		path: [require_internal$1.StagingAccessorName]
+	});
+	return sources;
+}
+function defaultCtxSources(ctx) {
+	return [...currentBlockSources(ctx), { kind: "result_pool" }];
+}
+//#endregion
+exports.ColumnsCollection = ColumnsCollection;
+exports.ColumnsCollectionImpl = ColumnsCollectionImpl;
+exports.isColumnsCollection = isColumnsCollection;
+
+//# sourceMappingURL=columns_collection.cjs.map

package/dist/columns/columns_collection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns_collection.cjs","names":["getService","ColumnRecipe","TreeNodeAccessor","isColumnProvider","getCfgRenderCtx","MainAccessorName","StagingAccessorName"],"sources":["../../src/columns/columns_collection.ts"],"sourcesContent":["import type {\n  CollectionHandle,\n  ColumnUniversalId,\n  ColumnsCollectionDriverModel,\n  ColumnsDiscoverOptions,\n  ColumnsFilterOptions,\n  SerializedColumnsSource,\n} from \"@milaboratories/pl-model-common\";\nimport type { GlobalCfgRenderCtx } from \"../render/internal\";\nimport { MainAccessorName, StagingAccessorName } from \"../render/internal\";\nimport type { ColumnsSource } from \"./column_providers\";\nimport { isColumnProvider } from \"./column_providers\";\nimport { TreeNodeAccessor } from \"../render/accessor\";\nimport { getService } from \"../services/get_services\";\nimport { getCfgRenderCtx } from \"../internal\";\nimport { ColumnRecipe } from \"./column_recipes\";\nimport { isNil } from \"es-toolkit\";\n\nexport interface ColumnsCollectionDeps {\n  /** Render ctx used both for service resolution and for default ctx sources. */\n  readonly ctx?: GlobalCfgRenderCtx;\n  /** Override the resolved `columnsCollection` service — primarily for tests. */\n  readonly driver?: ColumnsCollectionDriverModel;\n}\n\n/**\n * Shorthand literals accepted inside `ColumnsCollection`'s `sources`\n * array, expanded against the active render ctx:\n *\n * - `\"result_pool\"`  – fan-out into the host's upstream-block result pool.\n * - `\"current_block\"` – main outputs + prerun (staging) accessors of the\n *   current block, when present.\n */\nexport type ColumnsSourceShorthand = \"result_pool\" | \"current_block\";\n\n/**\n * Build a {@link ColumnsCollection} from sandbox-side source descriptors.\n * Resolves the `columnsCollection` driver (either from `deps.driver` or via\n * `getService(\"columnsCollection\")`) and asks the host to mint a fresh\n * handle covering the supplied sources. Pass `sources === undefined` to\n * fall back to the active render ctx (main outputs + prerun + result pool).\n *\n * `sources` accepts {@link ColumnsSourceShorthand} string literals\n * (`\"result_pool\"`, `\"current_block\"`) for the common ctx-derived sources.\n */\nexport function ColumnsCollection(\n  sources?: (ColumnsCollection | ColumnsSource | ColumnsSourceShorthand)[],\n  deps?: ColumnsCollectionDeps,\n): ColumnsCollection {\n  const driver = deps?.driver ?? getService(\"columnsCollection\", { ctx: deps?.ctx });\n  const serialized: SerializedColumnsSource[] = sources\n    ? sources.flatMap((s) => toSerializedSources(s, deps?.ctx))\n    : defaultCtxSources(deps?.ctx);\n  return new ColumnsCollectionImpl(driver.create(serialized), driver);\n}\n\nexport function isColumnsCollection(value: unknown): value is ColumnsCollection {\n  return value instanceof ColumnsCollectionImpl;\n}\n\n/**\n * Sandbox proxy over the host-side `ColumnsCollection` driver. The driver\n * owns all column-set state; this object only carries an opaque\n * {@link CollectionHandle} plus a reference to the driver service.\n *\n * Construct via {@link ColumnsCollection} — the bare constructor is a\n * trivial `(handle, driver)` pair so that `addSource` / `discover` / `filter`\n * can rebind a freshly-minted handle without going through source\n * serialisation again.\n *\n * Every method returning a `ColumnsCollection` mints a fresh handle on the\n * host — the host VM bridge pins it to the active render ctx, so the sandbox\n * never has to manage refcounts.\n */\nexport class ColumnsCollectionImpl {\n  constructor(\n    public readonly handle: CollectionHandle,\n    private readonly driver: ColumnsCollectionDriverModel,\n  ) {}\n\n  isEmpty(): boolean {\n    return this.driver.isEmpty(this.handle);\n  }\n\n  isFinal(): boolean {\n    return this.driver.isFinal(this.handle);\n  }\n\n  getColumnIds(): ColumnUniversalId[] {\n    return this.driver.getColumns(this.handle);\n  }\n\n  getColumns(): ColumnRecipe[] {\n    return this.getColumnIds()\n      .map((id) => ColumnRecipe(id))\n      .filter((c): c is ColumnRecipe => !isNil(c));\n  }\n\n  addSource(source: ColumnsSource | ColumnsCollection): ColumnsCollection {\n    return new ColumnsCollectionImpl(\n      this.driver.addSource(this.handle, toSerializedSources(source)),\n      this.driver,\n    );\n  }\n\n  discover(options: ColumnsDiscoverOptions): ColumnsCollection {\n    return new ColumnsCollectionImpl(this.driver.discover(this.handle, options), this.driver);\n  }\n\n  filter(options: ColumnsFilterOptions): ColumnsCollection {\n    return new ColumnsCollectionImpl(this.driver.filter(this.handle, options), this.driver);\n  }\n}\n\n/** Public type alias — value of the same name is the factory function above. */\nexport type ColumnsCollection = ColumnsCollectionImpl;\n\nfunction toSerializedSources(\n  source: ColumnsCollection | ColumnsSource | ColumnsSourceShorthand,\n  ctx?: GlobalCfgRenderCtx,\n): SerializedColumnsSource[] {\n  if (source === \"result_pool\") {\n    return [{ kind: \"result_pool\" }];\n  }\n  if (source === \"current_block\") {\n    return currentBlockSources(ctx);\n  }\n  if (source instanceof ColumnsCollectionImpl) {\n    return [{ kind: \"collection\", handle: source.handle }];\n  }\n  if (source instanceof TreeNodeAccessor) {\n    return [{ kind: \"accessor\", accessor: source.handle, path: source.resolvePath }];\n  }\n  if (isColumnArray(source)) {\n    return [{ kind: \"ids\", ids: source.columns.map((c) => c.id), isFinal: source.isFinal }];\n  }\n  if (isColumnProvider(source)) {\n    return [{ kind: \"ids\", ids: source.getColumns().map((c) => c.id), isFinal: source.isFinal() }];\n  }\n  throw new Error(\"ColumnsCollection: unrecognised ColumnsSource shape\");\n}\n\nfunction isColumnArray(source: unknown): source is {\n  columns: ReadonlyArray<{ id: ColumnUniversalId; spec?: unknown; data?: unknown }>;\n  isFinal: boolean;\n} {\n  if (typeof source !== \"object\" || source === null) return false;\n  const s = source as { columns?: unknown; isFinal?: unknown };\n  return Array.isArray(s.columns) && typeof s.isFinal === \"boolean\";\n}\n\nfunction currentBlockSources(ctx?: GlobalCfgRenderCtx): SerializedColumnsSource[] {\n  const renderCtx = ctx ?? getCfgRenderCtx();\n  const sources: SerializedColumnsSource[] = [];\n\n  const outputs = renderCtx.getAccessorHandleByName(MainAccessorName);\n  if (outputs !== undefined) {\n    sources.push({ kind: \"accessor\", accessor: outputs, path: [MainAccessorName] });\n  }\n  const prerun = renderCtx.getAccessorHandleByName(StagingAccessorName);\n  if (prerun !== undefined) {\n    sources.push({ kind: \"accessor\", accessor: prerun, path: [StagingAccessorName] });\n  }\n\n  return sources;\n}\n\nfunction defaultCtxSources(ctx?: GlobalCfgRenderCtx): SerializedColumnsSource[] {\n  return [...currentBlockSources(ctx), { kind: \"result_pool\" }];\n}\n"],"mappings":"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"}

package/dist/columns/columns_collection.d.ts

@@ -0,0 +1,64 @@
+import { GlobalCfgRenderCtx } from "../render/internal.js";
+import { ColumnRecipe } from "./column_recipes/index.js";
+import { ColumnsSource } from "./column_providers/types.js";
+import { CollectionHandle, ColumnUniversalId, ColumnsCollectionDriverModel, ColumnsDiscoverOptions, ColumnsFilterOptions } from "@milaboratories/pl-model-common";
+
+//#region src/columns/columns_collection.d.ts
+interface ColumnsCollectionDeps {
+  /** Render ctx used both for service resolution and for default ctx sources. */
+  readonly ctx?: GlobalCfgRenderCtx;
+  /** Override the resolved `columnsCollection` service — primarily for tests. */
+  readonly driver?: ColumnsCollectionDriverModel;
+}
+/**
+ * Shorthand literals accepted inside `ColumnsCollection`'s `sources`
+ * array, expanded against the active render ctx:
+ *
+ * - `"result_pool"`  – fan-out into the host's upstream-block result pool.
+ * - `"current_block"` – main outputs + prerun (staging) accessors of the
+ *   current block, when present.
+ */
+type ColumnsSourceShorthand = "result_pool" | "current_block";
+/**
+ * Build a {@link ColumnsCollection} from sandbox-side source descriptors.
+ * Resolves the `columnsCollection` driver (either from `deps.driver` or via
+ * `getService("columnsCollection")`) and asks the host to mint a fresh
+ * handle covering the supplied sources. Pass `sources === undefined` to
+ * fall back to the active render ctx (main outputs + prerun + result pool).
+ *
+ * `sources` accepts {@link ColumnsSourceShorthand} string literals
+ * (`"result_pool"`, `"current_block"`) for the common ctx-derived sources.
+ */
+declare function ColumnsCollection(sources?: (ColumnsCollection | ColumnsSource | ColumnsSourceShorthand)[], deps?: ColumnsCollectionDeps): ColumnsCollection;
+declare function isColumnsCollection(value: unknown): value is ColumnsCollection;
+/**
+ * Sandbox proxy over the host-side `ColumnsCollection` driver. The driver
+ * owns all column-set state; this object only carries an opaque
+ * {@link CollectionHandle} plus a reference to the driver service.
+ *
+ * Construct via {@link ColumnsCollection} — the bare constructor is a
+ * trivial `(handle, driver)` pair so that `addSource` / `discover` / `filter`
+ * can rebind a freshly-minted handle without going through source
+ * serialisation again.
+ *
+ * Every method returning a `ColumnsCollection` mints a fresh handle on the
+ * host — the host VM bridge pins it to the active render ctx, so the sandbox
+ * never has to manage refcounts.
+ */
+declare class ColumnsCollectionImpl {
+  readonly handle: CollectionHandle;
+  private readonly driver;
+  constructor(handle: CollectionHandle, driver: ColumnsCollectionDriverModel);
+  isEmpty(): boolean;
+  isFinal(): boolean;
+  getColumnIds(): ColumnUniversalId[];
+  getColumns(): ColumnRecipe[];
+  addSource(source: ColumnsSource | ColumnsCollection): ColumnsCollection;
+  discover(options: ColumnsDiscoverOptions): ColumnsCollection;
+  filter(options: ColumnsFilterOptions): ColumnsCollection;
+}
+/** Public type alias — value of the same name is the factory function above. */
+type ColumnsCollection = ColumnsCollectionImpl;
+//#endregion
+export { ColumnsCollection, ColumnsCollectionDeps, ColumnsCollectionImpl, ColumnsSourceShorthand, isColumnsCollection };
+//# sourceMappingURL=columns_collection.d.ts.map

package/dist/columns/columns_collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns_collection.d.ts","names":[],"sources":["../../src/columns/columns_collection.ts"],"mappings":";;;;;;UAkBiB,qBAAA;;WAEN,GAAA,GAAM,kBAAA;EAFA;EAAA,SAIN,MAAA,GAAS,4BAA4B;AAAA;;;;;;;AAAA;AAWhD;KAAY,sBAAA;;;AAAsB;AAYlC;;;;;;;iBAAgB,iBAAA,CACd,OAAA,IAAW,iBAAA,GAAoB,aAAA,GAAgB,sBAAA,KAC/C,IAAA,GAAO,qBAAA,GACN,iBAAA;AAAA,iBAQa,mBAAA,CAAoB,KAAA,YAAiB,KAAA,IAAS,iBAAiB;;;;;;;;;;AAR3D;AAQpB;;;;cAkBa,qBAAA;EAAA,SAEO,MAAA,EAAQ,gBAAA;EAAA,iBACP,MAAA;cADD,MAAA,EAAQ,gBAAA,EACP,MAAA,EAAQ,4BAAA;EAG3B,OAAA;EAIA,OAAA;EAIA,YAAA,IAAgB,iBAAA;EAIhB,UAAA,IAAc,YAAA;EAMd,SAAA,CAAU,MAAA,EAAQ,aAAA,GAAgB,iBAAA,GAAoB,iBAAA;EAOtD,QAAA,CAAS,OAAA,EAAS,sBAAA,GAAyB,iBAAA;EAI3C,MAAA,CAAO,OAAA,EAAS,oBAAA,GAAuB,iBAAA;AAAA;;KAM7B,iBAAA,GAAoB,qBAAqB"}

package/dist/columns/columns_collection.js

@@ -0,0 +1,122 @@
+import { getCfgRenderCtx } from "../internal.js";
+import { TreeNodeAccessor } from "../render/accessor.js";
+import { MainAccessorName, StagingAccessorName } from "../render/internal.js";
+import { getService } from "../services/get_services.js";
+import { ColumnRecipe } from "./column_recipes/index.js";
+import { isColumnProvider } from "./column_providers/index.js";
+import { isNil } from "es-toolkit";
+//#region src/columns/columns_collection.ts
+/**
+* Build a {@link ColumnsCollection} from sandbox-side source descriptors.
+* Resolves the `columnsCollection` driver (either from `deps.driver` or via
+* `getService("columnsCollection")`) and asks the host to mint a fresh
+* handle covering the supplied sources. Pass `sources === undefined` to
+* fall back to the active render ctx (main outputs + prerun + result pool).
+*
+* `sources` accepts {@link ColumnsSourceShorthand} string literals
+* (`"result_pool"`, `"current_block"`) for the common ctx-derived sources.
+*/
+function ColumnsCollection(sources, deps) {
+	const driver = deps?.driver ?? getService("columnsCollection", { ctx: deps?.ctx });
+	const serialized = sources ? sources.flatMap((s) => toSerializedSources(s, deps?.ctx)) : defaultCtxSources(deps?.ctx);
+	return new ColumnsCollectionImpl(driver.create(serialized), driver);
+}
+function isColumnsCollection(value) {
+	return value instanceof ColumnsCollectionImpl;
+}
+/**
+* Sandbox proxy over the host-side `ColumnsCollection` driver. The driver
+* owns all column-set state; this object only carries an opaque
+* {@link CollectionHandle} plus a reference to the driver service.
+*
+* Construct via {@link ColumnsCollection} — the bare constructor is a
+* trivial `(handle, driver)` pair so that `addSource` / `discover` / `filter`
+* can rebind a freshly-minted handle without going through source
+* serialisation again.
+*
+* Every method returning a `ColumnsCollection` mints a fresh handle on the
+* host — the host VM bridge pins it to the active render ctx, so the sandbox
+* never has to manage refcounts.
+*/
+var ColumnsCollectionImpl = class ColumnsCollectionImpl {
+	handle;
+	driver;
+	constructor(handle, driver) {
+		this.handle = handle;
+		this.driver = driver;
+	}
+	isEmpty() {
+		return this.driver.isEmpty(this.handle);
+	}
+	isFinal() {
+		return this.driver.isFinal(this.handle);
+	}
+	getColumnIds() {
+		return this.driver.getColumns(this.handle);
+	}
+	getColumns() {
+		return this.getColumnIds().map((id) => ColumnRecipe(id)).filter((c) => !isNil(c));
+	}
+	addSource(source) {
+		return new ColumnsCollectionImpl(this.driver.addSource(this.handle, toSerializedSources(source)), this.driver);
+	}
+	discover(options) {
+		return new ColumnsCollectionImpl(this.driver.discover(this.handle, options), this.driver);
+	}
+	filter(options) {
+		return new ColumnsCollectionImpl(this.driver.filter(this.handle, options), this.driver);
+	}
+};
+function toSerializedSources(source, ctx) {
+	if (source === "result_pool") return [{ kind: "result_pool" }];
+	if (source === "current_block") return currentBlockSources(ctx);
+	if (source instanceof ColumnsCollectionImpl) return [{
+		kind: "collection",
+		handle: source.handle
+	}];
+	if (source instanceof TreeNodeAccessor) return [{
+		kind: "accessor",
+		accessor: source.handle,
+		path: source.resolvePath
+	}];
+	if (isColumnArray(source)) return [{
+		kind: "ids",
+		ids: source.columns.map((c) => c.id),
+		isFinal: source.isFinal
+	}];
+	if (isColumnProvider(source)) return [{
+		kind: "ids",
+		ids: source.getColumns().map((c) => c.id),
+		isFinal: source.isFinal()
+	}];
+	throw new Error("ColumnsCollection: unrecognised ColumnsSource shape");
+}
+function isColumnArray(source) {
+	if (typeof source !== "object" || source === null) return false;
+	const s = source;
+	return Array.isArray(s.columns) && typeof s.isFinal === "boolean";
+}
+function currentBlockSources(ctx) {
+	const renderCtx = ctx ?? getCfgRenderCtx();
+	const sources = [];
+	const outputs = renderCtx.getAccessorHandleByName(MainAccessorName);
+	if (outputs !== void 0) sources.push({
+		kind: "accessor",
+		accessor: outputs,
+		path: [MainAccessorName]
+	});
+	const prerun = renderCtx.getAccessorHandleByName(StagingAccessorName);
+	if (prerun !== void 0) sources.push({
+		kind: "accessor",
+		accessor: prerun,
+		path: [StagingAccessorName]
+	});
+	return sources;
+}
+function defaultCtxSources(ctx) {
+	return [...currentBlockSources(ctx), { kind: "result_pool" }];
+}
+//#endregion
+export { ColumnsCollection, ColumnsCollectionImpl, isColumnsCollection };
+
+//# sourceMappingURL=columns_collection.js.map

package/dist/columns/columns_collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns_collection.js","names":[],"sources":["../../src/columns/columns_collection.ts"],"sourcesContent":["import type {\n  CollectionHandle,\n  ColumnUniversalId,\n  ColumnsCollectionDriverModel,\n  ColumnsDiscoverOptions,\n  ColumnsFilterOptions,\n  SerializedColumnsSource,\n} from \"@milaboratories/pl-model-common\";\nimport type { GlobalCfgRenderCtx } from \"../render/internal\";\nimport { MainAccessorName, StagingAccessorName } from \"../render/internal\";\nimport type { ColumnsSource } from \"./column_providers\";\nimport { isColumnProvider } from \"./column_providers\";\nimport { TreeNodeAccessor } from \"../render/accessor\";\nimport { getService } from \"../services/get_services\";\nimport { getCfgRenderCtx } from \"../internal\";\nimport { ColumnRecipe } from \"./column_recipes\";\nimport { isNil } from \"es-toolkit\";\n\nexport interface ColumnsCollectionDeps {\n  /** Render ctx used both for service resolution and for default ctx sources. */\n  readonly ctx?: GlobalCfgRenderCtx;\n  /** Override the resolved `columnsCollection` service — primarily for tests. */\n  readonly driver?: ColumnsCollectionDriverModel;\n}\n\n/**\n * Shorthand literals accepted inside `ColumnsCollection`'s `sources`\n * array, expanded against the active render ctx:\n *\n * - `\"result_pool\"`  – fan-out into the host's upstream-block result pool.\n * - `\"current_block\"` – main outputs + prerun (staging) accessors of the\n *   current block, when present.\n */\nexport type ColumnsSourceShorthand = \"result_pool\" | \"current_block\";\n\n/**\n * Build a {@link ColumnsCollection} from sandbox-side source descriptors.\n * Resolves the `columnsCollection` driver (either from `deps.driver` or via\n * `getService(\"columnsCollection\")`) and asks the host to mint a fresh\n * handle covering the supplied sources. Pass `sources === undefined` to\n * fall back to the active render ctx (main outputs + prerun + result pool).\n *\n * `sources` accepts {@link ColumnsSourceShorthand} string literals\n * (`\"result_pool\"`, `\"current_block\"`) for the common ctx-derived sources.\n */\nexport function ColumnsCollection(\n  sources?: (ColumnsCollection | ColumnsSource | ColumnsSourceShorthand)[],\n  deps?: ColumnsCollectionDeps,\n): ColumnsCollection {\n  const driver = deps?.driver ?? getService(\"columnsCollection\", { ctx: deps?.ctx });\n  const serialized: SerializedColumnsSource[] = sources\n    ? sources.flatMap((s) => toSerializedSources(s, deps?.ctx))\n    : defaultCtxSources(deps?.ctx);\n  return new ColumnsCollectionImpl(driver.create(serialized), driver);\n}\n\nexport function isColumnsCollection(value: unknown): value is ColumnsCollection {\n  return value instanceof ColumnsCollectionImpl;\n}\n\n/**\n * Sandbox proxy over the host-side `ColumnsCollection` driver. The driver\n * owns all column-set state; this object only carries an opaque\n * {@link CollectionHandle} plus a reference to the driver service.\n *\n * Construct via {@link ColumnsCollection} — the bare constructor is a\n * trivial `(handle, driver)` pair so that `addSource` / `discover` / `filter`\n * can rebind a freshly-minted handle without going through source\n * serialisation again.\n *\n * Every method returning a `ColumnsCollection` mints a fresh handle on the\n * host — the host VM bridge pins it to the active render ctx, so the sandbox\n * never has to manage refcounts.\n */\nexport class ColumnsCollectionImpl {\n  constructor(\n    public readonly handle: CollectionHandle,\n    private readonly driver: ColumnsCollectionDriverModel,\n  ) {}\n\n  isEmpty(): boolean {\n    return this.driver.isEmpty(this.handle);\n  }\n\n  isFinal(): boolean {\n    return this.driver.isFinal(this.handle);\n  }\n\n  getColumnIds(): ColumnUniversalId[] {\n    return this.driver.getColumns(this.handle);\n  }\n\n  getColumns(): ColumnRecipe[] {\n    return this.getColumnIds()\n      .map((id) => ColumnRecipe(id))\n      .filter((c): c is ColumnRecipe => !isNil(c));\n  }\n\n  addSource(source: ColumnsSource | ColumnsCollection): ColumnsCollection {\n    return new ColumnsCollectionImpl(\n      this.driver.addSource(this.handle, toSerializedSources(source)),\n      this.driver,\n    );\n  }\n\n  discover(options: ColumnsDiscoverOptions): ColumnsCollection {\n    return new ColumnsCollectionImpl(this.driver.discover(this.handle, options), this.driver);\n  }\n\n  filter(options: ColumnsFilterOptions): ColumnsCollection {\n    return new ColumnsCollectionImpl(this.driver.filter(this.handle, options), this.driver);\n  }\n}\n\n/** Public type alias — value of the same name is the factory function above. */\nexport type ColumnsCollection = ColumnsCollectionImpl;\n\nfunction toSerializedSources(\n  source: ColumnsCollection | ColumnsSource | ColumnsSourceShorthand,\n  ctx?: GlobalCfgRenderCtx,\n): SerializedColumnsSource[] {\n  if (source === \"result_pool\") {\n    return [{ kind: \"result_pool\" }];\n  }\n  if (source === \"current_block\") {\n    return currentBlockSources(ctx);\n  }\n  if (source instanceof ColumnsCollectionImpl) {\n    return [{ kind: \"collection\", handle: source.handle }];\n  }\n  if (source instanceof TreeNodeAccessor) {\n    return [{ kind: \"accessor\", accessor: source.handle, path: source.resolvePath }];\n  }\n  if (isColumnArray(source)) {\n    return [{ kind: \"ids\", ids: source.columns.map((c) => c.id), isFinal: source.isFinal }];\n  }\n  if (isColumnProvider(source)) {\n    return [{ kind: \"ids\", ids: source.getColumns().map((c) => c.id), isFinal: source.isFinal() }];\n  }\n  throw new Error(\"ColumnsCollection: unrecognised ColumnsSource shape\");\n}\n\nfunction isColumnArray(source: unknown): source is {\n  columns: ReadonlyArray<{ id: ColumnUniversalId; spec?: unknown; data?: unknown }>;\n  isFinal: boolean;\n} {\n  if (typeof source !== \"object\" || source === null) return false;\n  const s = source as { columns?: unknown; isFinal?: unknown };\n  return Array.isArray(s.columns) && typeof s.isFinal === \"boolean\";\n}\n\nfunction currentBlockSources(ctx?: GlobalCfgRenderCtx): SerializedColumnsSource[] {\n  const renderCtx = ctx ?? getCfgRenderCtx();\n  const sources: SerializedColumnsSource[] = [];\n\n  const outputs = renderCtx.getAccessorHandleByName(MainAccessorName);\n  if (outputs !== undefined) {\n    sources.push({ kind: \"accessor\", accessor: outputs, path: [MainAccessorName] });\n  }\n  const prerun = renderCtx.getAccessorHandleByName(StagingAccessorName);\n  if (prerun !== undefined) {\n    sources.push({ kind: \"accessor\", accessor: prerun, path: [StagingAccessorName] });\n  }\n\n  return sources;\n}\n\nfunction defaultCtxSources(ctx?: GlobalCfgRenderCtx): SerializedColumnsSource[] {\n  return [...currentBlockSources(ctx), { kind: \"result_pool\" }];\n}\n"],"mappings":"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"}

package/dist/columns/derive_axis_values_labels.cjs

@@ -0,0 +1,76 @@
+const require_accessor = require("../render/accessor.cjs");
+require("../render/index.cjs");
+const require_column_lazy = require("./column_lazy.cjs");
+const require_columns_collection = require("./columns_collection.cjs");
+let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
+//#region src/columns/derive_axis_values_labels.ts
+const RT_JSON = "PColumnData/Json";
+const RT_JSON_PARTITIONED = "PColumnData/JsonPartitioned";
+/**
+* Build an `axisValuesLabels` callback by discovering `pl7.app/label` columns
+* from the given source, eagerly materialising their value→label maps, and
+* keying them by canonical axis id.
+*
+* Modern replacement for `ctx.resultPool.findLabels` — uses the new
+* column-access mechanism (filtered {@link ColumnsCollection}) instead of
+* walking the raw result pool.
+*
+* Pair with {@link expandByPartition} (or any consumer expecting the
+* `(axisId) => Record<axisValue, label>` shape).
+*
+* Skips:
+*  - non-leaf recipes (only direct `ColumnLazy` data is read);
+*  - label columns whose `axesSpec.length !== 1`;
+*  - label columns whose data resource type isn't `PColumnData/Json` /
+*    `PColumnData/JsonPartitioned`.
+*/
+function deriveAxisValuesLabels(source, opts) {
+	const byAxis = (source === void 0 ? require_columns_collection.ColumnsCollection(void 0, opts) : require_columns_collection.isColumnsCollection(source) ? source : require_columns_collection.ColumnsCollection(source, opts)).filter({ include: { name: [{
+		type: "exact",
+		value: _milaboratories_pl_model_common.PColumnName.Label
+	}] } }).getColumns().reduce((map, col) => {
+		if (!require_column_lazy.isColumnLazy(col)) return map;
+		const spec = col.getSpec();
+		if (spec.axesSpec.length !== 1) return map;
+		const data = col.getData();
+		if (!(data instanceof require_accessor.TreeNodeAccessor)) return map;
+		const labelMap = readLabelMap(data);
+		if (!labelMap) return map;
+		map.set((0, _milaboratories_pl_model_common.canonicalizeAxisId)((0, _milaboratories_pl_model_common.getAxisId)(spec.axesSpec[0])), labelMap);
+		return map;
+	}, /* @__PURE__ */ new Map());
+	return (axisId) => byAxis.get((0, _milaboratories_pl_model_common.canonicalizeAxisId)(axisId));
+}
+function readLabelMap(acc) {
+	const rt = acc.resourceType.name;
+	if (rt === RT_JSON) {
+		const json = acc.getDataAsJson();
+		return json?.data ? parseLabelKeys(json.data) : void 0;
+	}
+	if (rt === RT_JSON_PARTITIONED) return acc.listInputFields().reduce((merged, partKey) => {
+		const part = acc.resolve({
+			field: partKey,
+			assertFieldType: "Input",
+			ignoreError: true
+		});
+		if (!part) return merged;
+		const json = part.getDataAsJson();
+		if (!json?.data) return merged;
+		return Object.assign(merged, parseLabelKeys(json.data));
+	}, {});
+}
+function parseLabelKeys(raw) {
+	return Object.entries(raw).reduce((acc, [k, v]) => {
+		try {
+			const parsed = JSON.parse(k);
+			acc[Array.isArray(parsed) ? parsed[0] : parsed] = v;
+		} catch {
+			acc[k] = v;
+		}
+		return acc;
+	}, {});
+}
+//#endregion
+exports.deriveAxisValuesLabels = deriveAxisValuesLabels;
+
+//# sourceMappingURL=derive_axis_values_labels.cjs.map

package/dist/columns/derive_axis_values_labels.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive_axis_values_labels.cjs","names":["ColumnsCollection","isColumnsCollection","PColumnName","isColumnLazy","TreeNodeAccessor"],"sources":["../../src/columns/derive_axis_values_labels.ts"],"sourcesContent":["import type { AxisId } from \"@milaboratories/pl-model-common\";\nimport { canonicalizeAxisId, getAxisId, PColumnName } from \"@milaboratories/pl-model-common\";\nimport type { ColumnsSource } from \"./column_providers\";\nimport { ColumnsCollection, isColumnsCollection } from \"./columns_collection\";\nimport type { GlobalCfgRenderCtx } from \"../render/internal\";\nimport { TreeNodeAccessor } from \"../render\";\nimport { isColumnLazy } from \"./column_lazy\";\n\nconst RT_JSON = \"PColumnData/Json\";\nconst RT_JSON_PARTITIONED = \"PColumnData/JsonPartitioned\";\n\n/**\n * Build an `axisValuesLabels` callback by discovering `pl7.app/label` columns\n * from the given source, eagerly materialising their value→label maps, and\n * keying them by canonical axis id.\n *\n * Modern replacement for `ctx.resultPool.findLabels` — uses the new\n * column-access mechanism (filtered {@link ColumnsCollection}) instead of\n * walking the raw result pool.\n *\n * Pair with {@link expandByPartition} (or any consumer expecting the\n * `(axisId) => Record<axisValue, label>` shape).\n *\n * Skips:\n *  - non-leaf recipes (only direct `ColumnLazy` data is read);\n *  - label columns whose `axesSpec.length !== 1`;\n *  - label columns whose data resource type isn't `PColumnData/Json` /\n *    `PColumnData/JsonPartitioned`.\n */\nexport function deriveAxisValuesLabels(\n  source?: ColumnsCollection | (ColumnsCollection | ColumnsSource)[],\n  opts?: { ctx?: GlobalCfgRenderCtx },\n): (axisId: AxisId) => Record<string | number, string> | undefined {\n  const collection =\n    source === undefined\n      ? ColumnsCollection(undefined, opts)\n      : isColumnsCollection(source)\n        ? source\n        : ColumnsCollection(source, opts);\n\n  const labelCols = collection\n    .filter({ include: { name: [{ type: \"exact\", value: PColumnName.Label }] } })\n    .getColumns();\n\n  const byAxis = labelCols.reduce<Map<string, Record<string | number, string>>>((map, col) => {\n    if (!isColumnLazy(col)) return map;\n    const spec = col.getSpec();\n    if (spec.axesSpec.length !== 1) return map;\n\n    const data = col.getData();\n    if (!(data instanceof TreeNodeAccessor)) return map;\n\n    const labelMap = readLabelMap(data);\n    if (!labelMap) return map;\n\n    map.set(canonicalizeAxisId(getAxisId(spec.axesSpec[0])), labelMap);\n    return map;\n  }, new Map());\n\n  return (axisId) => byAxis.get(canonicalizeAxisId(axisId));\n}\n\nfunction readLabelMap(acc: TreeNodeAccessor): undefined | Record<string | number, string> {\n  const rt = acc.resourceType.name;\n\n  if (rt === RT_JSON) {\n    const json = acc.getDataAsJson<{ data?: Record<string, string> }>();\n    return json?.data ? parseLabelKeys(json.data) : undefined;\n  }\n\n  if (rt === RT_JSON_PARTITIONED) {\n    return acc.listInputFields().reduce<Record<string | number, string>>((merged, partKey) => {\n      const part = acc.resolve({\n        field: partKey,\n        assertFieldType: \"Input\",\n        ignoreError: true,\n      });\n      if (!part) return merged;\n      const json = part.getDataAsJson<{ data?: Record<string, string> }>();\n      if (!json?.data) return merged;\n      return Object.assign(merged, parseLabelKeys(json.data));\n    }, {});\n  }\n\n  return undefined;\n}\n\nfunction parseLabelKeys(raw: Record<string, string>): Record<string | number, string> {\n  return Object.entries(raw).reduce<Record<string | number, string>>((acc, [k, v]) => {\n    try {\n      const parsed = JSON.parse(k);\n      acc[Array.isArray(parsed) ? parsed[0] : parsed] = v;\n    } catch {\n      acc[k] = v;\n    }\n    return acc;\n  }, {});\n}\n"],"mappings":";;;;;;AAQA,MAAM,UAAU;AAChB,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;AAoB5B,SAAgB,uBACd,QACA,MACiE;CAYjE,MAAM,UAVJ,WAAW,KAAA,IACPA,2BAAAA,kBAAkB,KAAA,GAAW,IAAI,IACjCC,2BAAAA,oBAAoB,MAAM,IACxB,SACAD,2BAAAA,kBAAkB,QAAQ,IAAI,EAAA,CAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;EAAE,MAAM;EAAS,OAAOE,gCAAAA,YAAY;CAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAC5E,WAEoB,CAAC,CAAC,QAAsD,KAAK,QAAQ;EAC1F,IAAI,CAACC,oBAAAA,aAAa,GAAG,GAAG,OAAO;EAC/B,MAAM,OAAO,IAAI,QAAQ;EACzB,IAAI,KAAK,SAAS,WAAW,GAAG,OAAO;EAEvC,MAAM,OAAO,IAAI,QAAQ;EACzB,IAAI,EAAE,gBAAgBC,iBAAAA,mBAAmB,OAAO;EAEhD,MAAM,WAAW,aAAa,IAAI;EAClC,IAAI,CAAC,UAAU,OAAO;EAEtB,IAAI,KAAA,GAAA,gCAAA,mBAAA,EAAA,GAAA,gCAAA,UAAA,CAAiC,KAAK,SAAS,EAAE,CAAC,GAAG,QAAQ;EACjE,OAAO;CACT,mBAAG,IAAI,IAAI,CAAC;CAEZ,QAAQ,WAAW,OAAO,KAAA,GAAA,gCAAA,mBAAA,CAAuB,MAAM,CAAC;AAC1D;AAEA,SAAS,aAAa,KAAoE;CACxF,MAAM,KAAK,IAAI,aAAa;CAE5B,IAAI,OAAO,SAAS;EAClB,MAAM,OAAO,IAAI,cAAiD;EAClE,OAAO,MAAM,OAAO,eAAe,KAAK,IAAI,IAAI,KAAA;CAClD;CAEA,IAAI,OAAO,qBACT,OAAO,IAAI,gBAAgB,CAAC,CAAC,QAAyC,QAAQ,YAAY;EACxF,MAAM,OAAO,IAAI,QAAQ;GACvB,OAAO;GACP,iBAAiB;GACjB,aAAa;EACf,CAAC;EACD,IAAI,CAAC,MAAM,OAAO;EAClB,MAAM,OAAO,KAAK,cAAiD;EACnE,IAAI,CAAC,MAAM,MAAM,OAAO;EACxB,OAAO,OAAO,OAAO,QAAQ,eAAe,KAAK,IAAI,CAAC;CACxD,GAAG,CAAC,CAAC;AAIT;AAEA,SAAS,eAAe,KAA8D;CACpF,OAAO,OAAO,QAAQ,GAAG,CAAC,CAAC,QAAyC,KAAK,CAAC,GAAG,OAAO;EAClF,IAAI;GACF,MAAM,SAAS,KAAK,MAAM,CAAC;GAC3B,IAAI,MAAM,QAAQ,MAAM,IAAI,OAAO,KAAK,UAAU;EACpD,QAAQ;GACN,IAAI,KAAK;EACX;EACA,OAAO;CACT,GAAG,CAAC,CAAC;AACP"}

package/dist/columns/derive_axis_values_labels.d.ts

@@ -0,0 +1,30 @@
+import { GlobalCfgRenderCtx } from "../render/internal.js";
+import { ColumnsSource } from "./column_providers/types.js";
+import { ColumnsCollection } from "./columns_collection.js";
+import { AxisId } from "@milaboratories/pl-model-common";
+
+//#region src/columns/derive_axis_values_labels.d.ts
+/**
+ * Build an `axisValuesLabels` callback by discovering `pl7.app/label` columns
+ * from the given source, eagerly materialising their value→label maps, and
+ * keying them by canonical axis id.
+ *
+ * Modern replacement for `ctx.resultPool.findLabels` — uses the new
+ * column-access mechanism (filtered {@link ColumnsCollection}) instead of
+ * walking the raw result pool.
+ *
+ * Pair with {@link expandByPartition} (or any consumer expecting the
+ * `(axisId) => Record<axisValue, label>` shape).
+ *
+ * Skips:
+ *  - non-leaf recipes (only direct `ColumnLazy` data is read);
+ *  - label columns whose `axesSpec.length !== 1`;
+ *  - label columns whose data resource type isn't `PColumnData/Json` /
+ *    `PColumnData/JsonPartitioned`.
+ */
+declare function deriveAxisValuesLabels(source?: ColumnsCollection | (ColumnsCollection | ColumnsSource)[], opts?: {
+  ctx?: GlobalCfgRenderCtx;
+}): (axisId: AxisId) => Record<string | number, string> | undefined;
+//#endregion
+export { deriveAxisValuesLabels };
+//# sourceMappingURL=derive_axis_values_labels.d.ts.map

package/dist/columns/derive_axis_values_labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive_axis_values_labels.d.ts","names":[],"sources":["../../src/columns/derive_axis_values_labels.ts"],"mappings":";;;;;;;;;AA6BA;;;;;;;;;;;;;;;iBAAgB,sBAAA,CACd,MAAA,GAAS,iBAAA,IAAqB,iBAAA,GAAoB,aAAA,KAClD,IAAA;EAAS,GAAA,GAAM,kBAAA;AAAA,KACb,MAAA,EAAQ,MAAA,KAAW,MAAA"}