@milaboratories/pl-model-common 1.46.4 → 1.47.0

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

@@ -1,10 +1,11 @@
 const require_spec = require("./spec.cjs");
+const require_filtered_column = require("./filtered_column.cjs");
+const require_discovered_column = require("./discovered_column.cjs");
+const require_overridden = require("./overridden.cjs");
 const require_ids = require("./ids.cjs");
 const require_anchored = require("./anchored.cjs");
-const require_filtered_column = require("./filtered_column.cjs");
 const require_selectors = require("./selectors.cjs");
 const require_native_id = require("./native_id.cjs");
-const require_discovered_column = require("./discovered_column.cjs");
 exports.AnchoredIdDeriver = require_anchored.AnchoredIdDeriver;
 exports.Annotation = require_spec.Annotation;
 exports.AnnotationJson = require_spec.AnnotationJson;
@@ -13,11 +14,21 @@ exports.DomainJson = require_spec.DomainJson;
 exports.PAxisName = require_spec.PAxisName;
 exports.PColumnName = require_spec.PColumnName;
 exports.ValueType = require_spec.ValueType;
+exports.applyAxisFilters = require_filtered_column.applyAxisFilters;
+exports.applySpecOverrides = require_overridden.applySpecOverrides;
 exports.canonicalizeAxisId = require_spec.canonicalizeAxisId;
 exports.canonicalizeAxisWithParents = require_spec.canonicalizeAxisWithParents;
-exports.createDiscoveredPColumnId = require_discovered_column.createDiscoveredPColumnId;
+exports.createColumnDiscoveredId = require_discovered_column.createColumnDiscoveredId;
+exports.createColumnDiscoveredKey = require_discovered_column.createColumnDiscoveredKey;
+exports.createColumnFilteredId = require_filtered_column.createColumnFilteredId;
+exports.createColumnFilteredKey = require_filtered_column.createColumnFilteredKey;
+exports.createColumnOverriddenId = require_overridden.createColumnOverriddenId;
+exports.createColumnOverriddenKey = require_overridden.createColumnOverriddenKey;
 exports.deriveNativeId = require_native_id.deriveNativeId;
-exports.distillDiscoveredPColumn = require_discovered_column.distillDiscoveredPColumn;
+exports.deriveSpecDelta = require_overridden.deriveSpecDelta;
+exports.distillColumnDiscoveredKey = require_discovered_column.distillColumnDiscoveredKey;
+exports.distillColumnOverriddenKey = require_overridden.distillColumnOverriddenKey;
+exports.extractPObjectId = require_ids.extractPObjectId;
 exports.getArrayFromAxisTree = require_spec.getArrayFromAxisTree;
 exports.getAxesId = require_spec.getAxesId;
 exports.getAxesTree = require_spec.getAxesTree;
@@ -30,7 +41,12 @@ exports.getSetFromAxisTree = require_spec.getSetFromAxisTree;
 exports.getTypeFromPColumnOrAxisSpec = require_spec.getTypeFromPColumnOrAxisSpec;
 exports.isAnchoredPColumnId = require_selectors.isAnchoredPColumnId;
 exports.isAxisId = require_spec.isAxisId;
-exports.isDiscoveredPColumn = require_discovered_column.isDiscoveredPColumn;
+exports.isColumnDiscoveredId = require_discovered_column.isColumnDiscoveredId;
+exports.isColumnDiscoveredKey = require_discovered_column.isColumnDiscoveredKey;
+exports.isColumnFilteredId = require_filtered_column.isColumnFilteredId;
+exports.isColumnFilteredKey = require_filtered_column.isColumnFilteredKey;
+exports.isColumnOverriddenKey = require_overridden.isColumnOverriddenKey;
+exports.isEmptySpecDelta = require_overridden.isEmptySpecDelta;
 exports.isFilteredPColumn = require_filtered_column.isFilteredPColumn;
 exports.isLabelColumn = require_spec.isLabelColumn;
 exports.isLinkerColumn = require_spec.isLinkerColumn;
@@ -39,9 +55,12 @@ exports.matchAxis = require_selectors.matchAxis;
 exports.matchAxisId = require_spec.matchAxisId;
 exports.matchMultiColumnSelector = require_selectors.matchMultiColumnSelector;
 exports.matchPColumn = require_selectors.matchPColumn;
+exports.mergeSpecOverrides = require_overridden.mergeSpecOverrides;
 exports.multiColumnSelectorsToPredicate = require_selectors.multiColumnSelectorsToPredicate;
+exports.parseColumnDiscoveredId = require_discovered_column.parseColumnDiscoveredId;
 exports.parseColumnId = require_ids.parseColumnId;
-exports.parseDiscoveredPColumnId = require_discovered_column.parseDiscoveredPColumnId;
+exports.parseColumnIdSafely = require_ids.parseColumnIdSafely;
+exports.parseColumnOverriddenId = require_overridden.parseColumnOverriddenId;
 exports.readAnnotation = require_spec.readAnnotation;
 exports.readAnnotationJson = require_spec.readAnnotationJson;
 exports.readAnnotationJsonOrThrow = require_spec.readAnnotationJsonOrThrow;
@@ -51,7 +70,11 @@ exports.readDomainJsonOrThrow = require_spec.readDomainJsonOrThrow;
 exports.readMetadata = require_spec.readMetadata;
 exports.readMetadataJson = require_spec.readMetadataJson;
 exports.readMetadataJsonOrThrow = require_spec.readMetadataJsonOrThrow;
+exports.reconstructSpecFromId = require_ids.reconstructSpecFromId;
 exports.resolveAnchors = require_anchored.resolveAnchors;
 exports.resolveAnnotationParents = require_spec.resolveAnnotationParents;
+exports.stringifyColumnDiscoveredId = require_discovered_column.stringifyColumnDiscoveredId;
+exports.stringifyColumnFilteredId = require_filtered_column.stringifyColumnFilteredId;
 exports.stringifyColumnId = require_ids.stringifyColumnId;
-exports.stringifyDiscoveredPColumnId = require_discovered_column.stringifyDiscoveredPColumnId;
+exports.stringifyColumnOverriddenId = require_overridden.stringifyColumnOverriddenId;
+exports.unwrapOverrides = require_overridden.unwrapOverrides;

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

@@ -1,8 +1,9 @@
-import { AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, FilteredPColumn, FilteredPColumnId, isFilteredPColumn } from "./filtered_column.js";
-import { DiscoveredPColumn, DiscoveredPColumnId, createDiscoveredPColumnId, distillDiscoveredPColumn, isDiscoveredPColumn, parseDiscoveredPColumnId, stringifyDiscoveredPColumnId } from "./discovered_column.js";
-import { SUniversalPColumnId, UniversalPColumnId, parseColumnId, stringifyColumnId } from "./ids.js";
-import { Annotation, AnnotationDataStatus, AnnotationJson, AxesId, AxesSpec, AxisId, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, ColumnValueType, Domain, DomainJson, Metadata, MetadataJson, PAxisName, PColumn, PColumnIdAndSpec, PColumnLazy, PColumnName, PColumnSpec, PColumnSpecId, PDataColumnSpec, PUniversalColumnSpec, Trace, TraceEntry, ValueType, canonicalizeAxisId, canonicalizeAxisWithParents, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAxisId, isLabelColumn, isLinkerColumn, matchAxisId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, resolveAnnotationParents } from "./spec.js";
+import { ColumnDiscoveredId, ColumnDiscoveredKey, createColumnDiscoveredId, createColumnDiscoveredKey, distillColumnDiscoveredKey, isColumnDiscoveredId, isColumnDiscoveredKey, parseColumnDiscoveredId, stringifyColumnDiscoveredId } from "./discovered_column.js";
+import { Annotation, AnnotationDataStatus, AnnotationJson, AxesId, AxesSpec, AxisId, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, ColumnValueType, Domain, DomainJson, Metadata, MetadataJson, PAxisName, PColumn, PColumnIdAndSpec, PColumnName, PColumnSpec, PColumnSpecId, PDataColumnSpec, PUniversalColumnSpec, Trace, TraceEntry, ValueType, canonicalizeAxisId, canonicalizeAxisWithParents, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAxisId, isLabelColumn, isLinkerColumn, matchAxisId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, resolveAnnotationParents } from "./spec.js";
+import { ColumnOverriddenId, ColumnOverriddenKey, SpecOverrides, applySpecOverrides, createColumnOverriddenId, createColumnOverriddenKey, deriveSpecDelta, distillColumnOverriddenKey, isColumnOverriddenKey, isEmptySpecDelta, mergeSpecOverrides, parseColumnOverriddenId, stringifyColumnOverriddenId, unwrapOverrides } from "./overridden.js";
+import { AxisPatches, ColumnUniversalId, ColumnUniversalKey, SUniversalPColumnId, UniversalPColumnId, extractPObjectId, parseColumnId, parseColumnIdSafely, reconstructSpecFromId, stringifyColumnId } from "./ids.js";
+import { AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, ColumnFilteredId, ColumnFilteredKey, FilteredPColumn, FilteredPColumnId, applyAxisFilters, createColumnFilteredId, createColumnFilteredKey, isColumnFilteredId, isColumnFilteredKey, isFilteredPColumn, stringifyColumnFilteredId } from "./filtered_column.js";
 import { AnchoredIdDeriver, ResolveAnchorsOptions, resolveAnchors } from "./anchored.js";
 import { NativePObjectId, deriveNativeId } from "./native_id.js";
 import { AAxisSelector, ADomain, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredPColumnId, AnchoredPColumnSelector, AxisQualification, LegacyAxisSelector, PColumnSelector, SingleAxisSelector, isAnchoredPColumnId, legacyColumnSelectorsToPredicate, matchAxis, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate } from "./selectors.js";
-export { AAxisSelector, ADomain, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredIdDeriver, AnchoredPColumnId, AnchoredPColumnSelector, Annotation, AnnotationDataStatus, AnnotationJson, AxesId, AxesSpec, AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, AxisId, AxisQualification, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, ColumnValueType, DiscoveredPColumn, DiscoveredPColumnId, Domain, DomainJson, FilteredPColumn, FilteredPColumnId, LegacyAxisSelector, Metadata, MetadataJson, NativePObjectId, PAxisName, PColumn, PColumnIdAndSpec, PColumnLazy, PColumnName, PColumnSelector, PColumnSpec, PColumnSpecId, PDataColumnSpec, PUniversalColumnSpec, ResolveAnchorsOptions, SUniversalPColumnId, SingleAxisSelector, Trace, TraceEntry, UniversalPColumnId, ValueType, canonicalizeAxisId, canonicalizeAxisWithParents, createDiscoveredPColumnId, deriveNativeId, distillDiscoveredPColumn, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAnchoredPColumnId, isAxisId, isDiscoveredPColumn, isFilteredPColumn, isLabelColumn, isLinkerColumn, legacyColumnSelectorsToPredicate, matchAxis, matchAxisId, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate, parseColumnId, parseDiscoveredPColumnId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, resolveAnchors, resolveAnnotationParents, stringifyColumnId, stringifyDiscoveredPColumnId };
+export { AAxisSelector, ADomain, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredIdDeriver, AnchoredPColumnId, AnchoredPColumnSelector, Annotation, AnnotationDataStatus, AnnotationJson, AxesId, AxesSpec, AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, AxisId, AxisPatches, AxisQualification, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, ColumnDiscoveredId, ColumnDiscoveredKey, ColumnFilteredId, ColumnFilteredKey, ColumnOverriddenId, ColumnOverriddenKey, ColumnUniversalId, ColumnUniversalKey, ColumnValueType, Domain, DomainJson, FilteredPColumn, FilteredPColumnId, LegacyAxisSelector, Metadata, MetadataJson, NativePObjectId, PAxisName, PColumn, PColumnIdAndSpec, PColumnName, PColumnSelector, PColumnSpec, PColumnSpecId, PDataColumnSpec, PUniversalColumnSpec, ResolveAnchorsOptions, SUniversalPColumnId, SingleAxisSelector, SpecOverrides, Trace, TraceEntry, UniversalPColumnId, ValueType, applyAxisFilters, applySpecOverrides, canonicalizeAxisId, canonicalizeAxisWithParents, createColumnDiscoveredId, createColumnDiscoveredKey, createColumnFilteredId, createColumnFilteredKey, createColumnOverriddenId, createColumnOverriddenKey, deriveNativeId, deriveSpecDelta, distillColumnDiscoveredKey, distillColumnOverriddenKey, extractPObjectId, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAnchoredPColumnId, isAxisId, isColumnDiscoveredId, isColumnDiscoveredKey, isColumnFilteredId, isColumnFilteredKey, isColumnOverriddenKey, isEmptySpecDelta, isFilteredPColumn, isLabelColumn, isLinkerColumn, legacyColumnSelectorsToPredicate, matchAxis, matchAxisId, matchMultiColumnSelector, matchPColumn, mergeSpecOverrides, multiColumnSelectorsToPredicate, parseColumnDiscoveredId, parseColumnId, parseColumnIdSafely, parseColumnOverriddenId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, reconstructSpecFromId, resolveAnchors, resolveAnnotationParents, stringifyColumnDiscoveredId, stringifyColumnFilteredId, stringifyColumnId, stringifyColumnOverriddenId, unwrapOverrides };

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

@@ -1,8 +1,9 @@
 import { Annotation, AnnotationJson, Domain, DomainJson, PAxisName, PColumnName, ValueType, canonicalizeAxisId, canonicalizeAxisWithParents, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAxisId, isLabelColumn, isLinkerColumn, matchAxisId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, resolveAnnotationParents } from "./spec.js";
-import { parseColumnId, stringifyColumnId } from "./ids.js";
+import { applyAxisFilters, createColumnFilteredId, createColumnFilteredKey, isColumnFilteredId, isColumnFilteredKey, isFilteredPColumn, stringifyColumnFilteredId } from "./filtered_column.js";
+import { createColumnDiscoveredId, createColumnDiscoveredKey, distillColumnDiscoveredKey, isColumnDiscoveredId, isColumnDiscoveredKey, parseColumnDiscoveredId, stringifyColumnDiscoveredId } from "./discovered_column.js";
+import { applySpecOverrides, createColumnOverriddenId, createColumnOverriddenKey, deriveSpecDelta, distillColumnOverriddenKey, isColumnOverriddenKey, isEmptySpecDelta, mergeSpecOverrides, parseColumnOverriddenId, stringifyColumnOverriddenId, unwrapOverrides } from "./overridden.js";
+import { extractPObjectId, parseColumnId, parseColumnIdSafely, reconstructSpecFromId, stringifyColumnId } from "./ids.js";
 import { AnchoredIdDeriver, resolveAnchors } from "./anchored.js";
-import { isFilteredPColumn } from "./filtered_column.js";
 import { isAnchoredPColumnId, legacyColumnSelectorsToPredicate, matchAxis, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate } from "./selectors.js";
 import { deriveNativeId } from "./native_id.js";
-import { createDiscoveredPColumnId, distillDiscoveredPColumn, isDiscoveredPColumn, parseDiscoveredPColumnId, stringifyDiscoveredPColumnId } from "./discovered_column.js";
-export { AnchoredIdDeriver, Annotation, AnnotationJson, Domain, DomainJson, PAxisName, PColumnName, ValueType, canonicalizeAxisId, canonicalizeAxisWithParents, createDiscoveredPColumnId, deriveNativeId, distillDiscoveredPColumn, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAnchoredPColumnId, isAxisId, isDiscoveredPColumn, isFilteredPColumn, isLabelColumn, isLinkerColumn, legacyColumnSelectorsToPredicate, matchAxis, matchAxisId, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate, parseColumnId, parseDiscoveredPColumnId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, resolveAnchors, resolveAnnotationParents, stringifyColumnId, stringifyDiscoveredPColumnId };
+export { AnchoredIdDeriver, Annotation, AnnotationJson, Domain, DomainJson, PAxisName, PColumnName, ValueType, applyAxisFilters, applySpecOverrides, canonicalizeAxisId, canonicalizeAxisWithParents, createColumnDiscoveredId, createColumnDiscoveredKey, createColumnFilteredId, createColumnFilteredKey, createColumnOverriddenId, createColumnOverriddenKey, deriveNativeId, deriveSpecDelta, distillColumnDiscoveredKey, distillColumnOverriddenKey, extractPObjectId, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAnchoredPColumnId, isAxisId, isColumnDiscoveredId, isColumnDiscoveredKey, isColumnFilteredId, isColumnFilteredKey, isColumnOverriddenKey, isEmptySpecDelta, isFilteredPColumn, isLabelColumn, isLinkerColumn, legacyColumnSelectorsToPredicate, matchAxis, matchAxisId, matchMultiColumnSelector, matchPColumn, mergeSpecOverrides, multiColumnSelectorsToPredicate, parseColumnDiscoveredId, parseColumnId, parseColumnIdSafely, parseColumnOverriddenId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, reconstructSpecFromId, resolveAnchors, resolveAnnotationParents, stringifyColumnDiscoveredId, stringifyColumnFilteredId, stringifyColumnId, stringifyColumnOverriddenId, unwrapOverrides };

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

@@ -1,6 +1,7 @@
 const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
 const require_spec = require("./spec.cjs");
 const require_spec$1 = require("../../../pool/spec.cjs");
+require("../../../pool/index.cjs");
 let canonicalize = require("canonicalize");
 canonicalize = require_runtime.__toESM(canonicalize, 1);
 //#region src/drivers/pframe/spec/native_id.ts

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

@@ -1 +1 @@
-{"version":3,"file":"native_id.cjs","names":["isPColumnSpec","getAxesId"],"sources":["../../../../src/drivers/pframe/spec/native_id.ts"],"sourcesContent":["import type { Branded } from \"../../../branding\";\nimport { isPColumnSpec, type PObjectSpec } from \"../../../pool\";\nimport { getAxesId } from \"./spec\";\nimport canonicalize from \"canonicalize\";\nexport type NativePObjectId = Branded<string, \"NativePObjectId\">;\n\nexport function deriveNativeId(spec: PObjectSpec): NativePObjectId {\n  const result: Record<string, unknown> = {\n    kind: spec.kind,\n    name: spec.name,\n  };\n  if (spec.domain !== undefined) result.domain = spec.domain;\n  if (spec.contextDomain !== undefined) result.contextDomain = spec.contextDomain;\n  if (isPColumnSpec(spec)) result.axesSpec = getAxesId(spec.axesSpec);\n  return canonicalize(result) as NativePObjectId;\n}\n"],"mappings":";;;;;;AAMA,SAAgB,eAAe,MAAoC;CACjE,MAAM,SAAkC;EACtC,MAAM,KAAK;EACX,MAAM,KAAK;CACb;CACA,IAAI,KAAK,WAAW,KAAA,GAAW,OAAO,SAAS,KAAK;CACpD,IAAI,KAAK,kBAAkB,KAAA,GAAW,OAAO,gBAAgB,KAAK;CAClE,IAAIA,eAAAA,cAAc,IAAI,GAAG,OAAO,WAAWC,aAAAA,UAAU,KAAK,QAAQ;CAClE,QAAA,GAAA,aAAA,QAAA,CAAoB,MAAM;AAC5B"}
+{"version":3,"file":"native_id.cjs","names":["isPColumnSpec","getAxesId"],"sources":["../../../../src/drivers/pframe/spec/native_id.ts"],"sourcesContent":["import type { Branded } from \"../../../branding\";\nimport { isPColumnSpec, type PObjectSpec } from \"../../../pool\";\nimport { getAxesId } from \"./spec\";\nimport canonicalize from \"canonicalize\";\nexport type NativePObjectId = Branded<string, \"NativePObjectId\">;\n\nexport function deriveNativeId(spec: PObjectSpec): NativePObjectId {\n  const result: Record<string, unknown> = {\n    kind: spec.kind,\n    name: spec.name,\n  };\n  if (spec.domain !== undefined) result.domain = spec.domain;\n  if (spec.contextDomain !== undefined) result.contextDomain = spec.contextDomain;\n  if (isPColumnSpec(spec)) result.axesSpec = getAxesId(spec.axesSpec);\n  return canonicalize(result) as NativePObjectId;\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,eAAe,MAAoC;CACjE,MAAM,SAAkC;EACtC,MAAM,KAAK;EACX,MAAM,KAAK;CACb;CACA,IAAI,KAAK,WAAW,KAAA,GAAW,OAAO,SAAS,KAAK;CACpD,IAAI,KAAK,kBAAkB,KAAA,GAAW,OAAO,gBAAgB,KAAK;CAClE,IAAIA,eAAAA,cAAc,IAAI,GAAG,OAAO,WAAWC,aAAAA,UAAU,KAAK,QAAQ;CAClE,QAAA,GAAA,aAAA,QAAA,CAAoB,MAAM;AAC5B"}

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

@@ -1,5 +1,6 @@
 import { getAxesId } from "./spec.js";
 import { isPColumnSpec } from "../../../pool/spec.js";
+import "../../../pool/index.js";
 import canonicalize from "canonicalize";
 //#region src/drivers/pframe/spec/native_id.ts
 function deriveNativeId(spec) {

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

@@ -1 +1 @@
-{"version":3,"file":"native_id.js","names":[],"sources":["../../../../src/drivers/pframe/spec/native_id.ts"],"sourcesContent":["import type { Branded } from \"../../../branding\";\nimport { isPColumnSpec, type PObjectSpec } from \"../../../pool\";\nimport { getAxesId } from \"./spec\";\nimport canonicalize from \"canonicalize\";\nexport type NativePObjectId = Branded<string, \"NativePObjectId\">;\n\nexport function deriveNativeId(spec: PObjectSpec): NativePObjectId {\n  const result: Record<string, unknown> = {\n    kind: spec.kind,\n    name: spec.name,\n  };\n  if (spec.domain !== undefined) result.domain = spec.domain;\n  if (spec.contextDomain !== undefined) result.contextDomain = spec.contextDomain;\n  if (isPColumnSpec(spec)) result.axesSpec = getAxesId(spec.axesSpec);\n  return canonicalize(result) as NativePObjectId;\n}\n"],"mappings":";;;;AAMA,SAAgB,eAAe,MAAoC;CACjE,MAAM,SAAkC;EACtC,MAAM,KAAK;EACX,MAAM,KAAK;CACb;CACA,IAAI,KAAK,WAAW,KAAA,GAAW,OAAO,SAAS,KAAK;CACpD,IAAI,KAAK,kBAAkB,KAAA,GAAW,OAAO,gBAAgB,KAAK;CAClE,IAAI,cAAc,IAAI,GAAG,OAAO,WAAW,UAAU,KAAK,QAAQ;CAClE,OAAO,aAAa,MAAM;AAC5B"}
+{"version":3,"file":"native_id.js","names":[],"sources":["../../../../src/drivers/pframe/spec/native_id.ts"],"sourcesContent":["import type { Branded } from \"../../../branding\";\nimport { isPColumnSpec, type PObjectSpec } from \"../../../pool\";\nimport { getAxesId } from \"./spec\";\nimport canonicalize from \"canonicalize\";\nexport type NativePObjectId = Branded<string, \"NativePObjectId\">;\n\nexport function deriveNativeId(spec: PObjectSpec): NativePObjectId {\n  const result: Record<string, unknown> = {\n    kind: spec.kind,\n    name: spec.name,\n  };\n  if (spec.domain !== undefined) result.domain = spec.domain;\n  if (spec.contextDomain !== undefined) result.contextDomain = spec.contextDomain;\n  if (isPColumnSpec(spec)) result.axesSpec = getAxesId(spec.axesSpec);\n  return canonicalize(result) as NativePObjectId;\n}\n"],"mappings":";;;;;AAMA,SAAgB,eAAe,MAAoC;CACjE,MAAM,SAAkC;EACtC,MAAM,KAAK;EACX,MAAM,KAAK;CACb;CACA,IAAI,KAAK,WAAW,KAAA,GAAW,OAAO,SAAS,KAAK;CACpD,IAAI,KAAK,kBAAkB,KAAA,GAAW,OAAO,gBAAgB,KAAK;CAClE,IAAI,cAAc,IAAI,GAAG,OAAO,WAAW,UAAU,KAAK,QAAQ;CAClE,OAAO,aAAa,MAAM;AAC5B"}

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

@@ -0,0 +1,212 @@
+const require_json = require("../../../json.cjs");
+const require_ids = require("./ids.cjs");
+let _milaboratories_helpers = require("@milaboratories/helpers");
+let es_toolkit = require("es-toolkit");
+//#region src/drivers/pframe/spec/overridden.ts
+function isColumnOverriddenKey(obj) {
+	return typeof obj === "object" && obj !== null && "__isOverridden" in obj;
+}
+function distillColumnOverriddenKey(props) {
+	return {
+		__isOverridden: true,
+		source: props.source,
+		specOverrides: props.specOverrides
+	};
+}
+function createColumnOverriddenId(props) {
+	return stringifyColumnOverriddenId(createColumnOverriddenKey(props));
+}
+function createColumnOverriddenKey(props) {
+	const { source, specOverrides } = props;
+	const unwrapped = unwrapOverrides(source);
+	return {
+		__isOverridden: true,
+		source: unwrapped ? unwrapped.source : source,
+		specOverrides: unwrapped ? mergeSpecOverrides(unwrapped.specOverrides, specOverrides) : specOverrides
+	};
+}
+function parseColumnOverriddenId(id) {
+	try {
+		const parsed = JSON.parse(id);
+		return isColumnOverriddenKey(parsed) ? parsed : (0, _milaboratories_helpers.throwError)("Parsed object is not a valid OverriddenPColumn");
+	} catch {
+		throw new Error("Invalid ColumnOverriddenId: not a valid JSON or does not conform to OverriddenPColumn structure");
+	}
+}
+function stringifyColumnOverriddenId(id) {
+	return require_json.canonicalizeJson(distillColumnOverriddenKey(id));
+}
+/**
+* Peel one override-wrap layer.
+*
+* Invariant: `{source, specOverrides}` can only appear at the top level —
+* the inner `source` is never itself an override-wrap. Anything else throws.
+*/
+function unwrapOverrides(id) {
+	const parsed = require_ids.parseColumnIdSafely(id);
+	if (parsed === void 0 || !isColumnOverriddenKey(parsed)) return void 0;
+	const inner = require_ids.parseColumnIdSafely(parsed.source);
+	if (inner !== void 0 && isColumnOverriddenKey(inner)) throw new Error("nested override-wrap detected — invariant broken");
+	return parsed;
+}
+/**
+* Diff two specs into a {@link SpecOverrides} patch that, when applied on top
+* of `base`, reconstructs `next`.
+*
+* - For top-level `annotations` / `domain` / `contextDomain`: include keys
+*   whose value in `next` differs from `base` (or is missing in `base`).
+*   Keys present in `base` but missing in `next` are not emitted — overrides
+*   merge, they cannot delete.
+* - For `axesSpec`: matched by **positional index**. Each `next[i]` is diffed
+*   against `base[i]`; only changed fields are emitted as a patch under key
+*   `i`. Indices past `base.length` carry the full new axis (append).
+*/
+function deriveSpecDelta(base, next) {
+	const annotations = recordDelta(base.annotations, next.annotations);
+	const domain = recordDelta(base.domain, next.domain);
+	const contextDomain = recordDelta(base.contextDomain, next.contextDomain);
+	const axesSpec = deriveAxesDelta(base.axesSpec, next.axesSpec);
+	return {
+		...axesSpec && { axesSpec },
+		...annotations && { annotations },
+		...domain && { domain },
+		...contextDomain && { contextDomain }
+	};
+}
+function isEmptySpecDelta(delta) {
+	return (!delta.annotations || Object.keys(delta.annotations).length === 0) && (!delta.domain || Object.keys(delta.domain).length === 0) && (!delta.contextDomain || Object.keys(delta.contextDomain).length === 0) && (!delta.axesSpec || Object.keys(delta.axesSpec).length === 0);
+}
+function deriveAxesDelta(base, next) {
+	const out = {};
+	let any = false;
+	for (let i = 0; i < next.length; i++) {
+		const a = next[i];
+		const b = base[i];
+		if (b === void 0) {
+			out[i] = a;
+			any = true;
+			continue;
+		}
+		const nameChanged = a.name !== b.name;
+		const typeChanged = a.type !== b.type;
+		const annotations = recordDelta(b.annotations, a.annotations);
+		const domain = recordDelta(b.domain, a.domain);
+		const contextDomain = recordDelta(b.contextDomain, a.contextDomain);
+		if (!nameChanged && !typeChanged && !annotations && !domain && !contextDomain) continue;
+		out[i] = {
+			...nameChanged && { name: a.name },
+			...typeChanged && { type: a.type },
+			...annotations && { annotations },
+			...domain && { domain },
+			...contextDomain && { contextDomain }
+		};
+		any = true;
+	}
+	return any ? out : void 0;
+}
+function recordDelta(base, next) {
+	if (!next) return void 0;
+	let any = false;
+	const diff = {};
+	for (const [k, v] of Object.entries(next)) if (!base || base[k] !== v) {
+		diff[k] = v;
+		any = true;
+	}
+	return any ? diff : void 0;
+}
+/**
+* Apply `specOverrides` from a rich id (`SUniversalPColumnId`) on top of a
+* resolved {@link PColumnSpec}. Returns `base` unchanged when the id carries
+* no overrides.
+*/
+function applySpecOverrides(base, idOrOverride) {
+	if ((0, es_toolkit.isNil)(idOrOverride)) return base;
+	const overrides = (0, es_toolkit.isString)(idOrOverride) ? unwrapOverrides(idOrOverride)?.specOverrides : idOrOverride;
+	if ((0, es_toolkit.isNil)(overrides)) return base;
+	const result = { ...base };
+	if (overrides.annotations) result.annotations = mergeRecord(base.annotations, overrides.annotations);
+	if (overrides.domain) result.domain = mergeRecord(base.domain, overrides.domain);
+	if (overrides.contextDomain) result.contextDomain = mergeRecord(base.contextDomain, overrides.contextDomain);
+	if (overrides.axesSpec) result.axesSpec = applyAxesPatches(base.axesSpec, overrides.axesSpec);
+	return result;
+}
+/**
+* Compose two override patches: applying `mergeSpecOverrides(prior, next)` on
+* top of a base spec produces the same result as applying `prior` then `next`.
+*/
+function mergeSpecOverrides(prior, next) {
+	const result = {};
+	const axesSpec = mergeAxesPatches(prior.axesSpec, next.axesSpec);
+	if (axesSpec !== void 0) result.axesSpec = axesSpec;
+	const annotations = mergeRecord(prior.annotations, next.annotations);
+	if (annotations !== void 0) result.annotations = annotations;
+	const domain = mergeRecord(prior.domain, next.domain);
+	if (domain !== void 0) result.domain = domain;
+	const contextDomain = mergeRecord(prior.contextDomain, next.contextDomain);
+	if (contextDomain !== void 0) result.contextDomain = contextDomain;
+	return result;
+}
+/**
+* Apply positional `patches` onto `base.axesSpec`. Patches deep-merge
+* `annotations` / `domain` / `contextDomain` and shallow-override `name` /
+* `type` at their slot. Indices `>= base.length` append new axes; intermediate
+* gaps (if any) are filled with the patch itself, so callers should not leave
+* holes between base.length and the highest patched index.
+*/
+function applyAxesPatches(base, patches) {
+	const result = base.slice();
+	for (const [k, p] of Object.entries(patches)) {
+		const i = Number(k);
+		const existing = result[i];
+		result[i] = existing === void 0 ? p : mergeAxisPatch(existing, p);
+	}
+	return result;
+}
+/**
+* Compose two positional patch maps: `mergeAxesPatches(prior, next)` applied to
+* a base spec must equal applying `prior` then `next`. Patches sharing an
+* index deep-merge field-by-field.
+*/
+function mergeAxesPatches(prior, next) {
+	if (!prior || Object.keys(prior).length === 0) return next;
+	if (!next || Object.keys(next).length === 0) return prior;
+	const result = { ...prior };
+	for (const [k, p] of Object.entries(next)) {
+		const i = Number(k);
+		const existing = result[i];
+		result[i] = existing === void 0 ? p : mergeAxisPatch(existing, p);
+	}
+	return result;
+}
+function mergeAxisPatch(axis, patch) {
+	const result = {
+		...axis,
+		...patch
+	};
+	if (patch.annotations) result.annotations = mergeRecord(axis.annotations, patch.annotations);
+	if (patch.domain) result.domain = mergeRecord(axis.domain, patch.domain);
+	if (patch.contextDomain) result.contextDomain = mergeRecord(axis.contextDomain, patch.contextDomain);
+	return result;
+}
+function mergeRecord(a, b) {
+	if (!b) return a;
+	if (!a) return b;
+	return {
+		...a,
+		...b
+	};
+}
+//#endregion
+exports.applySpecOverrides = applySpecOverrides;
+exports.createColumnOverriddenId = createColumnOverriddenId;
+exports.createColumnOverriddenKey = createColumnOverriddenKey;
+exports.deriveSpecDelta = deriveSpecDelta;
+exports.distillColumnOverriddenKey = distillColumnOverriddenKey;
+exports.isColumnOverriddenKey = isColumnOverriddenKey;
+exports.isEmptySpecDelta = isEmptySpecDelta;
+exports.mergeSpecOverrides = mergeSpecOverrides;
+exports.parseColumnOverriddenId = parseColumnOverriddenId;
+exports.stringifyColumnOverriddenId = stringifyColumnOverriddenId;
+exports.unwrapOverrides = unwrapOverrides;
+
+//# sourceMappingURL=overridden.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overridden.cjs","names":["canonicalizeJson","parseColumnIdSafely"],"sources":["../../../../src/drivers/pframe/spec/overridden.ts"],"sourcesContent":["import { type Branded, throwError, type Mutable, Nil } from \"@milaboratories/helpers\";\nimport { type CanonicalizedJson, canonicalizeJson } from \"../../../json\";\nimport { AxisPatches, type ColumnUniversalId, parseColumnIdSafely } from \"./ids\";\nimport type { AxisSpec, PColumnSpec } from \"./spec\";\nimport { isNil, isString } from \"es-toolkit\";\n\nexport type SpecOverrides = Pick<PColumnSpec, \"domain\" | \"contextDomain\" | \"annotations\"> & {\n  axesSpec?: AxisPatches;\n};\n\n/**\n * `source` can reference a leaf or a Filtered/Discovered id, but never another\n * Overridden id — there is no `Overridden<Overridden<...>>`. Repeated overrides\n * merge at the outer wrapper via {@link mergeSpecOverrides}.\n */\nexport interface ColumnOverriddenKey {\n  __isOverridden: true;\n  source: Exclude<ColumnUniversalId, ColumnOverriddenId>;\n  specOverrides: SpecOverrides;\n}\n\nexport type ColumnOverriddenId = Branded<\n  CanonicalizedJson<ColumnOverriddenKey>,\n  \"ColumnOverriddenId\"\n>;\n\nexport function isColumnOverriddenKey(obj: unknown): obj is ColumnOverriddenKey {\n  return typeof obj === \"object\" && obj !== null && \"__isOverridden\" in obj;\n}\n\nexport function distillColumnOverriddenKey(props: ColumnOverriddenKey): ColumnOverriddenKey {\n  return {\n    __isOverridden: true,\n    source: props.source,\n    specOverrides: props.specOverrides,\n  };\n}\n\nexport function createColumnOverriddenId(props: {\n  source: ColumnUniversalId;\n  specOverrides: SpecOverrides;\n}): ColumnOverriddenId {\n  return stringifyColumnOverriddenId(createColumnOverriddenKey(props));\n}\n\nexport function createColumnOverriddenKey(props: {\n  source: ColumnUniversalId;\n  specOverrides: SpecOverrides;\n}): ColumnOverriddenKey {\n  const { source, specOverrides } = props;\n  const unwrapped = unwrapOverrides(source);\n  const baseSource = unwrapped\n    ? unwrapped.source\n    : (source as Exclude<ColumnUniversalId, ColumnOverriddenId>);\n  const mergedOverrides = unwrapped\n    ? mergeSpecOverrides(unwrapped.specOverrides, specOverrides)\n    : specOverrides;\n\n  return {\n    __isOverridden: true,\n    source: baseSource,\n    specOverrides: mergedOverrides,\n  };\n}\n\nexport function parseColumnOverriddenId(id: ColumnUniversalId): ColumnOverriddenKey {\n  try {\n    const parsed = JSON.parse(id);\n    return isColumnOverriddenKey(parsed)\n      ? parsed\n      : throwError(\"Parsed object is not a valid OverriddenPColumn\");\n  } catch {\n    throw new Error(\n      \"Invalid ColumnOverriddenId: not a valid JSON or does not conform to OverriddenPColumn structure\",\n    );\n  }\n}\n\nexport function stringifyColumnOverriddenId(id: ColumnOverriddenKey): ColumnOverriddenId {\n  return canonicalizeJson<ColumnOverriddenKey>(\n    distillColumnOverriddenKey(id),\n  ) as ColumnOverriddenId;\n}\n\n/**\n * Peel one override-wrap layer.\n *\n * Invariant: `{source, specOverrides}` can only appear at the top level —\n * the inner `source` is never itself an override-wrap. Anything else throws.\n */\nexport function unwrapOverrides(id: ColumnUniversalId): ColumnOverriddenKey | undefined {\n  const parsed = parseColumnIdSafely(id);\n  if (parsed === undefined || !isColumnOverriddenKey(parsed)) return undefined;\n  const inner = parseColumnIdSafely(parsed.source);\n  if (inner !== undefined && isColumnOverriddenKey(inner)) {\n    throw new Error(\"nested override-wrap detected — invariant broken\");\n  }\n  return parsed;\n}\n\n/**\n * Diff two specs into a {@link SpecOverrides} patch that, when applied on top\n * of `base`, reconstructs `next`.\n *\n * - For top-level `annotations` / `domain` / `contextDomain`: include keys\n *   whose value in `next` differs from `base` (or is missing in `base`).\n *   Keys present in `base` but missing in `next` are not emitted — overrides\n *   merge, they cannot delete.\n * - For `axesSpec`: matched by **positional index**. Each `next[i]` is diffed\n *   against `base[i]`; only changed fields are emitted as a patch under key\n *   `i`. Indices past `base.length` carry the full new axis (append).\n */\nexport function deriveSpecDelta(base: PColumnSpec, next: PColumnSpec): SpecOverrides {\n  const annotations = recordDelta(base.annotations, next.annotations);\n  const domain = recordDelta(base.domain, next.domain);\n  const contextDomain = recordDelta(base.contextDomain, next.contextDomain);\n  const axesSpec = deriveAxesDelta(base.axesSpec, next.axesSpec);\n  return {\n    ...(axesSpec && { axesSpec }),\n    ...(annotations && { annotations }),\n    ...(domain && { domain }),\n    ...(contextDomain && { contextDomain }),\n  };\n}\n\nexport function isEmptySpecDelta(delta: SpecOverrides): boolean {\n  return (\n    (!delta.annotations || Object.keys(delta.annotations).length === 0) &&\n    (!delta.domain || Object.keys(delta.domain).length === 0) &&\n    (!delta.contextDomain || Object.keys(delta.contextDomain).length === 0) &&\n    (!delta.axesSpec || Object.keys(delta.axesSpec).length === 0)\n  );\n}\n\nfunction deriveAxesDelta(\n  base: readonly AxisSpec[],\n  next: readonly AxisSpec[],\n): AxisPatches | undefined {\n  const out: AxisPatches = {};\n  let any = false;\n  for (let i = 0; i < next.length; i++) {\n    const a = next[i];\n    const b = base[i];\n    if (b === undefined) {\n      out[i] = a;\n      any = true;\n      continue;\n    }\n    const nameChanged = a.name !== b.name;\n    const typeChanged = a.type !== b.type;\n    const annotations = recordDelta(b.annotations, a.annotations);\n    const domain = recordDelta(b.domain, a.domain);\n    const contextDomain = recordDelta(b.contextDomain, a.contextDomain);\n    if (!nameChanged && !typeChanged && !annotations && !domain && !contextDomain) continue;\n    out[i] = {\n      ...(nameChanged && { name: a.name }),\n      ...(typeChanged && { type: a.type }),\n      ...(annotations && { annotations }),\n      ...(domain && { domain }),\n      ...(contextDomain && { contextDomain }),\n    };\n    any = true;\n  }\n  return any ? out : undefined;\n}\n\nfunction recordDelta(\n  base: Record<string, string> | undefined,\n  next: Record<string, string> | undefined,\n): Record<string, string> | undefined {\n  if (!next) return undefined;\n  let any = false;\n  const diff: Record<string, string> = {};\n  for (const [k, v] of Object.entries(next)) {\n    if (!base || base[k] !== v) {\n      diff[k] = v;\n      any = true;\n    }\n  }\n  return any ? diff : undefined;\n}\n\n/**\n * Apply `specOverrides` from a rich id (`SUniversalPColumnId`) on top of a\n * resolved {@link PColumnSpec}. Returns `base` unchanged when the id carries\n * no overrides.\n */\nexport function applySpecOverrides(\n  base: PColumnSpec,\n  idOrOverride: Nil | SpecOverrides | ColumnUniversalId,\n): PColumnSpec {\n  if (isNil(idOrOverride)) {\n    return base;\n  }\n\n  const overrides = isString(idOrOverride)\n    ? unwrapOverrides(idOrOverride)?.specOverrides\n    : idOrOverride;\n\n  if (isNil(overrides)) {\n    return base;\n  }\n\n  const result = { ...base };\n  if (overrides.annotations)\n    result.annotations = mergeRecord(base.annotations, overrides.annotations);\n  if (overrides.domain) result.domain = mergeRecord(base.domain, overrides.domain);\n  if (overrides.contextDomain)\n    result.contextDomain = mergeRecord(base.contextDomain, overrides.contextDomain);\n  if (overrides.axesSpec) result.axesSpec = applyAxesPatches(base.axesSpec, overrides.axesSpec);\n  return result;\n}\n\n/**\n * Compose two override patches: applying `mergeSpecOverrides(prior, next)` on\n * top of a base spec produces the same result as applying `prior` then `next`.\n */\nexport function mergeSpecOverrides(prior: SpecOverrides, next: SpecOverrides): SpecOverrides {\n  const result: Mutable<SpecOverrides> = {};\n  const axesSpec = mergeAxesPatches(prior.axesSpec, next.axesSpec);\n  if (axesSpec !== undefined) result.axesSpec = axesSpec;\n  const annotations = mergeRecord(prior.annotations, next.annotations);\n  if (annotations !== undefined) result.annotations = annotations;\n  const domain = mergeRecord(prior.domain, next.domain);\n  if (domain !== undefined) result.domain = domain;\n  const contextDomain = mergeRecord(prior.contextDomain, next.contextDomain);\n  if (contextDomain !== undefined) result.contextDomain = contextDomain;\n  return result;\n}\n\n/**\n * Apply positional `patches` onto `base.axesSpec`. Patches deep-merge\n * `annotations` / `domain` / `contextDomain` and shallow-override `name` /\n * `type` at their slot. Indices `>= base.length` append new axes; intermediate\n * gaps (if any) are filled with the patch itself, so callers should not leave\n * holes between base.length and the highest patched index.\n */\nfunction applyAxesPatches(base: readonly AxisSpec[], patches: AxisPatches): AxisSpec[] {\n  const result: AxisSpec[] = base.slice();\n  for (const [k, p] of Object.entries(patches)) {\n    const i = Number(k);\n    const existing = result[i];\n    result[i] = (existing === undefined ? p : mergeAxisPatch(existing, p)) as AxisSpec;\n  }\n  return result;\n}\n\n/**\n * Compose two positional patch maps: `mergeAxesPatches(prior, next)` applied to\n * a base spec must equal applying `prior` then `next`. Patches sharing an\n * index deep-merge field-by-field.\n */\nfunction mergeAxesPatches(\n  prior: AxisPatches | undefined,\n  next: AxisPatches | undefined,\n): AxisPatches | undefined {\n  if (!prior || Object.keys(prior).length === 0) return next;\n  if (!next || Object.keys(next).length === 0) return prior;\n  const result: AxisPatches = { ...prior };\n  for (const [k, p] of Object.entries(next)) {\n    const i = Number(k);\n    const existing = result[i];\n    result[i] = existing === undefined ? p : mergeAxisPatch(existing, p);\n  }\n  return result;\n}\n\nfunction mergeAxisPatch<A extends Partial<AxisSpec>>(axis: A, patch: Partial<AxisSpec>): A {\n  const result: Mutable<A> = { ...axis, ...patch };\n  if (patch.annotations) result.annotations = mergeRecord(axis.annotations, patch.annotations);\n  if (patch.domain) result.domain = mergeRecord(axis.domain, patch.domain);\n  if (patch.contextDomain) {\n    result.contextDomain = mergeRecord(axis.contextDomain, patch.contextDomain);\n  }\n  return result;\n}\n\nfunction mergeRecord(\n  a: Record<string, string> | undefined,\n  b: Record<string, string> | undefined,\n): Record<string, string> | undefined {\n  if (!b) return a;\n  if (!a) return b;\n  return { ...a, ...b };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,67 @@
+import { CanonicalizedJson } from "../../../json.js";
+import { PColumnSpec } from "./spec.js";
+import { AxisPatches, ColumnUniversalId } from "./ids.js";
+import { Branded, Nil } from "@milaboratories/helpers";
+
+//#region src/drivers/pframe/spec/overridden.d.ts
+type SpecOverrides = Pick<PColumnSpec, "domain" | "contextDomain" | "annotations"> & {
+  axesSpec?: AxisPatches;
+};
+/**
+ * `source` can reference a leaf or a Filtered/Discovered id, but never another
+ * Overridden id — there is no `Overridden<Overridden<...>>`. Repeated overrides
+ * merge at the outer wrapper via {@link mergeSpecOverrides}.
+ */
+interface ColumnOverriddenKey {
+  __isOverridden: true;
+  source: Exclude<ColumnUniversalId, ColumnOverriddenId>;
+  specOverrides: SpecOverrides;
+}
+type ColumnOverriddenId = Branded<CanonicalizedJson<ColumnOverriddenKey>, "ColumnOverriddenId">;
+declare function isColumnOverriddenKey(obj: unknown): obj is ColumnOverriddenKey;
+declare function distillColumnOverriddenKey(props: ColumnOverriddenKey): ColumnOverriddenKey;
+declare function createColumnOverriddenId(props: {
+  source: ColumnUniversalId;
+  specOverrides: SpecOverrides;
+}): ColumnOverriddenId;
+declare function createColumnOverriddenKey(props: {
+  source: ColumnUniversalId;
+  specOverrides: SpecOverrides;
+}): ColumnOverriddenKey;
+declare function parseColumnOverriddenId(id: ColumnUniversalId): ColumnOverriddenKey;
+declare function stringifyColumnOverriddenId(id: ColumnOverriddenKey): ColumnOverriddenId;
+/**
+ * Peel one override-wrap layer.
+ *
+ * Invariant: `{source, specOverrides}` can only appear at the top level —
+ * the inner `source` is never itself an override-wrap. Anything else throws.
+ */
+declare function unwrapOverrides(id: ColumnUniversalId): ColumnOverriddenKey | undefined;
+/**
+ * Diff two specs into a {@link SpecOverrides} patch that, when applied on top
+ * of `base`, reconstructs `next`.
+ *
+ * - For top-level `annotations` / `domain` / `contextDomain`: include keys
+ *   whose value in `next` differs from `base` (or is missing in `base`).
+ *   Keys present in `base` but missing in `next` are not emitted — overrides
+ *   merge, they cannot delete.
+ * - For `axesSpec`: matched by **positional index**. Each `next[i]` is diffed
+ *   against `base[i]`; only changed fields are emitted as a patch under key
+ *   `i`. Indices past `base.length` carry the full new axis (append).
+ */
+declare function deriveSpecDelta(base: PColumnSpec, next: PColumnSpec): SpecOverrides;
+declare function isEmptySpecDelta(delta: SpecOverrides): boolean;
+/**
+ * Apply `specOverrides` from a rich id (`SUniversalPColumnId`) on top of a
+ * resolved {@link PColumnSpec}. Returns `base` unchanged when the id carries
+ * no overrides.
+ */
+declare function applySpecOverrides(base: PColumnSpec, idOrOverride: Nil | SpecOverrides | ColumnUniversalId): PColumnSpec;
+/**
+ * Compose two override patches: applying `mergeSpecOverrides(prior, next)` on
+ * top of a base spec produces the same result as applying `prior` then `next`.
+ */
+declare function mergeSpecOverrides(prior: SpecOverrides, next: SpecOverrides): SpecOverrides;
+//#endregion
+export { ColumnOverriddenId, ColumnOverriddenKey, SpecOverrides, applySpecOverrides, createColumnOverriddenId, createColumnOverriddenKey, deriveSpecDelta, distillColumnOverriddenKey, isColumnOverriddenKey, isEmptySpecDelta, mergeSpecOverrides, parseColumnOverriddenId, stringifyColumnOverriddenId, unwrapOverrides };
+//# sourceMappingURL=overridden.d.ts.map

package/dist/drivers/pframe/spec/overridden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overridden.d.ts","names":[],"sources":["../../../../src/drivers/pframe/spec/overridden.ts"],"mappings":";;;;;;KAMY,aAAA,GAAgB,IAAA,CAAK,WAAA;EAC/B,QAAA,GAAW,WAAA;AAAA;;;;;;UAQI,mBAAA;EACf,cAAA;EACA,MAAA,EAAQ,OAAA,CAAQ,iBAAA,EAAmB,kBAAA;EACnC,aAAA,EAAe,aAAA;AAAA;AAAA,KAGL,kBAAA,GAAqB,OAAA,CAC/B,iBAAA,CAAkB,mBAAA;AAAA,iBAIJ,qBAAA,CAAsB,GAAA,YAAe,GAAA,IAAO,mBAAmB;AAAA,iBAI/D,0BAAA,CAA2B,KAAA,EAAO,mBAAA,GAAsB,mBAAmB;AAAA,iBAQ3E,wBAAA,CAAyB,KAAA;EACvC,MAAA,EAAQ,iBAAA;EACR,aAAA,EAAe,aAAA;AAAA,IACb,kBAAA;AAAA,iBAIY,yBAAA,CAA0B,KAAA;EACxC,MAAA,EAAQ,iBAAA;EACR,aAAA,EAAe,aAAA;AAAA,IACb,mBAAA;AAAA,iBAiBY,uBAAA,CAAwB,EAAA,EAAI,iBAAA,GAAoB,mBAAmB;AAAA,iBAanE,2BAAA,CAA4B,EAAA,EAAI,mBAAA,GAAsB,kBAAkB;;;;;;;iBAYxE,eAAA,CAAgB,EAAA,EAAI,iBAAA,GAAoB,mBAAmB;AAxE7C;AAG9B;;;;;;;;;;;AAH8B,iBA8Fd,eAAA,CAAgB,IAAA,EAAM,WAAA,EAAa,IAAA,EAAM,WAAA,GAAc,aAAA;AAAA,iBAavD,gBAAA,CAAiB,KAAoB,EAAb,aAAa;AAnGrD;;;;;AAAA,iBAiKgB,kBAAA,CACd,IAAA,EAAM,WAAA,EACN,YAAA,EAAc,GAAA,GAAM,aAAA,GAAgB,iBAAA,GACnC,WAAA;;;AApK4E;AAI/E;iBA2LgB,kBAAA,CAAmB,KAAA,EAAO,aAAA,EAAe,IAAA,EAAM,aAAA,GAAgB,aAAA"}