@milaboratories/pl-model-common 1.45.0 → 1.46.1

package/dist/drivers/index.d.ts

@@ -1,11 +1,11 @@
 import { AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, FilteredPColumn, FilteredPColumnId, isFilteredPColumn } from "./pframe/spec/filtered_column.js";
 import { DiscoveredPColumn, DiscoveredPColumnId, createDiscoveredPColumnId, distillDiscoveredPColumn, isDiscoveredPColumn, parseDiscoveredPColumnId, stringifyDiscoveredPColumnId } from "./pframe/spec/discovered_column.js";
 import { SUniversalPColumnId, UniversalPColumnId, parseColumnId, stringifyColumnId } from "./pframe/spec/ids.js";
-import { Annotation, AnnotationDataStatus, AnnotationJson, AxesId, AxesSpec, AxisId, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, ColumnValueType, Domain, DomainJson, Metadata, MetadataJson, PAxisName, PColumn, PColumnIdAndSpec, PColumnInfo, 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 "./pframe/spec/spec.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 "./pframe/spec/spec.js";
 import { AnchoredIdDeriver, ResolveAnchorsOptions, resolveAnchors } from "./pframe/spec/anchored.js";
 import { NativePObjectId, deriveNativeId } from "./pframe/spec/native_id.js";
 import { PTableColumnId, PTableColumnIdAxis, PTableColumnIdColumn, PTableColumnSpec, PTableColumnSpecAxis, PTableColumnSpecColumn, getPTableColumnId } from "./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, isPTableNA, isValueNA, pTableValue, pTableValueBranded } from "./pframe/data_types.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 "./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 "./pframe/data_info.js";
 import { SpecExprAxisRef, SpecExprColumnRef, SpecQuery, SpecQueryBooleanExpression, SpecQueryColumn, SpecQueryExpression, SpecQueryFilter, SpecQueryInlineColumn, SpecQueryJoinEntry, SpecQueryLinkerJoin, SpecQueryLinkerJoinLinker, SpecQueryOuterJoin, SpecQuerySliceAxes, SpecQuerySort, SpecQuerySparseToDenseColumn, SpecQuerySymmetricJoin, SpecQueryTransformColumns } from "./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 "./pframe/table_calculate.js";

package/dist/drivers/pframe/data_types.cjs

@@ -44,8 +44,15 @@ function pTableValue(column, row, options) {
 function pTableValueBranded(column, row, options) {
 	return pTableValueImpl(column, row, options);
 }
+/**
+* Maximum number of data rows allowed per sheet in an `xlsx` export, kept below
+* Excel's hard limit of 1,048,576. The driver rejects oversized `xlsx` exports
+* (see {@link PFrameDriver.exportPTable}); UIs use it to gate the `xlsx` option.
+*/
+const XLSX_MAX_ROWS_PER_SHEET = 1e6;
 //#endregion
 exports.PTableNA = PTableNA;
+exports.XLSX_MAX_ROWS_PER_SHEET = XLSX_MAX_ROWS_PER_SHEET;
 exports.isPTableNA = isPTableNA;
 exports.isValueNA = isValueNA;
 exports.pTableValue = pTableValue;

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

@@ -1 +1 @@
-{"version":3,"file":"data_types.cjs","names":["ValueType"],"sources":["../../../src/drivers/pframe/data_types.ts"],"sourcesContent":["import type { Branded } from \"../../branding\";\nimport { ValueType } from \"./spec/spec\";\n\nexport type PVectorDataInt = Int32Array;\nexport type PVectorDataLong = BigInt64Array;\nexport type PVectorDataFloat = Float32Array;\nexport type PVectorDataDouble = Float64Array;\nexport type PVectorDataString = (null | string)[];\nexport type PVectorDataBytes = (null | Uint8Array)[];\nexport type PVectorDataTyped<DataType extends ValueType> = DataType extends typeof ValueType.Int\n  ? PVectorDataInt\n  : DataType extends typeof ValueType.Long\n    ? PVectorDataLong\n    : DataType extends typeof ValueType.Float\n      ? PVectorDataFloat\n      : DataType extends typeof ValueType.Double\n        ? PVectorDataDouble\n        : DataType extends typeof ValueType.String\n          ? PVectorDataString\n          : DataType extends typeof ValueType.Bytes\n            ? PVectorDataBytes\n            : never;\nexport type PVectorData = PVectorDataTyped<ValueType>;\n\nexport type PTableVectorTyped<DataType extends ValueType> = {\n  /** Stored data type */\n  readonly type: DataType;\n\n  /** Values for present positions */\n  readonly data: PVectorDataTyped<DataType>;\n\n  /**\n   * Encoded bit array marking some elements of this vector as NA,\n   * call {@link bitSet} to read the data.\n   * In old desktop versions NA values are encoded as magic values in data array.\n   * */\n  readonly isNA?: Uint8Array;\n\n  /** @deprecated Always empty. Kept for backwards compatibility with old blocks. */\n  readonly absent?: Uint8Array;\n};\n/** Table column data */\nexport type PTableVector = PTableVectorTyped<ValueType>;\n\nfunction isBitSet(bitVector: Uint8Array, offset: number): boolean {\n  const chunkIndex = Math.floor(offset / 8);\n  const mask = 1 << (7 - (offset % 8));\n  return (bitVector[chunkIndex] & mask) > 0;\n}\n\nexport function isValueNA(vector: PTableVector, row: number): boolean {\n  if (vector.isNA) return isBitSet(vector.isNA, row);\n\n  // Check for legacy magic values to support old desktop versions\n  const valueType = vector.type;\n  const value = vector.data[row];\n  switch (valueType) {\n    case ValueType.Int:\n      return (value as PVectorDataInt[number]) === -2147483648;\n    case ValueType.Long:\n      return (value as PVectorDataLong[number]) === -9007199254740991n;\n    case ValueType.Float:\n      return Number.isNaN(value as PVectorDataFloat[number]);\n    case ValueType.Double:\n      return Number.isNaN(value as PVectorDataDouble[number]);\n    case ValueType.String:\n      return (value as PVectorDataString[number]) === null;\n    case ValueType.Bytes:\n      return (value as PVectorDataBytes[number]) === null;\n    default:\n      throw Error(`unsupported data type: ${valueType satisfies never}`);\n  }\n}\n\nexport const PTableNA = null;\nexport type PTableNA = typeof PTableNA;\n\n/** Type guard for NA value */\nexport function isPTableNA(value: unknown): value is PTableNA {\n  return value === PTableNA;\n}\n\nexport type ValueTypeSupported = Exclude<ValueType, typeof ValueType.Bytes>;\n\nexport type PTableValueInt = number;\nexport type PTableValueLong = number;\nexport type PTableValueFloat = number;\nexport type PTableValueDouble = number;\nexport type PTableValueString = string;\nexport type PTableValueData<DataType extends ValueTypeSupported> =\n  DataType extends typeof ValueType.Int\n    ? PTableValueInt\n    : DataType extends typeof ValueType.Long\n      ? PTableValueLong\n      : DataType extends typeof ValueType.Float\n        ? PTableValueFloat\n        : DataType extends typeof ValueType.Double\n          ? PTableValueDouble\n          : DataType extends typeof ValueType.String\n            ? PTableValueString\n            : never;\nexport type PTableValueDataBranded<DataType extends ValueTypeSupported> = Branded<\n  PTableValueData<DataType>,\n  DataType\n>;\nexport type PTableValue<NA = PTableNA, DataType extends ValueTypeSupported = ValueTypeSupported> =\n  | NA\n  | PTableValueData<DataType>;\nexport type PTableValueBranded<\n  NA = PTableNA,\n  DataType extends ValueTypeSupported = ValueTypeSupported,\n> = NA | PTableValueDataBranded<DataType>;\n\nexport type PTableValueAxis<DataType extends ValueTypeSupported = ValueTypeSupported> =\n  PTableValueData<DataType>;\n\nfunction pTableValueImpl<FillNA = PTableNA, DataType extends ValueType = ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  const valueType = column.type;\n  if (valueType === ValueType.Bytes) {\n    throw Error(\"Bytes not yet supported\");\n  }\n\n  if (\n    options &&\n    \"dataType\" in options &&\n    options.dataType !== undefined &&\n    options.dataType !== valueType\n  ) {\n    throw Error(`expected column of type ${options.dataType}, got ${valueType}`);\n  }\n\n  if (isValueNA(column, row)) {\n    return options?.na !== undefined ? options.na : PTableNA;\n  }\n\n  const value = column.data[row]!;\n  switch (valueType) {\n    case ValueType.Int:\n      return value as PVectorDataInt[number];\n    case ValueType.Long:\n      return Number(value as PVectorDataLong[number]);\n    case ValueType.Float:\n      return value as PVectorDataFloat[number];\n    case ValueType.Double:\n      return value as PVectorDataDouble[number];\n    case ValueType.String:\n      return (value as PVectorDataString[number])!;\n  }\n}\n\n/** Read PTableValue from PTable column at specified row */\nexport function pTableValue<DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n): DataType extends ValueTypeSupported ? PTableValue<PTableNA, DataType> : never;\nexport function pTableValue<FillNA, DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n  options: {\n    na: FillNA;\n  },\n): DataType extends ValueTypeSupported ? PTableValue<FillNA, DataType> : never;\nexport function pTableValue<FillNA, DataType extends ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options: {\n    na: FillNA;\n    dataType: DataType;\n  },\n): PTableValue<FillNA, DataType>;\nexport function pTableValue<FillNA = PTableNA, DataType extends ValueType = ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  return pTableValueImpl(column, row, options);\n}\n\nexport function pTableValueBranded<DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n): DataType extends ValueTypeSupported ? PTableValueBranded<PTableNA, DataType> : never;\nexport function pTableValueBranded<FillNA, DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n  options: {\n    na: FillNA;\n  },\n): DataType extends ValueTypeSupported ? PTableValueBranded<FillNA, DataType> : never;\nexport function pTableValueBranded<FillNA, DataType extends ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options: {\n    na: FillNA;\n    dataType: DataType;\n  },\n): PTableValueBranded<FillNA, DataType>;\nexport function pTableValueBranded<\n  FillNA = PTableNA,\n  DataType extends ValueType = ValueTypeSupported,\n>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  return pTableValueImpl(column, row, options);\n}\n\n/** Used in requests to partially retrieve table's data */\nexport type TableRange = {\n  /** Index of the first record to retrieve */\n  readonly offset: number;\n\n  /** Block length */\n  readonly length: number;\n};\n\n/** Unified information about table shape */\nexport type PTableShape = {\n  /** Number of unified table columns, including all axes and PColumn values */\n  columns: number;\n\n  /** Number of rows */\n  rows: number;\n};\n\n/** Supported formats for PTable file download. */\nexport type PTableDownloadFormat = \"csv\" | \"tsv\";\n\n/** Compression applied to the written file. */\nexport type PTableDownloadCompression = \"none\" | \"gzip\";\n\n/** Options for downloading PTable data to a file. */\nexport interface WritePTableToFsOptions {\n  path: string;\n  format: PTableDownloadFormat;\n  columnIndices: number[];\n  range?: TableRange;\n  chunkSize?: number;\n  includeHeader?: boolean;\n  bom?: boolean;\n  compression?: {\n    type: \"gzip\";\n    level?: number;\n  };\n  signal?: AbortSignal;\n}\n\n/** Result of a PTable file download. */\nexport interface WritePTableToFsResult {\n  path: string;\n  rowsWritten: number;\n  bytesWritten: number;\n}\n\n/** Options for {@link PFrameDriver.exportPTable}. */\nexport interface ExportPTableOptions {\n  /** Destination file path; its extension selects the output format\n   * (`csv`/`tsv`/`parquet`/`xlsx`). */\n  path: string;\n  /** Unified indices of the columns to export, in output order\n   * (axes first, then data columns). */\n  columnIndices: number[];\n}\n"],"mappings":";;AA4CA,SAAS,SAAS,WAAuB,QAAyB;CAChE,MAAM,aAAa,KAAK,MAAM,SAAS,EAAE;CACzC,MAAM,OAAO,KAAM,IAAK,SAAS;AACjC,SAAQ,UAAU,cAAc,QAAQ;;AAG1C,SAAgB,UAAU,QAAsB,KAAsB;AACpE,KAAI,OAAO,KAAM,QAAO,SAAS,OAAO,MAAM,IAAI;CAGlD,MAAM,YAAY,OAAO;CACzB,MAAM,QAAQ,OAAO,KAAK;AAC1B,SAAQ,WAAR;EACE,KAAKA,aAAAA,UAAU,IACb,QAAQ,UAAqC;EAC/C,KAAKA,aAAAA,UAAU,KACb,QAAQ,UAAsC,CAAC;EACjD,KAAKA,aAAAA,UAAU,MACb,QAAO,OAAO,MAAM,MAAkC;EACxD,KAAKA,aAAAA,UAAU,OACb,QAAO,OAAO,MAAM,MAAmC;EACzD,KAAKA,aAAAA,UAAU,OACb,QAAQ,UAAwC;EAClD,KAAKA,aAAAA,UAAU,MACb,QAAQ,UAAuC;EACjD,QACE,OAAM,MAAM,0BAA0B,YAA4B;;;AAIxE,MAAa,WAAW;;AAIxB,SAAgB,WAAW,OAAmC;AAC5D,QAAO,UAAA;;AAqCT,SAAS,gBACP,QACA,KACA,SAIA;CACA,MAAM,YAAY,OAAO;AACzB,KAAI,cAAcA,aAAAA,UAAU,MAC1B,OAAM,MAAM,0BAA0B;AAGxC,KACE,WACA,cAAc,WACd,QAAQ,aAAa,KAAA,KACrB,QAAQ,aAAa,UAErB,OAAM,MAAM,2BAA2B,QAAQ,SAAS,QAAQ,YAAY;AAG9E,KAAI,UAAU,QAAQ,IAAI,CACxB,QAAO,SAAS,OAAO,KAAA,IAAY,QAAQ,KAAA;CAG7C,MAAM,QAAQ,OAAO,KAAK;AAC1B,SAAQ,WAAR;EACE,KAAKA,aAAAA,UAAU,IACb,QAAO;EACT,KAAKA,aAAAA,UAAU,KACb,QAAO,OAAO,MAAiC;EACjD,KAAKA,aAAAA,UAAU,MACb,QAAO;EACT,KAAKA,aAAAA,UAAU,OACb,QAAO;EACT,KAAKA,aAAAA,UAAU,OACb,QAAQ;;;AAwBd,SAAgB,YACd,QACA,KACA,SAIA;AACA,QAAO,gBAAgB,QAAQ,KAAK,QAAQ;;AAsB9C,SAAgB,mBAId,QACA,KACA,SAIA;AACA,QAAO,gBAAgB,QAAQ,KAAK,QAAQ"}
+{"version":3,"file":"data_types.cjs","names":["ValueType"],"sources":["../../../src/drivers/pframe/data_types.ts"],"sourcesContent":["import type { Branded } from \"../../branding\";\nimport { ValueType } from \"./spec/spec\";\n\nexport type PVectorDataInt = Int32Array;\nexport type PVectorDataLong = BigInt64Array;\nexport type PVectorDataFloat = Float32Array;\nexport type PVectorDataDouble = Float64Array;\nexport type PVectorDataString = (null | string)[];\nexport type PVectorDataBytes = (null | Uint8Array)[];\nexport type PVectorDataTyped<DataType extends ValueType> = DataType extends typeof ValueType.Int\n  ? PVectorDataInt\n  : DataType extends typeof ValueType.Long\n    ? PVectorDataLong\n    : DataType extends typeof ValueType.Float\n      ? PVectorDataFloat\n      : DataType extends typeof ValueType.Double\n        ? PVectorDataDouble\n        : DataType extends typeof ValueType.String\n          ? PVectorDataString\n          : DataType extends typeof ValueType.Bytes\n            ? PVectorDataBytes\n            : never;\nexport type PVectorData = PVectorDataTyped<ValueType>;\n\nexport type PTableVectorTyped<DataType extends ValueType> = {\n  /** Stored data type */\n  readonly type: DataType;\n\n  /** Values for present positions */\n  readonly data: PVectorDataTyped<DataType>;\n\n  /**\n   * Encoded bit array marking some elements of this vector as NA,\n   * call {@link bitSet} to read the data.\n   * In old desktop versions NA values are encoded as magic values in data array.\n   * */\n  readonly isNA?: Uint8Array;\n\n  /** @deprecated Always empty. Kept for backwards compatibility with old blocks. */\n  readonly absent?: Uint8Array;\n};\n/** Table column data */\nexport type PTableVector = PTableVectorTyped<ValueType>;\n\nfunction isBitSet(bitVector: Uint8Array, offset: number): boolean {\n  const chunkIndex = Math.floor(offset / 8);\n  const mask = 1 << (7 - (offset % 8));\n  return (bitVector[chunkIndex] & mask) > 0;\n}\n\nexport function isValueNA(vector: PTableVector, row: number): boolean {\n  if (vector.isNA) return isBitSet(vector.isNA, row);\n\n  // Check for legacy magic values to support old desktop versions\n  const valueType = vector.type;\n  const value = vector.data[row];\n  switch (valueType) {\n    case ValueType.Int:\n      return (value as PVectorDataInt[number]) === -2147483648;\n    case ValueType.Long:\n      return (value as PVectorDataLong[number]) === -9007199254740991n;\n    case ValueType.Float:\n      return Number.isNaN(value as PVectorDataFloat[number]);\n    case ValueType.Double:\n      return Number.isNaN(value as PVectorDataDouble[number]);\n    case ValueType.String:\n      return (value as PVectorDataString[number]) === null;\n    case ValueType.Bytes:\n      return (value as PVectorDataBytes[number]) === null;\n    default:\n      throw Error(`unsupported data type: ${valueType satisfies never}`);\n  }\n}\n\nexport const PTableNA = null;\nexport type PTableNA = typeof PTableNA;\n\n/** Type guard for NA value */\nexport function isPTableNA(value: unknown): value is PTableNA {\n  return value === PTableNA;\n}\n\nexport type ValueTypeSupported = Exclude<ValueType, typeof ValueType.Bytes>;\n\nexport type PTableValueInt = number;\nexport type PTableValueLong = number;\nexport type PTableValueFloat = number;\nexport type PTableValueDouble = number;\nexport type PTableValueString = string;\nexport type PTableValueData<DataType extends ValueTypeSupported> =\n  DataType extends typeof ValueType.Int\n    ? PTableValueInt\n    : DataType extends typeof ValueType.Long\n      ? PTableValueLong\n      : DataType extends typeof ValueType.Float\n        ? PTableValueFloat\n        : DataType extends typeof ValueType.Double\n          ? PTableValueDouble\n          : DataType extends typeof ValueType.String\n            ? PTableValueString\n            : never;\nexport type PTableValueDataBranded<DataType extends ValueTypeSupported> = Branded<\n  PTableValueData<DataType>,\n  DataType\n>;\nexport type PTableValue<NA = PTableNA, DataType extends ValueTypeSupported = ValueTypeSupported> =\n  | NA\n  | PTableValueData<DataType>;\nexport type PTableValueBranded<\n  NA = PTableNA,\n  DataType extends ValueTypeSupported = ValueTypeSupported,\n> = NA | PTableValueDataBranded<DataType>;\n\nexport type PTableValueAxis<DataType extends ValueTypeSupported = ValueTypeSupported> =\n  PTableValueData<DataType>;\n\nfunction pTableValueImpl<FillNA = PTableNA, DataType extends ValueType = ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  const valueType = column.type;\n  if (valueType === ValueType.Bytes) {\n    throw Error(\"Bytes not yet supported\");\n  }\n\n  if (\n    options &&\n    \"dataType\" in options &&\n    options.dataType !== undefined &&\n    options.dataType !== valueType\n  ) {\n    throw Error(`expected column of type ${options.dataType}, got ${valueType}`);\n  }\n\n  if (isValueNA(column, row)) {\n    return options?.na !== undefined ? options.na : PTableNA;\n  }\n\n  const value = column.data[row]!;\n  switch (valueType) {\n    case ValueType.Int:\n      return value as PVectorDataInt[number];\n    case ValueType.Long:\n      return Number(value as PVectorDataLong[number]);\n    case ValueType.Float:\n      return value as PVectorDataFloat[number];\n    case ValueType.Double:\n      return value as PVectorDataDouble[number];\n    case ValueType.String:\n      return (value as PVectorDataString[number])!;\n  }\n}\n\n/** Read PTableValue from PTable column at specified row */\nexport function pTableValue<DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n): DataType extends ValueTypeSupported ? PTableValue<PTableNA, DataType> : never;\nexport function pTableValue<FillNA, DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n  options: {\n    na: FillNA;\n  },\n): DataType extends ValueTypeSupported ? PTableValue<FillNA, DataType> : never;\nexport function pTableValue<FillNA, DataType extends ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options: {\n    na: FillNA;\n    dataType: DataType;\n  },\n): PTableValue<FillNA, DataType>;\nexport function pTableValue<FillNA = PTableNA, DataType extends ValueType = ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  return pTableValueImpl(column, row, options);\n}\n\nexport function pTableValueBranded<DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n): DataType extends ValueTypeSupported ? PTableValueBranded<PTableNA, DataType> : never;\nexport function pTableValueBranded<FillNA, DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n  options: {\n    na: FillNA;\n  },\n): DataType extends ValueTypeSupported ? PTableValueBranded<FillNA, DataType> : never;\nexport function pTableValueBranded<FillNA, DataType extends ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options: {\n    na: FillNA;\n    dataType: DataType;\n  },\n): PTableValueBranded<FillNA, DataType>;\nexport function pTableValueBranded<\n  FillNA = PTableNA,\n  DataType extends ValueType = ValueTypeSupported,\n>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  return pTableValueImpl(column, row, options);\n}\n\n/** Used in requests to partially retrieve table's data */\nexport type TableRange = {\n  /** Index of the first record to retrieve */\n  readonly offset: number;\n\n  /** Block length */\n  readonly length: number;\n};\n\n/** Unified information about table shape */\nexport type PTableShape = {\n  /** Number of unified table columns, including all axes and PColumn values */\n  columns: number;\n\n  /** Number of rows */\n  rows: number;\n};\n\n/** Supported formats for PTable file download. */\nexport type PTableDownloadFormat = \"csv\" | \"tsv\";\n\n/** Compression applied to the written file. */\nexport type PTableDownloadCompression = \"none\" | \"gzip\";\n\n/** Options for downloading PTable data to a file. */\nexport interface WritePTableToFsOptions {\n  path: string;\n  format: PTableDownloadFormat;\n  columnIndices: number[];\n  range?: TableRange;\n  chunkSize?: number;\n  includeHeader?: boolean;\n  bom?: boolean;\n  compression?: {\n    type: \"gzip\";\n    level?: number;\n  };\n  signal?: AbortSignal;\n}\n\n/** Result of a PTable file download. */\nexport interface WritePTableToFsResult {\n  path: string;\n  rowsWritten: number;\n  bytesWritten: number;\n}\n\n/**\n * Maximum number of data rows allowed per sheet in an `xlsx` export, kept below\n * Excel's hard limit of 1,048,576. The driver rejects oversized `xlsx` exports\n * (see {@link PFrameDriver.exportPTable}); UIs use it to gate the `xlsx` option.\n */\nexport const XLSX_MAX_ROWS_PER_SHEET = 1_000_000;\n\n/** Options for {@link PFrameDriver.exportPTable}. */\nexport interface ExportPTableOptions {\n  /** Destination file path; its extension selects the output format\n   * (`csv`/`tsv`/`parquet`/`xlsx`). */\n  path: string;\n  /** Unified indices of the columns to export, in output order\n   * (axes first, then data columns). */\n  columnIndices: number[];\n}\n"],"mappings":";;AA4CA,SAAS,SAAS,WAAuB,QAAyB;CAChE,MAAM,aAAa,KAAK,MAAM,SAAS,EAAE;CACzC,MAAM,OAAO,KAAM,IAAK,SAAS;AACjC,SAAQ,UAAU,cAAc,QAAQ;;AAG1C,SAAgB,UAAU,QAAsB,KAAsB;AACpE,KAAI,OAAO,KAAM,QAAO,SAAS,OAAO,MAAM,IAAI;CAGlD,MAAM,YAAY,OAAO;CACzB,MAAM,QAAQ,OAAO,KAAK;AAC1B,SAAQ,WAAR;EACE,KAAKA,aAAAA,UAAU,IACb,QAAQ,UAAqC;EAC/C,KAAKA,aAAAA,UAAU,KACb,QAAQ,UAAsC,CAAC;EACjD,KAAKA,aAAAA,UAAU,MACb,QAAO,OAAO,MAAM,MAAkC;EACxD,KAAKA,aAAAA,UAAU,OACb,QAAO,OAAO,MAAM,MAAmC;EACzD,KAAKA,aAAAA,UAAU,OACb,QAAQ,UAAwC;EAClD,KAAKA,aAAAA,UAAU,MACb,QAAQ,UAAuC;EACjD,QACE,OAAM,MAAM,0BAA0B,YAA4B;;;AAIxE,MAAa,WAAW;;AAIxB,SAAgB,WAAW,OAAmC;AAC5D,QAAO,UAAA;;AAqCT,SAAS,gBACP,QACA,KACA,SAIA;CACA,MAAM,YAAY,OAAO;AACzB,KAAI,cAAcA,aAAAA,UAAU,MAC1B,OAAM,MAAM,0BAA0B;AAGxC,KACE,WACA,cAAc,WACd,QAAQ,aAAa,KAAA,KACrB,QAAQ,aAAa,UAErB,OAAM,MAAM,2BAA2B,QAAQ,SAAS,QAAQ,YAAY;AAG9E,KAAI,UAAU,QAAQ,IAAI,CACxB,QAAO,SAAS,OAAO,KAAA,IAAY,QAAQ,KAAA;CAG7C,MAAM,QAAQ,OAAO,KAAK;AAC1B,SAAQ,WAAR;EACE,KAAKA,aAAAA,UAAU,IACb,QAAO;EACT,KAAKA,aAAAA,UAAU,KACb,QAAO,OAAO,MAAiC;EACjD,KAAKA,aAAAA,UAAU,MACb,QAAO;EACT,KAAKA,aAAAA,UAAU,OACb,QAAO;EACT,KAAKA,aAAAA,UAAU,OACb,QAAQ;;;AAwBd,SAAgB,YACd,QACA,KACA,SAIA;AACA,QAAO,gBAAgB,QAAQ,KAAK,QAAQ;;AAsB9C,SAAgB,mBAId,QACA,KACA,SAIA;AACA,QAAO,gBAAgB,QAAQ,KAAK,QAAQ;;;;;;;AAuD9C,MAAa,0BAA0B"}

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

@@ -91,6 +91,12 @@ interface WritePTableToFsResult {
   rowsWritten: number;
   bytesWritten: number;
 }
+/**
+ * Maximum number of data rows allowed per sheet in an `xlsx` export, kept below
+ * Excel's hard limit of 1,048,576. The driver rejects oversized `xlsx` exports
+ * (see {@link PFrameDriver.exportPTable}); UIs use it to gate the `xlsx` option.
+ */
+declare const XLSX_MAX_ROWS_PER_SHEET = 1000000;
 /** Options for {@link PFrameDriver.exportPTable}. */
 interface ExportPTableOptions {
   /** Destination file path; its extension selects the output format
@@ -101,5 +107,5 @@ interface ExportPTableOptions {
   columnIndices: number[];
 }
 //#endregion
-export { 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, isPTableNA, isValueNA, pTableValue, pTableValueBranded };
+export { 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 };
 //# sourceMappingURL=data_types.d.ts.map

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

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

package/dist/drivers/pframe/data_types.js

@@ -44,7 +44,13 @@ function pTableValue(column, row, options) {
 function pTableValueBranded(column, row, options) {
 	return pTableValueImpl(column, row, options);
 }
+/**
+* Maximum number of data rows allowed per sheet in an `xlsx` export, kept below
+* Excel's hard limit of 1,048,576. The driver rejects oversized `xlsx` exports
+* (see {@link PFrameDriver.exportPTable}); UIs use it to gate the `xlsx` option.
+*/
+const XLSX_MAX_ROWS_PER_SHEET = 1e6;
 //#endregion
-export { PTableNA, isPTableNA, isValueNA, pTableValue, pTableValueBranded };
+export { PTableNA, XLSX_MAX_ROWS_PER_SHEET, isPTableNA, isValueNA, pTableValue, pTableValueBranded };
 
 //# sourceMappingURL=data_types.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"data_types.js","names":[],"sources":["../../../src/drivers/pframe/data_types.ts"],"sourcesContent":["import type { Branded } from \"../../branding\";\nimport { ValueType } from \"./spec/spec\";\n\nexport type PVectorDataInt = Int32Array;\nexport type PVectorDataLong = BigInt64Array;\nexport type PVectorDataFloat = Float32Array;\nexport type PVectorDataDouble = Float64Array;\nexport type PVectorDataString = (null | string)[];\nexport type PVectorDataBytes = (null | Uint8Array)[];\nexport type PVectorDataTyped<DataType extends ValueType> = DataType extends typeof ValueType.Int\n  ? PVectorDataInt\n  : DataType extends typeof ValueType.Long\n    ? PVectorDataLong\n    : DataType extends typeof ValueType.Float\n      ? PVectorDataFloat\n      : DataType extends typeof ValueType.Double\n        ? PVectorDataDouble\n        : DataType extends typeof ValueType.String\n          ? PVectorDataString\n          : DataType extends typeof ValueType.Bytes\n            ? PVectorDataBytes\n            : never;\nexport type PVectorData = PVectorDataTyped<ValueType>;\n\nexport type PTableVectorTyped<DataType extends ValueType> = {\n  /** Stored data type */\n  readonly type: DataType;\n\n  /** Values for present positions */\n  readonly data: PVectorDataTyped<DataType>;\n\n  /**\n   * Encoded bit array marking some elements of this vector as NA,\n   * call {@link bitSet} to read the data.\n   * In old desktop versions NA values are encoded as magic values in data array.\n   * */\n  readonly isNA?: Uint8Array;\n\n  /** @deprecated Always empty. Kept for backwards compatibility with old blocks. */\n  readonly absent?: Uint8Array;\n};\n/** Table column data */\nexport type PTableVector = PTableVectorTyped<ValueType>;\n\nfunction isBitSet(bitVector: Uint8Array, offset: number): boolean {\n  const chunkIndex = Math.floor(offset / 8);\n  const mask = 1 << (7 - (offset % 8));\n  return (bitVector[chunkIndex] & mask) > 0;\n}\n\nexport function isValueNA(vector: PTableVector, row: number): boolean {\n  if (vector.isNA) return isBitSet(vector.isNA, row);\n\n  // Check for legacy magic values to support old desktop versions\n  const valueType = vector.type;\n  const value = vector.data[row];\n  switch (valueType) {\n    case ValueType.Int:\n      return (value as PVectorDataInt[number]) === -2147483648;\n    case ValueType.Long:\n      return (value as PVectorDataLong[number]) === -9007199254740991n;\n    case ValueType.Float:\n      return Number.isNaN(value as PVectorDataFloat[number]);\n    case ValueType.Double:\n      return Number.isNaN(value as PVectorDataDouble[number]);\n    case ValueType.String:\n      return (value as PVectorDataString[number]) === null;\n    case ValueType.Bytes:\n      return (value as PVectorDataBytes[number]) === null;\n    default:\n      throw Error(`unsupported data type: ${valueType satisfies never}`);\n  }\n}\n\nexport const PTableNA = null;\nexport type PTableNA = typeof PTableNA;\n\n/** Type guard for NA value */\nexport function isPTableNA(value: unknown): value is PTableNA {\n  return value === PTableNA;\n}\n\nexport type ValueTypeSupported = Exclude<ValueType, typeof ValueType.Bytes>;\n\nexport type PTableValueInt = number;\nexport type PTableValueLong = number;\nexport type PTableValueFloat = number;\nexport type PTableValueDouble = number;\nexport type PTableValueString = string;\nexport type PTableValueData<DataType extends ValueTypeSupported> =\n  DataType extends typeof ValueType.Int\n    ? PTableValueInt\n    : DataType extends typeof ValueType.Long\n      ? PTableValueLong\n      : DataType extends typeof ValueType.Float\n        ? PTableValueFloat\n        : DataType extends typeof ValueType.Double\n          ? PTableValueDouble\n          : DataType extends typeof ValueType.String\n            ? PTableValueString\n            : never;\nexport type PTableValueDataBranded<DataType extends ValueTypeSupported> = Branded<\n  PTableValueData<DataType>,\n  DataType\n>;\nexport type PTableValue<NA = PTableNA, DataType extends ValueTypeSupported = ValueTypeSupported> =\n  | NA\n  | PTableValueData<DataType>;\nexport type PTableValueBranded<\n  NA = PTableNA,\n  DataType extends ValueTypeSupported = ValueTypeSupported,\n> = NA | PTableValueDataBranded<DataType>;\n\nexport type PTableValueAxis<DataType extends ValueTypeSupported = ValueTypeSupported> =\n  PTableValueData<DataType>;\n\nfunction pTableValueImpl<FillNA = PTableNA, DataType extends ValueType = ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  const valueType = column.type;\n  if (valueType === ValueType.Bytes) {\n    throw Error(\"Bytes not yet supported\");\n  }\n\n  if (\n    options &&\n    \"dataType\" in options &&\n    options.dataType !== undefined &&\n    options.dataType !== valueType\n  ) {\n    throw Error(`expected column of type ${options.dataType}, got ${valueType}`);\n  }\n\n  if (isValueNA(column, row)) {\n    return options?.na !== undefined ? options.na : PTableNA;\n  }\n\n  const value = column.data[row]!;\n  switch (valueType) {\n    case ValueType.Int:\n      return value as PVectorDataInt[number];\n    case ValueType.Long:\n      return Number(value as PVectorDataLong[number]);\n    case ValueType.Float:\n      return value as PVectorDataFloat[number];\n    case ValueType.Double:\n      return value as PVectorDataDouble[number];\n    case ValueType.String:\n      return (value as PVectorDataString[number])!;\n  }\n}\n\n/** Read PTableValue from PTable column at specified row */\nexport function pTableValue<DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n): DataType extends ValueTypeSupported ? PTableValue<PTableNA, DataType> : never;\nexport function pTableValue<FillNA, DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n  options: {\n    na: FillNA;\n  },\n): DataType extends ValueTypeSupported ? PTableValue<FillNA, DataType> : never;\nexport function pTableValue<FillNA, DataType extends ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options: {\n    na: FillNA;\n    dataType: DataType;\n  },\n): PTableValue<FillNA, DataType>;\nexport function pTableValue<FillNA = PTableNA, DataType extends ValueType = ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  return pTableValueImpl(column, row, options);\n}\n\nexport function pTableValueBranded<DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n): DataType extends ValueTypeSupported ? PTableValueBranded<PTableNA, DataType> : never;\nexport function pTableValueBranded<FillNA, DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n  options: {\n    na: FillNA;\n  },\n): DataType extends ValueTypeSupported ? PTableValueBranded<FillNA, DataType> : never;\nexport function pTableValueBranded<FillNA, DataType extends ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options: {\n    na: FillNA;\n    dataType: DataType;\n  },\n): PTableValueBranded<FillNA, DataType>;\nexport function pTableValueBranded<\n  FillNA = PTableNA,\n  DataType extends ValueType = ValueTypeSupported,\n>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  return pTableValueImpl(column, row, options);\n}\n\n/** Used in requests to partially retrieve table's data */\nexport type TableRange = {\n  /** Index of the first record to retrieve */\n  readonly offset: number;\n\n  /** Block length */\n  readonly length: number;\n};\n\n/** Unified information about table shape */\nexport type PTableShape = {\n  /** Number of unified table columns, including all axes and PColumn values */\n  columns: number;\n\n  /** Number of rows */\n  rows: number;\n};\n\n/** Supported formats for PTable file download. */\nexport type PTableDownloadFormat = \"csv\" | \"tsv\";\n\n/** Compression applied to the written file. */\nexport type PTableDownloadCompression = \"none\" | \"gzip\";\n\n/** Options for downloading PTable data to a file. */\nexport interface WritePTableToFsOptions {\n  path: string;\n  format: PTableDownloadFormat;\n  columnIndices: number[];\n  range?: TableRange;\n  chunkSize?: number;\n  includeHeader?: boolean;\n  bom?: boolean;\n  compression?: {\n    type: \"gzip\";\n    level?: number;\n  };\n  signal?: AbortSignal;\n}\n\n/** Result of a PTable file download. */\nexport interface WritePTableToFsResult {\n  path: string;\n  rowsWritten: number;\n  bytesWritten: number;\n}\n\n/** Options for {@link PFrameDriver.exportPTable}. */\nexport interface ExportPTableOptions {\n  /** Destination file path; its extension selects the output format\n   * (`csv`/`tsv`/`parquet`/`xlsx`). */\n  path: string;\n  /** Unified indices of the columns to export, in output order\n   * (axes first, then data columns). */\n  columnIndices: number[];\n}\n"],"mappings":";;AA4CA,SAAS,SAAS,WAAuB,QAAyB;CAChE,MAAM,aAAa,KAAK,MAAM,SAAS,EAAE;CACzC,MAAM,OAAO,KAAM,IAAK,SAAS;AACjC,SAAQ,UAAU,cAAc,QAAQ;;AAG1C,SAAgB,UAAU,QAAsB,KAAsB;AACpE,KAAI,OAAO,KAAM,QAAO,SAAS,OAAO,MAAM,IAAI;CAGlD,MAAM,YAAY,OAAO;CACzB,MAAM,QAAQ,OAAO,KAAK;AAC1B,SAAQ,WAAR;EACE,KAAK,UAAU,IACb,QAAQ,UAAqC;EAC/C,KAAK,UAAU,KACb,QAAQ,UAAsC,CAAC;EACjD,KAAK,UAAU,MACb,QAAO,OAAO,MAAM,MAAkC;EACxD,KAAK,UAAU,OACb,QAAO,OAAO,MAAM,MAAmC;EACzD,KAAK,UAAU,OACb,QAAQ,UAAwC;EAClD,KAAK,UAAU,MACb,QAAQ,UAAuC;EACjD,QACE,OAAM,MAAM,0BAA0B,YAA4B;;;AAIxE,MAAa,WAAW;;AAIxB,SAAgB,WAAW,OAAmC;AAC5D,QAAO,UAAA;;AAqCT,SAAS,gBACP,QACA,KACA,SAIA;CACA,MAAM,YAAY,OAAO;AACzB,KAAI,cAAc,UAAU,MAC1B,OAAM,MAAM,0BAA0B;AAGxC,KACE,WACA,cAAc,WACd,QAAQ,aAAa,KAAA,KACrB,QAAQ,aAAa,UAErB,OAAM,MAAM,2BAA2B,QAAQ,SAAS,QAAQ,YAAY;AAG9E,KAAI,UAAU,QAAQ,IAAI,CACxB,QAAO,SAAS,OAAO,KAAA,IAAY,QAAQ,KAAA;CAG7C,MAAM,QAAQ,OAAO,KAAK;AAC1B,SAAQ,WAAR;EACE,KAAK,UAAU,IACb,QAAO;EACT,KAAK,UAAU,KACb,QAAO,OAAO,MAAiC;EACjD,KAAK,UAAU,MACb,QAAO;EACT,KAAK,UAAU,OACb,QAAO;EACT,KAAK,UAAU,OACb,QAAQ;;;AAwBd,SAAgB,YACd,QACA,KACA,SAIA;AACA,QAAO,gBAAgB,QAAQ,KAAK,QAAQ;;AAsB9C,SAAgB,mBAId,QACA,KACA,SAIA;AACA,QAAO,gBAAgB,QAAQ,KAAK,QAAQ"}
+{"version":3,"file":"data_types.js","names":[],"sources":["../../../src/drivers/pframe/data_types.ts"],"sourcesContent":["import type { Branded } from \"../../branding\";\nimport { ValueType } from \"./spec/spec\";\n\nexport type PVectorDataInt = Int32Array;\nexport type PVectorDataLong = BigInt64Array;\nexport type PVectorDataFloat = Float32Array;\nexport type PVectorDataDouble = Float64Array;\nexport type PVectorDataString = (null | string)[];\nexport type PVectorDataBytes = (null | Uint8Array)[];\nexport type PVectorDataTyped<DataType extends ValueType> = DataType extends typeof ValueType.Int\n  ? PVectorDataInt\n  : DataType extends typeof ValueType.Long\n    ? PVectorDataLong\n    : DataType extends typeof ValueType.Float\n      ? PVectorDataFloat\n      : DataType extends typeof ValueType.Double\n        ? PVectorDataDouble\n        : DataType extends typeof ValueType.String\n          ? PVectorDataString\n          : DataType extends typeof ValueType.Bytes\n            ? PVectorDataBytes\n            : never;\nexport type PVectorData = PVectorDataTyped<ValueType>;\n\nexport type PTableVectorTyped<DataType extends ValueType> = {\n  /** Stored data type */\n  readonly type: DataType;\n\n  /** Values for present positions */\n  readonly data: PVectorDataTyped<DataType>;\n\n  /**\n   * Encoded bit array marking some elements of this vector as NA,\n   * call {@link bitSet} to read the data.\n   * In old desktop versions NA values are encoded as magic values in data array.\n   * */\n  readonly isNA?: Uint8Array;\n\n  /** @deprecated Always empty. Kept for backwards compatibility with old blocks. */\n  readonly absent?: Uint8Array;\n};\n/** Table column data */\nexport type PTableVector = PTableVectorTyped<ValueType>;\n\nfunction isBitSet(bitVector: Uint8Array, offset: number): boolean {\n  const chunkIndex = Math.floor(offset / 8);\n  const mask = 1 << (7 - (offset % 8));\n  return (bitVector[chunkIndex] & mask) > 0;\n}\n\nexport function isValueNA(vector: PTableVector, row: number): boolean {\n  if (vector.isNA) return isBitSet(vector.isNA, row);\n\n  // Check for legacy magic values to support old desktop versions\n  const valueType = vector.type;\n  const value = vector.data[row];\n  switch (valueType) {\n    case ValueType.Int:\n      return (value as PVectorDataInt[number]) === -2147483648;\n    case ValueType.Long:\n      return (value as PVectorDataLong[number]) === -9007199254740991n;\n    case ValueType.Float:\n      return Number.isNaN(value as PVectorDataFloat[number]);\n    case ValueType.Double:\n      return Number.isNaN(value as PVectorDataDouble[number]);\n    case ValueType.String:\n      return (value as PVectorDataString[number]) === null;\n    case ValueType.Bytes:\n      return (value as PVectorDataBytes[number]) === null;\n    default:\n      throw Error(`unsupported data type: ${valueType satisfies never}`);\n  }\n}\n\nexport const PTableNA = null;\nexport type PTableNA = typeof PTableNA;\n\n/** Type guard for NA value */\nexport function isPTableNA(value: unknown): value is PTableNA {\n  return value === PTableNA;\n}\n\nexport type ValueTypeSupported = Exclude<ValueType, typeof ValueType.Bytes>;\n\nexport type PTableValueInt = number;\nexport type PTableValueLong = number;\nexport type PTableValueFloat = number;\nexport type PTableValueDouble = number;\nexport type PTableValueString = string;\nexport type PTableValueData<DataType extends ValueTypeSupported> =\n  DataType extends typeof ValueType.Int\n    ? PTableValueInt\n    : DataType extends typeof ValueType.Long\n      ? PTableValueLong\n      : DataType extends typeof ValueType.Float\n        ? PTableValueFloat\n        : DataType extends typeof ValueType.Double\n          ? PTableValueDouble\n          : DataType extends typeof ValueType.String\n            ? PTableValueString\n            : never;\nexport type PTableValueDataBranded<DataType extends ValueTypeSupported> = Branded<\n  PTableValueData<DataType>,\n  DataType\n>;\nexport type PTableValue<NA = PTableNA, DataType extends ValueTypeSupported = ValueTypeSupported> =\n  | NA\n  | PTableValueData<DataType>;\nexport type PTableValueBranded<\n  NA = PTableNA,\n  DataType extends ValueTypeSupported = ValueTypeSupported,\n> = NA | PTableValueDataBranded<DataType>;\n\nexport type PTableValueAxis<DataType extends ValueTypeSupported = ValueTypeSupported> =\n  PTableValueData<DataType>;\n\nfunction pTableValueImpl<FillNA = PTableNA, DataType extends ValueType = ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  const valueType = column.type;\n  if (valueType === ValueType.Bytes) {\n    throw Error(\"Bytes not yet supported\");\n  }\n\n  if (\n    options &&\n    \"dataType\" in options &&\n    options.dataType !== undefined &&\n    options.dataType !== valueType\n  ) {\n    throw Error(`expected column of type ${options.dataType}, got ${valueType}`);\n  }\n\n  if (isValueNA(column, row)) {\n    return options?.na !== undefined ? options.na : PTableNA;\n  }\n\n  const value = column.data[row]!;\n  switch (valueType) {\n    case ValueType.Int:\n      return value as PVectorDataInt[number];\n    case ValueType.Long:\n      return Number(value as PVectorDataLong[number]);\n    case ValueType.Float:\n      return value as PVectorDataFloat[number];\n    case ValueType.Double:\n      return value as PVectorDataDouble[number];\n    case ValueType.String:\n      return (value as PVectorDataString[number])!;\n  }\n}\n\n/** Read PTableValue from PTable column at specified row */\nexport function pTableValue<DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n): DataType extends ValueTypeSupported ? PTableValue<PTableNA, DataType> : never;\nexport function pTableValue<FillNA, DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n  options: {\n    na: FillNA;\n  },\n): DataType extends ValueTypeSupported ? PTableValue<FillNA, DataType> : never;\nexport function pTableValue<FillNA, DataType extends ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options: {\n    na: FillNA;\n    dataType: DataType;\n  },\n): PTableValue<FillNA, DataType>;\nexport function pTableValue<FillNA = PTableNA, DataType extends ValueType = ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  return pTableValueImpl(column, row, options);\n}\n\nexport function pTableValueBranded<DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n): DataType extends ValueTypeSupported ? PTableValueBranded<PTableNA, DataType> : never;\nexport function pTableValueBranded<FillNA, DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n  options: {\n    na: FillNA;\n  },\n): DataType extends ValueTypeSupported ? PTableValueBranded<FillNA, DataType> : never;\nexport function pTableValueBranded<FillNA, DataType extends ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options: {\n    na: FillNA;\n    dataType: DataType;\n  },\n): PTableValueBranded<FillNA, DataType>;\nexport function pTableValueBranded<\n  FillNA = PTableNA,\n  DataType extends ValueType = ValueTypeSupported,\n>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  return pTableValueImpl(column, row, options);\n}\n\n/** Used in requests to partially retrieve table's data */\nexport type TableRange = {\n  /** Index of the first record to retrieve */\n  readonly offset: number;\n\n  /** Block length */\n  readonly length: number;\n};\n\n/** Unified information about table shape */\nexport type PTableShape = {\n  /** Number of unified table columns, including all axes and PColumn values */\n  columns: number;\n\n  /** Number of rows */\n  rows: number;\n};\n\n/** Supported formats for PTable file download. */\nexport type PTableDownloadFormat = \"csv\" | \"tsv\";\n\n/** Compression applied to the written file. */\nexport type PTableDownloadCompression = \"none\" | \"gzip\";\n\n/** Options for downloading PTable data to a file. */\nexport interface WritePTableToFsOptions {\n  path: string;\n  format: PTableDownloadFormat;\n  columnIndices: number[];\n  range?: TableRange;\n  chunkSize?: number;\n  includeHeader?: boolean;\n  bom?: boolean;\n  compression?: {\n    type: \"gzip\";\n    level?: number;\n  };\n  signal?: AbortSignal;\n}\n\n/** Result of a PTable file download. */\nexport interface WritePTableToFsResult {\n  path: string;\n  rowsWritten: number;\n  bytesWritten: number;\n}\n\n/**\n * Maximum number of data rows allowed per sheet in an `xlsx` export, kept below\n * Excel's hard limit of 1,048,576. The driver rejects oversized `xlsx` exports\n * (see {@link PFrameDriver.exportPTable}); UIs use it to gate the `xlsx` option.\n */\nexport const XLSX_MAX_ROWS_PER_SHEET = 1_000_000;\n\n/** Options for {@link PFrameDriver.exportPTable}. */\nexport interface ExportPTableOptions {\n  /** Destination file path; its extension selects the output format\n   * (`csv`/`tsv`/`parquet`/`xlsx`). */\n  path: string;\n  /** Unified indices of the columns to export, in output order\n   * (axes first, then data columns). */\n  columnIndices: number[];\n}\n"],"mappings":";;AA4CA,SAAS,SAAS,WAAuB,QAAyB;CAChE,MAAM,aAAa,KAAK,MAAM,SAAS,EAAE;CACzC,MAAM,OAAO,KAAM,IAAK,SAAS;AACjC,SAAQ,UAAU,cAAc,QAAQ;;AAG1C,SAAgB,UAAU,QAAsB,KAAsB;AACpE,KAAI,OAAO,KAAM,QAAO,SAAS,OAAO,MAAM,IAAI;CAGlD,MAAM,YAAY,OAAO;CACzB,MAAM,QAAQ,OAAO,KAAK;AAC1B,SAAQ,WAAR;EACE,KAAK,UAAU,IACb,QAAQ,UAAqC;EAC/C,KAAK,UAAU,KACb,QAAQ,UAAsC,CAAC;EACjD,KAAK,UAAU,MACb,QAAO,OAAO,MAAM,MAAkC;EACxD,KAAK,UAAU,OACb,QAAO,OAAO,MAAM,MAAmC;EACzD,KAAK,UAAU,OACb,QAAQ,UAAwC;EAClD,KAAK,UAAU,MACb,QAAQ,UAAuC;EACjD,QACE,OAAM,MAAM,0BAA0B,YAA4B;;;AAIxE,MAAa,WAAW;;AAIxB,SAAgB,WAAW,OAAmC;AAC5D,QAAO,UAAA;;AAqCT,SAAS,gBACP,QACA,KACA,SAIA;CACA,MAAM,YAAY,OAAO;AACzB,KAAI,cAAc,UAAU,MAC1B,OAAM,MAAM,0BAA0B;AAGxC,KACE,WACA,cAAc,WACd,QAAQ,aAAa,KAAA,KACrB,QAAQ,aAAa,UAErB,OAAM,MAAM,2BAA2B,QAAQ,SAAS,QAAQ,YAAY;AAG9E,KAAI,UAAU,QAAQ,IAAI,CACxB,QAAO,SAAS,OAAO,KAAA,IAAY,QAAQ,KAAA;CAG7C,MAAM,QAAQ,OAAO,KAAK;AAC1B,SAAQ,WAAR;EACE,KAAK,UAAU,IACb,QAAO;EACT,KAAK,UAAU,KACb,QAAO,OAAO,MAAiC;EACjD,KAAK,UAAU,MACb,QAAO;EACT,KAAK,UAAU,OACb,QAAO;EACT,KAAK,UAAU,OACb,QAAQ;;;AAwBd,SAAgB,YACd,QACA,KACA,SAIA;AACA,QAAO,gBAAgB,QAAQ,KAAK,QAAQ;;AAsB9C,SAAgB,mBAId,QACA,KACA,SAIA;AACA,QAAO,gBAAgB,QAAQ,KAAK,QAAQ;;;;;;;AAuD9C,MAAa,0BAA0B"}

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

@@ -1,11 +1,11 @@
 import { AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, FilteredPColumn, FilteredPColumnId, isFilteredPColumn } from "./spec/filtered_column.js";
 import { DiscoveredPColumn, DiscoveredPColumnId, createDiscoveredPColumnId, distillDiscoveredPColumn, isDiscoveredPColumn, parseDiscoveredPColumnId, stringifyDiscoveredPColumnId } from "./spec/discovered_column.js";
 import { SUniversalPColumnId, UniversalPColumnId, parseColumnId, stringifyColumnId } from "./spec/ids.js";
-import { Annotation, AnnotationDataStatus, AnnotationJson, AxesId, AxesSpec, AxisId, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, ColumnValueType, Domain, DomainJson, Metadata, MetadataJson, PAxisName, PColumn, PColumnIdAndSpec, PColumnInfo, PColumnLazy, PColumnName, PColumnSpec, PColumnSpecId, PDataColumnSpec, PUniversalColumnSpec, Trace, TraceEntry, ValueType, canonicalizeAxisId, canonicalizeAxisWithParents, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAxisId, isLabelColumn, isLinkerColumn, matchAxisId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, resolveAnnotationParents } from "./spec/spec.js";
+import { Annotation, AnnotationDataStatus, AnnotationJson, AxesId, AxesSpec, AxisId, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, ColumnValueType, Domain, DomainJson, Metadata, MetadataJson, PAxisName, PColumn, PColumnIdAndSpec, PColumnLazy, PColumnName, PColumnSpec, PColumnSpecId, PDataColumnSpec, PUniversalColumnSpec, Trace, TraceEntry, ValueType, canonicalizeAxisId, canonicalizeAxisWithParents, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAxisId, isLabelColumn, isLinkerColumn, matchAxisId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, resolveAnnotationParents } from "./spec/spec.js";
 import { AnchoredIdDeriver, ResolveAnchorsOptions, resolveAnchors } from "./spec/anchored.js";
 import { NativePObjectId, deriveNativeId } from "./spec/native_id.js";
 import { PTableColumnId, PTableColumnIdAxis, PTableColumnIdColumn, PTableColumnSpec, PTableColumnSpecAxis, PTableColumnSpecColumn, getPTableColumnId } from "./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, isPTableNA, isValueNA, pTableValue, pTableValueBranded } from "./data_types.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 "./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 "./data_info.js";
 import { SpecExprAxisRef, SpecExprColumnRef, SpecQuery, SpecQueryBooleanExpression, SpecQueryColumn, SpecQueryExpression, SpecQueryFilter, SpecQueryInlineColumn, SpecQueryJoinEntry, SpecQueryLinkerJoin, SpecQueryLinkerJoinLinker, SpecQueryOuterJoin, SpecQuerySliceAxes, SpecQuerySort, SpecQuerySparseToDenseColumn, SpecQuerySymmetricJoin, SpecQueryTransformColumns } from "./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 "./table_calculate.js";

package/dist/drivers/pframe/query/query_common.d.ts

@@ -3,14 +3,13 @@ import { JsonDataInfo } from "../data_info.js";
 import { PObjectId } from "../../../pool/spec.js";
 //#region src/drivers/pframe/query/query_common.d.ts
 /**
- * Specification of column/frame structure.
- *
- * Defines the shape of data: which axes (dimensions) the data has
- * and what value types are stored in columns.
+ * Structural type information for a single column: the axis value types (in
+ * order) and the single column value type. Mirrors the self-contained
+ * `typeSpec` shape carried by the data layer (`{ axes, column }`).
  */
-type TypeSpec = {
-  /** List of axis value types defining the dimensions of the data */axes: AxisValueType[]; /** List of column value types defining the data stored */
-  columns: ColumnValueType[];
+type ColumnTypeSpec = {
+  /** List of axis value types defining the dimensions of the data */axes: AxisValueType[]; /** The single column value type */
+  column: ColumnValueType;
 };
 /**
  * Unary mathematical operation kinds.
@@ -1025,5 +1024,5 @@ interface QueryTransformColumns<Q, E, SO> {
   columns: [TransformColumnEntry<E, SO>, ...TransformColumnEntry<E, SO>[]];
 }
 //#endregion
-export { ExprAxisRef, ExprCast, ExprColumnRef, ExprConditional, ExprConstant, ExprFillNull, ExprIsIn, ExprIsNull, ExprLogicalUnary, ExprLogicalVariadic, ExprNumericBinary, ExprNumericComparison, ExprNumericUnary, ExprRanking, ExprStringContains, ExprStringContainsFuzzy, ExprStringEquals, ExprStringRegex, InferBooleanExpressionUnion, QueryColumn, QueryFilter, QueryInlineColumn, QueryJoinEntry, QueryLinkerJoin, QueryOuterJoin, QuerySliceAxes, QuerySort, QuerySparseToDenseColumn, QuerySymmetricJoin, QueryTransformColumns, TypeSpec };
+export { ColumnTypeSpec, ExprAxisRef, ExprCast, ExprColumnRef, ExprConditional, ExprConstant, ExprFillNull, ExprIsIn, ExprIsNull, ExprLogicalUnary, ExprLogicalVariadic, ExprNumericBinary, ExprNumericComparison, ExprNumericUnary, ExprRanking, ExprStringContains, ExprStringContainsFuzzy, ExprStringEquals, ExprStringRegex, InferBooleanExpressionUnion, QueryColumn, QueryFilter, QueryInlineColumn, QueryJoinEntry, QueryLinkerJoin, QueryOuterJoin, QuerySliceAxes, QuerySort, QuerySparseToDenseColumn, QuerySymmetricJoin, QueryTransformColumns };
 //# sourceMappingURL=query_common.d.ts.map

package/dist/drivers/pframe/query/query_common.d.ts.map

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

package/dist/drivers/pframe/query/query_data.d.ts

@@ -1,4 +1,4 @@
-import { ExprAxisRef, ExprCast, ExprColumnRef, ExprConditional, ExprConstant, ExprFillNull, ExprIsIn, ExprIsNull, ExprLogicalUnary, ExprLogicalVariadic, ExprNumericBinary, ExprNumericComparison, ExprNumericUnary, ExprRanking, ExprStringContains, ExprStringContainsFuzzy, ExprStringEquals, ExprStringRegex, InferBooleanExpressionUnion, QueryColumn, QueryFilter, QueryInlineColumn, QueryJoinEntry, QueryLinkerJoin, QueryOuterJoin, QuerySliceAxes, QuerySort, QuerySparseToDenseColumn, QuerySymmetricJoin, QueryTransformColumns, TypeSpec } from "./query_common.js";
+import { ColumnTypeSpec, ExprAxisRef, ExprCast, ExprColumnRef, ExprConditional, ExprConstant, ExprFillNull, ExprIsIn, ExprIsNull, ExprLogicalUnary, ExprLogicalVariadic, ExprNumericBinary, ExprNumericComparison, ExprNumericUnary, ExprRanking, ExprStringContains, ExprStringContainsFuzzy, ExprStringEquals, ExprStringRegex, InferBooleanExpressionUnion, QueryColumn, QueryFilter, QueryInlineColumn, QueryJoinEntry, QueryLinkerJoin, QueryOuterJoin, QuerySliceAxes, QuerySort, QuerySparseToDenseColumn, QuerySymmetricJoin, QueryTransformColumns } from "./query_common.js";
 import { PObjectId } from "../../../pool/spec.js";
 //#region src/drivers/pframe/query/query_data.d.ts
 /**
@@ -8,8 +8,8 @@ import { PObjectId } from "../../../pool/spec.js";
  * Used in data layer to carry type information alongside column references.
  */
 type ColumnIdAndTypeSpec = {
-  /** Unique identifier of the column */id: PObjectId; /** Type specification defining axes and column types */
-  spec: TypeSpec;
+  /** Unique identifier of the column */id: PObjectId; /** Type specification defining the axes and the single column value type */
+  spec: ColumnTypeSpec;
 };
 /**
  * Join entry for data layer queries.

package/dist/drivers/pframe/query/query_data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query_data.d.ts","names":[],"sources":["../../../../src/drivers/pframe/query/query_data.ts"],"mappings":";;;;;;AAiCwB;;;KAQnB,mBAAA;EAEH,sCAAA,EAAA,EAAI,SAAA,EAEJ;EAAA,IAAA,EAAM,QAAA;AAAA;;AAeR;;;;;;;;;AAMA;;UANiB,kBAAA,SAA2B,cAAA,CAAe,SAAA;EAM7B;EAJ5B,WAAA;AAAA;;KAIU,eAAA,GAAkB,WAAA;;KAElB,qBAAA,GAAwB,iBAAA,CAAkB,mBAAA;AAEtD;AAAA,KAAY,4BAAA,GAA+B,wBAAA,CACzC,SAAA,UAEA,mBAAA;;KAGU,sBAAA,GAAyB,kBAAA,CAAmB,kBAAA;;KAE5C,kBAAA,GAAqB,cAAA,CAAe,kBAAA;;;;;;;;AAFhD;KAWY,yBAAA;iCAEV,MAAA,EAAQ,SAAA,EAbgE;EAexE,WAAA,YAb4B;EAe5B,kBAAA;AAAA;;KAGU,mBAAA,GAAsB,eAAA,CAAgB,yBAAA,EAA2B,kBAAA;;KAEjE,kBAAA,GAAqB,cAAA,CAAe,SAAA;;KAEpC,aAAA,GAAgB,SAAA,CAAU,SAAA,EAAW,mBAAA;;KAErC,eAAA,GAAkB,WAAA,CAAY,SAAA,EAAW,0BAAA;;KAEzC,yBAAA,GAA4B,qBAAA,CACtC,SAAA,EACA,mBAAA,EACA,mBAAA;;AAXF;;;;;;;;;;KAyBY,SAAA,GACR,eAAA,GACA,qBAAA,GACA,4BAAA,GACA,sBAAA,GACA,kBAAA,GACA,mBAAA,GACA,kBAAA,GACA,aAAA,GACA,eAAA,GACA,yBAAA;;KAGQ,eAAA,GAAkB,WAAA;AApC9B;AAAA,KAsCY,iBAAA,GAAoB,aAAA;AAAA,KAEpB,mBAAA,GACR,iBAAA,GACA,eAAA,GACA,YAAA,GACA,iBAAA,CAAkB,mBAAA,IAClB,qBAAA,CAAsB,mBAAA,IACtB,gBAAA,CAAiB,mBAAA,IACjB,gBAAA,CAAiB,mBAAA,IACjB,kBAAA,CAAmB,mBAAA,IACnB,eAAA,CAAgB,mBAAA,IAChB,uBAAA,CAAwB,mBAAA,IACxB,UAAA,CAAW,mBAAA,IACX,YAAA,CAAa,mBAAA,IACb,gBAAA,CAAiB,mBAAA,IACjB,mBAAA,CAAoB,mBAAA,IACpB,QAAA,CAAS,mBAAA,YACT,QAAA,CAAS,mBAAA,YAET,QAAA,CAAS,mBAAA,IACT,eAAA,CAAgB,mBAAA,IAEhB,WAAA,CAAY,mBAAA;AAAA,KAGJ,0BAAA,GAA6B,2BAAA,CAA4B,mBAAA"}
+{"version":3,"file":"query_data.d.ts","names":[],"sources":["../../../../src/drivers/pframe/query/query_data.ts"],"mappings":";;;;;;AAiCwB;;;KAQnB,mBAAA;EAEH,sCAAA,EAAA,EAAI,SAAA,EAEJ;EAAA,IAAA,EAAM,cAAA;AAAA;;AAeR;;;;;;;;;AAMA;;UANiB,kBAAA,SAA2B,cAAA,CAAe,SAAA;EAM7B;EAJ5B,WAAA;AAAA;;KAIU,eAAA,GAAkB,WAAA;;KAElB,qBAAA,GAAwB,iBAAA,CAAkB,mBAAA;AAEtD;AAAA,KAAY,4BAAA,GAA+B,wBAAA,CACzC,SAAA,UAEA,mBAAA;;KAGU,sBAAA,GAAyB,kBAAA,CAAmB,kBAAA;;KAE5C,kBAAA,GAAqB,cAAA,CAAe,kBAAA;;;;;;;;AAFhD;KAWY,yBAAA;iCAEV,MAAA,EAAQ,SAAA,EAbgE;EAexE,WAAA,YAb4B;EAe5B,kBAAA;AAAA;;KAGU,mBAAA,GAAsB,eAAA,CAAgB,yBAAA,EAA2B,kBAAA;;KAEjE,kBAAA,GAAqB,cAAA,CAAe,SAAA;;KAEpC,aAAA,GAAgB,SAAA,CAAU,SAAA,EAAW,mBAAA;;KAErC,eAAA,GAAkB,WAAA,CAAY,SAAA,EAAW,0BAAA;;KAEzC,yBAAA,GAA4B,qBAAA,CACtC,SAAA,EACA,mBAAA,EACA,mBAAA;;AAXF;;;;;;;;;;KAyBY,SAAA,GACR,eAAA,GACA,qBAAA,GACA,4BAAA,GACA,sBAAA,GACA,kBAAA,GACA,mBAAA,GACA,kBAAA,GACA,aAAA,GACA,eAAA,GACA,yBAAA;;KAGQ,eAAA,GAAkB,WAAA;AApC9B;AAAA,KAsCY,iBAAA,GAAoB,aAAA;AAAA,KAEpB,mBAAA,GACR,iBAAA,GACA,eAAA,GACA,YAAA,GACA,iBAAA,CAAkB,mBAAA,IAClB,qBAAA,CAAsB,mBAAA,IACtB,gBAAA,CAAiB,mBAAA,IACjB,gBAAA,CAAiB,mBAAA,IACjB,kBAAA,CAAmB,mBAAA,IACnB,eAAA,CAAgB,mBAAA,IAChB,uBAAA,CAAwB,mBAAA,IACxB,UAAA,CAAW,mBAAA,IACX,YAAA,CAAa,mBAAA,IACb,gBAAA,CAAiB,mBAAA,IACjB,mBAAA,CAAoB,mBAAA,IACpB,QAAA,CAAS,mBAAA,YACT,QAAA,CAAS,mBAAA,YAET,QAAA,CAAS,mBAAA,IACT,eAAA,CAAgB,mBAAA,IAEhB,WAAA,CAAY,mBAAA;AAAA,KAGJ,0BAAA,GAA6B,2BAAA,CAA4B,mBAAA"}

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

@@ -1,7 +1,7 @@
 import { AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, FilteredPColumn, FilteredPColumnId, isFilteredPColumn } from "./filtered_column.js";
 import { DiscoveredPColumn, DiscoveredPColumnId, createDiscoveredPColumnId, distillDiscoveredPColumn, isDiscoveredPColumn, parseDiscoveredPColumnId, stringifyDiscoveredPColumnId } from "./discovered_column.js";
 import { SUniversalPColumnId, UniversalPColumnId, parseColumnId, stringifyColumnId } from "./ids.js";
-import { Annotation, AnnotationDataStatus, AnnotationJson, AxesId, AxesSpec, AxisId, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, ColumnValueType, Domain, DomainJson, Metadata, MetadataJson, PAxisName, PColumn, PColumnIdAndSpec, PColumnInfo, PColumnLazy, PColumnName, PColumnSpec, PColumnSpecId, PDataColumnSpec, PUniversalColumnSpec, Trace, TraceEntry, ValueType, canonicalizeAxisId, canonicalizeAxisWithParents, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAxisId, isLabelColumn, isLinkerColumn, matchAxisId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, resolveAnnotationParents } from "./spec.js";
+import { Annotation, AnnotationDataStatus, AnnotationJson, AxesId, AxesSpec, AxisId, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, ColumnValueType, Domain, DomainJson, Metadata, MetadataJson, PAxisName, PColumn, PColumnIdAndSpec, PColumnLazy, PColumnName, PColumnSpec, PColumnSpecId, PDataColumnSpec, PUniversalColumnSpec, Trace, TraceEntry, ValueType, canonicalizeAxisId, canonicalizeAxisWithParents, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAxisId, isLabelColumn, isLinkerColumn, matchAxisId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, resolveAnnotationParents } from "./spec.js";
 import { AnchoredIdDeriver, ResolveAnchorsOptions, resolveAnchors } from "./anchored.js";
 import { NativePObjectId, deriveNativeId } from "./native_id.js";
 import { AAxisSelector, ADomain, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredPColumnId, AnchoredPColumnSelector, AxisQualification, LegacyAxisSelector, PColumnSelector, SingleAxisSelector, isAnchoredPColumnId, legacyColumnSelectorsToPredicate, matchAxis, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate } from "./selectors.js";

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

@@ -1 +1 @@
-{"version":3,"file":"spec.cjs","names":["ensureError","z","canonicalizeJson"],"sources":["../../../../src/drivers/pframe/spec/spec.ts"],"sourcesContent":["import { ensureError } from \"../../../errors\";\nimport { canonicalizeJson, type CanonicalizedJson, type StringifiedJson } from \"../../../json\";\nimport type { PObject, PObjectId, PObjectSpec } from \"../../../pool\";\nimport { z } from \"zod\";\n\nexport const ValueType = {\n  Int: \"Int\",\n  Long: \"Long\",\n  Float: \"Float\",\n  Double: \"Double\",\n  String: \"String\",\n  Bytes: \"Bytes\",\n} as const;\n\nexport type AxisValueType = Extract<ValueType, \"Int\" | \"Long\" | \"String\">;\nexport type ColumnValueType = ValueType;\n\n/** PFrame columns and axes within them may store one of these types. */\nexport type ValueType = (typeof ValueType)[keyof typeof ValueType];\n\nexport type Metadata = Record<string, string>;\n\nexport function readMetadata<U extends Metadata, T extends keyof U = keyof U>(\n  metadata: Metadata | undefined,\n  key: T,\n): U[T] | undefined {\n  return (metadata as U | undefined)?.[key];\n}\n\ntype MetadataJsonImpl<M> = {\n  [P in keyof M as M[P] extends StringifiedJson ? P : never]: M[P] extends StringifiedJson<infer U>\n    ? z.ZodType<U>\n    : never;\n};\nexport type MetadataJson<M> = MetadataJsonImpl<Required<M>>;\n\nexport function readMetadataJsonOrThrow<M extends Metadata, T extends keyof MetadataJson<M>>(\n  metadata: Metadata | undefined,\n  metadataJson: MetadataJson<M>,\n  key: T,\n  methodNameInError: string = \"readMetadataJsonOrThrow\",\n): z.infer<MetadataJson<M>[T]> | undefined {\n  const json = readMetadata<M, T>(metadata, key);\n  if (json === undefined) return undefined;\n\n  const schema = metadataJson[key];\n  try {\n    const value = JSON.parse(json);\n    return schema.parse(value);\n  } catch (error: unknown) {\n    throw new Error(\n      `${methodNameInError} failed, ` +\n        `key: ${String(key)}, ` +\n        `value: ${json}, ` +\n        `error: ${ensureError(error)}`,\n    );\n  }\n}\n\nexport function readMetadataJson<M extends Metadata, T extends keyof MetadataJson<M>>(\n  metadata: Metadata | undefined,\n  metadataJson: MetadataJson<M>,\n  key: T,\n): z.infer<MetadataJson<M>[T]> | undefined {\n  try {\n    return readMetadataJsonOrThrow(metadata, metadataJson, key);\n  } catch {\n    return undefined; // treat invalid values as unset\n  }\n}\n\n/// Well-known domains\nexport const Domain = {\n  Alphabet: \"pl7.app/alphabet\",\n  BlockId: \"pl7.app/blockId\",\n  VDJ: {\n    Clustering: {\n      BlockId: \"pl7.app/vdj/clustering/blockId\",\n    },\n    ScClonotypeChain: {\n      Index: \"pl7.app/vdj/scClonotypeChain/index\",\n    },\n  },\n} as const;\n\nexport type Domain = Metadata &\n  Partial<{\n    [Domain.Alphabet]: \"nucleotide\" | \"aminoacid\" | (string & {});\n    [Domain.BlockId]: string;\n    [Domain.VDJ.ScClonotypeChain.Index]: \"primary\" | \"secondary\" | (string & {});\n  }>;\n\nexport type DomainJson = MetadataJson<Domain>;\nexport const DomainJson: DomainJson = {};\n\n/// Helper function for reading plain domain values\nexport function readDomain<T extends keyof Domain>(\n  spec: { domain?: Metadata | undefined } | undefined,\n  key: T,\n): Domain[T] | undefined {\n  return readMetadata<Domain, T>(spec?.domain, key);\n}\n\n/// Helper function for reading json-encoded domain values, throws on JSON parsing error\nexport function readDomainJsonOrThrow<T extends keyof DomainJson>(\n  spec: { domain?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<DomainJson[T]> | undefined {\n  return readMetadataJsonOrThrow<Domain, T>(spec?.domain, DomainJson, key, \"readDomainJsonOrThrow\");\n}\n\n/// Helper function for reading json-encoded domain values, returns undefined on JSON parsing error\nexport function readDomainJson<T extends keyof DomainJson>(\n  spec: { domain?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<DomainJson[T]> | undefined {\n  return readMetadataJson<Domain, T>(spec?.domain, DomainJson, key);\n}\n\n/// Well-known annotations\nexport const Annotation = {\n  AxisNature: \"pl7.app/axisNature\",\n  Alphabet: \"pl7.app/alphabet\",\n  Description: \"pl7.app/description\",\n  DataStatus: \"pl7.app/dataStatus\",\n  DiscreteValues: \"pl7.app/discreteValues\",\n  Format: \"pl7.app/format\",\n  Graph: {\n    Axis: {\n      HighCardinality: \"pl7.app/graph/axis/highCardinality\",\n      LowerLimit: \"pl7.app/graph/axis/lowerLimit\",\n      SymmetricRange: \"pl7.app/graph/axis/symmetricRange\",\n      UpperLimit: \"pl7.app/graph/axis/upperLimit\",\n    },\n    IsDenseAxis: \"pl7.app/graph/isDenseAxis\",\n    IsVirtual: \"pl7.app/graph/isVirtual\",\n    Palette: \"pl7.app/graph/palette\",\n    Thresholds: \"pl7.app/graph/thresholds\",\n    TreatAbsentValuesAs: \"pl7.app/graph/treatAbsentValuesAs\",\n  },\n  HideDataFromUi: \"pl7.app/hideDataFromUi\",\n  HideDataFromGraphs: \"pl7.app/hideDataFromGraphs\",\n  IsDiscreteFilter: \"pl7.app/isDiscreteFilter\",\n  IsAnchor: \"pl7.app/isAnchor\",\n  IsLinkerColumn: \"pl7.app/isLinkerColumn\",\n  IsScore: \"pl7.app/isScore\",\n  IsSubset: \"pl7.app/isSubset\",\n  Label: \"pl7.app/label\",\n  LinkLabel: \"pl7.app/linkLabel\",\n  Max: \"pl7.app/max\",\n  Min: \"pl7.app/min\",\n  MultipliesBy: \"pl7.app/multipliesBy\",\n  Parents: \"pl7.app/parents\",\n  Score: {\n    DefaultCutoff: \"pl7.app/score/defaultCutoff\",\n    RankingOrder: \"pl7.app/score/rankingOrder\",\n  },\n  Sequence: {\n    Annotation: {\n      Mapping: \"pl7.app/sequence/annotation/mapping\",\n    },\n    IsAnnotation: \"pl7.app/sequence/isAnnotation\",\n  },\n  Table: {\n    FontFamily: \"pl7.app/table/fontFamily\",\n    OrderPriority: \"pl7.app/table/orderPriority\",\n    Visibility: \"pl7.app/table/visibility\",\n    Info: \"pl7.app/table/info\",\n  },\n  Trace: \"pl7.app/trace\",\n  VDJ: {\n    IsAssemblingFeature: \"pl7.app/vdj/isAssemblingFeature\",\n    IsMainSequence: \"pl7.app/vdj/isMainSequence\",\n  },\n} as const;\n\nexport type AnnotationDataStatus = \"computing\" | \"ready\" | \"error\" | \"absent\";\n\nexport type Annotation = Metadata &\n  Partial<{\n    [Annotation.Alphabet]: \"nucleotide\" | \"aminoacid\" | (string & {});\n    [Annotation.AxisNature]: \"homogeneous\" | \"heterogeneous\" | \"scaleCompatible\" | (string & {});\n    [Annotation.Description]: string;\n    [Annotation.DataStatus]: AnnotationDataStatus;\n    [Annotation.DiscreteValues]: StringifiedJson<number[]> | StringifiedJson<string[]>;\n    [Annotation.Format]: string;\n    [Annotation.Graph.Axis.HighCardinality]: StringifiedJson<boolean>;\n    [Annotation.Graph.Axis.LowerLimit]: StringifiedJson<number>;\n    [Annotation.Graph.Axis.SymmetricRange]: StringifiedJson<boolean>;\n    [Annotation.Graph.Axis.UpperLimit]: StringifiedJson<number>;\n    [Annotation.Graph.IsDenseAxis]: StringifiedJson<boolean>;\n    [Annotation.Graph.IsVirtual]: StringifiedJson<boolean>;\n    [Annotation.Graph.Palette]: StringifiedJson<{ mapping: Record<string, number>; name: string }>;\n    [Annotation.Graph.Thresholds]: StringifiedJson<\n      { columnId: { valueType: ValueType; name: string }; value: number }[]\n    >;\n    [Annotation.Graph.TreatAbsentValuesAs]: StringifiedJson<number>;\n    [Annotation.HideDataFromGraphs]: StringifiedJson<boolean>;\n    [Annotation.HideDataFromUi]: StringifiedJson<boolean>;\n    [Annotation.IsDiscreteFilter]: StringifiedJson<boolean>;\n    [Annotation.IsLinkerColumn]: StringifiedJson<boolean>;\n    [Annotation.IsSubset]: StringifiedJson<boolean>;\n    [Annotation.Label]: string;\n    [Annotation.Max]: StringifiedJson<number>;\n    [Annotation.Min]: StringifiedJson<number>;\n    [Annotation.MultipliesBy]: StringifiedJson<AxisSpec[\"name\"][]>;\n    [Annotation.Parents]: StringifiedJson<AxisSpec[\"name\"][]>;\n    [Annotation.Sequence.Annotation.Mapping]: StringifiedJson<Record<string, string>>;\n    [Annotation.Sequence.IsAnnotation]: StringifiedJson<boolean>;\n    [Annotation.Table.FontFamily]: string;\n    [Annotation.Table.OrderPriority]: StringifiedJson<number>;\n    [Annotation.Table.Visibility]: \"hidden\" | \"optional\" | (string & {});\n    [Annotation.Table.Info]: string;\n    [Annotation.Trace]: StringifiedJson<Trace>;\n    [Annotation.VDJ.IsAssemblingFeature]: StringifiedJson<boolean>;\n  }>;\n\n/// One step in a column's derivation lineage. Only `type` and `label` are part\n/// of the typed public surface; writers may add fields (e.g. `id`, `importance`)\n/// passed through opaquely as `unknown`, accessed via explicit narrowing.\nconst TraceEntrySchema = z\n  .object({\n    type: z.string(),\n    label: z.string(),\n  })\n  .catchall(z.unknown());\n\nexport type TraceEntry = z.infer<typeof TraceEntrySchema>;\n\nexport type Trace = TraceEntry[];\n\n// export const AxisSpec = z.object({\n//   type: z.nativeEnum(ValueType),\n//   name: z.string(),\n//   domain: z.record(z.string(), z.string()).optional(),\n//   annotations: z.record(z.string(), z.string()).optional(),\n//   parentAxes: z.array(z.number()).optional(),\n// }).passthrough();\n//\n// type Expect<T extends true> = T;\n// type Equal<X, Y> =\n// (<T>() => T extends X ? 1 : 2) extends (<T>() => T extends Y ? 1 : 2) ? true : false;\n//\n// type _test = Expect<Equal<\n//   Readonly<z.infer<typeof AxisSpec>>,\n//   Readonly<AxisSpec & Record<string, unknown>>\n// >>;\n\nexport type AnnotationJson = MetadataJson<Annotation>;\n\nconst ValueTypeSchema = z.enum([\"Int\", \"Long\", \"Float\", \"Double\", \"String\"] as const);\nexport const AnnotationJson: AnnotationJson = {\n  [Annotation.DiscreteValues]: z.array(z.string()).or(z.array(z.number())),\n  [Annotation.Graph.Axis.HighCardinality]: z.boolean(),\n  [Annotation.Graph.Axis.LowerLimit]: z.number(),\n  [Annotation.Graph.Axis.UpperLimit]: z.number(),\n  [Annotation.Graph.Axis.SymmetricRange]: z.boolean(),\n  [Annotation.Graph.IsDenseAxis]: z.boolean(),\n  [Annotation.Graph.Palette]: z.object({ mapping: z.record(z.number()), name: z.string() }),\n  [Annotation.Graph.Thresholds]: z.array(\n    z.object({\n      columnId: z.object({ valueType: ValueTypeSchema, name: z.string() }),\n      value: z.number(),\n    }),\n  ),\n  [Annotation.Graph.TreatAbsentValuesAs]: z.number(),\n  [Annotation.Graph.IsVirtual]: z.boolean(),\n  [Annotation.HideDataFromUi]: z.boolean(),\n  [Annotation.HideDataFromGraphs]: z.boolean(),\n  [Annotation.IsDiscreteFilter]: z.boolean(),\n  [Annotation.IsLinkerColumn]: z.boolean(),\n  [Annotation.IsSubset]: z.boolean(),\n  [Annotation.Max]: z.number(),\n  [Annotation.Min]: z.number(),\n  [Annotation.MultipliesBy]: z.array(z.string()),\n  [Annotation.Parents]: z.array(z.string()),\n  [Annotation.Sequence.Annotation.Mapping]: z.record(z.string(), z.string()),\n  [Annotation.Sequence.IsAnnotation]: z.boolean(),\n  [Annotation.Table.OrderPriority]: z.number(),\n  [Annotation.Trace]: z.array(TraceEntrySchema),\n  [Annotation.VDJ.IsAssemblingFeature]: z.boolean(),\n};\n\n/// Helper function for reading plain annotation values\nexport function readAnnotation<T extends keyof Annotation>(\n  spec: { annotations?: Metadata | undefined } | undefined,\n  key: T,\n): Annotation[T] | undefined {\n  return readMetadata<Annotation, T>(spec?.annotations, key);\n}\n\n/// Helper function for reading json-encoded annotation values, throws on JSON parsing error\nexport function readAnnotationJsonOrThrow<T extends keyof AnnotationJson>(\n  spec: { annotations?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<AnnotationJson[T]> | undefined {\n  return readMetadataJsonOrThrow<Annotation, T>(\n    spec?.annotations,\n    AnnotationJson,\n    key,\n    \"readAnnotationJsonOrThrow\",\n  );\n}\n\n/// Helper function for reading json-encoded annotation values, returns undefined on JSON parsing error\nexport function readAnnotationJson<T extends keyof AnnotationJson>(\n  spec: { annotations?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<AnnotationJson[T]> | undefined {\n  return readMetadataJson<Annotation, T>(spec?.annotations, AnnotationJson, key);\n}\n\nexport function isLinkerColumn(column: PColumnSpec): boolean {\n  return !!readAnnotationJson(column, Annotation.IsLinkerColumn);\n}\n\n/**\n * Specification of an individual axis.\n *\n * Each axis is a part of a composite key that addresses data inside the PColumn.\n *\n * Each record inside a PColumn is addressed by a unique tuple of values set for\n * all the axes specified in the column spec.\n */\nexport type AxisSpec = {\n  /** Type of the axis value. Should not use non-key types like float or double. */\n  readonly type: AxisValueType;\n\n  /** Name of the axis */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis name, type and parents to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional axis identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n\n  /** Any additional information attached to the axis that does not affect its\n   * identifier */\n  readonly annotations?: Record<string, string>;\n\n  /**\n   * Parent axes provide contextual grouping for the axis in question, establishing\n   * a hierarchy where the current axis is dependent on one or more axes for its\n   * full definition and meaning. For instance, in a data structure where each\n   * \"container\" axis may contain multiple \"item\" axes, the `item` axis would\n   * list the index of the `container` axis in this field to denote its dependency.\n   *\n   * This means that the identity or significance of the `item` axis is only\n   * interpretable when combined with its parent `container` axis. An `item` axis\n   * index by itself may be non-unique and only gains uniqueness within the context\n   * of its parent `container`. Therefore, the `parentAxes` field is essential for\n   * mapping these relationships and ensuring data coherence across nested or\n   * multi-level data models.\n   *\n   * A list of zero-based indices of parent axes in the overall axes specification\n   * from the column spec. Each index corresponds to the position of a parent axis\n   * in the list that defines the structure of the data model.\n   */\n  readonly parentAxes?: number[];\n};\n\n/** Parents are specs, not indexes; normalized axis can be used considering its parents independently from column */\nexport interface AxisSpecNormalized extends Omit<AxisSpec, \"parentAxes\"> {\n  parentAxesSpec: AxisSpecNormalized[];\n}\n\n/** Tree: axis is a root, its parents are children */\nexport type AxisTree = {\n  axis: AxisSpecNormalized;\n  children: AxisTree[]; // parents\n};\n\nfunction makeAxisTree(axis: AxisSpecNormalized): AxisTree {\n  return { axis, children: [] };\n}\n\n/** Build tree by axis parents annotations */\nexport function getAxesTree(rootAxis: AxisSpecNormalized): AxisTree {\n  const root = makeAxisTree(rootAxis);\n  let nodesQ = [root];\n  while (nodesQ.length) {\n    const nextNodes: AxisTree[] = [];\n    for (const node of nodesQ) {\n      node.children = node.axis.parentAxesSpec.map(makeAxisTree);\n      nextNodes.push(...node.children);\n    }\n    nodesQ = nextNodes;\n  }\n  return root;\n}\n\n/** Get set of canonicalized axisIds from axisTree */\nexport function getSetFromAxisTree(tree: AxisTree): Set<CanonicalizedJson<AxisId>> {\n  const set = new Set([canonicalizeJson(getAxisId(tree.axis))]);\n  let nodesQ = [tree];\n  while (nodesQ.length) {\n    const nextNodes = [];\n    for (const node of nodesQ) {\n      for (const parent of node.children) {\n        set.add(canonicalizeJson(getAxisId(parent.axis)));\n        nextNodes.push(parent);\n      }\n    }\n    nodesQ = nextNodes;\n  }\n  return set;\n}\n\n/** Get array of axisSpecs from axisTree */\nexport function getArrayFromAxisTree(tree: AxisTree): AxisSpecNormalized[] {\n  const res = [tree.axis];\n  let nodesQ = [tree];\n  while (nodesQ.length) {\n    const nextNodes = [];\n    for (const node of nodesQ) {\n      for (const parent of node.children) {\n        res.push(parent.axis);\n        nextNodes.push(parent);\n      }\n    }\n    nodesQ = nextNodes;\n  }\n  return res;\n}\n\nexport function canonicalizeAxisWithParents(axis: AxisSpecNormalized) {\n  return canonicalizeJson(getArrayFromAxisTree(getAxesTree(axis)).map(getAxisId));\n}\n\nfunction normalizingAxesComparator(\n  axis1: AxisSpecNormalized,\n  axis2: AxisSpecNormalized,\n): 1 | -1 | 0 {\n  if (axis1.name !== axis2.name) {\n    return axis1.name < axis2.name ? 1 : -1;\n  }\n  if (axis1.type !== axis2.type) {\n    return axis1.type < axis2.type ? 1 : -1;\n  }\n  const domain1 = canonicalizeJson(axis1.domain ?? {});\n  const domain2 = canonicalizeJson(axis2.domain ?? {});\n  if (domain1 !== domain2) {\n    return domain1 < domain2 ? 1 : -1;\n  }\n\n  const contextDomain1 = canonicalizeJson(axis1.contextDomain ?? {});\n  const contextDomain2 = canonicalizeJson(axis2.contextDomain ?? {});\n  if (contextDomain1 !== contextDomain2) {\n    return contextDomain1 < contextDomain2 ? 1 : -1;\n  }\n\n  const parents1 = canonicalizeAxisWithParents(axis1);\n  const parents2 = canonicalizeAxisWithParents(axis2);\n\n  if (parents1 !== parents2) {\n    return parents1 < parents2 ? 1 : -1;\n  }\n\n  const annotation1 = canonicalizeJson(axis1.annotations ?? {});\n  const annotation2 = canonicalizeJson(axis2.annotations ?? {});\n  if (annotation1 !== annotation2) {\n    return annotation1 < annotation2 ? 1 : -1;\n  }\n  return 0;\n}\n\nfunction parseParentsFromAnnotations(axis: AxisSpec) {\n  const parentsList = readAnnotationJson(axis, Annotation.Parents);\n  if (parentsList === undefined) {\n    return [];\n  }\n  return parentsList;\n}\n\nfunction sortParentsDeep(axisSpec: AxisSpecNormalized) {\n  axisSpec.parentAxesSpec.forEach(sortParentsDeep);\n  axisSpec.parentAxesSpec.sort(normalizingAxesComparator);\n}\n\nfunction hasCycleOfParents(axisSpec: AxisSpecNormalized) {\n  const root = makeAxisTree(axisSpec);\n  let nodesQ = [root];\n  const ancestors = new Set(canonicalizeJson(getAxisId(axisSpec)));\n  while (nodesQ.length) {\n    const nextNodes: AxisTree[] = [];\n    const levelIds = new Set<CanonicalizedJson<AxisId>>();\n    for (const node of nodesQ) {\n      node.children = node.axis.parentAxesSpec.map(makeAxisTree);\n      for (const child of node.children) {\n        const childId = canonicalizeJson(getAxisId(child.axis));\n        if (!levelIds.has(childId)) {\n          nextNodes.push(child);\n          levelIds.add(childId);\n          if (ancestors.has(childId)) {\n            return true;\n          }\n          ancestors.add(childId);\n        }\n      }\n    }\n    nodesQ = nextNodes;\n  }\n  return false;\n}\n\n/** Create list of normalized axisSpec (parents are in array of specs, not indexes) */\nexport function getNormalizedAxesList(axes: AxisSpec[]): AxisSpecNormalized[] {\n  if (!axes.length) {\n    return [];\n  }\n  const modifiedAxes: AxisSpecNormalized[] = axes.map((axis) => {\n    const { parentAxes: _, ...copiedRest } = axis;\n    return { ...copiedRest, annotations: { ...copiedRest.annotations }, parentAxesSpec: [] };\n  });\n\n  axes.forEach((axis, idx) => {\n    const modifiedAxis = modifiedAxes[idx];\n    if (axis.parentAxes) {\n      // if we have parents by indexes then take from the list\n      modifiedAxis.parentAxesSpec = axis.parentAxes.map((idx) => modifiedAxes[idx]);\n    } else {\n      // else try to parse from annotation name\n      const parents = parseParentsFromAnnotations(axis).map((name) =>\n        modifiedAxes.find((axis) => axis.name === name),\n      );\n      modifiedAxis.parentAxesSpec = parents.some((p) => p === undefined)\n        ? []\n        : (parents as AxisSpecNormalized[]);\n    }\n  });\n\n  if (modifiedAxes.some(hasCycleOfParents)) {\n    // Axes list is broken\n    modifiedAxes.forEach((axis) => {\n      axis.parentAxesSpec = [];\n    });\n  } else {\n    modifiedAxes.forEach((axis) => {\n      sortParentsDeep(axis);\n    });\n  }\n\n  return modifiedAxes;\n}\n\n/** Create list of regular axisSpec from normalized (parents are indexes, inside of current axes list) */\nexport function getDenormalizedAxesList(axesSpec: AxisSpecNormalized[]): AxisSpec[] {\n  const idsList = axesSpec.map(canonicalizeAxisId);\n  return axesSpec.map((axisSpec) => {\n    const parentsIds = axisSpec.parentAxesSpec.map(canonicalizeAxisId);\n    const parentIdxs = parentsIds.map((id) => idsList.indexOf(id));\n    const { parentAxesSpec: _, ...copiedRest } = axisSpec;\n    if (parentIdxs.length) {\n      return { ...copiedRest, parentAxes: parentIdxs } as AxisSpec;\n    }\n    return copiedRest;\n  });\n}\n\n/**\n * Resolve annotation-based parents (`pl7.app/parents`) to numeric `parentAxes`\n * on a column spec. Returns the spec unchanged if all axes already use numeric\n * indices or have no parent annotations.\n */\nexport function resolveAnnotationParents(spec: PColumnSpec): PColumnSpec {\n  const hasAnnotationParents = spec.axesSpec.some(\n    (axis) => !!readAnnotationJson(axis, Annotation.Parents),\n  );\n  if (!hasAnnotationParents) return spec;\n\n  const normalized = getNormalizedAxesList(spec.axesSpec);\n  const denormalized = getDenormalizedAxesList(normalized);\n  return { ...spec, axesSpec: denormalized };\n}\n\n/** Common type representing spec for all the axes in a column */\nexport type AxesSpec = AxisSpec[];\n\n/// Well-known column names\nexport const PColumnName = {\n  Label: \"pl7.app/label\",\n  Table: {\n    RowSelection: \"pl7.app/table/row-selection\",\n  },\n  VDJ: {\n    LeadSelection: \"pl7.app/vdj/lead-selection\",\n    RankingOrder: \"pl7.app/vdj/ranking-order\",\n    Sequence: \"pl7.app/vdj/sequence\",\n  },\n} as const;\n\n/// Well-known axis names\nexport const PAxisName = {\n  SampleId: \"pl7.app/sampleId\",\n  VDJ: {\n    Assay: {\n      SequenceId: \"pl7.app/vdj/assay/sequenceId\",\n    },\n    ClusterId: \"pl7.app/vdj/clusterId\",\n    ClonotypeKey: \"pl7.app/vdj/clonotypeKey\",\n    ScClonotypeKey: \"pl7.app/vdj/scClonotypeKey\",\n  },\n} as const;\n\nexport function isLabelColumn(column: PColumnSpec) {\n  return column.axesSpec.length === 1 && column.name === PColumnName.Label;\n}\n\n/**\n * Full column specification including all axes specs and specs of the column\n * itself.\n *\n * A PColumn in its essence represents a mapping from a fixed size, explicitly\n * typed tuple to an explicitly typed value.\n *\n * (axis1Value1, axis2Value1, ...) -> columnValue\n *\n * Each element in tuple correspond to the axis having the same index in axesSpec.\n */\nexport type PUniversalColumnSpec = PObjectSpec & {\n  /** Defines specific type of BObject, the most generic type of unit of\n   * information in Platforma Project. */\n  readonly kind: \"PColumn\";\n\n  /** Type of column values */\n  readonly valueType: string;\n\n  /** Column name */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis name, type and parents to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional column identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n\n  /** Any additional information attached to the column that does not affect its\n   * identifier */\n  readonly annotations?: Record<string, string>;\n\n  /** A list of zero-based indices of parent axes from the {@link axesSpec} array. */\n  readonly parentAxes?: number[];\n\n  /** Axes specifications */\n  readonly axesSpec: AxesSpec;\n};\n\n/**\n * Specification of a data column.\n *\n * Data column is a specialized type of PColumn that stores only simple values (strings and numbers)\n * addressed by multiple keys. This is in contrast to other PColumn variants that can store more complex\n * values like files or other abstract data types. Data columns are optimized for storing and processing\n * basic tabular data.\n */\nexport type PDataColumnSpec = PUniversalColumnSpec & {\n  /** Type of column values */\n  readonly valueType: ValueType;\n};\n\n// @todo: change this to PUniversalColumnSpec\nexport type PColumnSpec = PDataColumnSpec;\n\n/** Unique PColumnSpec identifier */\nexport type PColumnSpecId = {\n  /** Defines specific type of BObject, the most generic type of unit of\n   * information in Platforma Project. */\n  readonly kind: \"PColumn\";\n\n  /** Type of column values */\n  readonly valueType: ValueType;\n\n  /** Column name */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis name, type and parents to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional column identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n\n  /** A list of zero-based indices of parent axes from the {@link axesSpec} array. */\n  readonly parentAxes?: number[];\n\n  /** Axes id */\n  readonly axesId: AxesId;\n};\n\nexport function getPColumnSpecId(spec: PColumnSpec): PColumnSpecId {\n  return {\n    kind: spec.kind,\n    valueType: spec.valueType,\n    name: spec.name,\n    domain: spec.domain,\n    contextDomain: spec.contextDomain,\n    parentAxes: spec.parentAxes,\n    axesId: getAxesId(spec.axesSpec),\n  };\n}\n\nexport interface PColumn<Data> extends PObject<Data> {\n  /** PColumn spec, allowing it to be found among other PObjects */\n  readonly spec: PColumnSpec;\n}\n\nexport type PColumnLazy<T> = PColumn<() => T>;\n\n/** Columns in a PFrame also have internal identifier, this object represents\n * combination of specs and such id */\nexport interface PColumnIdAndSpec {\n  /** Internal column id within the PFrame */\n  readonly columnId: PObjectId;\n\n  /** Column spec */\n  readonly spec: PColumnSpec;\n}\n\n/** Get column id and spec from a column */\nexport function getColumnIdAndSpec<Data>(column: PColumn<Data>): PColumnIdAndSpec {\n  return {\n    columnId: column.id,\n    spec: column.spec,\n  };\n}\n\n/** Information returned by {@link PFrame.listColumns} method */\nexport interface PColumnInfo extends PColumnIdAndSpec {\n  /** True if data was associated with this PColumn */\n  readonly hasData: boolean;\n}\n\nexport interface AxisId {\n  /** Type of the axis or column value. For an axis should not use non-key\n   * types like float or double. */\n  readonly type: AxisValueType;\n\n  /** Name of the axis or column */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis or column name and type to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional axis identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n}\n\n/** Array of axis ids */\nexport type AxesId = AxisId[];\n\n/** Extracts axis ids from axis spec */\nexport function getAxisId(spec: AxisSpec): AxisId {\n  const { type, name, domain, contextDomain } = spec;\n  const result: AxisId = { type, name };\n  if (domain && Object.entries(domain).length > 0) {\n    Object.assign(result, { domain });\n  }\n  if (contextDomain && Object.entries(contextDomain).length > 0) {\n    Object.assign(result, { contextDomain });\n  }\n  return result;\n}\n\n/** Extracts axes ids from axes spec array from column spec */\nexport function getAxesId(spec: AxesSpec): AxesId {\n  return spec.map(getAxisId);\n}\n\n/** Canonicalizes axis id */\nexport function canonicalizeAxisId(id: AxisId): CanonicalizedJson<AxisId> {\n  return canonicalizeJson(getAxisId(id));\n}\n\n/** Returns true if all domains from query are found in target */\nfunction matchDomain(query?: Record<string, string>, target?: Record<string, string>) {\n  if (query === undefined) return target === undefined;\n  if (target === undefined) return true;\n  for (const k in target) {\n    if (query[k] !== target[k]) return false;\n  }\n  return true;\n}\n\n/** Returns whether \"match\" axis id is compatible with the \"query\" */\nexport function matchAxisId(query: AxisId, target: AxisId): boolean {\n  return (\n    query.name === target.name &&\n    matchDomain(query.domain, target.domain) &&\n    matchDomain(query.contextDomain, target.contextDomain)\n  );\n}\n\nexport function getTypeFromPColumnOrAxisSpec(spec: PColumnSpec | AxisSpec): ValueType {\n  return \"valueType\" in spec ? spec.valueType : spec.type;\n}\n\nexport function isAxisId(id: unknown): id is AxisId {\n  return typeof id === \"object\" && id !== null && \"name\" in id && \"type\" in id;\n}\n"],"mappings":"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"}
+{"version":3,"file":"spec.cjs","names":["ensureError","z","canonicalizeJson"],"sources":["../../../../src/drivers/pframe/spec/spec.ts"],"sourcesContent":["import { ensureError } from \"../../../errors\";\nimport { canonicalizeJson, type CanonicalizedJson, type StringifiedJson } from \"../../../json\";\nimport type { PObject, PObjectId, PObjectSpec } from \"../../../pool\";\nimport { z } from \"zod\";\n\nexport const ValueType = {\n  Int: \"Int\",\n  Long: \"Long\",\n  Float: \"Float\",\n  Double: \"Double\",\n  String: \"String\",\n  Bytes: \"Bytes\",\n} as const;\n\nexport type AxisValueType = Extract<ValueType, \"Int\" | \"Long\" | \"String\">;\nexport type ColumnValueType = ValueType;\n\n/** PFrame columns and axes within them may store one of these types. */\nexport type ValueType = (typeof ValueType)[keyof typeof ValueType];\n\nexport type Metadata = Record<string, string>;\n\nexport function readMetadata<U extends Metadata, T extends keyof U = keyof U>(\n  metadata: Metadata | undefined,\n  key: T,\n): U[T] | undefined {\n  return (metadata as U | undefined)?.[key];\n}\n\ntype MetadataJsonImpl<M> = {\n  [P in keyof M as M[P] extends StringifiedJson ? P : never]: M[P] extends StringifiedJson<infer U>\n    ? z.ZodType<U>\n    : never;\n};\nexport type MetadataJson<M> = MetadataJsonImpl<Required<M>>;\n\nexport function readMetadataJsonOrThrow<M extends Metadata, T extends keyof MetadataJson<M>>(\n  metadata: Metadata | undefined,\n  metadataJson: MetadataJson<M>,\n  key: T,\n  methodNameInError: string = \"readMetadataJsonOrThrow\",\n): z.infer<MetadataJson<M>[T]> | undefined {\n  const json = readMetadata<M, T>(metadata, key);\n  if (json === undefined) return undefined;\n\n  const schema = metadataJson[key];\n  try {\n    const value = JSON.parse(json);\n    return schema.parse(value);\n  } catch (error: unknown) {\n    throw new Error(\n      `${methodNameInError} failed, ` +\n        `key: ${String(key)}, ` +\n        `value: ${json}, ` +\n        `error: ${ensureError(error)}`,\n    );\n  }\n}\n\nexport function readMetadataJson<M extends Metadata, T extends keyof MetadataJson<M>>(\n  metadata: Metadata | undefined,\n  metadataJson: MetadataJson<M>,\n  key: T,\n): z.infer<MetadataJson<M>[T]> | undefined {\n  try {\n    return readMetadataJsonOrThrow(metadata, metadataJson, key);\n  } catch {\n    return undefined; // treat invalid values as unset\n  }\n}\n\n/// Well-known domains\nexport const Domain = {\n  Alphabet: \"pl7.app/alphabet\",\n  BlockId: \"pl7.app/blockId\",\n  VDJ: {\n    Clustering: {\n      BlockId: \"pl7.app/vdj/clustering/blockId\",\n    },\n    ScClonotypeChain: {\n      Index: \"pl7.app/vdj/scClonotypeChain/index\",\n    },\n  },\n} as const;\n\nexport type Domain = Metadata &\n  Partial<{\n    [Domain.Alphabet]: \"nucleotide\" | \"aminoacid\" | (string & {});\n    [Domain.BlockId]: string;\n    [Domain.VDJ.ScClonotypeChain.Index]: \"primary\" | \"secondary\" | (string & {});\n  }>;\n\nexport type DomainJson = MetadataJson<Domain>;\nexport const DomainJson: DomainJson = {};\n\n/// Helper function for reading plain domain values\nexport function readDomain<T extends keyof Domain>(\n  spec: { domain?: Metadata | undefined } | undefined,\n  key: T,\n): Domain[T] | undefined {\n  return readMetadata<Domain, T>(spec?.domain, key);\n}\n\n/// Helper function for reading json-encoded domain values, throws on JSON parsing error\nexport function readDomainJsonOrThrow<T extends keyof DomainJson>(\n  spec: { domain?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<DomainJson[T]> | undefined {\n  return readMetadataJsonOrThrow<Domain, T>(spec?.domain, DomainJson, key, \"readDomainJsonOrThrow\");\n}\n\n/// Helper function for reading json-encoded domain values, returns undefined on JSON parsing error\nexport function readDomainJson<T extends keyof DomainJson>(\n  spec: { domain?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<DomainJson[T]> | undefined {\n  return readMetadataJson<Domain, T>(spec?.domain, DomainJson, key);\n}\n\n/// Well-known annotations\nexport const Annotation = {\n  AxisNature: \"pl7.app/axisNature\",\n  Alphabet: \"pl7.app/alphabet\",\n  Description: \"pl7.app/description\",\n  DataStatus: \"pl7.app/dataStatus\",\n  DiscreteValues: \"pl7.app/discreteValues\",\n  Format: \"pl7.app/format\",\n  Graph: {\n    Axis: {\n      HighCardinality: \"pl7.app/graph/axis/highCardinality\",\n      LowerLimit: \"pl7.app/graph/axis/lowerLimit\",\n      SymmetricRange: \"pl7.app/graph/axis/symmetricRange\",\n      UpperLimit: \"pl7.app/graph/axis/upperLimit\",\n    },\n    IsDenseAxis: \"pl7.app/graph/isDenseAxis\",\n    IsVirtual: \"pl7.app/graph/isVirtual\",\n    Palette: \"pl7.app/graph/palette\",\n    Thresholds: \"pl7.app/graph/thresholds\",\n    TreatAbsentValuesAs: \"pl7.app/graph/treatAbsentValuesAs\",\n  },\n  HideDataFromUi: \"pl7.app/hideDataFromUi\",\n  HideDataFromGraphs: \"pl7.app/hideDataFromGraphs\",\n  IsDiscreteFilter: \"pl7.app/isDiscreteFilter\",\n  IsAnchor: \"pl7.app/isAnchor\",\n  IsLinkerColumn: \"pl7.app/isLinkerColumn\",\n  IsScore: \"pl7.app/isScore\",\n  IsSubset: \"pl7.app/isSubset\",\n  Label: \"pl7.app/label\",\n  LinkLabel: \"pl7.app/linkLabel\",\n  Max: \"pl7.app/max\",\n  Min: \"pl7.app/min\",\n  MultipliesBy: \"pl7.app/multipliesBy\",\n  Parents: \"pl7.app/parents\",\n  Score: {\n    DefaultCutoff: \"pl7.app/score/defaultCutoff\",\n    RankingOrder: \"pl7.app/score/rankingOrder\",\n  },\n  Sequence: {\n    Annotation: {\n      Mapping: \"pl7.app/sequence/annotation/mapping\",\n    },\n    IsAnnotation: \"pl7.app/sequence/isAnnotation\",\n  },\n  Table: {\n    FontFamily: \"pl7.app/table/fontFamily\",\n    OrderPriority: \"pl7.app/table/orderPriority\",\n    Visibility: \"pl7.app/table/visibility\",\n    Info: \"pl7.app/table/info\",\n  },\n  Trace: \"pl7.app/trace\",\n  VDJ: {\n    IsAssemblingFeature: \"pl7.app/vdj/isAssemblingFeature\",\n    IsMainSequence: \"pl7.app/vdj/isMainSequence\",\n  },\n} as const;\n\nexport type AnnotationDataStatus = \"computing\" | \"ready\" | \"error\" | \"absent\";\n\nexport type Annotation = Metadata &\n  Partial<{\n    [Annotation.Alphabet]: \"nucleotide\" | \"aminoacid\" | (string & {});\n    [Annotation.AxisNature]: \"homogeneous\" | \"heterogeneous\" | \"scaleCompatible\" | (string & {});\n    [Annotation.Description]: string;\n    [Annotation.DataStatus]: AnnotationDataStatus;\n    [Annotation.DiscreteValues]: StringifiedJson<number[]> | StringifiedJson<string[]>;\n    [Annotation.Format]: string;\n    [Annotation.Graph.Axis.HighCardinality]: StringifiedJson<boolean>;\n    [Annotation.Graph.Axis.LowerLimit]: StringifiedJson<number>;\n    [Annotation.Graph.Axis.SymmetricRange]: StringifiedJson<boolean>;\n    [Annotation.Graph.Axis.UpperLimit]: StringifiedJson<number>;\n    [Annotation.Graph.IsDenseAxis]: StringifiedJson<boolean>;\n    [Annotation.Graph.IsVirtual]: StringifiedJson<boolean>;\n    [Annotation.Graph.Palette]: StringifiedJson<{ mapping: Record<string, number>; name: string }>;\n    [Annotation.Graph.Thresholds]: StringifiedJson<\n      { columnId: { valueType: ValueType; name: string }; value: number }[]\n    >;\n    [Annotation.Graph.TreatAbsentValuesAs]: StringifiedJson<number>;\n    [Annotation.HideDataFromGraphs]: StringifiedJson<boolean>;\n    [Annotation.HideDataFromUi]: StringifiedJson<boolean>;\n    [Annotation.IsDiscreteFilter]: StringifiedJson<boolean>;\n    [Annotation.IsLinkerColumn]: StringifiedJson<boolean>;\n    [Annotation.IsSubset]: StringifiedJson<boolean>;\n    [Annotation.Label]: string;\n    [Annotation.Max]: StringifiedJson<number>;\n    [Annotation.Min]: StringifiedJson<number>;\n    [Annotation.MultipliesBy]: StringifiedJson<AxisSpec[\"name\"][]>;\n    [Annotation.Parents]: StringifiedJson<AxisSpec[\"name\"][]>;\n    [Annotation.Sequence.Annotation.Mapping]: StringifiedJson<Record<string, string>>;\n    [Annotation.Sequence.IsAnnotation]: StringifiedJson<boolean>;\n    [Annotation.Table.FontFamily]: string;\n    [Annotation.Table.OrderPriority]: StringifiedJson<number>;\n    [Annotation.Table.Visibility]: \"hidden\" | \"optional\" | (string & {});\n    [Annotation.Table.Info]: string;\n    [Annotation.Trace]: StringifiedJson<Trace>;\n    [Annotation.VDJ.IsAssemblingFeature]: StringifiedJson<boolean>;\n  }>;\n\n/// One step in a column's derivation lineage. Only `type` and `label` are part\n/// of the typed public surface; writers may add fields (e.g. `id`, `importance`)\n/// passed through opaquely as `unknown`, accessed via explicit narrowing.\nconst TraceEntrySchema = z\n  .object({\n    type: z.string(),\n    label: z.string(),\n  })\n  .catchall(z.unknown());\n\nexport type TraceEntry = z.infer<typeof TraceEntrySchema>;\n\nexport type Trace = TraceEntry[];\n\n// export const AxisSpec = z.object({\n//   type: z.nativeEnum(ValueType),\n//   name: z.string(),\n//   domain: z.record(z.string(), z.string()).optional(),\n//   annotations: z.record(z.string(), z.string()).optional(),\n//   parentAxes: z.array(z.number()).optional(),\n// }).passthrough();\n//\n// type Expect<T extends true> = T;\n// type Equal<X, Y> =\n// (<T>() => T extends X ? 1 : 2) extends (<T>() => T extends Y ? 1 : 2) ? true : false;\n//\n// type _test = Expect<Equal<\n//   Readonly<z.infer<typeof AxisSpec>>,\n//   Readonly<AxisSpec & Record<string, unknown>>\n// >>;\n\nexport type AnnotationJson = MetadataJson<Annotation>;\n\nconst ValueTypeSchema = z.enum([\"Int\", \"Long\", \"Float\", \"Double\", \"String\"] as const);\nexport const AnnotationJson: AnnotationJson = {\n  [Annotation.DiscreteValues]: z.array(z.string()).or(z.array(z.number())),\n  [Annotation.Graph.Axis.HighCardinality]: z.boolean(),\n  [Annotation.Graph.Axis.LowerLimit]: z.number(),\n  [Annotation.Graph.Axis.UpperLimit]: z.number(),\n  [Annotation.Graph.Axis.SymmetricRange]: z.boolean(),\n  [Annotation.Graph.IsDenseAxis]: z.boolean(),\n  [Annotation.Graph.Palette]: z.object({ mapping: z.record(z.number()), name: z.string() }),\n  [Annotation.Graph.Thresholds]: z.array(\n    z.object({\n      columnId: z.object({ valueType: ValueTypeSchema, name: z.string() }),\n      value: z.number(),\n    }),\n  ),\n  [Annotation.Graph.TreatAbsentValuesAs]: z.number(),\n  [Annotation.Graph.IsVirtual]: z.boolean(),\n  [Annotation.HideDataFromUi]: z.boolean(),\n  [Annotation.HideDataFromGraphs]: z.boolean(),\n  [Annotation.IsDiscreteFilter]: z.boolean(),\n  [Annotation.IsLinkerColumn]: z.boolean(),\n  [Annotation.IsSubset]: z.boolean(),\n  [Annotation.Max]: z.number(),\n  [Annotation.Min]: z.number(),\n  [Annotation.MultipliesBy]: z.array(z.string()),\n  [Annotation.Parents]: z.array(z.string()),\n  [Annotation.Sequence.Annotation.Mapping]: z.record(z.string(), z.string()),\n  [Annotation.Sequence.IsAnnotation]: z.boolean(),\n  [Annotation.Table.OrderPriority]: z.number(),\n  [Annotation.Trace]: z.array(TraceEntrySchema),\n  [Annotation.VDJ.IsAssemblingFeature]: z.boolean(),\n};\n\n/// Helper function for reading plain annotation values\nexport function readAnnotation<T extends keyof Annotation>(\n  spec: { annotations?: Metadata | undefined } | undefined,\n  key: T,\n): Annotation[T] | undefined {\n  return readMetadata<Annotation, T>(spec?.annotations, key);\n}\n\n/// Helper function for reading json-encoded annotation values, throws on JSON parsing error\nexport function readAnnotationJsonOrThrow<T extends keyof AnnotationJson>(\n  spec: { annotations?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<AnnotationJson[T]> | undefined {\n  return readMetadataJsonOrThrow<Annotation, T>(\n    spec?.annotations,\n    AnnotationJson,\n    key,\n    \"readAnnotationJsonOrThrow\",\n  );\n}\n\n/// Helper function for reading json-encoded annotation values, returns undefined on JSON parsing error\nexport function readAnnotationJson<T extends keyof AnnotationJson>(\n  spec: { annotations?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<AnnotationJson[T]> | undefined {\n  return readMetadataJson<Annotation, T>(spec?.annotations, AnnotationJson, key);\n}\n\nexport function isLinkerColumn(column: PColumnSpec): boolean {\n  return !!readAnnotationJson(column, Annotation.IsLinkerColumn);\n}\n\n/**\n * Specification of an individual axis.\n *\n * Each axis is a part of a composite key that addresses data inside the PColumn.\n *\n * Each record inside a PColumn is addressed by a unique tuple of values set for\n * all the axes specified in the column spec.\n */\nexport type AxisSpec = {\n  /** Type of the axis value. Should not use non-key types like float or double. */\n  readonly type: AxisValueType;\n\n  /** Name of the axis */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis name, type and parents to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional axis identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n\n  /** Any additional information attached to the axis that does not affect its\n   * identifier */\n  readonly annotations?: Record<string, string>;\n\n  /**\n   * Parent axes provide contextual grouping for the axis in question, establishing\n   * a hierarchy where the current axis is dependent on one or more axes for its\n   * full definition and meaning. For instance, in a data structure where each\n   * \"container\" axis may contain multiple \"item\" axes, the `item` axis would\n   * list the index of the `container` axis in this field to denote its dependency.\n   *\n   * This means that the identity or significance of the `item` axis is only\n   * interpretable when combined with its parent `container` axis. An `item` axis\n   * index by itself may be non-unique and only gains uniqueness within the context\n   * of its parent `container`. Therefore, the `parentAxes` field is essential for\n   * mapping these relationships and ensuring data coherence across nested or\n   * multi-level data models.\n   *\n   * A list of zero-based indices of parent axes in the overall axes specification\n   * from the column spec. Each index corresponds to the position of a parent axis\n   * in the list that defines the structure of the data model.\n   */\n  readonly parentAxes?: number[];\n};\n\n/** Parents are specs, not indexes; normalized axis can be used considering its parents independently from column */\nexport interface AxisSpecNormalized extends Omit<AxisSpec, \"parentAxes\"> {\n  parentAxesSpec: AxisSpecNormalized[];\n}\n\n/** Tree: axis is a root, its parents are children */\nexport type AxisTree = {\n  axis: AxisSpecNormalized;\n  children: AxisTree[]; // parents\n};\n\nfunction makeAxisTree(axis: AxisSpecNormalized): AxisTree {\n  return { axis, children: [] };\n}\n\n/** Build tree by axis parents annotations */\nexport function getAxesTree(rootAxis: AxisSpecNormalized): AxisTree {\n  const root = makeAxisTree(rootAxis);\n  let nodesQ = [root];\n  while (nodesQ.length) {\n    const nextNodes: AxisTree[] = [];\n    for (const node of nodesQ) {\n      node.children = node.axis.parentAxesSpec.map(makeAxisTree);\n      nextNodes.push(...node.children);\n    }\n    nodesQ = nextNodes;\n  }\n  return root;\n}\n\n/** Get set of canonicalized axisIds from axisTree */\nexport function getSetFromAxisTree(tree: AxisTree): Set<CanonicalizedJson<AxisId>> {\n  const set = new Set([canonicalizeJson(getAxisId(tree.axis))]);\n  let nodesQ = [tree];\n  while (nodesQ.length) {\n    const nextNodes = [];\n    for (const node of nodesQ) {\n      for (const parent of node.children) {\n        set.add(canonicalizeJson(getAxisId(parent.axis)));\n        nextNodes.push(parent);\n      }\n    }\n    nodesQ = nextNodes;\n  }\n  return set;\n}\n\n/** Get array of axisSpecs from axisTree */\nexport function getArrayFromAxisTree(tree: AxisTree): AxisSpecNormalized[] {\n  const res = [tree.axis];\n  let nodesQ = [tree];\n  while (nodesQ.length) {\n    const nextNodes = [];\n    for (const node of nodesQ) {\n      for (const parent of node.children) {\n        res.push(parent.axis);\n        nextNodes.push(parent);\n      }\n    }\n    nodesQ = nextNodes;\n  }\n  return res;\n}\n\nexport function canonicalizeAxisWithParents(axis: AxisSpecNormalized) {\n  return canonicalizeJson(getArrayFromAxisTree(getAxesTree(axis)).map(getAxisId));\n}\n\nfunction normalizingAxesComparator(\n  axis1: AxisSpecNormalized,\n  axis2: AxisSpecNormalized,\n): 1 | -1 | 0 {\n  if (axis1.name !== axis2.name) {\n    return axis1.name < axis2.name ? 1 : -1;\n  }\n  if (axis1.type !== axis2.type) {\n    return axis1.type < axis2.type ? 1 : -1;\n  }\n  const domain1 = canonicalizeJson(axis1.domain ?? {});\n  const domain2 = canonicalizeJson(axis2.domain ?? {});\n  if (domain1 !== domain2) {\n    return domain1 < domain2 ? 1 : -1;\n  }\n\n  const contextDomain1 = canonicalizeJson(axis1.contextDomain ?? {});\n  const contextDomain2 = canonicalizeJson(axis2.contextDomain ?? {});\n  if (contextDomain1 !== contextDomain2) {\n    return contextDomain1 < contextDomain2 ? 1 : -1;\n  }\n\n  const parents1 = canonicalizeAxisWithParents(axis1);\n  const parents2 = canonicalizeAxisWithParents(axis2);\n\n  if (parents1 !== parents2) {\n    return parents1 < parents2 ? 1 : -1;\n  }\n\n  const annotation1 = canonicalizeJson(axis1.annotations ?? {});\n  const annotation2 = canonicalizeJson(axis2.annotations ?? {});\n  if (annotation1 !== annotation2) {\n    return annotation1 < annotation2 ? 1 : -1;\n  }\n  return 0;\n}\n\nfunction parseParentsFromAnnotations(axis: AxisSpec) {\n  const parentsList = readAnnotationJson(axis, Annotation.Parents);\n  if (parentsList === undefined) {\n    return [];\n  }\n  return parentsList;\n}\n\nfunction sortParentsDeep(axisSpec: AxisSpecNormalized) {\n  axisSpec.parentAxesSpec.forEach(sortParentsDeep);\n  axisSpec.parentAxesSpec.sort(normalizingAxesComparator);\n}\n\nfunction hasCycleOfParents(axisSpec: AxisSpecNormalized) {\n  const root = makeAxisTree(axisSpec);\n  let nodesQ = [root];\n  const ancestors = new Set(canonicalizeJson(getAxisId(axisSpec)));\n  while (nodesQ.length) {\n    const nextNodes: AxisTree[] = [];\n    const levelIds = new Set<CanonicalizedJson<AxisId>>();\n    for (const node of nodesQ) {\n      node.children = node.axis.parentAxesSpec.map(makeAxisTree);\n      for (const child of node.children) {\n        const childId = canonicalizeJson(getAxisId(child.axis));\n        if (!levelIds.has(childId)) {\n          nextNodes.push(child);\n          levelIds.add(childId);\n          if (ancestors.has(childId)) {\n            return true;\n          }\n          ancestors.add(childId);\n        }\n      }\n    }\n    nodesQ = nextNodes;\n  }\n  return false;\n}\n\n/** Create list of normalized axisSpec (parents are in array of specs, not indexes) */\nexport function getNormalizedAxesList(axes: AxisSpec[]): AxisSpecNormalized[] {\n  if (!axes.length) {\n    return [];\n  }\n  const modifiedAxes: AxisSpecNormalized[] = axes.map((axis) => {\n    const { parentAxes: _, ...copiedRest } = axis;\n    return { ...copiedRest, annotations: { ...copiedRest.annotations }, parentAxesSpec: [] };\n  });\n\n  axes.forEach((axis, idx) => {\n    const modifiedAxis = modifiedAxes[idx];\n    if (axis.parentAxes) {\n      // if we have parents by indexes then take from the list\n      modifiedAxis.parentAxesSpec = axis.parentAxes.map((idx) => modifiedAxes[idx]);\n    } else {\n      // else try to parse from annotation name\n      const parents = parseParentsFromAnnotations(axis).map((name) =>\n        modifiedAxes.find((axis) => axis.name === name),\n      );\n      modifiedAxis.parentAxesSpec = parents.some((p) => p === undefined)\n        ? []\n        : (parents as AxisSpecNormalized[]);\n    }\n  });\n\n  if (modifiedAxes.some(hasCycleOfParents)) {\n    // Axes list is broken\n    modifiedAxes.forEach((axis) => {\n      axis.parentAxesSpec = [];\n    });\n  } else {\n    modifiedAxes.forEach((axis) => {\n      sortParentsDeep(axis);\n    });\n  }\n\n  return modifiedAxes;\n}\n\n/** Create list of regular axisSpec from normalized (parents are indexes, inside of current axes list) */\nexport function getDenormalizedAxesList(axesSpec: AxisSpecNormalized[]): AxisSpec[] {\n  const idsList = axesSpec.map(canonicalizeAxisId);\n  return axesSpec.map((axisSpec) => {\n    const parentsIds = axisSpec.parentAxesSpec.map(canonicalizeAxisId);\n    const parentIdxs = parentsIds.map((id) => idsList.indexOf(id));\n    const { parentAxesSpec: _, ...copiedRest } = axisSpec;\n    if (parentIdxs.length) {\n      return { ...copiedRest, parentAxes: parentIdxs } as AxisSpec;\n    }\n    return copiedRest;\n  });\n}\n\n/**\n * Resolve annotation-based parents (`pl7.app/parents`) to numeric `parentAxes`\n * on a column spec. Returns the spec unchanged if all axes already use numeric\n * indices or have no parent annotations.\n */\nexport function resolveAnnotationParents(spec: PColumnSpec): PColumnSpec {\n  const hasAnnotationParents = spec.axesSpec.some(\n    (axis) => !!readAnnotationJson(axis, Annotation.Parents),\n  );\n  if (!hasAnnotationParents) return spec;\n\n  const normalized = getNormalizedAxesList(spec.axesSpec);\n  const denormalized = getDenormalizedAxesList(normalized);\n  return { ...spec, axesSpec: denormalized };\n}\n\n/** Common type representing spec for all the axes in a column */\nexport type AxesSpec = AxisSpec[];\n\n/// Well-known column names\nexport const PColumnName = {\n  Label: \"pl7.app/label\",\n  Table: {\n    RowSelection: \"pl7.app/table/row-selection\",\n  },\n  VDJ: {\n    LeadSelection: \"pl7.app/vdj/lead-selection\",\n    RankingOrder: \"pl7.app/vdj/ranking-order\",\n    Sequence: \"pl7.app/vdj/sequence\",\n  },\n} as const;\n\n/// Well-known axis names\nexport const PAxisName = {\n  SampleId: \"pl7.app/sampleId\",\n  VDJ: {\n    Assay: {\n      SequenceId: \"pl7.app/vdj/assay/sequenceId\",\n    },\n    ClusterId: \"pl7.app/vdj/clusterId\",\n    ClonotypeKey: \"pl7.app/vdj/clonotypeKey\",\n    ScClonotypeKey: \"pl7.app/vdj/scClonotypeKey\",\n  },\n} as const;\n\nexport function isLabelColumn(column: PColumnSpec) {\n  return column.axesSpec.length === 1 && column.name === PColumnName.Label;\n}\n\n/**\n * Full column specification including all axes specs and specs of the column\n * itself.\n *\n * A PColumn in its essence represents a mapping from a fixed size, explicitly\n * typed tuple to an explicitly typed value.\n *\n * (axis1Value1, axis2Value1, ...) -> columnValue\n *\n * Each element in tuple correspond to the axis having the same index in axesSpec.\n */\nexport type PUniversalColumnSpec = PObjectSpec & {\n  /** Defines specific type of BObject, the most generic type of unit of\n   * information in Platforma Project. */\n  readonly kind: \"PColumn\";\n\n  /** Type of column values */\n  readonly valueType: string;\n\n  /** Column name */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis name, type and parents to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional column identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n\n  /** Any additional information attached to the column that does not affect its\n   * identifier */\n  readonly annotations?: Record<string, string>;\n\n  /** A list of zero-based indices of parent axes from the {@link axesSpec} array. */\n  readonly parentAxes?: number[];\n\n  /** Axes specifications */\n  readonly axesSpec: AxesSpec;\n};\n\n/**\n * Specification of a data column.\n *\n * Data column is a specialized type of PColumn that stores only simple values (strings and numbers)\n * addressed by multiple keys. This is in contrast to other PColumn variants that can store more complex\n * values like files or other abstract data types. Data columns are optimized for storing and processing\n * basic tabular data.\n */\nexport type PDataColumnSpec = PUniversalColumnSpec & {\n  /** Type of column values */\n  readonly valueType: ValueType;\n};\n\n// @todo: change this to PUniversalColumnSpec\nexport type PColumnSpec = PDataColumnSpec;\n\n/** Unique PColumnSpec identifier */\nexport type PColumnSpecId = {\n  /** Defines specific type of BObject, the most generic type of unit of\n   * information in Platforma Project. */\n  readonly kind: \"PColumn\";\n\n  /** Type of column values */\n  readonly valueType: ValueType;\n\n  /** Column name */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis name, type and parents to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional column identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n\n  /** A list of zero-based indices of parent axes from the {@link axesSpec} array. */\n  readonly parentAxes?: number[];\n\n  /** Axes id */\n  readonly axesId: AxesId;\n};\n\nexport function getPColumnSpecId(spec: PColumnSpec): PColumnSpecId {\n  return {\n    kind: spec.kind,\n    valueType: spec.valueType,\n    name: spec.name,\n    domain: spec.domain,\n    contextDomain: spec.contextDomain,\n    parentAxes: spec.parentAxes,\n    axesId: getAxesId(spec.axesSpec),\n  };\n}\n\nexport interface PColumn<Data> extends PObject<Data> {\n  /** PColumn spec, allowing it to be found among other PObjects */\n  readonly spec: PColumnSpec;\n}\n\nexport type PColumnLazy<T> = PColumn<() => T>;\n\n/** Columns in a PFrame also have internal identifier, this object represents\n * combination of specs and such id */\nexport interface PColumnIdAndSpec {\n  /** Internal column id within the PFrame */\n  readonly columnId: PObjectId;\n\n  /** Column spec */\n  readonly spec: PColumnSpec;\n}\n\n/** Get column id and spec from a column */\nexport function getColumnIdAndSpec<Data>(column: PColumn<Data>): PColumnIdAndSpec {\n  return {\n    columnId: column.id,\n    spec: column.spec,\n  };\n}\n\nexport interface AxisId {\n  /** Type of the axis or column value. For an axis should not use non-key\n   * types like float or double. */\n  readonly type: AxisValueType;\n\n  /** Name of the axis or column */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis or column name and type to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional axis identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n}\n\n/** Array of axis ids */\nexport type AxesId = AxisId[];\n\n/** Extracts axis ids from axis spec */\nexport function getAxisId(spec: AxisSpec): AxisId {\n  const { type, name, domain, contextDomain } = spec;\n  const result: AxisId = { type, name };\n  if (domain && Object.entries(domain).length > 0) {\n    Object.assign(result, { domain });\n  }\n  if (contextDomain && Object.entries(contextDomain).length > 0) {\n    Object.assign(result, { contextDomain });\n  }\n  return result;\n}\n\n/** Extracts axes ids from axes spec array from column spec */\nexport function getAxesId(spec: AxesSpec): AxesId {\n  return spec.map(getAxisId);\n}\n\n/** Canonicalizes axis id */\nexport function canonicalizeAxisId(id: AxisId): CanonicalizedJson<AxisId> {\n  return canonicalizeJson(getAxisId(id));\n}\n\n/** Returns true if all domains from query are found in target */\nfunction matchDomain(query?: Record<string, string>, target?: Record<string, string>) {\n  if (query === undefined) return target === undefined;\n  if (target === undefined) return true;\n  for (const k in target) {\n    if (query[k] !== target[k]) return false;\n  }\n  return true;\n}\n\n/** Returns whether \"match\" axis id is compatible with the \"query\" */\nexport function matchAxisId(query: AxisId, target: AxisId): boolean {\n  return (\n    query.name === target.name &&\n    matchDomain(query.domain, target.domain) &&\n    matchDomain(query.contextDomain, target.contextDomain)\n  );\n}\n\nexport function getTypeFromPColumnOrAxisSpec(spec: PColumnSpec | AxisSpec): ValueType {\n  return \"valueType\" in spec ? spec.valueType : spec.type;\n}\n\nexport function isAxisId(id: unknown): id is AxisId {\n  return typeof id === \"object\" && id !== null && \"name\" in id && \"type\" in id;\n}\n"],"mappings":"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"}

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

@@ -339,11 +339,6 @@ interface PColumnIdAndSpec {
 }
 /** Get column id and spec from a column */
 declare function getColumnIdAndSpec<Data>(column: PColumn<Data>): PColumnIdAndSpec;
-/** Information returned by {@link PFrame.listColumns} method */
-interface PColumnInfo extends PColumnIdAndSpec {
-  /** True if data was associated with this PColumn */
-  readonly hasData: boolean;
-}
 interface AxisId {
   /** Type of the axis or column value. For an axis should not use non-key
    * types like float or double. */
@@ -370,5 +365,5 @@ declare function matchAxisId(query: AxisId, target: AxisId): boolean;
 declare function getTypeFromPColumnOrAxisSpec(spec: PColumnSpec | AxisSpec): ValueType;
 declare function isAxisId(id: unknown): id is AxisId;
 //#endregion
-export { Annotation, AnnotationDataStatus, AnnotationJson, AxesId, AxesSpec, AxisId, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, ColumnValueType, Domain, DomainJson, Metadata, MetadataJson, PAxisName, PColumn, PColumnIdAndSpec, PColumnInfo, 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 };
+export { 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 };
 //# sourceMappingURL=spec.d.ts.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"spec.js","names":[],"sources":["../../../../src/drivers/pframe/spec/spec.ts"],"sourcesContent":["import { ensureError } from \"../../../errors\";\nimport { canonicalizeJson, type CanonicalizedJson, type StringifiedJson } from \"../../../json\";\nimport type { PObject, PObjectId, PObjectSpec } from \"../../../pool\";\nimport { z } from \"zod\";\n\nexport const ValueType = {\n  Int: \"Int\",\n  Long: \"Long\",\n  Float: \"Float\",\n  Double: \"Double\",\n  String: \"String\",\n  Bytes: \"Bytes\",\n} as const;\n\nexport type AxisValueType = Extract<ValueType, \"Int\" | \"Long\" | \"String\">;\nexport type ColumnValueType = ValueType;\n\n/** PFrame columns and axes within them may store one of these types. */\nexport type ValueType = (typeof ValueType)[keyof typeof ValueType];\n\nexport type Metadata = Record<string, string>;\n\nexport function readMetadata<U extends Metadata, T extends keyof U = keyof U>(\n  metadata: Metadata | undefined,\n  key: T,\n): U[T] | undefined {\n  return (metadata as U | undefined)?.[key];\n}\n\ntype MetadataJsonImpl<M> = {\n  [P in keyof M as M[P] extends StringifiedJson ? P : never]: M[P] extends StringifiedJson<infer U>\n    ? z.ZodType<U>\n    : never;\n};\nexport type MetadataJson<M> = MetadataJsonImpl<Required<M>>;\n\nexport function readMetadataJsonOrThrow<M extends Metadata, T extends keyof MetadataJson<M>>(\n  metadata: Metadata | undefined,\n  metadataJson: MetadataJson<M>,\n  key: T,\n  methodNameInError: string = \"readMetadataJsonOrThrow\",\n): z.infer<MetadataJson<M>[T]> | undefined {\n  const json = readMetadata<M, T>(metadata, key);\n  if (json === undefined) return undefined;\n\n  const schema = metadataJson[key];\n  try {\n    const value = JSON.parse(json);\n    return schema.parse(value);\n  } catch (error: unknown) {\n    throw new Error(\n      `${methodNameInError} failed, ` +\n        `key: ${String(key)}, ` +\n        `value: ${json}, ` +\n        `error: ${ensureError(error)}`,\n    );\n  }\n}\n\nexport function readMetadataJson<M extends Metadata, T extends keyof MetadataJson<M>>(\n  metadata: Metadata | undefined,\n  metadataJson: MetadataJson<M>,\n  key: T,\n): z.infer<MetadataJson<M>[T]> | undefined {\n  try {\n    return readMetadataJsonOrThrow(metadata, metadataJson, key);\n  } catch {\n    return undefined; // treat invalid values as unset\n  }\n}\n\n/// Well-known domains\nexport const Domain = {\n  Alphabet: \"pl7.app/alphabet\",\n  BlockId: \"pl7.app/blockId\",\n  VDJ: {\n    Clustering: {\n      BlockId: \"pl7.app/vdj/clustering/blockId\",\n    },\n    ScClonotypeChain: {\n      Index: \"pl7.app/vdj/scClonotypeChain/index\",\n    },\n  },\n} as const;\n\nexport type Domain = Metadata &\n  Partial<{\n    [Domain.Alphabet]: \"nucleotide\" | \"aminoacid\" | (string & {});\n    [Domain.BlockId]: string;\n    [Domain.VDJ.ScClonotypeChain.Index]: \"primary\" | \"secondary\" | (string & {});\n  }>;\n\nexport type DomainJson = MetadataJson<Domain>;\nexport const DomainJson: DomainJson = {};\n\n/// Helper function for reading plain domain values\nexport function readDomain<T extends keyof Domain>(\n  spec: { domain?: Metadata | undefined } | undefined,\n  key: T,\n): Domain[T] | undefined {\n  return readMetadata<Domain, T>(spec?.domain, key);\n}\n\n/// Helper function for reading json-encoded domain values, throws on JSON parsing error\nexport function readDomainJsonOrThrow<T extends keyof DomainJson>(\n  spec: { domain?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<DomainJson[T]> | undefined {\n  return readMetadataJsonOrThrow<Domain, T>(spec?.domain, DomainJson, key, \"readDomainJsonOrThrow\");\n}\n\n/// Helper function for reading json-encoded domain values, returns undefined on JSON parsing error\nexport function readDomainJson<T extends keyof DomainJson>(\n  spec: { domain?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<DomainJson[T]> | undefined {\n  return readMetadataJson<Domain, T>(spec?.domain, DomainJson, key);\n}\n\n/// Well-known annotations\nexport const Annotation = {\n  AxisNature: \"pl7.app/axisNature\",\n  Alphabet: \"pl7.app/alphabet\",\n  Description: \"pl7.app/description\",\n  DataStatus: \"pl7.app/dataStatus\",\n  DiscreteValues: \"pl7.app/discreteValues\",\n  Format: \"pl7.app/format\",\n  Graph: {\n    Axis: {\n      HighCardinality: \"pl7.app/graph/axis/highCardinality\",\n      LowerLimit: \"pl7.app/graph/axis/lowerLimit\",\n      SymmetricRange: \"pl7.app/graph/axis/symmetricRange\",\n      UpperLimit: \"pl7.app/graph/axis/upperLimit\",\n    },\n    IsDenseAxis: \"pl7.app/graph/isDenseAxis\",\n    IsVirtual: \"pl7.app/graph/isVirtual\",\n    Palette: \"pl7.app/graph/palette\",\n    Thresholds: \"pl7.app/graph/thresholds\",\n    TreatAbsentValuesAs: \"pl7.app/graph/treatAbsentValuesAs\",\n  },\n  HideDataFromUi: \"pl7.app/hideDataFromUi\",\n  HideDataFromGraphs: \"pl7.app/hideDataFromGraphs\",\n  IsDiscreteFilter: \"pl7.app/isDiscreteFilter\",\n  IsAnchor: \"pl7.app/isAnchor\",\n  IsLinkerColumn: \"pl7.app/isLinkerColumn\",\n  IsScore: \"pl7.app/isScore\",\n  IsSubset: \"pl7.app/isSubset\",\n  Label: \"pl7.app/label\",\n  LinkLabel: \"pl7.app/linkLabel\",\n  Max: \"pl7.app/max\",\n  Min: \"pl7.app/min\",\n  MultipliesBy: \"pl7.app/multipliesBy\",\n  Parents: \"pl7.app/parents\",\n  Score: {\n    DefaultCutoff: \"pl7.app/score/defaultCutoff\",\n    RankingOrder: \"pl7.app/score/rankingOrder\",\n  },\n  Sequence: {\n    Annotation: {\n      Mapping: \"pl7.app/sequence/annotation/mapping\",\n    },\n    IsAnnotation: \"pl7.app/sequence/isAnnotation\",\n  },\n  Table: {\n    FontFamily: \"pl7.app/table/fontFamily\",\n    OrderPriority: \"pl7.app/table/orderPriority\",\n    Visibility: \"pl7.app/table/visibility\",\n    Info: \"pl7.app/table/info\",\n  },\n  Trace: \"pl7.app/trace\",\n  VDJ: {\n    IsAssemblingFeature: \"pl7.app/vdj/isAssemblingFeature\",\n    IsMainSequence: \"pl7.app/vdj/isMainSequence\",\n  },\n} as const;\n\nexport type AnnotationDataStatus = \"computing\" | \"ready\" | \"error\" | \"absent\";\n\nexport type Annotation = Metadata &\n  Partial<{\n    [Annotation.Alphabet]: \"nucleotide\" | \"aminoacid\" | (string & {});\n    [Annotation.AxisNature]: \"homogeneous\" | \"heterogeneous\" | \"scaleCompatible\" | (string & {});\n    [Annotation.Description]: string;\n    [Annotation.DataStatus]: AnnotationDataStatus;\n    [Annotation.DiscreteValues]: StringifiedJson<number[]> | StringifiedJson<string[]>;\n    [Annotation.Format]: string;\n    [Annotation.Graph.Axis.HighCardinality]: StringifiedJson<boolean>;\n    [Annotation.Graph.Axis.LowerLimit]: StringifiedJson<number>;\n    [Annotation.Graph.Axis.SymmetricRange]: StringifiedJson<boolean>;\n    [Annotation.Graph.Axis.UpperLimit]: StringifiedJson<number>;\n    [Annotation.Graph.IsDenseAxis]: StringifiedJson<boolean>;\n    [Annotation.Graph.IsVirtual]: StringifiedJson<boolean>;\n    [Annotation.Graph.Palette]: StringifiedJson<{ mapping: Record<string, number>; name: string }>;\n    [Annotation.Graph.Thresholds]: StringifiedJson<\n      { columnId: { valueType: ValueType; name: string }; value: number }[]\n    >;\n    [Annotation.Graph.TreatAbsentValuesAs]: StringifiedJson<number>;\n    [Annotation.HideDataFromGraphs]: StringifiedJson<boolean>;\n    [Annotation.HideDataFromUi]: StringifiedJson<boolean>;\n    [Annotation.IsDiscreteFilter]: StringifiedJson<boolean>;\n    [Annotation.IsLinkerColumn]: StringifiedJson<boolean>;\n    [Annotation.IsSubset]: StringifiedJson<boolean>;\n    [Annotation.Label]: string;\n    [Annotation.Max]: StringifiedJson<number>;\n    [Annotation.Min]: StringifiedJson<number>;\n    [Annotation.MultipliesBy]: StringifiedJson<AxisSpec[\"name\"][]>;\n    [Annotation.Parents]: StringifiedJson<AxisSpec[\"name\"][]>;\n    [Annotation.Sequence.Annotation.Mapping]: StringifiedJson<Record<string, string>>;\n    [Annotation.Sequence.IsAnnotation]: StringifiedJson<boolean>;\n    [Annotation.Table.FontFamily]: string;\n    [Annotation.Table.OrderPriority]: StringifiedJson<number>;\n    [Annotation.Table.Visibility]: \"hidden\" | \"optional\" | (string & {});\n    [Annotation.Table.Info]: string;\n    [Annotation.Trace]: StringifiedJson<Trace>;\n    [Annotation.VDJ.IsAssemblingFeature]: StringifiedJson<boolean>;\n  }>;\n\n/// One step in a column's derivation lineage. Only `type` and `label` are part\n/// of the typed public surface; writers may add fields (e.g. `id`, `importance`)\n/// passed through opaquely as `unknown`, accessed via explicit narrowing.\nconst TraceEntrySchema = z\n  .object({\n    type: z.string(),\n    label: z.string(),\n  })\n  .catchall(z.unknown());\n\nexport type TraceEntry = z.infer<typeof TraceEntrySchema>;\n\nexport type Trace = TraceEntry[];\n\n// export const AxisSpec = z.object({\n//   type: z.nativeEnum(ValueType),\n//   name: z.string(),\n//   domain: z.record(z.string(), z.string()).optional(),\n//   annotations: z.record(z.string(), z.string()).optional(),\n//   parentAxes: z.array(z.number()).optional(),\n// }).passthrough();\n//\n// type Expect<T extends true> = T;\n// type Equal<X, Y> =\n// (<T>() => T extends X ? 1 : 2) extends (<T>() => T extends Y ? 1 : 2) ? true : false;\n//\n// type _test = Expect<Equal<\n//   Readonly<z.infer<typeof AxisSpec>>,\n//   Readonly<AxisSpec & Record<string, unknown>>\n// >>;\n\nexport type AnnotationJson = MetadataJson<Annotation>;\n\nconst ValueTypeSchema = z.enum([\"Int\", \"Long\", \"Float\", \"Double\", \"String\"] as const);\nexport const AnnotationJson: AnnotationJson = {\n  [Annotation.DiscreteValues]: z.array(z.string()).or(z.array(z.number())),\n  [Annotation.Graph.Axis.HighCardinality]: z.boolean(),\n  [Annotation.Graph.Axis.LowerLimit]: z.number(),\n  [Annotation.Graph.Axis.UpperLimit]: z.number(),\n  [Annotation.Graph.Axis.SymmetricRange]: z.boolean(),\n  [Annotation.Graph.IsDenseAxis]: z.boolean(),\n  [Annotation.Graph.Palette]: z.object({ mapping: z.record(z.number()), name: z.string() }),\n  [Annotation.Graph.Thresholds]: z.array(\n    z.object({\n      columnId: z.object({ valueType: ValueTypeSchema, name: z.string() }),\n      value: z.number(),\n    }),\n  ),\n  [Annotation.Graph.TreatAbsentValuesAs]: z.number(),\n  [Annotation.Graph.IsVirtual]: z.boolean(),\n  [Annotation.HideDataFromUi]: z.boolean(),\n  [Annotation.HideDataFromGraphs]: z.boolean(),\n  [Annotation.IsDiscreteFilter]: z.boolean(),\n  [Annotation.IsLinkerColumn]: z.boolean(),\n  [Annotation.IsSubset]: z.boolean(),\n  [Annotation.Max]: z.number(),\n  [Annotation.Min]: z.number(),\n  [Annotation.MultipliesBy]: z.array(z.string()),\n  [Annotation.Parents]: z.array(z.string()),\n  [Annotation.Sequence.Annotation.Mapping]: z.record(z.string(), z.string()),\n  [Annotation.Sequence.IsAnnotation]: z.boolean(),\n  [Annotation.Table.OrderPriority]: z.number(),\n  [Annotation.Trace]: z.array(TraceEntrySchema),\n  [Annotation.VDJ.IsAssemblingFeature]: z.boolean(),\n};\n\n/// Helper function for reading plain annotation values\nexport function readAnnotation<T extends keyof Annotation>(\n  spec: { annotations?: Metadata | undefined } | undefined,\n  key: T,\n): Annotation[T] | undefined {\n  return readMetadata<Annotation, T>(spec?.annotations, key);\n}\n\n/// Helper function for reading json-encoded annotation values, throws on JSON parsing error\nexport function readAnnotationJsonOrThrow<T extends keyof AnnotationJson>(\n  spec: { annotations?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<AnnotationJson[T]> | undefined {\n  return readMetadataJsonOrThrow<Annotation, T>(\n    spec?.annotations,\n    AnnotationJson,\n    key,\n    \"readAnnotationJsonOrThrow\",\n  );\n}\n\n/// Helper function for reading json-encoded annotation values, returns undefined on JSON parsing error\nexport function readAnnotationJson<T extends keyof AnnotationJson>(\n  spec: { annotations?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<AnnotationJson[T]> | undefined {\n  return readMetadataJson<Annotation, T>(spec?.annotations, AnnotationJson, key);\n}\n\nexport function isLinkerColumn(column: PColumnSpec): boolean {\n  return !!readAnnotationJson(column, Annotation.IsLinkerColumn);\n}\n\n/**\n * Specification of an individual axis.\n *\n * Each axis is a part of a composite key that addresses data inside the PColumn.\n *\n * Each record inside a PColumn is addressed by a unique tuple of values set for\n * all the axes specified in the column spec.\n */\nexport type AxisSpec = {\n  /** Type of the axis value. Should not use non-key types like float or double. */\n  readonly type: AxisValueType;\n\n  /** Name of the axis */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis name, type and parents to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional axis identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n\n  /** Any additional information attached to the axis that does not affect its\n   * identifier */\n  readonly annotations?: Record<string, string>;\n\n  /**\n   * Parent axes provide contextual grouping for the axis in question, establishing\n   * a hierarchy where the current axis is dependent on one or more axes for its\n   * full definition and meaning. For instance, in a data structure where each\n   * \"container\" axis may contain multiple \"item\" axes, the `item` axis would\n   * list the index of the `container` axis in this field to denote its dependency.\n   *\n   * This means that the identity or significance of the `item` axis is only\n   * interpretable when combined with its parent `container` axis. An `item` axis\n   * index by itself may be non-unique and only gains uniqueness within the context\n   * of its parent `container`. Therefore, the `parentAxes` field is essential for\n   * mapping these relationships and ensuring data coherence across nested or\n   * multi-level data models.\n   *\n   * A list of zero-based indices of parent axes in the overall axes specification\n   * from the column spec. Each index corresponds to the position of a parent axis\n   * in the list that defines the structure of the data model.\n   */\n  readonly parentAxes?: number[];\n};\n\n/** Parents are specs, not indexes; normalized axis can be used considering its parents independently from column */\nexport interface AxisSpecNormalized extends Omit<AxisSpec, \"parentAxes\"> {\n  parentAxesSpec: AxisSpecNormalized[];\n}\n\n/** Tree: axis is a root, its parents are children */\nexport type AxisTree = {\n  axis: AxisSpecNormalized;\n  children: AxisTree[]; // parents\n};\n\nfunction makeAxisTree(axis: AxisSpecNormalized): AxisTree {\n  return { axis, children: [] };\n}\n\n/** Build tree by axis parents annotations */\nexport function getAxesTree(rootAxis: AxisSpecNormalized): AxisTree {\n  const root = makeAxisTree(rootAxis);\n  let nodesQ = [root];\n  while (nodesQ.length) {\n    const nextNodes: AxisTree[] = [];\n    for (const node of nodesQ) {\n      node.children = node.axis.parentAxesSpec.map(makeAxisTree);\n      nextNodes.push(...node.children);\n    }\n    nodesQ = nextNodes;\n  }\n  return root;\n}\n\n/** Get set of canonicalized axisIds from axisTree */\nexport function getSetFromAxisTree(tree: AxisTree): Set<CanonicalizedJson<AxisId>> {\n  const set = new Set([canonicalizeJson(getAxisId(tree.axis))]);\n  let nodesQ = [tree];\n  while (nodesQ.length) {\n    const nextNodes = [];\n    for (const node of nodesQ) {\n      for (const parent of node.children) {\n        set.add(canonicalizeJson(getAxisId(parent.axis)));\n        nextNodes.push(parent);\n      }\n    }\n    nodesQ = nextNodes;\n  }\n  return set;\n}\n\n/** Get array of axisSpecs from axisTree */\nexport function getArrayFromAxisTree(tree: AxisTree): AxisSpecNormalized[] {\n  const res = [tree.axis];\n  let nodesQ = [tree];\n  while (nodesQ.length) {\n    const nextNodes = [];\n    for (const node of nodesQ) {\n      for (const parent of node.children) {\n        res.push(parent.axis);\n        nextNodes.push(parent);\n      }\n    }\n    nodesQ = nextNodes;\n  }\n  return res;\n}\n\nexport function canonicalizeAxisWithParents(axis: AxisSpecNormalized) {\n  return canonicalizeJson(getArrayFromAxisTree(getAxesTree(axis)).map(getAxisId));\n}\n\nfunction normalizingAxesComparator(\n  axis1: AxisSpecNormalized,\n  axis2: AxisSpecNormalized,\n): 1 | -1 | 0 {\n  if (axis1.name !== axis2.name) {\n    return axis1.name < axis2.name ? 1 : -1;\n  }\n  if (axis1.type !== axis2.type) {\n    return axis1.type < axis2.type ? 1 : -1;\n  }\n  const domain1 = canonicalizeJson(axis1.domain ?? {});\n  const domain2 = canonicalizeJson(axis2.domain ?? {});\n  if (domain1 !== domain2) {\n    return domain1 < domain2 ? 1 : -1;\n  }\n\n  const contextDomain1 = canonicalizeJson(axis1.contextDomain ?? {});\n  const contextDomain2 = canonicalizeJson(axis2.contextDomain ?? {});\n  if (contextDomain1 !== contextDomain2) {\n    return contextDomain1 < contextDomain2 ? 1 : -1;\n  }\n\n  const parents1 = canonicalizeAxisWithParents(axis1);\n  const parents2 = canonicalizeAxisWithParents(axis2);\n\n  if (parents1 !== parents2) {\n    return parents1 < parents2 ? 1 : -1;\n  }\n\n  const annotation1 = canonicalizeJson(axis1.annotations ?? {});\n  const annotation2 = canonicalizeJson(axis2.annotations ?? {});\n  if (annotation1 !== annotation2) {\n    return annotation1 < annotation2 ? 1 : -1;\n  }\n  return 0;\n}\n\nfunction parseParentsFromAnnotations(axis: AxisSpec) {\n  const parentsList = readAnnotationJson(axis, Annotation.Parents);\n  if (parentsList === undefined) {\n    return [];\n  }\n  return parentsList;\n}\n\nfunction sortParentsDeep(axisSpec: AxisSpecNormalized) {\n  axisSpec.parentAxesSpec.forEach(sortParentsDeep);\n  axisSpec.parentAxesSpec.sort(normalizingAxesComparator);\n}\n\nfunction hasCycleOfParents(axisSpec: AxisSpecNormalized) {\n  const root = makeAxisTree(axisSpec);\n  let nodesQ = [root];\n  const ancestors = new Set(canonicalizeJson(getAxisId(axisSpec)));\n  while (nodesQ.length) {\n    const nextNodes: AxisTree[] = [];\n    const levelIds = new Set<CanonicalizedJson<AxisId>>();\n    for (const node of nodesQ) {\n      node.children = node.axis.parentAxesSpec.map(makeAxisTree);\n      for (const child of node.children) {\n        const childId = canonicalizeJson(getAxisId(child.axis));\n        if (!levelIds.has(childId)) {\n          nextNodes.push(child);\n          levelIds.add(childId);\n          if (ancestors.has(childId)) {\n            return true;\n          }\n          ancestors.add(childId);\n        }\n      }\n    }\n    nodesQ = nextNodes;\n  }\n  return false;\n}\n\n/** Create list of normalized axisSpec (parents are in array of specs, not indexes) */\nexport function getNormalizedAxesList(axes: AxisSpec[]): AxisSpecNormalized[] {\n  if (!axes.length) {\n    return [];\n  }\n  const modifiedAxes: AxisSpecNormalized[] = axes.map((axis) => {\n    const { parentAxes: _, ...copiedRest } = axis;\n    return { ...copiedRest, annotations: { ...copiedRest.annotations }, parentAxesSpec: [] };\n  });\n\n  axes.forEach((axis, idx) => {\n    const modifiedAxis = modifiedAxes[idx];\n    if (axis.parentAxes) {\n      // if we have parents by indexes then take from the list\n      modifiedAxis.parentAxesSpec = axis.parentAxes.map((idx) => modifiedAxes[idx]);\n    } else {\n      // else try to parse from annotation name\n      const parents = parseParentsFromAnnotations(axis).map((name) =>\n        modifiedAxes.find((axis) => axis.name === name),\n      );\n      modifiedAxis.parentAxesSpec = parents.some((p) => p === undefined)\n        ? []\n        : (parents as AxisSpecNormalized[]);\n    }\n  });\n\n  if (modifiedAxes.some(hasCycleOfParents)) {\n    // Axes list is broken\n    modifiedAxes.forEach((axis) => {\n      axis.parentAxesSpec = [];\n    });\n  } else {\n    modifiedAxes.forEach((axis) => {\n      sortParentsDeep(axis);\n    });\n  }\n\n  return modifiedAxes;\n}\n\n/** Create list of regular axisSpec from normalized (parents are indexes, inside of current axes list) */\nexport function getDenormalizedAxesList(axesSpec: AxisSpecNormalized[]): AxisSpec[] {\n  const idsList = axesSpec.map(canonicalizeAxisId);\n  return axesSpec.map((axisSpec) => {\n    const parentsIds = axisSpec.parentAxesSpec.map(canonicalizeAxisId);\n    const parentIdxs = parentsIds.map((id) => idsList.indexOf(id));\n    const { parentAxesSpec: _, ...copiedRest } = axisSpec;\n    if (parentIdxs.length) {\n      return { ...copiedRest, parentAxes: parentIdxs } as AxisSpec;\n    }\n    return copiedRest;\n  });\n}\n\n/**\n * Resolve annotation-based parents (`pl7.app/parents`) to numeric `parentAxes`\n * on a column spec. Returns the spec unchanged if all axes already use numeric\n * indices or have no parent annotations.\n */\nexport function resolveAnnotationParents(spec: PColumnSpec): PColumnSpec {\n  const hasAnnotationParents = spec.axesSpec.some(\n    (axis) => !!readAnnotationJson(axis, Annotation.Parents),\n  );\n  if (!hasAnnotationParents) return spec;\n\n  const normalized = getNormalizedAxesList(spec.axesSpec);\n  const denormalized = getDenormalizedAxesList(normalized);\n  return { ...spec, axesSpec: denormalized };\n}\n\n/** Common type representing spec for all the axes in a column */\nexport type AxesSpec = AxisSpec[];\n\n/// Well-known column names\nexport const PColumnName = {\n  Label: \"pl7.app/label\",\n  Table: {\n    RowSelection: \"pl7.app/table/row-selection\",\n  },\n  VDJ: {\n    LeadSelection: \"pl7.app/vdj/lead-selection\",\n    RankingOrder: \"pl7.app/vdj/ranking-order\",\n    Sequence: \"pl7.app/vdj/sequence\",\n  },\n} as const;\n\n/// Well-known axis names\nexport const PAxisName = {\n  SampleId: \"pl7.app/sampleId\",\n  VDJ: {\n    Assay: {\n      SequenceId: \"pl7.app/vdj/assay/sequenceId\",\n    },\n    ClusterId: \"pl7.app/vdj/clusterId\",\n    ClonotypeKey: \"pl7.app/vdj/clonotypeKey\",\n    ScClonotypeKey: \"pl7.app/vdj/scClonotypeKey\",\n  },\n} as const;\n\nexport function isLabelColumn(column: PColumnSpec) {\n  return column.axesSpec.length === 1 && column.name === PColumnName.Label;\n}\n\n/**\n * Full column specification including all axes specs and specs of the column\n * itself.\n *\n * A PColumn in its essence represents a mapping from a fixed size, explicitly\n * typed tuple to an explicitly typed value.\n *\n * (axis1Value1, axis2Value1, ...) -> columnValue\n *\n * Each element in tuple correspond to the axis having the same index in axesSpec.\n */\nexport type PUniversalColumnSpec = PObjectSpec & {\n  /** Defines specific type of BObject, the most generic type of unit of\n   * information in Platforma Project. */\n  readonly kind: \"PColumn\";\n\n  /** Type of column values */\n  readonly valueType: string;\n\n  /** Column name */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis name, type and parents to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional column identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n\n  /** Any additional information attached to the column that does not affect its\n   * identifier */\n  readonly annotations?: Record<string, string>;\n\n  /** A list of zero-based indices of parent axes from the {@link axesSpec} array. */\n  readonly parentAxes?: number[];\n\n  /** Axes specifications */\n  readonly axesSpec: AxesSpec;\n};\n\n/**\n * Specification of a data column.\n *\n * Data column is a specialized type of PColumn that stores only simple values (strings and numbers)\n * addressed by multiple keys. This is in contrast to other PColumn variants that can store more complex\n * values like files or other abstract data types. Data columns are optimized for storing and processing\n * basic tabular data.\n */\nexport type PDataColumnSpec = PUniversalColumnSpec & {\n  /** Type of column values */\n  readonly valueType: ValueType;\n};\n\n// @todo: change this to PUniversalColumnSpec\nexport type PColumnSpec = PDataColumnSpec;\n\n/** Unique PColumnSpec identifier */\nexport type PColumnSpecId = {\n  /** Defines specific type of BObject, the most generic type of unit of\n   * information in Platforma Project. */\n  readonly kind: \"PColumn\";\n\n  /** Type of column values */\n  readonly valueType: ValueType;\n\n  /** Column name */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis name, type and parents to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional column identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n\n  /** A list of zero-based indices of parent axes from the {@link axesSpec} array. */\n  readonly parentAxes?: number[];\n\n  /** Axes id */\n  readonly axesId: AxesId;\n};\n\nexport function getPColumnSpecId(spec: PColumnSpec): PColumnSpecId {\n  return {\n    kind: spec.kind,\n    valueType: spec.valueType,\n    name: spec.name,\n    domain: spec.domain,\n    contextDomain: spec.contextDomain,\n    parentAxes: spec.parentAxes,\n    axesId: getAxesId(spec.axesSpec),\n  };\n}\n\nexport interface PColumn<Data> extends PObject<Data> {\n  /** PColumn spec, allowing it to be found among other PObjects */\n  readonly spec: PColumnSpec;\n}\n\nexport type PColumnLazy<T> = PColumn<() => T>;\n\n/** Columns in a PFrame also have internal identifier, this object represents\n * combination of specs and such id */\nexport interface PColumnIdAndSpec {\n  /** Internal column id within the PFrame */\n  readonly columnId: PObjectId;\n\n  /** Column spec */\n  readonly spec: PColumnSpec;\n}\n\n/** Get column id and spec from a column */\nexport function getColumnIdAndSpec<Data>(column: PColumn<Data>): PColumnIdAndSpec {\n  return {\n    columnId: column.id,\n    spec: column.spec,\n  };\n}\n\n/** Information returned by {@link PFrame.listColumns} method */\nexport interface PColumnInfo extends PColumnIdAndSpec {\n  /** True if data was associated with this PColumn */\n  readonly hasData: boolean;\n}\n\nexport interface AxisId {\n  /** Type of the axis or column value. For an axis should not use non-key\n   * types like float or double. */\n  readonly type: AxisValueType;\n\n  /** Name of the axis or column */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis or column name and type to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional axis identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n}\n\n/** Array of axis ids */\nexport type AxesId = AxisId[];\n\n/** Extracts axis ids from axis spec */\nexport function getAxisId(spec: AxisSpec): AxisId {\n  const { type, name, domain, contextDomain } = spec;\n  const result: AxisId = { type, name };\n  if (domain && Object.entries(domain).length > 0) {\n    Object.assign(result, { domain });\n  }\n  if (contextDomain && Object.entries(contextDomain).length > 0) {\n    Object.assign(result, { contextDomain });\n  }\n  return result;\n}\n\n/** Extracts axes ids from axes spec array from column spec */\nexport function getAxesId(spec: AxesSpec): AxesId {\n  return spec.map(getAxisId);\n}\n\n/** Canonicalizes axis id */\nexport function canonicalizeAxisId(id: AxisId): CanonicalizedJson<AxisId> {\n  return canonicalizeJson(getAxisId(id));\n}\n\n/** Returns true if all domains from query are found in target */\nfunction matchDomain(query?: Record<string, string>, target?: Record<string, string>) {\n  if (query === undefined) return target === undefined;\n  if (target === undefined) return true;\n  for (const k in target) {\n    if (query[k] !== target[k]) return false;\n  }\n  return true;\n}\n\n/** Returns whether \"match\" axis id is compatible with the \"query\" */\nexport function matchAxisId(query: AxisId, target: AxisId): boolean {\n  return (\n    query.name === target.name &&\n    matchDomain(query.domain, target.domain) &&\n    matchDomain(query.contextDomain, target.contextDomain)\n  );\n}\n\nexport function getTypeFromPColumnOrAxisSpec(spec: PColumnSpec | AxisSpec): ValueType {\n  return \"valueType\" in spec ? spec.valueType : spec.type;\n}\n\nexport function isAxisId(id: unknown): id is AxisId {\n  return typeof id === \"object\" && id !== null && \"name\" in id && \"type\" in id;\n}\n"],"mappings":"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"}
+{"version":3,"file":"spec.js","names":[],"sources":["../../../../src/drivers/pframe/spec/spec.ts"],"sourcesContent":["import { ensureError } from \"../../../errors\";\nimport { canonicalizeJson, type CanonicalizedJson, type StringifiedJson } from \"../../../json\";\nimport type { PObject, PObjectId, PObjectSpec } from \"../../../pool\";\nimport { z } from \"zod\";\n\nexport const ValueType = {\n  Int: \"Int\",\n  Long: \"Long\",\n  Float: \"Float\",\n  Double: \"Double\",\n  String: \"String\",\n  Bytes: \"Bytes\",\n} as const;\n\nexport type AxisValueType = Extract<ValueType, \"Int\" | \"Long\" | \"String\">;\nexport type ColumnValueType = ValueType;\n\n/** PFrame columns and axes within them may store one of these types. */\nexport type ValueType = (typeof ValueType)[keyof typeof ValueType];\n\nexport type Metadata = Record<string, string>;\n\nexport function readMetadata<U extends Metadata, T extends keyof U = keyof U>(\n  metadata: Metadata | undefined,\n  key: T,\n): U[T] | undefined {\n  return (metadata as U | undefined)?.[key];\n}\n\ntype MetadataJsonImpl<M> = {\n  [P in keyof M as M[P] extends StringifiedJson ? P : never]: M[P] extends StringifiedJson<infer U>\n    ? z.ZodType<U>\n    : never;\n};\nexport type MetadataJson<M> = MetadataJsonImpl<Required<M>>;\n\nexport function readMetadataJsonOrThrow<M extends Metadata, T extends keyof MetadataJson<M>>(\n  metadata: Metadata | undefined,\n  metadataJson: MetadataJson<M>,\n  key: T,\n  methodNameInError: string = \"readMetadataJsonOrThrow\",\n): z.infer<MetadataJson<M>[T]> | undefined {\n  const json = readMetadata<M, T>(metadata, key);\n  if (json === undefined) return undefined;\n\n  const schema = metadataJson[key];\n  try {\n    const value = JSON.parse(json);\n    return schema.parse(value);\n  } catch (error: unknown) {\n    throw new Error(\n      `${methodNameInError} failed, ` +\n        `key: ${String(key)}, ` +\n        `value: ${json}, ` +\n        `error: ${ensureError(error)}`,\n    );\n  }\n}\n\nexport function readMetadataJson<M extends Metadata, T extends keyof MetadataJson<M>>(\n  metadata: Metadata | undefined,\n  metadataJson: MetadataJson<M>,\n  key: T,\n): z.infer<MetadataJson<M>[T]> | undefined {\n  try {\n    return readMetadataJsonOrThrow(metadata, metadataJson, key);\n  } catch {\n    return undefined; // treat invalid values as unset\n  }\n}\n\n/// Well-known domains\nexport const Domain = {\n  Alphabet: \"pl7.app/alphabet\",\n  BlockId: \"pl7.app/blockId\",\n  VDJ: {\n    Clustering: {\n      BlockId: \"pl7.app/vdj/clustering/blockId\",\n    },\n    ScClonotypeChain: {\n      Index: \"pl7.app/vdj/scClonotypeChain/index\",\n    },\n  },\n} as const;\n\nexport type Domain = Metadata &\n  Partial<{\n    [Domain.Alphabet]: \"nucleotide\" | \"aminoacid\" | (string & {});\n    [Domain.BlockId]: string;\n    [Domain.VDJ.ScClonotypeChain.Index]: \"primary\" | \"secondary\" | (string & {});\n  }>;\n\nexport type DomainJson = MetadataJson<Domain>;\nexport const DomainJson: DomainJson = {};\n\n/// Helper function for reading plain domain values\nexport function readDomain<T extends keyof Domain>(\n  spec: { domain?: Metadata | undefined } | undefined,\n  key: T,\n): Domain[T] | undefined {\n  return readMetadata<Domain, T>(spec?.domain, key);\n}\n\n/// Helper function for reading json-encoded domain values, throws on JSON parsing error\nexport function readDomainJsonOrThrow<T extends keyof DomainJson>(\n  spec: { domain?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<DomainJson[T]> | undefined {\n  return readMetadataJsonOrThrow<Domain, T>(spec?.domain, DomainJson, key, \"readDomainJsonOrThrow\");\n}\n\n/// Helper function for reading json-encoded domain values, returns undefined on JSON parsing error\nexport function readDomainJson<T extends keyof DomainJson>(\n  spec: { domain?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<DomainJson[T]> | undefined {\n  return readMetadataJson<Domain, T>(spec?.domain, DomainJson, key);\n}\n\n/// Well-known annotations\nexport const Annotation = {\n  AxisNature: \"pl7.app/axisNature\",\n  Alphabet: \"pl7.app/alphabet\",\n  Description: \"pl7.app/description\",\n  DataStatus: \"pl7.app/dataStatus\",\n  DiscreteValues: \"pl7.app/discreteValues\",\n  Format: \"pl7.app/format\",\n  Graph: {\n    Axis: {\n      HighCardinality: \"pl7.app/graph/axis/highCardinality\",\n      LowerLimit: \"pl7.app/graph/axis/lowerLimit\",\n      SymmetricRange: \"pl7.app/graph/axis/symmetricRange\",\n      UpperLimit: \"pl7.app/graph/axis/upperLimit\",\n    },\n    IsDenseAxis: \"pl7.app/graph/isDenseAxis\",\n    IsVirtual: \"pl7.app/graph/isVirtual\",\n    Palette: \"pl7.app/graph/palette\",\n    Thresholds: \"pl7.app/graph/thresholds\",\n    TreatAbsentValuesAs: \"pl7.app/graph/treatAbsentValuesAs\",\n  },\n  HideDataFromUi: \"pl7.app/hideDataFromUi\",\n  HideDataFromGraphs: \"pl7.app/hideDataFromGraphs\",\n  IsDiscreteFilter: \"pl7.app/isDiscreteFilter\",\n  IsAnchor: \"pl7.app/isAnchor\",\n  IsLinkerColumn: \"pl7.app/isLinkerColumn\",\n  IsScore: \"pl7.app/isScore\",\n  IsSubset: \"pl7.app/isSubset\",\n  Label: \"pl7.app/label\",\n  LinkLabel: \"pl7.app/linkLabel\",\n  Max: \"pl7.app/max\",\n  Min: \"pl7.app/min\",\n  MultipliesBy: \"pl7.app/multipliesBy\",\n  Parents: \"pl7.app/parents\",\n  Score: {\n    DefaultCutoff: \"pl7.app/score/defaultCutoff\",\n    RankingOrder: \"pl7.app/score/rankingOrder\",\n  },\n  Sequence: {\n    Annotation: {\n      Mapping: \"pl7.app/sequence/annotation/mapping\",\n    },\n    IsAnnotation: \"pl7.app/sequence/isAnnotation\",\n  },\n  Table: {\n    FontFamily: \"pl7.app/table/fontFamily\",\n    OrderPriority: \"pl7.app/table/orderPriority\",\n    Visibility: \"pl7.app/table/visibility\",\n    Info: \"pl7.app/table/info\",\n  },\n  Trace: \"pl7.app/trace\",\n  VDJ: {\n    IsAssemblingFeature: \"pl7.app/vdj/isAssemblingFeature\",\n    IsMainSequence: \"pl7.app/vdj/isMainSequence\",\n  },\n} as const;\n\nexport type AnnotationDataStatus = \"computing\" | \"ready\" | \"error\" | \"absent\";\n\nexport type Annotation = Metadata &\n  Partial<{\n    [Annotation.Alphabet]: \"nucleotide\" | \"aminoacid\" | (string & {});\n    [Annotation.AxisNature]: \"homogeneous\" | \"heterogeneous\" | \"scaleCompatible\" | (string & {});\n    [Annotation.Description]: string;\n    [Annotation.DataStatus]: AnnotationDataStatus;\n    [Annotation.DiscreteValues]: StringifiedJson<number[]> | StringifiedJson<string[]>;\n    [Annotation.Format]: string;\n    [Annotation.Graph.Axis.HighCardinality]: StringifiedJson<boolean>;\n    [Annotation.Graph.Axis.LowerLimit]: StringifiedJson<number>;\n    [Annotation.Graph.Axis.SymmetricRange]: StringifiedJson<boolean>;\n    [Annotation.Graph.Axis.UpperLimit]: StringifiedJson<number>;\n    [Annotation.Graph.IsDenseAxis]: StringifiedJson<boolean>;\n    [Annotation.Graph.IsVirtual]: StringifiedJson<boolean>;\n    [Annotation.Graph.Palette]: StringifiedJson<{ mapping: Record<string, number>; name: string }>;\n    [Annotation.Graph.Thresholds]: StringifiedJson<\n      { columnId: { valueType: ValueType; name: string }; value: number }[]\n    >;\n    [Annotation.Graph.TreatAbsentValuesAs]: StringifiedJson<number>;\n    [Annotation.HideDataFromGraphs]: StringifiedJson<boolean>;\n    [Annotation.HideDataFromUi]: StringifiedJson<boolean>;\n    [Annotation.IsDiscreteFilter]: StringifiedJson<boolean>;\n    [Annotation.IsLinkerColumn]: StringifiedJson<boolean>;\n    [Annotation.IsSubset]: StringifiedJson<boolean>;\n    [Annotation.Label]: string;\n    [Annotation.Max]: StringifiedJson<number>;\n    [Annotation.Min]: StringifiedJson<number>;\n    [Annotation.MultipliesBy]: StringifiedJson<AxisSpec[\"name\"][]>;\n    [Annotation.Parents]: StringifiedJson<AxisSpec[\"name\"][]>;\n    [Annotation.Sequence.Annotation.Mapping]: StringifiedJson<Record<string, string>>;\n    [Annotation.Sequence.IsAnnotation]: StringifiedJson<boolean>;\n    [Annotation.Table.FontFamily]: string;\n    [Annotation.Table.OrderPriority]: StringifiedJson<number>;\n    [Annotation.Table.Visibility]: \"hidden\" | \"optional\" | (string & {});\n    [Annotation.Table.Info]: string;\n    [Annotation.Trace]: StringifiedJson<Trace>;\n    [Annotation.VDJ.IsAssemblingFeature]: StringifiedJson<boolean>;\n  }>;\n\n/// One step in a column's derivation lineage. Only `type` and `label` are part\n/// of the typed public surface; writers may add fields (e.g. `id`, `importance`)\n/// passed through opaquely as `unknown`, accessed via explicit narrowing.\nconst TraceEntrySchema = z\n  .object({\n    type: z.string(),\n    label: z.string(),\n  })\n  .catchall(z.unknown());\n\nexport type TraceEntry = z.infer<typeof TraceEntrySchema>;\n\nexport type Trace = TraceEntry[];\n\n// export const AxisSpec = z.object({\n//   type: z.nativeEnum(ValueType),\n//   name: z.string(),\n//   domain: z.record(z.string(), z.string()).optional(),\n//   annotations: z.record(z.string(), z.string()).optional(),\n//   parentAxes: z.array(z.number()).optional(),\n// }).passthrough();\n//\n// type Expect<T extends true> = T;\n// type Equal<X, Y> =\n// (<T>() => T extends X ? 1 : 2) extends (<T>() => T extends Y ? 1 : 2) ? true : false;\n//\n// type _test = Expect<Equal<\n//   Readonly<z.infer<typeof AxisSpec>>,\n//   Readonly<AxisSpec & Record<string, unknown>>\n// >>;\n\nexport type AnnotationJson = MetadataJson<Annotation>;\n\nconst ValueTypeSchema = z.enum([\"Int\", \"Long\", \"Float\", \"Double\", \"String\"] as const);\nexport const AnnotationJson: AnnotationJson = {\n  [Annotation.DiscreteValues]: z.array(z.string()).or(z.array(z.number())),\n  [Annotation.Graph.Axis.HighCardinality]: z.boolean(),\n  [Annotation.Graph.Axis.LowerLimit]: z.number(),\n  [Annotation.Graph.Axis.UpperLimit]: z.number(),\n  [Annotation.Graph.Axis.SymmetricRange]: z.boolean(),\n  [Annotation.Graph.IsDenseAxis]: z.boolean(),\n  [Annotation.Graph.Palette]: z.object({ mapping: z.record(z.number()), name: z.string() }),\n  [Annotation.Graph.Thresholds]: z.array(\n    z.object({\n      columnId: z.object({ valueType: ValueTypeSchema, name: z.string() }),\n      value: z.number(),\n    }),\n  ),\n  [Annotation.Graph.TreatAbsentValuesAs]: z.number(),\n  [Annotation.Graph.IsVirtual]: z.boolean(),\n  [Annotation.HideDataFromUi]: z.boolean(),\n  [Annotation.HideDataFromGraphs]: z.boolean(),\n  [Annotation.IsDiscreteFilter]: z.boolean(),\n  [Annotation.IsLinkerColumn]: z.boolean(),\n  [Annotation.IsSubset]: z.boolean(),\n  [Annotation.Max]: z.number(),\n  [Annotation.Min]: z.number(),\n  [Annotation.MultipliesBy]: z.array(z.string()),\n  [Annotation.Parents]: z.array(z.string()),\n  [Annotation.Sequence.Annotation.Mapping]: z.record(z.string(), z.string()),\n  [Annotation.Sequence.IsAnnotation]: z.boolean(),\n  [Annotation.Table.OrderPriority]: z.number(),\n  [Annotation.Trace]: z.array(TraceEntrySchema),\n  [Annotation.VDJ.IsAssemblingFeature]: z.boolean(),\n};\n\n/// Helper function for reading plain annotation values\nexport function readAnnotation<T extends keyof Annotation>(\n  spec: { annotations?: Metadata | undefined } | undefined,\n  key: T,\n): Annotation[T] | undefined {\n  return readMetadata<Annotation, T>(spec?.annotations, key);\n}\n\n/// Helper function for reading json-encoded annotation values, throws on JSON parsing error\nexport function readAnnotationJsonOrThrow<T extends keyof AnnotationJson>(\n  spec: { annotations?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<AnnotationJson[T]> | undefined {\n  return readMetadataJsonOrThrow<Annotation, T>(\n    spec?.annotations,\n    AnnotationJson,\n    key,\n    \"readAnnotationJsonOrThrow\",\n  );\n}\n\n/// Helper function for reading json-encoded annotation values, returns undefined on JSON parsing error\nexport function readAnnotationJson<T extends keyof AnnotationJson>(\n  spec: { annotations?: Metadata | undefined } | undefined,\n  key: T,\n): z.infer<AnnotationJson[T]> | undefined {\n  return readMetadataJson<Annotation, T>(spec?.annotations, AnnotationJson, key);\n}\n\nexport function isLinkerColumn(column: PColumnSpec): boolean {\n  return !!readAnnotationJson(column, Annotation.IsLinkerColumn);\n}\n\n/**\n * Specification of an individual axis.\n *\n * Each axis is a part of a composite key that addresses data inside the PColumn.\n *\n * Each record inside a PColumn is addressed by a unique tuple of values set for\n * all the axes specified in the column spec.\n */\nexport type AxisSpec = {\n  /** Type of the axis value. Should not use non-key types like float or double. */\n  readonly type: AxisValueType;\n\n  /** Name of the axis */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis name, type and parents to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional axis identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n\n  /** Any additional information attached to the axis that does not affect its\n   * identifier */\n  readonly annotations?: Record<string, string>;\n\n  /**\n   * Parent axes provide contextual grouping for the axis in question, establishing\n   * a hierarchy where the current axis is dependent on one or more axes for its\n   * full definition and meaning. For instance, in a data structure where each\n   * \"container\" axis may contain multiple \"item\" axes, the `item` axis would\n   * list the index of the `container` axis in this field to denote its dependency.\n   *\n   * This means that the identity or significance of the `item` axis is only\n   * interpretable when combined with its parent `container` axis. An `item` axis\n   * index by itself may be non-unique and only gains uniqueness within the context\n   * of its parent `container`. Therefore, the `parentAxes` field is essential for\n   * mapping these relationships and ensuring data coherence across nested or\n   * multi-level data models.\n   *\n   * A list of zero-based indices of parent axes in the overall axes specification\n   * from the column spec. Each index corresponds to the position of a parent axis\n   * in the list that defines the structure of the data model.\n   */\n  readonly parentAxes?: number[];\n};\n\n/** Parents are specs, not indexes; normalized axis can be used considering its parents independently from column */\nexport interface AxisSpecNormalized extends Omit<AxisSpec, \"parentAxes\"> {\n  parentAxesSpec: AxisSpecNormalized[];\n}\n\n/** Tree: axis is a root, its parents are children */\nexport type AxisTree = {\n  axis: AxisSpecNormalized;\n  children: AxisTree[]; // parents\n};\n\nfunction makeAxisTree(axis: AxisSpecNormalized): AxisTree {\n  return { axis, children: [] };\n}\n\n/** Build tree by axis parents annotations */\nexport function getAxesTree(rootAxis: AxisSpecNormalized): AxisTree {\n  const root = makeAxisTree(rootAxis);\n  let nodesQ = [root];\n  while (nodesQ.length) {\n    const nextNodes: AxisTree[] = [];\n    for (const node of nodesQ) {\n      node.children = node.axis.parentAxesSpec.map(makeAxisTree);\n      nextNodes.push(...node.children);\n    }\n    nodesQ = nextNodes;\n  }\n  return root;\n}\n\n/** Get set of canonicalized axisIds from axisTree */\nexport function getSetFromAxisTree(tree: AxisTree): Set<CanonicalizedJson<AxisId>> {\n  const set = new Set([canonicalizeJson(getAxisId(tree.axis))]);\n  let nodesQ = [tree];\n  while (nodesQ.length) {\n    const nextNodes = [];\n    for (const node of nodesQ) {\n      for (const parent of node.children) {\n        set.add(canonicalizeJson(getAxisId(parent.axis)));\n        nextNodes.push(parent);\n      }\n    }\n    nodesQ = nextNodes;\n  }\n  return set;\n}\n\n/** Get array of axisSpecs from axisTree */\nexport function getArrayFromAxisTree(tree: AxisTree): AxisSpecNormalized[] {\n  const res = [tree.axis];\n  let nodesQ = [tree];\n  while (nodesQ.length) {\n    const nextNodes = [];\n    for (const node of nodesQ) {\n      for (const parent of node.children) {\n        res.push(parent.axis);\n        nextNodes.push(parent);\n      }\n    }\n    nodesQ = nextNodes;\n  }\n  return res;\n}\n\nexport function canonicalizeAxisWithParents(axis: AxisSpecNormalized) {\n  return canonicalizeJson(getArrayFromAxisTree(getAxesTree(axis)).map(getAxisId));\n}\n\nfunction normalizingAxesComparator(\n  axis1: AxisSpecNormalized,\n  axis2: AxisSpecNormalized,\n): 1 | -1 | 0 {\n  if (axis1.name !== axis2.name) {\n    return axis1.name < axis2.name ? 1 : -1;\n  }\n  if (axis1.type !== axis2.type) {\n    return axis1.type < axis2.type ? 1 : -1;\n  }\n  const domain1 = canonicalizeJson(axis1.domain ?? {});\n  const domain2 = canonicalizeJson(axis2.domain ?? {});\n  if (domain1 !== domain2) {\n    return domain1 < domain2 ? 1 : -1;\n  }\n\n  const contextDomain1 = canonicalizeJson(axis1.contextDomain ?? {});\n  const contextDomain2 = canonicalizeJson(axis2.contextDomain ?? {});\n  if (contextDomain1 !== contextDomain2) {\n    return contextDomain1 < contextDomain2 ? 1 : -1;\n  }\n\n  const parents1 = canonicalizeAxisWithParents(axis1);\n  const parents2 = canonicalizeAxisWithParents(axis2);\n\n  if (parents1 !== parents2) {\n    return parents1 < parents2 ? 1 : -1;\n  }\n\n  const annotation1 = canonicalizeJson(axis1.annotations ?? {});\n  const annotation2 = canonicalizeJson(axis2.annotations ?? {});\n  if (annotation1 !== annotation2) {\n    return annotation1 < annotation2 ? 1 : -1;\n  }\n  return 0;\n}\n\nfunction parseParentsFromAnnotations(axis: AxisSpec) {\n  const parentsList = readAnnotationJson(axis, Annotation.Parents);\n  if (parentsList === undefined) {\n    return [];\n  }\n  return parentsList;\n}\n\nfunction sortParentsDeep(axisSpec: AxisSpecNormalized) {\n  axisSpec.parentAxesSpec.forEach(sortParentsDeep);\n  axisSpec.parentAxesSpec.sort(normalizingAxesComparator);\n}\n\nfunction hasCycleOfParents(axisSpec: AxisSpecNormalized) {\n  const root = makeAxisTree(axisSpec);\n  let nodesQ = [root];\n  const ancestors = new Set(canonicalizeJson(getAxisId(axisSpec)));\n  while (nodesQ.length) {\n    const nextNodes: AxisTree[] = [];\n    const levelIds = new Set<CanonicalizedJson<AxisId>>();\n    for (const node of nodesQ) {\n      node.children = node.axis.parentAxesSpec.map(makeAxisTree);\n      for (const child of node.children) {\n        const childId = canonicalizeJson(getAxisId(child.axis));\n        if (!levelIds.has(childId)) {\n          nextNodes.push(child);\n          levelIds.add(childId);\n          if (ancestors.has(childId)) {\n            return true;\n          }\n          ancestors.add(childId);\n        }\n      }\n    }\n    nodesQ = nextNodes;\n  }\n  return false;\n}\n\n/** Create list of normalized axisSpec (parents are in array of specs, not indexes) */\nexport function getNormalizedAxesList(axes: AxisSpec[]): AxisSpecNormalized[] {\n  if (!axes.length) {\n    return [];\n  }\n  const modifiedAxes: AxisSpecNormalized[] = axes.map((axis) => {\n    const { parentAxes: _, ...copiedRest } = axis;\n    return { ...copiedRest, annotations: { ...copiedRest.annotations }, parentAxesSpec: [] };\n  });\n\n  axes.forEach((axis, idx) => {\n    const modifiedAxis = modifiedAxes[idx];\n    if (axis.parentAxes) {\n      // if we have parents by indexes then take from the list\n      modifiedAxis.parentAxesSpec = axis.parentAxes.map((idx) => modifiedAxes[idx]);\n    } else {\n      // else try to parse from annotation name\n      const parents = parseParentsFromAnnotations(axis).map((name) =>\n        modifiedAxes.find((axis) => axis.name === name),\n      );\n      modifiedAxis.parentAxesSpec = parents.some((p) => p === undefined)\n        ? []\n        : (parents as AxisSpecNormalized[]);\n    }\n  });\n\n  if (modifiedAxes.some(hasCycleOfParents)) {\n    // Axes list is broken\n    modifiedAxes.forEach((axis) => {\n      axis.parentAxesSpec = [];\n    });\n  } else {\n    modifiedAxes.forEach((axis) => {\n      sortParentsDeep(axis);\n    });\n  }\n\n  return modifiedAxes;\n}\n\n/** Create list of regular axisSpec from normalized (parents are indexes, inside of current axes list) */\nexport function getDenormalizedAxesList(axesSpec: AxisSpecNormalized[]): AxisSpec[] {\n  const idsList = axesSpec.map(canonicalizeAxisId);\n  return axesSpec.map((axisSpec) => {\n    const parentsIds = axisSpec.parentAxesSpec.map(canonicalizeAxisId);\n    const parentIdxs = parentsIds.map((id) => idsList.indexOf(id));\n    const { parentAxesSpec: _, ...copiedRest } = axisSpec;\n    if (parentIdxs.length) {\n      return { ...copiedRest, parentAxes: parentIdxs } as AxisSpec;\n    }\n    return copiedRest;\n  });\n}\n\n/**\n * Resolve annotation-based parents (`pl7.app/parents`) to numeric `parentAxes`\n * on a column spec. Returns the spec unchanged if all axes already use numeric\n * indices or have no parent annotations.\n */\nexport function resolveAnnotationParents(spec: PColumnSpec): PColumnSpec {\n  const hasAnnotationParents = spec.axesSpec.some(\n    (axis) => !!readAnnotationJson(axis, Annotation.Parents),\n  );\n  if (!hasAnnotationParents) return spec;\n\n  const normalized = getNormalizedAxesList(spec.axesSpec);\n  const denormalized = getDenormalizedAxesList(normalized);\n  return { ...spec, axesSpec: denormalized };\n}\n\n/** Common type representing spec for all the axes in a column */\nexport type AxesSpec = AxisSpec[];\n\n/// Well-known column names\nexport const PColumnName = {\n  Label: \"pl7.app/label\",\n  Table: {\n    RowSelection: \"pl7.app/table/row-selection\",\n  },\n  VDJ: {\n    LeadSelection: \"pl7.app/vdj/lead-selection\",\n    RankingOrder: \"pl7.app/vdj/ranking-order\",\n    Sequence: \"pl7.app/vdj/sequence\",\n  },\n} as const;\n\n/// Well-known axis names\nexport const PAxisName = {\n  SampleId: \"pl7.app/sampleId\",\n  VDJ: {\n    Assay: {\n      SequenceId: \"pl7.app/vdj/assay/sequenceId\",\n    },\n    ClusterId: \"pl7.app/vdj/clusterId\",\n    ClonotypeKey: \"pl7.app/vdj/clonotypeKey\",\n    ScClonotypeKey: \"pl7.app/vdj/scClonotypeKey\",\n  },\n} as const;\n\nexport function isLabelColumn(column: PColumnSpec) {\n  return column.axesSpec.length === 1 && column.name === PColumnName.Label;\n}\n\n/**\n * Full column specification including all axes specs and specs of the column\n * itself.\n *\n * A PColumn in its essence represents a mapping from a fixed size, explicitly\n * typed tuple to an explicitly typed value.\n *\n * (axis1Value1, axis2Value1, ...) -> columnValue\n *\n * Each element in tuple correspond to the axis having the same index in axesSpec.\n */\nexport type PUniversalColumnSpec = PObjectSpec & {\n  /** Defines specific type of BObject, the most generic type of unit of\n   * information in Platforma Project. */\n  readonly kind: \"PColumn\";\n\n  /** Type of column values */\n  readonly valueType: string;\n\n  /** Column name */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis name, type and parents to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional column identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n\n  /** Any additional information attached to the column that does not affect its\n   * identifier */\n  readonly annotations?: Record<string, string>;\n\n  /** A list of zero-based indices of parent axes from the {@link axesSpec} array. */\n  readonly parentAxes?: number[];\n\n  /** Axes specifications */\n  readonly axesSpec: AxesSpec;\n};\n\n/**\n * Specification of a data column.\n *\n * Data column is a specialized type of PColumn that stores only simple values (strings and numbers)\n * addressed by multiple keys. This is in contrast to other PColumn variants that can store more complex\n * values like files or other abstract data types. Data columns are optimized for storing and processing\n * basic tabular data.\n */\nexport type PDataColumnSpec = PUniversalColumnSpec & {\n  /** Type of column values */\n  readonly valueType: ValueType;\n};\n\n// @todo: change this to PUniversalColumnSpec\nexport type PColumnSpec = PDataColumnSpec;\n\n/** Unique PColumnSpec identifier */\nexport type PColumnSpecId = {\n  /** Defines specific type of BObject, the most generic type of unit of\n   * information in Platforma Project. */\n  readonly kind: \"PColumn\";\n\n  /** Type of column values */\n  readonly valueType: ValueType;\n\n  /** Column name */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis name, type and parents to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional column identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n\n  /** A list of zero-based indices of parent axes from the {@link axesSpec} array. */\n  readonly parentAxes?: number[];\n\n  /** Axes id */\n  readonly axesId: AxesId;\n};\n\nexport function getPColumnSpecId(spec: PColumnSpec): PColumnSpecId {\n  return {\n    kind: spec.kind,\n    valueType: spec.valueType,\n    name: spec.name,\n    domain: spec.domain,\n    contextDomain: spec.contextDomain,\n    parentAxes: spec.parentAxes,\n    axesId: getAxesId(spec.axesSpec),\n  };\n}\n\nexport interface PColumn<Data> extends PObject<Data> {\n  /** PColumn spec, allowing it to be found among other PObjects */\n  readonly spec: PColumnSpec;\n}\n\nexport type PColumnLazy<T> = PColumn<() => T>;\n\n/** Columns in a PFrame also have internal identifier, this object represents\n * combination of specs and such id */\nexport interface PColumnIdAndSpec {\n  /** Internal column id within the PFrame */\n  readonly columnId: PObjectId;\n\n  /** Column spec */\n  readonly spec: PColumnSpec;\n}\n\n/** Get column id and spec from a column */\nexport function getColumnIdAndSpec<Data>(column: PColumn<Data>): PColumnIdAndSpec {\n  return {\n    columnId: column.id,\n    spec: column.spec,\n  };\n}\n\nexport interface AxisId {\n  /** Type of the axis or column value. For an axis should not use non-key\n   * types like float or double. */\n  readonly type: AxisValueType;\n\n  /** Name of the axis or column */\n  readonly name: string;\n\n  /** Adds auxiliary information to the axis or column name and type to form a\n   * unique identifier */\n  readonly domain?: Record<string, string>;\n\n  /** Context domain provides additional axis identity that is matched\n   * by kinship rules (subset/superset/overlap) rather than exact equality */\n  readonly contextDomain?: Record<string, string>;\n}\n\n/** Array of axis ids */\nexport type AxesId = AxisId[];\n\n/** Extracts axis ids from axis spec */\nexport function getAxisId(spec: AxisSpec): AxisId {\n  const { type, name, domain, contextDomain } = spec;\n  const result: AxisId = { type, name };\n  if (domain && Object.entries(domain).length > 0) {\n    Object.assign(result, { domain });\n  }\n  if (contextDomain && Object.entries(contextDomain).length > 0) {\n    Object.assign(result, { contextDomain });\n  }\n  return result;\n}\n\n/** Extracts axes ids from axes spec array from column spec */\nexport function getAxesId(spec: AxesSpec): AxesId {\n  return spec.map(getAxisId);\n}\n\n/** Canonicalizes axis id */\nexport function canonicalizeAxisId(id: AxisId): CanonicalizedJson<AxisId> {\n  return canonicalizeJson(getAxisId(id));\n}\n\n/** Returns true if all domains from query are found in target */\nfunction matchDomain(query?: Record<string, string>, target?: Record<string, string>) {\n  if (query === undefined) return target === undefined;\n  if (target === undefined) return true;\n  for (const k in target) {\n    if (query[k] !== target[k]) return false;\n  }\n  return true;\n}\n\n/** Returns whether \"match\" axis id is compatible with the \"query\" */\nexport function matchAxisId(query: AxisId, target: AxisId): boolean {\n  return (\n    query.name === target.name &&\n    matchDomain(query.domain, target.domain) &&\n    matchDomain(query.contextDomain, target.contextDomain)\n  );\n}\n\nexport function getTypeFromPColumnOrAxisSpec(spec: PColumnSpec | AxisSpec): ValueType {\n  return \"valueType\" in spec ? spec.valueType : spec.type;\n}\n\nexport function isAxisId(id: unknown): id is AxisId {\n  return typeof id === \"object\" && id !== null && \"name\" in id && \"type\" in id;\n}\n"],"mappings":"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"}

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

@@ -1,5 +1,5 @@
 import { PoolEntry } from "../../pool_entry.js";
-import { AxesId, AxesSpec, AxisSpec, AxisValueType, ColumnValueType, PColumnIdAndSpec, PColumnInfo, PColumnSpec } from "./spec/spec.js";
+import { AxesId, AxesSpec, AxisSpec, AxisValueType, ColumnValueType, PColumnIdAndSpec, PColumnSpec } from "./spec/spec.js";
 import { PTableColumnId, PTableColumnSpec } from "./table_common.js";
 import { SpecQuery, SpecQueryJoinEntry } from "./query/query_spec.js";
 import { PTableRecordFilter } from "./table_calculate.js";
@@ -188,7 +188,7 @@ interface PFrameSpecDriver {
   /** Create a spec-only PFrame from column specs. Returns a pool entry with handle and unref. */
   createSpecFrame(specs: Record<string, PColumnSpec>): PoolEntry<SpecFrameHandle>;
   /** List all columns currently registered in the frame. */
-  listColumns(handle: SpecFrameHandle): PColumnInfo[];
+  listColumns(handle: SpecFrameHandle): PColumnIdAndSpec[];
   /** Discover columns compatible with given axes integration. */
   discoverColumns(handle: SpecFrameHandle, request: DiscoverColumnsRequest): DiscoverColumnsResponse;
   /** Delete an entry from a given axes integration */

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

@@ -1 +1 @@
-{"version":3,"file":"spec_driver.d.ts","names":[],"sources":["../../../src/drivers/pframe/spec_driver.ts"],"mappings":";;;;;;;;;;;;KAoBY,aAAA;EAEN,IAAA;EACA,KAAA;AAAA;EAGA,IAAA;EACA,KAAA;AAAA;;KAIM,UAAA,GAAa,MAAA,SAAe,aAAA;;UAGvB,iBAAA;EAXX;EAAA,SAaK,IAAA,GAAO,aAAA;EATZ;EAAA,SAWK,IAAA,GAAO,aAAA;EAXP;EAAA,SAaA,MAAA,GAAS,UAAA;EATE;EAAA,SAWX,aAAA,GAAgB,UAAA;EAXF;EAAA,SAad,WAAA,GAAc,UAAA;AAAA;;;UAKR,mBAAA;EAXC;EAAA,SAaP,IAAA,GAAO,eAAA;EATS;EAAA,SAWhB,IAAA,GAAO,aAAA;EATiB;EAAA,SAWxB,MAAA,GAAS,UAAA;EAnBT;EAAA,SAqBA,aAAA,GAAgB,UAAA;EAnBhB;EAAA,SAqBA,WAAA,GAAc,UAAA;EAnBd;EAAA,SAqBA,IAAA,GAAO,iBAAA;EAnBP;EAAA,SAqBA,gBAAA;AAAA;;UAIM,4BAAA;EAvBkB;EAyBjC,QAAA,EAAU,QAAA;EApBwB;EAsBlC,cAAA,EAAgB,iBAAA;AAAA;;UAID,0BAAA;EAlBU;EAoBzB,uBAAA;EAhBgB;EAkBhB,oBAAA;EAlBiC;EAoBjC,yBAAA;EA9BgB;EAgChB,sBAAA;AAAA;;UAIe,sBAAA;EA9BN;EAgCT,cAAA,GAAiB,mBAAA;EA9BR;EAgCT,cAAA,GAAiB,mBAAA;EA9BR;EAgCT,IAAA,EAAM,4BAAA;EA9BG;EAgCT,OAAA;EAhCyB;EAkCzB,WAAA,EAAa,0BAAA;AAAA;;UAIE,yBAAA;EACf,IAAA;EAjCU;EAmCV,MAAA,EAAQ,gBAAA;AAAA;;;AA7BV;;;;UAsCiB,yBAAA;EACf,IAAA;EAjCA;EAmCA,MAAA,EAAQ,gBAAA;AAAA;;KAIE,uBAAA,GAA0B,yBAAA,GAA4B,yBAAA;;;;;;;;;;;;;;;;;;KAmBtD,eAAA;EA1C6B,kFA4C9B,OAAA,QAxC+B;EAAA,SA0C/B,MAAA,EAAQ,SAAA,EAvCO;EAAA,SAyCf,IAAA,GAAO,uBAAA,IAzChB;EAAA,SA2CS,cAAA,GAAiB,iBAAA;AAAA;;UAIX,qCAAA;EAtCyB;EAwCxC,UAAA,EAAY,iBAAA;EArCY;EAuCxB,MAAA,EAAQ,iBAAA;AAAA;;UAIO,6BAAA;EA3CS;EA6CxB,cAAA,EAAgB,qCAAA;EAzCiB;EA2CjC,yBAAA,EAA2B,qCAAA;AAAA;;UAIZ,0BAAA;EA5BU;EA8BzB,GAAA,EAAK,gBAAA;EA1BY;EA4BjB,eAAA,EAAiB,6BAAA;EAxBS;EA0B1B,IAAA,EAAM,uBAAA;AAAA;;UAIS,uBAAA;EAlCE;EAoCjB,IAAA,EAAM,0BAAA;AAAA;;UAIS,mBAAA;EApC4B;EAsC3C,IAAA,EAAM,4BAAA;EAlCS;EAoCf,MAAA;AAAA;;UAIe,oBAAA;EACf,IAAA,EAAM,4BAAA;AAAA;;KAII,qBAAA;EAzCe;AAI3B;;;EA0CE,SAAA,EAAW,gBAAA;EAxCX;;;;EA6CA,SAAA,EAAW,SAAA;AAAA;AAvCb;AAAA,KA2CY,eAAA,GAAkB,OAAA;;;;;;;;UASb,gBAAA;EAhDf;EAkDA,eAAA,CAAgB,KAAA,EAAO,MAAA,SAAe,WAAA,IAAe,SAAA,CAAU,eAAA;EAhD/D;EAmDA,WAAA,CAAY,MAAA,EAAQ,eAAA,GAAkB,WAAA;EAnDT;EAsD7B,eAAA,CACE,MAAA,EAAQ,eAAA,EACR,OAAA,EAAS,sBAAA,GACR,uBAAA;EArDY;EAwDf,YAAA,CAAa,MAAA,EAAQ,eAAA,EAAiB,OAAA,EAAS,mBAAA,GAAsB,oBAAA;;EAGrE,aAAA,CAAc,MAAA,EAAQ,eAAA,EAAiB,OAAA,EAAS,SAAA,GAAY,qBAAA;EAzD5B;AAIlC;;;;;;EA8DE,UAAA,CAAW,KAAA,EAAO,eAAA,GAAkB,kBAAA;EA1D9B;EA6DN,UAAA,CAAW,IAAA,EAAM,QAAA,GAAW,MAAA;EAzDb;EA4Df,YAAA,CAAa,GAAA,EAAK,MAAA,GAAS,QAAA;;EAG3B,QAAA,CAAS,IAAA,EAAM,QAAA,EAAU,QAAA,EAAU,kBAAA;EA9DD;EAiElC,eAAA,CAAgB,SAAA,EAAW,gBAAA,IAAoB,QAAA,EAAU,cAAA;EA7D1B;;;;;EAoE/B,oBAAA,CAAqB,OAAA;IACnB,SAAA,EAAW,gBAAA;IACX,OAAA,EAAS,kBAAA;EAAA,IACP,0BAAA;AAAA"}
+{"version":3,"file":"spec_driver.d.ts","names":[],"sources":["../../../src/drivers/pframe/spec_driver.ts"],"mappings":";;;;;;;;;;;;KAmBY,aAAA;EAEN,IAAA;EACA,KAAA;AAAA;EAGA,IAAA;EACA,KAAA;AAAA;;KAIM,UAAA,GAAa,MAAA,SAAe,aAAA;;UAGvB,iBAAA;EAXX;EAAA,SAaK,IAAA,GAAO,aAAA;EATZ;EAAA,SAWK,IAAA,GAAO,aAAA;EAXP;EAAA,SAaA,MAAA,GAAS,UAAA;EATE;EAAA,SAWX,aAAA,GAAgB,UAAA;EAXF;EAAA,SAad,WAAA,GAAc,UAAA;AAAA;;;UAKR,mBAAA;EAXC;EAAA,SAaP,IAAA,GAAO,eAAA;EATS;EAAA,SAWhB,IAAA,GAAO,aAAA;EATiB;EAAA,SAWxB,MAAA,GAAS,UAAA;EAnBT;EAAA,SAqBA,aAAA,GAAgB,UAAA;EAnBhB;EAAA,SAqBA,WAAA,GAAc,UAAA;EAnBd;EAAA,SAqBA,IAAA,GAAO,iBAAA;EAnBP;EAAA,SAqBA,gBAAA;AAAA;;UAIM,4BAAA;EAvBkB;EAyBjC,QAAA,EAAU,QAAA;EApBwB;EAsBlC,cAAA,EAAgB,iBAAA;AAAA;;UAID,0BAAA;EAlBU;EAoBzB,uBAAA;EAhBgB;EAkBhB,oBAAA;EAlBiC;EAoBjC,yBAAA;EA9BgB;EAgChB,sBAAA;AAAA;;UAIe,sBAAA;EA9BN;EAgCT,cAAA,GAAiB,mBAAA;EA9BR;EAgCT,cAAA,GAAiB,mBAAA;EA9BR;EAgCT,IAAA,EAAM,4BAAA;EA9BG;EAgCT,OAAA;EAhCyB;EAkCzB,WAAA,EAAa,0BAAA;AAAA;;UAIE,yBAAA;EACf,IAAA;EAjCU;EAmCV,MAAA,EAAQ,gBAAA;AAAA;;;AA7BV;;;;UAsCiB,yBAAA;EACf,IAAA;EAjCA;EAmCA,MAAA,EAAQ,gBAAA;AAAA;;KAIE,uBAAA,GAA0B,yBAAA,GAA4B,yBAAA;;;;;;;;;;;;;;;;;;KAmBtD,eAAA;EA1C6B,kFA4C9B,OAAA,QAxC+B;EAAA,SA0C/B,MAAA,EAAQ,SAAA,EAvCO;EAAA,SAyCf,IAAA,GAAO,uBAAA,IAzChB;EAAA,SA2CS,cAAA,GAAiB,iBAAA;AAAA;;UAIX,qCAAA;EAtCyB;EAwCxC,UAAA,EAAY,iBAAA;EArCY;EAuCxB,MAAA,EAAQ,iBAAA;AAAA;;UAIO,6BAAA;EA3CS;EA6CxB,cAAA,EAAgB,qCAAA;EAzCiB;EA2CjC,yBAAA,EAA2B,qCAAA;AAAA;;UAIZ,0BAAA;EA5BU;EA8BzB,GAAA,EAAK,gBAAA;EA1BY;EA4BjB,eAAA,EAAiB,6BAAA;EAxBS;EA0B1B,IAAA,EAAM,uBAAA;AAAA;;UAIS,uBAAA;EAlCE;EAoCjB,IAAA,EAAM,0BAAA;AAAA;;UAIS,mBAAA;EApC4B;EAsC3C,IAAA,EAAM,4BAAA;EAlCS;EAoCf,MAAA;AAAA;;UAIe,oBAAA;EACf,IAAA,EAAM,4BAAA;AAAA;;KAII,qBAAA;EAzCe;AAI3B;;;EA0CE,SAAA,EAAW,gBAAA;EAxCX;;;;EA6CA,SAAA,EAAW,SAAA;AAAA;AAvCb;AAAA,KA2CY,eAAA,GAAkB,OAAA;;;;;;;;UASb,gBAAA;EAhDf;EAkDA,eAAA,CAAgB,KAAA,EAAO,MAAA,SAAe,WAAA,IAAe,SAAA,CAAU,eAAA;EAhD/D;EAmDA,WAAA,CAAY,MAAA,EAAQ,eAAA,GAAkB,gBAAA;EAnDT;EAsD7B,eAAA,CACE,MAAA,EAAQ,eAAA,EACR,OAAA,EAAS,sBAAA,GACR,uBAAA;EArDY;EAwDf,YAAA,CAAa,MAAA,EAAQ,eAAA,EAAiB,OAAA,EAAS,mBAAA,GAAsB,oBAAA;;EAGrE,aAAA,CAAc,MAAA,EAAQ,eAAA,EAAiB,OAAA,EAAS,SAAA,GAAY,qBAAA;EAzD5B;AAIlC;;;;;;EA8DE,UAAA,CAAW,KAAA,EAAO,eAAA,GAAkB,kBAAA;EA1D9B;EA6DN,UAAA,CAAW,IAAA,EAAM,QAAA,GAAW,MAAA;EAzDb;EA4Df,YAAA,CAAa,GAAA,EAAK,MAAA,GAAS,QAAA;;EAG3B,QAAA,CAAS,IAAA,EAAM,QAAA,EAAU,QAAA,EAAU,kBAAA;EA9DD;EAiElC,eAAA,CAAgB,SAAA,EAAW,gBAAA,IAAoB,QAAA,EAAU,cAAA;EA7D1B;;;;;EAoE/B,oBAAA,CAAqB,OAAA;IACnB,SAAA,EAAW,gBAAA;IACX,OAAA,EAAS,kBAAA;EAAA,IACP,0BAAA;AAAA"}

package/dist/index.cjs

@@ -88,6 +88,7 @@ exports.Services = require_service_declarations.Services;
 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.assertNever = require_util.assertNever;
 exports.base64Decode = require_base64.base64Decode;
 exports.base64Encode = require_base64.base64Encode;

package/dist/index.d.ts

@@ -9,11 +9,11 @@ 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, PColumnInfo, 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 { 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 { 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, isPTableNA, isValueNA, pTableValue, pTableValueBranded } from "./drivers/pframe/data_types.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 { 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";
@@ -64,4 +64,4 @@ 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, 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, PColumnInfo, 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, 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 };
+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, 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 };

package/dist/index.js

@@ -11,7 +11,7 @@ import { dataInfoToEntries, entriesToDataInfo, isDataInfo, isDataInfoEntries, is
 import { AbortError, PFrameDriverError, PFrameError, PFrameSpecDriverError, ServiceAlreadyRegisteredError, ServiceError, ServiceInjectionError, ServiceInvalidIdError, ServiceMethodNotFoundError, ServiceNotRegisteredError, UiError, deserializeError, deserializeResult, ensureError, hasAbortError, isAbortError, isAggregateError, isPFrameDriverError, isPFrameError, isPFrameSpecDriverError, isServiceAlreadyRegisteredError, isServiceError, isServiceInjectionError, isServiceInvalidIdError, isServiceMethodNotFoundError, isServiceNotRegisteredError, serializeError, serializeResult, unwrapResult, wrapAndSerialize, wrapAndSerializeAsync, wrapAsyncCallback, wrapCallback } from "./errors.js";
 import { bigintReplacer, canonicalizeJson, parseJson, parseJsonSafely, stringifyJson } from "./json.js";
 import { Annotation, AnnotationJson, Domain, DomainJson, PAxisName, PColumnName, ValueType, canonicalizeAxisId, canonicalizeAxisWithParents, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAxisId, isLabelColumn, isLinkerColumn, matchAxisId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, resolveAnnotationParents } from "./drivers/pframe/spec/spec.js";
-import { PTableNA, isPTableNA, isValueNA, pTableValue, pTableValueBranded } from "./drivers/pframe/data_types.js";
+import { PTableNA, XLSX_MAX_ROWS_PER_SHEET, isPTableNA, isValueNA, pTableValue, pTableValueBranded } from "./drivers/pframe/data_types.js";
 import { collectSpecQueryColumns, isBooleanExpression, mapSpecQueryColumns, sortSpecQuery, traverseQuerySpec } from "./drivers/pframe/query/utils.js";
 import { mapJoinEntry, mapPTableDef, mapPTableDefV2, sortJoinEntry, sortPTableDef } from "./drivers/pframe/table_calculate.js";
 import { getPTableColumnId } from "./drivers/pframe/table_common.js";
@@ -43,4 +43,4 @@ import { createNodeServiceHandlers } from "./services/node_service_handlers.js";
 import { MODEL_SERVICE_METHOD_MAP, SERVICE_METHOD_MAP, buildServiceInfo, resolveNodeServiceHandler } from "./services/service_injectors.js";
 import "./services/index.js";
 import { PoolEntryGuard } from "./pool_entry.js";
-export { AbortError, AllRequiresFeatureFlags, AllSupportsFeatureFlags, AnchoredIdDeriver, Annotation, AnnotationJson, ChunkedStreamReader, Code, DefaultNavigationState, Domain, DomainJson, IncompatibleFlagsError, LinkerMap, MODEL_SERVICE_METHOD_MAP, ModelServiceRegistry, PAxisName, PColumnName, PFrameDriverError, PFrameError, PFrameSpecDriverError, PTableNA, PlId, PlIdBytes, PlIdLength, PlRef, PoolEntryGuard, REQUIRES_PFRAMES_VERSION, RangeBytes, ResourceTypeName, ResourceTypePrefix, RuntimeCapabilities, SERVICE_CAPABILITY_FLAGS, SERVICE_FEATURE_FLAGS, SERVICE_METHOD_MAP, ServiceAlreadyRegisteredError, ServiceError, ServiceInjectionError, ServiceInvalidIdError, ServiceMethodNotFoundError, ServiceNotRegisteredError, Services, UiError, UiServiceRegistry, ValueType, 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 };
+export { AbortError, AllRequiresFeatureFlags, AllSupportsFeatureFlags, AnchoredIdDeriver, Annotation, AnnotationJson, ChunkedStreamReader, Code, DefaultNavigationState, Domain, DomainJson, IncompatibleFlagsError, LinkerMap, MODEL_SERVICE_METHOD_MAP, ModelServiceRegistry, PAxisName, PColumnName, PFrameDriverError, PFrameError, PFrameSpecDriverError, PTableNA, PlId, PlIdBytes, PlIdLength, PlRef, PoolEntryGuard, REQUIRES_PFRAMES_VERSION, RangeBytes, ResourceTypeName, ResourceTypePrefix, RuntimeCapabilities, SERVICE_CAPABILITY_FLAGS, SERVICE_FEATURE_FLAGS, SERVICE_METHOD_MAP, ServiceAlreadyRegisteredError, ServiceError, ServiceInjectionError, ServiceInvalidIdError, ServiceMethodNotFoundError, ServiceNotRegisteredError, Services, UiError, UiServiceRegistry, ValueType, 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-model-common",
-  "version": "1.45.0",
+  "version": "1.46.1",
   "description": "Platforma SDK Model",
   "files": [
     "./dist/**/*",

package/src/drivers/pframe/data_types.ts

@@ -266,6 +266,13 @@ export interface WritePTableToFsResult {
   bytesWritten: number;
 }
 
+/**
+ * Maximum number of data rows allowed per sheet in an `xlsx` export, kept below
+ * Excel's hard limit of 1,048,576. The driver rejects oversized `xlsx` exports
+ * (see {@link PFrameDriver.exportPTable}); UIs use it to gate the `xlsx` option.
+ */
+export const XLSX_MAX_ROWS_PER_SHEET = 1_000_000;
+
 /** Options for {@link PFrameDriver.exportPTable}. */
 export interface ExportPTableOptions {
   /** Destination file path; its extension selects the output format

package/src/drivers/pframe/query/query_common.ts

@@ -17,6 +17,18 @@ export type TypeSpec = {
   columns: ColumnValueType[];
 };
 
+/**
+ * Structural type information for a single column: the axis value types (in
+ * order) and the single column value type. Mirrors the self-contained
+ * `typeSpec` shape carried by the data layer (`{ axes, column }`).
+ */
+export type ColumnTypeSpec = {
+  /** List of axis value types defining the dimensions of the data */
+  axes: AxisValueType[];
+  /** The single column value type */
+  column: ColumnValueType;
+};
+
 // ============ Operand Types ============
 
 /**

package/src/drivers/pframe/query/query_data.ts

@@ -30,7 +30,7 @@ import type {
   QuerySparseToDenseColumn,
   QuerySymmetricJoin,
   QueryTransformColumns,
-  TypeSpec,
+  ColumnTypeSpec,
 } from "./query_common";
 
 /**
@@ -42,8 +42,8 @@ import type {
 type ColumnIdAndTypeSpec = {
   /** Unique identifier of the column */
   id: PObjectId;
-  /** Type specification defining axes and column types */
-  spec: TypeSpec;
+  /** Type specification defining the axes and the single column value type */
+  spec: ColumnTypeSpec;
 };
 
 /**

package/src/drivers/pframe/spec/spec.ts

@@ -730,12 +730,6 @@ export function getColumnIdAndSpec<Data>(column: PColumn<Data>): PColumnIdAndSpe
   };
 }
 
-/** Information returned by {@link PFrame.listColumns} method */
-export interface PColumnInfo extends PColumnIdAndSpec {
-  /** True if data was associated with this PColumn */
-  readonly hasData: boolean;
-}
-
 export interface AxisId {
   /** Type of the axis or column value. For an axis should not use non-key
    * types like float or double. */

package/src/drivers/pframe/spec_driver.ts

@@ -6,7 +6,6 @@ import type {
   AxesSpec,
   AxesId,
   PColumnIdAndSpec,
-  PColumnInfo,
   PColumnSpec,
   SingleAxisSelector,
   AxisQualification,
@@ -222,7 +221,7 @@ export interface PFrameSpecDriver {
   createSpecFrame(specs: Record<string, PColumnSpec>): PoolEntry<SpecFrameHandle>;
 
   /** List all columns currently registered in the frame. */
-  listColumns(handle: SpecFrameHandle): PColumnInfo[];
+  listColumns(handle: SpecFrameHandle): PColumnIdAndSpec[];
 
   /** Discover columns compatible with given axes integration. */
   discoverColumns(