@eifi1/ui-kit 0.46.0 → 0.47.0

package/dist/components/row-actions.d.ts

@@ -5,6 +5,7 @@ import { type CommitScope } from "./write-lock.js";
 import type { IconButtonGlyphSize, IconButtonSize } from "./icon-button.js";
 import type { TooltipSide } from "./tooltip.js";
 import type { DataTableColumn } from "./data-table.js";
+import { type TableHeaderCellProps } from "./table.js";
 import { DEFAULT_ROW_ACTIONS_LABELS } from "./row-actions-labels.js";
 /**
  * A row's actions — inline icons at Normal, one "⋯" menu at Large and above
@@ -183,6 +184,30 @@ export interface RowActionsProps {
  * dialog then returns it.
  */
 export declare function RowActions({ actions, name, collapse, size, menuWidth, className, glyphSize, tooltipSide, labels: labelsProp, }: RowActionsProps): import("react").JSX.Element | null;
+/** The actions cell's classes — `rowActionsColumn`'s `className`: the column hugs its
+ *  buttons, on one line, at the row's end. A hand-built table's `<TableCell>` takes them
+ *  around its {@link RowActions} (0.47, keksdose N17). */
+export declare const ROW_ACTIONS_CELL_CLASS = "w-px whitespace-nowrap text-end";
+/** The actions heading's classes — `rowActionsColumn`'s `headClassName`, which
+ *  {@link RowActionsHead} draws: hugging, end-aligned over the buttons (0.47, N17). */
+export declare const ROW_ACTIONS_HEAD_CLASS = "w-px text-end";
+export interface RowActionsHeadProps extends Omit<TableHeaderCellProps, "children"> {
+    /** The heading. Default: the provider's `rowActions.actions` ("Actions"). */
+    children?: ReactNode;
+    /** Named for a screen reader only — `rowActionsColumn`'s `header: false`. */
+    hideLabel?: boolean;
+    labels?: LabelOverride<RowActionsLabels>;
+}
+/**
+ * A hand-built table's actions heading (0.47, keksdose N17): the `<th>` `rowActionsColumn`
+ * gives a DataTable — "Actions" on screen in the provider's words, end-aligned over the
+ * buttons, hugging them. Pair it with `<TableCell className={ROW_ACTIONS_CELL_CLASS}>`
+ * around each row's {@link RowActions}. Every other `TableHeaderCell` prop passes on
+ * (`size`, the app's `className`, merged last).
+ *
+ *     <RowActionsHead size="sm" className={TH} />
+ */
+export declare function RowActionsHead({ children, hideLabel, labels, className, ...rest }: RowActionsHeadProps): import("react").JSX.Element;
 export interface RowActionsColumnOptions<T> {
     /** The column's key. Default `"actions"`. */
     key?: string;
@@ -201,10 +226,17 @@ export interface RowActionsColumnOptions<T> {
     /**
      * The column's name as plain text — the column-settings checklist and the phone
      * card's label read it (`DataTableColumn.headerText`). Pass the app's own word; left
-     * out, the header shows the provider's `rowActions.actions` to a screen reader and
-     * the plain-text places fall back to the column's `key`.
+     * out, the heading shows the provider's `rowActions.actions` and the plain-text
+     * places fall back to the column's `key`.
      */
     headerText?: string;
+    /**
+     * The heading (0.46.1, keksdose dev#598 rework — Marcel: a VISIBLE "Actions" heading on
+     * every table with an actions column). Default: `headerText`, else the provider's
+     * `rowActions.actions` ("Actions"), shown, end-aligned over the buttons. A node
+     * replaces it; `false` keeps the pre-0.46.1 heading, named for a screen reader only.
+     */
+    header?: ReactNode | false;
     labels?: LabelOverride<RowActionsLabels>;
     /** Anything else for the column (`mobileHidden`, `cellProps`…), merged last. */
     column?: Partial<DataTableColumn<T>>;
@@ -215,10 +247,10 @@ export interface RowActionsColumnOptions<T> {
  *
  *     columns={[...columns, rowActionsColumn({ actions: (r) => [...], name: (r) => r.name })]}
  *
- * The header is visually hidden (the icons say what the column is), the column hugs its
- * content at the row's end, and `noRowLink` keeps a `rowHref` anchor off it, so the
+ * The heading says "Actions" on screen (0.46.1; `header` changes or hides it), the
+ * column hugs its content at the row's end, and `noRowLink` keeps a `rowHref` anchor off it, so the
  * buttons keep their own clicks. On a phone it is a line of the card like any column;
  * set `column: { mobileHidden: true }` to drop it there (with `mobileDetailsInRow` it
  * then shows in the opened row instead).
  */
-export declare function rowActionsColumn<T>({ key, actions, name, collapse, size, glyphSize, tooltipSide, headerText, labels, column, }: RowActionsColumnOptions<T>): DataTableColumn<T>;
+export declare function rowActionsColumn<T>({ key, actions, name, collapse, size, glyphSize, tooltipSide, headerText, header, labels, column, }: RowActionsColumnOptions<T>): DataTableColumn<T>;

package/dist/components/row-actions.js

@@ -10,6 +10,7 @@ import { Button } from "./button.js";
 import { CompactControls } from "./field-parts.js";
 import { IconButton } from "./icon-button.js";
 import { useCommitReason } from "./write-lock.js";
+import { TableHeaderCell } from "./table.js";
 import { DEFAULT_ROW_ACTIONS_LABELS } from "./row-actions-labels.js";
 function visibleActions(actions) {
   return actions.filter((a) => Boolean(a) && !a.hidden);
@@ -276,9 +277,19 @@ function InlineAction({
     }
   );
 }
-function RowActionsHeader({ text, labels }) {
+function RowActionsHeader({
+  text,
+  labels,
+  hidden
+}) {
   const resolved = useKitLabels("rowActions", DEFAULT_ROW_ACTIONS_LABELS, labels);
-  return /* @__PURE__ */ jsx("span", { className: "sr-only", children: text ?? resolved.actions });
+  const word = text ?? resolved.actions;
+  return hidden ? /* @__PURE__ */ jsx("span", { className: "sr-only", children: word }) : /* @__PURE__ */ jsx(Fragment, { children: word });
+}
+const ROW_ACTIONS_CELL_CLASS = "w-px whitespace-nowrap text-end";
+const ROW_ACTIONS_HEAD_CLASS = "w-px text-end";
+function RowActionsHead({ children, hideLabel, labels, className, ...rest }) {
+  return /* @__PURE__ */ jsx(TableHeaderCell, { align: "end", ...rest, className: cn(ROW_ACTIONS_HEAD_CLASS, className), children: typeof children === "string" || children == null ? /* @__PURE__ */ jsx(RowActionsHeader, { text: children ?? void 0, labels, hidden: hideLabel }) : children });
 }
 function rowActionsColumn({
   key = "actions",
@@ -289,12 +300,13 @@ function rowActionsColumn({
   glyphSize,
   tooltipSide,
   headerText,
+  header,
   labels,
   column
 }) {
   return {
     key,
-    header: /* @__PURE__ */ jsx(RowActionsHeader, { text: headerText, labels }),
+    header: header === false || header == null ? /* @__PURE__ */ jsx(RowActionsHeader, { text: headerText, labels, hidden: header === false }) : header,
     headerText,
     cell: (row) => /* @__PURE__ */ jsx(
       RowActions,
@@ -308,15 +320,20 @@ function rowActionsColumn({
         labels
       }
     ),
-    className: "w-px whitespace-nowrap text-end",
-    headClassName: "w-px",
+    className: ROW_ACTIONS_CELL_CLASS,
+    // The heading over the buttons, at the row's end (0.46.1); a hand-built table's
+    // `RowActionsHead` (0.47).
+    headClassName: ROW_ACTIONS_HEAD_CLASS,
     noRowLink: true,
     ...column
   };
 }
 export {
   DEFAULT_ROW_ACTIONS_LABELS,
+  ROW_ACTIONS_CELL_CLASS,
+  ROW_ACTIONS_HEAD_CLASS,
   RowActions,
+  RowActionsHead,
   rowActionsColumn
 };
 //# sourceMappingURL=row-actions.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/row-actions.tsx"],"sourcesContent":["import { isValidElement } 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 { DEFAULT_ROW_ACTIONS_LABELS } from \"./row-actions-labels\";\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 * 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 — the app opens its confirmation or calls its API.\n   * Optional only beside `href`; an action has one or the other (or both: `onSelect`\n   * then runs as the link is followed).\n   */\n  onSelect?: () => void;\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/** 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}\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  /** 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`, 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({\n  actions,\n  name,\n  collapse = \"auto\",\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 entries = visibleActions(actions);\n  if (entries.length === 0) return null;\n  const asMenu = collapse === \"menu\" || (collapse === \"auto\" && large && entries.length > 1);\n  if (!asMenu) {\n    const strip = (\n      <div data-slot=\"row-actions\" className={cn(\"inline-flex items-center gap-0.5\", className)}>\n        {entries.map((action) => (\n          <InlineAction\n            key={action.key ?? action.label}\n            action={action}\n            size={size}\n            glyphSize={glyphSize}\n            tooltipSide={tooltipSide}\n          />\n        ))}\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  const title = name ? labels.actionsFor(name) : labels.actions;\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} />\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({ action, close }: { action: RowAction; close: () => void }) {\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    action.onSelect?.();\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}: {\n  action: RowAction;\n  size: RowActionsSize;\n  glyphSize?: IconButtonGlyphSize;\n  tooltipSide?: TooltipSide;\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={() => action.onSelect?.()}\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      action.onSelect?.();\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 hidden header, in the provider's words. */\nfunction RowActionsHeader({ text, labels }: { text?: string; labels?: LabelOverride<RowActionsLabels> }) {\n  const resolved = useKitLabels(\"rowActions\", DEFAULT_ROW_ACTIONS_LABELS, labels);\n  return <span className=\"sr-only\">{text ?? resolved.actions}</span>;\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 header shows the provider's `rowActions.actions` to a screen reader and\n   * the plain-text places fall back to the column's `key`.\n   */\n  headerText?: string;\n  labels?: LabelOverride<RowActionsLabels>;\n  /** Anything else for the column (`mobileHidden`, `cellProps`…), 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 header is visually hidden (the icons say what the column is), the column hugs its\n * content at the row's end, and `noRowLink` keeps a `rowHref` anchor off it, so the\n * buttons keep their own clicks. On a phone it is a line of the card like any column;\n * set `column: { mobileHidden: true }` to drop it there (with `mobileDetailsInRow` it\n * 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  labels,\n  column,\n}: RowActionsColumnOptions<T>): DataTableColumn<T> {\n  return {\n    key,\n    header: <RowActionsHeader text={headerText} labels={labels} />,\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: \"w-px whitespace-nowrap text-end\",\n    headClassName: \"w-px\",\n    noRowLink: true,\n    ...column,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/components/row-actions.tsx"],"sourcesContent":["import { isValidElement } 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\";\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 * 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 — the app opens its confirmation or calls its API.\n   * Optional only beside `href`; an action has one or the other (or both: `onSelect`\n   * then runs as the link is followed).\n   */\n  onSelect?: () => void;\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/** 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}\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  /** 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`, 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({\n  actions,\n  name,\n  collapse = \"auto\",\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 entries = visibleActions(actions);\n  if (entries.length === 0) return null;\n  const asMenu = collapse === \"menu\" || (collapse === \"auto\" && large && entries.length > 1);\n  if (!asMenu) {\n    const strip = (\n      <div data-slot=\"row-actions\" className={cn(\"inline-flex items-center gap-0.5\", className)}>\n        {entries.map((action) => (\n          <InlineAction\n            key={action.key ?? action.label}\n            action={action}\n            size={size}\n            glyphSize={glyphSize}\n            tooltipSide={tooltipSide}\n          />\n        ))}\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  const title = name ? labels.actionsFor(name) : labels.actions;\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} />\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({ action, close }: { action: RowAction; close: () => void }) {\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    action.onSelect?.();\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}: {\n  action: RowAction;\n  size: RowActionsSize;\n  glyphSize?: IconButtonGlyphSize;\n  tooltipSide?: TooltipSide;\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={() => action.onSelect?.()}\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      action.onSelect?.();\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`…), 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. On a phone it is a line of the card like any column;\n * set `column: { mobileHidden: true }` to drop it there (with `mobileDetailsInRow` it\n * 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    ...column,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/components/tabs.d.ts

@@ -36,10 +36,16 @@ export interface TabsLabels {
     add: string;
     /** Accessible name of a tab's × — "Remove <tab>". */
     remove: (tab: string) => string;
-    /** The `overflowCue` caret while tabs lie past the strip's end: "More tabs". */
+    /** The `overflowCue` › over the strip's end, while tabs lie past it: "More tabs". */
     more: string;
-    /** The `overflowCue` caret at the strip's end, which goes back to the first tab. */
-    backToFirst: string;
+    /** The `overflowCue` ‹ over the strip's start, while tabs lie before it: "Previous tabs". */
+    previous: string;
+    /**
+     * @deprecated 0.47: not drawn any more — the caret that turned into "back to the
+     * first tab" at the strip's end is now a ‹ of its own (`previous`). Accepted and
+     * ignored; removed in 0.48.
+     */
+    backToFirst?: string;
 }
 export { DEFAULT_TABS_LABELS };
 /**
@@ -62,20 +68,22 @@ export interface TabsProps<T extends string> extends Omit<ComponentPropsWithoutR
     onChange: (id: T) => void;
     className?: string;
     /**
-     * The caret beside a SCROLLING strip (0.40, kk run 79 gap 1): a › while
-     * tabs lie past the strip's end — a tap scrolls it on by three quarters of its width —
-     * turning into a ‹ at the end, which goes back to the first. Shown only while the strip
-     * actually overflows.
+     * Carets over the ends of a SCROLLING strip (0.40, kk run 79 gap 1; 0.47, keksdose
+     * live #410 round 4): a › over the strip's end while tabs lie past it, and a ‹ over
+     * its start while tabs lie before it — each there only while something is hidden
+     * past ITS edge (1 px slack, so a few cut-off pixels count), each a step of three
+     * quarters of the strip's width toward its own side. Neither ever changes direction:
+     * until 0.46 one caret turned round into "back to the first" at the end, and read as
+     * an arrow pointing the wrong way. Start and end follow the reading direction.
      *
-     * The edge fade alone could read as the end of the row: at the default scroll position
-     * the last visible tab can finish exactly where the fade begins, so nothing looks cut
-     * off (keksdose live #410, whose `tab-strip-more.tsx` this replaces). One button that
-     * turns round rather than two that come and go, so the strip's width never changes
-     * under the thumb. Out of the tab order — the keyboard walks the strip with the arrow
-     * keys, which bring the focused tab into view. At every width since 0.46 (keksdose live
-     * #410 round 3: eleven report tabs overflow a laptop too); before, `md:hidden`. Ignored on
-     * a vertical strip (a side nav is a column, not a row). Names:
-     * `tabs.more` / `tabs.backToFirst`.
+     * The edge fade alone could read as the end of the row: the last visible tab can
+     * finish exactly where the fade begins, so nothing looks cut off (keksdose live #410).
+     * The carets sit OVER the strip's ends (positioned, on the page's surface), not beside
+     * it, so the strip's width never changes as they come and go. Out of the tab order —
+     * the keyboard walks the strip with the arrow keys, which bring the focused tab into
+     * view. At every width. Ignored on a vertical strip (a side nav is a column, not a
+     * row). Names: `tabs.more` / `tabs.previous`. keksdose's `scroll-edge-cues.tsx` is
+     * the reference this replaces.
      */
     overflowCue?: boolean;
     /**

package/dist/components/tabs.js

@@ -48,35 +48,38 @@ function Tabs({
   const stripRef = useRef(null);
   const setStrip = useMemo(() => mergeRefs(stripRef, ref), [ref]);
   const fade = useStripFade(stripRef);
-  const cue = overflowCue && !vertical && fade.overflow !== void 0;
-  const cueAtEnd = fade.overflow === "start";
-  const onCue = () => {
+  const cue = overflowCue && !vertical;
+  const cueStart = cue && (fade.overflow === "start" || fade.overflow === "both");
+  const cueEnd = cue && (fade.overflow === "end" || fade.overflow === "both");
+  const onCue = (side) => {
     const strip = stripRef.current;
     if (!strip) return;
     const behavior = prefersReducedMotion() ? "auto" : "smooth";
-    if (cueAtEnd) {
-      strip.scrollTo({ left: 0, behavior });
-      return;
-    }
     const rtl = getComputedStyle(strip).direction === "rtl";
-    strip.scrollBy({ left: (rtl ? -1 : 1) * Math.round(strip.clientWidth * 0.75), behavior });
+    const toward = (side === "end" ? 1 : -1) * (rtl ? -1 : 1);
+    strip.scrollBy({ left: toward * Math.round(strip.clientWidth * 0.75), behavior });
   };
-  const cueButton = cue ? (
-    // The strip's bottom rule continues under the caret, so the row reads as one.
-    /* @__PURE__ */ jsx("div", { "data-tabs-overflow-cue": "", className: "flex shrink-0 items-center self-stretch border-b border-subtle", children: /* @__PURE__ */ jsx(
-      IconButton,
-      {
-        size: "sm",
-        variant: "ghost",
-        tone: "muted",
-        tabIndex: -1,
-        type: "button",
-        "aria-label": cueAtEnd ? text.backToFirst : text.more,
-        onClick: onCue,
-        children: cueAtEnd ? /* @__PURE__ */ jsx(ChevronLeft, { className: "rtl:-scale-x-100" }) : /* @__PURE__ */ jsx(ChevronRight, { className: "rtl:-scale-x-100" })
-      }
-    ) })
-  ) : null;
+  const cueAt = (side) => /* @__PURE__ */ jsx(
+    "div",
+    {
+      "data-tabs-overflow-cue": side,
+      className: cn("absolute top-1/2 z-10 flex -translate-y-1/2", side === "start" ? "start-0" : "end-0"),
+      children: /* @__PURE__ */ jsx(
+        IconButton,
+        {
+          size: "sm",
+          variant: "secondary",
+          className: "bg-surface shadow-sm",
+          tabIndex: -1,
+          type: "button",
+          label: side === "start" ? text.previous : text.more,
+          labelVisible: false,
+          onClick: () => onCue(side),
+          children: side === "start" ? /* @__PURE__ */ jsx(ChevronLeft, { className: "rtl:-scale-x-100" }) : /* @__PURE__ */ jsx(ChevronRight, { className: "rtl:-scale-x-100" })
+        }
+      )
+    }
+  );
   useLayoutEffect(() => {
     const strip = stripRef.current;
     const tab = strip?.querySelector('[role="tab"][aria-selected="true"]');
@@ -137,7 +140,7 @@ function Tabs({
       "data-overflow": fade.overflow,
       className: cn(
         vertical ? TABLIST_VERTICAL_CLASSES : TABLIST_CLASSES,
-        onAdd ? "min-w-0" : overflowCue && !vertical ? "min-w-0 flex-1" : className
+        cue ? "min-w-0 flex-1" : onAdd ? "min-w-0" : className
       ),
       children: tabs.map((tab) => {
         const isActive = tab.id === active;
@@ -260,11 +263,15 @@ function Tabs({
       children: text.remove(nameOf(activeTab))
     }
   ) : null;
-  if (!onAdd && overflowCue && !vertical) {
+  const stripBox = cue ? /* @__PURE__ */ jsxs("div", { className: cn("relative flex min-w-0", !onAdd && "flex-1"), children: [
+    tablist,
+    cueStart && cueAt("start"),
+    cueEnd && cueAt("end")
+  ] }) : tablist;
+  if (!onAdd && cue) {
     return /* @__PURE__ */ jsxs("div", { className: cn("flex items-end", className), children: [
-      tablist,
-      removeButton,
-      cueButton
+      stripBox,
+      removeButton
     ] });
   }
   if (!onAdd) {
@@ -284,9 +291,8 @@ function Tabs({
     ] });
   }
   return /* @__PURE__ */ jsxs("div", { className: cn("flex items-end", className), children: [
-    tablist,
+    stripBox,
     removeButton,
-    cueButton,
     /* @__PURE__ */ jsx(
       "div",
       {