@eifi1/ui-kit 0.33.0 → 0.34.0

package/dist/components/column-mapper.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/column-mapper.tsx"],"sourcesContent":["import { useEffect, useEffectEvent, useState } from \"react\";\nimport type { ChangeEvent, DragEvent, HTMLAttributes, ReactNode } from \"react\";\nimport { Upload } from \"lucide-react\";\n\nimport { useKitLabels, useKitLocale } from \"../i18n/kit-labels\";\nimport { cn } from \"../lib/cn\";\nimport {\n  assignColumnRole,\n  guessMapping,\n  missingRoles,\n  readMappedTable,\n  readTextFile,\n  roleOfColumn,\n} from \"../lib/column-mapping\";\nimport type {\n  ColumnMapperResult,\n  ColumnMapping,\n  ColumnRole,\n} from \"../lib/column-mapping\";\nimport { parseTextTable } from \"../lib/table-text\";\nimport type { TableSeparator, TextTable } from \"../lib/table-text\";\nimport { AlertBanner } from \"./alert-banner\";\nimport { Checkbox } from \"./checkbox\";\nimport { Disclosure } from \"./disclosure\";\nimport { FileButton, useFilePicker } from \"./file-button\";\nimport {\n  Table,\n  TableBody,\n  TableCell,\n  TableHead,\n  TableHeaderCell,\n  TableRow,\n} from \"./table\";\nimport { Select, Textarea } from \"./ui\";\n\n/**\n * A table pasted, dropped or chosen as a file, and which of its columns plays which\n * part — Kurvenschmiede's columns input and keksdose's bank-file mapping step, once.\n *\n * Kurvenschmiede (`features/control/columns-input.tsx` + `csv.ts`) reads a recorder's\n * export into a playground signal (time, value) and a comparison (time, setpoint,\n * actual): a textarea, a file button, a parse, a select per role, and a line that says\n * which decimal convention was assumed and how many lines were skipped. keksdose\n * (`import-map-step.tsx`) shows a bank's CSV as a table with a role select on every\n * column's header, the file's real values under it, ignored columns dimmed, and what\n * the import still needs named under it. Same problem, two hand-built answers.\n *\n * Two layers, so both shapes fit:\n *\n * * {@link ColumnMapper} — the whole single panel: paste, drop or choose → parse\n *   ({@link parseTextTable}: separator, decimal convention, header line, all stated\n *   back) → preview with a role per column → `onChange(result)`. Kurvenschmiede's.\n * * {@link ColumnRoleTable} — the preview with the role selects alone, controlled, over\n *   rows the caller already has. keksdose's map step, whose rows come from its server's\n *   sniff (encodings, quoted multi-line cells, skipped title rows) and whose mapping\n *   lives in the wizard's state between steps.\n *\n * The rules under both are headless in `lib/column-mapping.ts`: a role moves rather\n * than doubling up, what is missing is named, and the rows a numeric role cannot read\n * are reported by line number rather than dropped.\n */\n\n// ── Labels ────────────────────────────────────────────────────────────────────\n\nexport interface ColumnMapperLabels {\n  /** The paste box's label. */\n  paste: string;\n  /** The caption under the paste box. */\n  pasteHint: string;\n  /** The file button. */\n  chooseFile: string;\n  /** A chosen or dropped file whose bytes could not be read at all. */\n  readError: (name: string) => string;\n  /** The checkbox that says whether the first line names the columns. */\n  headerRow: string;\n  /** What was read: so many columns and rows. */\n  summary: (columns: number, rows: number) => string;\n  /** The separator that was assumed. */\n  separatorSemicolon: string;\n  separatorComma: string;\n  separatorTab: string;\n  separatorSpace: string;\n  /** The decimal convention that was assumed — with an example, because \"decimal\n   *  comma\" alone is a term, and `1,5` is something a reader recognises. */\n  decimalComma: string;\n  decimalPoint: string;\n  /** The title over the lines that could not be read. */\n  unreadCount: (count: number) => string;\n  /** One of them. */\n  unreadLine: (line: number) => string;\n  /** Past the first hundred listed. */\n  unreadMore: (count: number) => string;\n  /** The text has content, and none of it is a row. */\n  noRows: string;\n  /** The preview table's name. */\n  table: string;\n  /** A column the table names no header for. */\n  columnN: (n: number) => string;\n  /** The role select on a column's header — its accessible name. */\n  roleOf: (column: string) => string;\n  /** The role select's \"no role\" option. */\n  ignore: string;\n  /** A required role in the select — only while some role is NOT required: when\n   *  every one is, the mark tells no role from another (0.24, Kurvenschmiede). Since\n   *  0.25 this is what a screen reader says for the option (its `aria-label`); the\n   *  option SHOWS {@link requiredRoleShort}. */\n  requiredRole: (role: string) => string;\n  /** The same required role as the select shows it (0.25): the role's name and a short\n   *  mark, so the mark does not cut the name short in a phone-width column — \"Booking\n   *  date (re…\" was all keksdose's closed select had room for. Spoken as\n   *  {@link requiredRole}. Optional, so a complete `UiKitLabels` typed before 0.25\n   *  still compiles; the asterisk needs no translation in most languages. */\n  requiredRoleShort?: (role: string) => string;\n  /** Under the preview, when it shows fewer rows than were read. */\n  previewOf: (shown: number, total: number) => string;\n  /** A required group's roles, already joined as a list with \"or\". */\n  oneOf: (roles: string) => string;\n  /** What the table still needs, already joined as a list with \"and\". */\n  missing: (roles: string) => string;\n}\n\n/** {@link ColumnMapperLabels.requiredRoleShort}'s English — and its fallback for a\n *  provider whose labels predate the key. */\nconst markedShort = (role: string) => `${role} *`;\n\nexport const DEFAULT_COLUMN_MAPPER_LABELS: ColumnMapperLabels = {\n  paste: \"Paste a table\",\n  pasteHint:\n    \"Copy the rows out of a spreadsheet and paste them here, or drop a CSV or text file.\",\n  chooseFile: \"Choose a file\",\n  readError: (name) => `“${name}” could not be read`,\n  headerRow: \"The first line names the columns\",\n  summary: (columns, rows) =>\n    `${columns} ${columns === 1 ? \"column\" : \"columns\"}, ${rows} ${rows === 1 ? \"row\" : \"rows\"}`,\n  separatorSemicolon: \"separated by semicolons\",\n  separatorComma: \"separated by commas\",\n  separatorTab: \"separated by tabs\",\n  separatorSpace: \"separated by spaces\",\n  decimalComma: \"decimal comma (1,5)\",\n  decimalPoint: \"decimal point (1.5)\",\n  unreadCount: (count) =>\n    count === 1\n      ? \"1 line could not be read\"\n      : `${count} lines could not be read`,\n  unreadLine: (line) => `Line ${line} could not be read`,\n  unreadMore: (count) => `…and ${count} more`,\n  noRows: \"No line of this text reads as a row of the table.\",\n  table: \"Columns and their roles\",\n  columnN: (n) => `Column ${n}`,\n  roleOf: (column) => `What does column “${column}” hold?`,\n  ignore: \"Ignore\",\n  requiredRole: (role) => `${role} (required)`,\n  requiredRoleShort: markedShort,\n  previewOf: (shown, total) =>\n    shown === 1\n      ? `The first of ${total} rows`\n      : `The first ${shown} of ${total} rows`,\n  oneOf: (roles) => `either ${roles}`,\n  missing: (roles) => `Still needed: ${roles}.`,\n};\n\nconst SEPARATOR_LABEL: Record<\n  TableSeparator,\n  \"separatorSemicolon\" | \"separatorComma\" | \"separatorTab\" | \"separatorSpace\"\n> = {\n  \";\": \"separatorSemicolon\",\n  \",\": \"separatorComma\",\n  \"\\t\": \"separatorTab\",\n  \" \": \"separatorSpace\",\n};\n\n/** How many unread lines are listed before \"…and N more\". */\nconst UNREAD_LISTED = 100;\n\n/** A file a table is likely to be in. Extensions only, so a refusal reads \"Only .csv,\n *  .tsv, … files\" rather than a list of MIME types; the parse is the real check. */\nconst DEFAULT_ACCEPT = \".csv,.tsv,.txt,.dat,.asc\";\n\nfunction formatList(\n  items: string[],\n  type: \"conjunction\" | \"disjunction\",\n  locale: string | undefined,\n): string {\n  try {\n    return new Intl.ListFormat(locale, { type, style: \"long\" }).format(items);\n  } catch {\n    return items.join(\", \");\n  }\n}\n\n// ── ColumnRoleTable ───────────────────────────────────────────────────────────\n\n/** A `data-*` attribute, typed so `{ \"data-private\": \"\" }` needs no cast. */\ntype DataAttributes = { [key: `data-${string}`]: string | number | boolean | undefined };\n\n/**\n * What {@link ColumnRoleTableProps.bodyProps} puts on the preview's `<tbody>`: `data-*`\n * hooks, an `id`, a class, a style.\n */\nexport type ColumnRoleTableBodyProps = Omit<\n  HTMLAttributes<HTMLTableSectionElement>,\n  \"children\" | \"dangerouslySetInnerHTML\"\n> &\n  DataAttributes;\n\n/**\n * What {@link ColumnRoleTableProps.rowProps} returns for one preview row's `<tr>` —\n * the same shape as LineItems' `LineItemsRowProps`, on a table row.\n */\nexport type ColumnRoleTableRowProps = Omit<\n  HTMLAttributes<HTMLTableRowElement>,\n  \"children\" | \"dangerouslySetInnerHTML\"\n> &\n  DataAttributes;\n\nexport interface ColumnRoleTableProps<\n  R extends string,\n  M extends ColumnMapping<R> = ColumnMapping<R>,\n> {\n  /** The columns' names — the file's header line — or `null` for a table without one\n   *  (each column is then \"Column 1\", \"Column 2\", …). */\n  header: readonly string[] | null;\n  /** The rows to preview, as text. Only the first {@link previewRows} are drawn. */\n  rows: readonly (readonly string[])[];\n  /** How many columns. Default: the header's length or the widest previewed row. */\n  width?: number;\n  /** The parts a column can play. */\n  roles: readonly ColumnRole<R>[];\n  /** Role → column. Any object with the roles as nullable number fields — keksdose's\n   *  `CsvMapping` as it stands; the other fields are handed back untouched. */\n  mapping: M;\n  /** The next mapping, with the picked role moved onto its column. */\n  onMappingChange: (next: M) => void;\n  /** Default 5. */\n  previewRows?: number;\n  /** How many rows the table has in all, for \"The first 5 of 120 rows\". Default:\n   *  `rows.length`. */\n  totalRows?: number;\n  /** Every role select disabled — keksdose locks them while a re-sniff replaces the\n   *  table they point into. */\n  disabled?: boolean;\n  /**\n   * Extra attributes for the preview's `<tbody>` (0.24) — keksdose: the sample rows are\n   * the user's own bank data (payees, memos, amounts), and its demo mode blurs exactly\n   * that through `.demo-mode [data-private]` (#336). With nowhere to put the attribute,\n   * its map step reached into the table with a `useLayoutEffect` that set it on the\n   * `<tbody>` after every commit; `bodyProps={{ \"data-private\": \"\" }}` declares it.\n   * There is deliberately no head counterpart: the column names and the role selects\n   * are what such a mode is there to show.\n   *\n   * Spread on the kit `TableBody`; a `className` is added to its own.\n   */\n  bodyProps?: ColumnRoleTableBodyProps;\n  /**\n   * Extra attributes for one preview row's `<tr>`, from its cells and its index in the\n   * preview (0.24) — the contract of LineItems' `rowProps` (keksdose K20), on a table:\n   * `data-*` hooks (a per-row `data-private`, a test id), an `id`, a class. Called for\n   * the rows drawn, the first {@link previewRows}. The row has no attributes of its own\n   * to protect; a `className` is added after its classes.\n   */\n  rowProps?: (row: readonly string[], index: number) => ColumnRoleTableRowProps | undefined;\n  labels?: Partial<ColumnMapperLabels>;\n  className?: string;\n}\n\n/**\n * A table's first rows, with a role select on every column's header.\n *\n * keksdose's mapping step (dev#462: \"make it more table like, where the table columns\n * can be chosen from the input and the column data changes with the chosen column\n * header\"): the file IS the form. The file's own column name sits on top, verbatim —\n * it is how the reader recognises the column; under it the role, picked in place;\n * under that the column's real values, so a column that is one off shows up here and\n * not after the import. A column with no role says \"Ignore\" and its values are dimmed:\n * the state that most needs to be visible in a twelve-column bank export.\n *\n * Picking a role another column holds MOVES it ({@link assignColumnRole}). What the\n * table still needs is named under it — a required group as \"either Amount, Debit or\n * Credit\". Required roles are marked in the list only where some role is not\n * (0.24): Kurvenschmiede's roles are all required, so the mark told no option from\n * another, and on a phone it cut the role's own name short (\"Zeit (s) (erforderl…\")\n * — the part of the option the reader has to read. The \"Still needed\" line already\n * says what is missing; a mark that distinguishes nothing is only noise.\n *\n * Where the mark does tell roles apart, it is short (0.25): keksdose's bank roles, on\n * a phone, still showed \"Booking date (re…\" in the closed select. The option shows\n * \"Booking date *\" ({@link ColumnMapperLabels.requiredRoleShort}) and is NAMED \"Booking\n * date (required)\" ({@link ColumnMapperLabels.requiredRole}, its `aria-label`), so a\n * screen reader hears the word rather than \"star\". And no role is cut at all: each\n * column is at least as wide as its select's longest option — the select's own width,\n * which a table cell otherwise ignores for a `w-full` control — up to 14rem, the width\n * the column's name and values already stop at. A long role name (\"Date de\n * comptabilisation\", \"Betrag (mit Vorzeichen)\") widens the columns, and the edge fade\n * says there are more of them to scroll to.\n *\n * The table scrolls sideways inside its own box (the kit {@link Table}'s wrapper, a\n * named, keyboard-reachable region while it overflows), so a wide export never widens\n * the page at 390px. An edge with columns behind it fades out (0.24, Kurvenschmiede:\n * on a phone the fourth column's select sat off-screen and nothing said there was more\n * to the right; phone scrollbars are overlays that show only while you drag). Since\n * 0.25 that is the kit Table's own `edgeFade`, not a box of this table's round it:\n * measured, so a table that fits is painted as before; both ends once scrolled into\n * the middle; the reading direction's own in RTL; never animated; a `mask-image`,\n * which changes no layout and needs no background colour to fade to. A role select\n * focused behind the fade is scrolled clear of it, cell and all, and the Table's\n * wrapper says which ends are cut in `data-overflow`.\n */\nexport function ColumnRoleTable<\n  R extends string,\n  M extends ColumnMapping<R> = ColumnMapping<R>,\n>({\n  header,\n  rows,\n  width: widthProp,\n  roles,\n  mapping,\n  onMappingChange,\n  previewRows = 5,\n  totalRows,\n  disabled,\n  bodyProps,\n  rowProps,\n  labels: labelsProp,\n  className,\n}: ColumnRoleTableProps<R, M>) {\n  const labels: ColumnMapperLabels = useKitLabels(\n    \"columnMapper\",\n    DEFAULT_COLUMN_MAPPER_LABELS,\n    labelsProp,\n  );\n  const locale = useKitLocale();\n  const shown = rows.slice(0, previewRows);\n  const width =\n    widthProp ??\n    shown.reduce(\n      (widest, row) => Math.max(widest, row.length),\n      header?.length ?? 0,\n    );\n  const columns = Array.from({ length: width }, (_, index) => index);\n  const total = totalRows ?? rows.length;\n  const nameOf = (column: number) =>\n    header?.[column] || labels.columnN(column + 1);\n  const labelOf = (value: R) =>\n    roles.find((role) => role.value === value)?.label ?? value;\n  const gaps = missingRoles(roles, mapping, width).map((gap) =>\n    gap.length === 1\n      ? labelOf(gap[0])\n      : labels.oneOf(formatList(gap.map(labelOf), \"disjunction\", locale)),\n  );\n  // The required mark only where it tells one option from another.\n  const markRequired = roles.some((role) => role.required !== true);\n\n  return (\n    <div\n      className={cn(\"min-w-0 space-y-1.5\", className)}\n      data-slot=\"column-role-table\"\n    >\n      <Table density=\"compact\" framed edgeFade aria-label={labels.table}>\n        <TableHead>\n          <TableRow>\n            {columns.map((column) => {\n              const role = roleOfColumn(roles, mapping, column);\n              const name = nameOf(column);\n              return (\n                <TableHeaderCell\n                  key={column}\n                  scope=\"col\"\n                  className=\"min-w-36 py-2 align-top\"\n                >\n                  <span className=\"block max-w-56 truncate pb-1 text-caption font-normal text-[var(--text-muted)]\">\n                    {name}\n                  </span>\n                  <Select\n                    size=\"sm\"\n                    className=\"w-full\"\n                    // Its own width (the longest option) rather than the cell's: a cell\n                    // takes no width from a `w-full` select, so the role's name was\n                    // cut at the column's 9rem minimum. Stretched to the cell when that\n                    // is wider; capped where the column's name and values stop.\n                    selectClassName=\"w-auto min-w-full max-w-56\"\n                    aria-label={labels.roleOf(name)}\n                    value={role ?? \"\"}\n                    disabled={disabled}\n                    onChange={(event) =>\n                      onMappingChange(\n                        assignColumnRole(\n                          roles,\n                          mapping,\n                          column,\n                          event.target.value === \"\"\n                            ? null\n                            : (event.target.value as R),\n                        ),\n                      )\n                    }\n                  >\n                    <option value=\"\">{labels.ignore}</option>\n                    {roles.map((option) => {\n                      const marked = option.required === true && markRequired;\n                      return (\n                        <option\n                          key={option.value}\n                          value={option.value}\n                          // The short mark on screen, the word for a screen reader.\n                          aria-label={\n                            marked ? labels.requiredRole(option.label) : undefined\n                          }\n                        >\n                          {marked\n                            ? (labels.requiredRoleShort ?? markedShort)(option.label)\n                            : option.label}\n                        </option>\n                      );\n                    })}\n                  </Select>\n                </TableHeaderCell>\n              );\n            })}\n          </TableRow>\n        </TableHead>\n        <TableBody {...bodyProps}>\n          {shown.map((row, index) => (\n            <TableRow {...rowProps?.(row, index)} key={index}>\n              {columns.map((column) => (\n                <TableCell\n                  key={column}\n                  data-ignored={\n                    roleOfColumn(roles, mapping, column) === null || undefined\n                  }\n                  className={cn(\n                    \"font-mono whitespace-nowrap\",\n                    // Dimmed, not hidden: its values are what tell you whether ignoring\n                    // it was right.\n                    roleOfColumn(roles, mapping, column) === null &&\n                      \"text-[var(--text-muted)]\",\n                  )}\n                >\n                  <span className=\"block max-w-56 truncate\">\n                    {row[column] ?? \"\"}\n                  </span>\n                </TableCell>\n              ))}\n            </TableRow>\n          ))}\n        </TableBody>\n      </Table>\n      {total > shown.length && (\n        <p className=\"text-xs text-[var(--text-muted)]\">\n          {labels.previewOf(shown.length, total)}\n        </p>\n      )}\n      {gaps.length > 0 && (\n        <AlertBanner tone=\"warning\" variant=\"inline\" size=\"sm\" block>\n          {labels.missing(formatList(gaps, \"conjunction\", locale))}\n        </AlertBanner>\n      )}\n    </div>\n  );\n}\n\n// ── ColumnMapper ──────────────────────────────────────────────────────────────\n\nexport interface ColumnMapperProps<R extends string> {\n  /** The parts the columns play — translated labels, which are required, which must\n   *  be numbers. See {@link ColumnRole}. */\n  roles: readonly ColumnRole<R>[];\n  /**\n   * The table read through the current mapping, on every change: the text, the header\n   * checkbox, a role. `null` while there is no table at all (an empty box). Use it when\n   * `result.complete`; until then `result.missing` says what is not placed yet.\n   *\n   * The rows are strings. A numeric role's cells are guaranteed to read with\n   * `tableNumber(cell, result.decimalComma)`; anything else is the caller's to convert.\n   */\n  onChange: (result: ColumnMapperResult<R> | null) => void;\n  /** The paste box's label. Default: `labels.paste`. */\n  label?: ReactNode;\n  /** The caption under the paste box. Default: `labels.pasteHint`. */\n  hint?: ReactNode;\n  /** What the file dialog offers, and what a drop is checked against. Default:\n   *  `.csv,.tsv,.txt,.dat,.asc`. */\n  accept?: string;\n  /** The largest file taken, in bytes. Default: no limit. */\n  maxSize?: number;\n  /** Text to start with. `onChange` is called with its result once, on mount. */\n  defaultText?: string;\n  /** Rows in the preview. Default 5. */\n  previewRows?: number;\n  /** The first mapping for a new table. Default {@link guessMapping}: a column named\n   *  like a role gets it, and the required roles left over take the free columns in\n   *  order. */\n  guess?: (table: TextTable) => ColumnMapping<R>;\n  disabled?: boolean;\n  /** The preview table's `<tbody>` attributes — {@link ColumnRoleTableProps.bodyProps}\n   *  (0.24): `{ \"data-private\": \"\" }` for a table of someone's own data. */\n  bodyProps?: ColumnRoleTableBodyProps;\n  /** One preview row's `<tr>` attributes — {@link ColumnRoleTableProps.rowProps}\n   *  (0.24). `row` is the row as read, `index` its place in the preview. */\n  rowProps?: (row: readonly string[], index: number) => ColumnRoleTableRowProps | undefined;\n  labels?: Partial<ColumnMapperLabels>;\n  className?: string;\n}\n\ninterface MapperState<R extends string> {\n  text: string;\n  /** The reader's answer to \"does the first line name the columns\", or `null` for\n   *  the parse's own. */\n  header: boolean | null;\n  table: TextTable;\n  mapping: ColumnMapping<R>;\n}\n\nconst hasFiles = (event: DragEvent) =>\n  Array.from(event.dataTransfer?.types ?? []).includes(\"Files\");\n\n/**\n * Paste, drop or choose a table, see what it was read as, and say which column is\n * which — Kurvenschmiede's playground signal and comparison input as one kit part.\n *\n * Everything the parse assumed is stated, because a guess the reader cannot see is a\n * guess they cannot correct: the shape it found, the separator, the decimal\n * convention (\"decimal comma (1,5)\"), and every line it could not read, by number and\n * with its text. The header line is a checkbox, since the detection is a guess either\n * way and toggling it does not move a column (the mapping is kept, keksdose's\n * `keepRoles`). A new file is a new table and is mapped afresh; typing that changes the\n * column count re-guesses, because the old indexes point at nothing.\n *\n * A file can be chosen, dropped on the button, or dropped on the paste box — which,\n * left to the browser, would open the file in place of the page. It is read as UTF-8,\n * or as Windows-1252 when it is not UTF-8 ({@link readTextFile}).\n *\n * A two-step wizard that keeps the drop and the mapping apart (keksdose's) uses the\n * parts: {@link parseTextTable} or its own server's sniff, then {@link ColumnRoleTable},\n * then {@link readMappedTable}.\n */\nexport function ColumnMapper<R extends string>({\n  roles,\n  onChange,\n  label,\n  hint,\n  accept = DEFAULT_ACCEPT,\n  maxSize,\n  defaultText = \"\",\n  previewRows = 5,\n  guess,\n  disabled = false,\n  bodyProps,\n  rowProps,\n  labels: labelsProp,\n  className,\n}: ColumnMapperProps<R>) {\n  const labels: ColumnMapperLabels = useKitLabels(\n    \"columnMapper\",\n    DEFAULT_COLUMN_MAPPER_LABELS,\n    labelsProp,\n  );\n  const firstMapping = (table: TextTable) =>\n    guess ? guess(table) : guessMapping(roles, table.header, table.width);\n  const [state, setState] = useState<MapperState<R>>(() => {\n    const table = parseTextTable(defaultText);\n    return {\n      text: defaultText,\n      header: null,\n      table,\n      mapping: firstMapping(table),\n    };\n  });\n  const [reading, setReading] = useState(false);\n  const [refusal, setRefusal] = useState<string | null>(null);\n  const [dragOver, setDragOver] = useState(false);\n\n  // What is drawn and what is handed over are the same computation. Not memoised: a\n  // caller writes `roles={[…]}` inline, so a memo keyed on them would miss every time,\n  // and the read is one pass over rows that are already split.\n  const result = readMappedTable(state.table, roles, state.mapping);\n\n  const commit = (next: MapperState<R>) => {\n    setState(next);\n    onChange(\n      next.table.width === 0\n        ? null\n        : readMappedTable(next.table, roles, next.mapping),\n    );\n  };\n\n  /** New text. `fresh` (a file): the reader's header answer and the mapping start over. */\n  const take = (text: string, fresh: boolean) => {\n    const header = fresh ? null : state.header;\n    const table = parseTextTable(text, header === null ? {} : { header });\n    const keep =\n      !fresh && table.width === state.table.width && state.table.width > 0;\n    commit({\n      text,\n      header,\n      table,\n      mapping: keep ? state.mapping : firstMapping(table),\n    });\n  };\n\n  const load = (file: File) => {\n    setRefusal(null);\n    setReading(true);\n    void readTextFile(file)\n      .then(\n        (text) => take(text, true),\n        // Only the read: an error thrown by the caller's onChange is not the file's.\n        () => setRefusal(labels.readError(file.name)),\n      )\n      .finally(() => setReading(false));\n  };\n\n  const refuse = (rejections: { message: string }[]) =>\n    setRefusal(rejections[0]?.message ?? null);\n\n  // A file dropped on the paste box. The same screening as the button's.\n  const drop = useFilePicker({\n    accept,\n    maxSize,\n    disabled,\n    onFiles: ([file]) => load(file),\n    onReject: refuse,\n  });\n\n  const seeded = useEffectEvent(() => {\n    if (state.table.width > 0) onChange(result);\n  });\n  useEffect(() => {\n    seeded();\n  }, []);\n\n  const { table } = state;\n  const separator = labels[SEPARATOR_LABEL[table.separator]];\n  const unread = result.unread;\n\n  return (\n    <div\n      className={cn(\"min-w-0 space-y-3\", className)}\n      data-slot=\"column-mapper\"\n    >\n      <Textarea\n        label={label ?? labels.paste}\n        hint={hint ?? labels.pasteHint}\n        rows={5}\n        wrap=\"off\"\n        spellCheck={false}\n        autoCapitalize=\"off\"\n        autoCorrect=\"off\"\n        value={state.text}\n        disabled={disabled}\n        className={cn(\n          \"font-mono text-xs\",\n          dragOver && \"rounded-md ring-2 ring-[var(--brand)]\",\n        )}\n        data-drag-over={dragOver || undefined}\n        onChange={(event: ChangeEvent<HTMLTextAreaElement>) => {\n          setRefusal(null);\n          take(event.target.value, false);\n        }}\n        onDragEnter={(event) => {\n          if (!hasFiles(event)) return;\n          event.preventDefault();\n          if (!disabled) setDragOver(true);\n        }}\n        onDragOver={(event) => {\n          if (!hasFiles(event)) return;\n          // Cancelled for every file drag: an uncancelled one makes the browser open\n          // the file in place of the page.\n          event.preventDefault();\n          event.dataTransfer.dropEffect = disabled ? \"none\" : \"copy\";\n        }}\n        onDragLeave={() => setDragOver(false)}\n        onDrop={(event) => {\n          if (!hasFiles(event)) return;\n          event.preventDefault();\n          setDragOver(false);\n          drop.take(event.dataTransfer.files);\n        }}\n      />\n      {drop.element}\n\n      <div className=\"flex flex-wrap items-center gap-x-4 gap-y-2\">\n        <FileButton\n          variant=\"secondary\"\n          accept={accept}\n          maxSize={maxSize}\n          droppable\n          pending={reading}\n          disabled={disabled}\n          onFiles={([file]) => load(file)}\n          onReject={refuse}\n        >\n          <Upload className=\"size-4\" aria-hidden />\n          {labels.chooseFile}\n        </FileButton>\n        {table.width > 0 && (\n          <Checkbox\n            label={labels.headerRow}\n            checked={table.header !== null}\n            disabled={disabled}\n            onCheckedChange={(checked) => {\n              const next = parseTextTable(state.text, { header: checked });\n              // Same text, same split: the columns are where they were, and so are the\n              // roles on them.\n              commit({ ...state, header: checked, table: next });\n            }}\n          />\n        )}\n      </div>\n\n      {refusal && (\n        <AlertBanner tone=\"danger\" variant=\"inline\" size=\"sm\" block>\n          {refusal}\n        </AlertBanner>\n      )}\n\n      {table.width > 0 && (\n        <>\n          <p\n            className=\"text-xs text-[var(--text-secondary)]\"\n            data-slot=\"column-mapper-summary\"\n          >\n            {[\n              labels.summary(table.width, result.rows.length),\n              separator,\n              table.decimalComma ? labels.decimalComma : labels.decimalPoint,\n            ].join(\" · \")}\n          </p>\n          {result.rows.length === 0 && (\n            <AlertBanner tone=\"warning\" variant=\"inline\" size=\"sm\" block>\n              {labels.noRows}\n            </AlertBanner>\n          )}\n          <ColumnRoleTable\n            header={table.header}\n            rows={result.rows}\n            width={table.width}\n            roles={roles}\n            mapping={state.mapping}\n            onMappingChange={(mapping) => commit({ ...state, mapping })}\n            previewRows={previewRows}\n            disabled={disabled}\n            bodyProps={bodyProps}\n            rowProps={rowProps}\n            labels={labelsProp}\n          />\n          {unread.length > 0 && (\n            <Disclosure\n              variant=\"bare\"\n              title={labels.unreadCount(unread.length)}\n              data-slot=\"column-mapper-unread\"\n            >\n              <ul className=\"space-y-1 text-xs\">\n                {unread.slice(0, UNREAD_LISTED).map((line) => (\n                  <li key={line.line} className=\"min-w-0\">\n                    <span className=\"block text-[var(--text-secondary)]\">\n                      {labels.unreadLine(line.line)}\n                    </span>\n                    <code className=\"block truncate font-mono text-[var(--text-muted)]\">\n                      {line.text}\n                    </code>\n                  </li>\n                ))}\n                {unread.length > UNREAD_LISTED && (\n                  <li className=\"text-[var(--text-muted)]\">\n                    {labels.unreadMore(unread.length - UNREAD_LISTED)}\n                  </li>\n                )}\n              </ul>\n            </Disclosure>\n          )}\n        </>\n      )}\n    </div>\n  );\n}\n"],"mappings":"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","names":["table"]}
+{"version":3,"sources":["../../src/components/column-mapper.tsx"],"sourcesContent":["import { useEffect, useEffectEvent, useState } from \"react\";\nimport type { ChangeEvent, DragEvent, HTMLAttributes, ReactNode } from \"react\";\nimport { Upload } from \"lucide-react\";\n\nimport { useKitLabels, useKitLocale, type LabelOverride } from \"../i18n/kit-labels\";\nimport { cn } from \"../lib/cn\";\nimport {\n  assignColumnRole,\n  guessMapping,\n  missingRoles,\n  readMappedTable,\n  readTextFile,\n  roleOfColumn,\n} from \"../lib/column-mapping\";\nimport type {\n  ColumnMapperResult,\n  ColumnMapping,\n  ColumnRole,\n} from \"../lib/column-mapping\";\nimport { parseTextTable } from \"../lib/table-text\";\nimport type { TableSeparator, TextTable } from \"../lib/table-text\";\nimport { AlertBanner } from \"./alert-banner\";\nimport { Checkbox } from \"./checkbox\";\nimport { Disclosure } from \"./disclosure\";\nimport { FileButton, useFilePicker } from \"./file-button\";\nimport {\n  Table,\n  TableBody,\n  TableCell,\n  TableHead,\n  TableHeaderCell,\n  TableRow,\n} from \"./table\";\nimport { Select } from \"./select\";\nimport { Textarea } from \"./textarea\";\nimport { DEFAULT_COLUMN_MAPPER_LABELS, markedShort } from \"./column-mapper-labels\";\n\n/**\n * A table pasted, dropped or chosen as a file, and which of its columns plays which\n * part — Kurvenschmiede's columns input and keksdose's bank-file mapping step, once.\n *\n * Kurvenschmiede (`features/control/columns-input.tsx` + `csv.ts`) reads a recorder's\n * export into a playground signal (time, value) and a comparison (time, setpoint,\n * actual): a textarea, a file button, a parse, a select per role, and a line that says\n * which decimal convention was assumed and how many lines were skipped. keksdose\n * (`import-map-step.tsx`) shows a bank's CSV as a table with a role select on every\n * column's header, the file's real values under it, ignored columns dimmed, and what\n * the import still needs named under it. Same problem, two hand-built answers.\n *\n * Two layers, so both shapes fit:\n *\n * * {@link ColumnMapper} — the whole single panel: paste, drop or choose → parse\n *   ({@link parseTextTable}: separator, decimal convention, header line, all stated\n *   back) → preview with a role per column → `onChange(result)`. Kurvenschmiede's.\n * * {@link ColumnRoleTable} — the preview with the role selects alone, controlled, over\n *   rows the caller already has. keksdose's map step, whose rows come from its server's\n *   sniff (encodings, quoted multi-line cells, skipped title rows) and whose mapping\n *   lives in the wizard's state between steps.\n *\n * The rules under both are headless in `lib/column-mapping.ts`: a role moves rather\n * than doubling up, what is missing is named, and the rows a numeric role cannot read\n * are reported by line number rather than dropped.\n */\n\n// ── Labels ────────────────────────────────────────────────────────────────────\n\nexport interface ColumnMapperLabels {\n  /** The paste box's label. */\n  paste: string;\n  /** The caption under the paste box. */\n  pasteHint: string;\n  /** The file button. */\n  chooseFile: string;\n  /** A chosen or dropped file whose bytes could not be read at all. */\n  readError: (name: string) => string;\n  /** The checkbox that says whether the first line names the columns. */\n  headerRow: string;\n  /** What was read: so many columns and rows. */\n  summary: (columns: number, rows: number) => string;\n  /** The separator that was assumed. */\n  separatorSemicolon: string;\n  separatorComma: string;\n  separatorTab: string;\n  separatorSpace: string;\n  /** The decimal convention that was assumed — with an example, because \"decimal\n   *  comma\" alone is a term, and `1,5` is something a reader recognises. */\n  decimalComma: string;\n  decimalPoint: string;\n  /** The title over the lines that could not be read. */\n  unreadCount: (count: number) => string;\n  /** One of them. */\n  unreadLine: (line: number) => string;\n  /** Past the first hundred listed. */\n  unreadMore: (count: number) => string;\n  /** The text has content, and none of it is a row. */\n  noRows: string;\n  /** The preview table's name. */\n  table: string;\n  /** A column the table names no header for. */\n  columnN: (n: number) => string;\n  /** The role select on a column's header — its accessible name. */\n  roleOf: (column: string) => string;\n  /** The role select's \"no role\" option. */\n  ignore: string;\n  /** A required role in the select — only while some role is NOT required: when\n   *  every one is, the mark tells no role from another (0.24, Kurvenschmiede). Since\n   *  0.25 this is what a screen reader says for the option (its `aria-label`); the\n   *  option SHOWS {@link requiredRoleShort}. */\n  requiredRole: (role: string) => string;\n  /** The same required role as the select shows it (0.25): the role's name and a short\n   *  mark, so the mark does not cut the name short in a phone-width column — \"Booking\n   *  date (re…\" was all keksdose's closed select had room for. Spoken as\n   *  {@link requiredRole}. Optional, so a complete `UiKitLabels` typed before 0.25\n   *  still compiles; the asterisk needs no translation in most languages. */\n  requiredRoleShort?: (role: string) => string;\n  /** Under the preview, when it shows fewer rows than were read. */\n  previewOf: (shown: number, total: number) => string;\n  /** A required group's roles, already joined as a list with \"or\". */\n  oneOf: (roles: string) => string;\n  /** What the table still needs, already joined as a list with \"and\". */\n  missing: (roles: string) => string;\n}\n\n// Defined in ./column-mapper-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_COLUMN_MAPPER_LABELS };\n\nconst SEPARATOR_LABEL: Record<\n  TableSeparator,\n  \"separatorSemicolon\" | \"separatorComma\" | \"separatorTab\" | \"separatorSpace\"\n> = {\n  \";\": \"separatorSemicolon\",\n  \",\": \"separatorComma\",\n  \"\\t\": \"separatorTab\",\n  \" \": \"separatorSpace\",\n};\n\n/** How many unread lines are listed before \"…and N more\". */\nconst UNREAD_LISTED = 100;\n\n/** A file a table is likely to be in. Extensions only, so a refusal reads \"Only .csv,\n *  .tsv, … files\" rather than a list of MIME types; the parse is the real check. */\nconst DEFAULT_ACCEPT = \".csv,.tsv,.txt,.dat,.asc\";\n\nfunction formatList(\n  items: string[],\n  type: \"conjunction\" | \"disjunction\",\n  locale: string | undefined,\n): string {\n  try {\n    return new Intl.ListFormat(locale, { type, style: \"long\" }).format(items);\n  } catch {\n    return items.join(\", \");\n  }\n}\n\n// ── ColumnRoleTable ───────────────────────────────────────────────────────────\n\n/** A `data-*` attribute, typed so `{ \"data-private\": \"\" }` needs no cast. */\ntype DataAttributes = { [key: `data-${string}`]: string | number | boolean | undefined };\n\n/**\n * What {@link ColumnRoleTableProps.bodyProps} puts on the preview's `<tbody>`: `data-*`\n * hooks, an `id`, a class, a style.\n */\nexport type ColumnRoleTableBodyProps = Omit<\n  HTMLAttributes<HTMLTableSectionElement>,\n  \"children\" | \"dangerouslySetInnerHTML\"\n> &\n  DataAttributes;\n\n/**\n * What {@link ColumnRoleTableProps.rowProps} returns for one preview row's `<tr>` —\n * the same shape as LineItems' `LineItemsRowProps`, on a table row.\n */\nexport type ColumnRoleTableRowProps = Omit<\n  HTMLAttributes<HTMLTableRowElement>,\n  \"children\" | \"dangerouslySetInnerHTML\"\n> &\n  DataAttributes;\n\nexport interface ColumnRoleTableProps<\n  R extends string,\n  M extends ColumnMapping<R> = ColumnMapping<R>,\n> {\n  /** The columns' names — the file's header line — or `null` for a table without one\n   *  (each column is then \"Column 1\", \"Column 2\", …). */\n  header: readonly string[] | null;\n  /** The rows to preview, as text. Only the first {@link previewRows} are drawn. */\n  rows: readonly (readonly string[])[];\n  /** How many columns. Default: the header's length or the widest previewed row. */\n  width?: number;\n  /** The parts a column can play. */\n  roles: readonly ColumnRole<R>[];\n  /** Role → column. Any object with the roles as nullable number fields — keksdose's\n   *  `CsvMapping` as it stands; the other fields are handed back untouched. */\n  mapping: M;\n  /** The next mapping, with the picked role moved onto its column. */\n  onMappingChange: (next: M) => void;\n  /** Default 5. */\n  previewRows?: number;\n  /** How many rows the table has in all, for \"The first 5 of 120 rows\". Default:\n   *  `rows.length`. */\n  totalRows?: number;\n  /** Every role select disabled — keksdose locks them while a re-sniff replaces the\n   *  table they point into. */\n  disabled?: boolean;\n  /**\n   * Extra attributes for the preview's `<tbody>` (0.24) — keksdose: the sample rows are\n   * the user's own bank data (payees, memos, amounts), and its demo mode blurs exactly\n   * that through `.demo-mode [data-private]` (#336). With nowhere to put the attribute,\n   * its map step reached into the table with a `useLayoutEffect` that set it on the\n   * `<tbody>` after every commit; `bodyProps={{ \"data-private\": \"\" }}` declares it.\n   * There is deliberately no head counterpart: the column names and the role selects\n   * are what such a mode is there to show.\n   *\n   * Spread on the kit `TableBody`; a `className` is added to its own.\n   */\n  bodyProps?: ColumnRoleTableBodyProps;\n  /**\n   * Extra attributes for one preview row's `<tr>`, from its cells and its index in the\n   * preview (0.24) — the contract of LineItems' `rowProps` (keksdose K20), on a table:\n   * `data-*` hooks (a per-row `data-private`, a test id), an `id`, a class. Called for\n   * the rows drawn, the first {@link previewRows}. The row has no attributes of its own\n   * to protect; a `className` is added after its classes.\n   */\n  rowProps?: (row: readonly string[], index: number) => ColumnRoleTableRowProps | undefined;\n  labels?: LabelOverride<ColumnMapperLabels>;\n  className?: string;\n}\n\n/**\n * A table's first rows, with a role select on every column's header.\n *\n * keksdose's mapping step (dev#462: \"make it more table like, where the table columns\n * can be chosen from the input and the column data changes with the chosen column\n * header\"): the file IS the form. The file's own column name sits on top, verbatim —\n * it is how the reader recognises the column; under it the role, picked in place;\n * under that the column's real values, so a column that is one off shows up here and\n * not after the import. A column with no role says \"Ignore\" and its values are dimmed:\n * the state that most needs to be visible in a twelve-column bank export.\n *\n * Picking a role another column holds MOVES it ({@link assignColumnRole}). What the\n * table still needs is named under it — a required group as \"either Amount, Debit or\n * Credit\". Required roles are marked in the list only where some role is not\n * (0.24): Kurvenschmiede's roles are all required, so the mark told no option from\n * another, and on a phone it cut the role's own name short (\"Zeit (s) (erforderl…\")\n * — the part of the option the reader has to read. The \"Still needed\" line already\n * says what is missing; a mark that distinguishes nothing is only noise.\n *\n * Where the mark does tell roles apart, it is short (0.25): keksdose's bank roles, on\n * a phone, still showed \"Booking date (re…\" in the closed select. The option shows\n * \"Booking date *\" ({@link ColumnMapperLabels.requiredRoleShort}) and is NAMED \"Booking\n * date (required)\" ({@link ColumnMapperLabels.requiredRole}, its `aria-label`), so a\n * screen reader hears the word rather than \"star\". And no role is cut at all: each\n * column is at least as wide as its select's longest option — the select's own width,\n * which a table cell otherwise ignores for a `w-full` control — up to 14rem, the width\n * the column's name and values already stop at. A long role name (\"Date de\n * comptabilisation\", \"Betrag (mit Vorzeichen)\") widens the columns, and the edge fade\n * says there are more of them to scroll to.\n *\n * The table scrolls sideways inside its own box (the kit {@link Table}'s wrapper, a\n * named, keyboard-reachable region while it overflows), so a wide export never widens\n * the page at 390px. An edge with columns behind it fades out (0.24, Kurvenschmiede:\n * on a phone the fourth column's select sat off-screen and nothing said there was more\n * to the right; phone scrollbars are overlays that show only while you drag). Since\n * 0.25 that is the kit Table's own `edgeFade`, not a box of this table's round it:\n * measured, so a table that fits is painted as before; both ends once scrolled into\n * the middle; the reading direction's own in RTL; never animated; a `mask-image`,\n * which changes no layout and needs no background colour to fade to. A role select\n * focused behind the fade is scrolled clear of it, cell and all, and the Table's\n * wrapper says which ends are cut in `data-overflow`.\n */\nexport function ColumnRoleTable<\n  R extends string,\n  M extends ColumnMapping<R> = ColumnMapping<R>,\n>({\n  header,\n  rows,\n  width: widthProp,\n  roles,\n  mapping,\n  onMappingChange,\n  previewRows = 5,\n  totalRows,\n  disabled,\n  bodyProps,\n  rowProps,\n  labels: labelsProp,\n  className,\n}: ColumnRoleTableProps<R, M>) {\n  const labels: ColumnMapperLabels = useKitLabels(\n    \"columnMapper\",\n    DEFAULT_COLUMN_MAPPER_LABELS,\n    labelsProp,\n  );\n  const locale = useKitLocale();\n  const shown = rows.slice(0, previewRows);\n  const width =\n    widthProp ??\n    shown.reduce(\n      (widest, row) => Math.max(widest, row.length),\n      header?.length ?? 0,\n    );\n  const columns = Array.from({ length: width }, (_, index) => index);\n  const total = totalRows ?? rows.length;\n  const nameOf = (column: number) =>\n    header?.[column] || labels.columnN(column + 1);\n  const labelOf = (value: R) =>\n    roles.find((role) => role.value === value)?.label ?? value;\n  const gaps = missingRoles(roles, mapping, width).map((gap) =>\n    gap.length === 1\n      ? labelOf(gap[0])\n      : labels.oneOf(formatList(gap.map(labelOf), \"disjunction\", locale)),\n  );\n  // The required mark only where it tells one option from another.\n  const markRequired = roles.some((role) => role.required !== true);\n\n  return (\n    <div\n      className={cn(\"min-w-0 space-y-1.5\", className)}\n      data-slot=\"column-role-table\"\n    >\n      <Table density=\"compact\" framed edgeFade aria-label={labels.table}>\n        <TableHead>\n          <TableRow>\n            {columns.map((column) => {\n              const role = roleOfColumn(roles, mapping, column);\n              const name = nameOf(column);\n              return (\n                <TableHeaderCell\n                  key={column}\n                  scope=\"col\"\n                  className=\"min-w-36 py-2 align-top\"\n                >\n                  <span className=\"block max-w-56 truncate pb-1 text-caption font-normal text-muted\">\n                    {name}\n                  </span>\n                  <Select\n                    size=\"sm\"\n                    className=\"w-full\"\n                    // Its own width (the longest option) rather than the cell's: a cell\n                    // takes no width from a `w-full` select, so the role's name was\n                    // cut at the column's 9rem minimum. Stretched to the cell when that\n                    // is wider; capped where the column's name and values stop.\n                    selectClassName=\"w-auto min-w-full max-w-56\"\n                    aria-label={labels.roleOf(name)}\n                    value={role ?? \"\"}\n                    disabled={disabled}\n                    onChange={(event) =>\n                      onMappingChange(\n                        assignColumnRole(\n                          roles,\n                          mapping,\n                          column,\n                          event.target.value === \"\"\n                            ? null\n                            : (event.target.value as R),\n                        ),\n                      )\n                    }\n                  >\n                    <option value=\"\">{labels.ignore}</option>\n                    {roles.map((option) => {\n                      const marked = option.required === true && markRequired;\n                      return (\n                        <option\n                          key={option.value}\n                          value={option.value}\n                          // The short mark on screen, the word for a screen reader.\n                          aria-label={\n                            marked ? labels.requiredRole(option.label) : undefined\n                          }\n                        >\n                          {marked\n                            ? (labels.requiredRoleShort ?? markedShort)(option.label)\n                            : option.label}\n                        </option>\n                      );\n                    })}\n                  </Select>\n                </TableHeaderCell>\n              );\n            })}\n          </TableRow>\n        </TableHead>\n        <TableBody {...bodyProps}>\n          {shown.map((row, index) => (\n            <TableRow {...rowProps?.(row, index)} key={index}>\n              {columns.map((column) => (\n                <TableCell\n                  key={column}\n                  data-ignored={\n                    roleOfColumn(roles, mapping, column) === null || undefined\n                  }\n                  className={cn(\n                    \"font-mono whitespace-nowrap\",\n                    // Dimmed, not hidden: its values are what tell you whether ignoring\n                    // it was right.\n                    roleOfColumn(roles, mapping, column) === null &&\n                      \"text-muted\",\n                  )}\n                >\n                  <span className=\"block max-w-56 truncate\">\n                    {row[column] ?? \"\"}\n                  </span>\n                </TableCell>\n              ))}\n            </TableRow>\n          ))}\n        </TableBody>\n      </Table>\n      {total > shown.length && (\n        <p className=\"text-xs text-muted\">\n          {labels.previewOf(shown.length, total)}\n        </p>\n      )}\n      {gaps.length > 0 && (\n        <AlertBanner tone=\"warning\" variant=\"inline\" size=\"sm\" block>\n          {labels.missing(formatList(gaps, \"conjunction\", locale))}\n        </AlertBanner>\n      )}\n    </div>\n  );\n}\n\n// ── ColumnMapper ──────────────────────────────────────────────────────────────\n\nexport interface ColumnMapperProps<R extends string> {\n  /** The parts the columns play — translated labels, which are required, which must\n   *  be numbers. See {@link ColumnRole}. */\n  roles: readonly ColumnRole<R>[];\n  /**\n   * The table read through the current mapping, on every change: the text, the header\n   * checkbox, a role. `null` while there is no table at all (an empty box). Use it when\n   * `result.complete`; until then `result.missing` says what is not placed yet.\n   *\n   * The rows are strings. A numeric role's cells are guaranteed to read with\n   * `tableNumber(cell, result.decimalComma)`; anything else is the caller's to convert.\n   */\n  onChange: (result: ColumnMapperResult<R> | null) => void;\n  /** The paste box's label. Default: `labels.paste`. */\n  label?: ReactNode;\n  /** The caption under the paste box. Default: `labels.pasteHint`. */\n  hint?: ReactNode;\n  /** What the file dialog offers, and what a drop is checked against. Default:\n   *  `.csv,.tsv,.txt,.dat,.asc`. */\n  accept?: string;\n  /** The largest file taken, in bytes. Default: no limit. */\n  maxSize?: number;\n  /** Text to start with. `onChange` is called with its result once, on mount. */\n  defaultText?: string;\n  /** Rows in the preview. Default 5. */\n  previewRows?: number;\n  /** The first mapping for a new table. Default {@link guessMapping}: a column named\n   *  like a role gets it, and the required roles left over take the free columns in\n   *  order. */\n  guess?: (table: TextTable) => ColumnMapping<R>;\n  disabled?: boolean;\n  /** The preview table's `<tbody>` attributes — {@link ColumnRoleTableProps.bodyProps}\n   *  (0.24): `{ \"data-private\": \"\" }` for a table of someone's own data. */\n  bodyProps?: ColumnRoleTableBodyProps;\n  /** One preview row's `<tr>` attributes — {@link ColumnRoleTableProps.rowProps}\n   *  (0.24). `row` is the row as read, `index` its place in the preview. */\n  rowProps?: (row: readonly string[], index: number) => ColumnRoleTableRowProps | undefined;\n  labels?: LabelOverride<ColumnMapperLabels>;\n  className?: string;\n}\n\ninterface MapperState<R extends string> {\n  text: string;\n  /** The reader's answer to \"does the first line name the columns\", or `null` for\n   *  the parse's own. */\n  header: boolean | null;\n  table: TextTable;\n  mapping: ColumnMapping<R>;\n}\n\nconst hasFiles = (event: DragEvent) =>\n  Array.from(event.dataTransfer?.types ?? []).includes(\"Files\");\n\n/**\n * Paste, drop or choose a table, see what it was read as, and say which column is\n * which — Kurvenschmiede's playground signal and comparison input as one kit part.\n *\n * Everything the parse assumed is stated, because a guess the reader cannot see is a\n * guess they cannot correct: the shape it found, the separator, the decimal\n * convention (\"decimal comma (1,5)\"), and every line it could not read, by number and\n * with its text. The header line is a checkbox, since the detection is a guess either\n * way and toggling it does not move a column (the mapping is kept, keksdose's\n * `keepRoles`). A new file is a new table and is mapped afresh; typing that changes the\n * column count re-guesses, because the old indexes point at nothing.\n *\n * A file can be chosen, dropped on the button, or dropped on the paste box — which,\n * left to the browser, would open the file in place of the page. It is read as UTF-8,\n * or as Windows-1252 when it is not UTF-8 ({@link readTextFile}).\n *\n * A two-step wizard that keeps the drop and the mapping apart (keksdose's) uses the\n * parts: {@link parseTextTable} or its own server's sniff, then {@link ColumnRoleTable},\n * then {@link readMappedTable}.\n */\nexport function ColumnMapper<R extends string>({\n  roles,\n  onChange,\n  label,\n  hint,\n  accept = DEFAULT_ACCEPT,\n  maxSize,\n  defaultText = \"\",\n  previewRows = 5,\n  guess,\n  disabled = false,\n  bodyProps,\n  rowProps,\n  labels: labelsProp,\n  className,\n}: ColumnMapperProps<R>) {\n  const labels: ColumnMapperLabels = useKitLabels(\n    \"columnMapper\",\n    DEFAULT_COLUMN_MAPPER_LABELS,\n    labelsProp,\n  );\n  const firstMapping = (table: TextTable) =>\n    guess ? guess(table) : guessMapping(roles, table.header, table.width);\n  const [state, setState] = useState<MapperState<R>>(() => {\n    const table = parseTextTable(defaultText);\n    return {\n      text: defaultText,\n      header: null,\n      table,\n      mapping: firstMapping(table),\n    };\n  });\n  const [reading, setReading] = useState(false);\n  const [refusal, setRefusal] = useState<string | null>(null);\n  const [dragOver, setDragOver] = useState(false);\n\n  // What is drawn and what is handed over are the same computation. Not memoised: a\n  // caller writes `roles={[…]}` inline, so a memo keyed on them would miss every time,\n  // and the read is one pass over rows that are already split.\n  const result = readMappedTable(state.table, roles, state.mapping);\n\n  const commit = (next: MapperState<R>) => {\n    setState(next);\n    onChange(\n      next.table.width === 0\n        ? null\n        : readMappedTable(next.table, roles, next.mapping),\n    );\n  };\n\n  /** New text. `fresh` (a file): the reader's header answer and the mapping start over. */\n  const take = (text: string, fresh: boolean) => {\n    const header = fresh ? null : state.header;\n    const table = parseTextTable(text, header === null ? {} : { header });\n    const keep =\n      !fresh && table.width === state.table.width && state.table.width > 0;\n    commit({\n      text,\n      header,\n      table,\n      mapping: keep ? state.mapping : firstMapping(table),\n    });\n  };\n\n  const load = (file: File) => {\n    setRefusal(null);\n    setReading(true);\n    void readTextFile(file)\n      .then(\n        (text) => take(text, true),\n        // Only the read: an error thrown by the caller's onChange is not the file's.\n        () => setRefusal(labels.readError(file.name)),\n      )\n      .finally(() => setReading(false));\n  };\n\n  const refuse = (rejections: { message: string }[]) =>\n    setRefusal(rejections[0]?.message ?? null);\n\n  // A file dropped on the paste box. The same screening as the button's.\n  const drop = useFilePicker({\n    accept,\n    maxSize,\n    disabled,\n    onFiles: ([file]) => load(file),\n    onReject: refuse,\n  });\n\n  const seeded = useEffectEvent(() => {\n    if (state.table.width > 0) onChange(result);\n  });\n  useEffect(() => {\n    seeded();\n  }, []);\n\n  const { table } = state;\n  const separator = labels[SEPARATOR_LABEL[table.separator]];\n  const unread = result.unread;\n\n  return (\n    <div\n      className={cn(\"min-w-0 space-y-3\", className)}\n      data-slot=\"column-mapper\"\n    >\n      <Textarea\n        label={label ?? labels.paste}\n        hint={hint ?? labels.pasteHint}\n        rows={5}\n        wrap=\"off\"\n        spellCheck={false}\n        autoCapitalize=\"off\"\n        autoCorrect=\"off\"\n        value={state.text}\n        disabled={disabled}\n        className={cn(\n          \"font-mono text-xs\",\n          dragOver && \"rounded-md ring-2 ring-brand\",\n        )}\n        data-drag-over={dragOver || undefined}\n        onChange={(event: ChangeEvent<HTMLTextAreaElement>) => {\n          setRefusal(null);\n          take(event.target.value, false);\n        }}\n        onDragEnter={(event) => {\n          if (!hasFiles(event)) return;\n          event.preventDefault();\n          if (!disabled) setDragOver(true);\n        }}\n        onDragOver={(event) => {\n          if (!hasFiles(event)) return;\n          // Cancelled for every file drag: an uncancelled one makes the browser open\n          // the file in place of the page.\n          event.preventDefault();\n          event.dataTransfer.dropEffect = disabled ? \"none\" : \"copy\";\n        }}\n        onDragLeave={() => setDragOver(false)}\n        onDrop={(event) => {\n          if (!hasFiles(event)) return;\n          event.preventDefault();\n          setDragOver(false);\n          drop.take(event.dataTransfer.files);\n        }}\n      />\n      {drop.element}\n\n      <div className=\"flex flex-wrap items-center gap-x-4 gap-y-2\">\n        <FileButton\n          variant=\"secondary\"\n          accept={accept}\n          maxSize={maxSize}\n          droppable\n          pending={reading}\n          disabled={disabled}\n          onFiles={([file]) => load(file)}\n          onReject={refuse}\n        >\n          <Upload className=\"size-4\" aria-hidden />\n          {labels.chooseFile}\n        </FileButton>\n        {table.width > 0 && (\n          <Checkbox\n            label={labels.headerRow}\n            checked={table.header !== null}\n            disabled={disabled}\n            onCheckedChange={(checked) => {\n              const next = parseTextTable(state.text, { header: checked });\n              // Same text, same split: the columns are where they were, and so are the\n              // roles on them.\n              commit({ ...state, header: checked, table: next });\n            }}\n          />\n        )}\n      </div>\n\n      {refusal && (\n        <AlertBanner tone=\"danger\" variant=\"inline\" size=\"sm\" block>\n          {refusal}\n        </AlertBanner>\n      )}\n\n      {table.width > 0 && (\n        <>\n          <p\n            className=\"text-xs text-secondary\"\n            data-slot=\"column-mapper-summary\"\n          >\n            {[\n              labels.summary(table.width, result.rows.length),\n              separator,\n              table.decimalComma ? labels.decimalComma : labels.decimalPoint,\n            ].join(\" · \")}\n          </p>\n          {result.rows.length === 0 && (\n            <AlertBanner tone=\"warning\" variant=\"inline\" size=\"sm\" block>\n              {labels.noRows}\n            </AlertBanner>\n          )}\n          <ColumnRoleTable\n            header={table.header}\n            rows={result.rows}\n            width={table.width}\n            roles={roles}\n            mapping={state.mapping}\n            onMappingChange={(mapping) => commit({ ...state, mapping })}\n            previewRows={previewRows}\n            disabled={disabled}\n            bodyProps={bodyProps}\n            rowProps={rowProps}\n            labels={labelsProp}\n          />\n          {unread.length > 0 && (\n            <Disclosure\n              variant=\"bare\"\n              title={labels.unreadCount(unread.length)}\n              data-slot=\"column-mapper-unread\"\n            >\n              <ul className=\"space-y-1 text-xs\">\n                {unread.slice(0, UNREAD_LISTED).map((line) => (\n                  <li key={line.line} className=\"min-w-0\">\n                    <span className=\"block text-secondary\">\n                      {labels.unreadLine(line.line)}\n                    </span>\n                    <code className=\"block truncate font-mono text-muted\">\n                      {line.text}\n                    </code>\n                  </li>\n                ))}\n                {unread.length > UNREAD_LISTED && (\n                  <li className=\"text-muted\">\n                    {labels.unreadMore(unread.length - UNREAD_LISTED)}\n                  </li>\n                )}\n              </ul>\n            </Disclosure>\n          )}\n        </>\n      )}\n    </div>\n  );\n}\n"],"mappings":"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","names":["table"]}

package/dist/components/combobox-core.d.ts

@@ -1,8 +1,6 @@
-import * as react from 'react';
-import { ReactNode, RefObject, Dispatch, SetStateAction, ComponentPropsWithoutRef } from 'react';
-import { AnchorRect } from '../hooks/use-anchored-rect.js';
-import { AnchoredPanel } from '../hooks/use-anchored-panel.js';
-
+import type { ComponentPropsWithoutRef, Dispatch, ReactNode, RefObject, SetStateAction } from "react";
+import { type AnchorRect } from "../hooks/use-anchored-rect.js";
+import { type AnchoredPanel } from "../hooks/use-anchored-panel.js";
 /**
  * What an entity picker hands `onChange` when it is cleared — `clearValue` on
  * {@link EntityCombobox} and {@link InlineEntityCombobox}. `null` by default.
@@ -16,8 +14,8 @@ import { AnchoredPanel } from '../hooks/use-anchored-panel.js';
  * No `undefined`: a prop set to `undefined` is a prop not passed, so it would read as
  * the default and emit `null` — the one outcome the caller had asked not to get.
  */
-type ComboClearValue = null | "";
-interface ComboOption<V extends string | number> {
+export type ComboClearValue = null | "";
+export interface ComboOption<V extends string | number> {
     value: V;
     label: string;
     sublabel?: string;
@@ -44,7 +42,7 @@ interface ComboOption<V extends string | number> {
     disabled?: boolean;
 }
 /** A row the user may take — present and not {@link ComboOption.disabled}. */
-declare const isOptionEnabled: (o: {
+export declare const isOptionEnabled: (o: {
     disabled?: boolean;
 } | undefined) => boolean;
 /**
@@ -53,18 +51,18 @@ declare const isOptionEnabled: (o: {
  * list (the family's arrows clamp rather than wrap) and answers `-1` when `from` is
  * not a row and there is nothing to step to.
  */
-declare function stepEnabled(rows: readonly {
+export declare function stepEnabled(rows: readonly {
     disabled?: boolean;
 }[], from: number, dir: 1 | -1): number;
 /** `i` when that row is takeable, else the nearest takeable one after it, else
  *  before it, else `-1`. For a highlight that starts on a fixed index (the panel
  *  pickers open on row 0) and must never rest on a disabled row. */
-declare function settleEnabled(rows: readonly {
+export declare function settleEnabled(rows: readonly {
     disabled?: boolean;
 }[], i: number): number;
 /** Classes a disabled row adds over its normal ones — dimmed, no hover, the
  *  kit's soft-disabled look (`DangerConfirm`, `SignaturePad`). */
-declare const DISABLED_ROW_CLASS = "cursor-not-allowed opacity-50 hover:bg-transparent";
+export declare const DISABLED_ROW_CLASS = "cursor-not-allowed opacity-50 hover:bg-transparent";
 /**
  * Whether an entity picker offers its create row — one rule for
  * {@link EntityCombobox}, {@link MultiEntityCombobox} and {@link InlineEntityCombobox}.
@@ -78,7 +76,7 @@ declare const DISABLED_ROW_CLASS = "cursor-not-allowed opacity-50 hover:bg-trans
  * `names` is what the query is compared against: the loaded rows for a panel picker
  * (its async list is all it knows), every option for the inline one.
  */
-declare function offersCreate(onCreate: unknown, query: string, names: readonly string[], createEmptyLabel: string | undefined): boolean;
+export declare function offersCreate(onCreate: unknown, query: string, names: readonly string[], createEmptyLabel: string | undefined): boolean;
 /**
  * {@link EndHintRow}'s `hint` and `className` for a combobox-family field, keeping the
  * 0.22 rule (keksdose): a field that was passed `hint` at all — even `undefined` — keeps
@@ -91,7 +89,7 @@ declare function offersCreate(onCreate: unknown, query: string, names: readonly
  * went. With `hint` passed the row stays, its end slot empty and its gap closed, so
  * nothing on screen moves either.
  */
-declare function endHintRowProps(hintPassed: boolean, hasLabel: boolean, labelHint: ReactNode | undefined): {
+export declare function endHintRowProps(hintPassed: boolean, hasLabel: boolean, labelHint: ReactNode | undefined): {
     hint: ReactNode | undefined;
     className?: string;
 };
@@ -103,15 +101,15 @@ declare function endHintRowProps(hintPassed: boolean, hasLabel: boolean, labelHi
  * compose their own "label: value" name. `pointer-events-none` (from the class)
  * keeps a press on it landing on the field under it, as before.
  */
-declare function ComboboxFieldLabel({ htmlFor, className, children, ...rest }: ComponentPropsWithoutRef<"label"> & {
+export declare function ComboboxFieldLabel({ htmlFor, className, children, ...rest }: ComponentPropsWithoutRef<"label"> & {
     htmlFor: string;
-}): react.JSX.Element;
+}): import("react").JSX.Element;
 /**
  * Where a combobox's rows come from, and how a query narrows them. Shared by the
  * trigger pickers ({@link useComboboxCore}) and the inline {@link Autocomplete}, so
  * the two cannot drift in what a failed lookup or a too-short query does.
  */
-interface OptionSourceOptions<V extends string | number> {
+export interface OptionSourceOptions<V extends string | number> {
     /** Already-loaded options (client-side filtered unless `filter` is false), also
      *  used to resolve labels. */
     options?: ComboOption<V>[];
@@ -121,7 +119,8 @@ interface OptionSourceOptions<V extends string | number> {
     /** External loading flag, OR-ed with the internal async state. */
     loading?: boolean;
     /**
-     * Narrow `options` by the query (label/sublabel substring). Default `true`.
+     * Narrow `options` by the query (label/sublabel substring, folded for search: no case,
+     * no accents, the locale's case rules — "zurich" finds Zürich, DUP-5). Default `true`.
      *
      * `false` shows `options` exactly as given, in the given order — for a list the
      * caller has already searched and ranked on a server (Keksdose's geocoder), which a
@@ -140,7 +139,7 @@ interface OptionSourceOptions<V extends string | number> {
     /** Quiet time after the last keystroke before `loadOptions` runs. Default 150 ms. */
     debounceMs?: number;
 }
-interface OptionSource<V extends string | number> {
+export interface OptionSource<V extends string | number> {
     results: ComboOption<V>[];
     busy: boolean;
     /** The last lookup for this query REJECTED. The rows are emptied with it: results
@@ -158,12 +157,21 @@ interface OptionSource<V extends string | number> {
  * effect, so there is no render between a keystroke and the debounce in which an
  * empty list could claim "No results" for a question still being asked.
  */
-declare function useOptionSource<V extends string | number>({ options, loadOptions, loading, filter, minChars, debounceMs, query, active, }: OptionSourceOptions<V> & {
+export declare function useOptionSource<V extends string | number>({ options, loadOptions, loading, filter, minChars, debounceMs, query, active, }: OptionSourceOptions<V> & {
     query: string;
     active: boolean;
 }): OptionSource<V>;
-type ComboboxCoreOptions<V extends string | number> = OptionSourceOptions<V>;
-interface ComboboxCore<V extends string | number> {
+export interface ComboboxCoreOptions<V extends string | number> extends OptionSourceOptions<V> {
+    /**
+     * Back closes the open anchored list, not the page or the dialog behind it — the rule
+     * `useDropdown` keeps for its lists (keksdose live #309 rework). Default `false`, as the
+     * entity pickers have always been; CurrencySelect, MultiSelect, GroupedPicker and
+     * AmountInput's currency chip, which came over from `useDropdown` (DUP-4), pass `true`
+     * so they keep it. On a phone the `PickerSheet` registers Back itself.
+     */
+    backCloses?: boolean;
+}
+export interface ComboboxCore<V extends string | number> {
     triggerRef: RefObject<HTMLButtonElement | null>;
     panelRef: RefObject<HTMLDivElement | null>;
     inputRef: RefObject<HTMLInputElement | null>;
@@ -198,22 +206,11 @@ interface ComboboxCore<V extends string | number> {
  * and multi-value comboboxes render their triggers on top of this and share
  * {@link ComboboxPanel} for the dropdown.
  */
-declare function useComboboxCore<V extends string | number>({ options, minChars, ...source }: ComboboxCoreOptions<V>): ComboboxCore<V>;
-/**
- * {@link Input}'s `error` for the combobox family: the message under the field, its
- * id on the control's `aria-describedby` (merged, never replacing — the hint the
- * caller pointed at stays first), and `invalid` implied. ui.tsx's `useFieldError` is
- * module-private, so this restates it on the same rules `choice-parts.ts` does.
- */
-declare function useComboboxFieldError(error: ReactNode, invalid: boolean | undefined, describedBy?: string): {
-    isInvalid: boolean;
-    describedBy: string | undefined;
-    errorEl: react.JSX.Element | null;
-};
+export declare function useComboboxCore<V extends string | number>({ options, minChars, backCloses, ...source }: ComboboxCoreOptions<V>): ComboboxCore<V>;
 /** The anchored suggestion list's box and rows — one look for {@link Combobox},
  *  {@link InlineEntityCombobox} and {@link Autocomplete}. */
-declare const SUGGESTION_LIST_CLASS = "max-h-64 overflow-y-auto rounded-md border border-[var(--border)] bg-[var(--bg-surface)] py-1 shadow-lg";
-declare const suggestionRowClass: (isActive: boolean) => string;
+export declare const SUGGESTION_LIST_CLASS = "max-h-64 overflow-y-auto rounded-md border border-subtle bg-surface py-1 shadow-lg";
+export declare const suggestionRowClass: (isActive: boolean) => string;
 /**
  * Keep the option the keyboard is on inside the visible part of the list.
  *
@@ -226,8 +223,28 @@ declare const suggestionRowClass: (isActive: boolean) => string;
  * run this component in their own suites, and a picker that throws there is a worse
  * trade than a list that does not scroll in a test.
  */
-declare function useActiveOptionScroll(activeId: string | undefined): void;
-interface ComboboxPanelProps<V extends string | number> extends ComponentPropsWithoutRef<"div"> {
+export declare function useActiveOptionScroll(activeId: string | undefined): void;
+/**
+ * How wide the anchored panel is. The phone sheet is the screen's width whatever this
+ * says.
+ */
+export interface ComboboxPanelWidth {
+    /** The least width, in rem — never under the trigger's own. Default 13.75 (220 px at
+     *  Normal, §3.2). */
+    minRem?: number;
+    /**
+     * As wide as the rows make it (`max-content`), between the least width and `maxRem`,
+     * instead of exactly the least — measured, so the clamp to the glass still knows it.
+     * CurrencySelect's list grows to show the full currency names (feedback #308);
+     * MultiSelect's rows to show their hints (keksdose #147). A `w-*` class in the panel's
+     * `className` does not apply: the panel is portalled to <body>, where `w-full` would be
+     * the screen.
+     */
+    fit?: boolean;
+    /** With `fit`, the most it grows to, in rem. Default: the glass. */
+    maxRem?: number;
+}
+export interface ComboboxPanelProps<V extends string | number> extends ComponentPropsWithoutRef<"div"> {
     core: ComboboxCore<V>;
     /** What the trigger's `aria-controls` names. Owned by the component that renders
      *  the trigger, not by the core: one id has to reach both, and only one of them
@@ -256,6 +273,30 @@ interface ComboboxPanelProps<V extends string | number> extends ComponentPropsWi
     closeLabel?: string;
     /** Default: `combobox.loadError` from the {@link UiKitProvider}, else English. */
     loadErrorLabel?: string;
+    /**
+     * What a row shows in place of its label and sublabel — for a row that says more than
+     * two strings: CurrencySelect's symbol, code and name side by side. The option's
+     * `icon`, the multi checkbox and the check mark stay the panel's. Its text is the
+     * option's accessible name, so separate the parts with a space.
+     */
+    renderOption?: (o: ComboOption<V>) => ReactNode;
+    /** Controls between the search box and the list, in the anchored panel and the phone
+     *  sheet alike — MultiSelect's "Select all" and "Clear". */
+    toolbar?: ReactNode;
+    /** See {@link ComboboxPanelWidth}. */
+    width?: ComboboxPanelWidth;
+    /** Which of the trigger's edges the anchored panel hangs from, by reading direction.
+     *  Default `start`; `end` grows the panel toward the start, so a field with content
+     *  after it is not pushed past the page (CurrencySelect, feedback #308). */
+    align?: "start" | "end";
+    /**
+     * Lay the rows out in columns, one block per `group`, with the group's name above it —
+     * GroupedPicker's panel (feedback #267/#276): a large grouped set reads as a sheet of
+     * short lists side by side rather than one long one. Each block is a `role="group"`
+     * named by its heading. The arrow keys walk the rows in reading order, down each
+     * column. The phone sheet keeps one column with headings.
+     */
+    columns?: boolean;
 }
 /**
  * The portalled dropdown (search header + result rows + optional create row)
@@ -283,6 +324,4 @@ interface ComboboxPanelProps<V extends string | number> extends ComponentPropsWi
  * `tabIndex={-1}` because focus never leaves the search box — that is what
  * `aria-activedescendant` is FOR.
  */
-declare function ComboboxPanel<V extends string | number>({ core, listboxId, searchPlaceholder, emptyLabel, multi, isSelected, onChoose, showCreate, onCreate, createContent, createDisabledReason, sheetTitle, closeLabel, loadErrorLabel, className, style, ...rest }: ComboboxPanelProps<V>): react.JSX.Element | null;
-
-export { type ComboClearValue, type ComboOption, type ComboboxCore, type ComboboxCoreOptions, ComboboxFieldLabel, ComboboxPanel, type ComboboxPanelProps, DISABLED_ROW_CLASS, type OptionSource, type OptionSourceOptions, SUGGESTION_LIST_CLASS, endHintRowProps, isOptionEnabled, offersCreate, settleEnabled, stepEnabled, suggestionRowClass, useActiveOptionScroll, useComboboxCore, useComboboxFieldError, useOptionSource };
+export declare function ComboboxPanel<V extends string | number>({ core, listboxId, searchPlaceholder, emptyLabel, multi, isSelected, onChoose, showCreate, onCreate, createContent, createDisabledReason, sheetTitle, closeLabel, loadErrorLabel, renderOption, toolbar, width, align, columns, className, style, ...rest }: ComboboxPanelProps<V>): import("react").JSX.Element | null;