@milaboratories/pl-model-common 1.46.3 → 1.47.0

package/dist/drivers/pframe/table_calculate.d.ts

@@ -2,7 +2,7 @@ import { PColumn } from "./spec/spec.js";
 import { PTableColumnId, PTableColumnSpec } from "./table_common.js";
 import { PTableVector } from "./data_types.js";
 import { PColumnValues } from "./data_info.js";
-import { SpecQuery } from "./query/query_spec.js";
+import { SpecQuery, SpecQueryJoinEntry } from "./query/query_spec.js";
 import { PObjectId } from "../../pool/spec.js";
 //#region src/drivers/pframe/table_calculate.d.ts
 /** Defines a terminal column node in the join request tree */
@@ -287,7 +287,11 @@ type CalculateTableDataRequest<Col> = {
 type CalculateTableDataResponse = FullPTableColumnData[];
 declare function mapPTableDef<C1, C2>(def: PTableDef<C1>, cb: (c: C1) => C2): PTableDef<C2>;
 declare function sortPTableDef(def: PTableDef<PObjectId>): PTableDef<PObjectId>;
-declare function mapPTableDefV2<C1, C2>(def: PTableDefV2<C1>, cb: (c: C1) => C2): PTableDefV2<C2>;
+declare function mapPTableDefV2<C1, C2>(def: PTableDefV2<C1>, visitor: {
+  /** Transform column references in leaf nodes (column, sparseToDenseColumn). */column: (c: C1) => C2; /** Visit a node after its children have been traversed. */
+  node?: (node: SpecQuery<C2>) => SpecQuery<C2>; /** Visit a join entry after its inner query has been traversed. */
+  joinEntry?: (entry: SpecQueryJoinEntry<C2>) => SpecQueryJoinEntry<C2>;
+}): PTableDefV2<C2>;
 declare function mapJoinEntry<C1, C2>(entry: JoinEntry<C1>, cb: (c: C1) => C2): JoinEntry<C2>;
 declare function sortJoinEntry(entry: JoinEntry<PObjectId>): JoinEntry<PObjectId>;
 //#endregion

package/dist/drivers/pframe/table_calculate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table_calculate.d.ts","names":[],"sources":["../../../src/drivers/pframe/table_calculate.ts"],"mappings":"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"}
+{"version":3,"file":"table_calculate.d.ts","names":[],"sources":["../../../src/drivers/pframe/table_calculate.ts"],"mappings":"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"}

package/dist/drivers/pframe/table_calculate.js

@@ -25,8 +25,8 @@ function sortPTableDef(def) {
 		sorting: def.sorting
 	};
 }
-function mapPTableDefV2(def, cb) {
-	return { query: mapSpecQueryColumns(def.query, cb) };
+function mapPTableDefV2(def, visitor) {
+	return { query: mapSpecQueryColumns(def.query, visitor) };
 }
 function mapJoinEntry(entry, cb) {
 	switch (entry.type) {

package/dist/drivers/pframe/table_calculate.js.map

@@ -1 +1 @@
-{"version":3,"file":"table_calculate.js","names":[],"sources":["../../../src/drivers/pframe/table_calculate.ts"],"sourcesContent":["import type { PTableColumnId, PTableColumnSpec } from \"./table_common\";\nimport type { PTableVector } from \"./data_types\";\nimport type { PObjectId } from \"../../pool\";\nimport { assertNever } from \"../../util\";\nimport { getAxisId, type PColumn } from \"./spec/spec\";\nimport type { PColumnValues } from \"./data_info\";\nimport type { SpecQuery } from \"./query/query_spec\";\nimport { canonicalizeJson } from \"../../json\";\nimport { mapSpecQueryColumns } from \"./query\";\n\n/** Defines a terminal column node in the join request tree */\nexport interface ColumnJoinEntry<Col> {\n  /** Node type discriminator */\n  readonly type: \"column\";\n\n  /** Local column */\n  readonly column: Col;\n}\n\n/**\n * Axis filter slicing target axis from column axes.\n * If the axis has parents or is a parent, slicing cannot be applied (an error will be thrown).\n * */\nexport interface ConstantAxisFilter {\n  /** Filter type discriminator */\n  readonly type: \"constant\";\n\n  /** Index of axis to slice (zero-based) */\n  readonly axisIndex: number;\n\n  /** Equality filter reference value, see {@link SingleValueEqualPredicate} */\n  readonly constant: string | number;\n}\n\n/** Defines a terminal column node in the join request tree */\nexport interface SlicedColumnJoinEntry<Col> {\n  /** Node type discriminator */\n  readonly type: \"slicedColumn\";\n\n  /** Local column */\n  readonly column: Col;\n\n  /** New column id */\n  readonly newId: PObjectId;\n\n  /** Non-empty list of axis filters */\n  readonly axisFilters: ConstantAxisFilter[];\n}\n\nexport interface ArtificialColumnJoinEntry<Col> {\n  /** Node type discriminator */\n  readonly type: \"artificialColumn\";\n\n  /** Column definition */\n  readonly column: Col;\n\n  /** New column id */\n  readonly newId: PObjectId;\n\n  /** Indices of axes to pick from the column (zero-based) */\n  readonly axesIndices: number[];\n}\n\n/** Defines a terminal column node in the join request tree */\nexport interface InlineColumnJoinEntry {\n  /** Node type discriminator */\n  readonly type: \"inlineColumn\";\n\n  /** Column definition */\n  readonly column: PColumn<PColumnValues>;\n}\n\n/**\n * Defines a join request tree node that will output only records present in\n * all child nodes ({@link entries}).\n * */\nexport interface InnerJoin<Col> {\n  /** Node type discriminator */\n  readonly type: \"inner\";\n\n  /** Child nodes to be inner joined */\n  readonly entries: JoinEntry<Col>[];\n}\n\n/**\n * Defines a join request tree node that will output all records present at\n * least in one of the child nodes ({@link entries}), values for those PColumns\n * that lack corresponding combinations of axis values will be null.\n * */\nexport interface FullJoin<Col> {\n  /** Node type discriminator */\n  readonly type: \"full\";\n\n  /** Child nodes to be fully outer joined */\n  readonly entries: JoinEntry<Col>[];\n}\n\n/**\n * Defines a join request tree node that will output all records present in\n * {@link primary} child node, and records from the {@link secondary} nodes will\n * be added to the output only if present, values for those PColumns from the\n * {@link secondary} list, that lack corresponding combinations of axis values\n * will be null.\n *\n * This node can be thought as a chain of SQL LEFT JOIN operations starting from\n * the {@link primary} node and adding {@link secondary} nodes one by one.\n * */\nexport interface OuterJoin<Col> {\n  /** Node type discriminator */\n  readonly type: \"outer\";\n\n  /** Primes the join operation. Left part of LEFT JOIN. */\n  readonly primary: JoinEntry<Col>;\n\n  /** Driven nodes, giving their values only if primary node have corresponding\n   * nodes. Right parts of LEFT JOIN chain. */\n  readonly secondary: JoinEntry<Col>[];\n}\n\n/**\n * Base type of all join request tree nodes. Join request tree allows to combine\n * information from multiple PColumns into a PTable. Correlation between records\n * is performed by looking for records with the same values in common axis between\n * the PColumns. Common axis are those axis which have equal {@link AxisId} derived\n * from the columns axes spec.\n * */\nexport type JoinEntry<Col> =\n  | ColumnJoinEntry<Col>\n  | SlicedColumnJoinEntry<Col>\n  | ArtificialColumnJoinEntry<Col>\n  | InlineColumnJoinEntry\n  | InnerJoin<Col>\n  | FullJoin<Col>\n  | OuterJoin<Col>;\n\n/** Container representing whole data stored in specific PTable column. */\nexport interface FullPTableColumnData {\n  /** Unified spec */\n  readonly spec: PTableColumnSpec;\n\n  /** Data */\n  readonly data: PTableVector;\n}\n\nexport interface SingleValueIsNAPredicate {\n  /** Comparison operator */\n  readonly operator: \"IsNA\";\n}\n\nexport interface SingleValueEqualPredicate {\n  /** Comparison operator */\n  readonly operator: \"Equal\";\n\n  /** Reference value, NA values will not match */\n  readonly reference: string | number;\n}\n\nexport interface SingleValueInSetPredicate {\n  /** Comparison operator */\n  readonly operator: \"InSet\";\n\n  /** Reference values, NA values will not match */\n  readonly references: (string | number)[];\n}\n\nexport interface SingleValueIEqualPredicate {\n  /** Comparison operator (case insensitive) */\n  readonly operator: \"IEqual\";\n\n  /** Reference value, NA values will not match */\n  readonly reference: string;\n}\n\nexport interface SingleValueLessPredicate {\n  /** Comparison operator */\n  readonly operator: \"Less\";\n\n  /** Reference value, NA values will not match */\n  readonly reference: string | number;\n}\n\nexport interface SingleValueLessOrEqualPredicate {\n  /** Comparison operator */\n  readonly operator: \"LessOrEqual\";\n\n  /** Reference value, NA values will not match */\n  readonly reference: string | number;\n}\n\nexport interface SingleValueGreaterPredicate {\n  /** Comparison operator */\n  readonly operator: \"Greater\";\n\n  /** Reference value, NA values will not match */\n  readonly reference: string | number;\n}\n\nexport interface SingleValueGreaterOrEqualPredicate {\n  /** Comparison operator */\n  readonly operator: \"GreaterOrEqual\";\n\n  /** Reference value, NA values will not match */\n  readonly reference: string | number;\n}\n\nexport interface SingleValueStringContainsPredicate {\n  /** Comparison operator */\n  readonly operator: \"StringContains\";\n\n  /** Reference substring, NA values are skipped */\n  readonly substring: string;\n}\n\nexport interface SingleValueStringIContainsPredicate {\n  /** Comparison operator (case insensitive) */\n  readonly operator: \"StringIContains\";\n\n  /** Reference substring, NA values are skipped */\n  readonly substring: string;\n}\n\nexport interface SingleValueMatchesPredicate {\n  /** Comparison operator */\n  readonly operator: \"Matches\";\n\n  /** Regular expression, NA values are skipped */\n  readonly regex: string;\n}\n\nexport interface SingleValueStringContainsFuzzyPredicate {\n  /** Comparison operator */\n  readonly operator: \"StringContainsFuzzy\";\n\n  /** Reference value, NA values are skipped */\n  readonly reference: string;\n\n  /**\n   * Integer specifying the upper bound of edit distance between\n   * reference and actual value.\n   * When {@link substitutionsOnly} is not defined or set to false\n   * Levenshtein distance is used (substitutions and indels)\n   * @see https://en.wikipedia.org/wiki/Levenshtein_distance\n   * When {@link substitutionsOnly} is set to true\n   * Hamming distance is used (substitutions only)\n   * @see https://en.wikipedia.org/wiki/Hamming_distance\n   */\n  readonly maxEdits: number;\n\n  /** Changes the type of edit distance in {@link maxEdits} */\n  readonly substitutionsOnly?: boolean;\n\n  /**\n   * Some character in {@link reference} that will match any\n   * single character in searched text.\n   */\n  readonly wildcard?: string;\n}\n\nexport interface SingleValueStringIContainsFuzzyPredicate {\n  /** Comparison operator (case insensitive) */\n  readonly operator: \"StringIContainsFuzzy\";\n\n  /** Reference value, NA values are skipped */\n  readonly reference: string;\n\n  /**\n   * Integer specifying the upper bound of edit distance between\n   * reference and actual value.\n   * When {@link substitutionsOnly} is not defined or set to false\n   * Levenshtein distance is used (substitutions and indels)\n   * @see https://en.wikipedia.org/wiki/Levenshtein_distance\n   * When {@link substitutionsOnly} is set to true\n   * Hamming distance is used (substitutions only)\n   * @see https://en.wikipedia.org/wiki/Hamming_distance\n   */\n  readonly maxEdits: number;\n\n  /** Changes the type of edit distance in {@link maxEdits} */\n  readonly substitutionsOnly?: boolean;\n\n  /**\n   * Some character in {@link reference} that will match any\n   * single character in searched text.\n   */\n  readonly wildcard?: string;\n}\n\nexport interface SingleValueNotPredicateV2 {\n  /** Comparison operator */\n  readonly operator: \"Not\";\n\n  /** Operand to negate */\n  readonly operand: SingleValuePredicateV2;\n}\n\nexport interface SingleValueAndPredicateV2 {\n  /** Comparison operator */\n  readonly operator: \"And\";\n\n  /** Operands to combine */\n  readonly operands: SingleValuePredicateV2[];\n}\n\nexport interface SingleValueOrPredicateV2 {\n  /** Comparison operator */\n  readonly operator: \"Or\";\n\n  /** Operands to combine */\n  readonly operands: SingleValuePredicateV2[];\n}\n\n/** Filtering predicate for a single axis or column value */\nexport type SingleValuePredicateV2 =\n  | SingleValueIsNAPredicate\n  | SingleValueEqualPredicate\n  | SingleValueInSetPredicate\n  | SingleValueLessPredicate\n  | SingleValueLessOrEqualPredicate\n  | SingleValueGreaterPredicate\n  | SingleValueGreaterOrEqualPredicate\n  | SingleValueStringContainsPredicate\n  | SingleValueMatchesPredicate\n  | SingleValueStringContainsFuzzyPredicate\n  | SingleValueNotPredicateV2\n  | SingleValueAndPredicateV2\n  | SingleValueOrPredicateV2\n  | SingleValueIEqualPredicate\n  | SingleValueStringIContainsPredicate\n  | SingleValueStringIContainsFuzzyPredicate;\n\n/**\n * Filter PTable records based on specific axis or column value. If this is an\n * axis value filter and the axis is part of a partitioning key in some of the\n * source PColumns, the filter will be pushed down to those columns, so only\n * specific partitions will be retrieved from the remote storage.\n * */\nexport interface PTableRecordSingleValueFilterV2 {\n  /** Filter type discriminator */\n  readonly type: \"bySingleColumnV2\";\n\n  /** Target axis selector to examine values from */\n  readonly column: PTableColumnId;\n\n  /** Value predicate */\n  readonly predicate: SingleValuePredicateV2;\n}\n\n/** Generic PTable records filter */\nexport type PTableRecordFilter = PTableRecordSingleValueFilterV2;\n\n/** Sorting parameters for a PTable.  */\nexport type PTableSorting = {\n  /** Unified column identifier */\n  readonly column: PTableColumnId;\n\n  /** Sorting order */\n  readonly ascending: boolean;\n\n  /** Sorting in respect to NA and absent values */\n  readonly naAndAbsentAreLeastValues: boolean;\n};\n\n/** Information required to instantiate a PTable. */\nexport interface PTableDef<Col> {\n  /** Join tree to populate the PTable */\n  readonly src: JoinEntry<Col>;\n\n  /** Partition filters */\n  readonly partitionFilters: PTableRecordFilter[];\n\n  /** Record filters */\n  readonly filters: PTableRecordFilter[];\n\n  /** Table sorting */\n  readonly sorting: PTableSorting[];\n}\n\n/** Information required to instantiate a PTable (V2, query-based). */\nexport interface PTableDefV2<Col> {\n  /** Pre-built query spec describing joins, filters and sorting */\n  readonly query: SpecQuery<Col>;\n}\n\n/** Request to create and retrieve entirety of data of PTable. */\nexport type CalculateTableDataRequest<Col> = {\n  /** Join tree to populate the PTable */\n  readonly src: JoinEntry<Col>;\n\n  /** Record filters */\n  readonly filters: PTableRecordFilter[];\n\n  /** Table sorting */\n  readonly sorting: PTableSorting[];\n};\n\n/** Response for {@link CalculateTableDataRequest} */\nexport type CalculateTableDataResponse = FullPTableColumnData[];\n\nexport function mapPTableDef<C1, C2>(def: PTableDef<C1>, cb: (c: C1) => C2): PTableDef<C2> {\n  return { ...def, src: mapJoinEntry(def.src, cb) };\n}\n\nexport function sortPTableDef(def: PTableDef<PObjectId>): PTableDef<PObjectId> {\n  function sortFilters(filters: PTableRecordFilter[]): PTableRecordFilter[] {\n    return filters.toSorted((lhs, rhs) => {\n      if (lhs.column.type === \"axis\" && rhs.column.type === \"axis\") {\n        const lhsId = canonicalizeJson(getAxisId(lhs.column.id));\n        const rhsId = canonicalizeJson(getAxisId(rhs.column.id));\n        return lhsId < rhsId ? -1 : 1;\n      } else if (lhs.column.type === \"column\" && rhs.column.type === \"column\") {\n        return lhs.column.id < rhs.column.id ? -1 : 1;\n      } else {\n        return lhs.column.type === \"axis\" ? -1 : 1;\n      }\n    });\n  }\n  return {\n    src: sortJoinEntry(def.src),\n    partitionFilters: sortFilters(def.partitionFilters),\n    filters: sortFilters(def.filters),\n    sorting: def.sorting,\n  };\n}\n\nexport function mapPTableDefV2<C1, C2>(def: PTableDefV2<C1>, cb: (c: C1) => C2): PTableDefV2<C2> {\n  return { query: mapSpecQueryColumns(def.query, cb) };\n}\n\nexport function mapJoinEntry<C1, C2>(entry: JoinEntry<C1>, cb: (c: C1) => C2): JoinEntry<C2> {\n  switch (entry.type) {\n    case \"column\":\n      return {\n        type: \"column\",\n        column: cb(entry.column),\n      };\n    case \"slicedColumn\":\n      return {\n        type: \"slicedColumn\",\n        column: cb(entry.column),\n        newId: entry.newId,\n        axisFilters: entry.axisFilters,\n      };\n    case \"artificialColumn\":\n      return {\n        type: \"artificialColumn\",\n        column: cb(entry.column),\n        newId: entry.newId,\n        axesIndices: entry.axesIndices,\n      };\n    case \"inlineColumn\":\n      return entry;\n    case \"inner\":\n    case \"full\":\n      return {\n        type: entry.type,\n        entries: entry.entries.map((col) => mapJoinEntry(col, cb)),\n      };\n    case \"outer\":\n      return {\n        type: \"outer\",\n        primary: mapJoinEntry(entry.primary, cb),\n        secondary: entry.secondary.map((col) => mapJoinEntry(col, cb)),\n      };\n    default:\n      assertNever(entry);\n  }\n}\n\nfunction cmpJoinEntries(lhs: JoinEntry<PObjectId>, rhs: JoinEntry<PObjectId>): number {\n  if (lhs.type !== rhs.type) {\n    return lhs.type < rhs.type ? -1 : 1;\n  }\n  const type = lhs.type;\n  switch (type) {\n    case \"column\":\n      return lhs.column < (rhs as typeof lhs).column ? -1 : 1;\n    case \"slicedColumn\":\n    case \"artificialColumn\":\n      return lhs.newId < (rhs as typeof lhs).newId ? -1 : 1;\n    case \"inlineColumn\": {\n      return lhs.column.id < (rhs as typeof lhs).column.id ? -1 : 1;\n    }\n    case \"inner\":\n    case \"full\": {\n      const rhsInner = rhs as typeof lhs;\n      if (lhs.entries.length !== rhsInner.entries.length) {\n        return lhs.entries.length - rhsInner.entries.length;\n      }\n      for (let i = 0; i < lhs.entries.length; i++) {\n        const cmp = cmpJoinEntries(lhs.entries[i], rhsInner.entries[i]);\n        if (cmp !== 0) {\n          return cmp;\n        }\n      }\n      return 0;\n    }\n    case \"outer\": {\n      const rhsOuter = rhs as typeof lhs;\n      const cmp = cmpJoinEntries(lhs.primary, rhsOuter.primary);\n      if (cmp !== 0) {\n        return cmp;\n      }\n      if (lhs.secondary.length !== rhsOuter.secondary.length) {\n        return lhs.secondary.length - rhsOuter.secondary.length;\n      }\n      for (let i = 0; i < lhs.secondary.length; i++) {\n        const cmp = cmpJoinEntries(lhs.secondary[i], rhsOuter.secondary[i]);\n        if (cmp !== 0) {\n          return cmp;\n        }\n      }\n      return 0;\n    }\n    default:\n      assertNever(type);\n  }\n}\n\nexport function sortJoinEntry(entry: JoinEntry<PObjectId>): JoinEntry<PObjectId> {\n  switch (entry.type) {\n    case \"column\":\n    case \"slicedColumn\":\n    case \"inlineColumn\":\n      return entry;\n    case \"artificialColumn\": {\n      const sortedAxesIndices = entry.axesIndices.toSorted((lhs, rhs) => lhs - rhs);\n      return {\n        ...entry,\n        axesIndices: sortedAxesIndices,\n      };\n    }\n    case \"inner\":\n    case \"full\": {\n      const sortedEntries = entry.entries.map(sortJoinEntry);\n      sortedEntries.sort(cmpJoinEntries);\n      return {\n        ...entry,\n        entries: sortedEntries,\n      };\n    }\n    case \"outer\": {\n      const sortedSecondary = entry.secondary.map(sortJoinEntry);\n      sortedSecondary.sort(cmpJoinEntries);\n      return {\n        ...entry,\n        primary: sortJoinEntry(entry.primary),\n        secondary: sortedSecondary,\n      };\n    }\n    default:\n      assertNever(entry);\n  }\n}\n"],"mappings":";;;;;;AA8YA,SAAgB,aAAqB,KAAoB,IAAkC;CACzF,OAAO;EAAE,GAAG;EAAK,KAAK,aAAa,IAAI,KAAK,EAAE;CAAE;AAClD;AAEA,SAAgB,cAAc,KAAiD;CAC7E,SAAS,YAAY,SAAqD;EACxE,OAAO,QAAQ,UAAU,KAAK,QAAQ;GACpC,IAAI,IAAI,OAAO,SAAS,UAAU,IAAI,OAAO,SAAS,QAGpD,OAFc,iBAAiB,UAAU,IAAI,OAAO,EAAE,CAE3C,IADG,iBAAiB,UAAU,IAAI,OAAO,EAAE,CACnC,IAAI,KAAK;QACvB,IAAI,IAAI,OAAO,SAAS,YAAY,IAAI,OAAO,SAAS,UAC7D,OAAO,IAAI,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK;QAE5C,OAAO,IAAI,OAAO,SAAS,SAAS,KAAK;EAE7C,CAAC;CACH;CACA,OAAO;EACL,KAAK,cAAc,IAAI,GAAG;EAC1B,kBAAkB,YAAY,IAAI,gBAAgB;EAClD,SAAS,YAAY,IAAI,OAAO;EAChC,SAAS,IAAI;CACf;AACF;AAEA,SAAgB,eAAuB,KAAsB,IAAoC;CAC/F,OAAO,EAAE,OAAO,oBAAoB,IAAI,OAAO,EAAE,EAAE;AACrD;AAEA,SAAgB,aAAqB,OAAsB,IAAkC;CAC3F,QAAQ,MAAM,MAAd;EACE,KAAK,UACH,OAAO;GACL,MAAM;GACN,QAAQ,GAAG,MAAM,MAAM;EACzB;EACF,KAAK,gBACH,OAAO;GACL,MAAM;GACN,QAAQ,GAAG,MAAM,MAAM;GACvB,OAAO,MAAM;GACb,aAAa,MAAM;EACrB;EACF,KAAK,oBACH,OAAO;GACL,MAAM;GACN,QAAQ,GAAG,MAAM,MAAM;GACvB,OAAO,MAAM;GACb,aAAa,MAAM;EACrB;EACF,KAAK,gBACH,OAAO;EACT,KAAK;EACL,KAAK,QACH,OAAO;GACL,MAAM,MAAM;GACZ,SAAS,MAAM,QAAQ,KAAK,QAAQ,aAAa,KAAK,EAAE,CAAC;EAC3D;EACF,KAAK,SACH,OAAO;GACL,MAAM;GACN,SAAS,aAAa,MAAM,SAAS,EAAE;GACvC,WAAW,MAAM,UAAU,KAAK,QAAQ,aAAa,KAAK,EAAE,CAAC;EAC/D;EACF,SACE,YAAY,KAAK;CACrB;AACF;AAEA,SAAS,eAAe,KAA2B,KAAmC;CACpF,IAAI,IAAI,SAAS,IAAI,MACnB,OAAO,IAAI,OAAO,IAAI,OAAO,KAAK;CAEpC,MAAM,OAAO,IAAI;CACjB,QAAQ,MAAR;EACE,KAAK,UACH,OAAO,IAAI,SAAU,IAAmB,SAAS,KAAK;EACxD,KAAK;EACL,KAAK,oBACH,OAAO,IAAI,QAAS,IAAmB,QAAQ,KAAK;EACtD,KAAK,gBACH,OAAO,IAAI,OAAO,KAAM,IAAmB,OAAO,KAAK,KAAK;EAE9D,KAAK;EACL,KAAK,QAAQ;GACX,MAAM,WAAW;GACjB,IAAI,IAAI,QAAQ,WAAW,SAAS,QAAQ,QAC1C,OAAO,IAAI,QAAQ,SAAS,SAAS,QAAQ;GAE/C,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,QAAQ,QAAQ,KAAK;IAC3C,MAAM,MAAM,eAAe,IAAI,QAAQ,IAAI,SAAS,QAAQ,EAAE;IAC9D,IAAI,QAAQ,GACV,OAAO;GAEX;GACA,OAAO;EACT;EACA,KAAK,SAAS;GACZ,MAAM,WAAW;GACjB,MAAM,MAAM,eAAe,IAAI,SAAS,SAAS,OAAO;GACxD,IAAI,QAAQ,GACV,OAAO;GAET,IAAI,IAAI,UAAU,WAAW,SAAS,UAAU,QAC9C,OAAO,IAAI,UAAU,SAAS,SAAS,UAAU;GAEnD,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,UAAU,QAAQ,KAAK;IAC7C,MAAM,MAAM,eAAe,IAAI,UAAU,IAAI,SAAS,UAAU,EAAE;IAClE,IAAI,QAAQ,GACV,OAAO;GAEX;GACA,OAAO;EACT;EACA,SACE,YAAY,IAAI;CACpB;AACF;AAEA,SAAgB,cAAc,OAAmD;CAC/E,QAAQ,MAAM,MAAd;EACE,KAAK;EACL,KAAK;EACL,KAAK,gBACH,OAAO;EACT,KAAK,oBAAoB;GACvB,MAAM,oBAAoB,MAAM,YAAY,UAAU,KAAK,QAAQ,MAAM,GAAG;GAC5E,OAAO;IACL,GAAG;IACH,aAAa;GACf;EACF;EACA,KAAK;EACL,KAAK,QAAQ;GACX,MAAM,gBAAgB,MAAM,QAAQ,IAAI,aAAa;GACrD,cAAc,KAAK,cAAc;GACjC,OAAO;IACL,GAAG;IACH,SAAS;GACX;EACF;EACA,KAAK,SAAS;GACZ,MAAM,kBAAkB,MAAM,UAAU,IAAI,aAAa;GACzD,gBAAgB,KAAK,cAAc;GACnC,OAAO;IACL,GAAG;IACH,SAAS,cAAc,MAAM,OAAO;IACpC,WAAW;GACb;EACF;EACA,SACE,YAAY,KAAK;CACrB;AACF"}
+{"version":3,"file":"table_calculate.js","names":[],"sources":["../../../src/drivers/pframe/table_calculate.ts"],"sourcesContent":["import type { PTableColumnId, PTableColumnSpec } from \"./table_common\";\nimport type { PTableVector } from \"./data_types\";\nimport type { PObjectId } from \"../../pool\";\nimport { assertNever } from \"../../util\";\nimport { getAxisId, type PColumn } from \"./spec/spec\";\nimport type { PColumnValues } from \"./data_info\";\nimport type { SpecQuery, SpecQueryJoinEntry } from \"./query/query_spec\";\nimport { canonicalizeJson } from \"../../json\";\nimport { mapSpecQueryColumns } from \"./query\";\n\n/** Defines a terminal column node in the join request tree */\nexport interface ColumnJoinEntry<Col> {\n  /** Node type discriminator */\n  readonly type: \"column\";\n\n  /** Local column */\n  readonly column: Col;\n}\n\n/**\n * Axis filter slicing target axis from column axes.\n * If the axis has parents or is a parent, slicing cannot be applied (an error will be thrown).\n * */\nexport interface ConstantAxisFilter {\n  /** Filter type discriminator */\n  readonly type: \"constant\";\n\n  /** Index of axis to slice (zero-based) */\n  readonly axisIndex: number;\n\n  /** Equality filter reference value, see {@link SingleValueEqualPredicate} */\n  readonly constant: string | number;\n}\n\n/** Defines a terminal column node in the join request tree */\nexport interface SlicedColumnJoinEntry<Col> {\n  /** Node type discriminator */\n  readonly type: \"slicedColumn\";\n\n  /** Local column */\n  readonly column: Col;\n\n  /** New column id */\n  readonly newId: PObjectId;\n\n  /** Non-empty list of axis filters */\n  readonly axisFilters: ConstantAxisFilter[];\n}\n\nexport interface ArtificialColumnJoinEntry<Col> {\n  /** Node type discriminator */\n  readonly type: \"artificialColumn\";\n\n  /** Column definition */\n  readonly column: Col;\n\n  /** New column id */\n  readonly newId: PObjectId;\n\n  /** Indices of axes to pick from the column (zero-based) */\n  readonly axesIndices: number[];\n}\n\n/** Defines a terminal column node in the join request tree */\nexport interface InlineColumnJoinEntry {\n  /** Node type discriminator */\n  readonly type: \"inlineColumn\";\n\n  /** Column definition */\n  readonly column: PColumn<PColumnValues>;\n}\n\n/**\n * Defines a join request tree node that will output only records present in\n * all child nodes ({@link entries}).\n * */\nexport interface InnerJoin<Col> {\n  /** Node type discriminator */\n  readonly type: \"inner\";\n\n  /** Child nodes to be inner joined */\n  readonly entries: JoinEntry<Col>[];\n}\n\n/**\n * Defines a join request tree node that will output all records present at\n * least in one of the child nodes ({@link entries}), values for those PColumns\n * that lack corresponding combinations of axis values will be null.\n * */\nexport interface FullJoin<Col> {\n  /** Node type discriminator */\n  readonly type: \"full\";\n\n  /** Child nodes to be fully outer joined */\n  readonly entries: JoinEntry<Col>[];\n}\n\n/**\n * Defines a join request tree node that will output all records present in\n * {@link primary} child node, and records from the {@link secondary} nodes will\n * be added to the output only if present, values for those PColumns from the\n * {@link secondary} list, that lack corresponding combinations of axis values\n * will be null.\n *\n * This node can be thought as a chain of SQL LEFT JOIN operations starting from\n * the {@link primary} node and adding {@link secondary} nodes one by one.\n * */\nexport interface OuterJoin<Col> {\n  /** Node type discriminator */\n  readonly type: \"outer\";\n\n  /** Primes the join operation. Left part of LEFT JOIN. */\n  readonly primary: JoinEntry<Col>;\n\n  /** Driven nodes, giving their values only if primary node have corresponding\n   * nodes. Right parts of LEFT JOIN chain. */\n  readonly secondary: JoinEntry<Col>[];\n}\n\n/**\n * Base type of all join request tree nodes. Join request tree allows to combine\n * information from multiple PColumns into a PTable. Correlation between records\n * is performed by looking for records with the same values in common axis between\n * the PColumns. Common axis are those axis which have equal {@link AxisId} derived\n * from the columns axes spec.\n * */\nexport type JoinEntry<Col> =\n  | ColumnJoinEntry<Col>\n  | SlicedColumnJoinEntry<Col>\n  | ArtificialColumnJoinEntry<Col>\n  | InlineColumnJoinEntry\n  | InnerJoin<Col>\n  | FullJoin<Col>\n  | OuterJoin<Col>;\n\n/** Container representing whole data stored in specific PTable column. */\nexport interface FullPTableColumnData {\n  /** Unified spec */\n  readonly spec: PTableColumnSpec;\n\n  /** Data */\n  readonly data: PTableVector;\n}\n\nexport interface SingleValueIsNAPredicate {\n  /** Comparison operator */\n  readonly operator: \"IsNA\";\n}\n\nexport interface SingleValueEqualPredicate {\n  /** Comparison operator */\n  readonly operator: \"Equal\";\n\n  /** Reference value, NA values will not match */\n  readonly reference: string | number;\n}\n\nexport interface SingleValueInSetPredicate {\n  /** Comparison operator */\n  readonly operator: \"InSet\";\n\n  /** Reference values, NA values will not match */\n  readonly references: (string | number)[];\n}\n\nexport interface SingleValueIEqualPredicate {\n  /** Comparison operator (case insensitive) */\n  readonly operator: \"IEqual\";\n\n  /** Reference value, NA values will not match */\n  readonly reference: string;\n}\n\nexport interface SingleValueLessPredicate {\n  /** Comparison operator */\n  readonly operator: \"Less\";\n\n  /** Reference value, NA values will not match */\n  readonly reference: string | number;\n}\n\nexport interface SingleValueLessOrEqualPredicate {\n  /** Comparison operator */\n  readonly operator: \"LessOrEqual\";\n\n  /** Reference value, NA values will not match */\n  readonly reference: string | number;\n}\n\nexport interface SingleValueGreaterPredicate {\n  /** Comparison operator */\n  readonly operator: \"Greater\";\n\n  /** Reference value, NA values will not match */\n  readonly reference: string | number;\n}\n\nexport interface SingleValueGreaterOrEqualPredicate {\n  /** Comparison operator */\n  readonly operator: \"GreaterOrEqual\";\n\n  /** Reference value, NA values will not match */\n  readonly reference: string | number;\n}\n\nexport interface SingleValueStringContainsPredicate {\n  /** Comparison operator */\n  readonly operator: \"StringContains\";\n\n  /** Reference substring, NA values are skipped */\n  readonly substring: string;\n}\n\nexport interface SingleValueStringIContainsPredicate {\n  /** Comparison operator (case insensitive) */\n  readonly operator: \"StringIContains\";\n\n  /** Reference substring, NA values are skipped */\n  readonly substring: string;\n}\n\nexport interface SingleValueMatchesPredicate {\n  /** Comparison operator */\n  readonly operator: \"Matches\";\n\n  /** Regular expression, NA values are skipped */\n  readonly regex: string;\n}\n\nexport interface SingleValueStringContainsFuzzyPredicate {\n  /** Comparison operator */\n  readonly operator: \"StringContainsFuzzy\";\n\n  /** Reference value, NA values are skipped */\n  readonly reference: string;\n\n  /**\n   * Integer specifying the upper bound of edit distance between\n   * reference and actual value.\n   * When {@link substitutionsOnly} is not defined or set to false\n   * Levenshtein distance is used (substitutions and indels)\n   * @see https://en.wikipedia.org/wiki/Levenshtein_distance\n   * When {@link substitutionsOnly} is set to true\n   * Hamming distance is used (substitutions only)\n   * @see https://en.wikipedia.org/wiki/Hamming_distance\n   */\n  readonly maxEdits: number;\n\n  /** Changes the type of edit distance in {@link maxEdits} */\n  readonly substitutionsOnly?: boolean;\n\n  /**\n   * Some character in {@link reference} that will match any\n   * single character in searched text.\n   */\n  readonly wildcard?: string;\n}\n\nexport interface SingleValueStringIContainsFuzzyPredicate {\n  /** Comparison operator (case insensitive) */\n  readonly operator: \"StringIContainsFuzzy\";\n\n  /** Reference value, NA values are skipped */\n  readonly reference: string;\n\n  /**\n   * Integer specifying the upper bound of edit distance between\n   * reference and actual value.\n   * When {@link substitutionsOnly} is not defined or set to false\n   * Levenshtein distance is used (substitutions and indels)\n   * @see https://en.wikipedia.org/wiki/Levenshtein_distance\n   * When {@link substitutionsOnly} is set to true\n   * Hamming distance is used (substitutions only)\n   * @see https://en.wikipedia.org/wiki/Hamming_distance\n   */\n  readonly maxEdits: number;\n\n  /** Changes the type of edit distance in {@link maxEdits} */\n  readonly substitutionsOnly?: boolean;\n\n  /**\n   * Some character in {@link reference} that will match any\n   * single character in searched text.\n   */\n  readonly wildcard?: string;\n}\n\nexport interface SingleValueNotPredicateV2 {\n  /** Comparison operator */\n  readonly operator: \"Not\";\n\n  /** Operand to negate */\n  readonly operand: SingleValuePredicateV2;\n}\n\nexport interface SingleValueAndPredicateV2 {\n  /** Comparison operator */\n  readonly operator: \"And\";\n\n  /** Operands to combine */\n  readonly operands: SingleValuePredicateV2[];\n}\n\nexport interface SingleValueOrPredicateV2 {\n  /** Comparison operator */\n  readonly operator: \"Or\";\n\n  /** Operands to combine */\n  readonly operands: SingleValuePredicateV2[];\n}\n\n/** Filtering predicate for a single axis or column value */\nexport type SingleValuePredicateV2 =\n  | SingleValueIsNAPredicate\n  | SingleValueEqualPredicate\n  | SingleValueInSetPredicate\n  | SingleValueLessPredicate\n  | SingleValueLessOrEqualPredicate\n  | SingleValueGreaterPredicate\n  | SingleValueGreaterOrEqualPredicate\n  | SingleValueStringContainsPredicate\n  | SingleValueMatchesPredicate\n  | SingleValueStringContainsFuzzyPredicate\n  | SingleValueNotPredicateV2\n  | SingleValueAndPredicateV2\n  | SingleValueOrPredicateV2\n  | SingleValueIEqualPredicate\n  | SingleValueStringIContainsPredicate\n  | SingleValueStringIContainsFuzzyPredicate;\n\n/**\n * Filter PTable records based on specific axis or column value. If this is an\n * axis value filter and the axis is part of a partitioning key in some of the\n * source PColumns, the filter will be pushed down to those columns, so only\n * specific partitions will be retrieved from the remote storage.\n * */\nexport interface PTableRecordSingleValueFilterV2 {\n  /** Filter type discriminator */\n  readonly type: \"bySingleColumnV2\";\n\n  /** Target axis selector to examine values from */\n  readonly column: PTableColumnId;\n\n  /** Value predicate */\n  readonly predicate: SingleValuePredicateV2;\n}\n\n/** Generic PTable records filter */\nexport type PTableRecordFilter = PTableRecordSingleValueFilterV2;\n\n/** Sorting parameters for a PTable.  */\nexport type PTableSorting = {\n  /** Unified column identifier */\n  readonly column: PTableColumnId;\n\n  /** Sorting order */\n  readonly ascending: boolean;\n\n  /** Sorting in respect to NA and absent values */\n  readonly naAndAbsentAreLeastValues: boolean;\n};\n\n/** Information required to instantiate a PTable. */\nexport interface PTableDef<Col> {\n  /** Join tree to populate the PTable */\n  readonly src: JoinEntry<Col>;\n\n  /** Partition filters */\n  readonly partitionFilters: PTableRecordFilter[];\n\n  /** Record filters */\n  readonly filters: PTableRecordFilter[];\n\n  /** Table sorting */\n  readonly sorting: PTableSorting[];\n}\n\n/** Information required to instantiate a PTable (V2, query-based). */\nexport interface PTableDefV2<Col> {\n  /** Pre-built query spec describing joins, filters and sorting */\n  readonly query: SpecQuery<Col>;\n}\n\n/** Request to create and retrieve entirety of data of PTable. */\nexport type CalculateTableDataRequest<Col> = {\n  /** Join tree to populate the PTable */\n  readonly src: JoinEntry<Col>;\n\n  /** Record filters */\n  readonly filters: PTableRecordFilter[];\n\n  /** Table sorting */\n  readonly sorting: PTableSorting[];\n};\n\n/** Response for {@link CalculateTableDataRequest} */\nexport type CalculateTableDataResponse = FullPTableColumnData[];\n\nexport function mapPTableDef<C1, C2>(def: PTableDef<C1>, cb: (c: C1) => C2): PTableDef<C2> {\n  return { ...def, src: mapJoinEntry(def.src, cb) };\n}\n\nexport function sortPTableDef(def: PTableDef<PObjectId>): PTableDef<PObjectId> {\n  function sortFilters(filters: PTableRecordFilter[]): PTableRecordFilter[] {\n    return filters.toSorted((lhs, rhs) => {\n      if (lhs.column.type === \"axis\" && rhs.column.type === \"axis\") {\n        const lhsId = canonicalizeJson(getAxisId(lhs.column.id));\n        const rhsId = canonicalizeJson(getAxisId(rhs.column.id));\n        return lhsId < rhsId ? -1 : 1;\n      } else if (lhs.column.type === \"column\" && rhs.column.type === \"column\") {\n        return lhs.column.id < rhs.column.id ? -1 : 1;\n      } else {\n        return lhs.column.type === \"axis\" ? -1 : 1;\n      }\n    });\n  }\n  return {\n    src: sortJoinEntry(def.src),\n    partitionFilters: sortFilters(def.partitionFilters),\n    filters: sortFilters(def.filters),\n    sorting: def.sorting,\n  };\n}\n\nexport function mapPTableDefV2<C1, C2>(\n  def: PTableDefV2<C1>,\n  visitor: {\n    /** Transform column references in leaf nodes (column, sparseToDenseColumn). */\n    column: (c: C1) => C2;\n    /** Visit a node after its children have been traversed. */\n    node?: (node: SpecQuery<C2>) => SpecQuery<C2>;\n    /** Visit a join entry after its inner query has been traversed. */\n    joinEntry?: (entry: SpecQueryJoinEntry<C2>) => SpecQueryJoinEntry<C2>;\n  },\n): PTableDefV2<C2> {\n  return { query: mapSpecQueryColumns(def.query, visitor) };\n}\n\nexport function mapJoinEntry<C1, C2>(entry: JoinEntry<C1>, cb: (c: C1) => C2): JoinEntry<C2> {\n  switch (entry.type) {\n    case \"column\":\n      return {\n        type: \"column\",\n        column: cb(entry.column),\n      };\n    case \"slicedColumn\":\n      return {\n        type: \"slicedColumn\",\n        column: cb(entry.column),\n        newId: entry.newId,\n        axisFilters: entry.axisFilters,\n      };\n    case \"artificialColumn\":\n      return {\n        type: \"artificialColumn\",\n        column: cb(entry.column),\n        newId: entry.newId,\n        axesIndices: entry.axesIndices,\n      };\n    case \"inlineColumn\":\n      return entry;\n    case \"inner\":\n    case \"full\":\n      return {\n        type: entry.type,\n        entries: entry.entries.map((col) => mapJoinEntry(col, cb)),\n      };\n    case \"outer\":\n      return {\n        type: \"outer\",\n        primary: mapJoinEntry(entry.primary, cb),\n        secondary: entry.secondary.map((col) => mapJoinEntry(col, cb)),\n      };\n    default:\n      assertNever(entry);\n  }\n}\n\nfunction cmpJoinEntries(lhs: JoinEntry<PObjectId>, rhs: JoinEntry<PObjectId>): number {\n  if (lhs.type !== rhs.type) {\n    return lhs.type < rhs.type ? -1 : 1;\n  }\n  const type = lhs.type;\n  switch (type) {\n    case \"column\":\n      return lhs.column < (rhs as typeof lhs).column ? -1 : 1;\n    case \"slicedColumn\":\n    case \"artificialColumn\":\n      return lhs.newId < (rhs as typeof lhs).newId ? -1 : 1;\n    case \"inlineColumn\": {\n      return lhs.column.id < (rhs as typeof lhs).column.id ? -1 : 1;\n    }\n    case \"inner\":\n    case \"full\": {\n      const rhsInner = rhs as typeof lhs;\n      if (lhs.entries.length !== rhsInner.entries.length) {\n        return lhs.entries.length - rhsInner.entries.length;\n      }\n      for (let i = 0; i < lhs.entries.length; i++) {\n        const cmp = cmpJoinEntries(lhs.entries[i], rhsInner.entries[i]);\n        if (cmp !== 0) {\n          return cmp;\n        }\n      }\n      return 0;\n    }\n    case \"outer\": {\n      const rhsOuter = rhs as typeof lhs;\n      const cmp = cmpJoinEntries(lhs.primary, rhsOuter.primary);\n      if (cmp !== 0) {\n        return cmp;\n      }\n      if (lhs.secondary.length !== rhsOuter.secondary.length) {\n        return lhs.secondary.length - rhsOuter.secondary.length;\n      }\n      for (let i = 0; i < lhs.secondary.length; i++) {\n        const cmp = cmpJoinEntries(lhs.secondary[i], rhsOuter.secondary[i]);\n        if (cmp !== 0) {\n          return cmp;\n        }\n      }\n      return 0;\n    }\n    default:\n      assertNever(type);\n  }\n}\n\nexport function sortJoinEntry(entry: JoinEntry<PObjectId>): JoinEntry<PObjectId> {\n  switch (entry.type) {\n    case \"column\":\n    case \"slicedColumn\":\n    case \"inlineColumn\":\n      return entry;\n    case \"artificialColumn\": {\n      const sortedAxesIndices = entry.axesIndices.toSorted((lhs, rhs) => lhs - rhs);\n      return {\n        ...entry,\n        axesIndices: sortedAxesIndices,\n      };\n    }\n    case \"inner\":\n    case \"full\": {\n      const sortedEntries = entry.entries.map(sortJoinEntry);\n      sortedEntries.sort(cmpJoinEntries);\n      return {\n        ...entry,\n        entries: sortedEntries,\n      };\n    }\n    case \"outer\": {\n      const sortedSecondary = entry.secondary.map(sortJoinEntry);\n      sortedSecondary.sort(cmpJoinEntries);\n      return {\n        ...entry,\n        primary: sortJoinEntry(entry.primary),\n        secondary: sortedSecondary,\n      };\n    }\n    default:\n      assertNever(entry);\n  }\n}\n"],"mappings":"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"}

package/dist/drivers/pframe/table_common.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"table_common.cjs","names":[],"sources":["../../../src/drivers/pframe/table_common.ts"],"sourcesContent":["import type { PObjectId } from \"../../pool\";\nimport type { AxisId, AxisSpec, PColumnSpec } from \"./spec/spec\";\n\nexport type PTableColumnSpecAxis = {\n  type: \"axis\";\n  id: AxisId;\n  spec: AxisSpec;\n};\n\nexport type PTableColumnSpecColumn = {\n  type: \"column\";\n  id: PObjectId;\n  spec: PColumnSpec;\n};\n\n/** Unified spec object for axes and columns */\nexport type PTableColumnSpec = PTableColumnSpecAxis | PTableColumnSpecColumn;\n\nexport type PTableColumnIdAxis = {\n  type: \"axis\";\n  id: AxisId;\n};\n\nexport type PTableColumnIdColumn = {\n  type: \"column\";\n  id: PObjectId;\n};\n\n/** Unified PTable column identifier */\nexport type PTableColumnId = PTableColumnIdAxis | PTableColumnIdColumn;\n\nexport function getPTableColumnId(spec: PTableColumnSpec): PTableColumnId {\n  switch (spec.type) {\n    case \"axis\":\n      return {\n        type: \"axis\",\n        id: spec.id,\n      };\n    case \"column\":\n      return {\n        type: \"column\",\n        id: spec.id,\n      };\n  }\n}\n"],"mappings":";AA+BA,SAAgB,kBAAkB,MAAwC;CACxE,QAAQ,KAAK,MAAb;EACE,KAAK,QACH,OAAO;GACL,MAAM;GACN,IAAI,KAAK;EACX;EACF,KAAK,UACH,OAAO;GACL,MAAM;GACN,IAAI,KAAK;EACX;CACJ;AACF"}
+{"version":3,"file":"table_common.cjs","names":[],"sources":["../../../src/drivers/pframe/table_common.ts"],"sourcesContent":["import type { AxisId, AxisSpec, PColumnSpec } from \"./spec/spec\";\nimport type { ColumnUniversalId } from \"./spec/ids\";\n\nexport type PTableColumnSpecAxis = {\n  type: \"axis\";\n  id: AxisId;\n  spec: AxisSpec;\n};\n\nexport type PTableColumnSpecColumn = {\n  type: \"column\";\n  /**\n   * Leaf column id as it appears in the SpecQuery — may be a rich\n   * {@link ColumnUniversalId} (Discovered / Overridden / Filtered) or a bare\n   * {@link PObjectId}. The host resolver strips to bare via `extractPObjectId`\n   * before physical lookup.\n   */\n  id: ColumnUniversalId;\n  spec: PColumnSpec;\n};\n\n/** Unified spec object for axes and columns */\nexport type PTableColumnSpec = PTableColumnSpecAxis | PTableColumnSpecColumn;\n\nexport type PTableColumnIdAxis = {\n  type: \"axis\";\n  id: AxisId;\n};\n\nexport type PTableColumnIdColumn = {\n  type: \"column\";\n  /** @see PTableColumnSpecColumn.id */\n  id: ColumnUniversalId;\n};\n\n/** Unified PTable column identifier */\nexport type PTableColumnId = PTableColumnIdAxis | PTableColumnIdColumn;\n\nexport function getPTableColumnId(spec: PTableColumnSpec): PTableColumnId {\n  switch (spec.type) {\n    case \"axis\":\n      return {\n        type: \"axis\",\n        id: spec.id,\n      };\n    case \"column\":\n      return {\n        type: \"column\",\n        id: spec.id,\n      };\n  }\n}\n"],"mappings":";AAsCA,SAAgB,kBAAkB,MAAwC;CACxE,QAAQ,KAAK,MAAb;EACE,KAAK,QACH,OAAO;GACL,MAAM;GACN,IAAI,KAAK;EACX;EACF,KAAK,UACH,OAAO;GACL,MAAM;GACN,IAAI,KAAK;EACX;CACJ;AACF"}

package/dist/drivers/pframe/table_common.d.ts

@@ -1,5 +1,6 @@
 import { AxisId, AxisSpec, PColumnSpec } from "./spec/spec.js";
-import { PObjectId } from "../../pool/spec.js";
+import { ColumnUniversalId } from "./spec/ids.js";
+
 //#region src/drivers/pframe/table_common.d.ts
 type PTableColumnSpecAxis = {
   type: "axis";
@@ -8,7 +9,13 @@ type PTableColumnSpecAxis = {
 };
 type PTableColumnSpecColumn = {
   type: "column";
-  id: PObjectId;
+  /**
+   * Leaf column id as it appears in the SpecQuery — may be a rich
+   * {@link ColumnUniversalId} (Discovered / Overridden / Filtered) or a bare
+   * {@link PObjectId}. The host resolver strips to bare via `extractPObjectId`
+   * before physical lookup.
+   */
+  id: ColumnUniversalId;
   spec: PColumnSpec;
 };
 /** Unified spec object for axes and columns */
@@ -18,8 +25,8 @@ type PTableColumnIdAxis = {
   id: AxisId;
 };
 type PTableColumnIdColumn = {
-  type: "column";
-  id: PObjectId;
+  type: "column"; /** @see PTableColumnSpecColumn.id */
+  id: ColumnUniversalId;
 };
 /** Unified PTable column identifier */
 type PTableColumnId = PTableColumnIdAxis | PTableColumnIdColumn;

package/dist/drivers/pframe/table_common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table_common.d.ts","names":[],"sources":["../../../src/drivers/pframe/table_common.ts"],"mappings":";;;KAGY,oBAAA;EACV,IAAA;EACA,EAAA,EAAI,MAAA;EACJ,IAAA,EAAM,QAAQ;AAAA;AAAA,KAGJ,sBAAA;EACV,IAAA;EACA,EAAA,EAAI,SAAA;EACJ,IAAA,EAAM,WAAW;AAAA;;KAIP,gBAAA,GAAmB,oBAAA,GAAuB,sBAAsB;AAAA,KAEhE,kBAAA;EACV,IAAA;EACA,EAAA,EAAI,MAAM;AAAA;AAAA,KAGA,oBAAA;EACV,IAAA;EACA,EAAA,EAAI,SAAS;AAAA;;KAIH,cAAA,GAAiB,kBAAA,GAAqB,oBAAoB;AAAA,iBAEtD,iBAAA,CAAkB,IAAA,EAAM,gBAAA,GAAmB,cAAc"}
+{"version":3,"file":"table_common.d.ts","names":[],"sources":["../../../src/drivers/pframe/table_common.ts"],"mappings":";;;;KAGY,oBAAA;EACV,IAAA;EACA,EAAA,EAAI,MAAA;EACJ,IAAA,EAAM,QAAQ;AAAA;AAAA,KAGJ,sBAAA;EACV,IAAA;EALA;;;;;AACc;EAWd,EAAA,EAAI,iBAAA;EACJ,IAAA,EAAM,WAAW;AAAA;;KAIP,gBAAA,GAAmB,oBAAA,GAAuB,sBAAsB;AAAA,KAEhE,kBAAA;EACV,IAAA;EACA,EAAA,EAAI,MAAM;AAAA;AAAA,KAGA,oBAAA;EACV,IAAA,YARU;EAUV,EAAA,EAAI,iBAAiB;AAAA;;KAIX,cAAA,GAAiB,kBAAA,GAAqB,oBAAoB;AAAA,iBAEtD,iBAAA,CAAkB,IAAA,EAAM,gBAAA,GAAmB,cAAc"}

package/dist/drivers/pframe/table_common.js.map

@@ -1 +1 @@
-{"version":3,"file":"table_common.js","names":[],"sources":["../../../src/drivers/pframe/table_common.ts"],"sourcesContent":["import type { PObjectId } from \"../../pool\";\nimport type { AxisId, AxisSpec, PColumnSpec } from \"./spec/spec\";\n\nexport type PTableColumnSpecAxis = {\n  type: \"axis\";\n  id: AxisId;\n  spec: AxisSpec;\n};\n\nexport type PTableColumnSpecColumn = {\n  type: \"column\";\n  id: PObjectId;\n  spec: PColumnSpec;\n};\n\n/** Unified spec object for axes and columns */\nexport type PTableColumnSpec = PTableColumnSpecAxis | PTableColumnSpecColumn;\n\nexport type PTableColumnIdAxis = {\n  type: \"axis\";\n  id: AxisId;\n};\n\nexport type PTableColumnIdColumn = {\n  type: \"column\";\n  id: PObjectId;\n};\n\n/** Unified PTable column identifier */\nexport type PTableColumnId = PTableColumnIdAxis | PTableColumnIdColumn;\n\nexport function getPTableColumnId(spec: PTableColumnSpec): PTableColumnId {\n  switch (spec.type) {\n    case \"axis\":\n      return {\n        type: \"axis\",\n        id: spec.id,\n      };\n    case \"column\":\n      return {\n        type: \"column\",\n        id: spec.id,\n      };\n  }\n}\n"],"mappings":";AA+BA,SAAgB,kBAAkB,MAAwC;CACxE,QAAQ,KAAK,MAAb;EACE,KAAK,QACH,OAAO;GACL,MAAM;GACN,IAAI,KAAK;EACX;EACF,KAAK,UACH,OAAO;GACL,MAAM;GACN,IAAI,KAAK;EACX;CACJ;AACF"}
+{"version":3,"file":"table_common.js","names":[],"sources":["../../../src/drivers/pframe/table_common.ts"],"sourcesContent":["import type { AxisId, AxisSpec, PColumnSpec } from \"./spec/spec\";\nimport type { ColumnUniversalId } from \"./spec/ids\";\n\nexport type PTableColumnSpecAxis = {\n  type: \"axis\";\n  id: AxisId;\n  spec: AxisSpec;\n};\n\nexport type PTableColumnSpecColumn = {\n  type: \"column\";\n  /**\n   * Leaf column id as it appears in the SpecQuery — may be a rich\n   * {@link ColumnUniversalId} (Discovered / Overridden / Filtered) or a bare\n   * {@link PObjectId}. The host resolver strips to bare via `extractPObjectId`\n   * before physical lookup.\n   */\n  id: ColumnUniversalId;\n  spec: PColumnSpec;\n};\n\n/** Unified spec object for axes and columns */\nexport type PTableColumnSpec = PTableColumnSpecAxis | PTableColumnSpecColumn;\n\nexport type PTableColumnIdAxis = {\n  type: \"axis\";\n  id: AxisId;\n};\n\nexport type PTableColumnIdColumn = {\n  type: \"column\";\n  /** @see PTableColumnSpecColumn.id */\n  id: ColumnUniversalId;\n};\n\n/** Unified PTable column identifier */\nexport type PTableColumnId = PTableColumnIdAxis | PTableColumnIdColumn;\n\nexport function getPTableColumnId(spec: PTableColumnSpec): PTableColumnId {\n  switch (spec.type) {\n    case \"axis\":\n      return {\n        type: \"axis\",\n        id: spec.id,\n      };\n    case \"column\":\n      return {\n        type: \"column\",\n        id: spec.id,\n      };\n  }\n}\n"],"mappings":";AAsCA,SAAgB,kBAAkB,MAAwC;CACxE,QAAQ,KAAK,MAAb;EACE,KAAK,QACH,OAAO;GACL,MAAM;GACN,IAAI,KAAK;EACX;EACF,KAAK,UACH,OAAO;GACL,MAAM;GACN,IAAI,KAAK;EACX;CACJ;AACF"}

package/dist/index.cjs

@@ -16,15 +16,18 @@ const require_data_types = require("./drivers/pframe/data_types.cjs");
 const require_utils = require("./drivers/pframe/query/utils.cjs");
 const require_table_calculate = require("./drivers/pframe/table_calculate.cjs");
 const require_table_common = require("./drivers/pframe/table_common.cjs");
-const require_ids = require("./drivers/pframe/spec/ids.cjs");
-const require_anchored = require("./drivers/pframe/spec/anchored.cjs");
 const require_filtered_column = require("./drivers/pframe/spec/filtered_column.cjs");
 const require_spec$1 = require("./pool/spec.cjs");
 const require_query = require("./pool/query.cjs");
+require("./pool/index.cjs");
+const require_discovered_column = require("./drivers/pframe/spec/discovered_column.cjs");
+const require_overridden = require("./drivers/pframe/spec/overridden.cjs");
+const require_ids = require("./drivers/pframe/spec/ids.cjs");
+const require_anchored = require("./drivers/pframe/spec/anchored.cjs");
 const require_selectors = require("./drivers/pframe/spec/selectors.cjs");
 const require_native_id = require("./drivers/pframe/spec/native_id.cjs");
-const require_discovered_column = require("./drivers/pframe/spec/discovered_column.cjs");
 const require_linker_columns = require("./drivers/pframe/linker_columns.cjs");
+const require_discover_columns_options = require("./drivers/columns/discover_columns_options.cjs");
 const require_ChunkedStreamReader = require("./drivers/ChunkedStreamReader.cjs");
 require("./drivers/index.cjs");
 const require_block_flags = require("./flags/block_flags.cjs");
@@ -44,14 +47,24 @@ const require_node_service_handlers = require("./services/node_service_handlers.
 const require_service_injectors = require("./services/service_injectors.cjs");
 require("./services/index.cjs");
 const require_pool_entry = require("./pool_entry.cjs");
+const require_accessor_traversal = require("./columns/accessor_traversal.cjs");
+const require_column_registry = require("./columns/column_registry.cjs");
+const require_column_selector = require("./columns/column_selector.cjs");
+const require_dedup = require("./columns/dedup.cjs");
+const require_providers = require("./columns/providers.cjs");
+require("./columns/index.cjs");
 exports.AbortError = require_errors.AbortError;
+exports.AccessorEntriesProvider = require_providers.AccessorEntriesProvider;
 exports.AllRequiresFeatureFlags = require_block_flags.AllRequiresFeatureFlags;
 exports.AllSupportsFeatureFlags = require_block_flags.AllSupportsFeatureFlags;
 exports.AnchoredIdDeriver = require_anchored.AnchoredIdDeriver;
 exports.Annotation = require_spec.Annotation;
 exports.AnnotationJson = require_spec.AnnotationJson;
+exports.COLLECT_TYPES = require_accessor_traversal.COLLECT_TYPES;
 exports.ChunkedStreamReader = require_ChunkedStreamReader.ChunkedStreamReader;
 exports.Code = require_code.Code;
+exports.ColumnRegistry = require_column_registry.ColumnRegistry;
+exports.DESCEND_TYPES = require_accessor_traversal.DESCEND_TYPES;
 exports.DefaultNavigationState = require_navigation.DefaultNavigationState;
 exports.Domain = require_spec.Domain;
 exports.DomainJson = require_spec.DomainJson;
@@ -74,6 +87,7 @@ exports.REQUIRES_PFRAMES_VERSION = require_block_flags.REQUIRES_PFRAMES_VERSION;
 exports.RangeBytes = require_blob.RangeBytes;
 exports.ResourceTypeName = require_resource_types.ResourceTypeName;
 exports.ResourceTypePrefix = require_resource_types.ResourceTypePrefix;
+exports.ResultPoolEntriesProvider = require_providers.ResultPoolEntriesProvider;
 exports.RuntimeCapabilities = require_flag_utils.RuntimeCapabilities;
 exports.SERVICE_CAPABILITY_FLAGS = require_service_capabilities.SERVICE_CAPABILITY_FLAGS;
 exports.SERVICE_FEATURE_FLAGS = require_service_capabilities.SERVICE_FEATURE_FLAGS;
@@ -89,6 +103,8 @@ exports.UiError = require_errors.UiError;
 exports.UiServiceRegistry = require_service_registry.UiServiceRegistry;
 exports.ValueType = require_spec.ValueType;
 exports.XLSX_MAX_ROWS_PER_SHEET = require_data_types.XLSX_MAX_ROWS_PER_SHEET;
+exports.applyAxisFilters = require_filtered_column.applyAxisFilters;
+exports.applySpecOverrides = require_overridden.applySpecOverrides;
 exports.assertNever = require_util.assertNever;
 exports.base64Decode = require_base64.base64Decode;
 exports.base64Encode = require_base64.base64Encode;
@@ -99,17 +115,31 @@ exports.canonicalizeAxisWithParents = require_spec.canonicalizeAxisWithParents;
 exports.canonicalizeJson = require_json.canonicalizeJson;
 exports.checkBlockFlag = require_flag_utils.checkBlockFlag;
 exports.collectSpecQueryColumns = require_utils.collectSpecQueryColumns;
-exports.createDiscoveredPColumnId = require_discovered_column.createDiscoveredPColumnId;
+exports.convertColumnSelectorToMultiColumnSelector = require_column_selector.convertColumnSelectorToMultiColumnSelector;
+exports.convertRelaxedAxisSelectorToMultiAxisSelector = require_column_selector.convertRelaxedAxisSelectorToMultiAxisSelector;
+exports.convertRelaxedColumnSelectorToMultiColumnSelector = require_column_selector.convertRelaxedColumnSelectorToMultiColumnSelector;
+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.createEnrichmentRef = require_ref.createEnrichmentRef;
+exports.createGlobalPObjectId = require_spec$1.createGlobalPObjectId;
+exports.createLocalPObjectId = require_spec$1.createLocalPObjectId;
 exports.createNodeServiceHandlers = require_node_service_handlers.createNodeServiceHandlers;
+exports.createPObjectId = require_spec$1.createPObjectId;
 exports.createPlRef = require_ref.createPlRef;
 exports.createPrimaryRef = require_ref.createPrimaryRef;
 exports.dataInfoToEntries = require_data_info.dataInfoToEntries;
+exports.dedupColumns = require_dedup.dedupColumns;
 exports.deriveNativeId = require_native_id.deriveNativeId;
+exports.deriveSpecDelta = require_overridden.deriveSpecDelta;
 exports.deserializeError = require_errors.deserializeError;
 exports.deserializeResult = require_errors.deserializeResult;
 exports.digestPlId = require_plid.digestPlId;
-exports.distillDiscoveredPColumn = require_discovered_column.distillDiscoveredPColumn;
+exports.distillColumnDiscoveredKey = require_discovered_column.distillColumnDiscoveredKey;
+exports.distillColumnOverriddenKey = require_overridden.distillColumnOverriddenKey;
 exports.ensureError = require_errors.ensureError;
 exports.ensurePColumn = require_spec$1.ensurePColumn;
 exports.entriesToDataInfo = require_data_info.entriesToDataInfo;
@@ -119,6 +149,8 @@ exports.extractAllRequirements = require_flag_utils.extractAllRequirements;
 exports.extractAllSupports = require_flag_utils.extractAllSupports;
 exports.extractCodeWithInfo = require_block_config.extractCodeWithInfo;
 exports.extractConfigGeneric = require_normalization.extractConfigGeneric;
+exports.extractPObjectId = require_ids.extractPObjectId;
+exports.findDescendantsByType = require_accessor_traversal.findDescendantsByType;
 exports.getArrayFromAxisTree = require_spec.getArrayFromAxisTree;
 exports.getAxesId = require_spec.getAxesId;
 exports.getAxesTree = require_spec.getAxesTree;
@@ -137,6 +169,8 @@ exports.getServiceUiMethods = require_service_types.getServiceUiMethods;
 exports.getSetFromAxisTree = require_spec.getSetFromAxisTree;
 exports.getTypeFromPColumnOrAxisSpec = require_spec.getTypeFromPColumnOrAxisSpec;
 exports.hasAbortError = require_errors.hasAbortError;
+exports.indexAccessorRoot = require_accessor_traversal.indexAccessorRoot;
+exports.indexPoolBlock = require_accessor_traversal.indexPoolBlock;
 exports.isAbortError = require_errors.isAbortError;
 exports.isAggregateError = require_errors.isAggregateError;
 exports.isAnchoredPColumnId = require_selectors.isAnchoredPColumnId;
@@ -144,27 +178,37 @@ exports.isAnyLogHandle = require_log.isAnyLogHandle;
 exports.isAxisId = require_spec.isAxisId;
 exports.isBlockUIURL = require_urls.isBlockUIURL;
 exports.isBooleanExpression = require_utils.isBooleanExpression;
+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.isDataInfo = require_data_info.isDataInfo;
 exports.isDataInfoEntries = require_data_info.isDataInfoEntries;
-exports.isDiscoveredPColumn = require_discovered_column.isDiscoveredPColumn;
+exports.isEmptySpecDelta = require_overridden.isEmptySpecDelta;
 exports.isEnrichmentRef = require_ref.isEnrichmentRef;
 exports.isFilteredPColumn = require_filtered_column.isFilteredPColumn;
 exports.isFolderURL = require_urls.isFolderURL;
+exports.isGlobalPObjectId = require_spec$1.isGlobalPObjectId;
+exports.isGlobalPObjectKey = require_spec$1.isGlobalPObjectKey;
 exports.isImportFileHandleIndex = require_ls.isImportFileHandleIndex;
 exports.isImportFileHandleUpload = require_ls.isImportFileHandleUpload;
 exports.isKnownServiceName = require_service_capabilities.isKnownServiceName;
 exports.isLabelColumn = require_spec.isLabelColumn;
 exports.isLinkerColumn = require_spec.isLinkerColumn;
 exports.isLiveLog = require_log.isLiveLog;
+exports.isLocalPObjectId = require_spec$1.isLocalPObjectId;
+exports.isLocalPObjectKey = require_spec$1.isLocalPObjectKey;
 exports.isMainService = require_service_types.isMainService;
 exports.isNodeService = require_service_types.isNodeService;
 exports.isPColumn = require_spec$1.isPColumn;
-exports.isPColumnResult = require_spec$1.isPColumnResult;
 exports.isPColumnSpec = require_spec$1.isPColumnSpec;
-exports.isPColumnSpecResult = require_spec$1.isPColumnSpecResult;
 exports.isPFrameDriverError = require_errors.isPFrameDriverError;
 exports.isPFrameError = require_errors.isPFrameError;
 exports.isPFrameSpecDriverError = require_errors.isPFrameSpecDriverError;
+exports.isPObject = require_spec$1.isPObject;
+exports.isPObjectId = require_spec$1.isPObjectId;
+exports.isPObjectKey = require_spec$1.isPObjectKey;
 exports.isPTableNA = require_data_types.isPTableNA;
 exports.isPartitionedDataInfoEntries = require_data_info.isPartitionedDataInfoEntries;
 exports.isPlRef = require_ref.isPlRef;
@@ -178,6 +222,7 @@ exports.isServiceNotRegisteredError = require_errors.isServiceNotRegisteredError
 exports.isValueNA = require_data_types.isValueNA;
 exports.isWasmService = require_service_types.isWasmService;
 exports.legacyColumnSelectorsToPredicate = require_selectors.legacyColumnSelectorsToPredicate;
+exports.listColumnNames = require_accessor_traversal.listColumnNames;
 exports.mapDataInfo = require_data_info.mapDataInfo;
 exports.mapDataInfoEntries = require_data_info.mapDataInfoEntries;
 exports.mapJoinEntry = require_table_calculate.mapJoinEntry;
@@ -190,12 +235,16 @@ exports.matchAxis = require_selectors.matchAxis;
 exports.matchAxisId = require_spec.matchAxisId;
 exports.matchMultiColumnSelector = require_selectors.matchMultiColumnSelector;
 exports.matchPColumn = require_selectors.matchPColumn;
+exports.matchingModeToConstraints = require_discover_columns_options.matchingModeToConstraints;
+exports.mergeSpecOverrides = require_overridden.mergeSpecOverrides;
 exports.multiColumnSelectorsToPredicate = require_selectors.multiColumnSelectorsToPredicate;
 exports.newRangeBytesOpt = require_blob.newRangeBytesOpt;
 exports.pTableValue = require_data_types.pTableValue;
 exports.pTableValueBranded = require_data_types.pTableValueBranded;
+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.parseHttpAuth = require_httpAuth.parseHttpAuth;
 exports.parseJson = require_json.parseJson;
 exports.parseJsonSafely = require_json.parseJsonSafely;
@@ -210,6 +259,7 @@ 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.registerServiceCapabilities = require_service_capabilities.registerServiceCapabilities;
 exports.resolveAnchors = require_anchored.resolveAnchors;
 exports.resolveAnnotationParents = require_spec.resolveAnnotationParents;
@@ -223,12 +273,15 @@ exports.serviceFnKey = require_service_types.serviceFnKey;
 exports.sortJoinEntry = require_table_calculate.sortJoinEntry;
 exports.sortPTableDef = require_table_calculate.sortPTableDef;
 exports.sortSpecQuery = require_utils.sortSpecQuery;
+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.stringifyJson = require_json.stringifyJson;
 exports.traverseQuerySpec = require_utils.traverseQuerySpec;
 exports.uniqueBy = require_util.uniqueBy;
 exports.uniquePlId = require_plid.uniquePlId;
+exports.unwrapOverrides = require_overridden.unwrapOverrides;
 exports.unwrapResult = require_errors.unwrapResult;
 exports.validateRangeBytes = require_blob.validateRangeBytes;
 exports.visitDataInfo = require_data_info.visitDataInfo;

package/dist/index.d.ts

@@ -6,16 +6,17 @@ import { BlockState, BlockStateV3 } from "./block_state.js";
 import { Branded } from "./branding.js";
 import { DialogService, FileFilter, ShowSaveDialogOptions, ShowSaveDialogResult } from "./dialog/index.js";
 import { PoolEntry, PoolEntryGuard } from "./pool_entry.js";
-import { AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, FilteredPColumn, FilteredPColumnId, isFilteredPColumn } from "./drivers/pframe/spec/filtered_column.js";
-import { DiscoveredPColumn, DiscoveredPColumnId, createDiscoveredPColumnId, distillDiscoveredPColumn, isDiscoveredPColumn, parseDiscoveredPColumnId, stringifyDiscoveredPColumnId } from "./drivers/pframe/spec/discovered_column.js";
-import { SUniversalPColumnId, UniversalPColumnId, parseColumnId, stringifyColumnId } from "./drivers/pframe/spec/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 "./drivers/pframe/spec/spec.js";
+import { ColumnDiscoveredId, ColumnDiscoveredKey, createColumnDiscoveredId, createColumnDiscoveredKey, distillColumnDiscoveredKey, isColumnDiscoveredId, isColumnDiscoveredKey, parseColumnDiscoveredId, stringifyColumnDiscoveredId } from "./drivers/pframe/spec/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 "./drivers/pframe/spec/spec.js";
+import { ColumnOverriddenId, ColumnOverriddenKey, SpecOverrides, applySpecOverrides, createColumnOverriddenId, createColumnOverriddenKey, deriveSpecDelta, distillColumnOverriddenKey, isColumnOverriddenKey, isEmptySpecDelta, mergeSpecOverrides, parseColumnOverriddenId, stringifyColumnOverriddenId, unwrapOverrides } from "./drivers/pframe/spec/overridden.js";
+import { AxisPatches, ColumnUniversalId, ColumnUniversalKey, SUniversalPColumnId, UniversalPColumnId, extractPObjectId, parseColumnId, parseColumnIdSafely, reconstructSpecFromId, stringifyColumnId } from "./drivers/pframe/spec/ids.js";
+import { AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, ColumnFilteredId, ColumnFilteredKey, FilteredPColumn, FilteredPColumnId, applyAxisFilters, createColumnFilteredId, createColumnFilteredKey, isColumnFilteredId, isColumnFilteredKey, isFilteredPColumn, stringifyColumnFilteredId } from "./drivers/pframe/spec/filtered_column.js";
 import { AnchoredIdDeriver, ResolveAnchorsOptions, resolveAnchors } from "./drivers/pframe/spec/anchored.js";
 import { NativePObjectId, deriveNativeId } from "./drivers/pframe/spec/native_id.js";
 import { PTableColumnId, PTableColumnIdAxis, PTableColumnIdColumn, PTableColumnSpec, PTableColumnSpecAxis, PTableColumnSpecColumn, getPTableColumnId } from "./drivers/pframe/table_common.js";
 import { ExportPTableOptions, PTableDownloadCompression, PTableDownloadFormat, PTableNA, PTableShape, PTableValue, PTableValueAxis, PTableValueBranded, PTableValueData, PTableValueDataBranded, PTableValueDouble, PTableValueFloat, PTableValueInt, PTableValueLong, PTableValueString, PTableVector, PTableVectorTyped, PVectorData, PVectorDataBytes, PVectorDataDouble, PVectorDataFloat, PVectorDataInt, PVectorDataLong, PVectorDataString, PVectorDataTyped, TableRange, ValueTypeSupported, WritePTableToFsOptions, WritePTableToFsResult, XLSX_MAX_ROWS_PER_SHEET, isPTableNA, isValueNA, pTableValue, pTableValueBranded } from "./drivers/pframe/data_types.js";
 import { BinaryChunk, BinaryPartitionedDataInfo, BinaryPartitionedDataInfoEntries, DataInfo, DataInfoEntries, JsonDataInfo, JsonDataInfoEntries, JsonPartitionedDataInfo, JsonPartitionedDataInfoEntries, PColumnDataEntry, PColumnKey, PColumnValue, PColumnValues, PColumnValuesEntry, ParquetChunk, ParquetChunkMapping, ParquetChunkMappingAxis, ParquetChunkMappingColumn, ParquetChunkMetadata, ParquetChunkStats, ParquetPartitionedDataInfo, ParquetPartitionedDataInfoEntries, PartitionedDataInfoEntries, dataInfoToEntries, entriesToDataInfo, isDataInfo, isDataInfoEntries, isPartitionedDataInfoEntries, mapDataInfo, mapDataInfoEntries, visitDataInfo } from "./drivers/pframe/data_info.js";
-import { SpecExprAxisRef, SpecExprColumnRef, SpecQuery, SpecQueryBooleanExpression, SpecQueryColumn, SpecQueryExpression, SpecQueryFilter, SpecQueryInlineColumn, SpecQueryJoinEntry, SpecQueryLinkerJoin, SpecQueryLinkerJoinLinker, SpecQueryOuterJoin, SpecQuerySliceAxes, SpecQuerySort, SpecQuerySparseToDenseColumn, SpecQuerySymmetricJoin, SpecQueryTransformColumns } from "./drivers/pframe/query/query_spec.js";
+import { SpecExprAxisRef, SpecExprColumnRef, SpecQuery, SpecQueryBooleanExpression, SpecQueryColumn, SpecQueryExpression, SpecQueryFilter, SpecQueryInlineColumn, SpecQueryJoinEntry, SpecQueryLinkerJoin, SpecQueryOuterJoin, SpecQuerySliceAxes, SpecQuerySort, SpecQuerySparseToDenseColumn, SpecQuerySpecOverride, SpecQuerySymmetricJoin, SpecQueryTransformColumns } from "./drivers/pframe/query/query_spec.js";
 import { ArtificialColumnJoinEntry, CalculateTableDataRequest, CalculateTableDataResponse, ColumnJoinEntry, ConstantAxisFilter, FullJoin, FullPTableColumnData, InlineColumnJoinEntry, InnerJoin, JoinEntry, OuterJoin, PTableDef, PTableDefV2, PTableRecordFilter, PTableRecordSingleValueFilterV2, PTableSorting, SingleValueAndPredicateV2, SingleValueEqualPredicate, SingleValueGreaterOrEqualPredicate, SingleValueGreaterPredicate, SingleValueIEqualPredicate, SingleValueInSetPredicate, SingleValueIsNAPredicate, SingleValueLessOrEqualPredicate, SingleValueLessPredicate, SingleValueMatchesPredicate, SingleValueNotPredicateV2, SingleValueOrPredicateV2, SingleValuePredicateV2, SingleValueStringContainsFuzzyPredicate, SingleValueStringContainsPredicate, SingleValueStringIContainsFuzzyPredicate, SingleValueStringIContainsPredicate, SlicedColumnJoinEntry, mapJoinEntry, mapPTableDef, mapPTableDefV2, sortJoinEntry, sortPTableDef } from "./drivers/pframe/table_calculate.js";
 import { DataExprAxisRef, DataExprColumnRef, DataQuery, DataQueryBooleanExpression, DataQueryColumn, DataQueryExpression, DataQueryFilter, DataQueryInlineColumn, DataQueryJoinEntry, DataQueryLinkerJoin, DataQueryLinkerJoinLinker, DataQueryOuterJoin, DataQuerySliceAxes, DataQuerySort, DataQuerySparseToDenseColumn, DataQuerySymmetricJoin, DataQueryTransformColumns } from "./drivers/pframe/query/query_data.js";
 import { collectSpecQueryColumns, isBooleanExpression, mapSpecQueryColumns, sortSpecQuery, traverseQuerySpec } from "./drivers/pframe/query/utils.js";
@@ -29,19 +30,23 @@ import { AnyLogHandle, LiveLogHandle, LogsDriver, ProgressLogWithInfo, ReadyLogH
 import { ColumnFilter } from "./drivers/pframe/column_filter.js";
 import { FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, InferFilterSpecCommonLeaf, InferFilterSpecCommonNode, InferFilterSpecLeaf, InferFilterSpecLeafColumn, RootFilterSpec } from "./drivers/pframe/filter_spec.js";
 import { FindColumnsRequest, FindColumnsResponse } from "./drivers/pframe/find_columns.js";
-import { PTable } from "./drivers/pframe/table.js";
 import { UniqueValuesRequest, UniqueValuesResponse } from "./drivers/pframe/unique_values.js";
+import { PFrame, PFrameDef } from "./drivers/pframe/pframe.js";
+import { PTable } from "./drivers/pframe/table.js";
+import { PFrameDriver, PFrameHandle, PFrameModelDriver, PTableHandle } from "./drivers/pframe/driver.js";
 import { CompositeLinkerMap, LinkerMap } from "./drivers/pframe/linker_columns.js";
 import { FileRange, ImportFileHandle, ImportFileHandleIndex, ImportFileHandleUpload, ListFilesResult, LocalImportFileHandle, LsDriver, LsEntry, OpenDialogFilter, OpenDialogOps, OpenMultipleFilesResponse, OpenSingleFileResponse, StorageEntry, StorageHandle, StorageHandleLocal, StorageHandleRemote, getFileNameFromHandle, getFilePathFromHandle, isImportFileHandleIndex, isImportFileHandleUpload } from "./drivers/ls.js";
+import { ColumnSelector, RelaxedAxisSelector, RelaxedColumnSelector, RelaxedRecord, RelaxedStringMatchers, convertColumnSelectorToMultiColumnSelector, convertRelaxedAxisSelectorToMultiAxisSelector, convertRelaxedColumnSelectorToMultiColumnSelector } from "./columns/column_selector.js";
+import { AnchorEntry, ColumnsDiscoverOptions, ColumnsFilterOptions, DiscoverColumnsOptions, MatchQualifications, MatchingMode, matchingModeToConstraints } from "./drivers/columns/discover_columns_options.js";
 import { ChunkedStreamReader, ChunkedStreamReaderOptions, ErrorHandlerStatus } from "./drivers/ChunkedStreamReader.js";
-import { PObject, PObjectId, PObjectSpec, ensurePColumn, extractAllColumns, isPColumn, isPColumnResult, isPColumnSpec, isPColumnSpecResult, mapPObjectData } from "./pool/spec.js";
+import { GlobalPObjectId, GlobalPObjectKey, LocalPObjectId, LocalPObjectKey, PObject, PObjectId, PObjectSpec, createGlobalPObjectId, createLocalPObjectId, createPObjectId, ensurePColumn, extractAllColumns, isGlobalPObjectId, isGlobalPObjectKey, isLocalPObjectId, isLocalPObjectKey, isPColumn, isPColumnSpec, isPObject, isPObjectId, isPObjectKey, mapPObjectData } from "./pool/spec.js";
 import { CreateEnrichmentRefOptions, DatasetInput, EnrichmentLinkerStep, EnrichmentRef, EnrichmentStep, LabeledEnrichmentRef, LabeledEnrichmentRefs, Option, PlRef, PrimaryRef, Ref, createEnrichmentRef, createPlRef, createPrimaryRef, isEnrichmentRef, isPlRef, isPrimaryRef, plRefsEqual, withEnrichments } from "./ref.js";
 import { ResultCollection, ResultPoolEntry } from "./pool/entry.js";
 import { PSpecPredicate, executePSpecPredicate } from "./pool/query.js";
-import { PFrame, PFrameDef } from "./drivers/pframe/pframe.js";
-import { PFrameDriver, PFrameHandle, PFrameModelDriver, PTableHandle } from "./drivers/pframe/driver.js";
+import { AccessorHandle, AccessorLike, ColumnEntriesProvider, FieldTraversalStepLike, LeafEntry, UpstreamBlockCtx } from "./columns/types.js";
+import { CollectionHandle, ColumnsCollectionDriver, ColumnsCollectionDriverHost, ColumnsCollectionDriverModel, SerializedColumnsSource } from "./drivers/columns/columns_collection_driver.js";
 import { Services } from "./services/service_declarations.js";
-import { InferServiceKind, InferServiceModel, InferServiceUi, ModelServiceFactoryMap, ModelServices, RequireServices, ServiceBrand, ServiceDispatch, ServiceName, ServiceNameLiterals, ServiceRequireFlags, ServiceType, ServiceTypesLike, UiServiceFactoryMap, UiServices, getServiceKind, getServiceModelMethods, getServiceUiMethods, isMainService, isNodeService, isWasmService, service, serviceFnKey } from "./services/service_types.js";
+import { InferServiceKind, InferServiceModel, InferServiceModelHost, InferServiceUi, InferServiceUiHost, ModelServiceFactoryMap, ModelServices, RequireServices, ServiceBrand, ServiceDispatch, ServiceName, ServiceNameLiterals, ServiceRequireFlags, ServiceType, ServiceTypesLike, UiServiceFactoryMap, UiServices, getServiceKind, getServiceModelMethods, getServiceUiMethods, isMainService, isNodeService, isWasmService, service, serviceFnKey } from "./services/service_types.js";
 import { ModelServiceRegistry, UiServiceRegistry } from "./services/service_registry.js";
 import { ArrayTypeUnion, Assert, AssertKeysEqual, FilterKeysByPrefix, Is, IsSubtypeOf } from "./flags/type_utils.js";
 import { IncompatibleFlagsError, RuntimeCapabilities, SupportedRequirement, checkBlockFlag, extractAllRequirements, extractAllSupports } from "./flags/flag_utils.js";
@@ -64,4 +69,8 @@ import { assertNever, uniqueBy } from "./util.js";
 import { BasicHttpAuth, HttpAuth, parseHttpAuth, serializeHttpAuth } from "./httpAuth.js";
 import { ResourceTypeName, ResourceTypePrefix } from "./resource_types.js";
 import { ProjectId } from "./project_id.js";
-export { AAxisSelector, ADomain, AbortError, AllRequiresFeatureFlags, AllSupportsFeatureFlags, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredIdDeriver, AnchoredPColumnId, AnchoredPColumnSelector, Annotation, AnnotationDataStatus, AnnotationJson, AnyFunction, AnyLogHandle, ArchiveFormat, ArrayTypeUnion, ArtificialColumnJoinEntry, Assert, AssertKeysEqual, AuthorMarker, AxesId, AxesSpec, AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, AxisId, AxisQualification, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, Base64Compatible, Base64Encoded, BasicHttpAuth, BinaryChunk, BinaryPartitionedDataInfo, BinaryPartitionedDataInfoEntries, BlobDriver, BlobDriverMetrics, BlobHandleAndSize, BlobLike, BlobToURLDriver, BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags, BlockCodeWithInfo, BlockConfigContainer, BlockConfigGeneric, BlockConfigV3Generic, BlockConfigV4Generic, BlockOutputsBase, BlockRenderingMode, BlockSection, BlockSectionDelimiter, BlockSectionLink, BlockSectionLinkAppearance, BlockState, BlockStateV3, BlockUIURL, Branded, BuildQueryInput, CalculateTableDataRequest, CalculateTableDataResponse, CanonicalizedJson, ChunkedStreamReader, ChunkedStreamReaderOptions, Code, ColumnAxesWithQualifications, ColumnFilter, ColumnJoinEntry, ColumnValueType, CompositeLinkerMap, ConstantAxisFilter, ContentHandler, CreateEnrichmentRefOptions, DataExprAxisRef, DataExprColumnRef, DataInfo, DataInfoEntries, DataQuery, DataQueryBooleanExpression, DataQueryColumn, DataQueryExpression, DataQueryFilter, DataQueryInlineColumn, DataQueryJoinEntry, DataQueryLinkerJoin, DataQueryLinkerJoinLinker, DataQueryOuterJoin, DataQuerySliceAxes, DataQuerySort, DataQuerySparseToDenseColumn, DataQuerySymmetricJoin, DataQueryTransformColumns, DatasetInput, DefaultNavigationState, DeleteColumnRequest, DeleteColumnResponse, DialogService, DiscoverColumnsConstraints, DiscoverColumnsFilterStep, DiscoverColumnsLinkerStep, DiscoverColumnsMappingVariant, DiscoverColumnsRequest, DiscoverColumnsResponse, DiscoverColumnsResponseHit, DiscoverColumnsResponseQualifications, DiscoverColumnsStepInfo, DiscoveredPColumn, DiscoveredPColumnId, Domain, DomainJson, DriverKit, EnrichmentLinkerStep, EnrichmentRef, EnrichmentStep, ErrorHandlerStatus, EvaluateQueryResponse, ExportPTableOptions, FileFilter, FileLike, FileRange, FilterKeysByPrefix, FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, FilteredPColumn, FilteredPColumnId, FindColumnsRequest, FindColumnsResponse, FolderURL, FrontendDriver, FullJoin, FullPTableColumnData, GetContentOptions, HttpAuth, ImportFileHandle, ImportFileHandleIndex, ImportFileHandleUpload, ImportProgress, ImportStatus, IncompatibleFlagsError, InferFilterSpecCommonLeaf, InferFilterSpecCommonNode, InferFilterSpecLeaf, InferFilterSpecLeafColumn, InferServiceKind, InferServiceModel, InferServiceUi, InlineColumnJoinEntry, InnerJoin, Is, IsSubtypeOf, JoinEntry, JsonCompatible, JsonDataInfo, JsonDataInfoEntries, JsonPartitionedDataInfo, JsonPartitionedDataInfoEntries, JsonSerializable, KnownServiceName, LabeledEnrichmentRef, LabeledEnrichmentRefs, LegacyAxisSelector, LinkerMap, ListFilesResult, ListOptionBase, LiveLogHandle, LocalBlobHandle, LocalBlobHandleAndSize, LocalImportFileHandle, LogsDriver, LsDriver, LsEntry, MODEL_SERVICE_METHOD_MAP, MatcherMap, Metadata, MetadataJson, ModelServiceFactoryMap, ModelServiceRegistry, ModelServices, MultiAxisSelector, MultiColumnSelector, NativePObjectId, NavigationState, NodeServiceHandlerMap, OpenDialogFilter, OpenDialogOps, OpenMultipleFilesResponse, OpenSingleFileResponse, Option, OuterJoin, OutputWithStatus, PAxisName, PColumn, PColumnDataEntry, PColumnIdAndSpec, PColumnKey, PColumnLazy, PColumnName, PColumnSelector, PColumnSpec, PColumnSpecId, PColumnValue, PColumnValues, PColumnValuesEntry, PDataColumnSpec, PFrame, PFrameDef, PFrameDriver, PFrameDriverError, PFrameError, PFrameHandle, PFrameModelDriver, PFrameSpecDriver, PFrameSpecDriverError, PObject, PObjectId, PObjectSpec, PSpecPredicate, PTable, PTableColumnId, PTableColumnIdAxis, PTableColumnIdColumn, PTableColumnSpec, PTableColumnSpecAxis, PTableColumnSpecColumn, PTableDef, PTableDefV2, PTableDownloadCompression, PTableDownloadFormat, PTableHandle, PTableNA, PTableRecordFilter, PTableRecordSingleValueFilterV2, PTableShape, PTableSorting, PTableValue, PTableValueAxis, PTableValueBranded, PTableValueData, PTableValueDataBranded, PTableValueDouble, PTableValueFloat, PTableValueInt, PTableValueLong, PTableValueString, PTableVector, PTableVectorTyped, PUniversalColumnSpec, PVectorData, PVectorDataBytes, PVectorDataDouble, PVectorDataFloat, PVectorDataInt, PVectorDataLong, PVectorDataString, PVectorDataTyped, ParquetChunk, ParquetChunkMapping, ParquetChunkMappingAxis, ParquetChunkMappingColumn, ParquetChunkMetadata, ParquetChunkStats, ParquetPartitionedDataInfo, ParquetPartitionedDataInfoEntries, PartitionedDataInfoEntries, PlId, PlIdBytes, PlIdLength, PlRef, PoolEntry, PoolEntryGuard, PrimaryRef, ProgressLogWithInfo, ProjectId, REQUIRES_PFRAMES_VERSION, RangeBytes, ReadyLogHandle, Ref, RemoteBlobHandle, RemoteBlobHandleAndSize, RequireServices, ResolveAnchorsOptions, ResourceTypeName, ResourceTypePrefix, ResultCollection, ResultOrError, ResultPoolEntry, RootFilterSpec, RuntimeCapabilities, SERVICE_CAPABILITY_FLAGS, SERVICE_FEATURE_FLAGS, SERVICE_METHOD_MAP, SUniversalPColumnId, SerializedError, ServiceAlreadyRegisteredError, ServiceBrand, ServiceDispatch, ServiceError, ServiceInjectionError, ServiceInvalidIdError, ServiceMethodNotFoundError, ServiceName, ServiceNameLiterals, ServiceNotRegisteredError, ServiceRequireFlags, ServiceType, ServiceTypesLike, Services, ShowSaveDialogOptions, ShowSaveDialogResult, SingleAxisSelector, SingleValueAndPredicateV2, SingleValueEqualPredicate, SingleValueGreaterOrEqualPredicate, SingleValueGreaterPredicate, SingleValueIEqualPredicate, SingleValueInSetPredicate, SingleValueIsNAPredicate, SingleValueLessOrEqualPredicate, SingleValueLessPredicate, SingleValueMatchesPredicate, SingleValueNotPredicateV2, SingleValueOrPredicateV2, SingleValuePredicateV2, SingleValueStringContainsFuzzyPredicate, SingleValueStringContainsPredicate, SingleValueStringIContainsFuzzyPredicate, SingleValueStringIContainsPredicate, SlicedColumnJoinEntry, SpecExprAxisRef, SpecExprColumnRef, SpecFrameHandle, SpecQuery, SpecQueryBooleanExpression, SpecQueryColumn, SpecQueryExpression, SpecQueryFilter, SpecQueryInlineColumn, SpecQueryJoinEntry, SpecQueryLinkerJoin, SpecQueryLinkerJoinLinker, SpecQueryOuterJoin, SpecQuerySliceAxes, SpecQuerySort, SpecQuerySparseToDenseColumn, SpecQuerySymmetricJoin, SpecQueryTransformColumns, StorageEntry, StorageHandle, StorageHandleLocal, StorageHandleRemote, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, StringMatcher, StringifiedJson, SupportedRequirement, TableRange, Trace, TraceEntry, UiError, UiServiceFactoryMap, UiServiceRegistry, UiServices, UniqueValuesRequest, UniqueValuesResponse, UniversalPColumnId, ValueOrError, ValueType, ValueTypeSupported, ValueWithUTag, ValueWithUTagAndAuthor, WritePTableToFsOptions, WritePTableToFsResult, XLSX_MAX_ROWS_PER_SHEET, assertNever, base64Decode, base64Encode, bigintReplacer, buildServiceInfo, canonicalizeAxisId, canonicalizeAxisWithParents, canonicalizeJson, checkBlockFlag, collectSpecQueryColumns, createDiscoveredPColumnId, createEnrichmentRef, createNodeServiceHandlers, createPlRef, createPrimaryRef, dataInfoToEntries, deriveNativeId, deserializeError, deserializeResult, digestPlId, distillDiscoveredPColumn, ensureError, ensurePColumn, entriesToDataInfo, executePSpecPredicate, extractAllColumns, extractAllRequirements, extractAllSupports, extractCodeWithInfo, extractConfigGeneric, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getFileNameFromHandle, getFilePathFromHandle, getMethodNames, getNormalizedAxesList, getPColumnSpecId, getPTableColumnId, getServiceKind, getServiceModelMethods, getServiceUiMethods, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, hasAbortError, isAbortError, isAggregateError, isAnchoredPColumnId, isAnyLogHandle, isAxisId, isBlockUIURL, isBooleanExpression, isDataInfo, isDataInfoEntries, isDiscoveredPColumn, isEnrichmentRef, isFilteredPColumn, isFolderURL, isImportFileHandleIndex, isImportFileHandleUpload, isKnownServiceName, isLabelColumn, isLinkerColumn, isLiveLog, isMainService, isNodeService, isPColumn, isPColumnResult, isPColumnSpec, isPColumnSpecResult, isPFrameDriverError, isPFrameError, isPFrameSpecDriverError, isPTableNA, isPartitionedDataInfoEntries, isPlRef, isPrimaryRef, isServiceAlreadyRegisteredError, isServiceError, isServiceInjectionError, isServiceInvalidIdError, isServiceMethodNotFoundError, isServiceNotRegisteredError, isValueNA, isWasmService, legacyColumnSelectorsToPredicate, mapDataInfo, mapDataInfoEntries, mapJoinEntry, mapPObjectData, mapPTableDef, mapPTableDefV2, mapSpecQueryColumns, mapValueInVOE, matchAxis, matchAxisId, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate, newRangeBytesOpt, pTableValue, pTableValueBranded, parseColumnId, parseDiscoveredPColumnId, parseHttpAuth, parseJson, parseJsonSafely, plId, plRefsEqual, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, registerServiceCapabilities, resolveAnchors, resolveAnnotationParents, resolveNodeServiceHandler, resolveRequiredServices, serializeError, serializeHttpAuth, serializeResult, service, serviceFnKey, sortJoinEntry, sortPTableDef, sortSpecQuery, stringifyColumnId, stringifyDiscoveredPColumnId, stringifyJson, traverseQuerySpec, uniqueBy, uniquePlId, unwrapResult, validateRangeBytes, visitDataInfo, withEnrichments, wrapAndSerialize, wrapAndSerializeAsync, wrapAsyncCallback, wrapCallback };
+import { COLLECT_TYPES, DESCEND_TYPES, findDescendantsByType, indexAccessorRoot, indexPoolBlock, listColumnNames } from "./columns/accessor_traversal.js";
+import { ColumnRegistry } from "./columns/column_registry.js";
+import { dedupColumns } from "./columns/dedup.js";
+import { AccessorEntriesProvider, ResultPoolEntriesProvider } from "./columns/providers.js";
+export { AAxisSelector, ADomain, AbortError, AccessorEntriesProvider, AccessorHandle, AccessorLike, AllRequiresFeatureFlags, AllSupportsFeatureFlags, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchorEntry, AnchoredColumnMatchStrategy, AnchoredIdDeriver, AnchoredPColumnId, AnchoredPColumnSelector, Annotation, AnnotationDataStatus, AnnotationJson, AnyFunction, AnyLogHandle, ArchiveFormat, ArrayTypeUnion, ArtificialColumnJoinEntry, Assert, AssertKeysEqual, AuthorMarker, AxesId, AxesSpec, AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, AxisId, AxisPatches, AxisQualification, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, Base64Compatible, Base64Encoded, BasicHttpAuth, BinaryChunk, BinaryPartitionedDataInfo, BinaryPartitionedDataInfoEntries, BlobDriver, BlobDriverMetrics, BlobHandleAndSize, BlobLike, BlobToURLDriver, BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags, BlockCodeWithInfo, BlockConfigContainer, BlockConfigGeneric, BlockConfigV3Generic, BlockConfigV4Generic, BlockOutputsBase, BlockRenderingMode, BlockSection, BlockSectionDelimiter, BlockSectionLink, BlockSectionLinkAppearance, BlockState, BlockStateV3, BlockUIURL, Branded, BuildQueryInput, COLLECT_TYPES, CalculateTableDataRequest, CalculateTableDataResponse, CanonicalizedJson, ChunkedStreamReader, ChunkedStreamReaderOptions, Code, CollectionHandle, ColumnAxesWithQualifications, ColumnDiscoveredId, ColumnDiscoveredKey, ColumnEntriesProvider, ColumnFilter, ColumnFilteredId, ColumnFilteredKey, ColumnJoinEntry, ColumnOverriddenId, ColumnOverriddenKey, ColumnRegistry, ColumnSelector, ColumnUniversalId, ColumnUniversalKey, ColumnValueType, ColumnsCollectionDriver, ColumnsCollectionDriverHost, ColumnsCollectionDriverModel, ColumnsDiscoverOptions, ColumnsFilterOptions, CompositeLinkerMap, ConstantAxisFilter, ContentHandler, CreateEnrichmentRefOptions, DESCEND_TYPES, DataExprAxisRef, DataExprColumnRef, DataInfo, DataInfoEntries, DataQuery, DataQueryBooleanExpression, DataQueryColumn, DataQueryExpression, DataQueryFilter, DataQueryInlineColumn, DataQueryJoinEntry, DataQueryLinkerJoin, DataQueryLinkerJoinLinker, DataQueryOuterJoin, DataQuerySliceAxes, DataQuerySort, DataQuerySparseToDenseColumn, DataQuerySymmetricJoin, DataQueryTransformColumns, DatasetInput, DefaultNavigationState, DeleteColumnRequest, DeleteColumnResponse, DialogService, DiscoverColumnsConstraints, DiscoverColumnsFilterStep, DiscoverColumnsLinkerStep, DiscoverColumnsMappingVariant, DiscoverColumnsOptions, DiscoverColumnsRequest, DiscoverColumnsResponse, DiscoverColumnsResponseHit, DiscoverColumnsResponseQualifications, DiscoverColumnsStepInfo, Domain, DomainJson, DriverKit, EnrichmentLinkerStep, EnrichmentRef, EnrichmentStep, ErrorHandlerStatus, EvaluateQueryResponse, ExportPTableOptions, FieldTraversalStepLike, FileFilter, FileLike, FileRange, FilterKeysByPrefix, FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, FilteredPColumn, FilteredPColumnId, FindColumnsRequest, FindColumnsResponse, FolderURL, FrontendDriver, FullJoin, FullPTableColumnData, GetContentOptions, GlobalPObjectId, GlobalPObjectKey, HttpAuth, ImportFileHandle, ImportFileHandleIndex, ImportFileHandleUpload, ImportProgress, ImportStatus, IncompatibleFlagsError, InferFilterSpecCommonLeaf, InferFilterSpecCommonNode, InferFilterSpecLeaf, InferFilterSpecLeafColumn, InferServiceKind, InferServiceModel, InferServiceModelHost, InferServiceUi, InferServiceUiHost, InlineColumnJoinEntry, InnerJoin, Is, IsSubtypeOf, JoinEntry, JsonCompatible, JsonDataInfo, JsonDataInfoEntries, JsonPartitionedDataInfo, JsonPartitionedDataInfoEntries, JsonSerializable, KnownServiceName, LabeledEnrichmentRef, LabeledEnrichmentRefs, LeafEntry, LegacyAxisSelector, LinkerMap, ListFilesResult, ListOptionBase, LiveLogHandle, LocalBlobHandle, LocalBlobHandleAndSize, LocalImportFileHandle, LocalPObjectId, LocalPObjectKey, LogsDriver, LsDriver, LsEntry, MODEL_SERVICE_METHOD_MAP, MatchQualifications, MatcherMap, MatchingMode, Metadata, MetadataJson, ModelServiceFactoryMap, ModelServiceRegistry, ModelServices, MultiAxisSelector, MultiColumnSelector, NativePObjectId, NavigationState, NodeServiceHandlerMap, OpenDialogFilter, OpenDialogOps, OpenMultipleFilesResponse, OpenSingleFileResponse, Option, OuterJoin, OutputWithStatus, PAxisName, PColumn, PColumnDataEntry, PColumnIdAndSpec, PColumnKey, PColumnName, PColumnSelector, PColumnSpec, PColumnSpecId, PColumnValue, PColumnValues, PColumnValuesEntry, PDataColumnSpec, PFrame, PFrameDef, PFrameDriver, PFrameDriverError, PFrameError, PFrameHandle, PFrameModelDriver, PFrameSpecDriver, PFrameSpecDriverError, PObject, PObjectId, PObjectSpec, PSpecPredicate, PTable, PTableColumnId, PTableColumnIdAxis, PTableColumnIdColumn, PTableColumnSpec, PTableColumnSpecAxis, PTableColumnSpecColumn, PTableDef, PTableDefV2, PTableDownloadCompression, PTableDownloadFormat, PTableHandle, PTableNA, PTableRecordFilter, PTableRecordSingleValueFilterV2, PTableShape, PTableSorting, PTableValue, PTableValueAxis, PTableValueBranded, PTableValueData, PTableValueDataBranded, PTableValueDouble, PTableValueFloat, PTableValueInt, PTableValueLong, PTableValueString, PTableVector, PTableVectorTyped, PUniversalColumnSpec, PVectorData, PVectorDataBytes, PVectorDataDouble, PVectorDataFloat, PVectorDataInt, PVectorDataLong, PVectorDataString, PVectorDataTyped, ParquetChunk, ParquetChunkMapping, ParquetChunkMappingAxis, ParquetChunkMappingColumn, ParquetChunkMetadata, ParquetChunkStats, ParquetPartitionedDataInfo, ParquetPartitionedDataInfoEntries, PartitionedDataInfoEntries, PlId, PlIdBytes, PlIdLength, PlRef, PoolEntry, PoolEntryGuard, PrimaryRef, ProgressLogWithInfo, ProjectId, REQUIRES_PFRAMES_VERSION, RangeBytes, ReadyLogHandle, Ref, RelaxedAxisSelector, RelaxedColumnSelector, RelaxedRecord, RelaxedStringMatchers, RemoteBlobHandle, RemoteBlobHandleAndSize, RequireServices, ResolveAnchorsOptions, ResourceTypeName, ResourceTypePrefix, ResultCollection, ResultOrError, ResultPoolEntriesProvider, ResultPoolEntry, RootFilterSpec, RuntimeCapabilities, SERVICE_CAPABILITY_FLAGS, SERVICE_FEATURE_FLAGS, SERVICE_METHOD_MAP, SUniversalPColumnId, SerializedColumnsSource, SerializedError, ServiceAlreadyRegisteredError, ServiceBrand, ServiceDispatch, ServiceError, ServiceInjectionError, ServiceInvalidIdError, ServiceMethodNotFoundError, ServiceName, ServiceNameLiterals, ServiceNotRegisteredError, ServiceRequireFlags, ServiceType, ServiceTypesLike, Services, ShowSaveDialogOptions, ShowSaveDialogResult, SingleAxisSelector, SingleValueAndPredicateV2, SingleValueEqualPredicate, SingleValueGreaterOrEqualPredicate, SingleValueGreaterPredicate, SingleValueIEqualPredicate, SingleValueInSetPredicate, SingleValueIsNAPredicate, SingleValueLessOrEqualPredicate, SingleValueLessPredicate, SingleValueMatchesPredicate, SingleValueNotPredicateV2, SingleValueOrPredicateV2, SingleValuePredicateV2, SingleValueStringContainsFuzzyPredicate, SingleValueStringContainsPredicate, SingleValueStringIContainsFuzzyPredicate, SingleValueStringIContainsPredicate, SlicedColumnJoinEntry, SpecExprAxisRef, SpecExprColumnRef, SpecFrameHandle, SpecOverrides, SpecQuery, SpecQueryBooleanExpression, SpecQueryColumn, SpecQueryExpression, SpecQueryFilter, SpecQueryInlineColumn, SpecQueryJoinEntry, SpecQueryLinkerJoin, SpecQueryOuterJoin, SpecQuerySliceAxes, SpecQuerySort, SpecQuerySparseToDenseColumn, SpecQuerySpecOverride, SpecQuerySymmetricJoin, SpecQueryTransformColumns, StorageEntry, StorageHandle, StorageHandleLocal, StorageHandleRemote, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, StringMatcher, StringifiedJson, SupportedRequirement, TableRange, Trace, TraceEntry, UiError, UiServiceFactoryMap, UiServiceRegistry, UiServices, UniqueValuesRequest, UniqueValuesResponse, UniversalPColumnId, UpstreamBlockCtx, ValueOrError, ValueType, ValueTypeSupported, ValueWithUTag, ValueWithUTagAndAuthor, WritePTableToFsOptions, WritePTableToFsResult, XLSX_MAX_ROWS_PER_SHEET, applyAxisFilters, applySpecOverrides, assertNever, base64Decode, base64Encode, bigintReplacer, buildServiceInfo, canonicalizeAxisId, canonicalizeAxisWithParents, canonicalizeJson, checkBlockFlag, collectSpecQueryColumns, convertColumnSelectorToMultiColumnSelector, convertRelaxedAxisSelectorToMultiAxisSelector, convertRelaxedColumnSelectorToMultiColumnSelector, createColumnDiscoveredId, createColumnDiscoveredKey, createColumnFilteredId, createColumnFilteredKey, createColumnOverriddenId, createColumnOverriddenKey, createEnrichmentRef, createGlobalPObjectId, createLocalPObjectId, createNodeServiceHandlers, createPObjectId, createPlRef, createPrimaryRef, dataInfoToEntries, dedupColumns, deriveNativeId, deriveSpecDelta, deserializeError, deserializeResult, digestPlId, distillColumnDiscoveredKey, distillColumnOverriddenKey, ensureError, ensurePColumn, entriesToDataInfo, executePSpecPredicate, extractAllColumns, extractAllRequirements, extractAllSupports, extractCodeWithInfo, extractConfigGeneric, extractPObjectId, findDescendantsByType, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getFileNameFromHandle, getFilePathFromHandle, getMethodNames, getNormalizedAxesList, getPColumnSpecId, getPTableColumnId, getServiceKind, getServiceModelMethods, getServiceUiMethods, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, hasAbortError, indexAccessorRoot, indexPoolBlock, isAbortError, isAggregateError, isAnchoredPColumnId, isAnyLogHandle, isAxisId, isBlockUIURL, isBooleanExpression, isColumnDiscoveredId, isColumnDiscoveredKey, isColumnFilteredId, isColumnFilteredKey, isColumnOverriddenKey, isDataInfo, isDataInfoEntries, isEmptySpecDelta, isEnrichmentRef, isFilteredPColumn, isFolderURL, isGlobalPObjectId, isGlobalPObjectKey, isImportFileHandleIndex, isImportFileHandleUpload, isKnownServiceName, isLabelColumn, isLinkerColumn, isLiveLog, isLocalPObjectId, isLocalPObjectKey, isMainService, isNodeService, isPColumn, isPColumnSpec, isPFrameDriverError, isPFrameError, isPFrameSpecDriverError, isPObject, isPObjectId, isPObjectKey, isPTableNA, isPartitionedDataInfoEntries, isPlRef, isPrimaryRef, isServiceAlreadyRegisteredError, isServiceError, isServiceInjectionError, isServiceInvalidIdError, isServiceMethodNotFoundError, isServiceNotRegisteredError, isValueNA, isWasmService, legacyColumnSelectorsToPredicate, listColumnNames, mapDataInfo, mapDataInfoEntries, mapJoinEntry, mapPObjectData, mapPTableDef, mapPTableDefV2, mapSpecQueryColumns, mapValueInVOE, matchAxis, matchAxisId, matchMultiColumnSelector, matchPColumn, matchingModeToConstraints, mergeSpecOverrides, multiColumnSelectorsToPredicate, newRangeBytesOpt, pTableValue, pTableValueBranded, parseColumnDiscoveredId, parseColumnId, parseColumnIdSafely, parseColumnOverriddenId, parseHttpAuth, parseJson, parseJsonSafely, plId, plRefsEqual, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, reconstructSpecFromId, registerServiceCapabilities, resolveAnchors, resolveAnnotationParents, resolveNodeServiceHandler, resolveRequiredServices, serializeError, serializeHttpAuth, serializeResult, service, serviceFnKey, sortJoinEntry, sortPTableDef, sortSpecQuery, stringifyColumnDiscoveredId, stringifyColumnFilteredId, stringifyColumnId, stringifyColumnOverriddenId, stringifyJson, traverseQuerySpec, uniqueBy, uniquePlId, unwrapOverrides, unwrapResult, validateRangeBytes, visitDataInfo, withEnrichments, wrapAndSerialize, wrapAndSerializeAsync, wrapAsyncCallback, wrapCallback };