@eifi1/ui-kit 0.51.7 → 0.53.0

package/dist/components/row-actions.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/row-actions.tsx"],"sourcesContent":["import { isValidElement, useContext } from \"react\";\nimport type { KeyboardEvent, MouseEvent, ReactElement, ReactNode } from \"react\";\nimport { MoreHorizontal } from \"lucide-react\";\nimport type { LucideIcon } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { useLargeText } from \"../hooks/use-large-text\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { Popover } from \"./popover\";\nimport { Button } from \"./button\";\nimport { CompactControls } from \"./field-parts\";\nimport { IconButton } from \"./icon-button\";\nimport { useCommitReason, type CommitScope } from \"./write-lock\";\nimport type { IconButtonGlyphSize, IconButtonSize } from \"./icon-button\";\nimport type { TooltipSide } from \"./tooltip\";\nimport type { DataTableColumn } from \"./data-table\";\nimport { TableHeaderCell, type TableHeaderCellProps } from \"./table\";\nimport { DEFAULT_ROW_ACTIONS_LABELS } from \"./row-actions-labels\";\nimport { ConfirmContext } from \"./confirm-context\";\nimport { ConfirmProvider } from \"./confirm-dialog\";\n\n/**\n * A row's actions — inline icons at Normal, one \"⋯\" menu at Large and above\n * (docs/text-size-harmonization.md §10.8).\n *\n * At Large an IconButton shows its label as text (§4). In a dense row — a register's\n * action column, a list row's end — every label at once does not fit: Kurvenschmiede\n * has 44 IconButtons in rows, kastlan 119. So a row's actions collapse instead, into\n * the menu the user roster has used since 0.31 (`UserRowActions`, now built on this):\n * one \"⋯\" button, and a menu with each action's icon AND words, where a locked one stays\n * listed and says why.\n *\n * The data is the roster's `UserRowActionList`, generalised: entries, and `false` /\n * `null` for the ones a condition left out (`row.locked || {…}`).\n *\n * Destructive actions belong in the menu (0.49 KIT-12): a `tone: \"danger\"` action goes\n * into the \"⋯\" menu while the others stay inline (`dangerPlacement`), and choosing it\n * opens a `ConfirmDialog` before `onSelect` runs (`confirm`; `false` to opt out). A\n * delete is then never a bin icon in every row, one stray tap from gone.\n *\n * 0.33 (§10.16): an action carries its state at both sizes — a toggle (`pressed`), a\n * disclosure (`expanded`, `controls`), a tone, a tour anchor (`dataTour`) — so a row\n * with an \"on\" share button or a tour step no longer keeps hand-rolled IconButtons at\n * Normal and this only at Large (keksdose k15).\n */\n\n/** An action's colour: IconButton's tone inline; in the menu the glyph takes it and the\n *  words keep the text colour, except `danger`, whose words are the danger text. */\nexport type RowActionTone = \"default\" | \"muted\" | \"info\" | \"warning\" | \"danger\";\n\n/** One action of a row. */\nexport interface RowAction {\n  /** React key. Default: the label. */\n  key?: string;\n  /** The action's name: the inline icon's name and tooltip, the menu entry's words. */\n  label: string;\n  /**\n   * Runs it. The kit sends nothing — it calls this, after a `tone: \"danger\"` action's\n   * confirmation (see {@link confirm}). Optional only beside `href`; an action has one or\n   * the other (or both: `onSelect` then runs as the link is followed).\n   */\n  onSelect?: () => void;\n  /**\n   * 0.49 KIT-12: ask before `onSelect`. A `tone: \"danger\"` action asks by default — a\n   * `ConfirmDialog` (the provider's `useConfirm`, else one of its own) titled with the\n   * action and the row's name, \"Delete “Ada Example”?\", the consequence under it\n   * (`rowActions.confirmBody`), the action's label on the danger button and focus on\n   * Cancel. Pass the words to say more, or `false` when the app confirms in `onSelect`\n   * itself or offers an undo instead. Any other tone asks only when given one. Not for\n   * an `href` action: a link only navigates.\n   */\n  confirm?: boolean | RowActionConfirm;\n  /**\n   * The action NAVIGATES — an edit page, a mail to compose (0.32.1, kastlan's 0.32\n   * report): a real link inline and in the menu, so open in a new tab, a middle click\n   * and the URL on hover work, which `onSelect` + `navigate` lost. The kit's link rule\n   * applies ({@link Button}'s `href`): in-app through the provider's `linkComponent`, an\n   * external or `#anchor` one a plain `<a>`, `mailto:` included.\n   *\n   * A link cannot carry a reason or a spinner, so an action with a `disabledReason`\n   * (or under a write lock, with `commit`) or `pending` stays a button and says why.\n   */\n  href?: string;\n  /** With `href`: leaves the app — a new tab, and a screen reader is told so. */\n  external?: boolean;\n  /**\n   * The glyph: a Lucide icon (`Pencil`), or an element (`<Pencil />`, an app's own\n   * svg) — DataTable's `rowActions` hand their `icon` node through. Inline, an action\n   * without one is a small text button; in the menu it is the words alone.\n   */\n  icon?: LucideIcon | ReactElement;\n  /**\n   * `danger` for delete, revoke, erase: the quiet red of IconButton's `tone=\"danger\"`\n   * inline, the danger text tone in the menu. `muted` (an open or add that should not\n   * compete), `info` (a notice-worthy, harmless action: keksdose's reconcile) and\n   * `warning` (a flag that wants attention): IconButton's tone inline; in the menu the\n   * glyph takes it and the words keep the text colour, so `muted` looks like `default`\n   * there (0.33).\n   */\n  tone?: RowActionTone;\n  /** Why it is not available for this row. It stays listed, focusable, and says so — an\n   *  action that silently vanished would leave the reader looking for it. */\n  disabledReason?: ReactNode;\n  /**\n   * This action COMMITS — it saves, sends, deletes: under a locked\n   * {@link WriteLockProvider} it is refused with the lock's reason, as {@link Button}'s\n   * `commit` is, inline and in the menu alike. No provider, or an unlocked one: no effect.\n   */\n  commit?: CommitScope;\n  /**\n   * In flight — the request it started has not answered. Inline, the icon turns into\n   * IconButton's spinner (`pending`); collapsed, the \"⋯\" button does, since the menu\n   * closed when the action was chosen. Either way nothing in the row can be pressed again\n   * until it settles: the \"⋯\" opens no menu while busy.\n   */\n  pending?: boolean;\n  /**\n   * Not available for a moment, with nothing to explain — another action of the list\n   * is in flight (an admin panel's `busy`). The plain `disabled`; a lasting refusal is a\n   * `disabledReason`, which says why.\n   */\n  disabled?: boolean;\n  /** Leave it out for this row. */\n  hidden?: boolean;\n  /**\n   * A toggle (0.33): `aria-pressed` and IconButton's \"on\" look inline, `aria-pressed` on\n   * the menu entry. Keep the label the same in both states (\"Share budget\"): the pressed\n   * state already says whether it is on. Not on an `href` action — a link is not a\n   * toggle — nor with `expanded`.\n   */\n  pressed?: boolean;\n  /**\n   * Opens or closes something IN THE PAGE (0.33) — a share card under the row, an\n   * add-category row: `aria-expanded`, inline and on the menu entry. Not with `pressed`:\n   * a disclosure says open, not on. Not on an `href` action.\n   */\n  expanded?: boolean;\n  /** The `id` of what `expanded` opens: `aria-controls`, inline and on the menu entry. */\n  controls?: string;\n  /**\n   * A tour anchor (0.33, §10.18): `data-tour` on ONE element per action at a time.\n   * Inline, on the action's own control (the IconButton, the small text button, the\n   * link). Collapsed, on an `aria-hidden` box laid over the \"⋯\" button — `[data-tour=x]`\n   * resolves to a box the size of the \"⋯\", whose `data-slot=\"row-actions\"` box holds the\n   * button, two anchored actions in one row don't fight over one attribute, and a tap\n   * still reaches the button. Never on the entry in the open menu: the kit's tour takes\n   * the first visible match and the menu is portalled after the row, so a copy there\n   * would never be found, only make the selector match twice. The kit's name for it, as\n   * `AppShellNavItem.dataTour`.\n   */\n  dataTour?: string;\n}\n\n/** The words of a {@link RowAction.confirm}; each defaults as described there. */\nexport interface RowActionConfirm {\n  title?: ReactNode;\n  body?: ReactNode;\n  confirmLabel?: ReactNode;\n}\n\n/** What a row's actions may be: entries, and `false` / `null` / `undefined` for the ones\n *  a condition left out. */\nexport type RowActionList = readonly (RowAction | false | null | undefined)[];\n\nexport interface RowActionsLabels {\n  /** The menu button's name when the row has no name of its own; also the actions\n   *  column's (hidden) header in {@link rowActionsColumn}. */\n  actions: string;\n  /** The menu button's name, given the row's: \"Actions for Ada Example\". */\n  actionsFor: (name: string) => string;\n  /** 0.49 KIT-12: a danger action's confirmation title, given the action's label and the\n   *  row's name when it has one: \"Delete “Ada Example”?\", \"Delete?\". */\n  confirmTitle: (action: string, name?: string) => string;\n  /** 0.49 KIT-12: the line under it — \"This cannot be undone.\" */\n  confirmBody: string;\n}\n\n// Defined in ./row-actions-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_ROW_ACTIONS_LABELS };\n\n/**\n * - `\"auto\"` (default): the icons inline at Normal; the \"⋯\" menu at Large and Extra\n *   large once there are two or more (§10.8). A single action stays inline at every\n *   size, with its label as text at Large — one label fits a row, and a menu of one is\n *   a detour.\n * - `\"menu\"`: the menu at every size — the roster's choice, whose actions grow (§2.4\n *   there) and do not fit a phone card as a strip.\n * - `\"inline\"`: the icons at every size — for a row the app knows has room; at Large\n *   each then shows its label (IconButton's `labelVisible`).\n */\nexport type RowActionsCollapse = \"auto\" | \"menu\" | \"inline\";\n\n/** The sizes a row action comes in: IconButton's row steps. `2xs` is DataTable's\n *  compact density. At Large every one is at least a 48 px target (IconButton). */\nexport type RowActionsSize = Extract<IconButtonSize, \"md\" | \"sm\" | \"xs\" | \"2xs\">;\n\nexport interface RowActionsProps {\n  actions: RowActionList;\n  /**\n   * 0.49 KIT-12: where `tone: \"danger\"` actions go while the others are inline. `\"menu\"`\n   * (default): into the row's \"⋯\" menu, so a delete is never one stray tap in every\n   * row — the other actions stay icons beside it. `\"inline\"`: an icon like the rest.\n   * `collapse=\"inline\"` keeps every action inline, `collapse=\"menu\"` every one in the menu.\n   */\n  dangerPlacement?: \"menu\" | \"inline\";\n  /** The row's name, for the menu button's name — \"Actions for Ada Example\". Without it\n   *  (or `null`, as API fields often are) the button is \"Actions\". */\n  name?: string | null;\n  /** When the actions collapse into the menu — see {@link RowActionsCollapse}. */\n  collapse?: RowActionsCollapse;\n  /** The inline icons' and the \"⋯\" button's size. Default `xs`, a list row's action. */\n  size?: RowActionsSize;\n  /** The menu's width. Default `\"15rem\"`, in rem so it grows with the words (§3.2). */\n  menuWidth?: `${number}rem`;\n  /** On the wrapper: the inline strip, or the box round the \"⋯\" button. */\n  className?: string;\n  /** The inline glyphs' size, IconButton's `glyphSize` — e.g. 14 in a dense header strip\n   *  (keksdose's category group header). The \"⋯\" button keeps its box's own. */\n  glyphSize?: IconButtonGlyphSize;\n  /** The inline tooltips' side, IconButton's `tooltipSide` — `\"start\"` for a table's last\n   *  column, so a bubble does not run off the row's end. Per row: every inline action. */\n  tooltipSide?: TooltipSide;\n  labels?: LabelOverride<RowActionsLabels>;\n}\n\nfunction visibleActions(actions: RowActionList): RowAction[] {\n  return actions.filter((a): a is RowAction => Boolean(a) && !(a as RowAction).hidden);\n}\n\n/** An action's glyph as a node: a component is rendered, an element is used as is. */\nfunction glyphOf(icon: RowAction[\"icon\"]): ReactNode {\n  if (icon === undefined) return null;\n  if (isValidElement(icon)) return icon;\n  const Icon = icon as LucideIcon;\n  return <Icon />;\n}\n\n/** The menu glyph's tint per tone (0.33): the words keep the text colour, so the glyph\n *  carries `info` and `warning` — IconButton's toned colours. `danger` colours the words\n *  through Button's tone, and `muted` is the default look in a menu. */\nconst MENU_GLYPH_TONE: Partial<Record<RowActionTone, string>> = {\n  info: \"text-info\",\n  warning: \"text-warning\",\n};\n\n/** The state an action's control says, inline and in the menu alike: `aria-expanded` and\n *  `aria-controls` for a disclosure (a toggle's `aria-pressed` goes through the button's\n *  own `pressed`, which also draws the \"on\" look). */\nfunction stateAttrs(action: RowAction) {\n  return {\n    \"aria-expanded\": action.expanded,\n    \"aria-controls\": action.expanded === undefined ? undefined : action.controls,\n  };\n}\n\n/** An action's tone on its inline control, for a caller's CSS and a test: `data-tone`,\n *  left off for the default look. */\nfunction toneAttr(tone: RowActionTone | undefined) {\n  return { \"data-tone\": tone === undefined || tone === \"default\" ? undefined : tone };\n}\n\n/**\n * A row's actions, inline or as a \"⋯\" menu — see {@link RowActionsCollapse}. Every\n * control stops its click (and the Enter/Space it stands for) from reaching the row, so\n * a clickable row or a DataTable `rowLink` does not open as well; in a DataTable column\n * also set `noRowLink: true` and `role: \"actions\"`, as {@link rowActionsColumn} does.\n *\n * Inline, the icons sit in a {@link CompactControls} region at Normal: their labels\n * stay the names and the tooltips, and a locked one keeps its reason in the tooltip — a\n * line under one icon of a row would break the row. In the menu a locked action's\n * reason is a line under its words at Large and on touch (Button's\n * `disabledReasonDisplay`).\n *\n * The menu is portalled, so a table's scroller cannot clip it; Escape and an outside\n * press close it, and focus goes back to the \"⋯\" button, which is where a confirmation\n * dialog then returns it.\n */\nexport function RowActions(props: RowActionsProps) {\n  const outer = useContext(ConfirmContext);\n  // A danger action asks first (0.49 KIT-12). Under the app's ConfirmProvider through\n  // it; without one, through a provider of this row's own — only when there is\n  // something to ask, so a plain row adds nothing.\n  if (outer === null && visibleActions(props.actions).some(asksFirst)) {\n    return (\n      <ConfirmProvider>\n        <RowActionsBody {...props} />\n      </ConfirmProvider>\n    );\n  }\n  return <RowActionsBody {...props} />;\n}\n\n/** Whether choosing `action` opens a confirmation first: a danger action unless it says\n *  `confirm: false`, any other when it passes one; never a link. */\nfunction asksFirst(action: RowAction): boolean {\n  if (action.href !== undefined || action.confirm === false) return false;\n  return action.confirm !== undefined || action.tone === \"danger\";\n}\n\n/** `action.onSelect`, after its confirmation when it {@link asksFirst}. */\nfunction useRunAction(name: string | null | undefined, labels: RowActionsLabels) {\n  const confirm = useContext(ConfirmContext);\n  return (action: RowAction) => {\n    if (!asksFirst(action) || confirm === null) {\n      action.onSelect?.();\n      return;\n    }\n    const words = typeof action.confirm === \"object\" ? action.confirm : {};\n    void confirm({\n      title: words.title ?? labels.confirmTitle(action.label, name ?? undefined),\n      body: words.body ?? labels.confirmBody,\n      confirmLabel: words.confirmLabel ?? action.label,\n      tone: \"danger\",\n      commit: action.commit,\n    }).then((ok) => {\n      if (ok) action.onSelect?.();\n    });\n  };\n}\n\nfunction RowActionsBody({\n  actions,\n  name,\n  collapse = \"auto\",\n  dangerPlacement = \"menu\",\n  size = \"xs\",\n  menuWidth = \"15rem\",\n  className,\n  glyphSize,\n  tooltipSide,\n  labels: labelsProp,\n}: RowActionsProps) {\n  const labels = useKitLabels(\"rowActions\", DEFAULT_ROW_ACTIONS_LABELS, labelsProp);\n  const large = useLargeText();\n  const run = useRunAction(name, labels);\n  const entries = visibleActions(actions);\n  if (entries.length === 0) return null;\n  const asMenu = collapse === \"menu\" || (collapse === \"auto\" && large && entries.length > 1);\n  // Inline, a danger action still goes into the \"⋯\" menu (KIT-12) unless the app keeps it\n  // inline: the other actions stay icons, the menu holds the destructive ones.\n  const toMenu = (action: RowAction) =>\n    asMenu || (collapse === \"auto\" && dangerPlacement === \"menu\" && action.tone === \"danger\");\n  const inline = entries.filter((action) => !toMenu(action));\n  const menu = entries.filter(toMenu);\n  const title = name ? labels.actionsFor(name) : labels.actions;\n  const menuButton = menu.length > 0 && (\n    <RowActionsMenu\n      entries={menu}\n      title={title}\n      size={size}\n      menuWidth={menuWidth}\n      run={run}\n      className={inline.length === 0 ? className : undefined}\n    />\n  );\n  if (inline.length === 0) return menuButton || null;\n  const strip = (\n    <div data-slot=\"row-actions\" className={cn(\"inline-flex items-center gap-0.5\", className)}>\n      {inline.map((action) => (\n        <InlineAction\n          key={action.key ?? action.label}\n          action={action}\n          size={size}\n          glyphSize={glyphSize}\n          tooltipSide={tooltipSide}\n          run={run}\n        />\n      ))}\n      {menuButton}\n    </div>\n  );\n  // Compact at Normal (no room for a reason line in a row); at Large an inline action\n  // is the app's choice (\"inline\") or the row's only one, and shows its words.\n  return large ? strip : <CompactControls>{strip}</CompactControls>;\n}\n\n/** The \"⋯\" button and its menu of `entries`. */\nfunction RowActionsMenu({\n  entries,\n  title,\n  size,\n  menuWidth,\n  run,\n  className,\n}: {\n  entries: RowAction[];\n  title: string;\n  size: RowActionsSize;\n  menuWidth: `${number}rem`;\n  run: (action: RowAction) => void;\n  className?: string;\n}) {\n  // The menu closed when the action was chosen, so what is in flight shows on \"⋯\".\n  const busy = entries.some((action) => action.pending);\n  const anchored = entries.filter((action) => action.dataTour);\n  return (\n    // The \"⋯\" in a box of its own, the inline strip's slot: the tour anchors of the\n    // collapsed actions lie over the button in it (see `dataTour`), and `className`\n    // places the box as it places the strip.\n    <div data-slot=\"row-actions\" className={cn(\"relative inline-flex\", className)}>\n      <Popover\n        width={menuWidth}\n        aria-label={title}\n        className=\"p-1\"\n        trigger={({ open, toggle, ref }) => (\n          <IconButton\n            ref={ref}\n            size={size}\n            label={title}\n            // \"⋯\" is read by everyone as \"more actions\"; the menu it opens is the words.\n            labelVisible={false}\n            aria-haspopup=\"dialog\"\n            aria-expanded={open}\n            pending={busy}\n            stopPropagation\n            onClick={toggle}\n          >\n            <MoreHorizontal />\n          </IconButton>\n        )}\n        // React carries an event out of a portal along the COMPONENT tree, so a click in\n        // the menu reached a clickable row or a DataTable `onRowClick` the menu was opened\n        // from, though the panel is nowhere near it in the page — only the \"⋯\" trigger\n        // stopped its own (keksdose's 0.32 report). Stopped on the PANEL itself, its padding\n        // and border included (0.32.2: 0.32.1 stopped it on an inner box, and a click on\n        // the panel's `p-1` still went through): clicks, and the Enter / Space a row also\n        // listens for. Escape goes on, to the popover's own handler that closes it.\n        onClick={stopClick}\n        onKeyDown={stopActivationKeys}\n      >\n        {(close) => (\n          <ul data-slot=\"row-actions-menu\" className=\"space-y-0.5\">\n            {entries.map((action) => (\n              <li key={action.key ?? action.label}>\n                <MenuAction action={action} close={close} run={run} />\n              </li>\n            ))}\n          </ul>\n        )}\n      </Popover>\n      {anchored.map((action) => (\n        // The More cell's TourAnchor: decoration over the button, which keeps every tap.\n        <span\n          key={action.key ?? action.label}\n          aria-hidden\n          data-tour={action.dataTour}\n          className=\"pointer-events-none absolute inset-0\"\n        />\n      ))}\n    </div>\n  );\n}\n\nfunction stopClick(e: MouseEvent) {\n  e.stopPropagation();\n}\n\nfunction stopActivationKeys(e: KeyboardEvent) {\n  if (e.key === \"Enter\" || e.key === \" \") e.stopPropagation();\n}\n\n/**\n * The `href` an action renders as a link with, or `undefined` for a button: a link\n * cannot carry a reason or a spinner (Button's link form has neither), so a refused\n * action — its own `disabledReason`, or a write lock on a `commit` — and a pending one\n * stay buttons and say so.\n */\nfunction useActionHref(action: RowAction): string | undefined {\n  const reason = useCommitReason(action.commit, action.disabledReason);\n  const refused = reason !== undefined && reason !== null && reason !== false && reason !== \"\";\n  return action.href !== undefined && !action.pending && !refused ? action.href : undefined;\n}\n\n/** One entry of the \"⋯\" menu: the words, as a link for an `href`, else a button. */\nfunction MenuAction({\n  action,\n  close,\n  run,\n}: {\n  action: RowAction;\n  close: () => void;\n  run: (action: RowAction) => void;\n}) {\n  const href = useActionHref(action);\n  const glyph = glyphOf(action.icon);\n  const glyphTone = action.tone === undefined ? undefined : MENU_GLYPH_TONE[action.tone];\n  const words = (\n    <>\n      {glyph && (\n        <span\n          aria-hidden\n          data-tone={glyphTone ? action.tone : undefined}\n          className={cn(\"flex shrink-0 [&_svg]:size-4\", glyphTone)}\n        >\n          {glyph}\n        </span>\n      )}\n      {action.label}\n    </>\n  );\n  const tone = action.tone === \"danger\" ? \"danger\" : undefined;\n  const select = () => {\n    close();\n    run(action);\n  };\n  if (href !== undefined) {\n    return (\n      <Button\n        href={href}\n        external={action.external}\n        variant=\"ghost\"\n        size=\"sm\"\n        stretch\n        tone={tone}\n        disabled={action.disabled}\n        className=\"w-full justify-start text-start\"\n        onClick={select}\n      >\n        {words}\n      </Button>\n    );\n  }\n  return (\n    <Button\n      {...stateAttrs(action)}\n      type=\"button\"\n      variant=\"ghost\"\n      size=\"sm\"\n      stretch\n      tone={tone}\n      pressed={action.pressed}\n      disabledReason={action.disabledReason}\n      commit={action.commit}\n      pending={action.pending}\n      disabled={action.disabled}\n      className=\"w-full justify-start text-start\"\n      onClick={select}\n    >\n      {words}\n    </Button>\n  );\n}\n\n/** One inline action: an IconButton with its icon, else a small text button — each a\n *  link for an `href` (see {@link useActionHref}). The control carries the action's\n *  state, its tone and its tour anchor. */\nfunction InlineAction({\n  action,\n  size,\n  glyphSize,\n  tooltipSide,\n  run,\n}: {\n  action: RowAction;\n  size: RowActionsSize;\n  glyphSize?: IconButtonGlyphSize;\n  tooltipSide?: TooltipSide;\n  run: (action: RowAction) => void;\n}) {\n  const href = useActionHref(action);\n  const glyph = glyphOf(action.icon);\n  const iconTone = action.tone === \"default\" ? undefined : action.tone;\n  // A text button has Button's two tones; `info` and `warning` are a glyph's colours.\n  const textTone = action.tone === \"danger\" || action.tone === \"muted\" ? action.tone : undefined;\n  const marks = { \"data-tour\": action.dataTour, ...toneAttr(action.tone) };\n  if (glyph) {\n    if (href !== undefined) {\n      return (\n        <IconButton\n          {...marks}\n          href={href}\n          external={action.external}\n          size={size}\n          glyphSize={glyphSize}\n          label={action.label}\n          tooltipSide={tooltipSide}\n          tone={iconTone}\n          disabled={action.disabled}\n          stopPropagation\n          onClick={() => action.onSelect?.()}\n        >\n          {glyph}\n        </IconButton>\n      );\n    }\n    return (\n      <IconButton\n        {...marks}\n        {...stateAttrs(action)}\n        size={size}\n        glyphSize={glyphSize}\n        label={action.label}\n        tooltipSide={tooltipSide}\n        tone={iconTone}\n        pressed={action.pressed}\n        disabledReason={action.disabledReason}\n        commit={action.commit}\n        pending={action.pending}\n        disabled={action.disabled}\n        stopPropagation\n        onClick={() => run(action)}\n      >\n        {glyph}\n      </IconButton>\n    );\n  }\n  // A row listening for clicks must not open as well (IconButton's stopPropagation).\n  const stop = {\n    onClick: (e: MouseEvent) => {\n      e.stopPropagation();\n      run(action);\n    },\n    onKeyDown: (e: KeyboardEvent) => {\n      if (e.key === \"Enter\" || e.key === \" \") e.stopPropagation();\n    },\n  };\n  if (href !== undefined) {\n    return (\n      <Button\n        {...marks}\n        href={href}\n        external={action.external}\n        variant=\"ghost\"\n        size=\"sm\"\n        tone={textTone}\n        disabled={action.disabled}\n        {...stop}\n      >\n        {action.label}\n      </Button>\n    );\n  }\n  return (\n    <Button\n      {...marks}\n      {...stateAttrs(action)}\n      type=\"button\"\n      variant=\"ghost\"\n      size=\"sm\"\n      tone={textTone}\n      pressed={action.pressed}\n      disabledReason={action.disabledReason}\n      commit={action.commit}\n      pending={action.pending}\n      disabled={action.disabled}\n      {...stop}\n    >\n      {action.label}\n    </Button>\n  );\n}\n\n/** The actions column's heading, in the provider's words: on screen since 0.46.1 (keksdose\n *  dev#598 rework), a screen reader's name only with `hidden`. */\nfunction RowActionsHeader({\n  text,\n  labels,\n  hidden,\n}: {\n  text?: string;\n  labels?: LabelOverride<RowActionsLabels>;\n  hidden?: boolean;\n}) {\n  const resolved = useKitLabels(\"rowActions\", DEFAULT_ROW_ACTIONS_LABELS, labels);\n  const word = text ?? resolved.actions;\n  return hidden ? <span className=\"sr-only\">{word}</span> : <>{word}</>;\n}\n\n/** The actions cell's classes — `rowActionsColumn`'s `className`: the column hugs its\n *  buttons, on one line, at the row's end. A hand-built table's `<TableCell>` takes them\n *  around its {@link RowActions} (0.47, keksdose N17). */\nexport const ROW_ACTIONS_CELL_CLASS = \"w-px whitespace-nowrap text-end\";\n/** The actions heading's classes — `rowActionsColumn`'s `headClassName`, which\n *  {@link RowActionsHead} draws: hugging, end-aligned over the buttons (0.47, N17). */\nexport const ROW_ACTIONS_HEAD_CLASS = \"w-px text-end\";\n\nexport interface RowActionsHeadProps extends Omit<TableHeaderCellProps, \"children\"> {\n  /** The heading. Default: the provider's `rowActions.actions` (\"Actions\"). */\n  children?: ReactNode;\n  /** Named for a screen reader only — `rowActionsColumn`'s `header: false`. */\n  hideLabel?: boolean;\n  labels?: LabelOverride<RowActionsLabels>;\n}\n\n/**\n * A hand-built table's actions heading (0.47, keksdose N17): the `<th>` `rowActionsColumn`\n * gives a DataTable — \"Actions\" on screen in the provider's words, end-aligned over the\n * buttons, hugging them. Pair it with `<TableCell className={ROW_ACTIONS_CELL_CLASS}>`\n * around each row's {@link RowActions}. Every other `TableHeaderCell` prop passes on\n * (`size`, the app's `className`, merged last).\n *\n *     <RowActionsHead size=\"sm\" className={TH} />\n */\nexport function RowActionsHead({ children, hideLabel, labels, className, ...rest }: RowActionsHeadProps) {\n  return (\n    <TableHeaderCell align=\"end\" {...rest} className={cn(ROW_ACTIONS_HEAD_CLASS, className)}>\n      {typeof children === \"string\" || children == null ? (\n        <RowActionsHeader text={children ?? undefined} labels={labels} hidden={hideLabel} />\n      ) : (\n        children\n      )}\n    </TableHeaderCell>\n  );\n}\n\nexport interface RowActionsColumnOptions<T> {\n  /** The column's key. Default `\"actions\"`. */\n  key?: string;\n  /** The row's actions — `false` / `null` for the ones a condition leaves out. */\n  actions: (row: T) => RowActionList;\n  /** The row's name, for the \"⋯\" button's name (\"Actions for Ada Example\"). `null` and\n   *  `undefined` both mean \"Actions\". */\n  name?: (row: T) => string | null | undefined;\n  collapse?: RowActionsCollapse;\n  /** Default `xs`. */\n  size?: RowActionsSize;\n  /** See {@link RowActionsProps.glyphSize}. */\n  glyphSize?: IconButtonGlyphSize;\n  /** See {@link RowActionsProps.tooltipSide} — `\"start\"` in a table's last column. */\n  tooltipSide?: TooltipSide;\n  /**\n   * The column's name as plain text — the column-settings checklist and the phone\n   * card's label read it (`DataTableColumn.headerText`). Pass the app's own word; left\n   * out, the heading shows the provider's `rowActions.actions` and the plain-text\n   * places fall back to the column's `key`.\n   */\n  headerText?: string;\n  /**\n   * The heading (0.46.1, keksdose dev#598 rework — Marcel: a VISIBLE \"Actions\" heading on\n   * every table with an actions column). Default: `headerText`, else the provider's\n   * `rowActions.actions` (\"Actions\"), shown, end-aligned over the buttons. A node\n   * replaces it; `false` keeps the pre-0.46.1 heading, named for a screen reader only.\n   */\n  header?: ReactNode | false;\n  labels?: LabelOverride<RowActionsLabels>;\n  /** Anything else for the column (`mobileHidden`, `cellProps`, another `role`…), merged last. */\n  column?: Partial<DataTableColumn<T>>;\n}\n\n/**\n * A DataTable column of {@link RowActions} — an app's action column in one line\n * (§10.8): inline icons at Normal, the \"⋯\" menu at Large with two or more actions.\n *\n *     columns={[...columns, rowActionsColumn({ actions: (r) => [...], name: (r) => r.name })]}\n *\n * The heading says \"Actions\" on screen (0.46.1; `header` changes or hides it), the\n * column hugs its content at the row's end, and `noRowLink` keeps a `rowHref` anchor off it, so the\n * buttons keep their own clicks. It is `role: \"actions\"` (0.49 KIT-7): DataTable's default\n * phone card draws it after its three fields, at the card's end, and never counts it as\n * one of them. Set `column: { mobileHidden: true }` to drop it there (with\n * `mobileDetailsInRow` it then shows in the opened row instead).\n */\nexport function rowActionsColumn<T>({\n  key = \"actions\",\n  actions,\n  name,\n  collapse,\n  size,\n  glyphSize,\n  tooltipSide,\n  headerText,\n  header,\n  labels,\n  column,\n}: RowActionsColumnOptions<T>): DataTableColumn<T> {\n  return {\n    key,\n    header:\n      header === false || header == null ? (\n        <RowActionsHeader text={headerText} labels={labels} hidden={header === false} />\n      ) : (\n        header\n      ),\n    headerText,\n    cell: (row) => (\n      <RowActions\n        actions={actions(row)}\n        name={name?.(row)}\n        collapse={collapse}\n        size={size}\n        glyphSize={glyphSize}\n        tooltipSide={tooltipSide}\n        labels={labels}\n      />\n    ),\n    className: ROW_ACTIONS_CELL_CLASS,\n    // The heading over the buttons, at the row's end (0.46.1); a hand-built table's\n    // `RowActionsHead` (0.47).\n    headClassName: ROW_ACTIONS_HEAD_CLASS,\n    noRowLink: true,\n    // After the phone card's fields, never one of them (0.49 KIT-7).\n    role: \"actions\",\n    ...column,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/components/row-actions.tsx"],"sourcesContent":["import { isValidElement, useContext } from \"react\";\nimport type { KeyboardEvent, MouseEvent, ReactElement, ReactNode } from \"react\";\nimport { MoreHorizontal } from \"lucide-react\";\nimport type { LucideIcon } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { hasContent } from \"../lib/presence\";\nimport { useLargeText } from \"../hooks/use-large-text\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { Popover } from \"./popover\";\nimport { Button } from \"./button\";\nimport { CompactControls } from \"./field-parts\";\nimport { IconButton } from \"./icon-button\";\nimport { useCommitReason, type CommitScope } from \"./write-lock\";\nimport type { IconButtonGlyphSize, IconButtonSize } from \"./icon-button\";\nimport type { TooltipSide } from \"./tooltip\";\nimport type { DataTableColumn } from \"./data-table\";\nimport { TableHeaderCell, type TableHeaderCellProps } from \"./table\";\nimport { DEFAULT_ROW_ACTIONS_LABELS } from \"./row-actions-labels\";\nimport { ConfirmContext } from \"./confirm-context\";\nimport { ConfirmProvider } from \"./confirm-dialog\";\n\n/**\n * A row's actions — inline icons at Normal, one \"⋯\" menu at Large and above\n * (docs/text-size-harmonization.md §10.8).\n *\n * At Large an IconButton shows its label as text (§4). In a dense row — a register's\n * action column, a list row's end — every label at once does not fit: Kurvenschmiede\n * has 44 IconButtons in rows, kastlan 119. So a row's actions collapse instead, into\n * the menu the user roster has used since 0.31 (`UserRowActions`, now built on this):\n * one \"⋯\" button, and a menu with each action's icon AND words, where a locked one stays\n * listed and says why.\n *\n * The data is the roster's `UserRowActionList`, generalised: entries, and `false` /\n * `null` for the ones a condition left out (`row.locked || {…}`).\n *\n * Destructive actions belong in the menu (0.49 KIT-12): a `tone: \"danger\"` action goes\n * into the \"⋯\" menu while the others stay inline (`dangerPlacement`), and choosing it\n * opens a `ConfirmDialog` before `onSelect` runs (`confirm`; `false` to opt out). A\n * delete is then never a bin icon in every row, one stray tap from gone.\n *\n * 0.33 (§10.16): an action carries its state at both sizes — a toggle (`pressed`), a\n * disclosure (`expanded`, `controls`), a tone, a tour anchor (`dataTour`) — so a row\n * with an \"on\" share button or a tour step no longer keeps hand-rolled IconButtons at\n * Normal and this only at Large (keksdose k15).\n */\n\n/** An action's colour: IconButton's tone inline; in the menu the glyph takes it and the\n *  words keep the text colour, except `danger`, whose words are the danger text. */\nexport type RowActionTone = \"default\" | \"muted\" | \"info\" | \"warning\" | \"danger\";\n\n/** One action of a row. */\nexport interface RowAction {\n  /** React key. Default: the label. */\n  key?: string;\n  /** The action's name: the inline icon's name and tooltip, the menu entry's words. */\n  label: string;\n  /**\n   * Runs it. The kit sends nothing — it calls this, after a `tone: \"danger\"` action's\n   * confirmation (see {@link confirm}). Optional only beside `href`; an action has one or\n   * the other (or both: `onSelect` then runs as the link is followed).\n   */\n  onSelect?: () => void;\n  /**\n   * 0.49 KIT-12: ask before `onSelect`. A `tone: \"danger\"` action asks by default — a\n   * `ConfirmDialog` (the provider's `useConfirm`, else one of its own) titled with the\n   * action and the row's name, \"Delete “Ada Example”?\", the consequence under it\n   * (`rowActions.confirmBody`), the action's label on the danger button and focus on\n   * Cancel. Pass the words to say more, or `false` when the app confirms in `onSelect`\n   * itself or offers an undo instead. Any other tone asks only when given one. Not for\n   * an `href` action: a link only navigates.\n   */\n  confirm?: boolean | RowActionConfirm;\n  /**\n   * The action NAVIGATES — an edit page, a mail to compose (0.32.1, kastlan's 0.32\n   * report): a real link inline and in the menu, so open in a new tab, a middle click\n   * and the URL on hover work, which `onSelect` + `navigate` lost. The kit's link rule\n   * applies ({@link Button}'s `href`): in-app through the provider's `linkComponent`, an\n   * external or `#anchor` one a plain `<a>`, `mailto:` included.\n   *\n   * A link cannot carry a reason or a spinner, so an action with a `disabledReason`\n   * (or under a write lock, with `commit`) or `pending` stays a button and says why.\n   */\n  href?: string;\n  /** With `href`: leaves the app — a new tab, and a screen reader is told so. */\n  external?: boolean;\n  /**\n   * The glyph: a Lucide icon (`Pencil`), or an element (`<Pencil />`, an app's own\n   * svg) — DataTable's `rowActions` hand their `icon` node through. Inline, an action\n   * without one is a small text button; in the menu it is the words alone.\n   */\n  icon?: LucideIcon | ReactElement;\n  /**\n   * `danger` for delete, revoke, erase: the quiet red of IconButton's `tone=\"danger\"`\n   * inline, the danger text tone in the menu. `muted` (an open or add that should not\n   * compete), `info` (a notice-worthy, harmless action: keksdose's reconcile) and\n   * `warning` (a flag that wants attention): IconButton's tone inline; in the menu the\n   * glyph takes it and the words keep the text colour, so `muted` looks like `default`\n   * there (0.33).\n   */\n  tone?: RowActionTone;\n  /** Why it is not available for this row. It stays listed, focusable, and says so — an\n   *  action that silently vanished would leave the reader looking for it. */\n  disabledReason?: ReactNode;\n  /**\n   * This action COMMITS — it saves, sends, deletes: under a locked\n   * {@link WriteLockProvider} it is refused with the lock's reason, as {@link Button}'s\n   * `commit` is, inline and in the menu alike. No provider, or an unlocked one: no effect.\n   */\n  commit?: CommitScope;\n  /**\n   * In flight — the request it started has not answered. Inline, the icon turns into\n   * IconButton's spinner (`pending`); collapsed, the \"⋯\" button does, since the menu\n   * closed when the action was chosen. Either way nothing in the row can be pressed again\n   * until it settles: the \"⋯\" opens no menu while busy.\n   */\n  pending?: boolean;\n  /**\n   * Not available for a moment, with nothing to explain — another action of the list\n   * is in flight (an admin panel's `busy`). The plain `disabled`; a lasting refusal is a\n   * `disabledReason`, which says why.\n   */\n  disabled?: boolean;\n  /** Leave it out for this row. */\n  hidden?: boolean;\n  /**\n   * A toggle (0.33): `aria-pressed` and IconButton's \"on\" look inline, `aria-pressed` on\n   * the menu entry. Keep the label the same in both states (\"Share budget\"): the pressed\n   * state already says whether it is on. Not on an `href` action — a link is not a\n   * toggle — nor with `expanded`.\n   */\n  pressed?: boolean;\n  /**\n   * Opens or closes something IN THE PAGE (0.33) — a share card under the row, an\n   * add-category row: `aria-expanded`, inline and on the menu entry. Not with `pressed`:\n   * a disclosure says open, not on. Not on an `href` action.\n   */\n  expanded?: boolean;\n  /** The `id` of what `expanded` opens: `aria-controls`, inline and on the menu entry. */\n  controls?: string;\n  /**\n   * A tour anchor (0.33, §10.18): `data-tour` on ONE element per action at a time.\n   * Inline, on the action's own control (the IconButton, the small text button, the\n   * link). Collapsed, on an `aria-hidden` box laid over the \"⋯\" button — `[data-tour=x]`\n   * resolves to a box the size of the \"⋯\", whose `data-slot=\"row-actions\"` box holds the\n   * button, two anchored actions in one row don't fight over one attribute, and a tap\n   * still reaches the button. Never on the entry in the open menu: the kit's tour takes\n   * the first visible match and the menu is portalled after the row, so a copy there\n   * would never be found, only make the selector match twice. The kit's name for it, as\n   * `AppShellNavItem.dataTour`.\n   */\n  dataTour?: string;\n}\n\n/** The words of a {@link RowAction.confirm}; each defaults as described there. */\nexport interface RowActionConfirm {\n  title?: ReactNode;\n  body?: ReactNode;\n  confirmLabel?: ReactNode;\n}\n\n/** What a row's actions may be: entries, and `false` / `null` / `undefined` for the ones\n *  a condition left out. */\nexport type RowActionList = readonly (RowAction | false | null | undefined)[];\n\nexport interface RowActionsLabels {\n  /** The menu button's name when the row has no name of its own; also the actions\n   *  column's (hidden) header in {@link rowActionsColumn}. */\n  actions: string;\n  /** The menu button's name, given the row's: \"Actions for Ada Example\". */\n  actionsFor: (name: string) => string;\n  /** 0.49 KIT-12: a danger action's confirmation title, given the action's label and the\n   *  row's name when it has one: \"Delete “Ada Example”?\", \"Delete?\". */\n  confirmTitle: (action: string, name?: string) => string;\n  /** 0.49 KIT-12: the line under it — \"This cannot be undone.\" */\n  confirmBody: string;\n}\n\n// Defined in ./row-actions-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_ROW_ACTIONS_LABELS };\n\n/**\n * - `\"auto\"` (default): the icons inline at Normal; the \"⋯\" menu at Large and Extra\n *   large once there are two or more (§10.8). A single action stays inline at every\n *   size, with its label as text at Large — one label fits a row, and a menu of one is\n *   a detour.\n * - `\"menu\"`: the menu at every size — the roster's choice, whose actions grow (§2.4\n *   there) and do not fit a phone card as a strip.\n * - `\"inline\"`: the icons at every size — for a row the app knows has room; at Large\n *   each then shows its label (IconButton's `labelVisible`).\n */\nexport type RowActionsCollapse = \"auto\" | \"menu\" | \"inline\";\n\n/** The sizes a row action comes in: IconButton's row steps. `2xs` is DataTable's\n *  compact density. At Large every one is at least a 48 px target (IconButton). */\nexport type RowActionsSize = Extract<IconButtonSize, \"md\" | \"sm\" | \"xs\" | \"2xs\">;\n\nexport interface RowActionsProps {\n  actions: RowActionList;\n  /**\n   * 0.49 KIT-12: where `tone: \"danger\"` actions go while the others are inline. `\"menu\"`\n   * (default): into the row's \"⋯\" menu, so a delete is never one stray tap in every\n   * row — the other actions stay icons beside it. `\"inline\"`: an icon like the rest.\n   * `collapse=\"inline\"` keeps every action inline, `collapse=\"menu\"` every one in the menu.\n   */\n  dangerPlacement?: \"menu\" | \"inline\";\n  /** The row's name, for the menu button's name — \"Actions for Ada Example\". Without it\n   *  (or `null`, as API fields often are) the button is \"Actions\". */\n  name?: string | null;\n  /** When the actions collapse into the menu — see {@link RowActionsCollapse}. */\n  collapse?: RowActionsCollapse;\n  /** The inline icons' and the \"⋯\" button's size. Default `xs`, a list row's action. */\n  size?: RowActionsSize;\n  /** The menu's width. Default `\"15rem\"`, in rem so it grows with the words (§3.2). */\n  menuWidth?: `${number}rem`;\n  /** On the wrapper: the inline strip, or the box round the \"⋯\" button. */\n  className?: string;\n  /** The inline glyphs' size, IconButton's `glyphSize` — e.g. 14 in a dense header strip\n   *  (keksdose's category group header). The \"⋯\" button keeps its box's own. */\n  glyphSize?: IconButtonGlyphSize;\n  /** The inline tooltips' side, IconButton's `tooltipSide` — `\"start\"` for a table's last\n   *  column, so a bubble does not run off the row's end. Per row: every inline action. */\n  tooltipSide?: TooltipSide;\n  labels?: LabelOverride<RowActionsLabels>;\n}\n\nfunction visibleActions(actions: RowActionList): RowAction[] {\n  return actions.filter((a): a is RowAction => Boolean(a) && !(a as RowAction).hidden);\n}\n\n/** An action's glyph as a node: a component is rendered, an element is used as is. */\nfunction glyphOf(icon: RowAction[\"icon\"]): ReactNode {\n  if (icon === undefined) return null;\n  if (isValidElement(icon)) return icon;\n  const Icon = icon as LucideIcon;\n  return <Icon />;\n}\n\n/** The menu glyph's tint per tone (0.33): the words keep the text colour, so the glyph\n *  carries `info` and `warning` — IconButton's toned colours. `danger` colours the words\n *  through Button's tone, and `muted` is the default look in a menu. */\nconst MENU_GLYPH_TONE: Partial<Record<RowActionTone, string>> = {\n  info: \"text-info\",\n  warning: \"text-warning\",\n};\n\n/** The state an action's control says, inline and in the menu alike: `aria-expanded` and\n *  `aria-controls` for a disclosure (a toggle's `aria-pressed` goes through the button's\n *  own `pressed`, which also draws the \"on\" look). */\nfunction stateAttrs(action: RowAction) {\n  return {\n    \"aria-expanded\": action.expanded,\n    \"aria-controls\": action.expanded === undefined ? undefined : action.controls,\n  };\n}\n\n/** An action's tone on its inline control, for a caller's CSS and a test: `data-tone`,\n *  left off for the default look. */\nfunction toneAttr(tone: RowActionTone | undefined) {\n  return { \"data-tone\": tone === undefined || tone === \"default\" ? undefined : tone };\n}\n\n/**\n * A row's actions, inline or as a \"⋯\" menu — see {@link RowActionsCollapse}. Every\n * control stops its click (and the Enter/Space it stands for) from reaching the row, so\n * a clickable row or a DataTable `rowLink` does not open as well; in a DataTable column\n * also set `noRowLink: true` and `role: \"actions\"`, as {@link rowActionsColumn} does.\n *\n * Inline, the icons sit in a {@link CompactControls} region at Normal: their labels\n * stay the names and the tooltips, and a locked one keeps its reason in the tooltip — a\n * line under one icon of a row would break the row. In the menu a locked action's\n * reason is a line under its words at Large and on touch (Button's\n * `disabledReasonDisplay`).\n *\n * The menu is portalled, so a table's scroller cannot clip it; Escape and an outside\n * press close it, and focus goes back to the \"⋯\" button, which is where a confirmation\n * dialog then returns it.\n */\nexport function RowActions(props: RowActionsProps) {\n  const outer = useContext(ConfirmContext);\n  // A danger action asks first (0.49 KIT-12). Under the app's ConfirmProvider through\n  // it; without one, through a provider of this row's own — only when there is\n  // something to ask, so a plain row adds nothing.\n  if (outer === null && visibleActions(props.actions).some(asksFirst)) {\n    return (\n      <ConfirmProvider>\n        <RowActionsBody {...props} />\n      </ConfirmProvider>\n    );\n  }\n  return <RowActionsBody {...props} />;\n}\n\n/** Whether choosing `action` opens a confirmation first: a danger action unless it says\n *  `confirm: false`, any other when it passes one; never a link. */\nfunction asksFirst(action: RowAction): boolean {\n  if (action.href !== undefined || action.confirm === false) return false;\n  return action.confirm !== undefined || action.tone === \"danger\";\n}\n\n/** `action.onSelect`, after its confirmation when it {@link asksFirst}. */\nfunction useRunAction(name: string | null | undefined, labels: RowActionsLabels) {\n  const confirm = useContext(ConfirmContext);\n  return (action: RowAction) => {\n    if (!asksFirst(action) || confirm === null) {\n      action.onSelect?.();\n      return;\n    }\n    const words = typeof action.confirm === \"object\" ? action.confirm : {};\n    void confirm({\n      title: words.title ?? labels.confirmTitle(action.label, name ?? undefined),\n      body: words.body ?? labels.confirmBody,\n      confirmLabel: words.confirmLabel ?? action.label,\n      tone: \"danger\",\n      commit: action.commit,\n    }).then((ok) => {\n      if (ok) action.onSelect?.();\n    });\n  };\n}\n\nfunction RowActionsBody({\n  actions,\n  name,\n  collapse = \"auto\",\n  dangerPlacement = \"menu\",\n  size = \"xs\",\n  menuWidth = \"15rem\",\n  className,\n  glyphSize,\n  tooltipSide,\n  labels: labelsProp,\n}: RowActionsProps) {\n  const labels = useKitLabels(\"rowActions\", DEFAULT_ROW_ACTIONS_LABELS, labelsProp);\n  const large = useLargeText();\n  const run = useRunAction(name, labels);\n  const entries = visibleActions(actions);\n  if (entries.length === 0) return null;\n  const asMenu = collapse === \"menu\" || (collapse === \"auto\" && large && entries.length > 1);\n  // Inline, a danger action still goes into the \"⋯\" menu (KIT-12) unless the app keeps it\n  // inline: the other actions stay icons, the menu holds the destructive ones.\n  const toMenu = (action: RowAction) =>\n    asMenu || (collapse === \"auto\" && dangerPlacement === \"menu\" && action.tone === \"danger\");\n  const inline = entries.filter((action) => !toMenu(action));\n  const menu = entries.filter(toMenu);\n  const title = name ? labels.actionsFor(name) : labels.actions;\n  const menuButton = menu.length > 0 && (\n    <RowActionsMenu\n      entries={menu}\n      title={title}\n      size={size}\n      menuWidth={menuWidth}\n      run={run}\n      className={inline.length === 0 ? className : undefined}\n    />\n  );\n  if (inline.length === 0) return menuButton || null;\n  const strip = (\n    <div data-slot=\"row-actions\" className={cn(\"inline-flex items-center gap-0.5\", className)}>\n      {inline.map((action) => (\n        <InlineAction\n          key={action.key ?? action.label}\n          action={action}\n          size={size}\n          glyphSize={glyphSize}\n          tooltipSide={tooltipSide}\n          run={run}\n        />\n      ))}\n      {menuButton}\n    </div>\n  );\n  // Compact at Normal (no room for a reason line in a row); at Large an inline action\n  // is the app's choice (\"inline\") or the row's only one, and shows its words.\n  return large ? strip : <CompactControls>{strip}</CompactControls>;\n}\n\n/** The \"⋯\" button and its menu of `entries`. */\nfunction RowActionsMenu({\n  entries,\n  title,\n  size,\n  menuWidth,\n  run,\n  className,\n}: {\n  entries: RowAction[];\n  title: string;\n  size: RowActionsSize;\n  menuWidth: `${number}rem`;\n  run: (action: RowAction) => void;\n  className?: string;\n}) {\n  // The menu closed when the action was chosen, so what is in flight shows on \"⋯\".\n  const busy = entries.some((action) => action.pending);\n  const anchored = entries.filter((action) => action.dataTour);\n  return (\n    // The \"⋯\" in a box of its own, the inline strip's slot: the tour anchors of the\n    // collapsed actions lie over the button in it (see `dataTour`), and `className`\n    // places the box as it places the strip.\n    <div data-slot=\"row-actions\" className={cn(\"relative inline-flex\", className)}>\n      <Popover\n        width={menuWidth}\n        aria-label={title}\n        className=\"p-1\"\n        trigger={({ open, toggle, ref }) => (\n          <IconButton\n            ref={ref}\n            size={size}\n            label={title}\n            // \"⋯\" is read by everyone as \"more actions\"; the menu it opens is the words.\n            labelVisible={false}\n            aria-haspopup=\"dialog\"\n            aria-expanded={open}\n            pending={busy}\n            stopPropagation\n            onClick={toggle}\n          >\n            <MoreHorizontal />\n          </IconButton>\n        )}\n        // React carries an event out of a portal along the COMPONENT tree, so a click in\n        // the menu reached a clickable row or a DataTable `onRowClick` the menu was opened\n        // from, though the panel is nowhere near it in the page — only the \"⋯\" trigger\n        // stopped its own (keksdose's 0.32 report). Stopped on the PANEL itself, its padding\n        // and border included (0.32.2: 0.32.1 stopped it on an inner box, and a click on\n        // the panel's `p-1` still went through): clicks, and the Enter / Space a row also\n        // listens for. Escape goes on, to the popover's own handler that closes it.\n        onClick={stopClick}\n        onKeyDown={stopActivationKeys}\n      >\n        {(close) => (\n          <ul data-slot=\"row-actions-menu\" className=\"space-y-0.5\">\n            {entries.map((action) => (\n              <li key={action.key ?? action.label}>\n                <MenuAction action={action} close={close} run={run} />\n              </li>\n            ))}\n          </ul>\n        )}\n      </Popover>\n      {anchored.map((action) => (\n        // The More cell's TourAnchor: decoration over the button, which keeps every tap.\n        <span\n          key={action.key ?? action.label}\n          aria-hidden\n          data-tour={action.dataTour}\n          className=\"pointer-events-none absolute inset-0\"\n        />\n      ))}\n    </div>\n  );\n}\n\nfunction stopClick(e: MouseEvent) {\n  e.stopPropagation();\n}\n\nfunction stopActivationKeys(e: KeyboardEvent) {\n  if (e.key === \"Enter\" || e.key === \" \") e.stopPropagation();\n}\n\n/**\n * The `href` an action renders as a link with, or `undefined` for a button: a link\n * cannot carry a reason or a spinner (Button's link form has neither), so a refused\n * action — its own `disabledReason`, or a write lock on a `commit` — and a pending one\n * stay buttons and say so.\n */\nfunction useActionHref(action: RowAction): string | undefined {\n  const reason = useCommitReason(action.commit, action.disabledReason);\n  const refused = hasContent(reason);\n  return action.href !== undefined && !action.pending && !refused ? action.href : undefined;\n}\n\n/** One entry of the \"⋯\" menu: the words, as a link for an `href`, else a button. */\nfunction MenuAction({\n  action,\n  close,\n  run,\n}: {\n  action: RowAction;\n  close: () => void;\n  run: (action: RowAction) => void;\n}) {\n  const href = useActionHref(action);\n  const glyph = glyphOf(action.icon);\n  const glyphTone = action.tone === undefined ? undefined : MENU_GLYPH_TONE[action.tone];\n  const words = (\n    <>\n      {glyph && (\n        <span\n          aria-hidden\n          data-tone={glyphTone ? action.tone : undefined}\n          className={cn(\"flex shrink-0 [&_svg]:size-4\", glyphTone)}\n        >\n          {glyph}\n        </span>\n      )}\n      {action.label}\n    </>\n  );\n  const tone = action.tone === \"danger\" ? \"danger\" : undefined;\n  const select = () => {\n    close();\n    run(action);\n  };\n  if (href !== undefined) {\n    return (\n      <Button\n        href={href}\n        external={action.external}\n        variant=\"ghost\"\n        size=\"sm\"\n        stretch\n        tone={tone}\n        disabled={action.disabled}\n        className=\"w-full justify-start text-start\"\n        onClick={select}\n      >\n        {words}\n      </Button>\n    );\n  }\n  return (\n    <Button\n      {...stateAttrs(action)}\n      type=\"button\"\n      variant=\"ghost\"\n      size=\"sm\"\n      stretch\n      tone={tone}\n      pressed={action.pressed}\n      disabledReason={action.disabledReason}\n      commit={action.commit}\n      pending={action.pending}\n      disabled={action.disabled}\n      className=\"w-full justify-start text-start\"\n      onClick={select}\n    >\n      {words}\n    </Button>\n  );\n}\n\n/** One inline action: an IconButton with its icon, else a small text button — each a\n *  link for an `href` (see {@link useActionHref}). The control carries the action's\n *  state, its tone and its tour anchor. */\nfunction InlineAction({\n  action,\n  size,\n  glyphSize,\n  tooltipSide,\n  run,\n}: {\n  action: RowAction;\n  size: RowActionsSize;\n  glyphSize?: IconButtonGlyphSize;\n  tooltipSide?: TooltipSide;\n  run: (action: RowAction) => void;\n}) {\n  const href = useActionHref(action);\n  const glyph = glyphOf(action.icon);\n  const iconTone = action.tone === \"default\" ? undefined : action.tone;\n  // A text button has Button's two tones; `info` and `warning` are a glyph's colours.\n  const textTone = action.tone === \"danger\" || action.tone === \"muted\" ? action.tone : undefined;\n  const marks = { \"data-tour\": action.dataTour, ...toneAttr(action.tone) };\n  if (glyph) {\n    if (href !== undefined) {\n      return (\n        <IconButton\n          {...marks}\n          href={href}\n          external={action.external}\n          size={size}\n          glyphSize={glyphSize}\n          label={action.label}\n          tooltipSide={tooltipSide}\n          tone={iconTone}\n          disabled={action.disabled}\n          stopPropagation\n          onClick={() => action.onSelect?.()}\n        >\n          {glyph}\n        </IconButton>\n      );\n    }\n    return (\n      <IconButton\n        {...marks}\n        {...stateAttrs(action)}\n        size={size}\n        glyphSize={glyphSize}\n        label={action.label}\n        tooltipSide={tooltipSide}\n        tone={iconTone}\n        pressed={action.pressed}\n        disabledReason={action.disabledReason}\n        commit={action.commit}\n        pending={action.pending}\n        disabled={action.disabled}\n        stopPropagation\n        onClick={() => run(action)}\n      >\n        {glyph}\n      </IconButton>\n    );\n  }\n  // A row listening for clicks must not open as well (IconButton's stopPropagation).\n  const stop = {\n    onClick: (e: MouseEvent) => {\n      e.stopPropagation();\n      run(action);\n    },\n    onKeyDown: (e: KeyboardEvent) => {\n      if (e.key === \"Enter\" || e.key === \" \") e.stopPropagation();\n    },\n  };\n  if (href !== undefined) {\n    return (\n      <Button\n        {...marks}\n        href={href}\n        external={action.external}\n        variant=\"ghost\"\n        size=\"sm\"\n        tone={textTone}\n        disabled={action.disabled}\n        {...stop}\n      >\n        {action.label}\n      </Button>\n    );\n  }\n  return (\n    <Button\n      {...marks}\n      {...stateAttrs(action)}\n      type=\"button\"\n      variant=\"ghost\"\n      size=\"sm\"\n      tone={textTone}\n      pressed={action.pressed}\n      disabledReason={action.disabledReason}\n      commit={action.commit}\n      pending={action.pending}\n      disabled={action.disabled}\n      {...stop}\n    >\n      {action.label}\n    </Button>\n  );\n}\n\n/** The actions column's heading, in the provider's words: on screen since 0.46.1 (keksdose\n *  dev#598 rework), a screen reader's name only with `hidden`. */\nfunction RowActionsHeader({\n  text,\n  labels,\n  hidden,\n}: {\n  text?: string;\n  labels?: LabelOverride<RowActionsLabels>;\n  hidden?: boolean;\n}) {\n  const resolved = useKitLabels(\"rowActions\", DEFAULT_ROW_ACTIONS_LABELS, labels);\n  const word = text ?? resolved.actions;\n  return hidden ? <span className=\"sr-only\">{word}</span> : <>{word}</>;\n}\n\n/** The actions cell's classes — `rowActionsColumn`'s `className`: the column hugs its\n *  buttons, on one line, at the row's end. A hand-built table's `<TableCell>` takes them\n *  around its {@link RowActions} (0.47, keksdose N17). */\nexport const ROW_ACTIONS_CELL_CLASS = \"w-px whitespace-nowrap text-end\";\n/** The actions heading's classes — `rowActionsColumn`'s `headClassName`, which\n *  {@link RowActionsHead} draws: hugging, end-aligned over the buttons (0.47, N17). */\nexport const ROW_ACTIONS_HEAD_CLASS = \"w-px text-end\";\n\nexport interface RowActionsHeadProps extends Omit<TableHeaderCellProps, \"children\"> {\n  /** The heading. Default: the provider's `rowActions.actions` (\"Actions\"). */\n  children?: ReactNode;\n  /** Named for a screen reader only — `rowActionsColumn`'s `header: false`. */\n  hideLabel?: boolean;\n  labels?: LabelOverride<RowActionsLabels>;\n}\n\n/**\n * A hand-built table's actions heading (0.47, keksdose N17): the `<th>` `rowActionsColumn`\n * gives a DataTable — \"Actions\" on screen in the provider's words, end-aligned over the\n * buttons, hugging them. Pair it with `<TableCell className={ROW_ACTIONS_CELL_CLASS}>`\n * around each row's {@link RowActions}. Every other `TableHeaderCell` prop passes on\n * (`size`, the app's `className`, merged last).\n *\n *     <RowActionsHead size=\"sm\" className={TH} />\n */\nexport function RowActionsHead({ children, hideLabel, labels, className, ...rest }: RowActionsHeadProps) {\n  return (\n    <TableHeaderCell align=\"end\" {...rest} className={cn(ROW_ACTIONS_HEAD_CLASS, className)}>\n      {typeof children === \"string\" || children == null ? (\n        <RowActionsHeader text={children ?? undefined} labels={labels} hidden={hideLabel} />\n      ) : (\n        children\n      )}\n    </TableHeaderCell>\n  );\n}\n\nexport interface RowActionsColumnOptions<T> {\n  /** The column's key. Default `\"actions\"`. */\n  key?: string;\n  /** The row's actions — `false` / `null` for the ones a condition leaves out. */\n  actions: (row: T) => RowActionList;\n  /** The row's name, for the \"⋯\" button's name (\"Actions for Ada Example\"). `null` and\n   *  `undefined` both mean \"Actions\". */\n  name?: (row: T) => string | null | undefined;\n  collapse?: RowActionsCollapse;\n  /** Default `xs`. */\n  size?: RowActionsSize;\n  /** See {@link RowActionsProps.glyphSize}. */\n  glyphSize?: IconButtonGlyphSize;\n  /** See {@link RowActionsProps.tooltipSide} — `\"start\"` in a table's last column. */\n  tooltipSide?: TooltipSide;\n  /**\n   * The column's name as plain text — the column-settings checklist and the phone\n   * card's label read it (`DataTableColumn.headerText`). Pass the app's own word; left\n   * out, the heading shows the provider's `rowActions.actions` and the plain-text\n   * places fall back to the column's `key`.\n   */\n  headerText?: string;\n  /**\n   * The heading (0.46.1, keksdose dev#598 rework — Marcel: a VISIBLE \"Actions\" heading on\n   * every table with an actions column). Default: `headerText`, else the provider's\n   * `rowActions.actions` (\"Actions\"), shown, end-aligned over the buttons. A node\n   * replaces it; `false` keeps the pre-0.46.1 heading, named for a screen reader only.\n   */\n  header?: ReactNode | false;\n  labels?: LabelOverride<RowActionsLabels>;\n  /** Anything else for the column (`mobileHidden`, `cellProps`, another `role`…), merged last. */\n  column?: Partial<DataTableColumn<T>>;\n}\n\n/**\n * A DataTable column of {@link RowActions} — an app's action column in one line\n * (§10.8): inline icons at Normal, the \"⋯\" menu at Large with two or more actions.\n *\n *     columns={[...columns, rowActionsColumn({ actions: (r) => [...], name: (r) => r.name })]}\n *\n * The heading says \"Actions\" on screen (0.46.1; `header` changes or hides it), the\n * column hugs its content at the row's end, and `noRowLink` keeps a `rowHref` anchor off it, so the\n * buttons keep their own clicks. It is `role: \"actions\"` (0.49 KIT-7): DataTable's default\n * phone card draws it after its three fields, at the card's end, and never counts it as\n * one of them. Set `column: { mobileHidden: true }` to drop it there (with\n * `mobileDetailsInRow` it then shows in the opened row instead).\n */\nexport function rowActionsColumn<T>({\n  key = \"actions\",\n  actions,\n  name,\n  collapse,\n  size,\n  glyphSize,\n  tooltipSide,\n  headerText,\n  header,\n  labels,\n  column,\n}: RowActionsColumnOptions<T>): DataTableColumn<T> {\n  return {\n    key,\n    header:\n      header === false || header == null ? (\n        <RowActionsHeader text={headerText} labels={labels} hidden={header === false} />\n      ) : (\n        header\n      ),\n    headerText,\n    cell: (row) => (\n      <RowActions\n        actions={actions(row)}\n        name={name?.(row)}\n        collapse={collapse}\n        size={size}\n        glyphSize={glyphSize}\n        tooltipSide={tooltipSide}\n        labels={labels}\n      />\n    ),\n    className: ROW_ACTIONS_CELL_CLASS,\n    // The heading over the buttons, at the row's end (0.46.1); a hand-built table's\n    // `RowActionsHead` (0.47).\n    headClassName: ROW_ACTIONS_HEAD_CLASS,\n    noRowLink: true,\n    // After the phone card's fields, never one of them (0.49 KIT-7).\n    role: \"actions\",\n    ...column,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/components/series-chart-axes.d.ts

@@ -52,8 +52,8 @@ export declare function soleSeriesColor(axis: Pick<SeriesChartAxis, "id" | "colo
 export declare function oneAxis(format: ((value: number) => string) | undefined, title: string, width?: number, orientation?: "left" | "right"): SeriesChartAxis[];
 /** One source's samples: an abscissa and the channels measured against it. */
 export interface SeriesSource {
-    x: number[];
-    channels: Record<string, number[]>;
+    x: readonly number[];
+    channels: Readonly<Record<string, readonly number[]>>;
 }
 /**
  * Merge sources sampled on different grids into rows the chart can draw.
@@ -63,7 +63,7 @@ export interface SeriesSource {
  * has no sample the key is absent, and `connectNulls` bridges the hole with the same
  * straight segment an interpolation would have drawn — without claiming a measurement.
  */
-export declare function mergeSeries(sources: SeriesSource[]): Record<string, number>[];
+export declare function mergeSeries(sources: readonly SeriesSource[]): Record<string, number>[];
 /**
  * A series key built out of parts — as a CSS identifier.
  *
@@ -97,7 +97,7 @@ export declare function anchoredBand(extent: readonly [number, number] | undefin
  * it in its neighbour's colour on each click. Resolving the colours on the full list
  * and filtering after keeps each series in the colour its legend entry shows.
  */
-export declare function visibleSeries(series: readonly SeriesChartSeries[], hidden: ReadonlySet<string>): SeriesChartSeries[];
+export declare function visibleSeries<TRow extends object>(series: readonly SeriesChartSeries<TRow>[], hidden: ReadonlySet<string>): SeriesChartSeries<TRow>[];
 /** A finite number, or `undefined` — the only thing a row cell counts as a sample. */
 export declare const finite: (value: unknown) => number | undefined;
 /**

package/dist/components/series-chart-axes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/series-chart-axes.ts"],"sourcesContent":["// The series chart's pure half: the axis bands, the padded and anchored domains, the\n// series keys and colours, and the abscissa reduced to a number line. No React, no\n// recharts and no JSX here (chart-zoom-core lends the one name `DEFAULT_Y_AXIS`) —\n// arithmetic over rows and axes, which is why apps import some of it in\n// files that draw no chart (Kurvenschmiede's curve-chart-model.ts builds its series\n// keys with `seriesKey`).\n//\n// Moved out of series-chart.tsx as it was (MOD-9, refactor audit 2026-10). The public\n// names are still exported from series-chart.tsx, so `/chart` and the barrel are\n// unchanged; this module is not an entry of its own. The names below that series-chart\n// does not re-export (the tick-band constants, `xModel`, `finite`, …) stay internal.\nimport { DEFAULT_Y_AXIS } from \"./chart-zoom-core\";\nimport type { TimeTickUnit } from \"./series-chart-ticks\";\nimport { paletteFor } from \"../theme/chart-palette\";\nimport type {\n  SeriesChartAxis,\n  SeriesChartRow,\n  SeriesChartSeries,\n  SeriesChartTickValues,\n  SeriesChartX,\n  SeriesChartXValue,\n} from \"./series-chart\";\n\n/** How much of an axis band the rotated title takes, in px at Normal — × the text size's\n *  scale on the chart (§3.2), since the title is text. Reserved rather than shared with\n *  the ticks: a title merely offset inside the band prints on top of a five-figure tick,\n *  and which gives way depends on the data. */\nexport const AXIS_TITLE_STRIP = 16;\n\n/** Where inside its strip the rotated title sits. */\nexport const AXIS_TITLE_OFFSET = 10;\n\n/** The tallest band tilted x ticks reserve, in px at Normal (× the scale). A category\n *  name longer than this at its angle is clipped rather than squeezing the plot down to\n *  a strip. */\nconst MAX_TILTED_TICK_BAND = 120;\n\n/** What one character of a tick label is taken to be, in px at Normal, for the tilted\n *  band — the shell's `text-xs`. An estimate: the SVG is not laid out yet when the band\n *  is decided. Both grow with the text size, as `text-xs` does (§3.2). */\nconst TICK_CHAR_WIDTH = 7;\nconst TICK_LINE_HEIGHT = 12;\n/** recharts' gap between the axis line and a bottom tick's text — px, at every size:\n *  recharts draws it, not the type. */\nconst TICK_GAP = 8;\n/** recharts' own band under level x ticks. */\nconst LEVEL_TICK_BAND = 30;\n/** The least room recharts' x ticks keep between labels, in px at Normal. */\nexport const MIN_TICK_GAP = 32;\n\n/**\n * The height the x axis reserves for its ticks at a text `scale`: tilted by `angle`\n * degrees, the rotated box of the longest label, from its length; level, recharts' own\n * 30 px grown with the labels. `undefined` for level ticks at Normal, where recharts'\n * default is exactly that.\n */\nexport function tiltedTickBand(labels: readonly string[], angle: number, scale = 1): number | undefined {\n  if (!angle) return scale === 1 ? undefined : Math.ceil(LEVEL_TICK_BAND * scale);\n  const rad = (Math.abs(angle) * Math.PI) / 180;\n  const longest = Math.max(0, ...labels.map((label) => label.length)) * TICK_CHAR_WIDTH * scale;\n  const band = Math.sin(rad) * longest + Math.cos(rad) * TICK_LINE_HEIGHT * scale + TICK_GAP;\n  return Math.min(\n    Math.round(MAX_TILTED_TICK_BAND * scale),\n    Math.max(Math.ceil(LEVEL_TICK_BAND * scale), Math.ceil(band)),\n  );\n}\n\n/** The width the ticks of a y axis get when a caller does not say, in px at Normal. */\nexport const AXIS_TICK_WIDTH = 48;\n\n/**\n * How much air a FITTED axis leaves between the data and its frame, as a fraction of\n * the range. Recharts fits `[dataMin, dataMax]`, which draws a peak half a stroke\n * outside the plot and a curve running to its limit indistinguishable from the frame.\n */\nconst AUTO_PAD = 0.04;\n\n/** The band a fitted axis draws, padded — and a real band for constant data, which is\n *  a zero-height domain recharts cannot scale into. `undefined` when nothing finite. */\nexport function paddedDomain(values: Iterable<number>): [number, number] | undefined {\n  let low = Infinity;\n  let high = -Infinity;\n  for (const value of values) {\n    if (!Number.isFinite(value)) continue;\n    if (value < low) low = value;\n    if (value > high) high = value;\n  }\n  return padBand(low, high);\n}\n\n/**\n * {@link paddedDomain} for a caller that has already walked its own data — so a row\n * of charts can share one scale without building an array to find two numbers in, and\n * without a second padding rule. `low > high` means \"nothing was seen\": `undefined`.\n */\nexport function padBand(low: number, high: number): [number, number] | undefined {\n  if (!(low <= high)) return undefined;\n  const pad = (high - low) * AUTO_PAD || Math.abs(high) * AUTO_PAD || 1;\n  return [low - pad, high + pad];\n}\n\n/**\n * The whole band a y axis occupies: its ticks, and its title when it draws one. For\n * lining a heading up over a PLOT rather than over its column.\n *\n * `scale` is the text size's (`useTextSize().scale`, §3.2, §10.10): the chart draws every\n * band — the default 48 px and a caller's own `width` alike (keksdose's\n * `MONEY_AXIS_WIDTH`) — this many times wider, because the ticks in it are `text-xs`\n * and grow with the text. A heading lined up over the plot has to pass the same scale.\n * One factor for both sides of a facing pair, so the mirrored bands stay equal.\n */\nexport function axisBandWidth(tickWidth: number | undefined, titled: boolean, scale = 1): number {\n  const band = (tickWidth ?? AXIS_TICK_WIDTH) + (titled ? AXIS_TITLE_STRIP : 0);\n  return scale === 1 ? band : Math.round(band * scale);\n}\n\n/**\n * The colour an axis TITLE takes, or `undefined` for the neutral one.\n *\n * An axis measuring exactly one line is that line's, and saying so in the title lets a\n * reader find a channel's scale without counting axes. An axis measuring several is\n * nobody's — a title in the first one's colour would be claiming it. Counted off the\n * series, so toggling a second line onto an axis gives the colour up in the same render.\n */\nexport function soleSeriesColor(\n  axis: Pick<SeriesChartAxis, \"id\" | \"color\">,\n  series: readonly Pick<SeriesChartSeries, \"axis\">[],\n): string | undefined {\n  const mine = series.filter((entry) => (entry.axis ?? DEFAULT_Y_AXIS) === axis.id);\n  return mine.length === 1 ? axis.color : undefined;\n}\n\n/** The single-axis case, which is most charts. `width` is what the TICKS need;\n *  `orientation` is which side they stand on. */\nexport function oneAxis(\n  format: ((value: number) => string) | undefined,\n  title: string,\n  width?: number,\n  orientation?: \"left\" | \"right\",\n): SeriesChartAxis[] {\n  return [{ id: DEFAULT_Y_AXIS, format, title, width, orientation }];\n}\n\n/** One source's samples: an abscissa and the channels measured against it. */\nexport interface SeriesSource {\n  x: number[];\n  channels: Record<string, number[]>;\n}\n\n/**\n * Merge sources sampled on different grids into rows the chart can draw.\n *\n * Merged ON THE ABSCISSA VALUE ITSELF, never interpolated onto a common grid: a line\n * through invented points looks exactly like one through measured ones. Where a source\n * has no sample the key is absent, and `connectNulls` bridges the hole with the same\n * straight segment an interpolation would have drawn — without claiming a measurement.\n */\nexport function mergeSeries(sources: SeriesSource[]): Record<string, number>[] {\n  const byAbscissa = new Map<number, Record<string, number>>();\n  for (const source of sources) {\n    source.x.forEach((value, index) => {\n      const row = byAbscissa.get(value) ?? { x: value };\n      for (const [key, channel] of Object.entries(source.channels)) row[key] = channel[index];\n      byAbscissa.set(value, row);\n    });\n  }\n  return [...byAbscissa.values()].sort((a, b) => a.x - b.x);\n}\n\n/**\n * A series key built out of parts — as a CSS identifier.\n *\n * The chart shell paints each series through `--color-<key>`, and skips (with a\n * console warning) any key that is not `[A-Za-z_][A-Za-z0-9_-]*`. A line whose colour\n * was skipped has no stroke at all: an axis, a grid and nothing between them. So a key\n * assembled out of DATA — an id, an enum, a side — goes through here: every other\n * character becomes `_`, the parts are joined with `_`, and a key that would start with\n * a digit or a hyphen gets a leading `_`.\n */\nexport function seriesKey(...parts: (string | number)[]): string {\n  const key = parts.map((part) => String(part).replace(/[^A-Za-z0-9_-]/g, \"_\")).join(\"_\");\n  return /^[A-Za-z_]/.test(key) ? key : `_${key}`;\n}\n\n/**\n * The band an axis carrying bars or areas draws: the data's extent with ZERO in it,\n * padded only on the sides that are not zero — bars standing on a frame's bottom edge,\n * not floating four per cent above it on a band of air nobody asked for.\n * `undefined` when there is nothing to fit.\n *\n * All-zero data (a quiet period, a zoom window over empty months) is `[0, 1]`: one unit\n * on the free side, the unit {@link padBand} pads a zero extent by. d3 maps every value\n * of a zero-height domain to the range's midpoint, so `[0, 0]` stood the bars on a\n * baseline in the middle of the plot, the \"0\" tick beside it (audit 2026-10-30 DSP-10;\n * keksdose's weekday pattern drew seven 4 px stubs mid-card for a period with no\n * spending).\n */\nexport function anchoredBand(extent: readonly [number, number] | undefined): [number, number] | undefined {\n  if (!extent) return undefined;\n  const low = Math.min(0, extent[0]);\n  const high = Math.max(0, extent[1]);\n  if (low === 0 && high === 0) return [0, 1];\n  const pad = (high - low) * AUTO_PAD || 1;\n  return [low < 0 ? low - pad : 0, high > 0 ? high + pad : 0];\n}\n\n/**\n * Series with their colours settled BEFORE any are switched off.\n *\n * A series with no `color` takes `paletteFor(its position)` — and a legend toggle that\n * hands the chart a shorter list moves every later series one position up, repainting\n * it in its neighbour's colour on each click. Resolving the colours on the full list\n * and filtering after keeps each series in the colour its legend entry shows.\n */\nexport function visibleSeries(series: readonly SeriesChartSeries[], hidden: ReadonlySet<string>): SeriesChartSeries[] {\n  return series\n    .map((entry, index) => ({ ...entry, color: entry.color ?? paletteFor(index) }))\n    .filter((entry) => !hidden.has(entry.key));\n}\n\n/** Where a category or time chart keeps each row's plotted position. Not the caller's\n *  key: that one still holds their own value, which `format` and a hit hand back. */\nconst PLOTTED_X = \"__seriesChartX\";\n\n/** A finite number, or `undefined` — the only thing a row cell counts as a sample. */\nexport const finite = (value: unknown): number | undefined =>\n  typeof value === \"number\" && Number.isFinite(value) ? value : undefined;\n\n/** A time value as epoch ms. A date-only ISO string is LOCAL midnight (see\n *  `SeriesChartX.type`); anything unreadable is `undefined`, i.e. not plotted. */\nfunction toTime(value: unknown): number | undefined {\n  if (value instanceof Date) return finite(value.getTime());\n  if (typeof value === \"number\") return finite(value);\n  if (typeof value !== \"string\") return undefined;\n  const day = /^(\\d{4})-(\\d{2})(?:-(\\d{2}))?$/.exec(value);\n  if (day) return new Date(Number(day[1]), Number(day[2]) - 1, Number(day[3] ?? 1)).getTime();\n  return finite(Date.parse(value));\n}\n\n/** A category's identity, so a Date matches another Date of the same instant. */\nconst categoryId = (value: unknown) =>\n  value instanceof Date ? `d:${value.getTime()}` : `${typeof value}:${String(value)}`;\n\n/**\n * The abscissa, reduced to a number line — which is all the plot, the ticks and the\n * zoom ever deal in. A number stays itself; a category becomes its slot index; a time\n * its epoch ms. Everything the caller sees (ticks, tooltip, hits) is turned back.\n */\nexport interface XModel {\n  kind: \"number\" | \"category\" | \"time\";\n  /** The caller's key, still holding their value. */\n  sourceKey: string;\n  /** The key the plot reads. The same as `sourceKey` on a number line. */\n  plotKey: string;\n  /** The rows as plotted. The caller's own on a number line. */\n  rows: readonly SeriesChartRow[];\n  /** The caller's rows, which dots and hits hand back. */\n  source: readonly SeriesChartRow[];\n  position: (value: unknown) => number | undefined;\n  valueAt: (position: number) => SeriesChartXValue;\n}\n\nexport function xModel(rows: readonly SeriesChartRow[], x: SeriesChartX): XModel {\n  const sourceKey = x.key ?? \"x\";\n  if (x.type === \"category\") {\n    const slots = new Map<string, number>();\n    rows.forEach((row, index) => {\n      const id = categoryId(row[sourceKey]);\n      if (!slots.has(id)) slots.set(id, index);\n    });\n    return {\n      kind: \"category\",\n      sourceKey,\n      plotKey: PLOTTED_X,\n      rows: rows.map((row, index) => ({ ...row, [PLOTTED_X]: index })),\n      source: rows,\n      position: (value) => slots.get(categoryId(value)),\n      valueAt: (position) => rows[Math.round(position)]?.[sourceKey] as SeriesChartXValue,\n    };\n  }\n  if (x.type === \"time\") {\n    return {\n      kind: \"time\",\n      sourceKey,\n      plotKey: PLOTTED_X,\n      rows: rows.map((row) => ({ ...row, [PLOTTED_X]: toTime(row[sourceKey]) })),\n      source: rows,\n      position: toTime,\n      valueAt: (position) => new Date(position),\n    };\n  }\n  return {\n    kind: \"number\",\n    sourceKey,\n    plotKey: sourceKey,\n    rows,\n    source: rows,\n    position: finite,\n    valueAt: (position) => position,\n  };\n}\n\n/** Caller ticks, as positions inside the domain on show. */\nexport function resolveTicks<T>(\n  values: SeriesChartTickValues<T> | undefined,\n  domain: [number, number] | undefined,\n  position: (value: T) => number | undefined,\n): number[] | undefined {\n  if (!values || !domain) return undefined;\n  const list = typeof values === \"function\" ? values(domain) : values;\n  if (!list) return undefined;\n  const slack = (domain[1] - domain[0]) * 1e-9;\n  return list\n    .map(position)\n    .filter((at): at is number => at !== undefined && at >= domain[0] - slack && at <= domain[1] + slack);\n}\n\n/** A low/high pair widened by some values, or `undefined` if there is still none. */\nexport function extend(\n  span: readonly [number, number] | undefined,\n  values: readonly (number | undefined)[],\n): [number, number] | undefined {\n  let out: [number, number] | undefined = span ? [span[0], span[1]] : undefined;\n  for (const value of values) {\n    if (value === undefined || !Number.isFinite(value)) continue;\n    out = out ? [Math.min(out[0], value), Math.max(out[1], value)] : [value, value];\n  }\n  return out;\n}\n\n/** How a time tick is written, by what one step of the ticks is. */\nexport const TIME_TICK_FORMAT: Record<TimeTickUnit, Intl.DateTimeFormatOptions> = {\n  hour: { hour: \"2-digit\", minute: \"2-digit\" },\n  day: { day: \"numeric\", month: \"short\" },\n  month: { month: \"short\", year: \"2-digit\" },\n  year: { year: \"numeric\" },\n};\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/components/series-chart-axes.ts"],"sourcesContent":["// The series chart's pure half: the axis bands, the padded and anchored domains, the\n// series keys and colours, and the abscissa reduced to a number line. No React, no\n// recharts and no JSX here (chart-zoom-core lends the one name `DEFAULT_Y_AXIS`) —\n// arithmetic over rows and axes, which is why apps import some of it in\n// files that draw no chart (Kurvenschmiede's curve-chart-model.ts builds its series\n// keys with `seriesKey`).\n//\n// Moved out of series-chart.tsx as it was (MOD-9, refactor audit 2026-10). The public\n// names are still exported from series-chart.tsx, so `/chart` and the barrel are\n// unchanged; this module is not an entry of its own. The names below that series-chart\n// does not re-export (the tick-band constants, `xModel`, `finite`, …) stay internal.\nimport { DEFAULT_Y_AXIS } from \"./chart-zoom-core\";\nimport type { TimeTickUnit } from \"./series-chart-ticks\";\nimport { paletteFor } from \"../theme/chart-palette\";\nimport type {\n  SeriesChartAxis,\n  SeriesChartRow,\n  SeriesChartSeries,\n  SeriesChartTickValues,\n  SeriesChartX,\n  SeriesChartXValue,\n} from \"./series-chart\";\n\n/** How much of an axis band the rotated title takes, in px at Normal — × the text size's\n *  scale on the chart (§3.2), since the title is text. Reserved rather than shared with\n *  the ticks: a title merely offset inside the band prints on top of a five-figure tick,\n *  and which gives way depends on the data. */\nexport const AXIS_TITLE_STRIP = 16;\n\n/** Where inside its strip the rotated title sits. */\nexport const AXIS_TITLE_OFFSET = 10;\n\n/** The tallest band tilted x ticks reserve, in px at Normal (× the scale). A category\n *  name longer than this at its angle is clipped rather than squeezing the plot down to\n *  a strip. */\nconst MAX_TILTED_TICK_BAND = 120;\n\n/** What one character of a tick label is taken to be, in px at Normal, for the tilted\n *  band — the shell's `text-xs`. An estimate: the SVG is not laid out yet when the band\n *  is decided. Both grow with the text size, as `text-xs` does (§3.2). */\nconst TICK_CHAR_WIDTH = 7;\nconst TICK_LINE_HEIGHT = 12;\n/** recharts' gap between the axis line and a bottom tick's text — px, at every size:\n *  recharts draws it, not the type. */\nconst TICK_GAP = 8;\n/** recharts' own band under level x ticks. */\nconst LEVEL_TICK_BAND = 30;\n/** The least room recharts' x ticks keep between labels, in px at Normal. */\nexport const MIN_TICK_GAP = 32;\n\n/**\n * The height the x axis reserves for its ticks at a text `scale`: tilted by `angle`\n * degrees, the rotated box of the longest label, from its length; level, recharts' own\n * 30 px grown with the labels. `undefined` for level ticks at Normal, where recharts'\n * default is exactly that.\n */\nexport function tiltedTickBand(labels: readonly string[], angle: number, scale = 1): number | undefined {\n  if (!angle) return scale === 1 ? undefined : Math.ceil(LEVEL_TICK_BAND * scale);\n  const rad = (Math.abs(angle) * Math.PI) / 180;\n  const longest = Math.max(0, ...labels.map((label) => label.length)) * TICK_CHAR_WIDTH * scale;\n  const band = Math.sin(rad) * longest + Math.cos(rad) * TICK_LINE_HEIGHT * scale + TICK_GAP;\n  return Math.min(\n    Math.round(MAX_TILTED_TICK_BAND * scale),\n    Math.max(Math.ceil(LEVEL_TICK_BAND * scale), Math.ceil(band)),\n  );\n}\n\n/** The width the ticks of a y axis get when a caller does not say, in px at Normal. */\nexport const AXIS_TICK_WIDTH = 48;\n\n/**\n * How much air a FITTED axis leaves between the data and its frame, as a fraction of\n * the range. Recharts fits `[dataMin, dataMax]`, which draws a peak half a stroke\n * outside the plot and a curve running to its limit indistinguishable from the frame.\n */\nconst AUTO_PAD = 0.04;\n\n/** The band a fitted axis draws, padded — and a real band for constant data, which is\n *  a zero-height domain recharts cannot scale into. `undefined` when nothing finite. */\nexport function paddedDomain(values: Iterable<number>): [number, number] | undefined {\n  let low = Infinity;\n  let high = -Infinity;\n  for (const value of values) {\n    if (!Number.isFinite(value)) continue;\n    if (value < low) low = value;\n    if (value > high) high = value;\n  }\n  return padBand(low, high);\n}\n\n/**\n * {@link paddedDomain} for a caller that has already walked its own data — so a row\n * of charts can share one scale without building an array to find two numbers in, and\n * without a second padding rule. `low > high` means \"nothing was seen\": `undefined`.\n */\nexport function padBand(low: number, high: number): [number, number] | undefined {\n  if (!(low <= high)) return undefined;\n  const pad = (high - low) * AUTO_PAD || Math.abs(high) * AUTO_PAD || 1;\n  return [low - pad, high + pad];\n}\n\n/**\n * The whole band a y axis occupies: its ticks, and its title when it draws one. For\n * lining a heading up over a PLOT rather than over its column.\n *\n * `scale` is the text size's (`useTextSize().scale`, §3.2, §10.10): the chart draws every\n * band — the default 48 px and a caller's own `width` alike (keksdose's\n * `MONEY_AXIS_WIDTH`) — this many times wider, because the ticks in it are `text-xs`\n * and grow with the text. A heading lined up over the plot has to pass the same scale.\n * One factor for both sides of a facing pair, so the mirrored bands stay equal.\n */\nexport function axisBandWidth(tickWidth: number | undefined, titled: boolean, scale = 1): number {\n  const band = (tickWidth ?? AXIS_TICK_WIDTH) + (titled ? AXIS_TITLE_STRIP : 0);\n  return scale === 1 ? band : Math.round(band * scale);\n}\n\n/**\n * The colour an axis TITLE takes, or `undefined` for the neutral one.\n *\n * An axis measuring exactly one line is that line's, and saying so in the title lets a\n * reader find a channel's scale without counting axes. An axis measuring several is\n * nobody's — a title in the first one's colour would be claiming it. Counted off the\n * series, so toggling a second line onto an axis gives the colour up in the same render.\n */\nexport function soleSeriesColor(\n  axis: Pick<SeriesChartAxis, \"id\" | \"color\">,\n  series: readonly Pick<SeriesChartSeries, \"axis\">[],\n): string | undefined {\n  const mine = series.filter((entry) => (entry.axis ?? DEFAULT_Y_AXIS) === axis.id);\n  return mine.length === 1 ? axis.color : undefined;\n}\n\n/** The single-axis case, which is most charts. `width` is what the TICKS need;\n *  `orientation` is which side they stand on. */\nexport function oneAxis(\n  format: ((value: number) => string) | undefined,\n  title: string,\n  width?: number,\n  orientation?: \"left\" | \"right\",\n): SeriesChartAxis[] {\n  return [{ id: DEFAULT_Y_AXIS, format, title, width, orientation }];\n}\n\n/** One source's samples: an abscissa and the channels measured against it. */\nexport interface SeriesSource {\n  x: readonly number[];\n  channels: Readonly<Record<string, readonly number[]>>;\n}\n\n/**\n * Merge sources sampled on different grids into rows the chart can draw.\n *\n * Merged ON THE ABSCISSA VALUE ITSELF, never interpolated onto a common grid: a line\n * through invented points looks exactly like one through measured ones. Where a source\n * has no sample the key is absent, and `connectNulls` bridges the hole with the same\n * straight segment an interpolation would have drawn — without claiming a measurement.\n */\nexport function mergeSeries(sources: readonly SeriesSource[]): Record<string, number>[] {\n  const byAbscissa = new Map<number, Record<string, number>>();\n  for (const source of sources) {\n    source.x.forEach((value, index) => {\n      const row = byAbscissa.get(value) ?? { x: value };\n      for (const [key, channel] of Object.entries(source.channels)) row[key] = channel[index];\n      byAbscissa.set(value, row);\n    });\n  }\n  return [...byAbscissa.values()].sort((a, b) => a.x - b.x);\n}\n\n/**\n * A series key built out of parts — as a CSS identifier.\n *\n * The chart shell paints each series through `--color-<key>`, and skips (with a\n * console warning) any key that is not `[A-Za-z_][A-Za-z0-9_-]*`. A line whose colour\n * was skipped has no stroke at all: an axis, a grid and nothing between them. So a key\n * assembled out of DATA — an id, an enum, a side — goes through here: every other\n * character becomes `_`, the parts are joined with `_`, and a key that would start with\n * a digit or a hyphen gets a leading `_`.\n */\nexport function seriesKey(...parts: (string | number)[]): string {\n  const key = parts.map((part) => String(part).replace(/[^A-Za-z0-9_-]/g, \"_\")).join(\"_\");\n  return /^[A-Za-z_]/.test(key) ? key : `_${key}`;\n}\n\n/**\n * The band an axis carrying bars or areas draws: the data's extent with ZERO in it,\n * padded only on the sides that are not zero — bars standing on a frame's bottom edge,\n * not floating four per cent above it on a band of air nobody asked for.\n * `undefined` when there is nothing to fit.\n *\n * All-zero data (a quiet period, a zoom window over empty months) is `[0, 1]`: one unit\n * on the free side, the unit {@link padBand} pads a zero extent by. d3 maps every value\n * of a zero-height domain to the range's midpoint, so `[0, 0]` stood the bars on a\n * baseline in the middle of the plot, the \"0\" tick beside it (audit 2026-10-30 DSP-10;\n * keksdose's weekday pattern drew seven 4 px stubs mid-card for a period with no\n * spending).\n */\nexport function anchoredBand(extent: readonly [number, number] | undefined): [number, number] | undefined {\n  if (!extent) return undefined;\n  const low = Math.min(0, extent[0]);\n  const high = Math.max(0, extent[1]);\n  if (low === 0 && high === 0) return [0, 1];\n  const pad = (high - low) * AUTO_PAD || 1;\n  return [low < 0 ? low - pad : 0, high > 0 ? high + pad : 0];\n}\n\n/**\n * Series with their colours settled BEFORE any are switched off.\n *\n * A series with no `color` takes `paletteFor(its position)` — and a legend toggle that\n * hands the chart a shorter list moves every later series one position up, repainting\n * it in its neighbour's colour on each click. Resolving the colours on the full list\n * and filtering after keeps each series in the colour its legend entry shows.\n */\n// Generic so a typed list comes back typed (0.53): a chart of `Month` rows takes it, and\n// its `dot`s still read `point.row` as a `Month`.\nexport function visibleSeries<TRow extends object>(\n  series: readonly SeriesChartSeries<TRow>[],\n  hidden: ReadonlySet<string>,\n): SeriesChartSeries<TRow>[] {\n  return series\n    .map((entry, index) => ({ ...entry, color: entry.color ?? paletteFor(index) }))\n    .filter((entry) => !hidden.has(entry.key));\n}\n\n/** Where a category or time chart keeps each row's plotted position. Not the caller's\n *  key: that one still holds their own value, which `format` and a hit hand back. */\nconst PLOTTED_X = \"__seriesChartX\";\n\n/** A finite number, or `undefined` — the only thing a row cell counts as a sample. */\nexport const finite = (value: unknown): number | undefined =>\n  typeof value === \"number\" && Number.isFinite(value) ? value : undefined;\n\n/** A time value as epoch ms. A date-only ISO string is LOCAL midnight (see\n *  `SeriesChartX.type`); anything unreadable is `undefined`, i.e. not plotted. */\nfunction toTime(value: unknown): number | undefined {\n  if (value instanceof Date) return finite(value.getTime());\n  if (typeof value === \"number\") return finite(value);\n  if (typeof value !== \"string\") return undefined;\n  const day = /^(\\d{4})-(\\d{2})(?:-(\\d{2}))?$/.exec(value);\n  if (day) return new Date(Number(day[1]), Number(day[2]) - 1, Number(day[3] ?? 1)).getTime();\n  return finite(Date.parse(value));\n}\n\n/** A category's identity, so a Date matches another Date of the same instant. */\nconst categoryId = (value: unknown) =>\n  value instanceof Date ? `d:${value.getTime()}` : `${typeof value}:${String(value)}`;\n\n/**\n * The abscissa, reduced to a number line — which is all the plot, the ticks and the\n * zoom ever deal in. A number stays itself; a category becomes its slot index; a time\n * its epoch ms. Everything the caller sees (ticks, tooltip, hits) is turned back.\n */\nexport interface XModel {\n  kind: \"number\" | \"category\" | \"time\";\n  /** The caller's key, still holding their value. */\n  sourceKey: string;\n  /** The key the plot reads. The same as `sourceKey` on a number line. */\n  plotKey: string;\n  /** The rows as plotted. The caller's own on a number line. */\n  rows: readonly SeriesChartRow[];\n  /** The caller's rows, which dots and hits hand back. */\n  source: readonly SeriesChartRow[];\n  position: (value: unknown) => number | undefined;\n  valueAt: (position: number) => SeriesChartXValue;\n}\n\nexport function xModel(rows: readonly SeriesChartRow[], x: SeriesChartX): XModel {\n  const sourceKey = x.key ?? \"x\";\n  if (x.type === \"category\") {\n    const slots = new Map<string, number>();\n    rows.forEach((row, index) => {\n      const id = categoryId(row[sourceKey]);\n      if (!slots.has(id)) slots.set(id, index);\n    });\n    return {\n      kind: \"category\",\n      sourceKey,\n      plotKey: PLOTTED_X,\n      rows: rows.map((row, index) => ({ ...row, [PLOTTED_X]: index })),\n      source: rows,\n      position: (value) => slots.get(categoryId(value)),\n      valueAt: (position) => rows[Math.round(position)]?.[sourceKey] as SeriesChartXValue,\n    };\n  }\n  if (x.type === \"time\") {\n    return {\n      kind: \"time\",\n      sourceKey,\n      plotKey: PLOTTED_X,\n      rows: rows.map((row) => ({ ...row, [PLOTTED_X]: toTime(row[sourceKey]) })),\n      source: rows,\n      position: toTime,\n      valueAt: (position) => new Date(position),\n    };\n  }\n  return {\n    kind: \"number\",\n    sourceKey,\n    plotKey: sourceKey,\n    rows,\n    source: rows,\n    position: finite,\n    valueAt: (position) => position,\n  };\n}\n\n/** Caller ticks, as positions inside the domain on show. */\nexport function resolveTicks<T>(\n  values: SeriesChartTickValues<T> | undefined,\n  domain: [number, number] | undefined,\n  position: (value: T) => number | undefined,\n): number[] | undefined {\n  if (!values || !domain) return undefined;\n  const list = typeof values === \"function\" ? values(domain) : values;\n  if (!list) return undefined;\n  const slack = (domain[1] - domain[0]) * 1e-9;\n  return list\n    .map(position)\n    .filter((at): at is number => at !== undefined && at >= domain[0] - slack && at <= domain[1] + slack);\n}\n\n/** A low/high pair widened by some values, or `undefined` if there is still none. */\nexport function extend(\n  span: readonly [number, number] | undefined,\n  values: readonly (number | undefined)[],\n): [number, number] | undefined {\n  let out: [number, number] | undefined = span ? [span[0], span[1]] : undefined;\n  for (const value of values) {\n    if (value === undefined || !Number.isFinite(value)) continue;\n    out = out ? [Math.min(out[0], value), Math.max(out[1], value)] : [value, value];\n  }\n  return out;\n}\n\n/** How a time tick is written, by what one step of the ticks is. */\nexport const TIME_TICK_FORMAT: Record<TimeTickUnit, Intl.DateTimeFormatOptions> = {\n  hour: { hour: \"2-digit\", minute: \"2-digit\" },\n  day: { day: \"numeric\", month: \"short\" },\n  month: { month: \"short\", year: \"2-digit\" },\n  year: { year: \"numeric\" },\n};\n"],"mappings":"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","names":[]}

package/dist/components/series-chart-labels.d.ts

@@ -1,15 +1,18 @@
 export interface SeriesChartLabels {
     /** The button that puts a zoomed chart back to its full extent. Visible text. */
     resetZoom: string;
-    /** Accessible name of the drag surface laid over the plot. It is the only place the
-     *  gesture is explained, so it says how the drag is read and how to undo it. */
+    /** The drag-to-zoom gesture, said at the end of a zoomable chart's description (the
+     *  figure's `aria-describedby`; until 0.52 the name of the drag surface, an
+     *  `application` nothing could focus). It is the only place the gesture is explained,
+     *  so it says how the drag is read and how to undo it. */
     zoomHint: string;
     /** What a chart with nothing to draw says, when the caller passes no `empty`. */
     empty: string;
     /** Accessible name of a `ToggleLegend` — a group of switches, one per series. */
     legend: string;
-    /** Accessible name of the group of keyboard stops a clickable chart (`onPointClick`)
-     *  lays over its bars or periods — one tab stop, arrow keys between them. */
+    /** Accessible name of the group of keyboard stops a chart lays over its bars or
+     *  periods — one tab stop, arrow keys between them; buttons with `onPointClick`, and
+     *  since 0.52 images to read without. */
     points: string;
 }
 export declare const DEFAULT_SERIES_CHART_LABELS: SeriesChartLabels;

package/dist/components/series-chart-labels.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/series-chart-labels.ts"],"sourcesContent":["// All user-facing strings for the series chart family — `SeriesChart`, its drag-to-zoom\n// layer and `ToggleLegend` — as the `seriesChart` namespace of `<UiKitProvider labels>`,\n// and per chart the `labels` prop over that.\n//\n// A module of its own, with no recharts in it, so the label registry (src/i18n) can\n// import the defaults without pulling the chart library in behind them.\n\nexport interface SeriesChartLabels {\n  /** The button that puts a zoomed chart back to its full extent. Visible text. */\n  resetZoom: string;\n  /** Accessible name of the drag surface laid over the plot. It is the only place the\n   *  gesture is explained, so it says how the drag is read and how to undo it. */\n  zoomHint: string;\n  /** What a chart with nothing to draw says, when the caller passes no `empty`. */\n  empty: string;\n  /** Accessible name of a `ToggleLegend` — a group of switches, one per series. */\n  legend: string;\n  /** Accessible name of the group of keyboard stops a clickable chart (`onPointClick`)\n   *  lays over its bars or periods — one tab stop, arrow keys between them. */\n  points: string;\n}\n\nexport const DEFAULT_SERIES_CHART_LABELS: SeriesChartLabels = {\n  resetZoom: \"Reset zoom\",\n  zoomHint:\n    \"Drag to zoom: a roughly square selection zooms both axes, a long thin one only its own. Double-click to reset.\",\n  empty: \"No data\",\n  legend: \"Series\",\n  points: \"Chart values\",\n};\n"],"mappings":";AAsBO,MAAM,8BAAiD;AAAA,EAC5D,WAAW;AAAA,EACX,UACE;AAAA,EACF,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AACV;","names":[]}
+{"version":3,"sources":["../../src/components/series-chart-labels.ts"],"sourcesContent":["// All user-facing strings for the series chart family — `SeriesChart`, its drag-to-zoom\n// layer and `ToggleLegend` — as the `seriesChart` namespace of `<UiKitProvider labels>`,\n// and per chart the `labels` prop over that.\n//\n// A module of its own, with no recharts in it, so the label registry (src/i18n) can\n// import the defaults without pulling the chart library in behind them.\n\nexport interface SeriesChartLabels {\n  /** The button that puts a zoomed chart back to its full extent. Visible text. */\n  resetZoom: string;\n  /** The drag-to-zoom gesture, said at the end of a zoomable chart's description (the\n   *  figure's `aria-describedby`; until 0.52 the name of the drag surface, an\n   *  `application` nothing could focus). It is the only place the gesture is explained,\n   *  so it says how the drag is read and how to undo it. */\n  zoomHint: string;\n  /** What a chart with nothing to draw says, when the caller passes no `empty`. */\n  empty: string;\n  /** Accessible name of a `ToggleLegend` — a group of switches, one per series. */\n  legend: string;\n  /** Accessible name of the group of keyboard stops a chart lays over its bars or\n   *  periods — one tab stop, arrow keys between them; buttons with `onPointClick`, and\n   *  since 0.52 images to read without. */\n  points: string;\n}\n\nexport const DEFAULT_SERIES_CHART_LABELS: SeriesChartLabels = {\n  resetZoom: \"Reset zoom\",\n  zoomHint:\n    \"Drag to zoom: a roughly square selection zooms both axes, a long thin one only its own. Double-click to reset.\",\n  empty: \"No data\",\n  legend: \"Series\",\n  points: \"Chart values\",\n};\n"],"mappings":";AAyBO,MAAM,8BAAiD;AAAA,EAC5D,WAAW;AAAA,EACX,UACE;AAAA,EACF,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AACV;","names":[]}

package/dist/components/series-chart.d.ts

@@ -10,7 +10,14 @@ export { AXIS_TICK_WIDTH, AXIS_TITLE_STRIP, anchoredBand, axisBandWidth, mergeSe
 export type { SeriesSource } from "./series-chart-axes.js";
 import { type ChartTooltipPlacement, type LabelOverride } from "../i18n/kit-labels.js";
 import { type ChartHeight } from "./chart-height.js";
-export interface SeriesChartSeries {
+/**
+ * One line, area or bar run of a {@link SeriesChart}.
+ *
+ * `TRow` is the chart's row type (0.53, keksdose after 0.52), and only `dot` reads it: its
+ * `point.row` is that type. Without a type argument a series is what it was, and a chart
+ * of typed rows still takes it — see {@link SeriesChartProps}.
+ */
+export interface SeriesChartSeries<TRow extends object = object> {
     /** The row key this line reads — and the `--color-<key>` it is painted with, so it
      *  must be a CSS identifier. Build keys out of data with {@link seriesKey}. */
     key: string;
@@ -58,8 +65,9 @@ export interface SeriesChartSeries {
      * point: `true` for the default dot, `false`/`null` for none, or any SVG node drawn
      * as-is at `point.cx`/`point.cy` — a buy/sell marker on keksdose's paper price.
      * Never called for a point with no value. Bars have no points, and ignore it.
+     * `point.row` is the caller's own row, typed as the chart's rows are (0.53).
      */
-    dot?: boolean | ((point: SeriesChartPoint) => ReactNode);
+    dot?: boolean | ((point: SeriesChartPoint<TRow>) => ReactNode);
     /** Line (or area outline) weight in px. Default 2, or 1.5 for a `step`. keksdose
      *  draws the subject of a chart at 2.5 and the reference it is read against at 1.5. */
     strokeWidth?: number;
@@ -94,14 +102,16 @@ export interface SeriesChartSeries {
 }
 /** What a series draws. See {@link SeriesChartSeries.type}. */
 export type SeriesChartType = "line" | "bar" | "area";
-/** One point of a series, as a `dot` function is handed it. */
-export interface SeriesChartPoint {
+/** One point of a series, as a `dot` function is handed it. `TRow` is the chart's row
+ *  type (0.53); without one, `row` is a {@link SeriesChartRow}, as before. */
+export interface SeriesChartPoint<TRow extends object = object> {
     /** The series' key. */
     key: string;
     /** The row's position in `rows`. */
     index: number;
-    /** The caller's own row, with everything the chart did not plot still in it. */
-    row: SeriesChartRow;
+    /** The caller's own row, with everything the chart did not plot still in it: the very
+     *  object in `rows`, typed as `rows` is. */
+    row: SeriesChartRowOf<TRow>;
     /** The abscissa in the caller's terms: the number, the category, or (time) a Date. */
     x: SeriesChartXValue;
     value: number;
@@ -113,8 +123,26 @@ export interface SeriesChartPoint {
 }
 /** A row of a series chart: one abscissa value and the series' values at it. Anything
  *  else in it (a raw ISO period for a drilldown) rides along untouched and is handed
- *  back in {@link SeriesChartPoint.row} and {@link SeriesChartHit.row}. */
+ *  back in {@link SeriesChartPoint.row} and {@link SeriesChartHit.row} — typed as the
+ *  caller's rows are since 0.53, and as this where their type names no keys. */
 export type SeriesChartRow = Readonly<Record<string, unknown>>;
+/**
+ * The row a hit or a point hands back, for a chart whose rows are `TRow[]` (0.53, keksdose
+ * after 0.52): `TRow` itself, so a drilldown reads `hit.row.rawPeriod` as the string it
+ * is. A {@link SeriesChartRow} where `TRow` names no keys — `object`, the default, which
+ * keeps `SeriesChartHit` and `SeriesChartPoint` without a type argument what they were, and
+ * the `object[]` rows an app passes today; `{}`; and `any` or `never` (`rows={[]}`), which
+ * are both assignable to `null` while no object type is.
+ *
+ * Both tests take `TRow` in the CHECKED position, never in the `extends` one, so TypeScript
+ * measures every type below as covariant in it (`SeriesChartSeries`, through `dot`'s
+ * parameter, contravariant) and relates two of them by their type arguments alone: a
+ * `SeriesChartHit<Month>` is a `SeriesChartHit`, and a handler or a series typed without an
+ * argument fits a chart of `Month` rows, though an interface has no index signature and is
+ * not, field by field, a `SeriesChartRow`. Written `object extends TRow ?`, the type is
+ * invariant and both of those stop type-checking.
+ */
+type SeriesChartRowOf<TRow> = [TRow] extends [null] ? SeriesChartRow : [keyof TRow] extends [never] ? SeriesChartRow : TRow;
 /** An abscissa value: a number (`x.type: "number"`), a category (a string, a number or
  *  a Date standing for a period), or a time (a Date, epoch ms or an ISO string). */
 export type SeriesChartXValue = number | string | Date;
@@ -406,23 +434,43 @@ export interface SeriesChartMarker {
     /** Radius in px. Default 4.5. */
     r?: number;
 }
-/** What a click on the plot picked. */
-export interface SeriesChartHit {
+/** What a click on the plot picked. `TRow` is the chart's row type (0.53); without one,
+ *  `row` is a {@link SeriesChartRow}, as before. */
+export interface SeriesChartHit<TRow extends object = object> {
     /** The row's position in `rows`. */
     index: number;
-    /** The caller's own row — with its `rawPeriod`, id or whatever the drilldown needs. */
-    row: SeriesChartRow;
+    /** The caller's own row — with its `rawPeriod`, id or whatever the drilldown needs: the
+     *  very object in `rows`, typed as `rows` is, so it is read without a cast. */
+    row: SeriesChartRowOf<TRow>;
     x: SeriesChartXValue;
     /** The series, when the click landed ON a bar. A click anywhere else picks the slot
      *  (the period), not a series. */
     key?: string;
 }
-export interface SeriesChartProps {
-    /** One row per abscissa value. A missing key is a hole (see `connectNulls`). */
-    rows: readonly SeriesChartRow[];
-    series: SeriesChartSeries[];
+/**
+ * The props of {@link SeriesChart} and {@link StaticSeriesChart}, for rows of type `TRow`.
+ *
+ * `TRow` is inferred from `rows` (0.53, keksdose after 0.52), and what the chart hands back
+ * — `hit.row` in `onPointClick`, `point.row` in a series' `dot` — is that type, so a
+ * drilldown reads its own fields without narrowing an `unknown`. Without a type argument,
+ * `SeriesChartProps` is what it was: any object is a row, and a row comes back as a
+ * {@link SeriesChartRow}. So is `ComponentProps<typeof SeriesChart>`, which reads the
+ * constraint, `object`. A series, a handler or a `dot` typed without an argument fits a
+ * chart of typed rows too.
+ */
+export interface SeriesChartProps<TRow extends object = object> {
+    /**
+     * One row per abscissa value. A missing key is a hole (see `connectNulls`).
+     *
+     * Any object (0.52, refactor audit 2026-10-30, API-2): an `interface` has no index
+     * signature, so a typed sweep did not fit `SeriesChartRow` and Kurvenschmiede cast its
+     * Ackermann rows `as unknown as Record<string, number>[]`. The chart reads the keys
+     * `series` and `x` name, and hands the row back typed as these are (0.53).
+     */
+    rows: readonly TRow[];
+    series: readonly SeriesChartSeries<TRow>[];
     /** Default: one untitled axis, `"y"`. */
-    axes?: SeriesChartAxis[];
+    axes?: readonly SeriesChartAxis[];
     x?: SeriesChartX;
     /** A value in the tooltip, where a number stands on its own and needs its unit.
      *  Default: `Intl.NumberFormat` in the kit's locale. */
@@ -454,11 +502,11 @@ export interface SeriesChartProps {
      * as the curve twitching. Turn it on where series come and go by choice.
      */
     animationMs?: number;
-    spans?: SeriesChartSpan[];
+    spans?: readonly SeriesChartSpan[];
     /** Lines across the plot at one value. */
-    references?: SeriesChartReference[];
+    references?: readonly SeriesChartReference[];
     /** Single labelled points. */
-    markers?: SeriesChartMarker[];
+    markers?: readonly SeriesChartMarker[];
     /**
      * Which axes a drag may zoom: `"both"`, `"x"`, `"y"` or `"none"`. Default: read off
      * the marks — see `defaultZoomAxes` (lines both, areas x, bars none). An axis carrying
@@ -470,8 +518,12 @@ export interface SeriesChartProps {
      * A click on the plot: the slot under the pointer, and the series when it landed on a
      * bar. keksdose's drilldowns — a payee's month, a budget line, a spending category.
      * A drag that zoomed is not a click.
+     *
+     * The keyboard's stops are there either way (0.52, DSP-5): one per bar, or per slot of
+     * a chart without bars, named "period — series: value", behind ONE tab stop. With this
+     * they are buttons that Enter and Space activate; without, images to read.
      */
-    onPointClick?: (hit: SeriesChartHit) => void;
+    onPointClick?: (hit: SeriesChartHit<TRow>) => void;
     /** Where the tooltip may go: for a chart inside a scroll wrapper. See
      *  {@link SeriesChartTooltip}. */
     tooltip?: SeriesChartTooltip;
@@ -518,6 +570,19 @@ export interface SeriesChartProps {
     labels?: LabelOverride<SeriesChartLabels>;
     /** BCP 47 tag for the default number formats. Default: the provider's. */
     locale?: string;
+    /**
+     * The chart's name. The chart is a `role="figure"` (0.52, refactor audit 2026-10-30,
+     * DSP-5), and a figure is found and told apart by its name — "Net worth", "Load over
+     * travel". Its values are read stop by stop (see {@link SeriesChartProps.onPointClick}).
+     */
+    "aria-label"?: string;
+    /**
+     * What the picture SHOWS, in a sentence — "Spending rose 12 % in May, led by rent." —
+     * the figure's accessible description: a line, an area and a ruler are nothing a screen
+     * reader can say. Followed, on a zoomable chart, by the drag gesture (`zoomHint`). Not
+     * drawn; a caption the eye should read too belongs in the page.
+     */
+    description?: string;
     /** Onto the chart's root (`ChartContainer`) — e.g. an app's own grid ink. */
     className?: string;
     /** The shortest bar drawn, in px, for every bar series that does not set its own
@@ -571,17 +636,21 @@ export interface SeriesLegendAxes {
  * series whose axis is not drawn says the unit that axis would have: "Velocity (mm/s)"
  * — see {@link SeriesChartAxis.unit}. Without them, the labels are as given.
  */
-export declare function seriesLegendEntries(series: readonly SeriesChartSeries[], { axes, budgeted }?: SeriesLegendAxes): LegendEntry[];
+export declare function seriesLegendEntries<TRow extends object>(series: readonly SeriesChartSeries<TRow>[], { axes, budgeted }?: SeriesLegendAxes): LegendEntry[];
 /**
  * {@link SeriesChart} without the zoom: the same picture, no drag layer, no reset
  * button. For a thumbnail, a print view, or a chart the consumer wraps in its own
  * interaction.
  */
-export declare function StaticSeriesChart(props: SeriesChartProps): import("react").JSX.Element;
+export declare function StaticSeriesChart<TRow extends object = object>(props: SeriesChartProps<TRow>): import("react").JSX.Element;
 /**
  * The series chart, zoomable. Drag across the plot to zoom (the drag's shape picks the
  * axes), double-click or press the reset button to go back; wrap several in
  * `SharedXZoom` to move their x windows together. Which axes zoom depends on the marks
  * — see {@link SeriesChartProps.zoomAxes}.
+ *
+ * Generic in its rows (0.53): `hit.row` and a `dot`'s `point.row` are typed as `rows` is —
+ * see {@link SeriesChartProps}. A plain function, so the generic survives: a `memo` or a
+ * `forwardRef` around it would read `TRow` as its constraint.
  */
-export declare function SeriesChart(props: SeriesChartProps): import("react").JSX.Element;
+export declare function SeriesChart<TRow extends object = object>(props: SeriesChartProps<TRow>): import("react").JSX.Element;