@milaboratories/pl-model-common 1.19.6 → 1.19.8

package/dist/drivers/pframe/spec/anchored.cjs

@@ -0,0 +1,234 @@
+'use strict';
+
+var canonicalize = require('canonicalize');
+var ids = require('./ids.cjs');
+var spec = require('./spec.cjs');
+
+//
+// Helper functions
+//
+function axisKey(axis) {
+    return canonicalize(spec.getAxisId(axis));
+}
+function domainKey(key, value) {
+    return JSON.stringify([key, value]);
+}
+/**
+ * Context for resolving and generating anchored references to columns and axes
+ * Maintains maps of known domain values and axes that can be referenced by anchors
+ */
+class AnchoredIdDeriver {
+    anchors;
+    domains = new Map();
+    axes = new Map();
+    /**
+     * Domain packs are used to group domain keys that can be anchored to the same anchor
+     * This is used to optimize the lookup of domain anchors
+     */
+    domainPacks = [];
+    /**
+     * Maps domain packs to anchors
+     */
+    domainPackToAnchor = new Map();
+    /**
+     * Creates a new anchor context from a set of anchor column specifications
+     * @param anchors Record of anchor column specifications indexed by anchor ID
+     */
+    constructor(anchors) {
+        this.anchors = anchors;
+        const anchorEntries = Object.entries(anchors);
+        anchorEntries.sort((a, b) => a[0].localeCompare(b[0]));
+        for (const [anchorId, spec] of anchorEntries) {
+            for (let axisIdx = 0; axisIdx < spec.axesSpec.length; axisIdx++) {
+                const axis = spec.axesSpec[axisIdx];
+                const key = axisKey(axis);
+                this.axes.set(key, { anchor: anchorId, idx: axisIdx });
+            }
+            if (spec.domain !== undefined) {
+                const domainEntries = Object.entries(spec.domain);
+                domainEntries.sort((a, b) => a[0].localeCompare(b[0]));
+                this.domainPackToAnchor.set(JSON.stringify(domainEntries), anchorId);
+                this.domainPacks.push(domainEntries.map(([dKey]) => dKey));
+                for (const [dKey, dValue] of domainEntries) {
+                    const key = domainKey(dKey, dValue);
+                    this.domains.set(key, anchorId);
+                }
+            }
+        }
+    }
+    /**
+     * Implementation of derive method
+     */
+    derive(spec$1, axisFilters) {
+        const result = {
+            name: spec$1.name,
+            axes: [],
+        };
+        let skipDomains = undefined;
+        if (spec$1.domain !== undefined) {
+            outer: for (const domainPack of this.domainPacks) {
+                const dAnchor = [];
+                for (const domainKey of domainPack) {
+                    const dValue = spec$1.domain[domainKey];
+                    if (dValue !== undefined)
+                        dAnchor.push([domainKey, dValue]);
+                    else
+                        break outer;
+                }
+                const domainAnchor = this.domainPackToAnchor.get(JSON.stringify(dAnchor));
+                if (domainAnchor !== undefined) {
+                    result.domainAnchor = domainAnchor;
+                    skipDomains = new Set(domainPack);
+                    break;
+                }
+            }
+        }
+        for (const [dKey, dValue] of Object.entries(spec$1.domain ?? {})) {
+            if (skipDomains !== undefined && skipDomains.has(dKey))
+                continue;
+            const key = domainKey(dKey, dValue);
+            const anchorId = this.domains.get(key);
+            result.domain ??= {};
+            result.domain[dKey] = anchorId ? { anchor: anchorId } : dValue;
+        }
+        result.axes = spec$1.axesSpec.map((axis) => {
+            const key = axisKey(axis);
+            const anchorAxisRef = this.axes.get(key);
+            if (anchorAxisRef === undefined)
+                return spec.getAxisId(axis);
+            else
+                return anchorAxisRef;
+        });
+        // If no axis filters are provided, return the anchored ID as is
+        if (!axisFilters || axisFilters.length === 0) {
+            return result;
+        }
+        // Process axis filters and create a sliced column ID
+        const resolvedFilters = [];
+        for (const filter of axisFilters) {
+            const [axisIdOrIndex, value] = filter;
+            // If it's already a numeric index, validate it
+            if (typeof axisIdOrIndex === 'number') {
+                if (axisIdOrIndex < 0 || axisIdOrIndex >= spec$1.axesSpec.length) {
+                    throw new Error(`Axis index ${axisIdOrIndex} is out of bounds (0-${spec$1.axesSpec.length - 1})`);
+                }
+                resolvedFilters.push([axisIdOrIndex, value]);
+            }
+            else {
+                // If it's a string (axis name), resolve it to an index
+                const axisIndex = spec$1.axesSpec.findIndex((axis) => axis.name === axisIdOrIndex);
+                if (axisIndex === -1) {
+                    throw new Error(`Axis with name "${axisIdOrIndex}" not found in the column specification`);
+                }
+                resolvedFilters.push([axisIndex, value]);
+            }
+        }
+        // Sort filters by axis index to ensure consistency
+        resolvedFilters.sort((a, b) => a[0] - b[0]);
+        return {
+            source: result,
+            axisFilters: resolvedFilters,
+        };
+    }
+    /**
+     * Derives a canonicalized string representation of an anchored column identifier, can be used as a unique identifier for the column
+     * @param spec Column specification to anchor
+     * @param axisFilters Optional axis filters to apply to the column
+     * @returns A canonicalized string representation of the anchored column identifier
+     */
+    deriveS(spec, axisFilters) {
+        return ids.stringifyColumnId(this.derive(spec, axisFilters));
+    }
+}
+/**
+ * Resolves anchored references in a column matcher to create a non-anchored matcher.
+ * Doing an opposite operation to {@link AnchorIdDeriver.derive()}.
+ *
+ * @param anchors - Record of anchor column specifications indexed by anchor id
+ * @param matcher - An anchored column matcher (or id, which is subtype of it) containing references that need to be resolved
+ * @param options - Options for resolving anchors
+ * @returns A non-anchored column matcher with all references resolved to actual values
+ */
+function resolveAnchors(anchors, matcher, options) {
+    const result = { ...matcher };
+    const ignoreMissingDomains = options?.ignoreMissingDomains ?? false;
+    if (result.domainAnchor !== undefined) {
+        const anchorSpec = anchors[result.domainAnchor];
+        if (!anchorSpec)
+            throw new Error(`Anchor "${result.domainAnchor}" not found`);
+        const anchorDomains = anchorSpec.domain || {};
+        result.domain = { ...anchorDomains, ...result.domain };
+        delete result.domainAnchor;
+    }
+    if (result.domain) {
+        const resolvedDomain = {};
+        for (const [key, value] of Object.entries(result.domain)) {
+            if (typeof value === 'string') {
+                resolvedDomain[key] = value;
+            }
+            else {
+                // It's an AnchorDomainRef
+                const anchorSpec = anchors[value.anchor];
+                if (!anchorSpec)
+                    throw new Error(`Anchor "${value.anchor}" not found for domain key "${key}"`);
+                if (!anchorSpec.domain || anchorSpec.domain[key] === undefined) {
+                    if (!ignoreMissingDomains)
+                        throw new Error(`Domain key "${key}" not found in anchor "${value.anchor}"`);
+                    continue;
+                }
+                resolvedDomain[key] = anchorSpec.domain[key];
+            }
+        }
+        result.domain = resolvedDomain;
+    }
+    if (result.axes)
+        result.axes = result.axes.map((axis) => resolveAxisReference(anchors, axis));
+    return result;
+}
+/**
+ * Resolves an anchored axis reference to a concrete AxisId
+ */
+function resolveAxisReference(anchors, axisRef) {
+    if (!isAnchorAxisRef(axisRef))
+        return axisRef;
+    // It's an anchored reference
+    const anchorId = axisRef.anchor;
+    const anchorSpec = anchors[anchorId];
+    if (!anchorSpec)
+        throw new Error(`Anchor "${anchorId}" not found for axis reference`);
+    if ('idx' in axisRef) {
+        // AnchorAxisRefByIdx
+        if (axisRef.idx < 0 || axisRef.idx >= anchorSpec.axesSpec.length)
+            throw new Error(`Axis index ${axisRef.idx} out of bounds for anchor "${anchorId}"`);
+        return anchorSpec.axesSpec[axisRef.idx];
+    }
+    else if ('name' in axisRef) {
+        // AnchorAxisRefByName
+        const matches = anchorSpec.axesSpec.filter((axis) => axis.name === axisRef.name);
+        if (matches.length > 1)
+            throw new Error(`Multiple axes with name "${axisRef.name}" found in anchor "${anchorId}"`);
+        if (matches.length === 0)
+            throw new Error(`Axis with name "${axisRef.name}" not found in anchor "${anchorId}"`);
+        return matches[0];
+    }
+    else if ('id' in axisRef) {
+        // AnchorAxisRefByMatcher
+        const matches = anchorSpec.axesSpec.filter((axis) => spec.matchAxisId(axisRef.id, spec.getAxisId(axis)));
+        if (matches.length > 1)
+            throw new Error(`Multiple matching axes found for matcher in anchor "${anchorId}"`);
+        if (matches.length === 0)
+            throw new Error(`No matching axis found for matcher in anchor "${anchorId}"`);
+        return matches[0];
+    }
+    throw new Error(`Unsupported axis reference type`);
+}
+/**
+ * Type guard to check if a value is an anchored axis reference
+ */
+function isAnchorAxisRef(value) {
+    return typeof value === 'object' && 'anchor' in value;
+}
+
+exports.AnchoredIdDeriver = AnchoredIdDeriver;
+exports.resolveAnchors = resolveAnchors;
+//# sourceMappingURL=anchored.cjs.map

package/dist/drivers/pframe/spec/anchored.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchored.cjs","sources":["../../../../src/drivers/pframe/spec/anchored.ts"],"sourcesContent":["import canonicalize from 'canonicalize';\nimport type { AxisFilter, AxisFilterValue } from './filtered_column';\nimport type { SUniversalPColumnId, UniversalPColumnId } from './ids';\nimport { stringifyColumnId } from './ids';\nimport type { AAxisSelector, AnchorAxisRef, AnchorAxisRefByIdx, AnchoredPColumnId, AnchoredPColumnSelector, AxisSelector, PColumnSelector } from './selectors';\nimport type { AxisId, PColumnSpec } from './spec';\nimport { getAxisId, matchAxisId } from './spec';\n\n//\n// Helper functions\n//\n\nfunction axisKey(axis: AxisId): string {\n  return canonicalize(getAxisId(axis))!;\n}\n\nfunction domainKey(key: string, value: string): string {\n  return JSON.stringify([key, value]);\n}\n\n/**\n * Context for resolving and generating anchored references to columns and axes\n * Maintains maps of known domain values and axes that can be referenced by anchors\n */\nexport class AnchoredIdDeriver {\n  private readonly domains = new Map<string, string>();\n  private readonly axes = new Map<string, AnchorAxisRefByIdx>();\n  /**\n   * Domain packs are used to group domain keys that can be anchored to the same anchor\n   * This is used to optimize the lookup of domain anchors\n   */\n  private readonly domainPacks: string[][] = [];\n  /**\n   * Maps domain packs to anchors\n   */\n  private readonly domainPackToAnchor = new Map<string, string>();\n\n  /**\n   * Creates a new anchor context from a set of anchor column specifications\n   * @param anchors Record of anchor column specifications indexed by anchor ID\n   */\n  constructor(public readonly anchors: Record<string, PColumnSpec>) {\n    const anchorEntries = Object.entries(anchors);\n    anchorEntries.sort((a, b) => a[0].localeCompare(b[0]));\n    for (const [anchorId, spec] of anchorEntries) {\n      for (let axisIdx = 0; axisIdx < spec.axesSpec.length; axisIdx++) {\n        const axis = spec.axesSpec[axisIdx];\n        const key = axisKey(axis);\n        this.axes.set(key, { anchor: anchorId, idx: axisIdx });\n      }\n      if (spec.domain !== undefined) {\n        const domainEntries = Object.entries(spec.domain);\n        domainEntries.sort((a, b) => a[0].localeCompare(b[0]));\n\n        this.domainPackToAnchor.set(JSON.stringify(domainEntries), anchorId);\n        this.domainPacks.push(domainEntries.map(([dKey]) => dKey));\n\n        for (const [dKey, dValue] of domainEntries) {\n          const key = domainKey(dKey, dValue);\n          this.domains.set(key, anchorId);\n        }\n      }\n    }\n  }\n\n  /**\n   * Derives an anchored column identifier from a column specification\n   * @param spec Column specification to anchor\n   * @returns An anchored column identifier that can be used to identify columns similar to the input specification\n   */\n  derive(spec: PColumnSpec): AnchoredPColumnId;\n\n  /**\n   * Derives an anchored column identifier from a column specification\n   * @param spec Column specification to anchor\n   * @param axisFilters Axis filters to apply to the column\n   * @returns An anchored and sliced column identifier that can be used to identify columns similar to the input specification\n   */\n  derive(spec: PColumnSpec, axisFilters?: AxisFilter[]): UniversalPColumnId;\n\n  /**\n   * Implementation of derive method\n   */\n  derive(spec: PColumnSpec, axisFilters?: AxisFilter[]): UniversalPColumnId {\n    const result: AnchoredPColumnId = {\n      name: spec.name,\n      axes: [],\n    };\n\n    let skipDomains: Set<string> | undefined = undefined;\n    if (spec.domain !== undefined) {\n      outer:\n      for (const domainPack of this.domainPacks) {\n        const dAnchor: string[][] = [];\n        for (const domainKey of domainPack) {\n          const dValue = spec.domain[domainKey];\n          if (dValue !== undefined)\n            dAnchor.push([domainKey, dValue]);\n          else\n            break outer;\n        }\n        const domainAnchor = this.domainPackToAnchor.get(JSON.stringify(dAnchor));\n        if (domainAnchor !== undefined) {\n          result.domainAnchor = domainAnchor;\n          skipDomains = new Set(domainPack);\n          break;\n        }\n      }\n    }\n\n    for (const [dKey, dValue] of Object.entries(spec.domain ?? {})) {\n      if (skipDomains !== undefined && skipDomains.has(dKey))\n        continue;\n      const key = domainKey(dKey, dValue);\n      const anchorId = this.domains.get(key);\n      result.domain ??= {};\n      result.domain[dKey] = anchorId ? { anchor: anchorId } : dValue;\n    }\n\n    result.axes = spec.axesSpec.map((axis) => {\n      const key = axisKey(axis);\n      const anchorAxisRef = this.axes.get(key);\n      if (anchorAxisRef === undefined) return getAxisId(axis);\n      else return anchorAxisRef;\n    });\n\n    // If no axis filters are provided, return the anchored ID as is\n    if (!axisFilters || axisFilters.length === 0) {\n      return result;\n    }\n\n    // Process axis filters and create a sliced column ID\n    const resolvedFilters: [number, AxisFilterValue][] = [];\n\n    for (const filter of axisFilters) {\n      const [axisIdOrIndex, value] = filter;\n\n      // If it's already a numeric index, validate it\n      if (typeof axisIdOrIndex === 'number') {\n        if (axisIdOrIndex < 0 || axisIdOrIndex >= spec.axesSpec.length) {\n          throw new Error(`Axis index ${axisIdOrIndex} is out of bounds (0-${spec.axesSpec.length - 1})`);\n        }\n        resolvedFilters.push([axisIdOrIndex, value]);\n      } else {\n        // If it's a string (axis name), resolve it to an index\n        const axisIndex = spec.axesSpec.findIndex((axis) => axis.name === axisIdOrIndex);\n        if (axisIndex === -1) {\n          throw new Error(`Axis with name \"${axisIdOrIndex}\" not found in the column specification`);\n        }\n        resolvedFilters.push([axisIndex, value]);\n      }\n    }\n\n    // Sort filters by axis index to ensure consistency\n    resolvedFilters.sort((a, b) => a[0] - b[0]);\n\n    return {\n      source: result,\n      axisFilters: resolvedFilters,\n    };\n  }\n\n  /**\n   * Derives a canonicalized string representation of an anchored column identifier, can be used as a unique identifier for the column\n   * @param spec Column specification to anchor\n   * @param axisFilters Optional axis filters to apply to the column\n   * @returns A canonicalized string representation of the anchored column identifier\n   */\n  deriveS(spec: PColumnSpec, axisFilters?: AxisFilter[]): SUniversalPColumnId {\n    return stringifyColumnId(this.derive(spec, axisFilters));\n  }\n}\n\n/**\n * Options for the resolveAnchors function\n */\nexport type ResolveAnchorsOptions = {\n  /**\n   * If true, missing domain keys in anchors will be ignored.\n   * If false (default), an error will be thrown.\n   */\n  ignoreMissingDomains?: boolean;\n};\n\n/**\n * Resolves anchored references in a column matcher to create a non-anchored matcher.\n * Doing an opposite operation to {@link AnchorIdDeriver.derive()}.\n *\n * @param anchors - Record of anchor column specifications indexed by anchor id\n * @param matcher - An anchored column matcher (or id, which is subtype of it) containing references that need to be resolved\n * @param options - Options for resolving anchors\n * @returns A non-anchored column matcher with all references resolved to actual values\n */\nexport function resolveAnchors(anchors: Record<string, PColumnSpec>, matcher: AnchoredPColumnSelector, options?: ResolveAnchorsOptions): PColumnSelector {\n  const result = { ...matcher };\n  const ignoreMissingDomains = options?.ignoreMissingDomains ?? false;\n\n  if (result.domainAnchor !== undefined) {\n    const anchorSpec = anchors[result.domainAnchor];\n    if (!anchorSpec)\n      throw new Error(`Anchor \"${result.domainAnchor}\" not found`);\n\n    const anchorDomains = anchorSpec.domain || {};\n    result.domain = { ...anchorDomains, ...result.domain };\n    delete result.domainAnchor;\n  }\n\n  if (result.domain) {\n    const resolvedDomain: Record<string, string> = {};\n    for (const [key, value] of Object.entries(result.domain)) {\n      if (typeof value === 'string') {\n        resolvedDomain[key] = value;\n      } else {\n        // It's an AnchorDomainRef\n        const anchorSpec = anchors[value.anchor];\n        if (!anchorSpec)\n          throw new Error(`Anchor \"${value.anchor}\" not found for domain key \"${key}\"`);\n\n        if (!anchorSpec.domain || anchorSpec.domain[key] === undefined) {\n          if (!ignoreMissingDomains)\n            throw new Error(`Domain key \"${key}\" not found in anchor \"${value.anchor}\"`);\n          continue;\n        }\n\n        resolvedDomain[key] = anchorSpec.domain[key];\n      }\n    }\n    result.domain = resolvedDomain;\n  }\n\n  if (result.axes)\n    result.axes = result.axes.map((axis) => resolveAxisReference(anchors, axis));\n\n  return result as PColumnSelector;\n}\n\n/**\n * Resolves an anchored axis reference to a concrete AxisId\n */\nfunction resolveAxisReference(anchors: Record<string, PColumnSpec>, axisRef: AAxisSelector): AxisSelector {\n  if (!isAnchorAxisRef(axisRef))\n    return axisRef;\n\n  // It's an anchored reference\n  const anchorId = axisRef.anchor;\n  const anchorSpec = anchors[anchorId];\n  if (!anchorSpec)\n    throw new Error(`Anchor \"${anchorId}\" not found for axis reference`);\n\n  if ('idx' in axisRef) {\n    // AnchorAxisRefByIdx\n    if (axisRef.idx < 0 || axisRef.idx >= anchorSpec.axesSpec.length)\n      throw new Error(`Axis index ${axisRef.idx} out of bounds for anchor \"${anchorId}\"`);\n    return anchorSpec.axesSpec[axisRef.idx];\n  } else if ('name' in axisRef) {\n    // AnchorAxisRefByName\n    const matches = anchorSpec.axesSpec.filter((axis) => axis.name === axisRef.name);\n    if (matches.length > 1)\n      throw new Error(`Multiple axes with name \"${axisRef.name}\" found in anchor \"${anchorId}\"`);\n    if (matches.length === 0)\n      throw new Error(`Axis with name \"${axisRef.name}\" not found in anchor \"${anchorId}\"`);\n    return matches[0];\n  } else if ('id' in axisRef) {\n    // AnchorAxisRefByMatcher\n    const matches = anchorSpec.axesSpec.filter((axis) => matchAxisId(axisRef.id, getAxisId(axis)));\n    if (matches.length > 1)\n      throw new Error(`Multiple matching axes found for matcher in anchor \"${anchorId}\"`);\n    if (matches.length === 0)\n      throw new Error(`No matching axis found for matcher in anchor \"${anchorId}\"`);\n    return matches[0];\n  }\n\n  throw new Error(`Unsupported axis reference type`);\n}\n\n/**\n * Type guard to check if a value is an anchored axis reference\n */\nfunction isAnchorAxisRef(value: AAxisSelector): value is AnchorAxisRef {\n  return typeof value === 'object' && 'anchor' in value;\n}\n"],"names":["getAxisId","spec","stringifyColumnId","matchAxisId"],"mappings":"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"}

package/dist/drivers/pframe/spec/anchored.d.ts

@@ -65,4 +65,3 @@ export type ResolveAnchorsOptions = {
  * @returns A non-anchored column matcher with all references resolved to actual values
  */
 export declare function resolveAnchors(anchors: Record<string, PColumnSpec>, matcher: AnchoredPColumnSelector, options?: ResolveAnchorsOptions): PColumnSelector;
-//# sourceMappingURL=anchored.d.ts.map

package/dist/drivers/pframe/spec/anchored.js

@@ -0,0 +1,231 @@
+import canonicalize from 'canonicalize';
+import { stringifyColumnId } from './ids.js';
+import { getAxisId, matchAxisId } from './spec.js';
+
+//
+// Helper functions
+//
+function axisKey(axis) {
+    return canonicalize(getAxisId(axis));
+}
+function domainKey(key, value) {
+    return JSON.stringify([key, value]);
+}
+/**
+ * Context for resolving and generating anchored references to columns and axes
+ * Maintains maps of known domain values and axes that can be referenced by anchors
+ */
+class AnchoredIdDeriver {
+    anchors;
+    domains = new Map();
+    axes = new Map();
+    /**
+     * Domain packs are used to group domain keys that can be anchored to the same anchor
+     * This is used to optimize the lookup of domain anchors
+     */
+    domainPacks = [];
+    /**
+     * Maps domain packs to anchors
+     */
+    domainPackToAnchor = new Map();
+    /**
+     * Creates a new anchor context from a set of anchor column specifications
+     * @param anchors Record of anchor column specifications indexed by anchor ID
+     */
+    constructor(anchors) {
+        this.anchors = anchors;
+        const anchorEntries = Object.entries(anchors);
+        anchorEntries.sort((a, b) => a[0].localeCompare(b[0]));
+        for (const [anchorId, spec] of anchorEntries) {
+            for (let axisIdx = 0; axisIdx < spec.axesSpec.length; axisIdx++) {
+                const axis = spec.axesSpec[axisIdx];
+                const key = axisKey(axis);
+                this.axes.set(key, { anchor: anchorId, idx: axisIdx });
+            }
+            if (spec.domain !== undefined) {
+                const domainEntries = Object.entries(spec.domain);
+                domainEntries.sort((a, b) => a[0].localeCompare(b[0]));
+                this.domainPackToAnchor.set(JSON.stringify(domainEntries), anchorId);
+                this.domainPacks.push(domainEntries.map(([dKey]) => dKey));
+                for (const [dKey, dValue] of domainEntries) {
+                    const key = domainKey(dKey, dValue);
+                    this.domains.set(key, anchorId);
+                }
+            }
+        }
+    }
+    /**
+     * Implementation of derive method
+     */
+    derive(spec, axisFilters) {
+        const result = {
+            name: spec.name,
+            axes: [],
+        };
+        let skipDomains = undefined;
+        if (spec.domain !== undefined) {
+            outer: for (const domainPack of this.domainPacks) {
+                const dAnchor = [];
+                for (const domainKey of domainPack) {
+                    const dValue = spec.domain[domainKey];
+                    if (dValue !== undefined)
+                        dAnchor.push([domainKey, dValue]);
+                    else
+                        break outer;
+                }
+                const domainAnchor = this.domainPackToAnchor.get(JSON.stringify(dAnchor));
+                if (domainAnchor !== undefined) {
+                    result.domainAnchor = domainAnchor;
+                    skipDomains = new Set(domainPack);
+                    break;
+                }
+            }
+        }
+        for (const [dKey, dValue] of Object.entries(spec.domain ?? {})) {
+            if (skipDomains !== undefined && skipDomains.has(dKey))
+                continue;
+            const key = domainKey(dKey, dValue);
+            const anchorId = this.domains.get(key);
+            result.domain ??= {};
+            result.domain[dKey] = anchorId ? { anchor: anchorId } : dValue;
+        }
+        result.axes = spec.axesSpec.map((axis) => {
+            const key = axisKey(axis);
+            const anchorAxisRef = this.axes.get(key);
+            if (anchorAxisRef === undefined)
+                return getAxisId(axis);
+            else
+                return anchorAxisRef;
+        });
+        // If no axis filters are provided, return the anchored ID as is
+        if (!axisFilters || axisFilters.length === 0) {
+            return result;
+        }
+        // Process axis filters and create a sliced column ID
+        const resolvedFilters = [];
+        for (const filter of axisFilters) {
+            const [axisIdOrIndex, value] = filter;
+            // If it's already a numeric index, validate it
+            if (typeof axisIdOrIndex === 'number') {
+                if (axisIdOrIndex < 0 || axisIdOrIndex >= spec.axesSpec.length) {
+                    throw new Error(`Axis index ${axisIdOrIndex} is out of bounds (0-${spec.axesSpec.length - 1})`);
+                }
+                resolvedFilters.push([axisIdOrIndex, value]);
+            }
+            else {
+                // If it's a string (axis name), resolve it to an index
+                const axisIndex = spec.axesSpec.findIndex((axis) => axis.name === axisIdOrIndex);
+                if (axisIndex === -1) {
+                    throw new Error(`Axis with name "${axisIdOrIndex}" not found in the column specification`);
+                }
+                resolvedFilters.push([axisIndex, value]);
+            }
+        }
+        // Sort filters by axis index to ensure consistency
+        resolvedFilters.sort((a, b) => a[0] - b[0]);
+        return {
+            source: result,
+            axisFilters: resolvedFilters,
+        };
+    }
+    /**
+     * Derives a canonicalized string representation of an anchored column identifier, can be used as a unique identifier for the column
+     * @param spec Column specification to anchor
+     * @param axisFilters Optional axis filters to apply to the column
+     * @returns A canonicalized string representation of the anchored column identifier
+     */
+    deriveS(spec, axisFilters) {
+        return stringifyColumnId(this.derive(spec, axisFilters));
+    }
+}
+/**
+ * Resolves anchored references in a column matcher to create a non-anchored matcher.
+ * Doing an opposite operation to {@link AnchorIdDeriver.derive()}.
+ *
+ * @param anchors - Record of anchor column specifications indexed by anchor id
+ * @param matcher - An anchored column matcher (or id, which is subtype of it) containing references that need to be resolved
+ * @param options - Options for resolving anchors
+ * @returns A non-anchored column matcher with all references resolved to actual values
+ */
+function resolveAnchors(anchors, matcher, options) {
+    const result = { ...matcher };
+    const ignoreMissingDomains = options?.ignoreMissingDomains ?? false;
+    if (result.domainAnchor !== undefined) {
+        const anchorSpec = anchors[result.domainAnchor];
+        if (!anchorSpec)
+            throw new Error(`Anchor "${result.domainAnchor}" not found`);
+        const anchorDomains = anchorSpec.domain || {};
+        result.domain = { ...anchorDomains, ...result.domain };
+        delete result.domainAnchor;
+    }
+    if (result.domain) {
+        const resolvedDomain = {};
+        for (const [key, value] of Object.entries(result.domain)) {
+            if (typeof value === 'string') {
+                resolvedDomain[key] = value;
+            }
+            else {
+                // It's an AnchorDomainRef
+                const anchorSpec = anchors[value.anchor];
+                if (!anchorSpec)
+                    throw new Error(`Anchor "${value.anchor}" not found for domain key "${key}"`);
+                if (!anchorSpec.domain || anchorSpec.domain[key] === undefined) {
+                    if (!ignoreMissingDomains)
+                        throw new Error(`Domain key "${key}" not found in anchor "${value.anchor}"`);
+                    continue;
+                }
+                resolvedDomain[key] = anchorSpec.domain[key];
+            }
+        }
+        result.domain = resolvedDomain;
+    }
+    if (result.axes)
+        result.axes = result.axes.map((axis) => resolveAxisReference(anchors, axis));
+    return result;
+}
+/**
+ * Resolves an anchored axis reference to a concrete AxisId
+ */
+function resolveAxisReference(anchors, axisRef) {
+    if (!isAnchorAxisRef(axisRef))
+        return axisRef;
+    // It's an anchored reference
+    const anchorId = axisRef.anchor;
+    const anchorSpec = anchors[anchorId];
+    if (!anchorSpec)
+        throw new Error(`Anchor "${anchorId}" not found for axis reference`);
+    if ('idx' in axisRef) {
+        // AnchorAxisRefByIdx
+        if (axisRef.idx < 0 || axisRef.idx >= anchorSpec.axesSpec.length)
+            throw new Error(`Axis index ${axisRef.idx} out of bounds for anchor "${anchorId}"`);
+        return anchorSpec.axesSpec[axisRef.idx];
+    }
+    else if ('name' in axisRef) {
+        // AnchorAxisRefByName
+        const matches = anchorSpec.axesSpec.filter((axis) => axis.name === axisRef.name);
+        if (matches.length > 1)
+            throw new Error(`Multiple axes with name "${axisRef.name}" found in anchor "${anchorId}"`);
+        if (matches.length === 0)
+            throw new Error(`Axis with name "${axisRef.name}" not found in anchor "${anchorId}"`);
+        return matches[0];
+    }
+    else if ('id' in axisRef) {
+        // AnchorAxisRefByMatcher
+        const matches = anchorSpec.axesSpec.filter((axis) => matchAxisId(axisRef.id, getAxisId(axis)));
+        if (matches.length > 1)
+            throw new Error(`Multiple matching axes found for matcher in anchor "${anchorId}"`);
+        if (matches.length === 0)
+            throw new Error(`No matching axis found for matcher in anchor "${anchorId}"`);
+        return matches[0];
+    }
+    throw new Error(`Unsupported axis reference type`);
+}
+/**
+ * Type guard to check if a value is an anchored axis reference
+ */
+function isAnchorAxisRef(value) {
+    return typeof value === 'object' && 'anchor' in value;
+}
+
+export { AnchoredIdDeriver, resolveAnchors };
+//# sourceMappingURL=anchored.js.map

package/dist/drivers/pframe/spec/anchored.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchored.js","sources":["../../../../src/drivers/pframe/spec/anchored.ts"],"sourcesContent":["import canonicalize from 'canonicalize';\nimport type { AxisFilter, AxisFilterValue } from './filtered_column';\nimport type { SUniversalPColumnId, UniversalPColumnId } from './ids';\nimport { stringifyColumnId } from './ids';\nimport type { AAxisSelector, AnchorAxisRef, AnchorAxisRefByIdx, AnchoredPColumnId, AnchoredPColumnSelector, AxisSelector, PColumnSelector } from './selectors';\nimport type { AxisId, PColumnSpec } from './spec';\nimport { getAxisId, matchAxisId } from './spec';\n\n//\n// Helper functions\n//\n\nfunction axisKey(axis: AxisId): string {\n  return canonicalize(getAxisId(axis))!;\n}\n\nfunction domainKey(key: string, value: string): string {\n  return JSON.stringify([key, value]);\n}\n\n/**\n * Context for resolving and generating anchored references to columns and axes\n * Maintains maps of known domain values and axes that can be referenced by anchors\n */\nexport class AnchoredIdDeriver {\n  private readonly domains = new Map<string, string>();\n  private readonly axes = new Map<string, AnchorAxisRefByIdx>();\n  /**\n   * Domain packs are used to group domain keys that can be anchored to the same anchor\n   * This is used to optimize the lookup of domain anchors\n   */\n  private readonly domainPacks: string[][] = [];\n  /**\n   * Maps domain packs to anchors\n   */\n  private readonly domainPackToAnchor = new Map<string, string>();\n\n  /**\n   * Creates a new anchor context from a set of anchor column specifications\n   * @param anchors Record of anchor column specifications indexed by anchor ID\n   */\n  constructor(public readonly anchors: Record<string, PColumnSpec>) {\n    const anchorEntries = Object.entries(anchors);\n    anchorEntries.sort((a, b) => a[0].localeCompare(b[0]));\n    for (const [anchorId, spec] of anchorEntries) {\n      for (let axisIdx = 0; axisIdx < spec.axesSpec.length; axisIdx++) {\n        const axis = spec.axesSpec[axisIdx];\n        const key = axisKey(axis);\n        this.axes.set(key, { anchor: anchorId, idx: axisIdx });\n      }\n      if (spec.domain !== undefined) {\n        const domainEntries = Object.entries(spec.domain);\n        domainEntries.sort((a, b) => a[0].localeCompare(b[0]));\n\n        this.domainPackToAnchor.set(JSON.stringify(domainEntries), anchorId);\n        this.domainPacks.push(domainEntries.map(([dKey]) => dKey));\n\n        for (const [dKey, dValue] of domainEntries) {\n          const key = domainKey(dKey, dValue);\n          this.domains.set(key, anchorId);\n        }\n      }\n    }\n  }\n\n  /**\n   * Derives an anchored column identifier from a column specification\n   * @param spec Column specification to anchor\n   * @returns An anchored column identifier that can be used to identify columns similar to the input specification\n   */\n  derive(spec: PColumnSpec): AnchoredPColumnId;\n\n  /**\n   * Derives an anchored column identifier from a column specification\n   * @param spec Column specification to anchor\n   * @param axisFilters Axis filters to apply to the column\n   * @returns An anchored and sliced column identifier that can be used to identify columns similar to the input specification\n   */\n  derive(spec: PColumnSpec, axisFilters?: AxisFilter[]): UniversalPColumnId;\n\n  /**\n   * Implementation of derive method\n   */\n  derive(spec: PColumnSpec, axisFilters?: AxisFilter[]): UniversalPColumnId {\n    const result: AnchoredPColumnId = {\n      name: spec.name,\n      axes: [],\n    };\n\n    let skipDomains: Set<string> | undefined = undefined;\n    if (spec.domain !== undefined) {\n      outer:\n      for (const domainPack of this.domainPacks) {\n        const dAnchor: string[][] = [];\n        for (const domainKey of domainPack) {\n          const dValue = spec.domain[domainKey];\n          if (dValue !== undefined)\n            dAnchor.push([domainKey, dValue]);\n          else\n            break outer;\n        }\n        const domainAnchor = this.domainPackToAnchor.get(JSON.stringify(dAnchor));\n        if (domainAnchor !== undefined) {\n          result.domainAnchor = domainAnchor;\n          skipDomains = new Set(domainPack);\n          break;\n        }\n      }\n    }\n\n    for (const [dKey, dValue] of Object.entries(spec.domain ?? {})) {\n      if (skipDomains !== undefined && skipDomains.has(dKey))\n        continue;\n      const key = domainKey(dKey, dValue);\n      const anchorId = this.domains.get(key);\n      result.domain ??= {};\n      result.domain[dKey] = anchorId ? { anchor: anchorId } : dValue;\n    }\n\n    result.axes = spec.axesSpec.map((axis) => {\n      const key = axisKey(axis);\n      const anchorAxisRef = this.axes.get(key);\n      if (anchorAxisRef === undefined) return getAxisId(axis);\n      else return anchorAxisRef;\n    });\n\n    // If no axis filters are provided, return the anchored ID as is\n    if (!axisFilters || axisFilters.length === 0) {\n      return result;\n    }\n\n    // Process axis filters and create a sliced column ID\n    const resolvedFilters: [number, AxisFilterValue][] = [];\n\n    for (const filter of axisFilters) {\n      const [axisIdOrIndex, value] = filter;\n\n      // If it's already a numeric index, validate it\n      if (typeof axisIdOrIndex === 'number') {\n        if (axisIdOrIndex < 0 || axisIdOrIndex >= spec.axesSpec.length) {\n          throw new Error(`Axis index ${axisIdOrIndex} is out of bounds (0-${spec.axesSpec.length - 1})`);\n        }\n        resolvedFilters.push([axisIdOrIndex, value]);\n      } else {\n        // If it's a string (axis name), resolve it to an index\n        const axisIndex = spec.axesSpec.findIndex((axis) => axis.name === axisIdOrIndex);\n        if (axisIndex === -1) {\n          throw new Error(`Axis with name \"${axisIdOrIndex}\" not found in the column specification`);\n        }\n        resolvedFilters.push([axisIndex, value]);\n      }\n    }\n\n    // Sort filters by axis index to ensure consistency\n    resolvedFilters.sort((a, b) => a[0] - b[0]);\n\n    return {\n      source: result,\n      axisFilters: resolvedFilters,\n    };\n  }\n\n  /**\n   * Derives a canonicalized string representation of an anchored column identifier, can be used as a unique identifier for the column\n   * @param spec Column specification to anchor\n   * @param axisFilters Optional axis filters to apply to the column\n   * @returns A canonicalized string representation of the anchored column identifier\n   */\n  deriveS(spec: PColumnSpec, axisFilters?: AxisFilter[]): SUniversalPColumnId {\n    return stringifyColumnId(this.derive(spec, axisFilters));\n  }\n}\n\n/**\n * Options for the resolveAnchors function\n */\nexport type ResolveAnchorsOptions = {\n  /**\n   * If true, missing domain keys in anchors will be ignored.\n   * If false (default), an error will be thrown.\n   */\n  ignoreMissingDomains?: boolean;\n};\n\n/**\n * Resolves anchored references in a column matcher to create a non-anchored matcher.\n * Doing an opposite operation to {@link AnchorIdDeriver.derive()}.\n *\n * @param anchors - Record of anchor column specifications indexed by anchor id\n * @param matcher - An anchored column matcher (or id, which is subtype of it) containing references that need to be resolved\n * @param options - Options for resolving anchors\n * @returns A non-anchored column matcher with all references resolved to actual values\n */\nexport function resolveAnchors(anchors: Record<string, PColumnSpec>, matcher: AnchoredPColumnSelector, options?: ResolveAnchorsOptions): PColumnSelector {\n  const result = { ...matcher };\n  const ignoreMissingDomains = options?.ignoreMissingDomains ?? false;\n\n  if (result.domainAnchor !== undefined) {\n    const anchorSpec = anchors[result.domainAnchor];\n    if (!anchorSpec)\n      throw new Error(`Anchor \"${result.domainAnchor}\" not found`);\n\n    const anchorDomains = anchorSpec.domain || {};\n    result.domain = { ...anchorDomains, ...result.domain };\n    delete result.domainAnchor;\n  }\n\n  if (result.domain) {\n    const resolvedDomain: Record<string, string> = {};\n    for (const [key, value] of Object.entries(result.domain)) {\n      if (typeof value === 'string') {\n        resolvedDomain[key] = value;\n      } else {\n        // It's an AnchorDomainRef\n        const anchorSpec = anchors[value.anchor];\n        if (!anchorSpec)\n          throw new Error(`Anchor \"${value.anchor}\" not found for domain key \"${key}\"`);\n\n        if (!anchorSpec.domain || anchorSpec.domain[key] === undefined) {\n          if (!ignoreMissingDomains)\n            throw new Error(`Domain key \"${key}\" not found in anchor \"${value.anchor}\"`);\n          continue;\n        }\n\n        resolvedDomain[key] = anchorSpec.domain[key];\n      }\n    }\n    result.domain = resolvedDomain;\n  }\n\n  if (result.axes)\n    result.axes = result.axes.map((axis) => resolveAxisReference(anchors, axis));\n\n  return result as PColumnSelector;\n}\n\n/**\n * Resolves an anchored axis reference to a concrete AxisId\n */\nfunction resolveAxisReference(anchors: Record<string, PColumnSpec>, axisRef: AAxisSelector): AxisSelector {\n  if (!isAnchorAxisRef(axisRef))\n    return axisRef;\n\n  // It's an anchored reference\n  const anchorId = axisRef.anchor;\n  const anchorSpec = anchors[anchorId];\n  if (!anchorSpec)\n    throw new Error(`Anchor \"${anchorId}\" not found for axis reference`);\n\n  if ('idx' in axisRef) {\n    // AnchorAxisRefByIdx\n    if (axisRef.idx < 0 || axisRef.idx >= anchorSpec.axesSpec.length)\n      throw new Error(`Axis index ${axisRef.idx} out of bounds for anchor \"${anchorId}\"`);\n    return anchorSpec.axesSpec[axisRef.idx];\n  } else if ('name' in axisRef) {\n    // AnchorAxisRefByName\n    const matches = anchorSpec.axesSpec.filter((axis) => axis.name === axisRef.name);\n    if (matches.length > 1)\n      throw new Error(`Multiple axes with name \"${axisRef.name}\" found in anchor \"${anchorId}\"`);\n    if (matches.length === 0)\n      throw new Error(`Axis with name \"${axisRef.name}\" not found in anchor \"${anchorId}\"`);\n    return matches[0];\n  } else if ('id' in axisRef) {\n    // AnchorAxisRefByMatcher\n    const matches = anchorSpec.axesSpec.filter((axis) => matchAxisId(axisRef.id, getAxisId(axis)));\n    if (matches.length > 1)\n      throw new Error(`Multiple matching axes found for matcher in anchor \"${anchorId}\"`);\n    if (matches.length === 0)\n      throw new Error(`No matching axis found for matcher in anchor \"${anchorId}\"`);\n    return matches[0];\n  }\n\n  throw new Error(`Unsupported axis reference type`);\n}\n\n/**\n * Type guard to check if a value is an anchored axis reference\n */\nfunction isAnchorAxisRef(value: AAxisSelector): value is AnchorAxisRef {\n  return typeof value === 'object' && 'anchor' in value;\n}\n"],"names":[],"mappings":"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"}

package/dist/drivers/pframe/spec/filtered_column.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+/**
+ * Checks if a given value is a FilteredPColumn
+ * @param id - The value to check
+ * @returns True if the value is a FilteredPColumn, false otherwise
+ */
+function isFilteredPColumn(id) {
+    return typeof id === 'object' && id !== null && 'source' in id && 'axisFilters' in id;
+}
+
+exports.isFilteredPColumn = isFilteredPColumn;
+//# sourceMappingURL=filtered_column.cjs.map

package/dist/drivers/pframe/spec/filtered_column.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtered_column.cjs","sources":["../../../../src/drivers/pframe/spec/filtered_column.ts"],"sourcesContent":["import type { AnchoredPColumnId } from './selectors';\n\n/** Value of an axis filter */\nexport type AxisFilterValue = number | string;\n\n/** Axis filter by index */\nexport type AxisFilterByIdx = [number, AxisFilterValue];\n\n/** Axis filter by name */\nexport type AxisFilterByName = [string, AxisFilterValue];\n\n/** Axis filter */\nexport type AxisFilter = AxisFilterByIdx | AxisFilterByName;\n\n/**\n * Identifies a column derived from a CanonicalPColumnId by fixing values on certain axes,\n * thus effectively reducing the dimensionality of the original column.\n */\nexport type FilteredPColumn<CID = AnchoredPColumnId, AFI = AxisFilter> = {\n  /** The original column identifier */\n  source: CID;\n\n  /**\n   * List of fixed axes and their corresponding values.\n   * Each entry fixes one axis to a specific value, creating a slice of the multidimensional data.\n   * This effectively reduces the dimensionality by one for each fixed axis.\n   * Ordered by the axis index in canonical case.\n   */\n  axisFilters: AFI[];\n};\n\nexport type FilteredPColumnId = FilteredPColumn<AnchoredPColumnId, AxisFilterByIdx>;\n\n/**\n * Checks if a given value is a FilteredPColumn\n * @param id - The value to check\n * @returns True if the value is a FilteredPColumn, false otherwise\n */\nexport function isFilteredPColumn(id: unknown): id is FilteredPColumn {\n  return typeof id === 'object' && id !== null && 'source' in id && 'axisFilters' in id;\n}\n"],"names":[],"mappings":";;AAiCA;;;;AAIG;AACG,SAAU,iBAAiB,CAAC,EAAW,EAAA;AAC3C,IAAA,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,IAAI,IAAI,QAAQ,IAAI,EAAE,IAAI,aAAa,IAAI,EAAE;AACvF;;;;"}

package/dist/drivers/pframe/spec/filtered_column.d.ts

@@ -29,4 +29,3 @@ export type FilteredPColumnId = FilteredPColumn<AnchoredPColumnId, AxisFilterByI
  * @returns True if the value is a FilteredPColumn, false otherwise
  */
 export declare function isFilteredPColumn(id: unknown): id is FilteredPColumn;
-//# sourceMappingURL=filtered_column.d.ts.map

package/dist/drivers/pframe/spec/filtered_column.js

@@ -0,0 +1,11 @@
+/**
+ * Checks if a given value is a FilteredPColumn
+ * @param id - The value to check
+ * @returns True if the value is a FilteredPColumn, false otherwise
+ */
+function isFilteredPColumn(id) {
+    return typeof id === 'object' && id !== null && 'source' in id && 'axisFilters' in id;
+}
+
+export { isFilteredPColumn };
+//# sourceMappingURL=filtered_column.js.map

package/dist/drivers/pframe/spec/filtered_column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtered_column.js","sources":["../../../../src/drivers/pframe/spec/filtered_column.ts"],"sourcesContent":["import type { AnchoredPColumnId } from './selectors';\n\n/** Value of an axis filter */\nexport type AxisFilterValue = number | string;\n\n/** Axis filter by index */\nexport type AxisFilterByIdx = [number, AxisFilterValue];\n\n/** Axis filter by name */\nexport type AxisFilterByName = [string, AxisFilterValue];\n\n/** Axis filter */\nexport type AxisFilter = AxisFilterByIdx | AxisFilterByName;\n\n/**\n * Identifies a column derived from a CanonicalPColumnId by fixing values on certain axes,\n * thus effectively reducing the dimensionality of the original column.\n */\nexport type FilteredPColumn<CID = AnchoredPColumnId, AFI = AxisFilter> = {\n  /** The original column identifier */\n  source: CID;\n\n  /**\n   * List of fixed axes and their corresponding values.\n   * Each entry fixes one axis to a specific value, creating a slice of the multidimensional data.\n   * This effectively reduces the dimensionality by one for each fixed axis.\n   * Ordered by the axis index in canonical case.\n   */\n  axisFilters: AFI[];\n};\n\nexport type FilteredPColumnId = FilteredPColumn<AnchoredPColumnId, AxisFilterByIdx>;\n\n/**\n * Checks if a given value is a FilteredPColumn\n * @param id - The value to check\n * @returns True if the value is a FilteredPColumn, false otherwise\n */\nexport function isFilteredPColumn(id: unknown): id is FilteredPColumn {\n  return typeof id === 'object' && id !== null && 'source' in id && 'axisFilters' in id;\n}\n"],"names":[],"mappings":"AAiCA;;;;AAIG;AACG,SAAU,iBAAiB,CAAC,EAAW,EAAA;AAC3C,IAAA,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,IAAI,IAAI,QAAQ,IAAI,EAAE,IAAI,aAAa,IAAI,EAAE;AACvF;;;;"}

package/dist/drivers/pframe/spec/ids.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+var canonicalize = require('canonicalize');
+
+/**
+ * Canonically serializes a {@link UniversalPColumnId} to a string.
+ * @param id - The column identifier to serialize
+ * @returns The canonically serialized string
+ */
+function stringifyColumnId(id) {
+    return canonicalize(id);
+}
+/**
+ * Parses a canonically serialized {@link UniversalPColumnId} from a string.
+ * @param str - The string to parse
+ * @returns The parsed column identifier
+ */
+function parseColumnId(str) {
+    return JSON.parse(str);
+}
+
+exports.parseColumnId = parseColumnId;
+exports.stringifyColumnId = stringifyColumnId;
+//# sourceMappingURL=ids.cjs.map

package/dist/drivers/pframe/spec/ids.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.cjs","sources":["../../../../src/drivers/pframe/spec/ids.ts"],"sourcesContent":["import type { Branded } from '../../../branding';\nimport type { AnchoredPColumnId } from './selectors';\nimport type { FilteredPColumnId } from './filtered_column';\nimport canonicalize from 'canonicalize';\nimport type { PObjectId } from '../../../pool';\n/**\n * Universal column identifier optionally anchored and optionally filtered.\n */\nexport type UniversalPColumnId = AnchoredPColumnId | FilteredPColumnId;\n\n/**\n * Canonically serialized {@link UniversalPColumnId}.\n */\nexport type SUniversalPColumnId = Branded<PObjectId, 'SUniversalPColumnId', '__pl_model_brand_2__'>;\n\n/**\n * Canonically serializes a {@link UniversalPColumnId} to a string.\n * @param id - The column identifier to serialize\n * @returns The canonically serialized string\n */\nexport function stringifyColumnId(id: UniversalPColumnId): SUniversalPColumnId {\n  return canonicalize(id)! as SUniversalPColumnId;\n}\n\n/**\n * Parses a canonically serialized {@link UniversalPColumnId} from a string.\n * @param str - The string to parse\n * @returns The parsed column identifier\n */\nexport function parseColumnId(str: SUniversalPColumnId): UniversalPColumnId {\n  return JSON.parse(str) as UniversalPColumnId;\n}\n"],"names":[],"mappings":";;;;AAeA;;;;AAIG;AACG,SAAU,iBAAiB,CAAC,EAAsB,EAAA;AACtD,IAAA,OAAO,YAAY,CAAC,EAAE,CAAyB;AACjD;AAEA;;;;AAIG;AACG,SAAU,aAAa,CAAC,GAAwB,EAAA;AACpD,IAAA,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB;AAC9C;;;;;"}

package/dist/drivers/pframe/spec/ids.d.ts

@@ -22,4 +22,3 @@ export declare function stringifyColumnId(id: UniversalPColumnId): SUniversalPCo
  * @returns The parsed column identifier
  */
 export declare function parseColumnId(str: SUniversalPColumnId): UniversalPColumnId;
-//# sourceMappingURL=ids.d.ts.map