@platforma-sdk/model 1.79.15 → 1.79.20

package/dist/pframe_utils/axes.js.map

@@ -1 +1 @@
-{"version":3,"file":"axes.js","names":[],"sources":["../../src/pframe_utils/axes.ts"],"sourcesContent":["/**\n * Axes utilities for PFrame graph operations.\n *\n * Extracted from PFrameForGraphs to break circular dependency\n * between PFrameForGraphs and columns modules.\n *\n * @module pframe_utils/axes\n */\n\nimport type {\n  AxisId,\n  AxisSpecNormalized,\n  CanonicalizedJson,\n  PColumn,\n  PObjectId,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  Annotation,\n  canonicalizeJson,\n  getAxisId,\n  getColumnIdAndSpec,\n  LinkerMap,\n  matchAxisId,\n  readAnnotation,\n  stringifyJson,\n} from \"@milaboratories/pl-model-common\";\nimport type { PColumnDataUniversal } from \"../render\";\n\nexport type AxesVault = Map<CanonicalizedJson<AxisId>, AxisSpecNormalized>;\n\n/** Create id for column copy with added keys in axes domains */\nconst colId = (\n  id: PObjectId,\n  domains: (Record<string, string> | undefined)[],\n  contextDomains: (Record<string, string> | undefined)[],\n) => {\n  let wid = id.toString();\n  domains?.forEach((domain) => {\n    if (domain) {\n      for (const [k, v] of Object.entries(domain)) {\n        wid += k;\n        wid += v;\n      }\n    }\n  });\n  contextDomains?.forEach((contextDomain) => {\n    if (contextDomain) {\n      for (const [k, v] of Object.entries(contextDomain)) {\n        wid += k;\n        wid += v;\n      }\n    }\n  });\n  return wid;\n};\n\n/** All combinations with 1 key from each list */\nfunction getKeysCombinations(idsLists: AxisId[][]) {\n  if (!idsLists.length) {\n    return [];\n  }\n  let result: AxisId[][] = [[]];\n  idsLists.forEach((list) => {\n    const nextResult: AxisId[][] = [];\n    list.forEach((key) => {\n      nextResult.push(...result.map((resultItem) => [...resultItem, key]));\n    });\n    result = nextResult;\n  });\n  return result;\n}\n\nexport function getAvailableWithLinkersAxes(\n  linkerColumns: PColumn<PColumnDataUniversal>[],\n  blockAxes: AxesVault,\n): AxesVault {\n  const linkerMap = LinkerMap.fromColumns(linkerColumns.map(getColumnIdAndSpec));\n  const availableAxes = linkerMap.getReachableByLinkersAxesFromAxesNormalized(\n    [...blockAxes.values()],\n    (linkerKeyId, sourceAxisId) => matchAxisId(sourceAxisId, linkerKeyId),\n  );\n\n  return new Map(\n    availableAxes.map((axisSpec) => {\n      const id = getAxisId(axisSpec);\n      return [canonicalizeJson(id), axisSpec];\n    }),\n  );\n}\n\n/** Add columns with fully compatible axes created from partial compatible ones */\nexport function enrichCompatible<T extends Omit<PColumn<PColumnDataUniversal>, \"data\">>(\n  blockAxes: AxesVault,\n  columns: T[],\n): T[] {\n  return columns.flatMap((column) => getAdditionalColumnsForColumn(blockAxes, column));\n}\n\nfunction getAdditionalColumnsForColumn<T extends Omit<PColumn<PColumnDataUniversal>, \"data\">>(\n  blockAxes: AxesVault,\n  column: T,\n): T[] {\n  const columnAxesIds = column.spec.axesSpec.map(getAxisId);\n\n  if (columnAxesIds.every((id) => blockAxes.has(canonicalizeJson(id)))) {\n    return [column]; // the column is compatible with its own domains without modifications\n  }\n\n  // options with different possible domains for every axis of secondary column\n  const secondaryIdsOptions = columnAxesIds.map((id) => {\n    const result = [];\n    for (const [_, mainId] of blockAxes) {\n      if (matchAxisId(mainId, id) && !matchAxisId(id, mainId)) {\n        result.push(mainId);\n      }\n    }\n    return result;\n  });\n  // all possible combinations of axes with added domains\n  const secondaryIdsVariants = getKeysCombinations(secondaryIdsOptions);\n\n  // sets of added to column domain fields\n  const allAddedDomainValues = new Set<string>();\n  const addedNotToAllVariantsDomainValues = new Set<string>();\n  const addedByVariantsDomainValues = secondaryIdsVariants.map((idsList) => {\n    const addedSet = new Set<string>();\n    idsList.map((axisId, idx) => {\n      const d1 = column.spec.axesSpec[idx].domain;\n      const d2 = axisId.domain;\n      Object.entries(d2 ?? {}).forEach(([key, value]) => {\n        if (d1?.[key] === undefined) {\n          const item = JSON.stringify([key, value]);\n          addedSet.add(item);\n          allAddedDomainValues.add(item);\n        }\n      });\n      const cd1 = column.spec.axesSpec[idx].contextDomain;\n      const cd2 = axisId.contextDomain;\n      Object.entries(cd2 ?? {}).forEach(([key, value]) => {\n        if (cd1?.[key] === undefined) {\n          const item = JSON.stringify([\"ctx:\" + key, value]);\n          addedSet.add(item);\n          allAddedDomainValues.add(item);\n        }\n      });\n      return {\n        ...axisId,\n        annotations: column.spec.axesSpec[idx].annotations,\n      };\n    });\n    return addedSet;\n  });\n  [...allAddedDomainValues].forEach((addedPart) => {\n    if (addedByVariantsDomainValues.some((s) => !s.has(addedPart))) {\n      addedNotToAllVariantsDomainValues.add(addedPart);\n    }\n  });\n\n  const additionalColumns = secondaryIdsVariants.map((idsList, idx) => {\n    const id = colId(\n      column.id,\n      idsList.map((id) => id.domain),\n      idsList.map((id) => id.contextDomain),\n    );\n\n    const label = readAnnotation(column.spec, Annotation.Label) ?? \"\";\n    const labelDomainPart = [...addedByVariantsDomainValues[idx]]\n      .filter((str) => addedNotToAllVariantsDomainValues.has(str))\n      .sort()\n      .map((v) => JSON.parse(v)?.[1]) // use in labels only domain values, but sort them by key to save the same order in all column variants\n      .join(\" / \");\n\n    const annotations: Annotation = {\n      ...column.spec.annotations,\n      [Annotation.Graph.IsVirtual]: stringifyJson(true),\n    };\n    if (label || labelDomainPart) {\n      annotations[Annotation.Label] =\n        label && labelDomainPart ? label + \" / \" + labelDomainPart : label + labelDomainPart;\n    }\n\n    return {\n      ...column,\n      id: id as PObjectId,\n      spec: {\n        ...column.spec,\n        axesSpec: idsList.map((axisId, idx) => ({\n          ...axisId,\n          annotations: column.spec.axesSpec[idx].annotations,\n        })),\n        annotations,\n      },\n    };\n  });\n\n  return [column, ...additionalColumns];\n}\n"],"mappings":"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"}
+{"version":3,"file":"axes.js","names":[],"sources":["../../src/pframe_utils/axes.ts"],"sourcesContent":["/**\n * Axes utilities for PFrame graph operations.\n *\n * Extracted from PFrameForGraphs to break circular dependency\n * between PFrameForGraphs and columns modules.\n *\n * @module pframe_utils/axes\n */\n\nimport type {\n  AxisId,\n  AxisSpecNormalized,\n  CanonicalizedJson,\n  PColumn,\n  PObjectId,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  Annotation,\n  canonicalizeJson,\n  getAxisId,\n  getColumnIdAndSpec,\n  LinkerMap,\n  matchAxisId,\n  readAnnotation,\n  stringifyJson,\n} from \"@milaboratories/pl-model-common\";\nimport type { PColumnDataUniversal } from \"../render\";\n\nexport type AxesVault = Map<CanonicalizedJson<AxisId>, AxisSpecNormalized>;\n\n/** Create id for column copy with added keys in axes domains */\nconst colId = (\n  id: PObjectId,\n  domains: (Record<string, string> | undefined)[],\n  contextDomains: (Record<string, string> | undefined)[],\n) => {\n  let wid = id.toString();\n  domains?.forEach((domain) => {\n    if (domain) {\n      for (const [k, v] of Object.entries(domain)) {\n        wid += k;\n        wid += v;\n      }\n    }\n  });\n  contextDomains?.forEach((contextDomain) => {\n    if (contextDomain) {\n      for (const [k, v] of Object.entries(contextDomain)) {\n        wid += k;\n        wid += v;\n      }\n    }\n  });\n  return wid;\n};\n\n/** All combinations with 1 key from each list */\nfunction getKeysCombinations(idsLists: AxisId[][]) {\n  if (!idsLists.length) {\n    return [];\n  }\n  let result: AxisId[][] = [[]];\n  idsLists.forEach((list) => {\n    const nextResult: AxisId[][] = [];\n    list.forEach((key) => {\n      nextResult.push(...result.map((resultItem) => [...resultItem, key]));\n    });\n    result = nextResult;\n  });\n  return result;\n}\n\nexport function getAvailableWithLinkersAxes(\n  linkerColumns: PColumn<PColumnDataUniversal>[],\n  blockAxes: AxesVault,\n): AxesVault {\n  const linkerMap = LinkerMap.fromColumns(linkerColumns.map(getColumnIdAndSpec));\n  const availableAxes = linkerMap.getReachableByLinkersAxesFromAxesNormalized(\n    [...blockAxes.values()],\n    (linkerKeyId, sourceAxisId) => matchAxisId(sourceAxisId, linkerKeyId),\n  );\n\n  return new Map(\n    availableAxes.map((axisSpec) => {\n      const id = getAxisId(axisSpec);\n      return [canonicalizeJson(id), axisSpec];\n    }),\n  );\n}\n\n/** Add columns with fully compatible axes created from partial compatible ones */\nexport function enrichCompatible<T extends Omit<PColumn<PColumnDataUniversal>, \"data\">>(\n  blockAxes: AxesVault,\n  columns: T[],\n): T[] {\n  return columns.flatMap((column) => getAdditionalColumnsForColumn(blockAxes, column));\n}\n\nfunction getAdditionalColumnsForColumn<T extends Omit<PColumn<PColumnDataUniversal>, \"data\">>(\n  blockAxes: AxesVault,\n  column: T,\n): T[] {\n  const columnAxesIds = column.spec.axesSpec.map(getAxisId);\n\n  if (columnAxesIds.every((id) => blockAxes.has(canonicalizeJson(id)))) {\n    return [column]; // the column is compatible with its own domains without modifications\n  }\n\n  // options with different possible domains for every axis of secondary column\n  const secondaryIdsOptions = columnAxesIds.map((id) => {\n    const result = [];\n    for (const [_, mainId] of blockAxes) {\n      if (matchAxisId(mainId, id) && !matchAxisId(id, mainId)) {\n        result.push(mainId);\n      }\n    }\n    return result;\n  });\n  // all possible combinations of axes with added domains\n  const secondaryIdsVariants = getKeysCombinations(secondaryIdsOptions);\n\n  // sets of added to column domain fields\n  const allAddedDomainValues = new Set<string>();\n  const addedNotToAllVariantsDomainValues = new Set<string>();\n  const addedByVariantsDomainValues = secondaryIdsVariants.map((idsList) => {\n    const addedSet = new Set<string>();\n    idsList.map((axisId, idx) => {\n      const d1 = column.spec.axesSpec[idx].domain;\n      const d2 = axisId.domain;\n      Object.entries(d2 ?? {}).forEach(([key, value]) => {\n        if (d1?.[key] === undefined) {\n          const item = JSON.stringify([key, value]);\n          addedSet.add(item);\n          allAddedDomainValues.add(item);\n        }\n      });\n      const cd1 = column.spec.axesSpec[idx].contextDomain;\n      const cd2 = axisId.contextDomain;\n      Object.entries(cd2 ?? {}).forEach(([key, value]) => {\n        if (cd1?.[key] === undefined) {\n          const item = JSON.stringify([\"ctx:\" + key, value]);\n          addedSet.add(item);\n          allAddedDomainValues.add(item);\n        }\n      });\n      return {\n        ...axisId,\n        annotations: column.spec.axesSpec[idx].annotations,\n      };\n    });\n    return addedSet;\n  });\n  [...allAddedDomainValues].forEach((addedPart) => {\n    if (addedByVariantsDomainValues.some((s) => !s.has(addedPart))) {\n      addedNotToAllVariantsDomainValues.add(addedPart);\n    }\n  });\n\n  const additionalColumns = secondaryIdsVariants.map((idsList, idx) => {\n    const id = colId(\n      column.id,\n      idsList.map((id) => id.domain),\n      idsList.map((id) => id.contextDomain),\n    );\n\n    const label = readAnnotation(column.spec, Annotation.Label) ?? \"\";\n    const labelDomainPart = [...addedByVariantsDomainValues[idx]]\n      .filter((str) => addedNotToAllVariantsDomainValues.has(str))\n      .sort()\n      .map((v) => JSON.parse(v)?.[1]) // use in labels only domain values, but sort them by key to save the same order in all column variants\n      .join(\" / \");\n\n    const annotations: Annotation = {\n      ...column.spec.annotations,\n      [Annotation.Graph.IsVirtual]: stringifyJson(true),\n    };\n    if (label || labelDomainPart) {\n      annotations[Annotation.Label] =\n        label && labelDomainPart ? label + \" / \" + labelDomainPart : label + labelDomainPart;\n    }\n\n    return {\n      ...column,\n      id: id as PObjectId,\n      spec: {\n        ...column.spec,\n        axesSpec: idsList.map((axisId, idx) => ({\n          ...axisId,\n          annotations: column.spec.axesSpec[idx].annotations,\n        })),\n        annotations,\n      },\n    };\n  });\n\n  return [column, ...additionalColumns];\n}\n"],"mappings":"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"}

package/dist/pframe_utils/columns.cjs

@@ -1,4 +1,3 @@
-require("../_virtual/_rolldown/runtime.cjs");
 const require_column_collection = require("../render/util/column_collection.cjs");
 require("../render/index.cjs");
 const require_axes = require("./axes.cjs");

package/dist/pframe_utils/columns.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"columns.cjs","names":["PColumnCollection","enrichCompatible","getAvailableWithLinkersAxes","ColumnCollectionBuilder","collectCtxColumnSnapshotProviders"],"sources":["../../src/pframe_utils/columns.ts"],"sourcesContent":["import type {\n  PColumn,\n  PColumnSpec,\n  PColumnLazy,\n  PFrameDef,\n  PObjectId,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  getNormalizedAxesList,\n  getAxisId,\n  canonicalizeJson,\n  isLinkerColumn,\n  matchAxisId,\n  isLabelColumn,\n} from \"@milaboratories/pl-model-common\";\nimport type { AxesVault } from \"./axes\";\nimport { enrichCompatible, getAvailableWithLinkersAxes } from \"./axes\";\nimport type { RenderCtxBase, PColumnDataUniversal } from \"../render\";\nimport { PColumnCollection } from \"../render\";\nimport { ColumnCollectionBuilder } from \"../columns\";\nimport { collectCtxColumnSnapshotProviders } from \"../columns/ctx_column_sources\";\n\nexport function getAllRelatedColumns<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  predicate: (spec: PColumnSpec) => boolean,\n): PFrameDef<PColumn<PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>> {\n  // if current block doesn't produce own columns then use all columns from result pool\n  const columns = new PColumnCollection();\n  columns.addColumnProvider(ctx.resultPool);\n  const allColumns =\n    columns.getColumns(predicate, {\n      dontWaitAllData: true,\n      overrideLabelAnnotation: false,\n    }) ?? [];\n\n  const allAxes: AxesVault = new Map(\n    allColumns\n      .flatMap((column) => getNormalizedAxesList(column.spec.axesSpec))\n      .map((axisSpec) => {\n        const axisId = getAxisId(axisSpec);\n        return [canonicalizeJson(axisId), axisSpec];\n      }),\n  );\n\n  // additional columns are duplicates with extra fields in domains for compatibility if there are ones with partial match\n  const extendedColumns = enrichCompatible(allAxes, allColumns);\n\n  return extendedColumns;\n}\n\nexport function getRelatedColumns<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  {\n    columns: rootColumns,\n    predicate,\n  }: {\n    columns: PColumn<PColumnDataUniversal>[];\n    predicate: (spec: PColumnSpec) => boolean;\n  },\n): PFrameDef<PColumn<PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>> {\n  // if current block has its own columns then take from result pool only compatible with them\n  const columns = new PColumnCollection();\n  columns.addColumnProvider(ctx.resultPool);\n  columns.addColumns(rootColumns);\n\n  // all possible axes from block columns\n  const blockAxes: AxesVault = new Map();\n  // axes from block columns and compatible result pool columns\n  const allAxes: AxesVault = new Map();\n  for (const c of rootColumns) {\n    for (const spec of getNormalizedAxesList(c.spec.axesSpec)) {\n      const aid = getAxisId(spec);\n      blockAxes.set(canonicalizeJson(aid), spec);\n      allAxes.set(canonicalizeJson(aid), spec);\n    }\n  }\n\n  // all linker columns always go to pFrame - even it's impossible to use some of them they all are hidden\n  const linkerColumns =\n    columns.getColumns((spec) => predicate(spec) && isLinkerColumn(spec), {\n      dontWaitAllData: true,\n    }) ?? [];\n  const availableWithLinkersAxes = getAvailableWithLinkersAxes(linkerColumns, blockAxes);\n\n  // all possible axes from connected linkers\n  for (const item of availableWithLinkersAxes) {\n    blockAxes.set(...item);\n    allAxes.set(...item);\n  }\n\n  const blockAxesArr = Array.from(blockAxes.values());\n  // all compatible with block columns but without label columns\n  let compatibleWithoutLabels = (\n    columns.getColumns(\n      (spec) =>\n        predicate(spec) &&\n        spec.axesSpec.some((axisSpec) => {\n          const axisId = getAxisId(axisSpec);\n          return blockAxesArr.some((selectorAxisSpec) =>\n            matchAxisId(getAxisId(selectorAxisSpec), axisId),\n          );\n        }),\n      { dontWaitAllData: true, overrideLabelAnnotation: false },\n    ) ?? []\n  ).filter((column) => !isLabelColumn(column.spec));\n\n  // extend axes set for label columns request\n  for (const c of compatibleWithoutLabels) {\n    for (const spec of getNormalizedAxesList(c.spec.axesSpec)) {\n      const aid = getAxisId(spec);\n      allAxes.set(canonicalizeJson(aid), spec);\n    }\n  }\n\n  const allAxesArr = Array.from(allAxes.values());\n  // extend allowed columns - add columns thad doesn't have axes from block, but have all axes in 'allAxes' list (that means all axes from linkers or from 'hanging' of other selected columns)\n  compatibleWithoutLabels = (\n    columns.getColumns(\n      (spec) =>\n        predicate(spec) &&\n        spec.axesSpec.every((axisSpec) => {\n          const axisId = getAxisId(axisSpec);\n          return allAxesArr.some((selectorAxisSpec) =>\n            matchAxisId(getAxisId(selectorAxisSpec), axisId),\n          );\n        }),\n      { dontWaitAllData: true, overrideLabelAnnotation: false },\n    ) ?? []\n  ).filter((column) => !isLabelColumn(column.spec));\n\n  // label columns must be compatible with full set of axes - block axes and axes from compatible columns from result pool\n  const compatibleLabels = (\n    columns.getColumns(\n      (spec) =>\n        predicate(spec) &&\n        spec.axesSpec.some((axisSpec) => {\n          const axisId = getAxisId(axisSpec);\n          return allAxesArr.some((selectorAxisSpec) =>\n            matchAxisId(getAxisId(selectorAxisSpec), axisId),\n          );\n        }),\n      { dontWaitAllData: true, overrideLabelAnnotation: false },\n    ) ?? []\n  ).filter((column) => isLabelColumn(column.spec));\n\n  const compatible = [...compatibleWithoutLabels, ...compatibleLabels];\n\n  // Drop result-pool columns that share an axis with the block but cannot join it.\n  const integrableIds = discoverIntegrableColumnIds(ctx, rootColumns);\n  const rootIds = new Set(rootColumns.map((c) => c.id));\n  const connected = compatible.filter(\n    (c) => rootIds.has(c.id) || isLinkerColumn(c.spec) || (integrableIds?.has(c.id) ?? true),\n  );\n\n  // additional columns are duplicates with extra fields in domains for compatibility if there are ones with partial match\n  const extendedColumns = enrichCompatible(blockAxes, connected);\n\n  return extendedColumns;\n}\n\n/** Column ids that discovery confirms integrate with the block, or `undefined` when it can't decide. */\nfunction discoverIntegrableColumnIds<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  rootColumns: PColumn<PColumnDataUniversal>[],\n): Set<PObjectId> | undefined {\n  const anchorSpecs = Array.from(\n    new Map(rootColumns.map((c) => [canonicalizeJson(c.spec), c.spec])).values(),\n  );\n  if (anchorSpecs.length === 0) return undefined;\n\n  try {\n    const collection = new ColumnCollectionBuilder()\n      .addSources(collectCtxColumnSnapshotProviders(ctx))\n      .build({\n        allowPartialColumnList: true,\n        anchors: Object.fromEntries(anchorSpecs.map((spec, i) => [`anchor_${i}`, spec])),\n      });\n    try {\n      return new Set(collection.findColumns({ mode: \"enrichment\" }).map((m) => m.column.id));\n    } finally {\n      collection.dispose();\n    }\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"columns.cjs","names":["PColumnCollection","enrichCompatible","getAvailableWithLinkersAxes","ColumnCollectionBuilder","collectCtxColumnSnapshotProviders"],"sources":["../../src/pframe_utils/columns.ts"],"sourcesContent":["import type {\n  PColumn,\n  PColumnSpec,\n  PColumnLazy,\n  PFrameDef,\n  PObjectId,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  getNormalizedAxesList,\n  getAxisId,\n  canonicalizeJson,\n  isLinkerColumn,\n  matchAxisId,\n  isLabelColumn,\n} from \"@milaboratories/pl-model-common\";\nimport type { AxesVault } from \"./axes\";\nimport { enrichCompatible, getAvailableWithLinkersAxes } from \"./axes\";\nimport type { RenderCtxBase, PColumnDataUniversal } from \"../render\";\nimport { PColumnCollection } from \"../render\";\nimport { ColumnCollectionBuilder } from \"../columns\";\nimport { collectCtxColumnSnapshotProviders } from \"../columns/ctx_column_sources\";\n\nexport function getAllRelatedColumns<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  predicate: (spec: PColumnSpec) => boolean,\n): PFrameDef<PColumn<PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>> {\n  // if current block doesn't produce own columns then use all columns from result pool\n  const columns = new PColumnCollection();\n  columns.addColumnProvider(ctx.resultPool);\n  const allColumns =\n    columns.getColumns(predicate, {\n      dontWaitAllData: true,\n      overrideLabelAnnotation: false,\n    }) ?? [];\n\n  const allAxes: AxesVault = new Map(\n    allColumns\n      .flatMap((column) => getNormalizedAxesList(column.spec.axesSpec))\n      .map((axisSpec) => {\n        const axisId = getAxisId(axisSpec);\n        return [canonicalizeJson(axisId), axisSpec];\n      }),\n  );\n\n  // additional columns are duplicates with extra fields in domains for compatibility if there are ones with partial match\n  const extendedColumns = enrichCompatible(allAxes, allColumns);\n\n  return extendedColumns;\n}\n\nexport function getRelatedColumns<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  {\n    columns: rootColumns,\n    predicate,\n  }: {\n    columns: PColumn<PColumnDataUniversal>[];\n    predicate: (spec: PColumnSpec) => boolean;\n  },\n): PFrameDef<PColumn<PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>> {\n  // if current block has its own columns then take from result pool only compatible with them\n  const columns = new PColumnCollection();\n  columns.addColumnProvider(ctx.resultPool);\n  columns.addColumns(rootColumns);\n\n  // all possible axes from block columns\n  const blockAxes: AxesVault = new Map();\n  // axes from block columns and compatible result pool columns\n  const allAxes: AxesVault = new Map();\n  for (const c of rootColumns) {\n    for (const spec of getNormalizedAxesList(c.spec.axesSpec)) {\n      const aid = getAxisId(spec);\n      blockAxes.set(canonicalizeJson(aid), spec);\n      allAxes.set(canonicalizeJson(aid), spec);\n    }\n  }\n\n  // all linker columns always go to pFrame - even it's impossible to use some of them they all are hidden\n  const linkerColumns =\n    columns.getColumns((spec) => predicate(spec) && isLinkerColumn(spec), {\n      dontWaitAllData: true,\n    }) ?? [];\n  const availableWithLinkersAxes = getAvailableWithLinkersAxes(linkerColumns, blockAxes);\n\n  // all possible axes from connected linkers\n  for (const item of availableWithLinkersAxes) {\n    blockAxes.set(...item);\n    allAxes.set(...item);\n  }\n\n  const blockAxesArr = Array.from(blockAxes.values());\n  // all compatible with block columns but without label columns\n  let compatibleWithoutLabels = (\n    columns.getColumns(\n      (spec) =>\n        predicate(spec) &&\n        spec.axesSpec.some((axisSpec) => {\n          const axisId = getAxisId(axisSpec);\n          return blockAxesArr.some((selectorAxisSpec) =>\n            matchAxisId(getAxisId(selectorAxisSpec), axisId),\n          );\n        }),\n      { dontWaitAllData: true, overrideLabelAnnotation: false },\n    ) ?? []\n  ).filter((column) => !isLabelColumn(column.spec));\n\n  // extend axes set for label columns request\n  for (const c of compatibleWithoutLabels) {\n    for (const spec of getNormalizedAxesList(c.spec.axesSpec)) {\n      const aid = getAxisId(spec);\n      allAxes.set(canonicalizeJson(aid), spec);\n    }\n  }\n\n  const allAxesArr = Array.from(allAxes.values());\n  // extend allowed columns - add columns thad doesn't have axes from block, but have all axes in 'allAxes' list (that means all axes from linkers or from 'hanging' of other selected columns)\n  compatibleWithoutLabels = (\n    columns.getColumns(\n      (spec) =>\n        predicate(spec) &&\n        spec.axesSpec.every((axisSpec) => {\n          const axisId = getAxisId(axisSpec);\n          return allAxesArr.some((selectorAxisSpec) =>\n            matchAxisId(getAxisId(selectorAxisSpec), axisId),\n          );\n        }),\n      { dontWaitAllData: true, overrideLabelAnnotation: false },\n    ) ?? []\n  ).filter((column) => !isLabelColumn(column.spec));\n\n  // label columns must be compatible with full set of axes - block axes and axes from compatible columns from result pool\n  const compatibleLabels = (\n    columns.getColumns(\n      (spec) =>\n        predicate(spec) &&\n        spec.axesSpec.some((axisSpec) => {\n          const axisId = getAxisId(axisSpec);\n          return allAxesArr.some((selectorAxisSpec) =>\n            matchAxisId(getAxisId(selectorAxisSpec), axisId),\n          );\n        }),\n      { dontWaitAllData: true, overrideLabelAnnotation: false },\n    ) ?? []\n  ).filter((column) => isLabelColumn(column.spec));\n\n  const compatible = [...compatibleWithoutLabels, ...compatibleLabels];\n\n  // Drop result-pool columns that share an axis with the block but cannot join it.\n  const integrableIds = discoverIntegrableColumnIds(ctx, rootColumns);\n  const rootIds = new Set(rootColumns.map((c) => c.id));\n  const connected = compatible.filter(\n    (c) => rootIds.has(c.id) || isLinkerColumn(c.spec) || (integrableIds?.has(c.id) ?? true),\n  );\n\n  // additional columns are duplicates with extra fields in domains for compatibility if there are ones with partial match\n  const extendedColumns = enrichCompatible(blockAxes, connected);\n\n  return extendedColumns;\n}\n\n/** Column ids that discovery confirms integrate with the block, or `undefined` when it can't decide. */\nfunction discoverIntegrableColumnIds<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  rootColumns: PColumn<PColumnDataUniversal>[],\n): Set<PObjectId> | undefined {\n  const anchorSpecs = Array.from(\n    new Map(rootColumns.map((c) => [canonicalizeJson(c.spec), c.spec])).values(),\n  );\n  if (anchorSpecs.length === 0) return undefined;\n\n  try {\n    const collection = new ColumnCollectionBuilder()\n      .addSources(collectCtxColumnSnapshotProviders(ctx))\n      .build({\n        allowPartialColumnList: true,\n        anchors: Object.fromEntries(anchorSpecs.map((spec, i) => [`anchor_${i}`, spec])),\n      });\n    try {\n      return new Set(collection.findColumns({ mode: \"enrichment\" }).map((m) => m.column.id));\n    } finally {\n      collection.dispose();\n    }\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":"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"}

package/dist/pframe_utils/columns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"columns.d.ts","names":[],"sources":["../../src/pframe_utils/columns.ts"],"mappings":";;;;;iBAsBgB,oBAAA,MAAA,CACd,GAAA,EAAK,aAAA,CAAc,CAAA,EAAG,CAAA,GACtB,SAAA,GAAY,IAAA,EAAM,WAAA,eACjB,SAAA,CAAU,OAAA,CAAQ,oBAAA,IAAwB,WAAA,aAAwB,oBAAA;AAAA,iBAyBrD,iBAAA,MAAA,CACd,GAAA,EAAK,aAAA,CAAc,CAAA,EAAG,CAAA;EAEpB,OAAA,EAAS,WAAA;EACT;AAAA;EAEA,OAAA,EAAS,OAAA,CAAQ,oBAAA;EACjB,SAAA,GAAY,IAAA,EAAM,WAAA;AAAA,IAEnB,SAAA,CAAU,OAAA,CAAQ,oBAAA,IAAwB,WAAA,aAAwB,oBAAA"}
+{"version":3,"file":"columns.d.ts","names":[],"sources":["../../src/pframe_utils/columns.ts"],"mappings":";;;;;iBAsBgB,oBAAA,OACd,GAAA,EAAK,aAAA,CAAc,CAAA,EAAG,CAAA,GACtB,SAAA,GAAY,IAAA,EAAM,WAAA,eACjB,SAAA,CAAU,OAAA,CAAQ,oBAAA,IAAwB,WAAA,aAAwB,oBAAA;AAAA,iBAyBrD,iBAAA,OACd,GAAA,EAAK,aAAA,CAAc,CAAA,EAAG,CAAA;EAEpB,OAAA,EAAS,WAAA;EACT;AAAA;EAEA,OAAA,EAAS,OAAA,CAAQ,oBAAA;EACjB,SAAA,GAAY,IAAA,EAAM,WAAA;AAAA,IAEnB,SAAA,CAAU,OAAA,CAAQ,oBAAA,IAAwB,WAAA,aAAwB,oBAAA"}

package/dist/pframe_utils/columns.js.map

@@ -1 +1 @@
-{"version":3,"file":"columns.js","names":[],"sources":["../../src/pframe_utils/columns.ts"],"sourcesContent":["import type {\n  PColumn,\n  PColumnSpec,\n  PColumnLazy,\n  PFrameDef,\n  PObjectId,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  getNormalizedAxesList,\n  getAxisId,\n  canonicalizeJson,\n  isLinkerColumn,\n  matchAxisId,\n  isLabelColumn,\n} from \"@milaboratories/pl-model-common\";\nimport type { AxesVault } from \"./axes\";\nimport { enrichCompatible, getAvailableWithLinkersAxes } from \"./axes\";\nimport type { RenderCtxBase, PColumnDataUniversal } from \"../render\";\nimport { PColumnCollection } from \"../render\";\nimport { ColumnCollectionBuilder } from \"../columns\";\nimport { collectCtxColumnSnapshotProviders } from \"../columns/ctx_column_sources\";\n\nexport function getAllRelatedColumns<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  predicate: (spec: PColumnSpec) => boolean,\n): PFrameDef<PColumn<PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>> {\n  // if current block doesn't produce own columns then use all columns from result pool\n  const columns = new PColumnCollection();\n  columns.addColumnProvider(ctx.resultPool);\n  const allColumns =\n    columns.getColumns(predicate, {\n      dontWaitAllData: true,\n      overrideLabelAnnotation: false,\n    }) ?? [];\n\n  const allAxes: AxesVault = new Map(\n    allColumns\n      .flatMap((column) => getNormalizedAxesList(column.spec.axesSpec))\n      .map((axisSpec) => {\n        const axisId = getAxisId(axisSpec);\n        return [canonicalizeJson(axisId), axisSpec];\n      }),\n  );\n\n  // additional columns are duplicates with extra fields in domains for compatibility if there are ones with partial match\n  const extendedColumns = enrichCompatible(allAxes, allColumns);\n\n  return extendedColumns;\n}\n\nexport function getRelatedColumns<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  {\n    columns: rootColumns,\n    predicate,\n  }: {\n    columns: PColumn<PColumnDataUniversal>[];\n    predicate: (spec: PColumnSpec) => boolean;\n  },\n): PFrameDef<PColumn<PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>> {\n  // if current block has its own columns then take from result pool only compatible with them\n  const columns = new PColumnCollection();\n  columns.addColumnProvider(ctx.resultPool);\n  columns.addColumns(rootColumns);\n\n  // all possible axes from block columns\n  const blockAxes: AxesVault = new Map();\n  // axes from block columns and compatible result pool columns\n  const allAxes: AxesVault = new Map();\n  for (const c of rootColumns) {\n    for (const spec of getNormalizedAxesList(c.spec.axesSpec)) {\n      const aid = getAxisId(spec);\n      blockAxes.set(canonicalizeJson(aid), spec);\n      allAxes.set(canonicalizeJson(aid), spec);\n    }\n  }\n\n  // all linker columns always go to pFrame - even it's impossible to use some of them they all are hidden\n  const linkerColumns =\n    columns.getColumns((spec) => predicate(spec) && isLinkerColumn(spec), {\n      dontWaitAllData: true,\n    }) ?? [];\n  const availableWithLinkersAxes = getAvailableWithLinkersAxes(linkerColumns, blockAxes);\n\n  // all possible axes from connected linkers\n  for (const item of availableWithLinkersAxes) {\n    blockAxes.set(...item);\n    allAxes.set(...item);\n  }\n\n  const blockAxesArr = Array.from(blockAxes.values());\n  // all compatible with block columns but without label columns\n  let compatibleWithoutLabels = (\n    columns.getColumns(\n      (spec) =>\n        predicate(spec) &&\n        spec.axesSpec.some((axisSpec) => {\n          const axisId = getAxisId(axisSpec);\n          return blockAxesArr.some((selectorAxisSpec) =>\n            matchAxisId(getAxisId(selectorAxisSpec), axisId),\n          );\n        }),\n      { dontWaitAllData: true, overrideLabelAnnotation: false },\n    ) ?? []\n  ).filter((column) => !isLabelColumn(column.spec));\n\n  // extend axes set for label columns request\n  for (const c of compatibleWithoutLabels) {\n    for (const spec of getNormalizedAxesList(c.spec.axesSpec)) {\n      const aid = getAxisId(spec);\n      allAxes.set(canonicalizeJson(aid), spec);\n    }\n  }\n\n  const allAxesArr = Array.from(allAxes.values());\n  // extend allowed columns - add columns thad doesn't have axes from block, but have all axes in 'allAxes' list (that means all axes from linkers or from 'hanging' of other selected columns)\n  compatibleWithoutLabels = (\n    columns.getColumns(\n      (spec) =>\n        predicate(spec) &&\n        spec.axesSpec.every((axisSpec) => {\n          const axisId = getAxisId(axisSpec);\n          return allAxesArr.some((selectorAxisSpec) =>\n            matchAxisId(getAxisId(selectorAxisSpec), axisId),\n          );\n        }),\n      { dontWaitAllData: true, overrideLabelAnnotation: false },\n    ) ?? []\n  ).filter((column) => !isLabelColumn(column.spec));\n\n  // label columns must be compatible with full set of axes - block axes and axes from compatible columns from result pool\n  const compatibleLabels = (\n    columns.getColumns(\n      (spec) =>\n        predicate(spec) &&\n        spec.axesSpec.some((axisSpec) => {\n          const axisId = getAxisId(axisSpec);\n          return allAxesArr.some((selectorAxisSpec) =>\n            matchAxisId(getAxisId(selectorAxisSpec), axisId),\n          );\n        }),\n      { dontWaitAllData: true, overrideLabelAnnotation: false },\n    ) ?? []\n  ).filter((column) => isLabelColumn(column.spec));\n\n  const compatible = [...compatibleWithoutLabels, ...compatibleLabels];\n\n  // Drop result-pool columns that share an axis with the block but cannot join it.\n  const integrableIds = discoverIntegrableColumnIds(ctx, rootColumns);\n  const rootIds = new Set(rootColumns.map((c) => c.id));\n  const connected = compatible.filter(\n    (c) => rootIds.has(c.id) || isLinkerColumn(c.spec) || (integrableIds?.has(c.id) ?? true),\n  );\n\n  // additional columns are duplicates with extra fields in domains for compatibility if there are ones with partial match\n  const extendedColumns = enrichCompatible(blockAxes, connected);\n\n  return extendedColumns;\n}\n\n/** Column ids that discovery confirms integrate with the block, or `undefined` when it can't decide. */\nfunction discoverIntegrableColumnIds<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  rootColumns: PColumn<PColumnDataUniversal>[],\n): Set<PObjectId> | undefined {\n  const anchorSpecs = Array.from(\n    new Map(rootColumns.map((c) => [canonicalizeJson(c.spec), c.spec])).values(),\n  );\n  if (anchorSpecs.length === 0) return undefined;\n\n  try {\n    const collection = new ColumnCollectionBuilder()\n      .addSources(collectCtxColumnSnapshotProviders(ctx))\n      .build({\n        allowPartialColumnList: true,\n        anchors: Object.fromEntries(anchorSpecs.map((spec, i) => [`anchor_${i}`, spec])),\n      });\n    try {\n      return new Set(collection.findColumns({ mode: \"enrichment\" }).map((m) => m.column.id));\n    } finally {\n      collection.dispose();\n    }\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"columns.js","names":[],"sources":["../../src/pframe_utils/columns.ts"],"sourcesContent":["import type {\n  PColumn,\n  PColumnSpec,\n  PColumnLazy,\n  PFrameDef,\n  PObjectId,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  getNormalizedAxesList,\n  getAxisId,\n  canonicalizeJson,\n  isLinkerColumn,\n  matchAxisId,\n  isLabelColumn,\n} from \"@milaboratories/pl-model-common\";\nimport type { AxesVault } from \"./axes\";\nimport { enrichCompatible, getAvailableWithLinkersAxes } from \"./axes\";\nimport type { RenderCtxBase, PColumnDataUniversal } from \"../render\";\nimport { PColumnCollection } from \"../render\";\nimport { ColumnCollectionBuilder } from \"../columns\";\nimport { collectCtxColumnSnapshotProviders } from \"../columns/ctx_column_sources\";\n\nexport function getAllRelatedColumns<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  predicate: (spec: PColumnSpec) => boolean,\n): PFrameDef<PColumn<PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>> {\n  // if current block doesn't produce own columns then use all columns from result pool\n  const columns = new PColumnCollection();\n  columns.addColumnProvider(ctx.resultPool);\n  const allColumns =\n    columns.getColumns(predicate, {\n      dontWaitAllData: true,\n      overrideLabelAnnotation: false,\n    }) ?? [];\n\n  const allAxes: AxesVault = new Map(\n    allColumns\n      .flatMap((column) => getNormalizedAxesList(column.spec.axesSpec))\n      .map((axisSpec) => {\n        const axisId = getAxisId(axisSpec);\n        return [canonicalizeJson(axisId), axisSpec];\n      }),\n  );\n\n  // additional columns are duplicates with extra fields in domains for compatibility if there are ones with partial match\n  const extendedColumns = enrichCompatible(allAxes, allColumns);\n\n  return extendedColumns;\n}\n\nexport function getRelatedColumns<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  {\n    columns: rootColumns,\n    predicate,\n  }: {\n    columns: PColumn<PColumnDataUniversal>[];\n    predicate: (spec: PColumnSpec) => boolean;\n  },\n): PFrameDef<PColumn<PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>> {\n  // if current block has its own columns then take from result pool only compatible with them\n  const columns = new PColumnCollection();\n  columns.addColumnProvider(ctx.resultPool);\n  columns.addColumns(rootColumns);\n\n  // all possible axes from block columns\n  const blockAxes: AxesVault = new Map();\n  // axes from block columns and compatible result pool columns\n  const allAxes: AxesVault = new Map();\n  for (const c of rootColumns) {\n    for (const spec of getNormalizedAxesList(c.spec.axesSpec)) {\n      const aid = getAxisId(spec);\n      blockAxes.set(canonicalizeJson(aid), spec);\n      allAxes.set(canonicalizeJson(aid), spec);\n    }\n  }\n\n  // all linker columns always go to pFrame - even it's impossible to use some of them they all are hidden\n  const linkerColumns =\n    columns.getColumns((spec) => predicate(spec) && isLinkerColumn(spec), {\n      dontWaitAllData: true,\n    }) ?? [];\n  const availableWithLinkersAxes = getAvailableWithLinkersAxes(linkerColumns, blockAxes);\n\n  // all possible axes from connected linkers\n  for (const item of availableWithLinkersAxes) {\n    blockAxes.set(...item);\n    allAxes.set(...item);\n  }\n\n  const blockAxesArr = Array.from(blockAxes.values());\n  // all compatible with block columns but without label columns\n  let compatibleWithoutLabels = (\n    columns.getColumns(\n      (spec) =>\n        predicate(spec) &&\n        spec.axesSpec.some((axisSpec) => {\n          const axisId = getAxisId(axisSpec);\n          return blockAxesArr.some((selectorAxisSpec) =>\n            matchAxisId(getAxisId(selectorAxisSpec), axisId),\n          );\n        }),\n      { dontWaitAllData: true, overrideLabelAnnotation: false },\n    ) ?? []\n  ).filter((column) => !isLabelColumn(column.spec));\n\n  // extend axes set for label columns request\n  for (const c of compatibleWithoutLabels) {\n    for (const spec of getNormalizedAxesList(c.spec.axesSpec)) {\n      const aid = getAxisId(spec);\n      allAxes.set(canonicalizeJson(aid), spec);\n    }\n  }\n\n  const allAxesArr = Array.from(allAxes.values());\n  // extend allowed columns - add columns thad doesn't have axes from block, but have all axes in 'allAxes' list (that means all axes from linkers or from 'hanging' of other selected columns)\n  compatibleWithoutLabels = (\n    columns.getColumns(\n      (spec) =>\n        predicate(spec) &&\n        spec.axesSpec.every((axisSpec) => {\n          const axisId = getAxisId(axisSpec);\n          return allAxesArr.some((selectorAxisSpec) =>\n            matchAxisId(getAxisId(selectorAxisSpec), axisId),\n          );\n        }),\n      { dontWaitAllData: true, overrideLabelAnnotation: false },\n    ) ?? []\n  ).filter((column) => !isLabelColumn(column.spec));\n\n  // label columns must be compatible with full set of axes - block axes and axes from compatible columns from result pool\n  const compatibleLabels = (\n    columns.getColumns(\n      (spec) =>\n        predicate(spec) &&\n        spec.axesSpec.some((axisSpec) => {\n          const axisId = getAxisId(axisSpec);\n          return allAxesArr.some((selectorAxisSpec) =>\n            matchAxisId(getAxisId(selectorAxisSpec), axisId),\n          );\n        }),\n      { dontWaitAllData: true, overrideLabelAnnotation: false },\n    ) ?? []\n  ).filter((column) => isLabelColumn(column.spec));\n\n  const compatible = [...compatibleWithoutLabels, ...compatibleLabels];\n\n  // Drop result-pool columns that share an axis with the block but cannot join it.\n  const integrableIds = discoverIntegrableColumnIds(ctx, rootColumns);\n  const rootIds = new Set(rootColumns.map((c) => c.id));\n  const connected = compatible.filter(\n    (c) => rootIds.has(c.id) || isLinkerColumn(c.spec) || (integrableIds?.has(c.id) ?? true),\n  );\n\n  // additional columns are duplicates with extra fields in domains for compatibility if there are ones with partial match\n  const extendedColumns = enrichCompatible(blockAxes, connected);\n\n  return extendedColumns;\n}\n\n/** Column ids that discovery confirms integrate with the block, or `undefined` when it can't decide. */\nfunction discoverIntegrableColumnIds<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  rootColumns: PColumn<PColumnDataUniversal>[],\n): Set<PObjectId> | undefined {\n  const anchorSpecs = Array.from(\n    new Map(rootColumns.map((c) => [canonicalizeJson(c.spec), c.spec])).values(),\n  );\n  if (anchorSpecs.length === 0) return undefined;\n\n  try {\n    const collection = new ColumnCollectionBuilder()\n      .addSources(collectCtxColumnSnapshotProviders(ctx))\n      .build({\n        allowPartialColumnList: true,\n        anchors: Object.fromEntries(anchorSpecs.map((spec, i) => [`anchor_${i}`, spec])),\n      });\n    try {\n      return new Set(collection.findColumns({ mode: \"enrichment\" }).map((m) => m.column.id));\n    } finally {\n      collection.dispose();\n    }\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":"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"}

package/dist/pframe_utils/index.cjs

@@ -1,5 +1,4 @@
-require("../_virtual/_rolldown/runtime.cjs");
-require("./columns.cjs");
+const require_columns = require("./columns.cjs");
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
 let es_toolkit = require("es-toolkit");
 //#region src/pframe_utils/index.ts
@@ -259,11 +258,13 @@ async function getUniqueSourceValuesWithLabels(handle, params) {
 	});
 }
 //#endregion
+exports.getAllRelatedColumns = require_columns.getAllRelatedColumns;
 exports.getAxisUniqueValues = getAxisUniqueValues;
 exports.getColumnOrAxisValueLabelsId = getColumnOrAxisValueLabelsId;
 exports.getColumnSpecById = getColumnSpecById;
 exports.getColumnUniqueValues = getColumnUniqueValues;
 exports.getColumnsFull = getColumnsFull;
+exports.getRelatedColumns = require_columns.getRelatedColumns;
 exports.getRequestColumnsFromSelectedSources = getRequestColumnsFromSelectedSources;
 exports.getSingleColumnData = getSingleColumnData;
 exports.getUniqueSourceValuesWithLabels = getUniqueSourceValuesWithLabels;

package/dist/pframe_utils/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["PColumnName","Annotation"],"sources":["../../src/pframe_utils/index.ts"],"sourcesContent":["import { flatten, uniq } from \"es-toolkit\";\n\nimport type {\n  AxisSpec,\n  CalculateTableDataRequest,\n  PColumnSpec,\n  PFrameHandle,\n  PTableVector,\n  UniqueValuesRequest,\n  AxisId,\n  CanonicalizedJson,\n  FindColumnsRequest,\n  FindColumnsResponse,\n  FullPTableColumnData,\n  PColumnIdAndSpec,\n  PObjectId,\n  PTableRecordSingleValueFilterV2,\n  ValueType,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  pTableValue,\n  Annotation,\n  canonicalizeAxisId,\n  getAxisId,\n  readAnnotation,\n  PColumnName,\n} from \"@milaboratories/pl-model-common\";\n\nexport * from \"./columns\";\n\n// Types\ntype PValue = string | number | null;\n\ntype SuggestionResponse = {\n  values: {\n    value: string;\n    label: string;\n  }[];\n  overflow: boolean;\n};\n\ntype SingleColumnData = {\n  axesData: Record<string, PValue[]>;\n  data: PValue[];\n};\n\ntype UniqueValuesResponse = {\n  values: string[];\n  overflow: boolean;\n};\n\ntype GetUniqueSourceValuesParams = {\n  columnId: PObjectId;\n  axisIdx?: number;\n  limit?: number;\n  searchQuery?: string;\n  searchQueryValue?: string;\n};\n\ntype GetAxisUniqueValuesParams = {\n  axisId: AxisId;\n  parentColumnIds: PObjectId[];\n  limit?: number;\n  filters?: PTableRecordSingleValueFilterV2[];\n};\n\ntype GetColumnsFullParams = {\n  selectedSources: PObjectId[];\n  strictlyCompatible: boolean;\n  types?: ValueType[];\n  names?: string[];\n  annotations?: FindColumnsRequest[\"columnFilter\"][\"annotationValue\"];\n  annotationsNotEmpty?: string[];\n};\n\n// Constants\nconst UNIQUE_VALUES_LIMIT = 1000000;\n\n// Helper functions\nconst sortValuesPredicate = (a: { label: string }, b: { label: string }) =>\n  a.label.localeCompare(b.label, \"en\", { numeric: true });\n\nfunction convertColumnData(type: ValueType, response: PTableVector): PValue[] {\n  if (type === \"String\") {\n    return response.data as PValue[];\n  }\n  const res: PValue[] = new Array(response.data.length);\n  for (let i = 0; i < response.data.length; i++) {\n    res[i] = pTableValue(response, i) as PValue;\n  }\n  return res;\n}\n\nfunction createSearchFilter(\n  columnId: PObjectId,\n  substring: string,\n): PTableRecordSingleValueFilterV2 {\n  return {\n    type: \"bySingleColumnV2\",\n    column: {\n      type: \"column\",\n      id: columnId,\n    },\n    predicate: {\n      operator: \"StringIContains\",\n      substring,\n    },\n  };\n}\n\nfunction createAxisSearchFilter(\n  axisSpec: AxisSpec,\n  substring: string,\n): PTableRecordSingleValueFilterV2 {\n  return {\n    type: \"bySingleColumnV2\",\n    column: {\n      type: \"axis\",\n      id: {\n        type: axisSpec.type,\n        name: axisSpec.name,\n      },\n    },\n    predicate: {\n      operator: \"StringIContains\",\n      substring,\n    },\n  };\n}\n\nfunction mapValuesToSuggestions(values: string[]): { value: string; label: string }[] {\n  return values.map((v) => ({ value: String(v), label: String(v) })).sort(sortValuesPredicate);\n}\n\nfunction getPFrameDriver() {\n  if (typeof platforma === \"undefined\") {\n    throw new Error(\"Platforma instance is not available\");\n  }\n  if (typeof platforma.pFrameDriver === \"undefined\") {\n    throw new Error(\"PFrame driver is not available in the current Platforma instance\");\n  }\n  return platforma.pFrameDriver;\n}\n\n// Core functions\nexport async function getColumnSpecById(\n  handle: PFrameHandle,\n  id: PObjectId,\n): Promise<PColumnSpec | null> {\n  try {\n    const response = await getPFrameDriver().getColumnSpec(handle, id);\n    return response ?? null;\n  } catch (err) {\n    console.error(\"PFrame: get single column error\", err);\n    return null;\n  }\n}\n\nexport async function getSingleColumnData(\n  handle: PFrameHandle,\n  id: PObjectId,\n  filters: PTableRecordSingleValueFilterV2[] = [],\n): Promise<SingleColumnData> {\n  try {\n    const response: FullPTableColumnData[] = await getPFrameDriver().calculateTableData(handle, {\n      src: {\n        type: \"column\",\n        column: id,\n      },\n      filters,\n      sorting: [],\n    } as CalculateTableDataRequest<PObjectId>);\n\n    const axes = response.filter((item) => item.spec.type === \"axis\");\n    const columns = response.filter((item) => item.spec.type === \"column\");\n\n    return {\n      axesData: axes.reduce((res: Record<string, PValue[]>, item) => {\n        const id = getAxisId(item.spec.spec as AxisSpec);\n        res[canonicalizeAxisId(id)] = convertColumnData(id.type, item.data);\n        return res;\n      }, {}),\n      data: columns.length ? convertColumnData(columns[0].data.type, columns[0].data) : [],\n    };\n  } catch (err) {\n    console.error(\"PFrame: calculateTableData error\");\n    throw err;\n  }\n}\n\nexport async function getColumnUniqueValues(\n  handle: PFrameHandle,\n  id: PObjectId,\n  limit = UNIQUE_VALUES_LIMIT,\n  filters: PTableRecordSingleValueFilterV2[] = [],\n): Promise<UniqueValuesResponse> {\n  const request: UniqueValuesRequest = {\n    columnId: id,\n    filters,\n    limit,\n  };\n\n  try {\n    const response = await getPFrameDriver().getUniqueValues(handle, request);\n    if (response.overflow) {\n      console.warn(`More than ${limit} values for ${id} column`);\n    }\n    return {\n      values: Array.from(response.values.data as ArrayLike<unknown>).map(String),\n      overflow: response.overflow,\n    };\n  } catch (err) {\n    console.error(\"PFrame: getUniqueValues for column error\");\n    throw err;\n  }\n}\n\nexport async function getAxisUniqueValues(\n  handle: PFrameHandle,\n  params: GetAxisUniqueValuesParams,\n): Promise<UniqueValuesResponse> {\n  const { axisId, parentColumnIds, limit = UNIQUE_VALUES_LIMIT, filters = [] } = params;\n  const strAxisId = canonicalizeAxisId(axisId);\n\n  const parentsSpecs = (await Promise.all(parentColumnIds.map((p) => getColumnSpecById(handle, p))))\n    .flatMap((spec, i): [PObjectId, PColumnSpec][] =>\n      spec != null && spec.kind === \"PColumn\" ? [[parentColumnIds[i], spec]] : [],\n    )\n    .filter(([_, spec]) =>\n      spec.axesSpec.some((axisSpec) => canonicalizeAxisId(getAxisId(axisSpec)) === strAxisId),\n    );\n\n  if (parentsSpecs.length === 0) {\n    console.warn(\"Axis unique values requested without parent columns\");\n    return { values: [], overflow: false };\n  }\n\n  try {\n    const responses = await Promise.all(\n      parentsSpecs.map(([id]) =>\n        getPFrameDriver().getUniqueValues(handle, {\n          columnId: id,\n          axis: axisId,\n          filters,\n          limit,\n        }),\n      ),\n    );\n\n    const overflow = responses.some((r) => r.overflow);\n    return {\n      values: uniq(\n        flatten(responses.map((r) => Array.from(r.values.data as ArrayLike<unknown>).map(String))),\n      ),\n      overflow,\n    };\n  } catch (err) {\n    console.error(\"PFrame: getUniqueValues for axis error\", err);\n    return { values: [], overflow: false };\n  }\n}\n\nexport async function getRequestColumnsFromSelectedSources(\n  handle: PFrameHandle,\n  sources: PObjectId[],\n): Promise<AxisId[]> {\n  const result: AxisId[] = [];\n  for (const item of sources) {\n    const spec = await getColumnSpecById(handle, item);\n    if (spec?.kind === \"PColumn\") {\n      result.push(...spec.axesSpec.map((spec) => getAxisId(spec)));\n    }\n  }\n  return result;\n}\n\nexport async function getColumnsFull(\n  handle: PFrameHandle,\n  params: GetColumnsFullParams,\n): Promise<PColumnIdAndSpec[]> {\n  const { selectedSources, strictlyCompatible, types, names, annotations, annotationsNotEmpty } =\n    params;\n\n  try {\n    const request: FindColumnsRequest = {\n      columnFilter: {\n        type: types,\n        name: names,\n        annotationValue: annotations,\n        annotationPattern: annotationsNotEmpty?.reduce(\n          (res, v) => {\n            res[v] = \".+\";\n            return res;\n          },\n          {} as Record<string, string>,\n        ),\n      },\n      compatibleWith: await getRequestColumnsFromSelectedSources(handle, selectedSources),\n      strictlyCompatible,\n    };\n\n    const response: FindColumnsResponse = await getPFrameDriver().findColumns(handle, request);\n    return response.hits;\n  } catch (err) {\n    console.error(\"PFrame: findColumns error\");\n    throw err;\n  }\n}\n\nexport async function getColumnOrAxisValueLabelsId(\n  handle: PFrameHandle,\n  strAxisId: CanonicalizedJson<AxisId>,\n): Promise<PObjectId | undefined> {\n  const labelColumns = await getColumnsFull(handle, {\n    selectedSources: [],\n    strictlyCompatible: false,\n    names: [PColumnName.Label],\n  });\n\n  const labelColumn = labelColumns.find(({ spec }) => {\n    return spec && spec.axesSpec.length === 1 && canonicalizeAxisId(spec.axesSpec[0]) === strAxisId;\n  });\n\n  return labelColumn?.columnId;\n}\n\nfunction getDiscreteValuesFromAnnotation(columnSpec: PColumnSpec): undefined | SuggestionResponse {\n  const discreteValuesStr = readAnnotation(columnSpec, Annotation.DiscreteValues);\n  if (!discreteValuesStr) {\n    return undefined;\n  }\n\n  try {\n    const discreteValues: string[] = (JSON.parse(discreteValuesStr) as (string | number)[]).map(\n      (v) => String(v),\n    );\n    const values = discreteValues.map((v) => ({ value: v, label: v })).sort(sortValuesPredicate);\n    return { values, overflow: false };\n  } catch {\n    console.error(`Parsing error: discrete values annotation ${discreteValuesStr}`);\n    return undefined;\n  }\n}\n\nasync function getAxisValuesWithLabels(\n  handle: PFrameHandle,\n  params: {\n    columnId: PObjectId;\n    axisSpec: AxisSpec;\n    labelsColumnId: PObjectId | undefined;\n    limit?: number;\n    searchQuery?: string;\n    searchQueryValue?: string;\n  },\n): Promise<SuggestionResponse> {\n  const { columnId, axisSpec, labelsColumnId, limit, searchQuery, searchQueryValue } = params;\n  const strAxisId = canonicalizeAxisId(getAxisId(axisSpec));\n\n  let filters: PTableRecordSingleValueFilterV2[] = [];\n\n  if (labelsColumnId) {\n    if (searchQuery) {\n      filters = [createSearchFilter(labelsColumnId, searchQuery)];\n    }\n    if (searchQueryValue) {\n      filters = [createAxisSearchFilter(axisSpec, searchQueryValue)];\n    }\n\n    const { data: dataValues, axesData } = await getSingleColumnData(\n      handle,\n      labelsColumnId,\n      filters,\n    );\n    const axisKeys = axesData[strAxisId];\n    const values: { value: string; label: string }[] = [];\n\n    for (let i = 0; i < Math.min(axisKeys.length, limit ?? axisKeys.length); i++) {\n      values.push({ value: String(axisKeys[i]), label: String(dataValues[i]) });\n    }\n\n    values.sort(sortValuesPredicate);\n    return { values, overflow: !(limit === undefined || axisKeys.length < limit) };\n  } else {\n    const searchInLabelsOrValue = searchQuery ?? searchQueryValue;\n    if (searchInLabelsOrValue) {\n      filters = [createAxisSearchFilter(axisSpec, searchInLabelsOrValue)];\n    }\n\n    const response = await getAxisUniqueValues(handle, {\n      axisId: getAxisId(axisSpec),\n      parentColumnIds: [columnId],\n      limit,\n      filters,\n    });\n\n    const values = mapValuesToSuggestions(response.values);\n    return { values, overflow: response.overflow };\n  }\n}\n\nasync function getColumnValuesWithLabels(\n  handle: PFrameHandle,\n  params: {\n    columnId: PObjectId;\n    limit?: number;\n    searchQuery?: string;\n    searchQueryValue?: string;\n  },\n): Promise<SuggestionResponse> {\n  const { columnId, limit, searchQuery, searchQueryValue } = params;\n  const searchInLabelsOrValue = searchQuery ?? searchQueryValue;\n\n  const filters: PTableRecordSingleValueFilterV2[] = searchInLabelsOrValue\n    ? [createSearchFilter(columnId, searchInLabelsOrValue)]\n    : [];\n\n  const response = await getColumnUniqueValues(handle, columnId, limit, filters);\n  const values = mapValuesToSuggestions(response.values);\n  return { values, overflow: response.overflow };\n}\n\nexport async function getUniqueSourceValuesWithLabels(\n  handle: PFrameHandle,\n  params: GetUniqueSourceValuesParams,\n): Promise<SuggestionResponse> {\n  const { columnId, axisIdx, limit, searchQuery, searchQueryValue } = params;\n\n  const selectedSourceSpec = await getColumnSpecById(handle, columnId);\n  if (selectedSourceSpec == null || selectedSourceSpec.kind !== \"PColumn\") {\n    return { values: [], overflow: false };\n  }\n\n  // Try to get discrete values from annotation\n  const discreteValues = getDiscreteValuesFromAnnotation(selectedSourceSpec);\n  if (discreteValues != null) {\n    return discreteValues;\n  }\n\n  // Handle axis values\n  if (axisIdx != null) {\n    const axisSpec = selectedSourceSpec.axesSpec[axisIdx];\n    const strAxisId = canonicalizeAxisId(getAxisId(axisSpec));\n    const labelsColumnId = await getColumnOrAxisValueLabelsId(handle, strAxisId);\n\n    return getAxisValuesWithLabels(handle, {\n      columnId,\n      axisSpec,\n      labelsColumnId,\n      limit,\n      searchQuery,\n      searchQueryValue,\n    });\n  }\n\n  // Handle column values\n  return getColumnValuesWithLabels(handle, {\n    columnId,\n    limit,\n    searchQuery,\n    searchQueryValue,\n  });\n}\n"],"mappings":";;;;;AA4EA,MAAM,sBAAsB;AAG5B,MAAM,uBAAuB,GAAsB,MACjD,EAAE,MAAM,cAAc,EAAE,OAAO,MAAM,EAAE,SAAS,MAAM,CAAC;AAEzD,SAAS,kBAAkB,MAAiB,UAAkC;AAC5E,KAAI,SAAS,SACX,QAAO,SAAS;CAElB,MAAM,MAAgB,IAAI,MAAM,SAAS,KAAK,OAAO;AACrD,MAAK,IAAI,IAAI,GAAG,IAAI,SAAS,KAAK,QAAQ,IACxC,KAAI,MAAA,GAAA,gCAAA,aAAiB,UAAU,EAAE;AAEnC,QAAO;;AAGT,SAAS,mBACP,UACA,WACiC;AACjC,QAAO;EACL,MAAM;EACN,QAAQ;GACN,MAAM;GACN,IAAI;GACL;EACD,WAAW;GACT,UAAU;GACV;GACD;EACF;;AAGH,SAAS,uBACP,UACA,WACiC;AACjC,QAAO;EACL,MAAM;EACN,QAAQ;GACN,MAAM;GACN,IAAI;IACF,MAAM,SAAS;IACf,MAAM,SAAS;IAChB;GACF;EACD,WAAW;GACT,UAAU;GACV;GACD;EACF;;AAGH,SAAS,uBAAuB,QAAsD;AACpF,QAAO,OAAO,KAAK,OAAO;EAAE,OAAO,OAAO,EAAE;EAAE,OAAO,OAAO,EAAE;EAAE,EAAE,CAAC,KAAK,oBAAoB;;AAG9F,SAAS,kBAAkB;AACzB,KAAI,OAAO,cAAc,YACvB,OAAM,IAAI,MAAM,sCAAsC;AAExD,KAAI,OAAO,UAAU,iBAAiB,YACpC,OAAM,IAAI,MAAM,mEAAmE;AAErF,QAAO,UAAU;;AAInB,eAAsB,kBACpB,QACA,IAC6B;AAC7B,KAAI;AAEF,SADiB,MAAM,iBAAiB,CAAC,cAAc,QAAQ,GAAG,IAC/C;UACZ,KAAK;AACZ,UAAQ,MAAM,mCAAmC,IAAI;AACrD,SAAO;;;AAIX,eAAsB,oBACpB,QACA,IACA,UAA6C,EAAE,EACpB;AAC3B,KAAI;EACF,MAAM,WAAmC,MAAM,iBAAiB,CAAC,mBAAmB,QAAQ;GAC1F,KAAK;IACH,MAAM;IACN,QAAQ;IACT;GACD;GACA,SAAS,EAAE;GACZ,CAAyC;EAE1C,MAAM,OAAO,SAAS,QAAQ,SAAS,KAAK,KAAK,SAAS,OAAO;EACjE,MAAM,UAAU,SAAS,QAAQ,SAAS,KAAK,KAAK,SAAS,SAAS;AAEtE,SAAO;GACL,UAAU,KAAK,QAAQ,KAA+B,SAAS;IAC7D,MAAM,MAAA,GAAA,gCAAA,WAAe,KAAK,KAAK,KAAiB;AAChD,SAAA,GAAA,gCAAA,oBAAuB,GAAG,IAAI,kBAAkB,GAAG,MAAM,KAAK,KAAK;AACnE,WAAO;MACN,EAAE,CAAC;GACN,MAAM,QAAQ,SAAS,kBAAkB,QAAQ,GAAG,KAAK,MAAM,QAAQ,GAAG,KAAK,GAAG,EAAE;GACrF;UACM,KAAK;AACZ,UAAQ,MAAM,mCAAmC;AACjD,QAAM;;;AAIV,eAAsB,sBACpB,QACA,IACA,QAAQ,qBACR,UAA6C,EAAE,EAChB;CAC/B,MAAM,UAA+B;EACnC,UAAU;EACV;EACA;EACD;AAED,KAAI;EACF,MAAM,WAAW,MAAM,iBAAiB,CAAC,gBAAgB,QAAQ,QAAQ;AACzE,MAAI,SAAS,SACX,SAAQ,KAAK,aAAa,MAAM,cAAc,GAAG,SAAS;AAE5D,SAAO;GACL,QAAQ,MAAM,KAAK,SAAS,OAAO,KAA2B,CAAC,IAAI,OAAO;GAC1E,UAAU,SAAS;GACpB;UACM,KAAK;AACZ,UAAQ,MAAM,2CAA2C;AACzD,QAAM;;;AAIV,eAAsB,oBACpB,QACA,QAC+B;CAC/B,MAAM,EAAE,QAAQ,iBAAiB,QAAQ,qBAAqB,UAAU,EAAE,KAAK;CAC/E,MAAM,aAAA,GAAA,gCAAA,oBAA+B,OAAO;CAE5C,MAAM,gBAAgB,MAAM,QAAQ,IAAI,gBAAgB,KAAK,MAAM,kBAAkB,QAAQ,EAAE,CAAC,CAAC,EAC9F,SAAS,MAAM,MACd,QAAQ,QAAQ,KAAK,SAAS,YAAY,CAAC,CAAC,gBAAgB,IAAI,KAAK,CAAC,GAAG,EAAE,CAC5E,CACA,QAAQ,CAAC,GAAG,UACX,KAAK,SAAS,MAAM,cAAA,GAAA,gCAAA,qBAAA,GAAA,gCAAA,WAA0C,SAAS,CAAC,KAAK,UAAU,CACxF;AAEH,KAAI,aAAa,WAAW,GAAG;AAC7B,UAAQ,KAAK,sDAAsD;AACnE,SAAO;GAAE,QAAQ,EAAE;GAAE,UAAU;GAAO;;AAGxC,KAAI;EACF,MAAM,YAAY,MAAM,QAAQ,IAC9B,aAAa,KAAK,CAAC,QACjB,iBAAiB,CAAC,gBAAgB,QAAQ;GACxC,UAAU;GACV,MAAM;GACN;GACA;GACD,CAAC,CACH,CACF;EAED,MAAM,WAAW,UAAU,MAAM,MAAM,EAAE,SAAS;AAClD,SAAO;GACL,SAAA,GAAA,WAAA,OAAA,GAAA,WAAA,SACU,UAAU,KAAK,MAAM,MAAM,KAAK,EAAE,OAAO,KAA2B,CAAC,IAAI,OAAO,CAAC,CAAC,CAC3F;GACD;GACD;UACM,KAAK;AACZ,UAAQ,MAAM,0CAA0C,IAAI;AAC5D,SAAO;GAAE,QAAQ,EAAE;GAAE,UAAU;GAAO;;;AAI1C,eAAsB,qCACpB,QACA,SACmB;CACnB,MAAM,SAAmB,EAAE;AAC3B,MAAK,MAAM,QAAQ,SAAS;EAC1B,MAAM,OAAO,MAAM,kBAAkB,QAAQ,KAAK;AAClD,MAAI,MAAM,SAAS,UACjB,QAAO,KAAK,GAAG,KAAK,SAAS,KAAK,UAAA,GAAA,gCAAA,WAAmB,KAAK,CAAC,CAAC;;AAGhE,QAAO;;AAGT,eAAsB,eACpB,QACA,QAC6B;CAC7B,MAAM,EAAE,iBAAiB,oBAAoB,OAAO,OAAO,aAAa,wBACtE;AAEF,KAAI;EACF,MAAM,UAA8B;GAClC,cAAc;IACZ,MAAM;IACN,MAAM;IACN,iBAAiB;IACjB,mBAAmB,qBAAqB,QACrC,KAAK,MAAM;AACV,SAAI,KAAK;AACT,YAAO;OAET,EAAE,CACH;IACF;GACD,gBAAgB,MAAM,qCAAqC,QAAQ,gBAAgB;GACnF;GACD;AAGD,UADsC,MAAM,iBAAiB,CAAC,YAAY,QAAQ,QAAQ,EAC1E;UACT,KAAK;AACZ,UAAQ,MAAM,4BAA4B;AAC1C,QAAM;;;AAIV,eAAsB,6BACpB,QACA,WACgC;AAWhC,SAVqB,MAAM,eAAe,QAAQ;EAChD,iBAAiB,EAAE;EACnB,oBAAoB;EACpB,OAAO,CAACA,gCAAAA,YAAY,MAAM;EAC3B,CAAC,EAE+B,MAAM,EAAE,WAAW;AAClD,SAAO,QAAQ,KAAK,SAAS,WAAW,MAAA,GAAA,gCAAA,oBAAwB,KAAK,SAAS,GAAG,KAAK;GACtF,EAEkB;;AAGtB,SAAS,gCAAgC,YAAyD;CAChG,MAAM,qBAAA,GAAA,gCAAA,gBAAmC,YAAYC,gCAAAA,WAAW,eAAe;AAC/E,KAAI,CAAC,kBACH;AAGF,KAAI;AAKF,SAAO;GAAE,QAJyB,KAAK,MAAM,kBAAkB,CAAyB,KACrF,MAAM,OAAO,EAAE,CACjB,CAC6B,KAAK,OAAO;IAAE,OAAO;IAAG,OAAO;IAAG,EAAE,CAAC,KAAK,oBAAoB;GAC3E,UAAU;GAAO;SAC5B;AACN,UAAQ,MAAM,6CAA6C,oBAAoB;AAC/E;;;AAIJ,eAAe,wBACb,QACA,QAQ6B;CAC7B,MAAM,EAAE,UAAU,UAAU,gBAAgB,OAAO,aAAa,qBAAqB;CACrF,MAAM,aAAA,GAAA,gCAAA,qBAAA,GAAA,gCAAA,WAAyC,SAAS,CAAC;CAEzD,IAAI,UAA6C,EAAE;AAEnD,KAAI,gBAAgB;AAClB,MAAI,YACF,WAAU,CAAC,mBAAmB,gBAAgB,YAAY,CAAC;AAE7D,MAAI,iBACF,WAAU,CAAC,uBAAuB,UAAU,iBAAiB,CAAC;EAGhE,MAAM,EAAE,MAAM,YAAY,aAAa,MAAM,oBAC3C,QACA,gBACA,QACD;EACD,MAAM,WAAW,SAAS;EAC1B,MAAM,SAA6C,EAAE;AAErD,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,IAAI,SAAS,QAAQ,SAAS,SAAS,OAAO,EAAE,IACvE,QAAO,KAAK;GAAE,OAAO,OAAO,SAAS,GAAG;GAAE,OAAO,OAAO,WAAW,GAAG;GAAE,CAAC;AAG3E,SAAO,KAAK,oBAAoB;AAChC,SAAO;GAAE;GAAQ,UAAU,EAAE,UAAU,KAAA,KAAa,SAAS,SAAS;GAAQ;QACzE;EACL,MAAM,wBAAwB,eAAe;AAC7C,MAAI,sBACF,WAAU,CAAC,uBAAuB,UAAU,sBAAsB,CAAC;EAGrE,MAAM,WAAW,MAAM,oBAAoB,QAAQ;GACjD,SAAA,GAAA,gCAAA,WAAkB,SAAS;GAC3B,iBAAiB,CAAC,SAAS;GAC3B;GACA;GACD,CAAC;AAGF,SAAO;GAAE,QADM,uBAAuB,SAAS,OAAO;GACrC,UAAU,SAAS;GAAU;;;AAIlD,eAAe,0BACb,QACA,QAM6B;CAC7B,MAAM,EAAE,UAAU,OAAO,aAAa,qBAAqB;CAC3D,MAAM,wBAAwB,eAAe;CAM7C,MAAM,WAAW,MAAM,sBAAsB,QAAQ,UAAU,OAJZ,wBAC/C,CAAC,mBAAmB,UAAU,sBAAsB,CAAC,GACrD,EAAE,CAEwE;AAE9E,QAAO;EAAE,QADM,uBAAuB,SAAS,OAAO;EACrC,UAAU,SAAS;EAAU;;AAGhD,eAAsB,gCACpB,QACA,QAC6B;CAC7B,MAAM,EAAE,UAAU,SAAS,OAAO,aAAa,qBAAqB;CAEpE,MAAM,qBAAqB,MAAM,kBAAkB,QAAQ,SAAS;AACpE,KAAI,sBAAsB,QAAQ,mBAAmB,SAAS,UAC5D,QAAO;EAAE,QAAQ,EAAE;EAAE,UAAU;EAAO;CAIxC,MAAM,iBAAiB,gCAAgC,mBAAmB;AAC1E,KAAI,kBAAkB,KACpB,QAAO;AAIT,KAAI,WAAW,MAAM;EACnB,MAAM,WAAW,mBAAmB,SAAS;AAI7C,SAAO,wBAAwB,QAAQ;GACrC;GACA;GACA,gBALqB,MAAM,6BAA6B,SAAA,GAAA,gCAAA,qBAAA,GAAA,gCAAA,WADX,SAAS,CAAC,CACmB;GAM1E;GACA;GACA;GACD,CAAC;;AAIJ,QAAO,0BAA0B,QAAQ;EACvC;EACA;EACA;EACA;EACD,CAAC"}
+{"version":3,"file":"index.cjs","names":["PColumnName","Annotation"],"sources":["../../src/pframe_utils/index.ts"],"sourcesContent":["import { flatten, uniq } from \"es-toolkit\";\n\nimport type {\n  AxisSpec,\n  CalculateTableDataRequest,\n  PColumnSpec,\n  PFrameHandle,\n  PTableVector,\n  UniqueValuesRequest,\n  AxisId,\n  CanonicalizedJson,\n  FindColumnsRequest,\n  FindColumnsResponse,\n  FullPTableColumnData,\n  PColumnIdAndSpec,\n  PObjectId,\n  PTableRecordSingleValueFilterV2,\n  ValueType,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  pTableValue,\n  Annotation,\n  canonicalizeAxisId,\n  getAxisId,\n  readAnnotation,\n  PColumnName,\n} from \"@milaboratories/pl-model-common\";\n\nexport * from \"./columns\";\n\n// Types\ntype PValue = string | number | null;\n\ntype SuggestionResponse = {\n  values: {\n    value: string;\n    label: string;\n  }[];\n  overflow: boolean;\n};\n\ntype SingleColumnData = {\n  axesData: Record<string, PValue[]>;\n  data: PValue[];\n};\n\ntype UniqueValuesResponse = {\n  values: string[];\n  overflow: boolean;\n};\n\ntype GetUniqueSourceValuesParams = {\n  columnId: PObjectId;\n  axisIdx?: number;\n  limit?: number;\n  searchQuery?: string;\n  searchQueryValue?: string;\n};\n\ntype GetAxisUniqueValuesParams = {\n  axisId: AxisId;\n  parentColumnIds: PObjectId[];\n  limit?: number;\n  filters?: PTableRecordSingleValueFilterV2[];\n};\n\ntype GetColumnsFullParams = {\n  selectedSources: PObjectId[];\n  strictlyCompatible: boolean;\n  types?: ValueType[];\n  names?: string[];\n  annotations?: FindColumnsRequest[\"columnFilter\"][\"annotationValue\"];\n  annotationsNotEmpty?: string[];\n};\n\n// Constants\nconst UNIQUE_VALUES_LIMIT = 1000000;\n\n// Helper functions\nconst sortValuesPredicate = (a: { label: string }, b: { label: string }) =>\n  a.label.localeCompare(b.label, \"en\", { numeric: true });\n\nfunction convertColumnData(type: ValueType, response: PTableVector): PValue[] {\n  if (type === \"String\") {\n    return response.data as PValue[];\n  }\n  const res: PValue[] = new Array(response.data.length);\n  for (let i = 0; i < response.data.length; i++) {\n    res[i] = pTableValue(response, i) as PValue;\n  }\n  return res;\n}\n\nfunction createSearchFilter(\n  columnId: PObjectId,\n  substring: string,\n): PTableRecordSingleValueFilterV2 {\n  return {\n    type: \"bySingleColumnV2\",\n    column: {\n      type: \"column\",\n      id: columnId,\n    },\n    predicate: {\n      operator: \"StringIContains\",\n      substring,\n    },\n  };\n}\n\nfunction createAxisSearchFilter(\n  axisSpec: AxisSpec,\n  substring: string,\n): PTableRecordSingleValueFilterV2 {\n  return {\n    type: \"bySingleColumnV2\",\n    column: {\n      type: \"axis\",\n      id: {\n        type: axisSpec.type,\n        name: axisSpec.name,\n      },\n    },\n    predicate: {\n      operator: \"StringIContains\",\n      substring,\n    },\n  };\n}\n\nfunction mapValuesToSuggestions(values: string[]): { value: string; label: string }[] {\n  return values.map((v) => ({ value: String(v), label: String(v) })).sort(sortValuesPredicate);\n}\n\nfunction getPFrameDriver() {\n  if (typeof platforma === \"undefined\") {\n    throw new Error(\"Platforma instance is not available\");\n  }\n  if (typeof platforma.pFrameDriver === \"undefined\") {\n    throw new Error(\"PFrame driver is not available in the current Platforma instance\");\n  }\n  return platforma.pFrameDriver;\n}\n\n// Core functions\nexport async function getColumnSpecById(\n  handle: PFrameHandle,\n  id: PObjectId,\n): Promise<PColumnSpec | null> {\n  try {\n    const response = await getPFrameDriver().getColumnSpec(handle, id);\n    return response ?? null;\n  } catch (err) {\n    console.error(\"PFrame: get single column error\", err);\n    return null;\n  }\n}\n\nexport async function getSingleColumnData(\n  handle: PFrameHandle,\n  id: PObjectId,\n  filters: PTableRecordSingleValueFilterV2[] = [],\n): Promise<SingleColumnData> {\n  try {\n    const response: FullPTableColumnData[] = await getPFrameDriver().calculateTableData(handle, {\n      src: {\n        type: \"column\",\n        column: id,\n      },\n      filters,\n      sorting: [],\n    } as CalculateTableDataRequest<PObjectId>);\n\n    const axes = response.filter((item) => item.spec.type === \"axis\");\n    const columns = response.filter((item) => item.spec.type === \"column\");\n\n    return {\n      axesData: axes.reduce((res: Record<string, PValue[]>, item) => {\n        const id = getAxisId(item.spec.spec as AxisSpec);\n        res[canonicalizeAxisId(id)] = convertColumnData(id.type, item.data);\n        return res;\n      }, {}),\n      data: columns.length ? convertColumnData(columns[0].data.type, columns[0].data) : [],\n    };\n  } catch (err) {\n    console.error(\"PFrame: calculateTableData error\");\n    throw err;\n  }\n}\n\nexport async function getColumnUniqueValues(\n  handle: PFrameHandle,\n  id: PObjectId,\n  limit = UNIQUE_VALUES_LIMIT,\n  filters: PTableRecordSingleValueFilterV2[] = [],\n): Promise<UniqueValuesResponse> {\n  const request: UniqueValuesRequest = {\n    columnId: id,\n    filters,\n    limit,\n  };\n\n  try {\n    const response = await getPFrameDriver().getUniqueValues(handle, request);\n    if (response.overflow) {\n      console.warn(`More than ${limit} values for ${id} column`);\n    }\n    return {\n      values: Array.from(response.values.data as ArrayLike<unknown>).map(String),\n      overflow: response.overflow,\n    };\n  } catch (err) {\n    console.error(\"PFrame: getUniqueValues for column error\");\n    throw err;\n  }\n}\n\nexport async function getAxisUniqueValues(\n  handle: PFrameHandle,\n  params: GetAxisUniqueValuesParams,\n): Promise<UniqueValuesResponse> {\n  const { axisId, parentColumnIds, limit = UNIQUE_VALUES_LIMIT, filters = [] } = params;\n  const strAxisId = canonicalizeAxisId(axisId);\n\n  const parentsSpecs = (await Promise.all(parentColumnIds.map((p) => getColumnSpecById(handle, p))))\n    .flatMap((spec, i): [PObjectId, PColumnSpec][] =>\n      spec != null && spec.kind === \"PColumn\" ? [[parentColumnIds[i], spec]] : [],\n    )\n    .filter(([_, spec]) =>\n      spec.axesSpec.some((axisSpec) => canonicalizeAxisId(getAxisId(axisSpec)) === strAxisId),\n    );\n\n  if (parentsSpecs.length === 0) {\n    console.warn(\"Axis unique values requested without parent columns\");\n    return { values: [], overflow: false };\n  }\n\n  try {\n    const responses = await Promise.all(\n      parentsSpecs.map(([id]) =>\n        getPFrameDriver().getUniqueValues(handle, {\n          columnId: id,\n          axis: axisId,\n          filters,\n          limit,\n        }),\n      ),\n    );\n\n    const overflow = responses.some((r) => r.overflow);\n    return {\n      values: uniq(\n        flatten(responses.map((r) => Array.from(r.values.data as ArrayLike<unknown>).map(String))),\n      ),\n      overflow,\n    };\n  } catch (err) {\n    console.error(\"PFrame: getUniqueValues for axis error\", err);\n    return { values: [], overflow: false };\n  }\n}\n\nexport async function getRequestColumnsFromSelectedSources(\n  handle: PFrameHandle,\n  sources: PObjectId[],\n): Promise<AxisId[]> {\n  const result: AxisId[] = [];\n  for (const item of sources) {\n    const spec = await getColumnSpecById(handle, item);\n    if (spec?.kind === \"PColumn\") {\n      result.push(...spec.axesSpec.map((spec) => getAxisId(spec)));\n    }\n  }\n  return result;\n}\n\nexport async function getColumnsFull(\n  handle: PFrameHandle,\n  params: GetColumnsFullParams,\n): Promise<PColumnIdAndSpec[]> {\n  const { selectedSources, strictlyCompatible, types, names, annotations, annotationsNotEmpty } =\n    params;\n\n  try {\n    const request: FindColumnsRequest = {\n      columnFilter: {\n        type: types,\n        name: names,\n        annotationValue: annotations,\n        annotationPattern: annotationsNotEmpty?.reduce(\n          (res, v) => {\n            res[v] = \".+\";\n            return res;\n          },\n          {} as Record<string, string>,\n        ),\n      },\n      compatibleWith: await getRequestColumnsFromSelectedSources(handle, selectedSources),\n      strictlyCompatible,\n    };\n\n    const response: FindColumnsResponse = await getPFrameDriver().findColumns(handle, request);\n    return response.hits;\n  } catch (err) {\n    console.error(\"PFrame: findColumns error\");\n    throw err;\n  }\n}\n\nexport async function getColumnOrAxisValueLabelsId(\n  handle: PFrameHandle,\n  strAxisId: CanonicalizedJson<AxisId>,\n): Promise<PObjectId | undefined> {\n  const labelColumns = await getColumnsFull(handle, {\n    selectedSources: [],\n    strictlyCompatible: false,\n    names: [PColumnName.Label],\n  });\n\n  const labelColumn = labelColumns.find(({ spec }) => {\n    return spec && spec.axesSpec.length === 1 && canonicalizeAxisId(spec.axesSpec[0]) === strAxisId;\n  });\n\n  return labelColumn?.columnId;\n}\n\nfunction getDiscreteValuesFromAnnotation(columnSpec: PColumnSpec): undefined | SuggestionResponse {\n  const discreteValuesStr = readAnnotation(columnSpec, Annotation.DiscreteValues);\n  if (!discreteValuesStr) {\n    return undefined;\n  }\n\n  try {\n    const discreteValues: string[] = (JSON.parse(discreteValuesStr) as (string | number)[]).map(\n      (v) => String(v),\n    );\n    const values = discreteValues.map((v) => ({ value: v, label: v })).sort(sortValuesPredicate);\n    return { values, overflow: false };\n  } catch {\n    console.error(`Parsing error: discrete values annotation ${discreteValuesStr}`);\n    return undefined;\n  }\n}\n\nasync function getAxisValuesWithLabels(\n  handle: PFrameHandle,\n  params: {\n    columnId: PObjectId;\n    axisSpec: AxisSpec;\n    labelsColumnId: PObjectId | undefined;\n    limit?: number;\n    searchQuery?: string;\n    searchQueryValue?: string;\n  },\n): Promise<SuggestionResponse> {\n  const { columnId, axisSpec, labelsColumnId, limit, searchQuery, searchQueryValue } = params;\n  const strAxisId = canonicalizeAxisId(getAxisId(axisSpec));\n\n  let filters: PTableRecordSingleValueFilterV2[] = [];\n\n  if (labelsColumnId) {\n    if (searchQuery) {\n      filters = [createSearchFilter(labelsColumnId, searchQuery)];\n    }\n    if (searchQueryValue) {\n      filters = [createAxisSearchFilter(axisSpec, searchQueryValue)];\n    }\n\n    const { data: dataValues, axesData } = await getSingleColumnData(\n      handle,\n      labelsColumnId,\n      filters,\n    );\n    const axisKeys = axesData[strAxisId];\n    const values: { value: string; label: string }[] = [];\n\n    for (let i = 0; i < Math.min(axisKeys.length, limit ?? axisKeys.length); i++) {\n      values.push({ value: String(axisKeys[i]), label: String(dataValues[i]) });\n    }\n\n    values.sort(sortValuesPredicate);\n    return { values, overflow: !(limit === undefined || axisKeys.length < limit) };\n  } else {\n    const searchInLabelsOrValue = searchQuery ?? searchQueryValue;\n    if (searchInLabelsOrValue) {\n      filters = [createAxisSearchFilter(axisSpec, searchInLabelsOrValue)];\n    }\n\n    const response = await getAxisUniqueValues(handle, {\n      axisId: getAxisId(axisSpec),\n      parentColumnIds: [columnId],\n      limit,\n      filters,\n    });\n\n    const values = mapValuesToSuggestions(response.values);\n    return { values, overflow: response.overflow };\n  }\n}\n\nasync function getColumnValuesWithLabels(\n  handle: PFrameHandle,\n  params: {\n    columnId: PObjectId;\n    limit?: number;\n    searchQuery?: string;\n    searchQueryValue?: string;\n  },\n): Promise<SuggestionResponse> {\n  const { columnId, limit, searchQuery, searchQueryValue } = params;\n  const searchInLabelsOrValue = searchQuery ?? searchQueryValue;\n\n  const filters: PTableRecordSingleValueFilterV2[] = searchInLabelsOrValue\n    ? [createSearchFilter(columnId, searchInLabelsOrValue)]\n    : [];\n\n  const response = await getColumnUniqueValues(handle, columnId, limit, filters);\n  const values = mapValuesToSuggestions(response.values);\n  return { values, overflow: response.overflow };\n}\n\nexport async function getUniqueSourceValuesWithLabels(\n  handle: PFrameHandle,\n  params: GetUniqueSourceValuesParams,\n): Promise<SuggestionResponse> {\n  const { columnId, axisIdx, limit, searchQuery, searchQueryValue } = params;\n\n  const selectedSourceSpec = await getColumnSpecById(handle, columnId);\n  if (selectedSourceSpec == null || selectedSourceSpec.kind !== \"PColumn\") {\n    return { values: [], overflow: false };\n  }\n\n  // Try to get discrete values from annotation\n  const discreteValues = getDiscreteValuesFromAnnotation(selectedSourceSpec);\n  if (discreteValues != null) {\n    return discreteValues;\n  }\n\n  // Handle axis values\n  if (axisIdx != null) {\n    const axisSpec = selectedSourceSpec.axesSpec[axisIdx];\n    const strAxisId = canonicalizeAxisId(getAxisId(axisSpec));\n    const labelsColumnId = await getColumnOrAxisValueLabelsId(handle, strAxisId);\n\n    return getAxisValuesWithLabels(handle, {\n      columnId,\n      axisSpec,\n      labelsColumnId,\n      limit,\n      searchQuery,\n      searchQueryValue,\n    });\n  }\n\n  // Handle column values\n  return getColumnValuesWithLabels(handle, {\n    columnId,\n    limit,\n    searchQuery,\n    searchQueryValue,\n  });\n}\n"],"mappings":"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"}

package/dist/pframe_utils/index.d.ts

@@ -48,5 +48,5 @@ declare function getColumnsFull(handle: PFrameHandle, params: GetColumnsFullPara
 declare function getColumnOrAxisValueLabelsId(handle: PFrameHandle, strAxisId: CanonicalizedJson<AxisId>): Promise<PObjectId | undefined>;
 declare function getUniqueSourceValuesWithLabels(handle: PFrameHandle, params: GetUniqueSourceValuesParams): Promise<SuggestionResponse>;
 //#endregion
-export { getAxisUniqueValues, getColumnOrAxisValueLabelsId, getColumnSpecById, getColumnUniqueValues, getColumnsFull, getRequestColumnsFromSelectedSources, getSingleColumnData, getUniqueSourceValuesWithLabels };
+export { getAllRelatedColumns, getAxisUniqueValues, getColumnOrAxisValueLabelsId, getColumnSpecById, getColumnUniqueValues, getColumnsFull, getRelatedColumns, getRequestColumnsFromSelectedSources, getSingleColumnData, getUniqueSourceValuesWithLabels };
 //# sourceMappingURL=index.d.ts.map

package/dist/pframe_utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/pframe_utils/index.ts"],"mappings":";;;;KA+BK,MAAA;AAAA,KAEA,kBAAA;EACH,MAAA;IACE,KAAA;IACA,KAAA;EAAA;EAEF,QAAA;AAAA;AAAA,KAGG,gBAAA;EACH,QAAA,EAAU,MAAA,SAAe,MAAA;EACzB,IAAA,EAAM,MAAA;AAAA;AAAA,KAGH,sBAAA;EACH,MAAA;EACA,QAAA;AAAA;AAAA,KAGG,2BAAA;EACH,QAAA,EAAU,SAAA;EACV,OAAA;EACA,KAAA;EACA,WAAA;EACA,gBAAA;AAAA;AAAA,KAGG,yBAAA;EACH,MAAA,EAAQ,MAAA;EACR,eAAA,EAAiB,SAAA;EACjB,KAAA;EACA,OAAA,GAAU,+BAAA;AAAA;AAAA,KAGP,oBAAA;EACH,eAAA,EAAiB,SAAA;EACjB,kBAAA;EACA,KAAA,GAAQ,SAAA;EACR,KAAA;EACA,WAAA,GAAc,kBAAA;EACd,mBAAA;AAAA;AAAA,iBAyEoB,iBAAA,CACpB,MAAA,EAAQ,YAAA,EACR,EAAA,EAAI,SAAA,GACH,OAAA,CAAQ,WAAA;AAAA,iBAUW,mBAAA,CACpB,MAAA,EAAQ,YAAA,EACR,EAAA,EAAI,SAAA,EACJ,OAAA,GAAS,+BAAA,KACR,OAAA,CAAQ,gBAAA;AAAA,iBA4BW,qBAAA,CACpB,MAAA,EAAQ,YAAA,EACR,EAAA,EAAI,SAAA,EACJ,KAAA,WACA,OAAA,GAAS,+BAAA,KACR,OAAA,CAAQ,sBAAA;AAAA,iBAsBW,mBAAA,CACpB,MAAA,EAAQ,YAAA,EACR,MAAA,EAAQ,yBAAA,GACP,OAAA,CAAQ,sBAAA;AAAA,iBA0CW,oCAAA,CACpB,MAAA,EAAQ,YAAA,EACR,OAAA,EAAS,SAAA,KACR,OAAA,CAAQ,MAAA;AAAA,iBAWW,cAAA,CACpB,MAAA,EAAQ,YAAA,EACR,MAAA,EAAQ,oBAAA,GACP,OAAA,CAAQ,gBAAA;AAAA,iBA8BW,4BAAA,CACpB,MAAA,EAAQ,YAAA,EACR,SAAA,EAAW,iBAAA,CAAkB,MAAA,IAC5B,OAAA,CAAQ,SAAA;AAAA,iBA6GW,+BAAA,CACpB,MAAA,EAAQ,YAAA,EACR,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,kBAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/pframe_utils/index.ts"],"mappings":";;;;KA+BK,MAAA;AAAA,KAEA,kBAAA;EACH,MAAA;IACE,KAAA;IACA,KAAA;EAAA;EAEF,QAAA;AAAA;AAAA,KAGG,gBAAA;EACH,QAAA,EAAU,MAAA,SAAe,MAAA;EACzB,IAAA,EAAM,MAAA;AAAA;AAAA,KAGH,sBAAA;EACH,MAAA;EACA,QAAQ;AAAA;AAAA,KAGL,2BAAA;EACH,QAAA,EAAU,SAAS;EACnB,OAAA;EACA,KAAA;EACA,WAAA;EACA,gBAAA;AAAA;AAAA,KAGG,yBAAA;EACH,MAAA,EAAQ,MAAA;EACR,eAAA,EAAiB,SAAA;EACjB,KAAA;EACA,OAAA,GAAU,+BAAA;AAAA;AAAA,KAGP,oBAAA;EACH,eAAA,EAAiB,SAAA;EACjB,kBAAA;EACA,KAAA,GAAQ,SAAA;EACR,KAAA;EACA,WAAA,GAAc,kBAAA;EACd,mBAAA;AAAA;AAAA,iBAyEoB,iBAAA,CACpB,MAAA,EAAQ,YAAA,EACR,EAAA,EAAI,SAAA,GACH,OAAA,CAAQ,WAAA;AAAA,iBAUW,mBAAA,CACpB,MAAA,EAAQ,YAAA,EACR,EAAA,EAAI,SAAA,EACJ,OAAA,GAAS,+BAAA,KACR,OAAA,CAAQ,gBAAA;AAAA,iBA4BW,qBAAA,CACpB,MAAA,EAAQ,YAAA,EACR,EAAA,EAAI,SAAA,EACJ,KAAA,WACA,OAAA,GAAS,+BAAA,KACR,OAAA,CAAQ,sBAAA;AAAA,iBAsBW,mBAAA,CACpB,MAAA,EAAQ,YAAA,EACR,MAAA,EAAQ,yBAAA,GACP,OAAA,CAAQ,sBAAA;AAAA,iBA0CW,oCAAA,CACpB,MAAA,EAAQ,YAAA,EACR,OAAA,EAAS,SAAA,KACR,OAAA,CAAQ,MAAA;AAAA,iBAWW,cAAA,CACpB,MAAA,EAAQ,YAAA,EACR,MAAA,EAAQ,oBAAA,GACP,OAAA,CAAQ,gBAAA;AAAA,iBA8BW,4BAAA,CACpB,MAAA,EAAQ,YAAA,EACR,SAAA,EAAW,iBAAA,CAAkB,MAAA,IAC5B,OAAA,CAAQ,SAAA;AAAA,iBA6GW,+BAAA,CACpB,MAAA,EAAQ,YAAA,EACR,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,kBAAA"}

package/dist/pframe_utils/index.js

@@ -1,4 +1,4 @@
-import "./columns.js";
+import { getAllRelatedColumns, getRelatedColumns } from "./columns.js";
 import { Annotation, PColumnName, canonicalizeAxisId, getAxisId, pTableValue, readAnnotation } from "@milaboratories/pl-model-common";
 import { flatten, uniq } from "es-toolkit";
 //#region src/pframe_utils/index.ts
@@ -258,6 +258,6 @@ async function getUniqueSourceValuesWithLabels(handle, params) {
 	});
 }
 //#endregion
-export { getAxisUniqueValues, getColumnOrAxisValueLabelsId, getColumnSpecById, getColumnUniqueValues, getColumnsFull, getRequestColumnsFromSelectedSources, getSingleColumnData, getUniqueSourceValuesWithLabels };
+export { getAllRelatedColumns, getAxisUniqueValues, getColumnOrAxisValueLabelsId, getColumnSpecById, getColumnUniqueValues, getColumnsFull, getRelatedColumns, getRequestColumnsFromSelectedSources, getSingleColumnData, getUniqueSourceValuesWithLabels };
 
 //# sourceMappingURL=index.js.map

package/dist/pframe_utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/pframe_utils/index.ts"],"sourcesContent":["import { flatten, uniq } from \"es-toolkit\";\n\nimport type {\n  AxisSpec,\n  CalculateTableDataRequest,\n  PColumnSpec,\n  PFrameHandle,\n  PTableVector,\n  UniqueValuesRequest,\n  AxisId,\n  CanonicalizedJson,\n  FindColumnsRequest,\n  FindColumnsResponse,\n  FullPTableColumnData,\n  PColumnIdAndSpec,\n  PObjectId,\n  PTableRecordSingleValueFilterV2,\n  ValueType,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  pTableValue,\n  Annotation,\n  canonicalizeAxisId,\n  getAxisId,\n  readAnnotation,\n  PColumnName,\n} from \"@milaboratories/pl-model-common\";\n\nexport * from \"./columns\";\n\n// Types\ntype PValue = string | number | null;\n\ntype SuggestionResponse = {\n  values: {\n    value: string;\n    label: string;\n  }[];\n  overflow: boolean;\n};\n\ntype SingleColumnData = {\n  axesData: Record<string, PValue[]>;\n  data: PValue[];\n};\n\ntype UniqueValuesResponse = {\n  values: string[];\n  overflow: boolean;\n};\n\ntype GetUniqueSourceValuesParams = {\n  columnId: PObjectId;\n  axisIdx?: number;\n  limit?: number;\n  searchQuery?: string;\n  searchQueryValue?: string;\n};\n\ntype GetAxisUniqueValuesParams = {\n  axisId: AxisId;\n  parentColumnIds: PObjectId[];\n  limit?: number;\n  filters?: PTableRecordSingleValueFilterV2[];\n};\n\ntype GetColumnsFullParams = {\n  selectedSources: PObjectId[];\n  strictlyCompatible: boolean;\n  types?: ValueType[];\n  names?: string[];\n  annotations?: FindColumnsRequest[\"columnFilter\"][\"annotationValue\"];\n  annotationsNotEmpty?: string[];\n};\n\n// Constants\nconst UNIQUE_VALUES_LIMIT = 1000000;\n\n// Helper functions\nconst sortValuesPredicate = (a: { label: string }, b: { label: string }) =>\n  a.label.localeCompare(b.label, \"en\", { numeric: true });\n\nfunction convertColumnData(type: ValueType, response: PTableVector): PValue[] {\n  if (type === \"String\") {\n    return response.data as PValue[];\n  }\n  const res: PValue[] = new Array(response.data.length);\n  for (let i = 0; i < response.data.length; i++) {\n    res[i] = pTableValue(response, i) as PValue;\n  }\n  return res;\n}\n\nfunction createSearchFilter(\n  columnId: PObjectId,\n  substring: string,\n): PTableRecordSingleValueFilterV2 {\n  return {\n    type: \"bySingleColumnV2\",\n    column: {\n      type: \"column\",\n      id: columnId,\n    },\n    predicate: {\n      operator: \"StringIContains\",\n      substring,\n    },\n  };\n}\n\nfunction createAxisSearchFilter(\n  axisSpec: AxisSpec,\n  substring: string,\n): PTableRecordSingleValueFilterV2 {\n  return {\n    type: \"bySingleColumnV2\",\n    column: {\n      type: \"axis\",\n      id: {\n        type: axisSpec.type,\n        name: axisSpec.name,\n      },\n    },\n    predicate: {\n      operator: \"StringIContains\",\n      substring,\n    },\n  };\n}\n\nfunction mapValuesToSuggestions(values: string[]): { value: string; label: string }[] {\n  return values.map((v) => ({ value: String(v), label: String(v) })).sort(sortValuesPredicate);\n}\n\nfunction getPFrameDriver() {\n  if (typeof platforma === \"undefined\") {\n    throw new Error(\"Platforma instance is not available\");\n  }\n  if (typeof platforma.pFrameDriver === \"undefined\") {\n    throw new Error(\"PFrame driver is not available in the current Platforma instance\");\n  }\n  return platforma.pFrameDriver;\n}\n\n// Core functions\nexport async function getColumnSpecById(\n  handle: PFrameHandle,\n  id: PObjectId,\n): Promise<PColumnSpec | null> {\n  try {\n    const response = await getPFrameDriver().getColumnSpec(handle, id);\n    return response ?? null;\n  } catch (err) {\n    console.error(\"PFrame: get single column error\", err);\n    return null;\n  }\n}\n\nexport async function getSingleColumnData(\n  handle: PFrameHandle,\n  id: PObjectId,\n  filters: PTableRecordSingleValueFilterV2[] = [],\n): Promise<SingleColumnData> {\n  try {\n    const response: FullPTableColumnData[] = await getPFrameDriver().calculateTableData(handle, {\n      src: {\n        type: \"column\",\n        column: id,\n      },\n      filters,\n      sorting: [],\n    } as CalculateTableDataRequest<PObjectId>);\n\n    const axes = response.filter((item) => item.spec.type === \"axis\");\n    const columns = response.filter((item) => item.spec.type === \"column\");\n\n    return {\n      axesData: axes.reduce((res: Record<string, PValue[]>, item) => {\n        const id = getAxisId(item.spec.spec as AxisSpec);\n        res[canonicalizeAxisId(id)] = convertColumnData(id.type, item.data);\n        return res;\n      }, {}),\n      data: columns.length ? convertColumnData(columns[0].data.type, columns[0].data) : [],\n    };\n  } catch (err) {\n    console.error(\"PFrame: calculateTableData error\");\n    throw err;\n  }\n}\n\nexport async function getColumnUniqueValues(\n  handle: PFrameHandle,\n  id: PObjectId,\n  limit = UNIQUE_VALUES_LIMIT,\n  filters: PTableRecordSingleValueFilterV2[] = [],\n): Promise<UniqueValuesResponse> {\n  const request: UniqueValuesRequest = {\n    columnId: id,\n    filters,\n    limit,\n  };\n\n  try {\n    const response = await getPFrameDriver().getUniqueValues(handle, request);\n    if (response.overflow) {\n      console.warn(`More than ${limit} values for ${id} column`);\n    }\n    return {\n      values: Array.from(response.values.data as ArrayLike<unknown>).map(String),\n      overflow: response.overflow,\n    };\n  } catch (err) {\n    console.error(\"PFrame: getUniqueValues for column error\");\n    throw err;\n  }\n}\n\nexport async function getAxisUniqueValues(\n  handle: PFrameHandle,\n  params: GetAxisUniqueValuesParams,\n): Promise<UniqueValuesResponse> {\n  const { axisId, parentColumnIds, limit = UNIQUE_VALUES_LIMIT, filters = [] } = params;\n  const strAxisId = canonicalizeAxisId(axisId);\n\n  const parentsSpecs = (await Promise.all(parentColumnIds.map((p) => getColumnSpecById(handle, p))))\n    .flatMap((spec, i): [PObjectId, PColumnSpec][] =>\n      spec != null && spec.kind === \"PColumn\" ? [[parentColumnIds[i], spec]] : [],\n    )\n    .filter(([_, spec]) =>\n      spec.axesSpec.some((axisSpec) => canonicalizeAxisId(getAxisId(axisSpec)) === strAxisId),\n    );\n\n  if (parentsSpecs.length === 0) {\n    console.warn(\"Axis unique values requested without parent columns\");\n    return { values: [], overflow: false };\n  }\n\n  try {\n    const responses = await Promise.all(\n      parentsSpecs.map(([id]) =>\n        getPFrameDriver().getUniqueValues(handle, {\n          columnId: id,\n          axis: axisId,\n          filters,\n          limit,\n        }),\n      ),\n    );\n\n    const overflow = responses.some((r) => r.overflow);\n    return {\n      values: uniq(\n        flatten(responses.map((r) => Array.from(r.values.data as ArrayLike<unknown>).map(String))),\n      ),\n      overflow,\n    };\n  } catch (err) {\n    console.error(\"PFrame: getUniqueValues for axis error\", err);\n    return { values: [], overflow: false };\n  }\n}\n\nexport async function getRequestColumnsFromSelectedSources(\n  handle: PFrameHandle,\n  sources: PObjectId[],\n): Promise<AxisId[]> {\n  const result: AxisId[] = [];\n  for (const item of sources) {\n    const spec = await getColumnSpecById(handle, item);\n    if (spec?.kind === \"PColumn\") {\n      result.push(...spec.axesSpec.map((spec) => getAxisId(spec)));\n    }\n  }\n  return result;\n}\n\nexport async function getColumnsFull(\n  handle: PFrameHandle,\n  params: GetColumnsFullParams,\n): Promise<PColumnIdAndSpec[]> {\n  const { selectedSources, strictlyCompatible, types, names, annotations, annotationsNotEmpty } =\n    params;\n\n  try {\n    const request: FindColumnsRequest = {\n      columnFilter: {\n        type: types,\n        name: names,\n        annotationValue: annotations,\n        annotationPattern: annotationsNotEmpty?.reduce(\n          (res, v) => {\n            res[v] = \".+\";\n            return res;\n          },\n          {} as Record<string, string>,\n        ),\n      },\n      compatibleWith: await getRequestColumnsFromSelectedSources(handle, selectedSources),\n      strictlyCompatible,\n    };\n\n    const response: FindColumnsResponse = await getPFrameDriver().findColumns(handle, request);\n    return response.hits;\n  } catch (err) {\n    console.error(\"PFrame: findColumns error\");\n    throw err;\n  }\n}\n\nexport async function getColumnOrAxisValueLabelsId(\n  handle: PFrameHandle,\n  strAxisId: CanonicalizedJson<AxisId>,\n): Promise<PObjectId | undefined> {\n  const labelColumns = await getColumnsFull(handle, {\n    selectedSources: [],\n    strictlyCompatible: false,\n    names: [PColumnName.Label],\n  });\n\n  const labelColumn = labelColumns.find(({ spec }) => {\n    return spec && spec.axesSpec.length === 1 && canonicalizeAxisId(spec.axesSpec[0]) === strAxisId;\n  });\n\n  return labelColumn?.columnId;\n}\n\nfunction getDiscreteValuesFromAnnotation(columnSpec: PColumnSpec): undefined | SuggestionResponse {\n  const discreteValuesStr = readAnnotation(columnSpec, Annotation.DiscreteValues);\n  if (!discreteValuesStr) {\n    return undefined;\n  }\n\n  try {\n    const discreteValues: string[] = (JSON.parse(discreteValuesStr) as (string | number)[]).map(\n      (v) => String(v),\n    );\n    const values = discreteValues.map((v) => ({ value: v, label: v })).sort(sortValuesPredicate);\n    return { values, overflow: false };\n  } catch {\n    console.error(`Parsing error: discrete values annotation ${discreteValuesStr}`);\n    return undefined;\n  }\n}\n\nasync function getAxisValuesWithLabels(\n  handle: PFrameHandle,\n  params: {\n    columnId: PObjectId;\n    axisSpec: AxisSpec;\n    labelsColumnId: PObjectId | undefined;\n    limit?: number;\n    searchQuery?: string;\n    searchQueryValue?: string;\n  },\n): Promise<SuggestionResponse> {\n  const { columnId, axisSpec, labelsColumnId, limit, searchQuery, searchQueryValue } = params;\n  const strAxisId = canonicalizeAxisId(getAxisId(axisSpec));\n\n  let filters: PTableRecordSingleValueFilterV2[] = [];\n\n  if (labelsColumnId) {\n    if (searchQuery) {\n      filters = [createSearchFilter(labelsColumnId, searchQuery)];\n    }\n    if (searchQueryValue) {\n      filters = [createAxisSearchFilter(axisSpec, searchQueryValue)];\n    }\n\n    const { data: dataValues, axesData } = await getSingleColumnData(\n      handle,\n      labelsColumnId,\n      filters,\n    );\n    const axisKeys = axesData[strAxisId];\n    const values: { value: string; label: string }[] = [];\n\n    for (let i = 0; i < Math.min(axisKeys.length, limit ?? axisKeys.length); i++) {\n      values.push({ value: String(axisKeys[i]), label: String(dataValues[i]) });\n    }\n\n    values.sort(sortValuesPredicate);\n    return { values, overflow: !(limit === undefined || axisKeys.length < limit) };\n  } else {\n    const searchInLabelsOrValue = searchQuery ?? searchQueryValue;\n    if (searchInLabelsOrValue) {\n      filters = [createAxisSearchFilter(axisSpec, searchInLabelsOrValue)];\n    }\n\n    const response = await getAxisUniqueValues(handle, {\n      axisId: getAxisId(axisSpec),\n      parentColumnIds: [columnId],\n      limit,\n      filters,\n    });\n\n    const values = mapValuesToSuggestions(response.values);\n    return { values, overflow: response.overflow };\n  }\n}\n\nasync function getColumnValuesWithLabels(\n  handle: PFrameHandle,\n  params: {\n    columnId: PObjectId;\n    limit?: number;\n    searchQuery?: string;\n    searchQueryValue?: string;\n  },\n): Promise<SuggestionResponse> {\n  const { columnId, limit, searchQuery, searchQueryValue } = params;\n  const searchInLabelsOrValue = searchQuery ?? searchQueryValue;\n\n  const filters: PTableRecordSingleValueFilterV2[] = searchInLabelsOrValue\n    ? [createSearchFilter(columnId, searchInLabelsOrValue)]\n    : [];\n\n  const response = await getColumnUniqueValues(handle, columnId, limit, filters);\n  const values = mapValuesToSuggestions(response.values);\n  return { values, overflow: response.overflow };\n}\n\nexport async function getUniqueSourceValuesWithLabels(\n  handle: PFrameHandle,\n  params: GetUniqueSourceValuesParams,\n): Promise<SuggestionResponse> {\n  const { columnId, axisIdx, limit, searchQuery, searchQueryValue } = params;\n\n  const selectedSourceSpec = await getColumnSpecById(handle, columnId);\n  if (selectedSourceSpec == null || selectedSourceSpec.kind !== \"PColumn\") {\n    return { values: [], overflow: false };\n  }\n\n  // Try to get discrete values from annotation\n  const discreteValues = getDiscreteValuesFromAnnotation(selectedSourceSpec);\n  if (discreteValues != null) {\n    return discreteValues;\n  }\n\n  // Handle axis values\n  if (axisIdx != null) {\n    const axisSpec = selectedSourceSpec.axesSpec[axisIdx];\n    const strAxisId = canonicalizeAxisId(getAxisId(axisSpec));\n    const labelsColumnId = await getColumnOrAxisValueLabelsId(handle, strAxisId);\n\n    return getAxisValuesWithLabels(handle, {\n      columnId,\n      axisSpec,\n      labelsColumnId,\n      limit,\n      searchQuery,\n      searchQueryValue,\n    });\n  }\n\n  // Handle column values\n  return getColumnValuesWithLabels(handle, {\n    columnId,\n    limit,\n    searchQuery,\n    searchQueryValue,\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/pframe_utils/index.ts"],"sourcesContent":["import { flatten, uniq } from \"es-toolkit\";\n\nimport type {\n  AxisSpec,\n  CalculateTableDataRequest,\n  PColumnSpec,\n  PFrameHandle,\n  PTableVector,\n  UniqueValuesRequest,\n  AxisId,\n  CanonicalizedJson,\n  FindColumnsRequest,\n  FindColumnsResponse,\n  FullPTableColumnData,\n  PColumnIdAndSpec,\n  PObjectId,\n  PTableRecordSingleValueFilterV2,\n  ValueType,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  pTableValue,\n  Annotation,\n  canonicalizeAxisId,\n  getAxisId,\n  readAnnotation,\n  PColumnName,\n} from \"@milaboratories/pl-model-common\";\n\nexport * from \"./columns\";\n\n// Types\ntype PValue = string | number | null;\n\ntype SuggestionResponse = {\n  values: {\n    value: string;\n    label: string;\n  }[];\n  overflow: boolean;\n};\n\ntype SingleColumnData = {\n  axesData: Record<string, PValue[]>;\n  data: PValue[];\n};\n\ntype UniqueValuesResponse = {\n  values: string[];\n  overflow: boolean;\n};\n\ntype GetUniqueSourceValuesParams = {\n  columnId: PObjectId;\n  axisIdx?: number;\n  limit?: number;\n  searchQuery?: string;\n  searchQueryValue?: string;\n};\n\ntype GetAxisUniqueValuesParams = {\n  axisId: AxisId;\n  parentColumnIds: PObjectId[];\n  limit?: number;\n  filters?: PTableRecordSingleValueFilterV2[];\n};\n\ntype GetColumnsFullParams = {\n  selectedSources: PObjectId[];\n  strictlyCompatible: boolean;\n  types?: ValueType[];\n  names?: string[];\n  annotations?: FindColumnsRequest[\"columnFilter\"][\"annotationValue\"];\n  annotationsNotEmpty?: string[];\n};\n\n// Constants\nconst UNIQUE_VALUES_LIMIT = 1000000;\n\n// Helper functions\nconst sortValuesPredicate = (a: { label: string }, b: { label: string }) =>\n  a.label.localeCompare(b.label, \"en\", { numeric: true });\n\nfunction convertColumnData(type: ValueType, response: PTableVector): PValue[] {\n  if (type === \"String\") {\n    return response.data as PValue[];\n  }\n  const res: PValue[] = new Array(response.data.length);\n  for (let i = 0; i < response.data.length; i++) {\n    res[i] = pTableValue(response, i) as PValue;\n  }\n  return res;\n}\n\nfunction createSearchFilter(\n  columnId: PObjectId,\n  substring: string,\n): PTableRecordSingleValueFilterV2 {\n  return {\n    type: \"bySingleColumnV2\",\n    column: {\n      type: \"column\",\n      id: columnId,\n    },\n    predicate: {\n      operator: \"StringIContains\",\n      substring,\n    },\n  };\n}\n\nfunction createAxisSearchFilter(\n  axisSpec: AxisSpec,\n  substring: string,\n): PTableRecordSingleValueFilterV2 {\n  return {\n    type: \"bySingleColumnV2\",\n    column: {\n      type: \"axis\",\n      id: {\n        type: axisSpec.type,\n        name: axisSpec.name,\n      },\n    },\n    predicate: {\n      operator: \"StringIContains\",\n      substring,\n    },\n  };\n}\n\nfunction mapValuesToSuggestions(values: string[]): { value: string; label: string }[] {\n  return values.map((v) => ({ value: String(v), label: String(v) })).sort(sortValuesPredicate);\n}\n\nfunction getPFrameDriver() {\n  if (typeof platforma === \"undefined\") {\n    throw new Error(\"Platforma instance is not available\");\n  }\n  if (typeof platforma.pFrameDriver === \"undefined\") {\n    throw new Error(\"PFrame driver is not available in the current Platforma instance\");\n  }\n  return platforma.pFrameDriver;\n}\n\n// Core functions\nexport async function getColumnSpecById(\n  handle: PFrameHandle,\n  id: PObjectId,\n): Promise<PColumnSpec | null> {\n  try {\n    const response = await getPFrameDriver().getColumnSpec(handle, id);\n    return response ?? null;\n  } catch (err) {\n    console.error(\"PFrame: get single column error\", err);\n    return null;\n  }\n}\n\nexport async function getSingleColumnData(\n  handle: PFrameHandle,\n  id: PObjectId,\n  filters: PTableRecordSingleValueFilterV2[] = [],\n): Promise<SingleColumnData> {\n  try {\n    const response: FullPTableColumnData[] = await getPFrameDriver().calculateTableData(handle, {\n      src: {\n        type: \"column\",\n        column: id,\n      },\n      filters,\n      sorting: [],\n    } as CalculateTableDataRequest<PObjectId>);\n\n    const axes = response.filter((item) => item.spec.type === \"axis\");\n    const columns = response.filter((item) => item.spec.type === \"column\");\n\n    return {\n      axesData: axes.reduce((res: Record<string, PValue[]>, item) => {\n        const id = getAxisId(item.spec.spec as AxisSpec);\n        res[canonicalizeAxisId(id)] = convertColumnData(id.type, item.data);\n        return res;\n      }, {}),\n      data: columns.length ? convertColumnData(columns[0].data.type, columns[0].data) : [],\n    };\n  } catch (err) {\n    console.error(\"PFrame: calculateTableData error\");\n    throw err;\n  }\n}\n\nexport async function getColumnUniqueValues(\n  handle: PFrameHandle,\n  id: PObjectId,\n  limit = UNIQUE_VALUES_LIMIT,\n  filters: PTableRecordSingleValueFilterV2[] = [],\n): Promise<UniqueValuesResponse> {\n  const request: UniqueValuesRequest = {\n    columnId: id,\n    filters,\n    limit,\n  };\n\n  try {\n    const response = await getPFrameDriver().getUniqueValues(handle, request);\n    if (response.overflow) {\n      console.warn(`More than ${limit} values for ${id} column`);\n    }\n    return {\n      values: Array.from(response.values.data as ArrayLike<unknown>).map(String),\n      overflow: response.overflow,\n    };\n  } catch (err) {\n    console.error(\"PFrame: getUniqueValues for column error\");\n    throw err;\n  }\n}\n\nexport async function getAxisUniqueValues(\n  handle: PFrameHandle,\n  params: GetAxisUniqueValuesParams,\n): Promise<UniqueValuesResponse> {\n  const { axisId, parentColumnIds, limit = UNIQUE_VALUES_LIMIT, filters = [] } = params;\n  const strAxisId = canonicalizeAxisId(axisId);\n\n  const parentsSpecs = (await Promise.all(parentColumnIds.map((p) => getColumnSpecById(handle, p))))\n    .flatMap((spec, i): [PObjectId, PColumnSpec][] =>\n      spec != null && spec.kind === \"PColumn\" ? [[parentColumnIds[i], spec]] : [],\n    )\n    .filter(([_, spec]) =>\n      spec.axesSpec.some((axisSpec) => canonicalizeAxisId(getAxisId(axisSpec)) === strAxisId),\n    );\n\n  if (parentsSpecs.length === 0) {\n    console.warn(\"Axis unique values requested without parent columns\");\n    return { values: [], overflow: false };\n  }\n\n  try {\n    const responses = await Promise.all(\n      parentsSpecs.map(([id]) =>\n        getPFrameDriver().getUniqueValues(handle, {\n          columnId: id,\n          axis: axisId,\n          filters,\n          limit,\n        }),\n      ),\n    );\n\n    const overflow = responses.some((r) => r.overflow);\n    return {\n      values: uniq(\n        flatten(responses.map((r) => Array.from(r.values.data as ArrayLike<unknown>).map(String))),\n      ),\n      overflow,\n    };\n  } catch (err) {\n    console.error(\"PFrame: getUniqueValues for axis error\", err);\n    return { values: [], overflow: false };\n  }\n}\n\nexport async function getRequestColumnsFromSelectedSources(\n  handle: PFrameHandle,\n  sources: PObjectId[],\n): Promise<AxisId[]> {\n  const result: AxisId[] = [];\n  for (const item of sources) {\n    const spec = await getColumnSpecById(handle, item);\n    if (spec?.kind === \"PColumn\") {\n      result.push(...spec.axesSpec.map((spec) => getAxisId(spec)));\n    }\n  }\n  return result;\n}\n\nexport async function getColumnsFull(\n  handle: PFrameHandle,\n  params: GetColumnsFullParams,\n): Promise<PColumnIdAndSpec[]> {\n  const { selectedSources, strictlyCompatible, types, names, annotations, annotationsNotEmpty } =\n    params;\n\n  try {\n    const request: FindColumnsRequest = {\n      columnFilter: {\n        type: types,\n        name: names,\n        annotationValue: annotations,\n        annotationPattern: annotationsNotEmpty?.reduce(\n          (res, v) => {\n            res[v] = \".+\";\n            return res;\n          },\n          {} as Record<string, string>,\n        ),\n      },\n      compatibleWith: await getRequestColumnsFromSelectedSources(handle, selectedSources),\n      strictlyCompatible,\n    };\n\n    const response: FindColumnsResponse = await getPFrameDriver().findColumns(handle, request);\n    return response.hits;\n  } catch (err) {\n    console.error(\"PFrame: findColumns error\");\n    throw err;\n  }\n}\n\nexport async function getColumnOrAxisValueLabelsId(\n  handle: PFrameHandle,\n  strAxisId: CanonicalizedJson<AxisId>,\n): Promise<PObjectId | undefined> {\n  const labelColumns = await getColumnsFull(handle, {\n    selectedSources: [],\n    strictlyCompatible: false,\n    names: [PColumnName.Label],\n  });\n\n  const labelColumn = labelColumns.find(({ spec }) => {\n    return spec && spec.axesSpec.length === 1 && canonicalizeAxisId(spec.axesSpec[0]) === strAxisId;\n  });\n\n  return labelColumn?.columnId;\n}\n\nfunction getDiscreteValuesFromAnnotation(columnSpec: PColumnSpec): undefined | SuggestionResponse {\n  const discreteValuesStr = readAnnotation(columnSpec, Annotation.DiscreteValues);\n  if (!discreteValuesStr) {\n    return undefined;\n  }\n\n  try {\n    const discreteValues: string[] = (JSON.parse(discreteValuesStr) as (string | number)[]).map(\n      (v) => String(v),\n    );\n    const values = discreteValues.map((v) => ({ value: v, label: v })).sort(sortValuesPredicate);\n    return { values, overflow: false };\n  } catch {\n    console.error(`Parsing error: discrete values annotation ${discreteValuesStr}`);\n    return undefined;\n  }\n}\n\nasync function getAxisValuesWithLabels(\n  handle: PFrameHandle,\n  params: {\n    columnId: PObjectId;\n    axisSpec: AxisSpec;\n    labelsColumnId: PObjectId | undefined;\n    limit?: number;\n    searchQuery?: string;\n    searchQueryValue?: string;\n  },\n): Promise<SuggestionResponse> {\n  const { columnId, axisSpec, labelsColumnId, limit, searchQuery, searchQueryValue } = params;\n  const strAxisId = canonicalizeAxisId(getAxisId(axisSpec));\n\n  let filters: PTableRecordSingleValueFilterV2[] = [];\n\n  if (labelsColumnId) {\n    if (searchQuery) {\n      filters = [createSearchFilter(labelsColumnId, searchQuery)];\n    }\n    if (searchQueryValue) {\n      filters = [createAxisSearchFilter(axisSpec, searchQueryValue)];\n    }\n\n    const { data: dataValues, axesData } = await getSingleColumnData(\n      handle,\n      labelsColumnId,\n      filters,\n    );\n    const axisKeys = axesData[strAxisId];\n    const values: { value: string; label: string }[] = [];\n\n    for (let i = 0; i < Math.min(axisKeys.length, limit ?? axisKeys.length); i++) {\n      values.push({ value: String(axisKeys[i]), label: String(dataValues[i]) });\n    }\n\n    values.sort(sortValuesPredicate);\n    return { values, overflow: !(limit === undefined || axisKeys.length < limit) };\n  } else {\n    const searchInLabelsOrValue = searchQuery ?? searchQueryValue;\n    if (searchInLabelsOrValue) {\n      filters = [createAxisSearchFilter(axisSpec, searchInLabelsOrValue)];\n    }\n\n    const response = await getAxisUniqueValues(handle, {\n      axisId: getAxisId(axisSpec),\n      parentColumnIds: [columnId],\n      limit,\n      filters,\n    });\n\n    const values = mapValuesToSuggestions(response.values);\n    return { values, overflow: response.overflow };\n  }\n}\n\nasync function getColumnValuesWithLabels(\n  handle: PFrameHandle,\n  params: {\n    columnId: PObjectId;\n    limit?: number;\n    searchQuery?: string;\n    searchQueryValue?: string;\n  },\n): Promise<SuggestionResponse> {\n  const { columnId, limit, searchQuery, searchQueryValue } = params;\n  const searchInLabelsOrValue = searchQuery ?? searchQueryValue;\n\n  const filters: PTableRecordSingleValueFilterV2[] = searchInLabelsOrValue\n    ? [createSearchFilter(columnId, searchInLabelsOrValue)]\n    : [];\n\n  const response = await getColumnUniqueValues(handle, columnId, limit, filters);\n  const values = mapValuesToSuggestions(response.values);\n  return { values, overflow: response.overflow };\n}\n\nexport async function getUniqueSourceValuesWithLabels(\n  handle: PFrameHandle,\n  params: GetUniqueSourceValuesParams,\n): Promise<SuggestionResponse> {\n  const { columnId, axisIdx, limit, searchQuery, searchQueryValue } = params;\n\n  const selectedSourceSpec = await getColumnSpecById(handle, columnId);\n  if (selectedSourceSpec == null || selectedSourceSpec.kind !== \"PColumn\") {\n    return { values: [], overflow: false };\n  }\n\n  // Try to get discrete values from annotation\n  const discreteValues = getDiscreteValuesFromAnnotation(selectedSourceSpec);\n  if (discreteValues != null) {\n    return discreteValues;\n  }\n\n  // Handle axis values\n  if (axisIdx != null) {\n    const axisSpec = selectedSourceSpec.axesSpec[axisIdx];\n    const strAxisId = canonicalizeAxisId(getAxisId(axisSpec));\n    const labelsColumnId = await getColumnOrAxisValueLabelsId(handle, strAxisId);\n\n    return getAxisValuesWithLabels(handle, {\n      columnId,\n      axisSpec,\n      labelsColumnId,\n      limit,\n      searchQuery,\n      searchQueryValue,\n    });\n  }\n\n  // Handle column values\n  return getColumnValuesWithLabels(handle, {\n    columnId,\n    limit,\n    searchQuery,\n    searchQueryValue,\n  });\n}\n"],"mappings":";;;;AA4EA,MAAM,sBAAsB;AAG5B,MAAM,uBAAuB,GAAsB,MACjD,EAAE,MAAM,cAAc,EAAE,OAAO,MAAM,EAAE,SAAS,KAAK,CAAC;AAExD,SAAS,kBAAkB,MAAiB,UAAkC;CAC5E,IAAI,SAAS,UACX,OAAO,SAAS;CAElB,MAAM,MAAgB,IAAI,MAAM,SAAS,KAAK,MAAM;CACpD,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,KAAK,QAAQ,KACxC,IAAI,KAAK,YAAY,UAAU,CAAC;CAElC,OAAO;AACT;AAEA,SAAS,mBACP,UACA,WACiC;CACjC,OAAO;EACL,MAAM;EACN,QAAQ;GACN,MAAM;GACN,IAAI;EACN;EACA,WAAW;GACT,UAAU;GACV;EACF;CACF;AACF;AAEA,SAAS,uBACP,UACA,WACiC;CACjC,OAAO;EACL,MAAM;EACN,QAAQ;GACN,MAAM;GACN,IAAI;IACF,MAAM,SAAS;IACf,MAAM,SAAS;GACjB;EACF;EACA,WAAW;GACT,UAAU;GACV;EACF;CACF;AACF;AAEA,SAAS,uBAAuB,QAAsD;CACpF,OAAO,OAAO,KAAK,OAAO;EAAE,OAAO,OAAO,CAAC;EAAG,OAAO,OAAO,CAAC;CAAE,EAAE,CAAC,CAAC,KAAK,mBAAmB;AAC7F;AAEA,SAAS,kBAAkB;CACzB,IAAI,OAAO,cAAc,aACvB,MAAM,IAAI,MAAM,qCAAqC;CAEvD,IAAI,OAAO,UAAU,iBAAiB,aACpC,MAAM,IAAI,MAAM,kEAAkE;CAEpF,OAAO,UAAU;AACnB;AAGA,eAAsB,kBACpB,QACA,IAC6B;CAC7B,IAAI;EAEF,OAAO,MADgB,gBAAgB,CAAC,CAAC,cAAc,QAAQ,EAAE,KAC9C;CACrB,SAAS,KAAK;EACZ,QAAQ,MAAM,mCAAmC,GAAG;EACpD,OAAO;CACT;AACF;AAEA,eAAsB,oBACpB,QACA,IACA,UAA6C,CAAC,GACnB;CAC3B,IAAI;EACF,MAAM,WAAmC,MAAM,gBAAgB,CAAC,CAAC,mBAAmB,QAAQ;GAC1F,KAAK;IACH,MAAM;IACN,QAAQ;GACV;GACA;GACA,SAAS,CAAC;EACZ,CAAyC;EAEzC,MAAM,OAAO,SAAS,QAAQ,SAAS,KAAK,KAAK,SAAS,MAAM;EAChE,MAAM,UAAU,SAAS,QAAQ,SAAS,KAAK,KAAK,SAAS,QAAQ;EAErE,OAAO;GACL,UAAU,KAAK,QAAQ,KAA+B,SAAS;IAC7D,MAAM,KAAK,UAAU,KAAK,KAAK,IAAgB;IAC/C,IAAI,mBAAmB,EAAE,KAAK,kBAAkB,GAAG,MAAM,KAAK,IAAI;IAClE,OAAO;GACT,GAAG,CAAC,CAAC;GACL,MAAM,QAAQ,SAAS,kBAAkB,QAAQ,EAAE,CAAC,KAAK,MAAM,QAAQ,EAAE,CAAC,IAAI,IAAI,CAAC;EACrF;CACF,SAAS,KAAK;EACZ,QAAQ,MAAM,kCAAkC;EAChD,MAAM;CACR;AACF;AAEA,eAAsB,sBACpB,QACA,IACA,QAAQ,qBACR,UAA6C,CAAC,GACf;CAC/B,MAAM,UAA+B;EACnC,UAAU;EACV;EACA;CACF;CAEA,IAAI;EACF,MAAM,WAAW,MAAM,gBAAgB,CAAC,CAAC,gBAAgB,QAAQ,OAAO;EACxE,IAAI,SAAS,UACX,QAAQ,KAAK,aAAa,MAAM,cAAc,GAAG,QAAQ;EAE3D,OAAO;GACL,QAAQ,MAAM,KAAK,SAAS,OAAO,IAA0B,CAAC,CAAC,IAAI,MAAM;GACzE,UAAU,SAAS;EACrB;CACF,SAAS,KAAK;EACZ,QAAQ,MAAM,0CAA0C;EACxD,MAAM;CACR;AACF;AAEA,eAAsB,oBACpB,QACA,QAC+B;CAC/B,MAAM,EAAE,QAAQ,iBAAiB,QAAQ,qBAAqB,UAAU,CAAC,MAAM;CAC/E,MAAM,YAAY,mBAAmB,MAAM;CAE3C,MAAM,gBAAgB,MAAM,QAAQ,IAAI,gBAAgB,KAAK,MAAM,kBAAkB,QAAQ,CAAC,CAAC,CAAC,EAAA,CAC7F,SAAS,MAAM,MACd,QAAQ,QAAQ,KAAK,SAAS,YAAY,CAAC,CAAC,gBAAgB,IAAI,IAAI,CAAC,IAAI,CAAC,CAC5E,CAAC,CACA,QAAQ,CAAC,GAAG,UACX,KAAK,SAAS,MAAM,aAAa,mBAAmB,UAAU,QAAQ,CAAC,MAAM,SAAS,CACxF;CAEF,IAAI,aAAa,WAAW,GAAG;EAC7B,QAAQ,KAAK,qDAAqD;EAClE,OAAO;GAAE,QAAQ,CAAC;GAAG,UAAU;EAAM;CACvC;CAEA,IAAI;EACF,MAAM,YAAY,MAAM,QAAQ,IAC9B,aAAa,KAAK,CAAC,QACjB,gBAAgB,CAAC,CAAC,gBAAgB,QAAQ;GACxC,UAAU;GACV,MAAM;GACN;GACA;EACF,CAAC,CACH,CACF;EAEA,MAAM,WAAW,UAAU,MAAM,MAAM,EAAE,QAAQ;EACjD,OAAO;GACL,QAAQ,KACN,QAAQ,UAAU,KAAK,MAAM,MAAM,KAAK,EAAE,OAAO,IAA0B,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAC3F;GACA;EACF;CACF,SAAS,KAAK;EACZ,QAAQ,MAAM,0CAA0C,GAAG;EAC3D,OAAO;GAAE,QAAQ,CAAC;GAAG,UAAU;EAAM;CACvC;AACF;AAEA,eAAsB,qCACpB,QACA,SACmB;CACnB,MAAM,SAAmB,CAAC;CAC1B,KAAK,MAAM,QAAQ,SAAS;EAC1B,MAAM,OAAO,MAAM,kBAAkB,QAAQ,IAAI;EACjD,IAAI,MAAM,SAAS,WACjB,OAAO,KAAK,GAAG,KAAK,SAAS,KAAK,SAAS,UAAU,IAAI,CAAC,CAAC;CAE/D;CACA,OAAO;AACT;AAEA,eAAsB,eACpB,QACA,QAC6B;CAC7B,MAAM,EAAE,iBAAiB,oBAAoB,OAAO,OAAO,aAAa,wBACtE;CAEF,IAAI;EACF,MAAM,UAA8B;GAClC,cAAc;IACZ,MAAM;IACN,MAAM;IACN,iBAAiB;IACjB,mBAAmB,qBAAqB,QACrC,KAAK,MAAM;KACV,IAAI,KAAK;KACT,OAAO;IACT,GACA,CAAC,CACH;GACF;GACA,gBAAgB,MAAM,qCAAqC,QAAQ,eAAe;GAClF;EACF;EAGA,QAAO,MADqC,gBAAgB,CAAC,CAAC,YAAY,QAAQ,OAAO,EAAA,CACzE;CAClB,SAAS,KAAK;EACZ,QAAQ,MAAM,2BAA2B;EACzC,MAAM;CACR;AACF;AAEA,eAAsB,6BACpB,QACA,WACgC;CAWhC,QAJoB,MANO,eAAe,QAAQ;EAChD,iBAAiB,CAAC;EAClB,oBAAoB;EACpB,OAAO,CAAC,YAAY,KAAK;CAC3B,CAAC,EAAA,CAEgC,MAAM,EAAE,WAAW;EAClD,OAAO,QAAQ,KAAK,SAAS,WAAW,KAAK,mBAAmB,KAAK,SAAS,EAAE,MAAM;CACxF,CAEiB,CAAC,EAAE;AACtB;AAEA,SAAS,gCAAgC,YAAyD;CAChG,MAAM,oBAAoB,eAAe,YAAY,WAAW,cAAc;CAC9E,IAAI,CAAC,mBACH;CAGF,IAAI;EAKF,OAAO;GAAE,QAJyB,KAAK,MAAM,iBAAiB,CAAC,CAAyB,KACrF,MAAM,OAAO,CAAC,CAEW,CAAC,CAAC,KAAK,OAAO;IAAE,OAAO;IAAG,OAAO;GAAE,EAAE,CAAC,CAAC,KAAK,mBAC1D;GAAG,UAAU;EAAM;CACnC,QAAQ;EACN,QAAQ,MAAM,6CAA6C,mBAAmB;EAC9E;CACF;AACF;AAEA,eAAe,wBACb,QACA,QAQ6B;CAC7B,MAAM,EAAE,UAAU,UAAU,gBAAgB,OAAO,aAAa,qBAAqB;CACrF,MAAM,YAAY,mBAAmB,UAAU,QAAQ,CAAC;CAExD,IAAI,UAA6C,CAAC;CAElD,IAAI,gBAAgB;EAClB,IAAI,aACF,UAAU,CAAC,mBAAmB,gBAAgB,WAAW,CAAC;EAE5D,IAAI,kBACF,UAAU,CAAC,uBAAuB,UAAU,gBAAgB,CAAC;EAG/D,MAAM,EAAE,MAAM,YAAY,aAAa,MAAM,oBAC3C,QACA,gBACA,OACF;EACA,MAAM,WAAW,SAAS;EAC1B,MAAM,SAA6C,CAAC;EAEpD,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,IAAI,SAAS,QAAQ,SAAS,SAAS,MAAM,GAAG,KACvE,OAAO,KAAK;GAAE,OAAO,OAAO,SAAS,EAAE;GAAG,OAAO,OAAO,WAAW,EAAE;EAAE,CAAC;EAG1E,OAAO,KAAK,mBAAmB;EAC/B,OAAO;GAAE;GAAQ,UAAU,EAAE,UAAU,KAAA,KAAa,SAAS,SAAS;EAAO;CAC/E,OAAO;EACL,MAAM,wBAAwB,eAAe;EAC7C,IAAI,uBACF,UAAU,CAAC,uBAAuB,UAAU,qBAAqB,CAAC;EAGpE,MAAM,WAAW,MAAM,oBAAoB,QAAQ;GACjD,QAAQ,UAAU,QAAQ;GAC1B,iBAAiB,CAAC,QAAQ;GAC1B;GACA;EACF,CAAC;EAGD,OAAO;GAAE,QADM,uBAAuB,SAAS,MACjC;GAAG,UAAU,SAAS;EAAS;CAC/C;AACF;AAEA,eAAe,0BACb,QACA,QAM6B;CAC7B,MAAM,EAAE,UAAU,OAAO,aAAa,qBAAqB;CAC3D,MAAM,wBAAwB,eAAe;CAM7C,MAAM,WAAW,MAAM,sBAAsB,QAAQ,UAAU,OAJZ,wBAC/C,CAAC,mBAAmB,UAAU,qBAAqB,CAAC,IACpD,CAAC,CAEwE;CAE7E,OAAO;EAAE,QADM,uBAAuB,SAAS,MACjC;EAAG,UAAU,SAAS;CAAS;AAC/C;AAEA,eAAsB,gCACpB,QACA,QAC6B;CAC7B,MAAM,EAAE,UAAU,SAAS,OAAO,aAAa,qBAAqB;CAEpE,MAAM,qBAAqB,MAAM,kBAAkB,QAAQ,QAAQ;CACnE,IAAI,sBAAsB,QAAQ,mBAAmB,SAAS,WAC5D,OAAO;EAAE,QAAQ,CAAC;EAAG,UAAU;CAAM;CAIvC,MAAM,iBAAiB,gCAAgC,kBAAkB;CACzE,IAAI,kBAAkB,MACpB,OAAO;CAIT,IAAI,WAAW,MAAM;EACnB,MAAM,WAAW,mBAAmB,SAAS;EAI7C,OAAO,wBAAwB,QAAQ;GACrC;GACA;GACA,gBAAA,MAL2B,6BAA6B,QADxC,mBAAmB,UAAU,QAAQ,CACmB,CAAC;GAMzE;GACA;GACA;EACF,CAAC;CACH;CAGA,OAAO,0BAA0B,QAAQ;EACvC;EACA;EACA;EACA;CACF,CAAC;AACH"}

package/dist/platforma.d.ts.map

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

package/dist/plugin_handle.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin_handle.cjs","names":[],"sources":["../src/plugin_handle.ts"],"sourcesContent":["/**\n * PluginHandle — Opaque branded handle and output key utilities for plugin instances.\n *\n * Extracted into its own module to break circular dependencies:\n * both block_storage.ts and plugin_model.ts can import from here\n * without depending on each other.\n *\n * @module plugin_handle\n */\n\nimport type { Branded } from \"@milaboratories/helpers\";\n\n/**\n * Phantom-only base type for constraining PluginHandle's type parameter.\n *\n * PluginFactory has create() → PluginInstance with function properties, making it invariant\n * under strictFunctionTypes. PluginFactoryLike exposes only the covariant `__types` phantom,\n * avoiding the contravariance chain. Handles only need `__types` for type extraction.\n *\n * PluginFactory extends PluginFactoryLike, so every concrete factory satisfies this constraint.\n */\nexport interface PluginFactoryLike<\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>,\n  Outputs extends Record<string, unknown> = Record<string, unknown>,\n  ModelServices = unknown,\n  UiServices = unknown,\n> {\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n    modelServices: ModelServices;\n    uiServices: UiServices;\n  };\n}\n\n/** Extract the Data type from a PluginFactoryLike phantom. */\nexport type InferFactoryData<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer D, any, any, any, any> ? D : Record<string, unknown>\n>;\n\n/** Extract the Params type from a PluginFactoryLike phantom. */\nexport type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, infer P, any, any, any> ? P : undefined\n>;\n\n/** Extract the Outputs type from a PluginFactoryLike phantom. */\nexport type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, any, infer O, any, any> ? O : Record<string, unknown>\n>;\n\n/** Extract the pre-resolved model services type from a PluginFactoryLike phantom. */\nexport type InferFactoryModelServices<F extends PluginFactoryLike> =\n  F extends PluginFactoryLike<any, any, any, infer ModelServices, any> ? ModelServices : {};\n\n/** Extract the pre-resolved UI services type from a PluginFactoryLike phantom. */\nexport type InferFactoryUiServices<F extends PluginFactoryLike> =\n  F extends PluginFactoryLike<any, any, any, any, infer UiServices> ? UiServices : {};\n\n/**\n * Derive a typed PluginHandle from a PluginFactory type.\n * Normalizes the brand to data/params/outputs/services (strips config) so handles\n * from InferPluginUiEntries match handles from InferPluginHandle.\n */\nexport type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<\n    infer Data,\n    infer Params,\n    infer Outputs,\n    infer ModelServices,\n    infer UiServices\n  >\n    ? PluginHandle<PluginFactoryLike<Data, Params, Outputs, ModelServices, UiServices>>\n    : PluginHandle\n>;\n\n/**\n * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.\n * Branded with factory phantom `F` for type-safe data/outputs extraction.\n * Constrained with PluginFactoryLike (not PluginFactory) to avoid variance issues.\n */\nexport type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;\n\nconst PLUGIN_OUTPUT_PREFIX = \"plugin-output#\";\n\n/** Construct the output key for a plugin output in the block outputs map. */\nexport function pluginOutputKey<F extends PluginFactoryLike>(\n  handle: PluginHandle<F>,\n  outputKey: string,\n): string {\n  return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;\n}\n\n/** Check whether an output key belongs to a plugin (vs block-level output). */\nexport function isPluginOutputKey(key: string): boolean {\n  return key.startsWith(PLUGIN_OUTPUT_PREFIX);\n}\n\n/** Get the prefix used for all outputs of a specific plugin instance. */\nexport function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string {\n  return pluginOutputKey(handle, \"\");\n}\n"],"mappings":";AAoFA,MAAM,uBAAuB;;AAG7B,SAAgB,gBACd,QACA,WACQ;AACR,QAAO,GAAG,uBAAuB,OAAO,GAAG;;;AAI7C,SAAgB,kBAAkB,KAAsB;AACtD,QAAO,IAAI,WAAW,qBAAqB;;;AAI7C,SAAgB,mBAAgD,QAAiC;AAC/F,QAAO,gBAAgB,QAAQ,GAAG"}
+{"version":3,"file":"plugin_handle.cjs","names":[],"sources":["../src/plugin_handle.ts"],"sourcesContent":["/**\n * PluginHandle — Opaque branded handle and output key utilities for plugin instances.\n *\n * Extracted into its own module to break circular dependencies:\n * both block_storage.ts and plugin_model.ts can import from here\n * without depending on each other.\n *\n * @module plugin_handle\n */\n\nimport type { Branded } from \"@milaboratories/helpers\";\n\n/**\n * Phantom-only base type for constraining PluginHandle's type parameter.\n *\n * PluginFactory has create() → PluginInstance with function properties, making it invariant\n * under strictFunctionTypes. PluginFactoryLike exposes only the covariant `__types` phantom,\n * avoiding the contravariance chain. Handles only need `__types` for type extraction.\n *\n * PluginFactory extends PluginFactoryLike, so every concrete factory satisfies this constraint.\n */\nexport interface PluginFactoryLike<\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>,\n  Outputs extends Record<string, unknown> = Record<string, unknown>,\n  ModelServices = unknown,\n  UiServices = unknown,\n> {\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n    modelServices: ModelServices;\n    uiServices: UiServices;\n  };\n}\n\n/** Extract the Data type from a PluginFactoryLike phantom. */\nexport type InferFactoryData<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer D, any, any, any, any> ? D : Record<string, unknown>\n>;\n\n/** Extract the Params type from a PluginFactoryLike phantom. */\nexport type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, infer P, any, any, any> ? P : undefined\n>;\n\n/** Extract the Outputs type from a PluginFactoryLike phantom. */\nexport type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, any, infer O, any, any> ? O : Record<string, unknown>\n>;\n\n/** Extract the pre-resolved model services type from a PluginFactoryLike phantom. */\nexport type InferFactoryModelServices<F extends PluginFactoryLike> =\n  F extends PluginFactoryLike<any, any, any, infer ModelServices, any> ? ModelServices : {};\n\n/** Extract the pre-resolved UI services type from a PluginFactoryLike phantom. */\nexport type InferFactoryUiServices<F extends PluginFactoryLike> =\n  F extends PluginFactoryLike<any, any, any, any, infer UiServices> ? UiServices : {};\n\n/**\n * Derive a typed PluginHandle from a PluginFactory type.\n * Normalizes the brand to data/params/outputs/services (strips config) so handles\n * from InferPluginUiEntries match handles from InferPluginHandle.\n */\nexport type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<\n    infer Data,\n    infer Params,\n    infer Outputs,\n    infer ModelServices,\n    infer UiServices\n  >\n    ? PluginHandle<PluginFactoryLike<Data, Params, Outputs, ModelServices, UiServices>>\n    : PluginHandle\n>;\n\n/**\n * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.\n * Branded with factory phantom `F` for type-safe data/outputs extraction.\n * Constrained with PluginFactoryLike (not PluginFactory) to avoid variance issues.\n */\nexport type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;\n\nconst PLUGIN_OUTPUT_PREFIX = \"plugin-output#\";\n\n/** Construct the output key for a plugin output in the block outputs map. */\nexport function pluginOutputKey<F extends PluginFactoryLike>(\n  handle: PluginHandle<F>,\n  outputKey: string,\n): string {\n  return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;\n}\n\n/** Check whether an output key belongs to a plugin (vs block-level output). */\nexport function isPluginOutputKey(key: string): boolean {\n  return key.startsWith(PLUGIN_OUTPUT_PREFIX);\n}\n\n/** Get the prefix used for all outputs of a specific plugin instance. */\nexport function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string {\n  return pluginOutputKey(handle, \"\");\n}\n"],"mappings":";AAoFA,MAAM,uBAAuB;;AAG7B,SAAgB,gBACd,QACA,WACQ;CACR,OAAO,GAAG,uBAAuB,OAAO,GAAG;AAC7C;;AAGA,SAAgB,kBAAkB,KAAsB;CACtD,OAAO,IAAI,WAAW,oBAAoB;AAC5C;;AAGA,SAAgB,mBAAgD,QAAiC;CAC/F,OAAO,gBAAgB,QAAQ,EAAE;AACnC"}

package/dist/plugin_handle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin_handle.d.ts","names":[],"sources":["../src/plugin_handle.ts"],"mappings":";;;;;;;;;;;;UAqBiB,iBAAA,cACF,MAAA,oBAA0B,MAAA,8CACZ,MAAA,gCAAsC,MAAA,mCACjD,MAAA,oBAA0B,MAAA;EAAA,SAIjC,OAAA;IACP,IAAA,EAAM,IAAA;IACN,MAAA,EAAQ,MAAA;IACR,OAAA,EAAS,OAAA;IACT,aAAA,EAAe,aAAA;IACf,UAAA,EAAY,UAAA;EAAA;AAAA;;KAKJ,gBAAA,WAA2B,iBAAA,IAAqB,WAAA,CAC1D,CAAA,SAAU,iBAAA,gCAAiD,CAAA,GAAI,MAAA;;KAIrD,kBAAA,WAA6B,iBAAA,IAAqB,WAAA,CAC5D,CAAA,SAAU,iBAAA,gCAAiD,CAAA;;KAIjD,mBAAA,WAA8B,iBAAA,IAAqB,WAAA,CAC7D,CAAA,SAAU,iBAAA,gCAAiD,CAAA,GAAI,MAAA;;KAIrD,yBAAA,WAAoC,iBAAA,IAC9C,CAAA,SAAU,iBAAA,4CAA6D,aAAA;;KAG7D,sBAAA,WAAiC,iBAAA,IAC3C,CAAA,SAAU,iBAAA,yCAA0D,UAAA;;;;;;KAO1D,iBAAA,WAA4B,iBAAA,IAAqB,WAAA,CAC3D,CAAA,SAAU,iBAAA,mFAON,YAAA,CAAa,iBAAA,CAAkB,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAS,aAAA,EAAe,UAAA,KACrE,YAAA;;;;;;KAQM,YAAA,WAAuB,iBAAA,GAAoB,iBAAA,IAAqB,OAAA,SAAgB,CAAA;;iBAK5E,eAAA,WAA0B,iBAAA,CAAA,CACxC,MAAA,EAAQ,YAAA,CAAa,CAAA,GACrB,SAAA;;iBAMc,iBAAA,CAAkB,GAAA;;iBAKlB,kBAAA,WAA6B,iBAAA,CAAA,CAAmB,MAAA,EAAQ,YAAA,CAAa,CAAA"}
+{"version":3,"file":"plugin_handle.d.ts","names":[],"sources":["../src/plugin_handle.ts"],"mappings":";;;;;;;;;;;;UAqBiB,iBAAA,cACF,MAAA,oBAA0B,MAAA,8CACZ,MAAA,gCAAsC,MAAA,mCACjD,MAAA,oBAA0B,MAAA;EAAA,SAIjC,OAAA;IACP,IAAA,EAAM,IAAA;IACN,MAAA,EAAQ,MAAA;IACR,OAAA,EAAS,OAAA;IACT,aAAA,EAAe,aAAA;IACf,UAAA,EAAY,UAAA;EAAA;AAAA;;KAKJ,gBAAA,WAA2B,iBAAA,IAAqB,WAAA,CAC1D,CAAA,SAAU,iBAAA,gCAAiD,CAAA,GAAI,MAAA;;KAIrD,kBAAA,WAA6B,iBAAA,IAAqB,WAAA,CAC5D,CAAA,SAAU,iBAAA,gCAAiD,CAAA;;KAIjD,mBAAA,WAA8B,iBAAA,IAAqB,WAAA,CAC7D,CAAA,SAAU,iBAAA,gCAAiD,CAAA,GAAI,MAAA;;KAIrD,yBAAA,WAAoC,iBAAA,IAC9C,CAAA,SAAU,iBAAA,4CAA6D,aAAA;;KAG7D,sBAAA,WAAiC,iBAAA,IAC3C,CAAA,SAAU,iBAAA,yCAA0D,UAAA;;;;;AAzB5C;KAgCd,iBAAA,WAA4B,iBAAA,IAAqB,WAAA,CAC3D,CAAA,SAAU,iBAAA,mFAON,YAAA,CAAa,iBAAA,CAAkB,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAS,aAAA,EAAe,UAAA,KACrE,YAAA;;;;;;KAQM,YAAA,WAAuB,iBAAA,GAAoB,iBAAA,IAAqB,OAAA,SAAgB,CAAA;;iBAK5E,eAAA,WAA0B,iBAAA,EACxC,MAAA,EAAQ,YAAA,CAAa,CAAA,GACrB,SAAA;;iBAMc,iBAAA,CAAkB,GAAW;;iBAK7B,kBAAA,WAA6B,iBAAA,EAAmB,MAAA,EAAQ,YAAA,CAAa,CAAA"}

package/dist/plugin_handle.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin_handle.js","names":[],"sources":["../src/plugin_handle.ts"],"sourcesContent":["/**\n * PluginHandle — Opaque branded handle and output key utilities for plugin instances.\n *\n * Extracted into its own module to break circular dependencies:\n * both block_storage.ts and plugin_model.ts can import from here\n * without depending on each other.\n *\n * @module plugin_handle\n */\n\nimport type { Branded } from \"@milaboratories/helpers\";\n\n/**\n * Phantom-only base type for constraining PluginHandle's type parameter.\n *\n * PluginFactory has create() → PluginInstance with function properties, making it invariant\n * under strictFunctionTypes. PluginFactoryLike exposes only the covariant `__types` phantom,\n * avoiding the contravariance chain. Handles only need `__types` for type extraction.\n *\n * PluginFactory extends PluginFactoryLike, so every concrete factory satisfies this constraint.\n */\nexport interface PluginFactoryLike<\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>,\n  Outputs extends Record<string, unknown> = Record<string, unknown>,\n  ModelServices = unknown,\n  UiServices = unknown,\n> {\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n    modelServices: ModelServices;\n    uiServices: UiServices;\n  };\n}\n\n/** Extract the Data type from a PluginFactoryLike phantom. */\nexport type InferFactoryData<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer D, any, any, any, any> ? D : Record<string, unknown>\n>;\n\n/** Extract the Params type from a PluginFactoryLike phantom. */\nexport type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, infer P, any, any, any> ? P : undefined\n>;\n\n/** Extract the Outputs type from a PluginFactoryLike phantom. */\nexport type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, any, infer O, any, any> ? O : Record<string, unknown>\n>;\n\n/** Extract the pre-resolved model services type from a PluginFactoryLike phantom. */\nexport type InferFactoryModelServices<F extends PluginFactoryLike> =\n  F extends PluginFactoryLike<any, any, any, infer ModelServices, any> ? ModelServices : {};\n\n/** Extract the pre-resolved UI services type from a PluginFactoryLike phantom. */\nexport type InferFactoryUiServices<F extends PluginFactoryLike> =\n  F extends PluginFactoryLike<any, any, any, any, infer UiServices> ? UiServices : {};\n\n/**\n * Derive a typed PluginHandle from a PluginFactory type.\n * Normalizes the brand to data/params/outputs/services (strips config) so handles\n * from InferPluginUiEntries match handles from InferPluginHandle.\n */\nexport type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<\n    infer Data,\n    infer Params,\n    infer Outputs,\n    infer ModelServices,\n    infer UiServices\n  >\n    ? PluginHandle<PluginFactoryLike<Data, Params, Outputs, ModelServices, UiServices>>\n    : PluginHandle\n>;\n\n/**\n * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.\n * Branded with factory phantom `F` for type-safe data/outputs extraction.\n * Constrained with PluginFactoryLike (not PluginFactory) to avoid variance issues.\n */\nexport type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;\n\nconst PLUGIN_OUTPUT_PREFIX = \"plugin-output#\";\n\n/** Construct the output key for a plugin output in the block outputs map. */\nexport function pluginOutputKey<F extends PluginFactoryLike>(\n  handle: PluginHandle<F>,\n  outputKey: string,\n): string {\n  return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;\n}\n\n/** Check whether an output key belongs to a plugin (vs block-level output). */\nexport function isPluginOutputKey(key: string): boolean {\n  return key.startsWith(PLUGIN_OUTPUT_PREFIX);\n}\n\n/** Get the prefix used for all outputs of a specific plugin instance. */\nexport function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string {\n  return pluginOutputKey(handle, \"\");\n}\n"],"mappings":";AAoFA,MAAM,uBAAuB;;AAG7B,SAAgB,gBACd,QACA,WACQ;AACR,QAAO,GAAG,uBAAuB,OAAO,GAAG;;;AAI7C,SAAgB,kBAAkB,KAAsB;AACtD,QAAO,IAAI,WAAW,qBAAqB;;;AAI7C,SAAgB,mBAAgD,QAAiC;AAC/F,QAAO,gBAAgB,QAAQ,GAAG"}
+{"version":3,"file":"plugin_handle.js","names":[],"sources":["../src/plugin_handle.ts"],"sourcesContent":["/**\n * PluginHandle — Opaque branded handle and output key utilities for plugin instances.\n *\n * Extracted into its own module to break circular dependencies:\n * both block_storage.ts and plugin_model.ts can import from here\n * without depending on each other.\n *\n * @module plugin_handle\n */\n\nimport type { Branded } from \"@milaboratories/helpers\";\n\n/**\n * Phantom-only base type for constraining PluginHandle's type parameter.\n *\n * PluginFactory has create() → PluginInstance with function properties, making it invariant\n * under strictFunctionTypes. PluginFactoryLike exposes only the covariant `__types` phantom,\n * avoiding the contravariance chain. Handles only need `__types` for type extraction.\n *\n * PluginFactory extends PluginFactoryLike, so every concrete factory satisfies this constraint.\n */\nexport interface PluginFactoryLike<\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>,\n  Outputs extends Record<string, unknown> = Record<string, unknown>,\n  ModelServices = unknown,\n  UiServices = unknown,\n> {\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n    modelServices: ModelServices;\n    uiServices: UiServices;\n  };\n}\n\n/** Extract the Data type from a PluginFactoryLike phantom. */\nexport type InferFactoryData<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer D, any, any, any, any> ? D : Record<string, unknown>\n>;\n\n/** Extract the Params type from a PluginFactoryLike phantom. */\nexport type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, infer P, any, any, any> ? P : undefined\n>;\n\n/** Extract the Outputs type from a PluginFactoryLike phantom. */\nexport type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, any, infer O, any, any> ? O : Record<string, unknown>\n>;\n\n/** Extract the pre-resolved model services type from a PluginFactoryLike phantom. */\nexport type InferFactoryModelServices<F extends PluginFactoryLike> =\n  F extends PluginFactoryLike<any, any, any, infer ModelServices, any> ? ModelServices : {};\n\n/** Extract the pre-resolved UI services type from a PluginFactoryLike phantom. */\nexport type InferFactoryUiServices<F extends PluginFactoryLike> =\n  F extends PluginFactoryLike<any, any, any, any, infer UiServices> ? UiServices : {};\n\n/**\n * Derive a typed PluginHandle from a PluginFactory type.\n * Normalizes the brand to data/params/outputs/services (strips config) so handles\n * from InferPluginUiEntries match handles from InferPluginHandle.\n */\nexport type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<\n    infer Data,\n    infer Params,\n    infer Outputs,\n    infer ModelServices,\n    infer UiServices\n  >\n    ? PluginHandle<PluginFactoryLike<Data, Params, Outputs, ModelServices, UiServices>>\n    : PluginHandle\n>;\n\n/**\n * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.\n * Branded with factory phantom `F` for type-safe data/outputs extraction.\n * Constrained with PluginFactoryLike (not PluginFactory) to avoid variance issues.\n */\nexport type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;\n\nconst PLUGIN_OUTPUT_PREFIX = \"plugin-output#\";\n\n/** Construct the output key for a plugin output in the block outputs map. */\nexport function pluginOutputKey<F extends PluginFactoryLike>(\n  handle: PluginHandle<F>,\n  outputKey: string,\n): string {\n  return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;\n}\n\n/** Check whether an output key belongs to a plugin (vs block-level output). */\nexport function isPluginOutputKey(key: string): boolean {\n  return key.startsWith(PLUGIN_OUTPUT_PREFIX);\n}\n\n/** Get the prefix used for all outputs of a specific plugin instance. */\nexport function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string {\n  return pluginOutputKey(handle, \"\");\n}\n"],"mappings":";AAoFA,MAAM,uBAAuB;;AAG7B,SAAgB,gBACd,QACA,WACQ;CACR,OAAO,GAAG,uBAAuB,OAAO,GAAG;AAC7C;;AAGA,SAAgB,kBAAkB,KAAsB;CACtD,OAAO,IAAI,WAAW,oBAAoB;AAC5C;;AAGA,SAAgB,mBAAgD,QAAiC;CAC/F,OAAO,gBAAgB,QAAQ,EAAE;AACnC"}

package/dist/plugin_model.cjs

@@ -61,6 +61,7 @@ var PluginDataModelBuilder = class {
 * No .upgradeLegacy() — that is only available on the initial chain.
 */
 var PluginDataModelChain = class PluginDataModelChain {
+	state;
 	constructor(state) {
 		this.state = state;
 	}
@@ -132,6 +133,7 @@ var PluginDataModelInitialChain = class PluginDataModelInitialChain extends Plug
 * Chain after .recover() — supports .migrate(), .init(). No second recover().
 */
 var PluginDataModelWithRecover = class PluginDataModelWithRecover {
+	state;
 	constructor(state) {
 		this.state = state;
 	}
@@ -435,6 +437,9 @@ var PluginModelInitialBuilder = class PluginModelInitialBuilder extends PluginMo
 exports.CREATE_PLUGIN_MODEL = CREATE_PLUGIN_MODEL;
 exports.PluginDataModel = PluginDataModel;
 exports.PluginDataModelBuilder = PluginDataModelBuilder;
+exports.PluginDataModelChain = PluginDataModelChain;
+exports.PluginDataModelInitialChain = PluginDataModelInitialChain;
+exports.PluginDataModelWithRecover = PluginDataModelWithRecover;
 exports.PluginInstance = PluginInstance;
 exports.PluginModel = PluginModel;