@platforma-sdk/model 1.79.24 → 1.80.0

package/dist/columns/column_collection_builder.cjs

@@ -1,241 +0,0 @@
-const require_accessor = require("../render/accessor.cjs");
-const require_get_services = require("../services/get_services.cjs");
-require("../services/index.cjs");
-const require_column_snapshot_provider = require("./column_snapshot_provider.cjs");
-const require_column_selector = require("./column_selector.cjs");
-let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
-let _milaboratories_helpers = require("@milaboratories/helpers");
-//#region src/columns/column_collection_builder.ts
-/**
-* Mutable builder that accumulates column sources, then produces
-* a ColumnCollection (plain) or AnchoredColumnCollection (with anchors).
-*
-* Each output lambda creates its own builder — a constraint of the
-* computable framework where each output tracks its own dependencies.
-*/
-var ColumnCollectionBuilder = class {
-	specDriver;
-	providers = [];
-	constructor(specDriver = require_get_services.getService("pframeSpec")) {
-		this.specDriver = specDriver;
-	}
-	/**
-	* Register a column source. Sources added first take precedence for dedup.
-	* Does NOT accept undefined — if a source isn't available yet,
-	* the caller should return undefined from the output lambda.
-	*/
-	addSource(source) {
-		if (source instanceof require_accessor.TreeNodeAccessor) {
-			const columns = source.getPColumns();
-			if (columns) this.providers.push(new require_column_snapshot_provider.ArrayColumnProvider(columns));
-		} else this.providers.push(require_column_snapshot_provider.toColumnSnapshotProvider(source));
-		return this;
-	}
-	addSources(sources) {
-		for (const source of sources) this.addSource(source);
-		return this;
-	}
-	build(options) {
-		const allowPartial = options?.allowPartialColumnList === true;
-		if (!this.providers.every((p) => p.isColumnListComplete()) && !allowPartial) return void 0;
-		const columns = collectColumns(this.providers);
-		if (options !== void 0 && "anchors" in options) return new AnchoredColumnCollectionImpl(this.specDriver, {
-			anchors: options.anchors,
-			columns
-		});
-		else return new ColumnCollectionImpl(this.specDriver, { columns });
-	}
-};
-var ColumnCollectionImpl = class {
-	specDriver;
-	columns;
-	specFrameEntry;
-	constructor(specDriver, options) {
-		this.specDriver = specDriver;
-		this.columns = new Map(options.columns.map((col) => [col.id, col]));
-		this.specFrameEntry = this.specDriver.createSpecFrame(Object.fromEntries(options.columns.map((col) => [col.id, col.spec])));
-	}
-	dispose() {
-		this.specFrameEntry.unref();
-	}
-	[Symbol.dispose]() {
-		this.dispose();
-	}
-	findColumns(options) {
-		const includeColumns = options?.include ? toMultiColumnSelectors(options.include) : void 0;
-		const excludeColumns = options?.exclude ? toMultiColumnSelectors(options.exclude) : void 0;
-		return this.specDriver.discoverColumns(this.specFrameEntry.key, {
-			includeColumns,
-			excludeColumns,
-			axes: [],
-			maxHops: 0,
-			constraints: matchingModeToConstraints("enrichment")
-		}).hits.map((hit) => this.columns.get(hit.hit.columnId)).filter((col) => col !== void 0);
-	}
-};
-var AnchoredColumnCollectionImpl = class {
-	specDriver;
-	anchorsMap;
-	columnsMap;
-	specFrameEntry;
-	constructor(specDriver, options) {
-		this.specDriver = specDriver;
-		this.specFrameEntry = this.specDriver.createSpecFrame(Object.fromEntries(options.columns.map((col) => [col.id, col.spec])));
-		this.columnsMap = new Map(options.columns.map((col) => [col.id, col]));
-		this.anchorsMap = resolveAnchorMap(options.anchors, options.columns, this.specDriver.discoverColumns.bind(this.specDriver, this.specFrameEntry.key));
-	}
-	dispose() {
-		this.specFrameEntry.unref();
-	}
-	[Symbol.dispose]() {
-		this.dispose();
-	}
-	getAnchors() {
-		return this.anchorsMap;
-	}
-	findColumns(options) {
-		const constraints = matchingModeToConstraints(options?.mode ?? "enrichment");
-		const includeColumns = options?.include ? toMultiColumnSelectors(options.include) : void 0;
-		const excludeColumns = options?.exclude ? toMultiColumnSelectors(options.exclude) : void 0;
-		const anchors = Array.from(this.anchorsMap.values());
-		const byColumn = this.specDriver.discoverColumns(this.specFrameEntry.key, {
-			includeColumns,
-			excludeColumns,
-			constraints,
-			maxHops: options?.maxHops ?? 4,
-			axes: anchors.map((anchor) => ({
-				axesSpec: anchor.spec.axesSpec,
-				qualifications: []
-			}))
-		}).hits.reduce((acc, hit) => {
-			const origId = hit.hit.columnId;
-			const col = this.columnsMap.get(origId) ?? (0, _milaboratories_helpers.throwError)(`Column with id ${origId} not found in collection`);
-			const path = hit.path.map((step) => {
-				if (step.type !== "linker") throw new Error(`Unexpected discover-columns step type: ${step.type}`);
-				return { linker: this.columnsMap.get(step.linker.columnId) ?? (0, _milaboratories_helpers.throwError)(`Linker column with id ${step.linker.columnId} not found in collection`) };
-			});
-			const variants = hit.mappingVariants.map((v) => ({
-				path,
-				qualifications: remapFromIdxToId(v.qualifications, anchors)
-			}));
-			const existing = acc.get(origId);
-			return acc.set(origId, existing === void 0 ? {
-				column: col,
-				variants
-			} : {
-				...existing,
-				variants: [...existing.variants, ...variants]
-			});
-		}, /* @__PURE__ */ new Map());
-		return Array.from(byColumn.values());
-	}
-	findColumnVariants(options) {
-		return this.findColumns(options).flatMap((match) => match.variants.map((variant) => ({
-			column: match.column,
-			path: variant.path,
-			qualifications: variant.qualifications
-		})));
-	}
-};
-/**
-* Collect all columns from all providers, dedup by NativePObjectId.
-* First source wins.
-*/
-function collectColumns(providers) {
-	const seen = /* @__PURE__ */ new Set();
-	const result = [];
-	for (const provider of providers) {
-		const columns = provider.getAllColumns();
-		for (const col of columns) {
-			const nativeId = (0, _milaboratories_pl_model_common.deriveNativeId)(col.spec);
-			if (seen.has(nativeId)) continue;
-			seen.add(nativeId);
-			result.push(col);
-		}
-	}
-	return result;
-}
-/** Normalize ColumnSelector (relaxed, single or array) to MultiColumnSelector[]. */
-function toMultiColumnSelectors(input) {
-	return require_column_selector.convertColumnSelectorToMultiColumnSelector(input);
-}
-/**
-* Resolve each anchor entry to a ColumnSnapshot from the collected columns.
-* - PObjectId (string): looked up by id in the collected columns
-* - PColumnSpec: matched by deriveNativeId against collected columns
-* - RelaxedColumnSelector: resolved via discoverColumns in "exact" mode;
-*   must match exactly one column
-* Throws on unresolved, ambiguous, or duplicated matches. Requires at least one
-* anchor to resolve.
-*/
-function resolveAnchorMap(anchors, columns, discoverColumns) {
-	const result = /* @__PURE__ */ new Map();
-	const resovedIds = /* @__PURE__ */ new Set();
-	const getDuplicateError = (key) => `Anchor "${key}": selector matched a column that was already matched by another anchor; please refine the selector to match a different column`;
-	let byId;
-	let byNativeId;
-	for (const [name, anchor] of Object.entries(anchors)) if (typeof anchor === "string") {
-		if (byId === void 0) byId = new Map(columns.map((col) => [col.id, col]));
-		const found = byId.get(anchor) ?? (0, _milaboratories_helpers.throwError)(`Anchor "${name}": column with id "${anchor}" not found in sources`);
-		if (resovedIds.has(found.id)) (0, _milaboratories_helpers.throwError)(getDuplicateError(name));
-		result.set(name, found);
-		resovedIds.add(found.id);
-	} else if ("kind" in anchor) {
-		if (!(0, _milaboratories_pl_model_common.isPColumnSpec)(anchor)) (0, _milaboratories_helpers.throwError)(`Anchor "${name}": invalid PColumnSpec`);
-		if (byNativeId === void 0) byNativeId = new Map(columns.map((col) => [(0, _milaboratories_pl_model_common.deriveNativeId)(col.spec), col]));
-		const found = byNativeId.get((0, _milaboratories_pl_model_common.deriveNativeId)(anchor)) ?? (0, _milaboratories_helpers.throwError)(`Anchor "${name}": no column matching spec found in sources`);
-		if (resovedIds.has(found.id)) (0, _milaboratories_helpers.throwError)(getDuplicateError(name));
-		result.set(name, found);
-		resovedIds.add(found.id);
-	} else {
-		const matched = discoverColumns({
-			includeColumns: toMultiColumnSelectors(anchor),
-			excludeColumns: void 0,
-			axes: [],
-			maxHops: 0,
-			constraints: matchingModeToConstraints("related")
-		});
-		if (matched.hits.length === 0) (0, _milaboratories_helpers.throwError)(`Anchor "${name}": no columns matched selector`);
-		if (matched.hits.length > 1) (0, _milaboratories_helpers.throwError)(`Anchor "${name}": selector is ambiguous and matched multiple columns; please refine the selector to match exactly one column`);
-		if (resovedIds.has(matched.hits[0].hit.columnId)) (0, _milaboratories_helpers.throwError)(getDuplicateError(name));
-		const id = matched.hits[0].hit.columnId;
-		const snap = columns.find((col) => col.id === id) ?? (0, _milaboratories_helpers.throwError)(`Anchor "${name}": matched column with id "${id}" not found in sources`);
-		result.set(name, snap);
-		resovedIds.add(snap.id);
-	}
-	if (resovedIds.size === 0) (0, _milaboratories_helpers.throwError)("At least one anchor must be resolved to a valid column");
-	return result;
-}
-function remapFromIdxToId(qualifications, anchors) {
-	const forQueries = qualifications.forQueries.reduce((acc, qs, i) => anchors[i] && qs.length > 0 ? acc.set(anchors[i].id, qs) : acc, /* @__PURE__ */ new Map());
-	return {
-		forQueries: forQueries.size > 0 ? Object.fromEntries(forQueries) : void 0,
-		forHit: qualifications.forHit.length > 0 ? qualifications.forHit : void 0
-	};
-}
-function matchingModeToConstraints(mode) {
-	switch (mode) {
-		case "enrichment": return {
-			allowFloatingSourceAxes: true,
-			allowFloatingHitAxes: false,
-			allowSourceQualifications: true,
-			allowHitQualifications: true
-		};
-		case "related": return {
-			allowFloatingSourceAxes: true,
-			allowFloatingHitAxes: true,
-			allowSourceQualifications: true,
-			allowHitQualifications: true
-		};
-		case "exact": return {
-			allowFloatingSourceAxes: false,
-			allowFloatingHitAxes: false,
-			allowSourceQualifications: false,
-			allowHitQualifications: false
-		};
-	}
-}
-//#endregion
-exports.ColumnCollectionBuilder = ColumnCollectionBuilder;
-
-//# sourceMappingURL=column_collection_builder.cjs.map

package/dist/columns/column_collection_builder.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"column_collection_builder.cjs","names":["getService","TreeNodeAccessor","ArrayColumnProvider","toColumnSnapshotProvider","convertColumnSelectorToMultiColumnSelector"],"sources":["../../src/columns/column_collection_builder.ts"],"sourcesContent":["import type {\n  AxisQualification,\n  DiscoverColumnsConstraints,\n  DiscoverColumnsRequest,\n  DiscoverColumnsResponse,\n  MultiColumnSelector,\n  NativePObjectId,\n  PColumnSpec,\n  PObjectId,\n} from \"@milaboratories/pl-model-common\";\nimport { deriveNativeId, isPColumnSpec } from \"@milaboratories/pl-model-common\";\nimport type { ColumnSelector, RelaxedColumnSelector } from \"./column_selector\";\nimport { convertColumnSelectorToMultiColumnSelector } from \"./column_selector\";\nimport { TreeNodeAccessor } from \"../render/accessor\";\nimport type { ColumnSnapshot } from \"./column_snapshot\";\nimport type { ColumnSnapshotProvider, ColumnSource } from \"./column_snapshot_provider\";\nimport { ArrayColumnProvider, toColumnSnapshotProvider } from \"./column_snapshot_provider\";\n\nimport type { PFrameSpecDriver, PoolEntry, SpecFrameHandle } from \"@milaboratories/pl-model-common\";\nimport { throwError } from \"@milaboratories/helpers\";\nimport { getService } from \"../services\";\n\n/** Options for plain collection findColumns. */\nexport interface FindColumnsOptions {\n  /** Include columns matching these selectors. If omitted, includes all columns. */\n  include?: ColumnSelector;\n  /** Exclude columns matching these selectors. */\n  exclude?: ColumnSelector;\n}\n\n/** Plain collection — no axis context, selector-based filtering only. */\nexport interface ColumnCollection extends Disposable {\n  /** Release the underlying spec frame WASM resource. */\n  dispose(): void;\n\n  /** Find columns matching selectors. Returns flat list of snapshots.\n   *  No axis compatibility matching, no linker traversal.\n   *  Never returns undefined — the \"not ready\" state was absorbed by the builder. */\n  findColumns(options?: FindColumnsOptions): ColumnSnapshot<PObjectId>[];\n}\n\n/** Axis-aware column collection with anchored identity derivation. */\nexport interface AnchoredColumnCollection extends Disposable {\n  /** Release the underlying spec frame WASM resource. */\n  dispose(): void;\n\n  /** List of anchors used for discovery, with their resolved specs. */\n  getAnchors(): Map<string, ColumnSnapshot<PObjectId>>;\n\n  /** Axis-aware column discovery. */\n  findColumns(options?: AnchoredFindColumnsOptions): ColumnMatch[];\n\n  /** Variant discovery with detailed mapping info for each hit. */\n  findColumnVariants(options?: AnchoredFindColumnsOptions): ColumnVariant[];\n}\n\n/** Controls axis matching behavior for anchored discovery. */\nexport type MatchingMode = \"enrichment\" | \"related\" | \"exact\";\n\n/** Options for anchored collection findColumns. */\nexport interface AnchoredFindColumnsOptions extends FindColumnsOptions {\n  /** Controls axis matching behavior. Default: 'enrichment'. */\n  mode?: MatchingMode;\n  /** Maximum linker hops for cross-domain discovery (0 = direct only, default: 4). */\n  maxHops?: number;\n}\n\n/** Result of anchored discovery — column snapshot + routing info. */\nexport interface ColumnMatch {\n  /** Column snapshot with anchored SUniversalPColumnId. */\n  readonly column: ColumnSnapshot<PObjectId>;\n  /** Match variants — different ways (paths/qualifications) to reach this column. */\n  readonly variants: MatchVariant[];\n}\n\nexport interface ColumnVariant<Id extends PObjectId = PObjectId> {\n  /** Column snapshot with anchored SUniversalPColumnId. */\n  readonly column: ColumnSnapshot<Id>;\n  /** Linker steps traversed to reach this hit; empty for direct matches. */\n  readonly path?: { linker: ColumnSnapshot<PObjectId> }[];\n  /** Full qualifications needed for integration. */\n  readonly qualifications?: MatchQualifications;\n}\n\n/** A single mapping variant describing how a hit column can be integrated. */\nexport interface MatchVariant {\n  /** Full qualifications needed for integration. */\n  readonly qualifications: MatchQualifications;\n  /** Linker steps traversed to reach this hit; empty for direct matches. */\n  readonly path: { linker: ColumnSnapshot<PObjectId> }[];\n}\n\n/** Qualifications needed for both already-integrated anchor columns and the hit column. */\nexport interface MatchQualifications {\n  /** Qualifications for already-integrated anchor columns */\n  readonly forQueries?: Record<PObjectId, AxisQualification[]>;\n  /** Qualifications for the hit column. */\n  readonly forHit?: AxisQualification[];\n}\n\nexport interface BuildOptions {\n  allowPartialColumnList?: true;\n}\n\nexport type AnchorEntry = PObjectId | PColumnSpec | RelaxedColumnSelector;\n\nexport interface AnchoredBuildOptions extends BuildOptions {\n  anchors: Record<string, AnchorEntry>;\n}\n\n/**\n * Mutable builder that accumulates column sources, then produces\n * a ColumnCollection (plain) or AnchoredColumnCollection (with anchors).\n *\n * Each output lambda creates its own builder — a constraint of the\n * computable framework where each output tracks its own dependencies.\n */\nexport class ColumnCollectionBuilder {\n  private readonly providers: ColumnSnapshotProvider[] = [];\n\n  constructor(private readonly specDriver: PFrameSpecDriver = getService(\"pframeSpec\")) {}\n\n  /**\n   * Register a column source. Sources added first take precedence for dedup.\n   * Does NOT accept undefined — if a source isn't available yet,\n   * the caller should return undefined from the output lambda.\n   */\n  addSource(source: ColumnSource | TreeNodeAccessor): this {\n    if (source instanceof TreeNodeAccessor) {\n      const columns = source.getPColumns();\n      if (columns) this.providers.push(new ArrayColumnProvider(columns));\n    } else {\n      this.providers.push(toColumnSnapshotProvider(source));\n    }\n    return this;\n  }\n\n  addSources(sources: (ColumnSource | TreeNodeAccessor)[]): this {\n    for (const source of sources) {\n      this.addSource(source);\n    }\n    return this;\n  }\n\n  /** Plain collection — selector-based filtering, PObjectId namespace. */\n  build(): undefined | ColumnCollection;\n  build(options: {\n    allowPartialColumnList: true;\n  }): ColumnCollection & { readonly columnListComplete: boolean };\n  /** Anchored collection — axis-aware discovery, SUniversalPColumnId namespace. */\n  build(\n    options: AnchoredBuildOptions & { allowPartialColumnList: true },\n  ): AnchoredColumnCollection & { readonly columnListComplete: boolean };\n  build(options: AnchoredBuildOptions): undefined | AnchoredColumnCollection;\n  build(\n    options?: BuildOptions | AnchoredBuildOptions,\n  ):\n    | undefined\n    | ColumnCollection\n    | AnchoredColumnCollection\n    | (ColumnCollection & { readonly columnListComplete: boolean })\n    | (AnchoredColumnCollection & { readonly columnListComplete: boolean }) {\n    const allowPartial = options?.allowPartialColumnList === true;\n\n    // Check column list completeness\n    const allComplete = this.providers.every((p) => p.isColumnListComplete());\n    if (!allComplete && !allowPartial) return undefined;\n\n    // Collect all columns, dedup by native ID (first source wins)\n    const columns = collectColumns(this.providers);\n    const hasAnchors = options !== undefined && \"anchors\" in options;\n\n    if (hasAnchors) {\n      return new AnchoredColumnCollectionImpl(this.specDriver, {\n        anchors: options.anchors,\n        columns,\n      });\n    } else {\n      return new ColumnCollectionImpl(this.specDriver, {\n        columns,\n      });\n    }\n  }\n}\n\ninterface ColumnCollectionImplOptions {\n  readonly columns: ColumnSnapshot<PObjectId>[];\n}\n\nclass ColumnCollectionImpl implements ColumnCollection, Disposable {\n  private readonly columns: Map<PObjectId, ColumnSnapshot<PObjectId>>;\n  private readonly specFrameEntry: PoolEntry<SpecFrameHandle>;\n\n  constructor(\n    private readonly specDriver: PFrameSpecDriver,\n    options: ColumnCollectionImplOptions,\n  ) {\n    this.columns = new Map(options.columns.map((col) => [col.id, col]));\n    this.specFrameEntry = this.specDriver.createSpecFrame(\n      Object.fromEntries(options.columns.map((col) => [col.id, col.spec])),\n    );\n  }\n\n  dispose(): void {\n    this.specFrameEntry.unref();\n  }\n\n  [Symbol.dispose](): void {\n    this.dispose();\n  }\n\n  findColumns(options?: FindColumnsOptions): ColumnSnapshot<PObjectId>[] {\n    const includeColumns = options?.include ? toMultiColumnSelectors(options.include) : undefined;\n    const excludeColumns = options?.exclude ? toMultiColumnSelectors(options.exclude) : undefined;\n\n    const response = this.specDriver.discoverColumns(this.specFrameEntry.key, {\n      includeColumns,\n      excludeColumns,\n      axes: [],\n      maxHops: 0,\n      constraints: matchingModeToConstraints(\"enrichment\"),\n    });\n\n    // Map hits back to snapshots\n    const results = response.hits\n      .map((hit) => this.columns.get(hit.hit.columnId as PObjectId))\n      .filter((col): col is ColumnSnapshot<PObjectId> => col !== undefined);\n\n    return results;\n  }\n}\n\ninterface AnchoredColumnCollectionImplOptions extends ColumnCollectionImplOptions {\n  readonly anchors: Record<string, AnchorEntry>;\n}\n\nclass AnchoredColumnCollectionImpl implements AnchoredColumnCollection, Disposable {\n  private readonly anchorsMap: Map<string, ColumnSnapshot<PObjectId>>;\n  private readonly columnsMap: Map<PObjectId, ColumnSnapshot<PObjectId>>;\n  private readonly specFrameEntry: PoolEntry<SpecFrameHandle>;\n\n  constructor(\n    private readonly specDriver: PFrameSpecDriver,\n    options: AnchoredColumnCollectionImplOptions,\n  ) {\n    // Create spec frame from all collected columns\n    this.specFrameEntry = this.specDriver.createSpecFrame(\n      Object.fromEntries(options.columns.map((col) => [col.id, col.spec])),\n    );\n    this.columnsMap = new Map(options.columns.map((col) => [col.id, col]));\n    this.anchorsMap = resolveAnchorMap(\n      options.anchors,\n      options.columns,\n      this.specDriver.discoverColumns.bind(this.specDriver, this.specFrameEntry.key),\n    );\n  }\n\n  dispose(): void {\n    this.specFrameEntry.unref();\n  }\n\n  [Symbol.dispose](): void {\n    this.dispose();\n  }\n\n  getAnchors(): Map<string, ColumnSnapshot<PObjectId>> {\n    return this.anchorsMap;\n  }\n\n  findColumns(options?: AnchoredFindColumnsOptions): ColumnMatch[] {\n    const mode = options?.mode ?? \"enrichment\";\n    const constraints = matchingModeToConstraints(mode);\n    const includeColumns = options?.include ? toMultiColumnSelectors(options.include) : undefined;\n    const excludeColumns = options?.exclude ? toMultiColumnSelectors(options.exclude) : undefined;\n    const anchors = Array.from(this.anchorsMap.values());\n    const response = this.specDriver.discoverColumns(this.specFrameEntry.key, {\n      includeColumns,\n      excludeColumns,\n      constraints,\n      maxHops: options?.maxHops ?? 4,\n      axes: anchors.map((anchor) => ({\n        axesSpec: anchor.spec.axesSpec,\n        qualifications: [],\n      })),\n    });\n\n    const byColumn = response.hits.reduce<Map<PObjectId, ColumnMatch>>((acc, hit) => {\n      const origId = hit.hit.columnId as PObjectId;\n      const col =\n        this.columnsMap.get(origId) ??\n        throwError(`Column with id ${origId} not found in collection`);\n\n      const path = hit.path.map((step) => {\n        if (step.type !== \"linker\") {\n          throw new Error(`Unexpected discover-columns step type: ${step.type}`);\n        }\n\n        return {\n          linker:\n            this.columnsMap.get(step.linker.columnId) ??\n            throwError(`Linker column with id ${step.linker.columnId} not found in collection`),\n        };\n      });\n      const variants: MatchVariant[] = hit.mappingVariants.map((v) => ({\n        path,\n        qualifications: remapFromIdxToId(v.qualifications, anchors),\n      }));\n      const existing = acc.get(origId);\n      return acc.set(\n        origId,\n        existing === undefined\n          ? { column: col, variants }\n          : { ...existing, variants: [...existing.variants, ...variants] },\n      );\n    }, new Map());\n\n    return Array.from(byColumn.values());\n  }\n\n  findColumnVariants(options?: AnchoredFindColumnsOptions): ColumnVariant[] {\n    const matches = this.findColumns(options);\n    return matches.flatMap((match) =>\n      match.variants.map((variant) => ({\n        column: match.column,\n        path: variant.path,\n        qualifications: variant.qualifications,\n      })),\n    );\n  }\n}\n\n/**\n * Collect all columns from all providers, dedup by NativePObjectId.\n * First source wins.\n */\nfunction collectColumns(providers: ColumnSnapshotProvider[]): ColumnSnapshot<PObjectId>[] {\n  const seen = new Set<NativePObjectId>();\n  const result: ColumnSnapshot<PObjectId>[] = [];\n\n  for (const provider of providers) {\n    const columns = provider.getAllColumns();\n    for (const col of columns) {\n      const nativeId = deriveNativeId(col.spec);\n      if (seen.has(nativeId)) continue;\n      seen.add(nativeId);\n      result.push(col);\n    }\n  }\n\n  return result;\n}\n\n/** Normalize ColumnSelector (relaxed, single or array) to MultiColumnSelector[]. */\nfunction toMultiColumnSelectors(input: ColumnSelector): MultiColumnSelector[] {\n  return convertColumnSelectorToMultiColumnSelector(input);\n}\n\n/**\n * Resolve each anchor entry to a ColumnSnapshot from the collected columns.\n * - PObjectId (string): looked up by id in the collected columns\n * - PColumnSpec: matched by deriveNativeId against collected columns\n * - RelaxedColumnSelector: resolved via discoverColumns in \"exact\" mode;\n *   must match exactly one column\n * Throws on unresolved, ambiguous, or duplicated matches. Requires at least one\n * anchor to resolve.\n */\nfunction resolveAnchorMap(\n  anchors: Record<string, AnchorEntry>,\n  columns: ColumnSnapshot<PObjectId>[],\n  discoverColumns: (request: DiscoverColumnsRequest) => DiscoverColumnsResponse,\n): Map<string, ColumnSnapshot<PObjectId>> {\n  const result = new Map<string, ColumnSnapshot<PObjectId>>();\n  const resovedIds = new Set<PObjectId>();\n  const getDuplicateError = (key: string) =>\n    `Anchor \"${key}\": selector matched a column that was already matched by another anchor; please refine the selector to match a different column`;\n\n  // O(1) lookup maps built lazily — only when an anchor of the matching kind is\n  // encountered. Avoids O(anchors × columns) `deriveNativeId` calls, which were\n  // tripping the QuickJS interrupt deadline on tables with many anchors.\n  let byId: Map<PObjectId, ColumnSnapshot<PObjectId>> | undefined;\n  let byNativeId: Map<NativePObjectId, ColumnSnapshot<PObjectId>> | undefined;\n\n  for (const [name, anchor] of Object.entries(anchors)) {\n    if (typeof anchor === \"string\") {\n      if (byId === undefined) byId = new Map(columns.map((col) => [col.id, col]));\n      const found =\n        byId.get(anchor) ??\n        throwError(`Anchor \"${name}\": column with id \"${anchor}\" not found in sources`);\n      if (resovedIds.has(found.id)) {\n        throwError(getDuplicateError(name));\n      }\n      result.set(name, found);\n      resovedIds.add(found.id);\n    } else if (\"kind\" in anchor) {\n      if (!isPColumnSpec(anchor)) throwError(`Anchor \"${name}\": invalid PColumnSpec`);\n      if (byNativeId === undefined) {\n        byNativeId = new Map(columns.map((col) => [deriveNativeId(col.spec), col]));\n      }\n      const found =\n        byNativeId.get(deriveNativeId(anchor)) ??\n        throwError(`Anchor \"${name}\": no column matching spec found in sources`);\n      if (resovedIds.has(found.id)) {\n        throwError(getDuplicateError(name));\n      }\n      result.set(name, found);\n      resovedIds.add(found.id);\n    } else {\n      const matched = discoverColumns({\n        includeColumns: toMultiColumnSelectors(anchor),\n        excludeColumns: undefined,\n        axes: [],\n        maxHops: 0,\n        constraints: matchingModeToConstraints(\"related\"),\n      });\n\n      if (matched.hits.length === 0) {\n        throwError(`Anchor \"${name}\": no columns matched selector`);\n      }\n      if (matched.hits.length > 1) {\n        throwError(\n          `Anchor \"${name}\": selector is ambiguous and matched multiple columns; please refine the selector to match exactly one column`,\n        );\n      }\n      if (resovedIds.has(matched.hits[0].hit.columnId as PObjectId)) {\n        throwError(getDuplicateError(name));\n      }\n\n      const id = matched.hits[0].hit.columnId as PObjectId;\n      const snap =\n        columns.find((col) => col.id === id) ??\n        throwError(`Anchor \"${name}\": matched column with id \"${id}\" not found in sources`);\n      result.set(name, snap);\n      resovedIds.add(snap.id);\n    }\n  }\n\n  if (resovedIds.size === 0) {\n    throwError(\"At least one anchor must be resolved to a valid column\");\n  }\n\n  return result;\n}\n\nfunction remapFromIdxToId(\n  qualifications: {\n    forQueries: AxisQualification[][];\n    forHit: AxisQualification[];\n  },\n  anchors: ColumnSnapshot<PObjectId>[],\n): MatchQualifications {\n  const forQueries = qualifications.forQueries.reduce(\n    (acc, qs, i) => (anchors[i] && qs.length > 0 ? acc.set(anchors[i].id, qs) : acc),\n    new Map<PObjectId, AxisQualification[]>(),\n  );\n  return {\n    forQueries: forQueries.size > 0 ? Object.fromEntries(forQueries) : undefined,\n    forHit: qualifications.forHit.length > 0 ? qualifications.forHit : undefined,\n  };\n}\n\nfunction matchingModeToConstraints(mode: MatchingMode): DiscoverColumnsConstraints {\n  switch (mode) {\n    case \"enrichment\":\n      return {\n        allowFloatingSourceAxes: true,\n        allowFloatingHitAxes: false,\n        allowSourceQualifications: true,\n        allowHitQualifications: true,\n      };\n    case \"related\":\n      return {\n        allowFloatingSourceAxes: true,\n        allowFloatingHitAxes: true,\n        allowSourceQualifications: true,\n        allowHitQualifications: true,\n      };\n    case \"exact\":\n      return {\n        allowFloatingSourceAxes: false,\n        allowFloatingHitAxes: false,\n        allowSourceQualifications: false,\n        allowHitQualifications: false,\n      };\n  }\n}\n"],"mappings":"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"}

package/dist/columns/column_collection_builder.d.ts

@@ -1,119 +0,0 @@
-import { TreeNodeAccessor } from "../render/accessor.js";
-import { ColumnSelector, RelaxedColumnSelector } from "./column_selector.js";
-import { ColumnSnapshot } from "./column_snapshot.js";
-import { ColumnSource } from "./column_snapshot_provider.js";
-import { AxisQualification, PColumnSpec, PFrameSpecDriver, PObjectId } from "@milaboratories/pl-model-common";
-
-//#region src/columns/column_collection_builder.d.ts
-/** Options for plain collection findColumns. */
-interface FindColumnsOptions {
-  /** Include columns matching these selectors. If omitted, includes all columns. */
-  include?: ColumnSelector;
-  /** Exclude columns matching these selectors. */
-  exclude?: ColumnSelector;
-}
-/** Plain collection — no axis context, selector-based filtering only. */
-interface ColumnCollection extends Disposable {
-  /** Release the underlying spec frame WASM resource. */
-  dispose(): void;
-  /** Find columns matching selectors. Returns flat list of snapshots.
-   *  No axis compatibility matching, no linker traversal.
-   *  Never returns undefined — the "not ready" state was absorbed by the builder. */
-  findColumns(options?: FindColumnsOptions): ColumnSnapshot<PObjectId>[];
-}
-/** Axis-aware column collection with anchored identity derivation. */
-interface AnchoredColumnCollection extends Disposable {
-  /** Release the underlying spec frame WASM resource. */
-  dispose(): void;
-  /** List of anchors used for discovery, with their resolved specs. */
-  getAnchors(): Map<string, ColumnSnapshot<PObjectId>>;
-  /** Axis-aware column discovery. */
-  findColumns(options?: AnchoredFindColumnsOptions): ColumnMatch[];
-  /** Variant discovery with detailed mapping info for each hit. */
-  findColumnVariants(options?: AnchoredFindColumnsOptions): ColumnVariant[];
-}
-/** Controls axis matching behavior for anchored discovery. */
-type MatchingMode = "enrichment" | "related" | "exact";
-/** Options for anchored collection findColumns. */
-interface AnchoredFindColumnsOptions extends FindColumnsOptions {
-  /** Controls axis matching behavior. Default: 'enrichment'. */
-  mode?: MatchingMode;
-  /** Maximum linker hops for cross-domain discovery (0 = direct only, default: 4). */
-  maxHops?: number;
-}
-/** Result of anchored discovery — column snapshot + routing info. */
-interface ColumnMatch {
-  /** Column snapshot with anchored SUniversalPColumnId. */
-  readonly column: ColumnSnapshot<PObjectId>;
-  /** Match variants — different ways (paths/qualifications) to reach this column. */
-  readonly variants: MatchVariant[];
-}
-interface ColumnVariant<Id extends PObjectId = PObjectId> {
-  /** Column snapshot with anchored SUniversalPColumnId. */
-  readonly column: ColumnSnapshot<Id>;
-  /** Linker steps traversed to reach this hit; empty for direct matches. */
-  readonly path?: {
-    linker: ColumnSnapshot<PObjectId>;
-  }[];
-  /** Full qualifications needed for integration. */
-  readonly qualifications?: MatchQualifications;
-}
-/** A single mapping variant describing how a hit column can be integrated. */
-interface MatchVariant {
-  /** Full qualifications needed for integration. */
-  readonly qualifications: MatchQualifications;
-  /** Linker steps traversed to reach this hit; empty for direct matches. */
-  readonly path: {
-    linker: ColumnSnapshot<PObjectId>;
-  }[];
-}
-/** Qualifications needed for both already-integrated anchor columns and the hit column. */
-interface MatchQualifications {
-  /** Qualifications for already-integrated anchor columns */
-  readonly forQueries?: Record<PObjectId, AxisQualification[]>;
-  /** Qualifications for the hit column. */
-  readonly forHit?: AxisQualification[];
-}
-interface BuildOptions {
-  allowPartialColumnList?: true;
-}
-type AnchorEntry = PObjectId | PColumnSpec | RelaxedColumnSelector;
-interface AnchoredBuildOptions extends BuildOptions {
-  anchors: Record<string, AnchorEntry>;
-}
-/**
- * Mutable builder that accumulates column sources, then produces
- * a ColumnCollection (plain) or AnchoredColumnCollection (with anchors).
- *
- * Each output lambda creates its own builder — a constraint of the
- * computable framework where each output tracks its own dependencies.
- */
-declare class ColumnCollectionBuilder {
-  private readonly specDriver;
-  private readonly providers;
-  constructor(specDriver?: PFrameSpecDriver);
-  /**
-   * Register a column source. Sources added first take precedence for dedup.
-   * Does NOT accept undefined — if a source isn't available yet,
-   * the caller should return undefined from the output lambda.
-   */
-  addSource(source: ColumnSource | TreeNodeAccessor): this;
-  addSources(sources: (ColumnSource | TreeNodeAccessor)[]): this;
-  /** Plain collection — selector-based filtering, PObjectId namespace. */
-  build(): undefined | ColumnCollection;
-  build(options: {
-    allowPartialColumnList: true;
-  }): ColumnCollection & {
-    readonly columnListComplete: boolean;
-  };
-  /** Anchored collection — axis-aware discovery, SUniversalPColumnId namespace. */
-  build(options: AnchoredBuildOptions & {
-    allowPartialColumnList: true;
-  }): AnchoredColumnCollection & {
-    readonly columnListComplete: boolean;
-  };
-  build(options: AnchoredBuildOptions): undefined | AnchoredColumnCollection;
-}
-//#endregion
-export { AnchorEntry, AnchoredBuildOptions, AnchoredColumnCollection, AnchoredFindColumnsOptions, BuildOptions, ColumnCollection, ColumnCollectionBuilder, ColumnMatch, ColumnVariant, FindColumnsOptions, MatchQualifications, MatchVariant, MatchingMode };
-//# sourceMappingURL=column_collection_builder.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"column_collection_builder.d.ts","names":[],"sources":["../../src/columns/column_collection_builder.ts"],"mappings":";;;;;;;;UAuBiB,kBAAA;EAAkB;EAEjC,OAAA,GAAU,cAAA;EAEc;EAAxB,OAAA,GAAU,cAAc;AAAA;;UAIT,gBAAA,SAAyB,UAAA;EAJhB;EAMxB,OAAA;EAFe;;;EAOf,WAAA,CAAY,OAAA,GAAU,kBAAA,GAAqB,cAAA,CAAe,SAAA;AAAA;;UAI3C,wBAAA,SAAiC,UAAA;EAXE;EAalD,OAAA;EAbwC;EAgBxC,UAAA,IAAc,GAAA,SAAY,cAAA,CAAe,SAAA;EATzC;EAYA,WAAA,CAAY,OAAA,GAAU,0BAAA,GAA6B,WAAA;EAZvC;EAeZ,kBAAA,CAAmB,OAAA,GAAU,0BAAA,GAA6B,aAAA;AAAA;;KAIhD,YAAA;AAfZ;AAAA,UAkBiB,0BAAA,SAAmC,kBAAkB;;EAEpE,IAAA,GAAO,YAAA;EAfmB;EAiB1B,OAAA;AAAA;;UAIe,WAAA;EAf2C;EAAA,SAiBjD,MAAA,EAAQ,cAAA,CAAe,SAAA;EA5B0B;EAAA,SA8BjD,QAAA,EAAU,YAAA;AAAA;AAAA,UAGJ,aAAA,YAAyB,SAAA,GAAY,SAAA;EA5BpD;EAAA,SA8BS,MAAA,EAAQ,cAAA,CAAe,EAAA;EA9BN;EAAA,SAgCjB,IAAA;IAAS,MAAA,EAAQ,cAAA,CAAe,SAAA;EAAA;EA7B7B;EAAA,SA+BH,cAAA,GAAiB,mBAAA;AAAA;;UAIX,YAAA;EAhC2C;EAAA,SAkCjD,cAAA,EAAgB,mBAAA;EAlC8C;EAAA,SAoC9D,IAAA;IAAQ,MAAA,EAAQ,cAAA,CAAe,SAAA;EAAA;AAAA;AAhClB;AAAA,UAoCP,mBAAA;EAjC2B;EAAA,SAmCjC,UAAA,GAAa,MAAA,CAAO,SAAA,EAAW,iBAAA;EAnC4B;EAAA,SAqC3D,MAAA,GAAS,iBAAA;AAAA;AAAA,UAGH,YAAA;EACf,sBAAsB;AAAA;AAAA,KAGZ,WAAA,GAAc,SAAA,GAAY,WAAA,GAAc,qBAAA;AAAA,UAEnC,oBAAA,SAA6B,YAAA;EAC5C,OAAA,EAAS,MAAA,SAAe,WAAA;AAAA;;;;;;;;cAUb,uBAAA;EAAA,iBAGkB,UAAA;EAAA,iBAFZ,SAAA;cAEY,UAAA,GAAY,gBAAA;EAhDV;AAGjC;;;;EAoDE,SAAA,CAAU,MAAA,EAAQ,YAAA,GAAe,gBAAA;EAUjC,UAAA,CAAW,OAAA,GAAU,YAAA,GAAe,gBAAA;EA5DnB;EAoEjB,KAAA,gBAAqB,gBAAA;EACrB,KAAA,CAAM,OAAA;IACJ,sBAAA;EAAA,IACE,gBAAA;IAAA,SAA8B,kBAAA;EAAA;EAzEM;EA2ExC,KAAA,CACE,OAAA,EAAS,oBAAA;IAAyB,sBAAA;EAAA,IACjC,wBAAA;IAAA,SAAsC,kBAAA;EAAA;EACzC,KAAA,CAAM,OAAA,EAAS,oBAAA,eAAmC,wBAAA;AAAA"}

package/dist/columns/column_collection_builder.js

@@ -1,241 +0,0 @@
-import { TreeNodeAccessor } from "../render/accessor.js";
-import { getService } from "../services/get_services.js";
-import "../services/index.js";
-import { ArrayColumnProvider, toColumnSnapshotProvider } from "./column_snapshot_provider.js";
-import { convertColumnSelectorToMultiColumnSelector } from "./column_selector.js";
-import { deriveNativeId, isPColumnSpec } from "@milaboratories/pl-model-common";
-import { throwError } from "@milaboratories/helpers";
-//#region src/columns/column_collection_builder.ts
-/**
-* Mutable builder that accumulates column sources, then produces
-* a ColumnCollection (plain) or AnchoredColumnCollection (with anchors).
-*
-* Each output lambda creates its own builder — a constraint of the
-* computable framework where each output tracks its own dependencies.
-*/
-var ColumnCollectionBuilder = class {
-	specDriver;
-	providers = [];
-	constructor(specDriver = getService("pframeSpec")) {
-		this.specDriver = specDriver;
-	}
-	/**
-	* Register a column source. Sources added first take precedence for dedup.
-	* Does NOT accept undefined — if a source isn't available yet,
-	* the caller should return undefined from the output lambda.
-	*/
-	addSource(source) {
-		if (source instanceof TreeNodeAccessor) {
-			const columns = source.getPColumns();
-			if (columns) this.providers.push(new ArrayColumnProvider(columns));
-		} else this.providers.push(toColumnSnapshotProvider(source));
-		return this;
-	}
-	addSources(sources) {
-		for (const source of sources) this.addSource(source);
-		return this;
-	}
-	build(options) {
-		const allowPartial = options?.allowPartialColumnList === true;
-		if (!this.providers.every((p) => p.isColumnListComplete()) && !allowPartial) return void 0;
-		const columns = collectColumns(this.providers);
-		if (options !== void 0 && "anchors" in options) return new AnchoredColumnCollectionImpl(this.specDriver, {
-			anchors: options.anchors,
-			columns
-		});
-		else return new ColumnCollectionImpl(this.specDriver, { columns });
-	}
-};
-var ColumnCollectionImpl = class {
-	specDriver;
-	columns;
-	specFrameEntry;
-	constructor(specDriver, options) {
-		this.specDriver = specDriver;
-		this.columns = new Map(options.columns.map((col) => [col.id, col]));
-		this.specFrameEntry = this.specDriver.createSpecFrame(Object.fromEntries(options.columns.map((col) => [col.id, col.spec])));
-	}
-	dispose() {
-		this.specFrameEntry.unref();
-	}
-	[Symbol.dispose]() {
-		this.dispose();
-	}
-	findColumns(options) {
-		const includeColumns = options?.include ? toMultiColumnSelectors(options.include) : void 0;
-		const excludeColumns = options?.exclude ? toMultiColumnSelectors(options.exclude) : void 0;
-		return this.specDriver.discoverColumns(this.specFrameEntry.key, {
-			includeColumns,
-			excludeColumns,
-			axes: [],
-			maxHops: 0,
-			constraints: matchingModeToConstraints("enrichment")
-		}).hits.map((hit) => this.columns.get(hit.hit.columnId)).filter((col) => col !== void 0);
-	}
-};
-var AnchoredColumnCollectionImpl = class {
-	specDriver;
-	anchorsMap;
-	columnsMap;
-	specFrameEntry;
-	constructor(specDriver, options) {
-		this.specDriver = specDriver;
-		this.specFrameEntry = this.specDriver.createSpecFrame(Object.fromEntries(options.columns.map((col) => [col.id, col.spec])));
-		this.columnsMap = new Map(options.columns.map((col) => [col.id, col]));
-		this.anchorsMap = resolveAnchorMap(options.anchors, options.columns, this.specDriver.discoverColumns.bind(this.specDriver, this.specFrameEntry.key));
-	}
-	dispose() {
-		this.specFrameEntry.unref();
-	}
-	[Symbol.dispose]() {
-		this.dispose();
-	}
-	getAnchors() {
-		return this.anchorsMap;
-	}
-	findColumns(options) {
-		const constraints = matchingModeToConstraints(options?.mode ?? "enrichment");
-		const includeColumns = options?.include ? toMultiColumnSelectors(options.include) : void 0;
-		const excludeColumns = options?.exclude ? toMultiColumnSelectors(options.exclude) : void 0;
-		const anchors = Array.from(this.anchorsMap.values());
-		const byColumn = this.specDriver.discoverColumns(this.specFrameEntry.key, {
-			includeColumns,
-			excludeColumns,
-			constraints,
-			maxHops: options?.maxHops ?? 4,
-			axes: anchors.map((anchor) => ({
-				axesSpec: anchor.spec.axesSpec,
-				qualifications: []
-			}))
-		}).hits.reduce((acc, hit) => {
-			const origId = hit.hit.columnId;
-			const col = this.columnsMap.get(origId) ?? throwError(`Column with id ${origId} not found in collection`);
-			const path = hit.path.map((step) => {
-				if (step.type !== "linker") throw new Error(`Unexpected discover-columns step type: ${step.type}`);
-				return { linker: this.columnsMap.get(step.linker.columnId) ?? throwError(`Linker column with id ${step.linker.columnId} not found in collection`) };
-			});
-			const variants = hit.mappingVariants.map((v) => ({
-				path,
-				qualifications: remapFromIdxToId(v.qualifications, anchors)
-			}));
-			const existing = acc.get(origId);
-			return acc.set(origId, existing === void 0 ? {
-				column: col,
-				variants
-			} : {
-				...existing,
-				variants: [...existing.variants, ...variants]
-			});
-		}, /* @__PURE__ */ new Map());
-		return Array.from(byColumn.values());
-	}
-	findColumnVariants(options) {
-		return this.findColumns(options).flatMap((match) => match.variants.map((variant) => ({
-			column: match.column,
-			path: variant.path,
-			qualifications: variant.qualifications
-		})));
-	}
-};
-/**
-* Collect all columns from all providers, dedup by NativePObjectId.
-* First source wins.
-*/
-function collectColumns(providers) {
-	const seen = /* @__PURE__ */ new Set();
-	const result = [];
-	for (const provider of providers) {
-		const columns = provider.getAllColumns();
-		for (const col of columns) {
-			const nativeId = deriveNativeId(col.spec);
-			if (seen.has(nativeId)) continue;
-			seen.add(nativeId);
-			result.push(col);
-		}
-	}
-	return result;
-}
-/** Normalize ColumnSelector (relaxed, single or array) to MultiColumnSelector[]. */
-function toMultiColumnSelectors(input) {
-	return convertColumnSelectorToMultiColumnSelector(input);
-}
-/**
-* Resolve each anchor entry to a ColumnSnapshot from the collected columns.
-* - PObjectId (string): looked up by id in the collected columns
-* - PColumnSpec: matched by deriveNativeId against collected columns
-* - RelaxedColumnSelector: resolved via discoverColumns in "exact" mode;
-*   must match exactly one column
-* Throws on unresolved, ambiguous, or duplicated matches. Requires at least one
-* anchor to resolve.
-*/
-function resolveAnchorMap(anchors, columns, discoverColumns) {
-	const result = /* @__PURE__ */ new Map();
-	const resovedIds = /* @__PURE__ */ new Set();
-	const getDuplicateError = (key) => `Anchor "${key}": selector matched a column that was already matched by another anchor; please refine the selector to match a different column`;
-	let byId;
-	let byNativeId;
-	for (const [name, anchor] of Object.entries(anchors)) if (typeof anchor === "string") {
-		if (byId === void 0) byId = new Map(columns.map((col) => [col.id, col]));
-		const found = byId.get(anchor) ?? throwError(`Anchor "${name}": column with id "${anchor}" not found in sources`);
-		if (resovedIds.has(found.id)) throwError(getDuplicateError(name));
-		result.set(name, found);
-		resovedIds.add(found.id);
-	} else if ("kind" in anchor) {
-		if (!isPColumnSpec(anchor)) throwError(`Anchor "${name}": invalid PColumnSpec`);
-		if (byNativeId === void 0) byNativeId = new Map(columns.map((col) => [deriveNativeId(col.spec), col]));
-		const found = byNativeId.get(deriveNativeId(anchor)) ?? throwError(`Anchor "${name}": no column matching spec found in sources`);
-		if (resovedIds.has(found.id)) throwError(getDuplicateError(name));
-		result.set(name, found);
-		resovedIds.add(found.id);
-	} else {
-		const matched = discoverColumns({
-			includeColumns: toMultiColumnSelectors(anchor),
-			excludeColumns: void 0,
-			axes: [],
-			maxHops: 0,
-			constraints: matchingModeToConstraints("related")
-		});
-		if (matched.hits.length === 0) throwError(`Anchor "${name}": no columns matched selector`);
-		if (matched.hits.length > 1) throwError(`Anchor "${name}": selector is ambiguous and matched multiple columns; please refine the selector to match exactly one column`);
-		if (resovedIds.has(matched.hits[0].hit.columnId)) throwError(getDuplicateError(name));
-		const id = matched.hits[0].hit.columnId;
-		const snap = columns.find((col) => col.id === id) ?? throwError(`Anchor "${name}": matched column with id "${id}" not found in sources`);
-		result.set(name, snap);
-		resovedIds.add(snap.id);
-	}
-	if (resovedIds.size === 0) throwError("At least one anchor must be resolved to a valid column");
-	return result;
-}
-function remapFromIdxToId(qualifications, anchors) {
-	const forQueries = qualifications.forQueries.reduce((acc, qs, i) => anchors[i] && qs.length > 0 ? acc.set(anchors[i].id, qs) : acc, /* @__PURE__ */ new Map());
-	return {
-		forQueries: forQueries.size > 0 ? Object.fromEntries(forQueries) : void 0,
-		forHit: qualifications.forHit.length > 0 ? qualifications.forHit : void 0
-	};
-}
-function matchingModeToConstraints(mode) {
-	switch (mode) {
-		case "enrichment": return {
-			allowFloatingSourceAxes: true,
-			allowFloatingHitAxes: false,
-			allowSourceQualifications: true,
-			allowHitQualifications: true
-		};
-		case "related": return {
-			allowFloatingSourceAxes: true,
-			allowFloatingHitAxes: true,
-			allowSourceQualifications: true,
-			allowHitQualifications: true
-		};
-		case "exact": return {
-			allowFloatingSourceAxes: false,
-			allowFloatingHitAxes: false,
-			allowSourceQualifications: false,
-			allowHitQualifications: false
-		};
-	}
-}
-//#endregion
-export { ColumnCollectionBuilder };
-
-//# sourceMappingURL=column_collection_builder.js.map