@milaboratories/pl-model-common 1.36.2 → 1.38.0

package/dist/index.d.ts

@@ -5,28 +5,26 @@ import { CanonicalizedJson, JsonCompatible, JsonSerializable, StringifiedJson, b
 import { BlockState, BlockStateV3 } from "./block_state.js";
 import { Branded } from "./branding.js";
 import { DialogService, FileFilter, ShowSaveDialogOptions, ShowSaveDialogResult } from "./dialog/index.js";
-import { DatasetInput, DatasetOption, Option, PlRef, PrimaryRef, Ref, createPlRef, createPrimaryRef, isPlRef, isPrimaryRef, plRefsEqual, withEnrichments } from "./ref.js";
-import { ResultCollection, ResultPoolEntry } from "./pool/entry.js";
-import { BlobLike, FileLike } from "./drivers/interfaces.js";
-import { ArchiveFormat, BlobToURLDriver, BlockUIURL, FolderURL, FrontendDriver, isBlockUIURL, isFolderURL } from "./drivers/urls.js";
-import { BlobDriver, BlobHandleAndSize, ContentHandler, GetContentOptions, LocalBlobHandle, LocalBlobHandleAndSize, RangeBytes, RemoteBlobHandle, RemoteBlobHandleAndSize, newRangeBytesOpt, validateRangeBytes } from "./drivers/blob.js";
-import { ImportProgress, ImportStatus } from "./drivers/upload.js";
-import { AnyLogHandle, LiveLogHandle, LogsDriver, ProgressLogWithInfo, ReadyLogHandle, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, isAnyLogHandle, isLiveLog } from "./drivers/log.js";
-import { Annotation, 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 { ColumnFilter } from "./drivers/pframe/column_filter.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 { AAxisSelector, ADomain, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredPColumnId, AnchoredPColumnSelector, LegacyAxisSelector, PColumnSelector, SingleAxisSelector, isAnchoredPColumnId, legacyColumnSelectorsToPredicate, matchAxis, matchPColumn } from "./drivers/pframe/spec/selectors.js";
-import { AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, FilteredPColumn, FilteredPColumnId, isFilteredPColumn } from "./drivers/pframe/spec/filtered_column.js";
 import { PoolEntry, PoolEntryGuard } from "./pool_entry.js";
+import { AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, FilteredPColumn, FilteredPColumnId, isFilteredPColumn } from "./drivers/pframe/spec/filtered_column.js";
+import { DiscoveredPColumn, DiscoveredPColumnId, createDiscoveredPColumn, createDiscoveredPColumnId, 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 { 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 { 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 } from "./drivers/pframe/query/query_spec.js";
 import { DataExprAxisRef, DataExprColumnRef, DataQuery, DataQueryBooleanExpression, DataQueryColumn, DataQueryExpression, DataQueryFilter, DataQueryInlineColumn, DataQueryJoinEntry, DataQueryLinkerJoin, DataQueryLinkerJoinLinker, DataQueryOuterJoin, DataQuerySliceAxes, DataQuerySort, DataQuerySparseToDenseColumn, DataQuerySymmetricJoin } from "./drivers/pframe/query/query_data.js";
 import { collectSpecQueryColumns, isBooleanExpression, mapSpecQueryColumns, sortSpecQuery, traverseQuerySpec } from "./drivers/pframe/query/utils.js";
-import { AxisQualification, BuildQueryInput, ColumnAxesWithQualifications, DeleteColumnRequest, DeleteColumnResponse, DiscoverColumnsConstraints, DiscoverColumnsFilterStep, DiscoverColumnsLinkerStep, DiscoverColumnsMappingVariant, DiscoverColumnsRequest, DiscoverColumnsResponse, DiscoverColumnsResponseHit, DiscoverColumnsResponseQualifications, DiscoverColumnsStepInfo, EvaluateQueryResponse, MatcherMap, MultiAxisSelector, MultiColumnSelector, PFrameSpecDriver, SpecFrameHandle, StringMatcher } from "./drivers/pframe/spec_driver.js";
-import { DiscoveredPColumn, DiscoveredPColumnId, createDiscoveredPColumn, createDiscoveredPColumnId, isDiscoveredPColumn, parseDiscoveredPColumnId, stringifyDiscoveredPColumnId } from "./drivers/pframe/spec/discovered_column.js";
-import { SUniversalPColumnId, UniversalPColumnId, parseColumnId, stringifyColumnId } from "./drivers/pframe/spec/ids.js";
+import { BuildQueryInput, ColumnAxesWithQualifications, DeleteColumnRequest, DeleteColumnResponse, DiscoverColumnsConstraints, DiscoverColumnsFilterStep, DiscoverColumnsLinkerStep, DiscoverColumnsMappingVariant, DiscoverColumnsRequest, DiscoverColumnsResponse, DiscoverColumnsResponseHit, DiscoverColumnsResponseQualifications, DiscoverColumnsStepInfo, EvaluateQueryResponse, MatcherMap, MultiAxisSelector, MultiColumnSelector, PFrameSpecDriver, SpecFrameHandle, StringMatcher } from "./drivers/pframe/spec_driver.js";
+import { AAxisSelector, ADomain, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredPColumnId, AnchoredPColumnSelector, AxisQualification, LegacyAxisSelector, PColumnSelector, SingleAxisSelector, isAnchoredPColumnId, legacyColumnSelectorsToPredicate, matchAxis, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate } from "./drivers/pframe/spec/selectors.js";
+import { BlobLike, FileLike } from "./drivers/interfaces.js";
+import { ArchiveFormat, BlobToURLDriver, BlockUIURL, FolderURL, FrontendDriver, isBlockUIURL, isFolderURL } from "./drivers/urls.js";
+import { BlobDriver, BlobHandleAndSize, ContentHandler, GetContentOptions, LocalBlobHandle, LocalBlobHandleAndSize, RangeBytes, RemoteBlobHandle, RemoteBlobHandleAndSize, newRangeBytesOpt, validateRangeBytes } from "./drivers/blob.js";
+import { ImportProgress, ImportStatus } from "./drivers/upload.js";
+import { AnyLogHandle, LiveLogHandle, LogsDriver, ProgressLogWithInfo, ReadyLogHandle, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, isAnyLogHandle, isLiveLog } from "./drivers/log.js";
+import { ColumnFilter } from "./drivers/pframe/column_filter.js";
 import { FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, InferFilterSpecCommonLeaf, InferFilterSpecCommonNode, InferFilterSpecLeaf, InferFilterSpecLeafColumn, RootFilterSpec } from "./drivers/pframe/filter_spec.js";
 import { 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 { FindColumnsRequest, FindColumnsResponse } from "./drivers/pframe/find_columns.js";
@@ -37,6 +35,8 @@ import { CompositeLinkerMap, LinkerMap } from "./drivers/pframe/linker_columns.j
 import { FileRange, ImportFileHandle, ImportFileHandleIndex, ImportFileHandleUpload, ListFilesResult, LocalImportFileHandle, LsDriver, LsEntry, OpenDialogFilter, OpenDialogOps, OpenMultipleFilesResponse, OpenSingleFileResponse, StorageEntry, StorageHandle, StorageHandleLocal, StorageHandleRemote, getFileNameFromHandle, getFilePathFromHandle, isImportFileHandleIndex, isImportFileHandleUpload } from "./drivers/ls.js";
 import { ChunkedStreamReader, ChunkedStreamReaderOptions, ErrorHandlerStatus } from "./drivers/ChunkedStreamReader.js";
 import { PObject, PObjectId, PObjectSpec, ensurePColumn, extractAllColumns, isPColumn, isPColumnResult, isPColumnSpec, isPColumnSpecResult, mapPObjectData } from "./pool/spec.js";
+import { CreateEnrichmentRefOptions, DatasetInput, EnrichmentLinkerStep, EnrichmentRef, EnrichmentStep, LabeledEnrichmentRef, LabeledEnrichmentRefs, Option, PlRef, PrimaryRef, Ref, createEnrichmentRef, createPlRef, createPrimaryRef, isEnrichmentRef, isPlRef, isPrimaryRef, plRefsEqual, withEnrichments } from "./ref.js";
+import { ResultCollection, ResultPoolEntry } from "./pool/entry.js";
 import { PSpecPredicate, executePSpecPredicate } from "./pool/query.js";
 import { PFrame, PFrameDef } from "./drivers/pframe/pframe.js";
 import { PFrameDriver, PFrameHandle, PFrameModelDriver, PTableHandle } from "./drivers/pframe/driver.js";
@@ -63,4 +63,4 @@ import { Base64Compatible, Base64Encoded, base64Decode, base64Encode } from "./b
 import { assertNever, uniqueBy } from "./util.js";
 import { BasicHttpAuth, HttpAuth, parseHttpAuth, serializeHttpAuth } from "./httpAuth.js";
 import { ResourceTypeName, ResourceTypePrefix } from "./resource_types.js";
-export { AAxisSelector, ADomain, AbortError, AllRequiresFeatureFlags, AllSupportsFeatureFlags, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredIdDeriver, AnchoredPColumnId, AnchoredPColumnSelector, Annotation, 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, DataExprAxisRef, DataExprColumnRef, DataInfo, DataInfoEntries, DataQuery, DataQueryBooleanExpression, DataQueryColumn, DataQueryExpression, DataQueryFilter, DataQueryInlineColumn, DataQueryJoinEntry, DataQueryLinkerJoin, DataQueryLinkerJoinLinker, DataQueryOuterJoin, DataQuerySliceAxes, DataQuerySort, DataQuerySparseToDenseColumn, DataQuerySymmetricJoin, DatasetInput, DatasetOption, DefaultNavigationState, DeleteColumnRequest, DeleteColumnResponse, DialogService, DiscoverColumnsConstraints, DiscoverColumnsFilterStep, DiscoverColumnsLinkerStep, DiscoverColumnsMappingVariant, DiscoverColumnsRequest, DiscoverColumnsResponse, DiscoverColumnsResponseHit, DiscoverColumnsResponseQualifications, DiscoverColumnsStepInfo, DiscoveredPColumn, DiscoveredPColumnId, Domain, DomainJson, DriverKit, ErrorHandlerStatus, EvaluateQueryResponse, 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, 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, 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, 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, createDiscoveredPColumn, createDiscoveredPColumnId, createNodeServiceHandlers, createPlRef, createPrimaryRef, dataInfoToEntries, deriveNativeId, deserializeError, deserializeResult, digestPlId, 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, 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, matchPColumn, newRangeBytesOpt, pTableValue, pTableValueBranded, parseColumnId, parseDiscoveredPColumnId, parseHttpAuth, parseJson, 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, DatasetInput, DefaultNavigationState, DeleteColumnRequest, DeleteColumnResponse, DialogService, DiscoverColumnsConstraints, DiscoverColumnsFilterStep, DiscoverColumnsLinkerStep, DiscoverColumnsMappingVariant, DiscoverColumnsRequest, DiscoverColumnsResponse, DiscoverColumnsResponseHit, DiscoverColumnsResponseQualifications, DiscoverColumnsStepInfo, DiscoveredPColumn, DiscoveredPColumnId, Domain, DomainJson, DriverKit, EnrichmentLinkerStep, EnrichmentRef, EnrichmentStep, ErrorHandlerStatus, EvaluateQueryResponse, 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, 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, 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, createDiscoveredPColumn, createDiscoveredPColumnId, createEnrichmentRef, createNodeServiceHandlers, createPlRef, createPrimaryRef, dataInfoToEntries, deriveNativeId, deserializeError, deserializeResult, digestPlId, 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, 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

@@ -20,7 +20,7 @@ import { AnchoredIdDeriver, resolveAnchors } from "./drivers/pframe/spec/anchore
 import { isFilteredPColumn } from "./drivers/pframe/spec/filtered_column.js";
 import { ensurePColumn, extractAllColumns, isPColumn, isPColumnResult, isPColumnSpec, isPColumnSpecResult, mapPObjectData } from "./pool/spec.js";
 import { executePSpecPredicate } from "./pool/query.js";
-import { isAnchoredPColumnId, legacyColumnSelectorsToPredicate, matchAxis, matchPColumn } from "./drivers/pframe/spec/selectors.js";
+import { isAnchoredPColumnId, legacyColumnSelectorsToPredicate, matchAxis, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate } from "./drivers/pframe/spec/selectors.js";
 import { deriveNativeId } from "./drivers/pframe/spec/native_id.js";
 import { createDiscoveredPColumn, createDiscoveredPColumnId, isDiscoveredPColumn, parseDiscoveredPColumnId, stringifyDiscoveredPColumnId } from "./drivers/pframe/spec/discovered_column.js";
 import { LinkerMap } from "./drivers/pframe/linker_columns.js";
@@ -30,7 +30,7 @@ import { AllRequiresFeatureFlags, AllSupportsFeatureFlags } from "./flags/block_
 import { IncompatibleFlagsError, RuntimeCapabilities, checkBlockFlag, extractAllRequirements, extractAllSupports } from "./flags/flag_utils.js";
 import { DefaultNavigationState } from "./navigation.js";
 import { PlId, PlIdBytes, PlIdLength, digestPlId, plId, uniquePlId } from "./plid.js";
-import { PlRef, createPlRef, createPrimaryRef, isPlRef, isPrimaryRef, plRefsEqual, withEnrichments } from "./ref.js";
+import { PlRef, createEnrichmentRef, createPlRef, createPrimaryRef, isEnrichmentRef, isPlRef, isPrimaryRef, plRefsEqual, withEnrichments } from "./ref.js";
 import { mapValueInVOE } from "./value_or_error.js";
 import { base64Decode, base64Encode } from "./base64.js";
 import { parseHttpAuth, serializeHttpAuth } from "./httpAuth.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, 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, createDiscoveredPColumn, createDiscoveredPColumnId, createNodeServiceHandlers, createPlRef, createPrimaryRef, dataInfoToEntries, deriveNativeId, deserializeError, deserializeResult, digestPlId, 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, 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, matchPColumn, newRangeBytesOpt, pTableValue, pTableValueBranded, parseColumnId, parseDiscoveredPColumnId, parseHttpAuth, parseJson, 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, 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, createDiscoveredPColumn, createDiscoveredPColumnId, createEnrichmentRef, createNodeServiceHandlers, createPlRef, createPrimaryRef, dataInfoToEntries, deriveNativeId, deserializeError, deserializeResult, digestPlId, 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, 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/pool/index.d.ts

@@ -1,3 +1,3 @@
-import { ResultCollection, ResultPoolEntry } from "./entry.js";
 import { PObject, PObjectId, PObjectSpec, ensurePColumn, extractAllColumns, isPColumn, isPColumnResult, isPColumnSpec, isPColumnSpecResult, mapPObjectData } from "./spec.js";
+import { ResultCollection, ResultPoolEntry } from "./entry.js";
 import { PSpecPredicate, executePSpecPredicate } from "./query.js";

package/dist/pool/spec.d.ts

@@ -1,7 +1,8 @@
 import { Branded } from "../branding.js";
-import { ResultPoolEntry } from "./entry.js";
 import { PColumn, PColumnLazy, PColumnSpec } from "../drivers/pframe/spec/spec.js";
 import { JoinEntry } from "../drivers/pframe/table_calculate.js";
+import { ResultPoolEntry } from "./entry.js";
+
 //#region src/pool/spec.d.ts
 /** Any object exported into the result pool by the block always have spec attached to it */
 type PObjectSpec = {

package/dist/pool/spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","names":[],"sources":["../../src/pool/spec.ts"],"mappings":";;;;;;KAMY,WAAA;4CAED,IAAA,UAFC;EAAA,SAKD,IAAA;WAGA,MAAA,GAAS,MAAA;EAIO;;EAAA,SAAhB,aAAA,GAAgB,MAAA,kBAGI;EAAA,SAApB,WAAA,GAAc,MAAA;AAAA;;KAIb,SAAA,GAAY,OAAA;;;;;;UAOP,OAAA;EAPL;EAAA,SASD,EAAA,EAAI,SAAA;;WAGJ,IAAA,EAAM,WAAA;EAZc;EAAA,SAepB,IAAA,EAAM,IAAA;AAAA;AAAA,iBAGD,aAAA,CAAc,IAAA,EAAM,WAAA,GAAc,IAAA,IAAQ,WAAA;AAAA,iBAI1C,SAAA,GAAA,CAAa,GAAA,EAAK,OAAA,CAAQ,CAAA,IAAK,GAAA,IAAO,OAAA,CAAQ,CAAA;AAAA,iBAI9C,mBAAA,CACd,CAAA,EAAG,eAAA,CAAgB,WAAA,IAClB,CAAA,IAAK,eAAA,CAAgB,WAAA;AAAA,iBAIR,eAAA,GAAA,CACd,CAAA,EAAG,eAAA,CAAgB,OAAA,CAAQ,CAAA,KAC1B,CAAA,IAAK,eAAA,CAAgB,OAAA,CAAQ,CAAA;AAAA,iBAIhB,aAAA,GAAA,CAAiB,GAAA,EAAK,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA;AAAA,iBAK3C,cAAA,QAAA,CACd,IAAA,EAAM,OAAA,CAAQ,EAAA,IAAM,WAAA,CAAY,EAAA,GAChC,EAAA,GAAK,CAAA,EAAG,EAAA,KAAO,EAAA,GACd,OAAA,CAAQ,EAAA;AAAA,iBACK,cAAA,QAAA,CAAuB,IAAA,EAAM,OAAA,CAAQ,EAAA,GAAK,EAAA,GAAK,CAAA,EAAG,EAAA,KAAO,EAAA,GAAK,OAAA,CAAQ,EAAA;AAAA,iBACtE,cAAA,QAAA,CACd,IAAA,EAAM,OAAA,CAAQ,EAAA,eACd,EAAA,GAAK,CAAA,EAAG,EAAA,KAAO,EAAA,GACd,OAAA,CAAQ,EAAA;AAAA,iBACK,cAAA,QAAA,CAAuB,IAAA,EAAM,OAAA,CAAQ,EAAA,GAAK,EAAA,GAAK,CAAA,EAAG,EAAA,KAAO,EAAA,GAAK,OAAA,CAAQ,EAAA;AAAA,iBACtE,cAAA,QAAA,CACd,IAAA,EAAM,OAAA,CAAQ,EAAA,eACd,EAAA,GAAK,CAAA,EAAG,EAAA,KAAO,EAAA,GACd,OAAA,CAAQ,EAAA;AAAA,iBAaK,iBAAA,GAAA,CAAqB,KAAA,EAAO,SAAA,CAAU,OAAA,CAAQ,CAAA,KAAM,OAAA,CAAQ,CAAA"}
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../src/pool/spec.ts"],"mappings":";;;;;;;KAMY,WAAA;4CAED,IAAA,UAFC;EAAA,SAKD,IAAA;WAGA,MAAA,GAAS,MAAA;EAIO;;EAAA,SAAhB,aAAA,GAAgB,MAAA,kBAGI;EAAA,SAApB,WAAA,GAAc,MAAA;AAAA;;KAIb,SAAA,GAAY,OAAA;;;;;;UAOP,OAAA;EAPL;EAAA,SASD,EAAA,EAAI,SAAA;;WAGJ,IAAA,EAAM,WAAA;EAZc;EAAA,SAepB,IAAA,EAAM,IAAA;AAAA;AAAA,iBAGD,aAAA,CAAc,IAAA,EAAM,WAAA,GAAc,IAAA,IAAQ,WAAA;AAAA,iBAI1C,SAAA,GAAA,CAAa,GAAA,EAAK,OAAA,CAAQ,CAAA,IAAK,GAAA,IAAO,OAAA,CAAQ,CAAA;AAAA,iBAI9C,mBAAA,CACd,CAAA,EAAG,eAAA,CAAgB,WAAA,IAClB,CAAA,IAAK,eAAA,CAAgB,WAAA;AAAA,iBAIR,eAAA,GAAA,CACd,CAAA,EAAG,eAAA,CAAgB,OAAA,CAAQ,CAAA,KAC1B,CAAA,IAAK,eAAA,CAAgB,OAAA,CAAQ,CAAA;AAAA,iBAIhB,aAAA,GAAA,CAAiB,GAAA,EAAK,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA;AAAA,iBAK3C,cAAA,QAAA,CACd,IAAA,EAAM,OAAA,CAAQ,EAAA,IAAM,WAAA,CAAY,EAAA,GAChC,EAAA,GAAK,CAAA,EAAG,EAAA,KAAO,EAAA,GACd,OAAA,CAAQ,EAAA;AAAA,iBACK,cAAA,QAAA,CAAuB,IAAA,EAAM,OAAA,CAAQ,EAAA,GAAK,EAAA,GAAK,CAAA,EAAG,EAAA,KAAO,EAAA,GAAK,OAAA,CAAQ,EAAA;AAAA,iBACtE,cAAA,QAAA,CACd,IAAA,EAAM,OAAA,CAAQ,EAAA,eACd,EAAA,GAAK,CAAA,EAAG,EAAA,KAAO,EAAA,GACd,OAAA,CAAQ,EAAA;AAAA,iBACK,cAAA,QAAA,CAAuB,IAAA,EAAM,OAAA,CAAQ,EAAA,GAAK,EAAA,GAAK,CAAA,EAAG,EAAA,KAAO,EAAA,GAAK,OAAA,CAAQ,EAAA;AAAA,iBACtE,cAAA,QAAA,CACd,IAAA,EAAM,OAAA,CAAQ,EAAA,eACd,EAAA,GAAK,CAAA,EAAG,EAAA,KAAO,EAAA,GACd,OAAA,CAAQ,EAAA;AAAA,iBAaK,iBAAA,GAAA,CAAqB,KAAA,EAAO,SAAA,CAAU,OAAA,CAAQ,CAAA,KAAM,OAAA,CAAQ,CAAA"}

package/dist/ref.cjs

@@ -69,14 +69,28 @@ function createPrimaryRef(column, filter) {
 		column
 	};
 }
+function isEnrichmentRef(value) {
+	return typeof value === "object" && value !== null && value.__isEnrichment === "v1" && "hit" in value;
+}
+function createEnrichmentRef(hit, options = {}) {
+	const { path, qualifications } = options;
+	return {
+		__isEnrichment: "v1",
+		hit,
+		...path !== void 0 && path.length > 0 ? { path } : {},
+		...qualifications !== void 0 && qualifications.length > 0 ? { qualifications } : {}
+	};
+}
 /** Compare two PlRefs and returns true if they are qual */
 function plRefsEqual(ref1, ref2, ignoreEnrichments = false) {
 	return ref1.blockId === ref2.blockId && ref1.name === ref2.name && (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments);
 }
 //#endregion
 exports.PlRef = PlRef;
+exports.createEnrichmentRef = createEnrichmentRef;
 exports.createPlRef = createPlRef;
 exports.createPrimaryRef = createPrimaryRef;
+exports.isEnrichmentRef = isEnrichmentRef;
 exports.isPlRef = isPlRef;
 exports.isPrimaryRef = isPrimaryRef;
 exports.plRefsEqual = plRefsEqual;

package/dist/ref.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ref.cjs","names":["z"],"sources":["../src/ref.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const PlRef = z\n  .object({\n    __isRef: z\n      .literal(true)\n      .describe(\"Crucial marker for the block dependency tree reconstruction\"),\n    blockId: z.string().describe(\"Upstream block id\"),\n    name: z.string().describe(\"Name of the output provided to the upstream block's output context\"),\n    requireEnrichments: z\n      .literal(true)\n      .optional()\n      .describe(\n        \"True if current block that stores this reference in its args, may need enrichments \" +\n          \"for the references value originating from the blocks in between current and referenced block\",\n      ),\n  })\n  .describe(\n    \"Universal reference type, allowing to set block connections. It is crucial that \" +\n      \"{@link __isRef} is present and equal to true, internal logic relies on this marker \" +\n      \"to build block dependency trees.\",\n  )\n  .readonly();\nexport type PlRef = z.infer<typeof PlRef>;\n/** @deprecated use {@link PlRef} */\nexport type Ref = PlRef;\n\n/**\n * Type guard to check if a value is a PlRef.\n *\n * @param value - The value to check.\n * @returns True if the value is a PlRef, false otherwise.\n */\nexport function isPlRef(value: unknown): value is PlRef {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"__isRef\" in value &&\n    (value as { __isRef: unknown }).__isRef === true &&\n    \"blockId\" in value &&\n    \"name\" in value\n  );\n}\n\n/** Standard way how to communicate possible connections given specific\n * requirements for incoming data. */\nexport type Option = {\n  /** Fully rendered reference to be assigned for the intended field in block's\n   * args */\n  readonly ref: PlRef;\n\n  /** Label to be present for the user in i.e. drop-down list */\n  readonly label: string;\n};\n\n/**\n * Creates a PlRef with the given blockId and name.\n *\n * @param blockId - The blockId of the reference.\n * @param name - The name of the reference.\n * @param requireEnrichments - Whether the reference requires enrichments.\n */\nexport function createPlRef(\n  blockId: string,\n  name: string,\n  requireEnrichments: boolean = false,\n): PlRef {\n  if (requireEnrichments)\n    return {\n      __isRef: true,\n      blockId,\n      name,\n      requireEnrichments: true,\n    };\n  else\n    return {\n      __isRef: true,\n      blockId,\n      name,\n    };\n}\n\n/**\n * Creates a new PlRef based on an existing one, explicitly setting (default) or removing the\n * requireEnrichments property.\n *\n * @param ref - The original PlRef object.\n * @param requireEnrichments - If true, the `requireEnrichments: true` property is added\n *   to the returned PlRef. If false, the `requireEnrichments` property is removed. Defaults to true.\n * @returns A new PlRef object with the `requireEnrichments` property set or removed accordingly.\n */\nexport function withEnrichments(ref: PlRef, requireEnrichments: boolean = true): PlRef {\n  if (requireEnrichments)\n    return {\n      ...ref,\n      requireEnrichments: true,\n    };\n  else {\n    const { requireEnrichments: _, ...rest } = ref;\n    return rest;\n  }\n}\n\n/** Primary dataset reference with an optional filter. */\nexport type PrimaryRef = {\n  readonly __isPrimaryRef: \"v1\";\n  readonly column: PlRef;\n  readonly filter?: PlRef;\n};\n\nexport function isPrimaryRef(value: unknown): value is PrimaryRef {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as { __isPrimaryRef?: unknown }).__isPrimaryRef === \"v1\" &&\n    \"column\" in value\n  );\n}\n\nexport function createPrimaryRef(column: PlRef, filter?: PlRef): PrimaryRef {\n  if (filter !== undefined) return { __isPrimaryRef: \"v1\", column, filter };\n  else return { __isPrimaryRef: \"v1\", column };\n}\n\n/** Block args accept either form — backward compatible. */\nexport type DatasetInput = PlRef | PrimaryRef;\n\n/** Dataset option with optional filter choices. */\nexport type DatasetOption = Option & {\n  readonly filters?: readonly Option[];\n};\n\n/** Compare two PlRefs and returns true if they are qual */\nexport function plRefsEqual(ref1: PlRef, ref2: PlRef, ignoreEnrichments: boolean = false) {\n  return (\n    ref1.blockId === ref2.blockId &&\n    ref1.name === ref2.name &&\n    (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments)\n  );\n}\n"],"mappings":";;;AAEA,MAAa,QAAQA,IAAAA,EAClB,OAAO;CACN,SAASA,IAAAA,EACN,QAAQ,KAAK,CACb,SAAS,8DAA8D;CAC1E,SAASA,IAAAA,EAAE,QAAQ,CAAC,SAAS,oBAAoB;CACjD,MAAMA,IAAAA,EAAE,QAAQ,CAAC,SAAS,qEAAqE;CAC/F,oBAAoBA,IAAAA,EACjB,QAAQ,KAAK,CACb,UAAU,CACV,SACC,kLAED;CACJ,CAAC,CACD,SACC,sMAGD,CACA,UAAU;;;;;;;AAWb,SAAgB,QAAQ,OAAgC;AACtD,QACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACZ,MAA+B,YAAY,QAC5C,aAAa,SACb,UAAU;;;;;;;;;AAsBd,SAAgB,YACd,SACA,MACA,qBAA8B,OACvB;AACP,KAAI,mBACF,QAAO;EACL,SAAS;EACT;EACA;EACA,oBAAoB;EACrB;KAED,QAAO;EACL,SAAS;EACT;EACA;EACD;;;;;;;;;;;AAYL,SAAgB,gBAAgB,KAAY,qBAA8B,MAAa;AACrF,KAAI,mBACF,QAAO;EACL,GAAG;EACH,oBAAoB;EACrB;MACE;EACH,MAAM,EAAE,oBAAoB,GAAG,GAAG,SAAS;AAC3C,SAAO;;;AAWX,SAAgB,aAAa,OAAqC;AAChE,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAuC,mBAAmB,QAC3D,YAAY;;AAIhB,SAAgB,iBAAiB,QAAe,QAA4B;AAC1E,KAAI,WAAW,KAAA,EAAW,QAAO;EAAE,gBAAgB;EAAM;EAAQ;EAAQ;KACpE,QAAO;EAAE,gBAAgB;EAAM;EAAQ;;;AAY9C,SAAgB,YAAY,MAAa,MAAa,oBAA6B,OAAO;AACxF,QACE,KAAK,YAAY,KAAK,WACtB,KAAK,SAAS,KAAK,SAClB,qBAAqB,KAAK,uBAAuB,KAAK"}
+{"version":3,"file":"ref.cjs","names":["z"],"sources":["../src/ref.ts"],"sourcesContent":["import { z } from \"zod\";\nimport type { AxisQualification } from \"./drivers/pframe/spec/selectors\";\nimport type { PObjectId } from \"./pool/spec\";\n\nexport const PlRef = z\n  .object({\n    __isRef: z\n      .literal(true)\n      .describe(\"Crucial marker for the block dependency tree reconstruction\"),\n    blockId: z.string().describe(\"Upstream block id\"),\n    name: z.string().describe(\"Name of the output provided to the upstream block's output context\"),\n    requireEnrichments: z\n      .literal(true)\n      .optional()\n      .describe(\n        \"True if current block that stores this reference in its args, may need enrichments \" +\n          \"for the references value originating from the blocks in between current and referenced block\",\n      ),\n  })\n  .describe(\n    \"Universal reference type, allowing to set block connections. It is crucial that \" +\n      \"{@link __isRef} is present and equal to true, internal logic relies on this marker \" +\n      \"to build block dependency trees.\",\n  )\n  .readonly();\nexport type PlRef = z.infer<typeof PlRef>;\n/** @deprecated use {@link PlRef} */\nexport type Ref = PlRef;\n\n/**\n * Type guard to check if a value is a PlRef.\n *\n * @param value - The value to check.\n * @returns True if the value is a PlRef, false otherwise.\n */\nexport function isPlRef(value: unknown): value is PlRef {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"__isRef\" in value &&\n    (value as { __isRef: unknown }).__isRef === true &&\n    \"blockId\" in value &&\n    \"name\" in value\n  );\n}\n\n/** Standard way how to communicate possible connections given specific\n * requirements for incoming data. */\nexport type Option = {\n  /** Fully rendered reference to be assigned for the intended field in block's\n   * args */\n  readonly ref: PlRef;\n\n  /** Label to be present for the user in i.e. drop-down list */\n  readonly label: string;\n};\n\n/**\n * Creates a PlRef with the given blockId and name.\n *\n * @param blockId - The blockId of the reference.\n * @param name - The name of the reference.\n * @param requireEnrichments - Whether the reference requires enrichments.\n */\nexport function createPlRef(\n  blockId: string,\n  name: string,\n  requireEnrichments: boolean = false,\n): PlRef {\n  if (requireEnrichments)\n    return {\n      __isRef: true,\n      blockId,\n      name,\n      requireEnrichments: true,\n    };\n  else\n    return {\n      __isRef: true,\n      blockId,\n      name,\n    };\n}\n\n/**\n * Creates a new PlRef based on an existing one, explicitly setting (default) or removing the\n * requireEnrichments property.\n *\n * @param ref - The original PlRef object.\n * @param requireEnrichments - If true, the `requireEnrichments: true` property is added\n *   to the returned PlRef. If false, the `requireEnrichments` property is removed. Defaults to true.\n * @returns A new PlRef object with the `requireEnrichments` property set or removed accordingly.\n */\nexport function withEnrichments(ref: PlRef, requireEnrichments: boolean = true): PlRef {\n  if (requireEnrichments)\n    return {\n      ...ref,\n      requireEnrichments: true,\n    };\n  else {\n    const { requireEnrichments: _, ...rest } = ref;\n    return rest;\n  }\n}\n\n/** Primary dataset reference with an optional filter. */\nexport type PrimaryRef = {\n  readonly __isPrimaryRef: \"v1\";\n  readonly column: PlRef;\n  readonly filter?: PlRef;\n};\n\nexport function isPrimaryRef(value: unknown): value is PrimaryRef {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as { __isPrimaryRef?: unknown }).__isPrimaryRef === \"v1\" &&\n    \"column\" in value\n  );\n}\n\nexport function createPrimaryRef(column: PlRef, filter?: PlRef): PrimaryRef {\n  if (filter !== undefined) return { __isPrimaryRef: \"v1\", column, filter };\n  else return { __isPrimaryRef: \"v1\", column };\n}\n\n/** Block args accept either form — backward compatible. */\nexport type DatasetInput = PlRef | PrimaryRef;\n\n/** Many-to-one linker hop. */\nexport type EnrichmentLinkerStep = {\n  readonly type: \"linker\";\n  readonly linker: PObjectId;\n};\n\n/** Step from primary to hit. `path[0]` applied first. */\nexport type EnrichmentStep = EnrichmentLinkerStep;\n\n/**\n * Enrichment column reached via {@link path} linker hops; omitted means zero-hop.\n * `hit` and `path[].linker` are global-form {@link PObjectId}s\n * (`canonicalize({ __isRef: true, blockId, name })`) which the workflow decodes\n * to a PlRef before resolving. For a prerun-sourced hop, supply a resolved\n * `{spec, data}` map in place of the id — `tableBuilder` accepts both.\n */\nexport type EnrichmentRef = {\n  readonly __isEnrichment: \"v1\";\n  readonly hit: PObjectId;\n  readonly path?: readonly EnrichmentStep[];\n  readonly qualifications?: readonly AxisQualification[];\n};\n\nexport function isEnrichmentRef(value: unknown): value is EnrichmentRef {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as { __isEnrichment?: unknown }).__isEnrichment === \"v1\" &&\n    \"hit\" in value\n  );\n}\n\nexport type CreateEnrichmentRefOptions = {\n  readonly path?: readonly EnrichmentStep[];\n  readonly qualifications?: readonly AxisQualification[];\n};\n\nexport function createEnrichmentRef(\n  hit: PObjectId,\n  options: CreateEnrichmentRefOptions = {},\n): EnrichmentRef {\n  const { path, qualifications } = options;\n  return {\n    __isEnrichment: \"v1\",\n    hit,\n    ...(path !== undefined && path.length > 0 ? { path } : {}),\n    ...(qualifications !== undefined && qualifications.length > 0 ? { qualifications } : {}),\n  };\n}\n\n/** {@link EnrichmentRef} plus the export header label. */\nexport type LabeledEnrichmentRef = {\n  readonly ref: EnrichmentRef;\n  readonly label: string;\n};\n\n/** Auto-attached enrichment payload; not user-picked. */\nexport type LabeledEnrichmentRefs = readonly LabeledEnrichmentRef[];\n\n/** Compare two PlRefs and returns true if they are qual */\nexport function plRefsEqual(ref1: PlRef, ref2: PlRef, ignoreEnrichments: boolean = false) {\n  return (\n    ref1.blockId === ref2.blockId &&\n    ref1.name === ref2.name &&\n    (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments)\n  );\n}\n"],"mappings":";;;AAIA,MAAa,QAAQA,IAAAA,EAClB,OAAO;CACN,SAASA,IAAAA,EACN,QAAQ,KAAK,CACb,SAAS,8DAA8D;CAC1E,SAASA,IAAAA,EAAE,QAAQ,CAAC,SAAS,oBAAoB;CACjD,MAAMA,IAAAA,EAAE,QAAQ,CAAC,SAAS,qEAAqE;CAC/F,oBAAoBA,IAAAA,EACjB,QAAQ,KAAK,CACb,UAAU,CACV,SACC,kLAED;CACJ,CAAC,CACD,SACC,sMAGD,CACA,UAAU;;;;;;;AAWb,SAAgB,QAAQ,OAAgC;AACtD,QACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACZ,MAA+B,YAAY,QAC5C,aAAa,SACb,UAAU;;;;;;;;;AAsBd,SAAgB,YACd,SACA,MACA,qBAA8B,OACvB;AACP,KAAI,mBACF,QAAO;EACL,SAAS;EACT;EACA;EACA,oBAAoB;EACrB;KAED,QAAO;EACL,SAAS;EACT;EACA;EACD;;;;;;;;;;;AAYL,SAAgB,gBAAgB,KAAY,qBAA8B,MAAa;AACrF,KAAI,mBACF,QAAO;EACL,GAAG;EACH,oBAAoB;EACrB;MACE;EACH,MAAM,EAAE,oBAAoB,GAAG,GAAG,SAAS;AAC3C,SAAO;;;AAWX,SAAgB,aAAa,OAAqC;AAChE,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAuC,mBAAmB,QAC3D,YAAY;;AAIhB,SAAgB,iBAAiB,QAAe,QAA4B;AAC1E,KAAI,WAAW,KAAA,EAAW,QAAO;EAAE,gBAAgB;EAAM;EAAQ;EAAQ;KACpE,QAAO;EAAE,gBAAgB;EAAM;EAAQ;;AA6B9C,SAAgB,gBAAgB,OAAwC;AACtE,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAuC,mBAAmB,QAC3D,SAAS;;AASb,SAAgB,oBACd,KACA,UAAsC,EAAE,EACzB;CACf,MAAM,EAAE,MAAM,mBAAmB;AACjC,QAAO;EACL,gBAAgB;EAChB;EACA,GAAI,SAAS,KAAA,KAAa,KAAK,SAAS,IAAI,EAAE,MAAM,GAAG,EAAE;EACzD,GAAI,mBAAmB,KAAA,KAAa,eAAe,SAAS,IAAI,EAAE,gBAAgB,GAAG,EAAE;EACxF;;;AAaH,SAAgB,YAAY,MAAa,MAAa,oBAA6B,OAAO;AACxF,QACE,KAAK,YAAY,KAAK,WACtB,KAAK,SAAS,KAAK,SAClB,qBAAqB,KAAK,uBAAuB,KAAK"}

package/dist/ref.d.ts

@@ -1,3 +1,5 @@
+import { AxisQualification } from "./drivers/pframe/spec/selectors.js";
+import { PObjectId } from "./pool/spec.js";
 import { z } from "zod";
 
 //#region src/ref.d.ts
@@ -63,12 +65,41 @@ declare function isPrimaryRef(value: unknown): value is PrimaryRef;
 declare function createPrimaryRef(column: PlRef, filter?: PlRef): PrimaryRef;
 /** Block args accept either form — backward compatible. */
 type DatasetInput = PlRef | PrimaryRef;
-/** Dataset option with optional filter choices. */
-type DatasetOption = Option & {
-  readonly filters?: readonly Option[];
+/** Many-to-one linker hop. */
+type EnrichmentLinkerStep = {
+  readonly type: "linker";
+  readonly linker: PObjectId;
 };
+/** Step from primary to hit. `path[0]` applied first. */
+type EnrichmentStep = EnrichmentLinkerStep;
+/**
+ * Enrichment column reached via {@link path} linker hops; omitted means zero-hop.
+ * `hit` and `path[].linker` are global-form {@link PObjectId}s
+ * (`canonicalize({ __isRef: true, blockId, name })`) which the workflow decodes
+ * to a PlRef before resolving. For a prerun-sourced hop, supply a resolved
+ * `{spec, data}` map in place of the id — `tableBuilder` accepts both.
+ */
+type EnrichmentRef = {
+  readonly __isEnrichment: "v1";
+  readonly hit: PObjectId;
+  readonly path?: readonly EnrichmentStep[];
+  readonly qualifications?: readonly AxisQualification[];
+};
+declare function isEnrichmentRef(value: unknown): value is EnrichmentRef;
+type CreateEnrichmentRefOptions = {
+  readonly path?: readonly EnrichmentStep[];
+  readonly qualifications?: readonly AxisQualification[];
+};
+declare function createEnrichmentRef(hit: PObjectId, options?: CreateEnrichmentRefOptions): EnrichmentRef;
+/** {@link EnrichmentRef} plus the export header label. */
+type LabeledEnrichmentRef = {
+  readonly ref: EnrichmentRef;
+  readonly label: string;
+};
+/** Auto-attached enrichment payload; not user-picked. */
+type LabeledEnrichmentRefs = readonly LabeledEnrichmentRef[];
 /** Compare two PlRefs and returns true if they are qual */
 declare function plRefsEqual(ref1: PlRef, ref2: PlRef, ignoreEnrichments?: boolean): boolean;
 //#endregion
-export { DatasetInput, DatasetOption, Option, PlRef, PrimaryRef, Ref, createPlRef, createPrimaryRef, isPlRef, isPrimaryRef, plRefsEqual, withEnrichments };
+export { CreateEnrichmentRefOptions, DatasetInput, EnrichmentLinkerStep, EnrichmentRef, EnrichmentStep, LabeledEnrichmentRef, LabeledEnrichmentRefs, Option, PlRef, PrimaryRef, Ref, createEnrichmentRef, createPlRef, createPrimaryRef, isEnrichmentRef, isPlRef, isPrimaryRef, plRefsEqual, withEnrichments };
 //# sourceMappingURL=ref.d.ts.map

package/dist/ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ref.d.ts","names":[],"sources":["../src/ref.ts"],"mappings":";;;cAEa,KAAA,EAAK,CAAA,CAAA,WAAA,CAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;KAqBN,KAAA,GAAQ,CAAA,CAAE,KAAA,QAAa,KAAA;;KAEvB,GAAA,GAAM,KAAA;;;;;;;iBAQF,OAAA,CAAQ,KAAA,YAAiB,KAAA,IAAS,KAAA;;;KAatC,MAAA;;;WAGD,GAAA,EAAK,KAAA;WAGL,KAAA;AAAA;;;;;;;;iBAUK,WAAA,CACd,OAAA,UACA,IAAA,UACA,kBAAA,aACC,KAAA;;;AA3CH;;;;;;;iBAoEgB,eAAA,CAAgB,GAAA,EAAK,KAAA,EAAO,kBAAA,aAAqC,KAAA;;KAarE,UAAA;EAAA,SACD,cAAA;EAAA,SACA,MAAA,EAAQ,KAAA;EAAA,SACR,MAAA,GAAS,KAAA;AAAA;AAAA,iBAGJ,YAAA,CAAa,KAAA,YAAiB,KAAA,IAAS,UAAA;AAAA,iBASvC,gBAAA,CAAiB,MAAA,EAAQ,KAAA,EAAO,MAAA,GAAS,KAAA,GAAQ,UAAA;;KAMrD,YAAA,GAAe,KAAA,GAAQ,UAAA;;KAGvB,aAAA,GAAgB,MAAA;EAAA,SACjB,OAAA,YAAmB,MAAA;AAAA;;iBAId,WAAA,CAAY,IAAA,EAAM,KAAA,EAAO,IAAA,EAAM,KAAA,EAAO,iBAAA"}
+{"version":3,"file":"ref.d.ts","names":[],"sources":["../src/ref.ts"],"mappings":";;;;;cAIa,KAAA,EAAK,CAAA,CAAA,WAAA,CAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;KAqBN,KAAA,GAAQ,CAAA,CAAE,KAAA,QAAa,KAAA;;KAEvB,GAAA,GAAM,KAAA;;;;;;;iBAQF,OAAA,CAAQ,KAAA,YAAiB,KAAA,IAAS,KAAA;;;KAatC,MAAA;;;WAGD,GAAA,EAAK,KAAA;WAGL,KAAA;AAAA;;;;;;;;iBAUK,WAAA,CACd,OAAA,UACA,IAAA,UACA,kBAAA,aACC,KAAA;;;AA3CH;;;;;;;iBAoEgB,eAAA,CAAgB,GAAA,EAAK,KAAA,EAAO,kBAAA,aAAqC,KAAA;;KAarE,UAAA;EAAA,SACD,cAAA;EAAA,SACA,MAAA,EAAQ,KAAA;EAAA,SACR,MAAA,GAAS,KAAA;AAAA;AAAA,iBAGJ,YAAA,CAAa,KAAA,YAAiB,KAAA,IAAS,UAAA;AAAA,iBASvC,gBAAA,CAAiB,MAAA,EAAQ,KAAA,EAAO,MAAA,GAAS,KAAA,GAAQ,UAAA;;KAMrD,YAAA,GAAe,KAAA,GAAQ,UAAA;;KAGvB,oBAAA;EAAA,SACD,IAAA;EAAA,SACA,MAAA,EAAQ,SAAA;AAAA;AApFnB;AAAA,KAwFY,cAAA,GAAiB,oBAAA;;;;;;;;KASjB,aAAA;EAAA,SACD,cAAA;EAAA,SACA,GAAA,EAAK,SAAA;EAAA,SACL,IAAA,YAAgB,cAAA;EAAA,SAChB,cAAA,YAA0B,iBAAA;AAAA;AAAA,iBAGrB,eAAA,CAAgB,KAAA,YAAiB,KAAA,IAAS,aAAA;AAAA,KAS9C,0BAAA;EAAA,SACD,IAAA,YAAgB,cAAA;EAAA,SAChB,cAAA,YAA0B,iBAAA;AAAA;AAAA,iBAGrB,mBAAA,CACd,GAAA,EAAK,SAAA,EACL,OAAA,GAAS,0BAAA,GACR,aAAA;;KAWS,oBAAA;EAAA,SACD,GAAA,EAAK,aAAA;EAAA,SACL,KAAA;AAAA;;KAIC,qBAAA,YAAiC,oBAAA;;iBAG7B,WAAA,CAAY,IAAA,EAAM,KAAA,EAAO,IAAA,EAAM,KAAA,EAAO,iBAAA"}

package/dist/ref.js

@@ -68,11 +68,23 @@ function createPrimaryRef(column, filter) {
 		column
 	};
 }
+function isEnrichmentRef(value) {
+	return typeof value === "object" && value !== null && value.__isEnrichment === "v1" && "hit" in value;
+}
+function createEnrichmentRef(hit, options = {}) {
+	const { path, qualifications } = options;
+	return {
+		__isEnrichment: "v1",
+		hit,
+		...path !== void 0 && path.length > 0 ? { path } : {},
+		...qualifications !== void 0 && qualifications.length > 0 ? { qualifications } : {}
+	};
+}
 /** Compare two PlRefs and returns true if they are qual */
 function plRefsEqual(ref1, ref2, ignoreEnrichments = false) {
 	return ref1.blockId === ref2.blockId && ref1.name === ref2.name && (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments);
 }
 //#endregion
-export { PlRef, createPlRef, createPrimaryRef, isPlRef, isPrimaryRef, plRefsEqual, withEnrichments };
+export { PlRef, createEnrichmentRef, createPlRef, createPrimaryRef, isEnrichmentRef, isPlRef, isPrimaryRef, plRefsEqual, withEnrichments };
 
 //# sourceMappingURL=ref.js.map

package/dist/ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"ref.js","names":[],"sources":["../src/ref.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const PlRef = z\n  .object({\n    __isRef: z\n      .literal(true)\n      .describe(\"Crucial marker for the block dependency tree reconstruction\"),\n    blockId: z.string().describe(\"Upstream block id\"),\n    name: z.string().describe(\"Name of the output provided to the upstream block's output context\"),\n    requireEnrichments: z\n      .literal(true)\n      .optional()\n      .describe(\n        \"True if current block that stores this reference in its args, may need enrichments \" +\n          \"for the references value originating from the blocks in between current and referenced block\",\n      ),\n  })\n  .describe(\n    \"Universal reference type, allowing to set block connections. It is crucial that \" +\n      \"{@link __isRef} is present and equal to true, internal logic relies on this marker \" +\n      \"to build block dependency trees.\",\n  )\n  .readonly();\nexport type PlRef = z.infer<typeof PlRef>;\n/** @deprecated use {@link PlRef} */\nexport type Ref = PlRef;\n\n/**\n * Type guard to check if a value is a PlRef.\n *\n * @param value - The value to check.\n * @returns True if the value is a PlRef, false otherwise.\n */\nexport function isPlRef(value: unknown): value is PlRef {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"__isRef\" in value &&\n    (value as { __isRef: unknown }).__isRef === true &&\n    \"blockId\" in value &&\n    \"name\" in value\n  );\n}\n\n/** Standard way how to communicate possible connections given specific\n * requirements for incoming data. */\nexport type Option = {\n  /** Fully rendered reference to be assigned for the intended field in block's\n   * args */\n  readonly ref: PlRef;\n\n  /** Label to be present for the user in i.e. drop-down list */\n  readonly label: string;\n};\n\n/**\n * Creates a PlRef with the given blockId and name.\n *\n * @param blockId - The blockId of the reference.\n * @param name - The name of the reference.\n * @param requireEnrichments - Whether the reference requires enrichments.\n */\nexport function createPlRef(\n  blockId: string,\n  name: string,\n  requireEnrichments: boolean = false,\n): PlRef {\n  if (requireEnrichments)\n    return {\n      __isRef: true,\n      blockId,\n      name,\n      requireEnrichments: true,\n    };\n  else\n    return {\n      __isRef: true,\n      blockId,\n      name,\n    };\n}\n\n/**\n * Creates a new PlRef based on an existing one, explicitly setting (default) or removing the\n * requireEnrichments property.\n *\n * @param ref - The original PlRef object.\n * @param requireEnrichments - If true, the `requireEnrichments: true` property is added\n *   to the returned PlRef. If false, the `requireEnrichments` property is removed. Defaults to true.\n * @returns A new PlRef object with the `requireEnrichments` property set or removed accordingly.\n */\nexport function withEnrichments(ref: PlRef, requireEnrichments: boolean = true): PlRef {\n  if (requireEnrichments)\n    return {\n      ...ref,\n      requireEnrichments: true,\n    };\n  else {\n    const { requireEnrichments: _, ...rest } = ref;\n    return rest;\n  }\n}\n\n/** Primary dataset reference with an optional filter. */\nexport type PrimaryRef = {\n  readonly __isPrimaryRef: \"v1\";\n  readonly column: PlRef;\n  readonly filter?: PlRef;\n};\n\nexport function isPrimaryRef(value: unknown): value is PrimaryRef {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as { __isPrimaryRef?: unknown }).__isPrimaryRef === \"v1\" &&\n    \"column\" in value\n  );\n}\n\nexport function createPrimaryRef(column: PlRef, filter?: PlRef): PrimaryRef {\n  if (filter !== undefined) return { __isPrimaryRef: \"v1\", column, filter };\n  else return { __isPrimaryRef: \"v1\", column };\n}\n\n/** Block args accept either form — backward compatible. */\nexport type DatasetInput = PlRef | PrimaryRef;\n\n/** Dataset option with optional filter choices. */\nexport type DatasetOption = Option & {\n  readonly filters?: readonly Option[];\n};\n\n/** Compare two PlRefs and returns true if they are qual */\nexport function plRefsEqual(ref1: PlRef, ref2: PlRef, ignoreEnrichments: boolean = false) {\n  return (\n    ref1.blockId === ref2.blockId &&\n    ref1.name === ref2.name &&\n    (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments)\n  );\n}\n"],"mappings":";;AAEA,MAAa,QAAQ,EAClB,OAAO;CACN,SAAS,EACN,QAAQ,KAAK,CACb,SAAS,8DAA8D;CAC1E,SAAS,EAAE,QAAQ,CAAC,SAAS,oBAAoB;CACjD,MAAM,EAAE,QAAQ,CAAC,SAAS,qEAAqE;CAC/F,oBAAoB,EACjB,QAAQ,KAAK,CACb,UAAU,CACV,SACC,kLAED;CACJ,CAAC,CACD,SACC,sMAGD,CACA,UAAU;;;;;;;AAWb,SAAgB,QAAQ,OAAgC;AACtD,QACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACZ,MAA+B,YAAY,QAC5C,aAAa,SACb,UAAU;;;;;;;;;AAsBd,SAAgB,YACd,SACA,MACA,qBAA8B,OACvB;AACP,KAAI,mBACF,QAAO;EACL,SAAS;EACT;EACA;EACA,oBAAoB;EACrB;KAED,QAAO;EACL,SAAS;EACT;EACA;EACD;;;;;;;;;;;AAYL,SAAgB,gBAAgB,KAAY,qBAA8B,MAAa;AACrF,KAAI,mBACF,QAAO;EACL,GAAG;EACH,oBAAoB;EACrB;MACE;EACH,MAAM,EAAE,oBAAoB,GAAG,GAAG,SAAS;AAC3C,SAAO;;;AAWX,SAAgB,aAAa,OAAqC;AAChE,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAuC,mBAAmB,QAC3D,YAAY;;AAIhB,SAAgB,iBAAiB,QAAe,QAA4B;AAC1E,KAAI,WAAW,KAAA,EAAW,QAAO;EAAE,gBAAgB;EAAM;EAAQ;EAAQ;KACpE,QAAO;EAAE,gBAAgB;EAAM;EAAQ;;;AAY9C,SAAgB,YAAY,MAAa,MAAa,oBAA6B,OAAO;AACxF,QACE,KAAK,YAAY,KAAK,WACtB,KAAK,SAAS,KAAK,SAClB,qBAAqB,KAAK,uBAAuB,KAAK"}
+{"version":3,"file":"ref.js","names":[],"sources":["../src/ref.ts"],"sourcesContent":["import { z } from \"zod\";\nimport type { AxisQualification } from \"./drivers/pframe/spec/selectors\";\nimport type { PObjectId } from \"./pool/spec\";\n\nexport const PlRef = z\n  .object({\n    __isRef: z\n      .literal(true)\n      .describe(\"Crucial marker for the block dependency tree reconstruction\"),\n    blockId: z.string().describe(\"Upstream block id\"),\n    name: z.string().describe(\"Name of the output provided to the upstream block's output context\"),\n    requireEnrichments: z\n      .literal(true)\n      .optional()\n      .describe(\n        \"True if current block that stores this reference in its args, may need enrichments \" +\n          \"for the references value originating from the blocks in between current and referenced block\",\n      ),\n  })\n  .describe(\n    \"Universal reference type, allowing to set block connections. It is crucial that \" +\n      \"{@link __isRef} is present and equal to true, internal logic relies on this marker \" +\n      \"to build block dependency trees.\",\n  )\n  .readonly();\nexport type PlRef = z.infer<typeof PlRef>;\n/** @deprecated use {@link PlRef} */\nexport type Ref = PlRef;\n\n/**\n * Type guard to check if a value is a PlRef.\n *\n * @param value - The value to check.\n * @returns True if the value is a PlRef, false otherwise.\n */\nexport function isPlRef(value: unknown): value is PlRef {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"__isRef\" in value &&\n    (value as { __isRef: unknown }).__isRef === true &&\n    \"blockId\" in value &&\n    \"name\" in value\n  );\n}\n\n/** Standard way how to communicate possible connections given specific\n * requirements for incoming data. */\nexport type Option = {\n  /** Fully rendered reference to be assigned for the intended field in block's\n   * args */\n  readonly ref: PlRef;\n\n  /** Label to be present for the user in i.e. drop-down list */\n  readonly label: string;\n};\n\n/**\n * Creates a PlRef with the given blockId and name.\n *\n * @param blockId - The blockId of the reference.\n * @param name - The name of the reference.\n * @param requireEnrichments - Whether the reference requires enrichments.\n */\nexport function createPlRef(\n  blockId: string,\n  name: string,\n  requireEnrichments: boolean = false,\n): PlRef {\n  if (requireEnrichments)\n    return {\n      __isRef: true,\n      blockId,\n      name,\n      requireEnrichments: true,\n    };\n  else\n    return {\n      __isRef: true,\n      blockId,\n      name,\n    };\n}\n\n/**\n * Creates a new PlRef based on an existing one, explicitly setting (default) or removing the\n * requireEnrichments property.\n *\n * @param ref - The original PlRef object.\n * @param requireEnrichments - If true, the `requireEnrichments: true` property is added\n *   to the returned PlRef. If false, the `requireEnrichments` property is removed. Defaults to true.\n * @returns A new PlRef object with the `requireEnrichments` property set or removed accordingly.\n */\nexport function withEnrichments(ref: PlRef, requireEnrichments: boolean = true): PlRef {\n  if (requireEnrichments)\n    return {\n      ...ref,\n      requireEnrichments: true,\n    };\n  else {\n    const { requireEnrichments: _, ...rest } = ref;\n    return rest;\n  }\n}\n\n/** Primary dataset reference with an optional filter. */\nexport type PrimaryRef = {\n  readonly __isPrimaryRef: \"v1\";\n  readonly column: PlRef;\n  readonly filter?: PlRef;\n};\n\nexport function isPrimaryRef(value: unknown): value is PrimaryRef {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as { __isPrimaryRef?: unknown }).__isPrimaryRef === \"v1\" &&\n    \"column\" in value\n  );\n}\n\nexport function createPrimaryRef(column: PlRef, filter?: PlRef): PrimaryRef {\n  if (filter !== undefined) return { __isPrimaryRef: \"v1\", column, filter };\n  else return { __isPrimaryRef: \"v1\", column };\n}\n\n/** Block args accept either form — backward compatible. */\nexport type DatasetInput = PlRef | PrimaryRef;\n\n/** Many-to-one linker hop. */\nexport type EnrichmentLinkerStep = {\n  readonly type: \"linker\";\n  readonly linker: PObjectId;\n};\n\n/** Step from primary to hit. `path[0]` applied first. */\nexport type EnrichmentStep = EnrichmentLinkerStep;\n\n/**\n * Enrichment column reached via {@link path} linker hops; omitted means zero-hop.\n * `hit` and `path[].linker` are global-form {@link PObjectId}s\n * (`canonicalize({ __isRef: true, blockId, name })`) which the workflow decodes\n * to a PlRef before resolving. For a prerun-sourced hop, supply a resolved\n * `{spec, data}` map in place of the id — `tableBuilder` accepts both.\n */\nexport type EnrichmentRef = {\n  readonly __isEnrichment: \"v1\";\n  readonly hit: PObjectId;\n  readonly path?: readonly EnrichmentStep[];\n  readonly qualifications?: readonly AxisQualification[];\n};\n\nexport function isEnrichmentRef(value: unknown): value is EnrichmentRef {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as { __isEnrichment?: unknown }).__isEnrichment === \"v1\" &&\n    \"hit\" in value\n  );\n}\n\nexport type CreateEnrichmentRefOptions = {\n  readonly path?: readonly EnrichmentStep[];\n  readonly qualifications?: readonly AxisQualification[];\n};\n\nexport function createEnrichmentRef(\n  hit: PObjectId,\n  options: CreateEnrichmentRefOptions = {},\n): EnrichmentRef {\n  const { path, qualifications } = options;\n  return {\n    __isEnrichment: \"v1\",\n    hit,\n    ...(path !== undefined && path.length > 0 ? { path } : {}),\n    ...(qualifications !== undefined && qualifications.length > 0 ? { qualifications } : {}),\n  };\n}\n\n/** {@link EnrichmentRef} plus the export header label. */\nexport type LabeledEnrichmentRef = {\n  readonly ref: EnrichmentRef;\n  readonly label: string;\n};\n\n/** Auto-attached enrichment payload; not user-picked. */\nexport type LabeledEnrichmentRefs = readonly LabeledEnrichmentRef[];\n\n/** Compare two PlRefs and returns true if they are qual */\nexport function plRefsEqual(ref1: PlRef, ref2: PlRef, ignoreEnrichments: boolean = false) {\n  return (\n    ref1.blockId === ref2.blockId &&\n    ref1.name === ref2.name &&\n    (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments)\n  );\n}\n"],"mappings":";;AAIA,MAAa,QAAQ,EAClB,OAAO;CACN,SAAS,EACN,QAAQ,KAAK,CACb,SAAS,8DAA8D;CAC1E,SAAS,EAAE,QAAQ,CAAC,SAAS,oBAAoB;CACjD,MAAM,EAAE,QAAQ,CAAC,SAAS,qEAAqE;CAC/F,oBAAoB,EACjB,QAAQ,KAAK,CACb,UAAU,CACV,SACC,kLAED;CACJ,CAAC,CACD,SACC,sMAGD,CACA,UAAU;;;;;;;AAWb,SAAgB,QAAQ,OAAgC;AACtD,QACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACZ,MAA+B,YAAY,QAC5C,aAAa,SACb,UAAU;;;;;;;;;AAsBd,SAAgB,YACd,SACA,MACA,qBAA8B,OACvB;AACP,KAAI,mBACF,QAAO;EACL,SAAS;EACT;EACA;EACA,oBAAoB;EACrB;KAED,QAAO;EACL,SAAS;EACT;EACA;EACD;;;;;;;;;;;AAYL,SAAgB,gBAAgB,KAAY,qBAA8B,MAAa;AACrF,KAAI,mBACF,QAAO;EACL,GAAG;EACH,oBAAoB;EACrB;MACE;EACH,MAAM,EAAE,oBAAoB,GAAG,GAAG,SAAS;AAC3C,SAAO;;;AAWX,SAAgB,aAAa,OAAqC;AAChE,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAuC,mBAAmB,QAC3D,YAAY;;AAIhB,SAAgB,iBAAiB,QAAe,QAA4B;AAC1E,KAAI,WAAW,KAAA,EAAW,QAAO;EAAE,gBAAgB;EAAM;EAAQ;EAAQ;KACpE,QAAO;EAAE,gBAAgB;EAAM;EAAQ;;AA6B9C,SAAgB,gBAAgB,OAAwC;AACtE,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAuC,mBAAmB,QAC3D,SAAS;;AASb,SAAgB,oBACd,KACA,UAAsC,EAAE,EACzB;CACf,MAAM,EAAE,MAAM,mBAAmB;AACjC,QAAO;EACL,gBAAgB;EAChB;EACA,GAAI,SAAS,KAAA,KAAa,KAAK,SAAS,IAAI,EAAE,MAAM,GAAG,EAAE;EACzD,GAAI,mBAAmB,KAAA,KAAa,eAAe,SAAS,IAAI,EAAE,gBAAgB,GAAG,EAAE;EACxF;;;AAaH,SAAgB,YAAY,MAAa,MAAa,oBAA6B,OAAO;AACxF,QACE,KAAK,YAAY,KAAK,WACtB,KAAK,SAAS,KAAK,SAClB,qBAAqB,KAAK,uBAAuB,KAAK"}

package/package.json

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

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

@@ -1,6 +1,6 @@
 import { Branded, throwError } from "@milaboratories/helpers";
 import { PObjectId } from "../../../pool";
-import { AxisQualification } from "../spec_driver";
+import { AxisQualification } from "./selectors";
 import { canonicalizeJson } from "../../../json";
 
 export type DiscoveredPColumn = {
@@ -15,7 +15,6 @@ export type DiscoveredPColumnId = Branded<PObjectId, "DiscoveredPColumnId">; //
 type PathItem = {
   type: "linker";
   column: PObjectId;
-  qualifications: AxisQualification[];
 };
 
 export function isDiscoveredPColumn(obj: unknown): obj is DiscoveredPColumn {

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

@@ -1,4 +1,10 @@
 import { isPColumnSpec, type PObjectSpec } from "../../../pool";
+import type {
+  MatcherMap,
+  MultiAxisSelector,
+  MultiColumnSelector,
+  StringMatcher,
+} from "../spec_driver";
 import type { AxisId, AxisValueType, Domain, PColumnSpec, ValueType } from "./spec";
 import { getAxisId } from "./spec";
 
@@ -62,6 +68,14 @@ export interface SingleAxisSelector {
   parentAxes?: SingleAxisSelector[];
 }
 
+/** Qualification applied to a single axis to make it compatible during integration. */
+export interface AxisQualification {
+  /** Axis selector identifying which axis is qualified. */
+  readonly axis: SingleAxisSelector;
+  /** Additional context domain entries applied to the axis. */
+  readonly contextDomain: Record<string, string>;
+}
+
 /**
  * Reference to an axis by its numerical index within the anchor column's axes array
  * Format: [anchorId, axisIndex]
@@ -312,3 +326,74 @@ export function legacyColumnSelectorsToPredicate(
       predicateOrSelectors.some((selector) => isPColumnSpec(spec) && matchPColumn(spec, selector));
   else return (spec) => isPColumnSpec(spec) && matchPColumn(spec, predicateOrSelectors);
 }
+
+function matchString(matcher: StringMatcher, value: string): boolean {
+  return matcher.type === "exact" ? value === matcher.value : new RegExp(matcher.value).test(value);
+}
+
+function matchMatcherMap(map: MatcherMap, target: Record<string, string> | undefined): boolean {
+  const t = target ?? {};
+  for (const [key, matchers] of Object.entries(map)) {
+    const v = t[key];
+    if (v === undefined) return false;
+    if (!matchers.some((m) => matchString(m, v))) return false;
+  }
+  return true;
+}
+
+function matchMultiAxis(selector: MultiAxisSelector, axis: AxisId): boolean {
+  if (selector.type !== undefined && !selector.type.includes(axis.type)) return false;
+  if (selector.name !== undefined && !selector.name.some((m) => matchString(m, axis.name)))
+    return false;
+  if (selector.domain !== undefined && !matchMatcherMap(selector.domain, axis.domain)) return false;
+  if (
+    selector.contextDomain !== undefined &&
+    !matchMatcherMap(selector.contextDomain, axis.contextDomain)
+  )
+    return false;
+  return true;
+}
+
+/** Match a {@link PColumnSpec} against a {@link MultiColumnSelector}. */
+export function matchMultiColumnSelector(
+  spec: PColumnSpec,
+  selector: MultiColumnSelector,
+): boolean {
+  if (selector.type !== undefined && !selector.type.includes(spec.valueType)) return false;
+  if (selector.name !== undefined && !selector.name.some((m) => matchString(m, spec.name)))
+    return false;
+  if (selector.domain !== undefined && !matchMatcherMap(selector.domain, spec.domain)) return false;
+  if (
+    selector.contextDomain !== undefined &&
+    !matchMatcherMap(selector.contextDomain, spec.contextDomain)
+  )
+    return false;
+  if (
+    selector.annotations !== undefined &&
+    !matchMatcherMap(selector.annotations, spec.annotations)
+  )
+    return false;
+  if (selector.axes !== undefined) {
+    const columnAxes = spec.axesSpec.map(getAxisId);
+    if (selector.partialAxesMatch ?? true) {
+      for (const axisSelector of selector.axes)
+        if (!columnAxes.some((axis) => matchMultiAxis(axisSelector, axis))) return false;
+    } else {
+      if (columnAxes.length !== selector.axes.length) return false;
+      for (let i = 0; i < selector.axes.length; i++)
+        if (!matchMultiAxis(selector.axes[i], columnAxes[i])) return false;
+    }
+  }
+  return true;
+}
+
+/**
+ * Convert a {@link MultiColumnSelector} (or array; selectors OR-ed) to a predicate.
+ * Non-PColumn specs always return false.
+ */
+export function multiColumnSelectorsToPredicate(
+  selectors: MultiColumnSelector | MultiColumnSelector[],
+): (spec: PObjectSpec) => boolean {
+  const arr = Array.isArray(selectors) ? selectors : [selectors];
+  return (spec) => isPColumnSpec(spec) && arr.some((sel) => matchMultiColumnSelector(spec, sel));
+}

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

@@ -122,6 +122,7 @@ export const Annotation = {
   AxisNature: "pl7.app/axisNature",
   Alphabet: "pl7.app/alphabet",
   Description: "pl7.app/description",
+  DataStatus: "pl7.app/dataStatus",
   DiscreteValues: "pl7.app/discreteValues",
   Format: "pl7.app/format",
   Graph: {
@@ -173,11 +174,14 @@ export const Annotation = {
   },
 } as const;
 
+export type AnnotationDataStatus = "computing" | "ready" | "error" | "absent";
+
 export type Annotation = Metadata &
   Partial<{
     [Annotation.Alphabet]: "nucleotide" | "aminoacid" | (string & {});
     [Annotation.AxisNature]: "homogeneous" | "heterogeneous" | "scaleCompatible" | (string & {});
     [Annotation.Description]: string;
+    [Annotation.DataStatus]: AnnotationDataStatus;
     [Annotation.DiscreteValues]: StringifiedJson<number[]> | StringifiedJson<string[]>;
     [Annotation.Format]: string;
     [Annotation.Graph.Axis.HighCardinality]: StringifiedJson<boolean>;

package/src/drivers/pframe/spec_driver.ts

@@ -9,6 +9,7 @@ import type {
   PColumnInfo,
   PColumnSpec,
   SingleAxisSelector,
+  AxisQualification,
   AxisValueType,
   ColumnValueType,
 } from "./spec";
@@ -62,14 +63,6 @@ export interface MultiColumnSelector {
   readonly partialAxesMatch?: boolean;
 }
 
-/** Qualification applied to a single axis to make it compatible during integration. */
-export interface AxisQualification {
-  /** Axis selector identifying which axis is qualified. */
-  readonly axis: SingleAxisSelector;
-  /** Additional context domain entries applied to the axis. */
-  readonly contextDomain: Record<string, string>;
-}
-
 /** Qualifications needed for both query (already-integrated) columns and the hit column. */
 export interface ColumnAxesWithQualifications {
   /** Already integrated (query) columns with their qualifications. */
@@ -109,8 +102,6 @@ export interface DiscoverColumnsLinkerStep {
   type: "linker";
   /** The linker column traversed in this step */
   linker: PColumnIdAndSpec;
-  /** Axis qualifications produced when matching the linker's many-side axes */
-  qualifications: AxisQualification[];
 }
 
 /**