{"version":3,"file":"column_values.cjs","names":["getCfgRenderCtx","createColumnValueId","ColumnRecipe","extractPObjectId","isPColumn","finalizePColumnData"],"sources":["../../src/columns/column_values.ts"],"sourcesContent":["import {\n  createColumnValueId,\n  extractPObjectId,\n  isPColumn,\n  type ColumnUniversalId,\n  type ColumnValueId,\n  type PColumn,\n  type PFrameHandle,\n  type PObjectId,\n} from \"@milaboratories/pl-model-common\";\nimport { finalizePColumnData } from \"../render/api\";\nimport type { GlobalCfgRenderCtx, PColumnDataUniversal } from \"../render/internal\";\nimport { getCfgRenderCtx } from \"../internal\";\nimport { ColumnRecipe } from \"./column_recipes\";\nimport type { ColumnResolutionStatus } from \"./column_recipes/types\";\nimport type { DataColumnRecipe } from \"./data_column\";\n\n/** Drop-down option for a value of a column — column-value-id valued. */\nexport type ColumnValueOption = {\n  readonly value: ColumnValueId;\n  readonly label: string;\n};\n\n/** A column a value picker offers the values of, or labels them by. */\nexport type ColumnValueOptionsColumn =\n  | ColumnUniversalId\n  | PColumn<undefined | PColumnDataUniversal>\n  | DataColumnRecipe\n  | ColumnRecipe;\n\n/**\n * What a UI reads the options of a value picker from: a frame holding the value column, and the\n * label column while there is one, as long as the value column is there. `valueColumn` is the\n * column the options are values of, so the UI can tell a model that still describes an earlier\n * pick. `frameColumns` names both columns as the frame holds them.\n */\nexport type ColumnValueOptionsModel =\n  | { readonly type: \"resolving\"; readonly valueColumn: ColumnUniversalId }\n  | { readonly type: \"absent\"; readonly valueColumn: ColumnUniversalId }\n  | {\n      readonly type: \"present\";\n      readonly valueColumn: ColumnUniversalId;\n      readonly frame: PFrameHandle;\n      readonly frameColumns: {\n        readonly value: PObjectId;\n        /** `null` when the values label themselves. */\n        readonly label: PObjectId | null;\n      };\n    };\n\n/**\n * The model of a value picker over the values of `valueColumn`, for a model output; the UI reads\n * the options through it (`usePlColumnValueOptions`, `PlColumnValueDropdown`). Each option is a\n * value of `valueColumn`, labelled by the value of `labelColumn` in the same row, or by the value\n * itself when no label column is given.\n *\n * `absent` once the value column is gone: a stored id may name a column its upstream block no\n * longer produces. A label column that is gone leaves the values to label themselves; one that is\n * still resolving keeps the model resolving.\n */\nexport function createColumnValueOptions(\n  columns: {\n    readonly valueColumn: ColumnValueOptionsColumn;\n    readonly labelColumn?: ColumnValueOptionsColumn;\n  },\n  deps?: { readonly ctx?: GlobalCfgRenderCtx },\n): ColumnValueOptionsModel {\n  const ctx = deps?.ctx ?? getCfgRenderCtx();\n  const value = frameEntryOf(columns.valueColumn, ctx);\n  const valueColumn = value.id;\n  if (value.status !== \"present\") return { type: value.status, valueColumn };\n\n  const label =\n    columns.labelColumn === undefined ? undefined : frameEntryOf(columns.labelColumn, ctx);\n  if (label?.status === \"resolving\") return { type: \"resolving\", valueColumn };\n  const labelled =\n    label?.status === \"present\" && label.frameId !== value.frameId ? label : undefined;\n\n  const frame = ctx.createPFrame(labelled === undefined ? [value.def] : [value.def, labelled.def]);\n  return {\n    type: \"present\",\n    valueColumn,\n    frame,\n    frameColumns: { value: value.frameId, label: labelled?.frameId ?? null },\n  };\n}\n\n/**\n * Distinct `values` of `column` as options, each a column value id naming the column, labelled\n * by the value itself and ordered naturally by label (\"R2\" before \"R10\"). Empty values are not\n * offered.\n */\nexport function deriveColumnValueOptions(\n  column: ColumnUniversalId,\n  values: readonly string[],\n): ColumnValueOption[] {\n  return deriveLabelledColumnValueOptions(\n    column,\n    values.map((value) => ({ value, label: value })),\n  );\n}\n\n/**\n * Distinct values of `column` among `rows` as options, each a column value id naming the column,\n * labelled by the label of the first row holding the value, and ordered naturally by label (\"R2\"\n * before \"R10\"). Empty values are not offered; a value whose label is empty labels itself.\n */\nexport function deriveLabelledColumnValueOptions(\n  column: ColumnUniversalId,\n  rows: readonly { readonly value: string; readonly label: string }[],\n): ColumnValueOption[] {\n  const options = new Map<string, ColumnValueOption>();\n  for (const { value, label } of rows) {\n    if (value === \"\" || options.has(value)) continue;\n    options.set(value, {\n      value: createColumnValueId({ column, value }),\n      label: label === \"\" ? value : label,\n    });\n  }\n  return [...options.values()].sort((a, b) => compareNatural(a.label, b.label));\n}\n\n// Internals\n\n/** A column as a frame is made of it: its id, its status, and what the frame is created from. */\ntype FrameEntry = {\n  readonly id: ColumnUniversalId;\n  readonly status: ColumnResolutionStatus;\n  readonly frameId: PObjectId;\n  readonly def: Parameters<GlobalCfgRenderCtx[\"createPFrame\"]>[0][number];\n};\n\n/**\n * A column given by id or by a recipe goes into the frame by its id, which the frame holds as the\n * bare id of its leaf; a materialised column goes in as it is.\n */\nfunction frameEntryOf(column: ColumnValueOptionsColumn, ctx: GlobalCfgRenderCtx): FrameEntry {\n  if (typeof column === \"string\") {\n    return {\n      id: column,\n      status: ColumnRecipe.getStatus(column, { ctx }),\n      frameId: extractPObjectId(column),\n      def: column,\n    };\n  }\n  if (isPColumn<undefined | PColumnDataUniversal>(column)) {\n    return {\n      id: column.id,\n      status: \"present\",\n      frameId: column.id,\n      def: finalizePColumnData(column),\n    };\n  }\n  return {\n    id: column.id,\n    status: column.getDataStatus(),\n    frameId: extractPObjectId(column.id),\n    def: column.id,\n  };\n}\n\nconst CHUNKS = /\\d+|\\D+/g;\n\n/**\n * Natural order: runs of digits compare as numbers, other text case-insensitively, so \"R2\"\n * comes before \"R10\". The model runtime has no `Intl`.\n */\nfunction compareNatural(a: string, b: string): number {\n  const chunksA = a.match(CHUNKS) ?? [];\n  const chunksB = b.match(CHUNKS) ?? [];\n  for (let i = 0; i < Math.min(chunksA.length, chunksB.length); i++) {\n    const order = compareChunks(chunksA[i], chunksB[i]);\n    if (order !== 0) return order;\n  }\n  return chunksA.length - chunksB.length || compareStrings(a, b);\n}\n\nfunction compareChunks(a: string, b: string): number {\n  if (isDigits(a) && isDigits(b)) {\n    // Compared as digit strings, so numbers of any length keep their order.\n    const numberA = a.replace(/^0+(?=\\d)/, \"\");\n    const numberB = b.replace(/^0+(?=\\d)/, \"\");\n    return numberA.length - numberB.length || compareStrings(numberA, numberB);\n  }\n  return compareStrings(a.toLowerCase(), b.toLowerCase());\n}\n\nfunction isDigits(chunk: string): boolean {\n  return chunk.charCodeAt(0) >= 48 && chunk.charCodeAt(0) <= 57;\n}\n\nfunction compareStrings(a: string, b: string): number {\n  return a < b ? -1 : a > b ? 1 : 0;\n}\n"],"mappings":"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"}