@eifi1/ui-kit 0.39.1 → 0.40.1

package/dist/components/inline-entity-combobox.js

@@ -13,6 +13,7 @@ import {
   ComboboxFieldLabel,
   DISABLED_ROW_CLASS,
   endHintRowProps,
+  GROUP_HEADING_STICKY,
   isOptionEnabled,
   offersCreate,
   stepEnabled,
@@ -123,7 +124,7 @@ function InlineEntityCombobox(props) {
         return rank === 0 || rank === 1;
       };
       const starts = options.filter(leads);
-      const rest2 = options.filter((o) => !leads(o) && (hit(o.label) || hit(o.sublabel) || hit(o.group)));
+      const rest2 = options.filter((o) => !leads(o) && (hit(o.label) || hit(o.sublabel)));
       ranked = [...starts, ...rest2];
     }
     if (!ranked.some((o) => o.group)) return ranked;
@@ -343,7 +344,10 @@ function InlineEntityCombobox(props) {
                   "li",
                   {
                     role: "presentation",
-                    className: "px-4 pb-0.5 pt-3 text-caption font-semibold uppercase tracking-wide text-muted",
+                    className: cn(
+                      GROUP_HEADING_STICKY,
+                      "px-4 pb-0.5 pt-3 text-caption font-semibold uppercase tracking-wide text-muted"
+                    ),
                     children: o.group
                   }
                 ),
@@ -398,7 +402,10 @@ function InlineEntityCombobox(props) {
               "li",
               {
                 role: "presentation",
-                className: "px-3 pb-0.5 pt-2 text-caption font-semibold uppercase tracking-wide text-muted first:pt-1",
+                className: cn(
+                  GROUP_HEADING_STICKY,
+                  "px-3 pb-0.5 pt-2 text-caption font-semibold uppercase tracking-wide text-muted first:pt-1"
+                ),
                 children: o.group
               }
             ),

package/dist/components/inline-entity-combobox.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/inline-entity-combobox.tsx"],"sourcesContent":["// The id-keyed sibling of Combobox. Moved out of combobox.tsx as it was (MOD-9,\n// refactor audit 2026-10); combobox still exports `InlineEntityCombobox` and its props.\nimport { Fragment, useId, useMemo, useRef, useState } from \"react\";\nimport type { ComponentPropsWithoutRef, ReactNode, Ref } from \"react\";\nimport { ChevronDown, Plus, X } from \"lucide-react\";\nimport { FIELD_BASE, FIELD_FLOATING_PAD, FIELD_INVALID } from \"./field-base\";\nimport { cn } from \"../lib/cn\";\nimport { useDropdown } from \"./dropdown\";\nimport { takeEscape, useDismissLayer } from \"../hooks/use-dismiss\";\nimport { isImeEnter } from \"../lib/ime\";\nimport { usePhoneLayout } from \"../hooks/use-breakpoint\";\nimport { PickerSheet, SHEET_ROW_CLASS } from \"./picker-sheet\";\nimport {\n  ComboboxFieldLabel,\n  DISABLED_ROW_CLASS,\n  endHintRowProps,\n  isOptionEnabled,\n  offersCreate,\n  stepEnabled,\n  useActiveOptionScroll,\n  type ComboClearValue,\n  type ComboOption,\n} from \"./combobox-core\";\nimport { DEFAULT_COMBOBOX_LABELS, useKitLabels, useKitLocale } from \"../i18n/kit-labels\";\nimport { foldForSearch, rankMatch } from \"../lib/text-match\";\nimport {\n  EndHintRow,\n  FieldCaption,\n  LABEL_IN_ROW,\n  LockedReason,\n  mergeDescribedBy,\n  StaticLabelRow,\n  useFieldError,\n  useFieldHint,\n  useLockReason,\n  type DisabledReasonDisplay,\n  type FieldHelpProps,\n} from \"./field-parts\";\nimport { hasContent } from \"../lib/presence\";\nimport { useCommitReason, type CommitScope } from \"./write-lock\";\nimport { lockedKeyDown, rowClass, SuggestionList, usePrimaryPressOnly } from \"./combobox-suggestions\";\n\n/** {@link InlineEntityCombobox}'s create row over the shared row look: in the brand\n *  colour {@link Combobox}'s own create row wears, with a leading \"+\" as the panel\n *  pickers' has — an action at the foot of the list, not one more record. */\nconst CREATE_ROW_CLASS = \"flex items-center gap-2 font-medium text-brand\";\n\n/** `id` is the INPUT's and `onChange` is the field's — see {@link ComboboxProps}\n *  for why the div's spellings of them are omitted. */\nexport interface InlineEntityComboboxProps<V extends string | number, C extends ComboClearValue = null>\n  extends Omit<ComponentPropsWithoutRef<\"div\">, \"id\" | \"onChange\">,\n    FieldHelpProps {\n  /** Selected option id; `null` or `clearValue` when nothing is selected. */\n  value: V | C | null;\n  /** Required and unanswered — see {@link Combobox}'s `invalid`. */\n  invalid?: boolean;\n  /** What is wrong with the value — see {@link Combobox}'s `error`. */\n  error?: ReactNode;\n  /** Standing advice — see {@link Combobox}'s `hint` (keksdose K4). */\n  hint?: ReactNode;\n  /** A picked/typed option emits its id; emptying the field, or the \"×\", emits\n   *  `clearValue`. */\n  onChange: (v: V | C) => void;\n  /** What a clear emits — `null` by default, `\"\"` for a schema that wants an empty\n   *  string. See {@link EntityCombobox}'s `clearValue`. */\n  clearValue?: C;\n  options: ComboOption<V>[];\n  /** The visible label — see {@link Combobox}'s `label` (a ReactNode since 0.34, API-9). */\n  label?: ReactNode;\n  id?: string;\n  placeholder?: string;\n  className?: string;\n  disabled?: boolean;\n  /** Focus on mount, the way `<input autoFocus>` does — and, through `onFocus`\n   *  below, open the list with it. A click-the-value editor needs it: the cell\n   *  the user clicked names the field the editor should land the caret in, and\n   *  without a passthrough this component's fixed prop list puts the `<input>`\n   *  out of a caller's reach entirely (Keksdose feedback live #218). */\n  autoFocus?: boolean;\n  /** Phone sheet only — the anchored list has the field itself to type in. Falls\n   *  back to `placeholder`, then to `combobox.search` from the {@link UiKitProvider}. */\n  searchPlaceholder?: string;\n  /** Phone sheet only: a full screen showing nothing has to say why. The anchored\n   *  list simply does not open. Default: `combobox.noResults` from the provider. */\n  emptyLabel?: string;\n  closeLabel?: string;\n  /** The phone sheet's heading (and, as a string, its accessible name) for a field\n   *  whose label is drawn by someone else — a bound field's label;\n   *  `RhfInlineEntityCombobox` hands its label over here (0.24). Default: `label`.\n   *  See {@link Combobox}'s `sheetTitle`. */\n  sheetTitle?: ReactNode;\n  /** Offer a clear \"×\" in place of the chevron whenever something is selected.\n   *\n   *  Emptying the text already clears (see {@link reconcile}), and on a desktop that\n   *  is the fast way. It is not a way at all on a PHONE: touching the field opens the\n   *  full-screen sheet, which covers the very input the text would have been deleted\n   *  from — so a field that had been answered could not be UNanswered by any gesture\n   *  the screen offered (Keksdose live #236, filed from a phone). The \"×\" is the one\n   *  affordance both shells share, and it clears without opening anything. */\n  clearable?: boolean;\n  clearLabel?: string;\n  /**\n   * Why the choice cannot be changed — {@link Button}'s `disabledReason`, for a picker\n   * that SAVES on change. keksdose G2: the statement review's account picker IS the\n   * write (picking re-runs the duplicate check on the server), and on the read-only demo\n   * the app wrapped it in a hand-made Tooltip over a native `disabled` — out of the tab\n   * order, so the reason never reached a keyboard.\n   *\n   * With a reason the input stays focusable and `aria-disabled`, is `readOnly` (the\n   * settled grey), opens no list or sheet, offers no clear \"×\", and no pick, typed\n   * label or clear reaches `onChange`; the reason is in the kit {@link Tooltip} and on\n   * the input's `aria-describedby`. Wins over `disabled`. Use it CONTROLLED, as the\n   * component always is: the shown label is `value`'s.\n   */\n  disabledReason?: ReactNode;\n  /**\n   * This picker COMMITS — choosing saves. Under a locked {@link WriteLockProvider} it is\n   * locked the `disabledReason` way with the lock's reason (which wins over its own).\n   * A picker inside a form with its own Save stays editable under the lock — leave this\n   * off there and put `commit` on the Save. No provider, or an unlocked one: no effect.\n   */\n  commit?: CommitScope;\n  /** Where the reason shows — {@link Button}'s `disabledReasonDisplay`: a line under the\n   *  field at Large and on a touch screen by default, the tooltip otherwise (DUP-3). */\n  disabledReasonDisplay?: DisabledReasonDisplay;\n  /**\n   * A last row that makes a new record from what was typed — keksdose G9, whose \"Create\n   * cash account\" had to become a separate button because this picker had no such row.\n   *\n   * Shown while the typed query is non-empty and names no option exactly\n   * (case-insensitive — an exact hit is a record the list already shows), worded\n   * `createLabel(query)`, default `combobox.create`: \"Create “{query}”\". The arrow keys\n   * reach it like an option; Enter or a click calls `onCreate(query)` and closes the\n   * list. Making the record, and then passing its id as `value`, is the caller's: the\n   * field shows the old selection until it does.\n   *\n   * The same rule as {@link EntityCombobox}'s `onCreate`, so the family agrees. It is a\n   * row of the LIST, not an option: it is never `aria-selected`, never matched by a\n   * typed label on blur, and never sorted among the records the way a sentinel option\n   * would be (the reason keksdose gave for the separate button).\n   */\n  onCreate?: (query: string) => void;\n  /** The create row's words for a query. Default: `combobox.create` from the\n   *  {@link UiKitProvider}, else English `Create “{query}”`. */\n  createLabel?: (query: string) => string;\n  /**\n   * Offer the create row with NOTHING typed too, worded as this — keksdose's \"Create cash\n   * account\", which mints an account under a default name and so needs no query.\n   * `onCreate` then receives `\"\"`, and the caller supplies the name. Left out, the row\n   * needs a query.\n   *\n   * One string rather than a switch: a row with no query has nothing to quote, so the\n   * kit cannot word it — \"Create “”\" says nothing — and naming it is what turns it on.\n   * With both, one handler serves both rows:\n   *\n   * ```tsx\n   * onCreate={(name) => createCash(name || t(\"cash_account_default_name\"))}\n   * createEmptyLabel={t(\"create_cash_account\")}\n   * ```\n   */\n  createEmptyLabel?: string;\n  /**\n   * The create row WRITES while picking does not — keksdose dev#496: on the read-only\n   * demo choosing the cash account is draft state and stays live, minting one is a\n   * write. Under a locked {@link WriteLockProvider} the row stays in the list, dimmed and\n   * passed over by the arrows, with the lock's reason as its second line (a hover is the\n   * one explanation a phone cannot show), and `onCreate` is not called. Not needed with\n   * `commit`: a locked field opens no list at all.\n   */\n  createCommit?: CommitScope;\n  /**\n   * The `<input>` — the focusable control, the one a reader types in — as a React 19\n   * ref prop (0.24, kastlan). Its account picker is this component inside an\n   * `RhfField` render, and react-hook-form's focus-on-error calls `focus()` on whatever\n   * `field.ref` is handed: with no ref there was nothing to hand it, so a line-item form\n   * whose account was missing failed its submit and left the caret where it was. Pass\n   * `field.ref` here, or use `RhfInlineEntityCombobox`, which does. The wrapper is not\n   * reachable this way — focus and selection are the input's. See {@link Combobox}'s `ref`.\n   */\n  ref?: Ref<HTMLInputElement>;\n}\n\n/**\n * The id-keyed sibling of {@link Combobox}: identical anatomy (a real text input\n * with the shared field styling, chevron and inline as-you-type filtering) but\n * the value is an option id, not free text. Built so an entity picker can sit\n * next to a free-text combobox without any visible difference — a button-trigger\n * panel picker ({@link EntityCombobox}) never matches an input field exactly.\n *\n * Text-vs-value reconciliation: the input's text is transient. Picking a row or\n * typing an exact (unique) label commits that option; emptying the text commits\n * a clear; anything else reverts to the selected option's label on blur/Escape.\n *\n * **On a phone the list opens as a full-screen sheet**, exactly like {@link Combobox}\n * beside it (Keksdose live #200, extended by dev#477 — the account picker moved onto\n * this component and must not lose its sheet). The sheet carries its OWN query state\n * rather than reusing `text`: `text` is what {@link reconcile} judges on blur, so a\n * sheet that emptied it to show the full list would read as \"the user cleared the\n * field\" the moment it closed.\n */\nexport function InlineEntityCombobox<V extends string | number, C extends ComboClearValue = null>(\n  props: InlineEntityComboboxProps<V, C>,\n) {\n  const {\n    value: rawValue,\n    onChange,\n    clearValue = null as C,\n    options,\n    label,\n    id,\n    placeholder,\n    className,\n    disabled,\n    autoFocus,\n    searchPlaceholder,\n    emptyLabel,\n    closeLabel,\n    sheetTitle,\n    clearable,\n    clearLabel,\n    disabledReason,\n    disabledReasonDisplay,\n    commit,\n    onCreate,\n    createLabel,\n    createEmptyLabel,\n    createCommit,\n    invalid,\n    error,\n    hint,\n    help,\n    ref,\n    \"aria-label\": ariaLabel,\n    // Off `rest` and onto the <input>, which is the combobox a reader meets: `Field`'s\n    // render-prop spreads `{ id, aria-describedby, aria-invalid, aria-required }`, and\n    // on the wrapper div the hint and required state described nothing.\n    \"aria-describedby\": ariaDescribedBy,\n    \"aria-invalid\": ariaInvalid,\n    \"aria-required\": ariaRequired,\n    ...rest\n  } = props;\n  // The clear value reads as \"nothing selected\", whichever one the caller picked —\n  // so from here down `value` is the id or `null`, as it always was.\n  const value: V | null = rawValue == null || rawValue === clearValue ? null : (rawValue as V);\n  const hintParts = useFieldHint(hint, ariaDescribedBy, { help, name: label ?? ariaLabel });\n  const field = useFieldError(error, invalid, hintParts.describedBy, ariaInvalid);\n  const generated = useId();\n  const fieldId = id ?? generated;\n  // See the twin above on why these hang off the generated id.\n  const listboxId = `${generated}-listbox`;\n  const optionId = (index: number) => `${generated}-option-${index}`;\n  const isPhone = usePhoneLayout();\n  // See the twin above: the phone sheet owns its own Back entry (live #309), and the\n  // Escape layer is this field's own.\n  const { open, setOpen, wrapperRef, panelRef } = useDropdown({ backCloses: !isPhone, escapeLayer: false });\n  const primaryOnly = usePrimaryPressOnly();\n  const [active, setActive] = useState(-1);\n  // null = not editing → the input shows the selected option's label.\n  const [text, setText] = useState<string | null>(null);\n  const sheetInputRef = useRef<HTMLInputElement | null>(null);\n  // The box the portalled list hangs off — see {@link SuggestionList}.\n  const fieldRef = useRef<HTMLDivElement>(null);\n  // The sheet's search box. Starts empty on every open, so a field that already\n  // holds a value still offers the whole list — the shape a native <select> has\n  // on a phone, and what the anchored panel gets from `query` below.\n  const [sheetQuery, setSheetQuery] = useState(\"\");\n  // Props first, provider second — see `EntityCombobox`. `emptyLabel` used to render\n  // nothing when omitted, which left a phone user staring at a blank full-screen\n  // sheet; now an omitted one says \"No results\" in the provider's language.\n  const labels = useKitLabels(\"combobox\", DEFAULT_COMBOBOX_LABELS, {\n    search: searchPlaceholder,\n    noResults: emptyLabel,\n    clear: clearLabel,\n    create: createLabel,\n  });\n  // The lock (see `lockedKeyDown` above). A lock arriving mid-edit closes the list and\n  // drops the loose text, adjusted while rendering: nothing typed before it may be\n  // judged by `reconcile` after it.\n  const lock = useLockReason(commit, disabledReason);\n  const locked = lock.locked;\n  const inert = locked || Boolean(disabled);\n  if (locked && (open || text !== null)) {\n    setOpen(false);\n    setText(null);\n  }\n  // The create row's own lock (`createCommit`): the list stays live, the row does not.\n  const createReason = useCommitReason(createCommit, undefined);\n  const createLocked = hasContent(createReason);\n\n  const selected = useMemo(\n    () => (value == null ? null : (options.find((o) => o.value === value) ?? null)),\n    [options, value],\n  );\n  const shown = text ?? selected?.label ?? \"\";\n  // Nothing selected has nothing to clear, and the chevron comes back — the field\n  // keeps exactly one trailing control, so the \"×\" never crowds the value it sits on.\n  const showClear = Boolean(clearable && value != null && !inert);\n\n  // Focusing select-alls the current label; filtering only kicks in once the\n  // text actually differs from it, so an already-filled field still opens on\n  // the FULL list instead of a single-row \"filter\" of its own value.\n  const typedQuery = text !== null && text !== (selected?.label ?? \"\") ? text.trim() : \"\";\n  const query = isPhone ? sheetQuery.trim() : typedQuery;\n  // Folded as every kit list folds (DUP-5): accents off and the locale's case, so\n  // \"zurich\" finds Zürich and, in Turkish, \"ı\" finds \"IRMAK\".\n  const locale = useKitLocale();\n  const matches = useMemo(() => {\n    let ranked = options;\n    if (query) {\n      const q = foldForSearch(query, locale);\n      const hit = (s: string | undefined) => s !== undefined && foldForSearch(s, locale).includes(q);\n      // The label's whole name or its start first (`rankMatch` 0 and 1), then a match\n      // anywhere in the label, the sublabel or the group.\n      const leads = (o: ComboOption<V>) => {\n        const rank = rankMatch(o.label, query, { locale });\n        return rank === 0 || rank === 1;\n      };\n      const starts = options.filter(leads);\n      const rest = options.filter((o) => !leads(o) && (hit(o.label) || hit(o.sublabel) || hit(o.group)));\n      ranked = [...starts, ...rest];\n    }\n    if (!ranked.some((o) => o.group)) return ranked;\n    // Keep each group contiguous so the headings below appear once instead of\n    // re-appearing every time the ranking interleaves two groups — while preserving\n    // \"best match first\": a Map keeps insertion order, so groups come out ordered by\n    // their best-ranked member and members keep their rank order inside the group.\n    const blocks = new Map<string, ComboOption<V>[]>();\n    for (const o of ranked) {\n      const key = o.group ?? \"\";\n      if (!blocks.has(key)) blocks.set(key, []);\n      blocks.get(key)!.push(o);\n    }\n    return [...blocks.values()].flat();\n  }, [options, query, locale]);\n\n  // The create row (`onCreate`), on the query as typed — not lowercased: it becomes a\n  // name. Compared against EVERY option, not `matches`: an exact hit anywhere is a\n  // record that exists, disabled or not. Restated from `text` rather than derived from\n  // `typedQuery`: this value is handed to the caller's `onCreate`, and the React\n  // Compiler cannot then keep `matches` memoised on anything it was derived from.\n  const createQuery = isPhone\n    ? sheetQuery.trim()\n    : text !== null && text !== (selected?.label ?? \"\")\n      ? text.trim()\n      : \"\";\n  const showCreate = offersCreate(\n    onCreate,\n    createQuery,\n    options.map((o) => o.label),\n    createEmptyLabel,\n  );\n  const createText = createQuery ? labels.create(createQuery) : createEmptyLabel;\n  // Every row the keyboard can land on: the options, then the create row — passed over\n  // like a disabled option while a write lock holds it.\n  const rows: readonly { disabled?: boolean }[] = showCreate\n    ? [...matches, { disabled: createLocked }]\n    : matches;\n  const createIndex = matches.length;\n\n  // Pointer-device only: the phone's rows live in a {@link PickerSheet} whose own\n  // search box holds focus, so the field behind it must not claim to be pointing at\n  // one of them.\n  // A disabled row is never the keyboard's, even if the list changed under it.\n  const activeId = !isPhone && isOptionEnabled(rows[active]) ? optionId(active) : undefined;\n  useActiveOptionScroll(activeId);\n\n  const close = () => {\n    setOpen(false);\n    setActive(-1);\n    setSheetQuery(\"\");\n  };\n  // See the twin above: a layer while the list SHOWS, and Escape puts the label back.\n  const showing = !isPhone && open && !inert && (matches.length > 0 || showCreate);\n  useDismissLayer(showing, () => {\n    setText(null);\n    close();\n  });\n  const take = (o: ComboOption<V>) => {\n    // A `disabled` option is listed, never taken — by any path; nor is anything while\n    // the field is locked.\n    if (o.disabled || locked) return;\n    if (o.value !== value) onChange(o.value);\n    setText(null);\n    close();\n  };\n  /** Turn loose text into a decision: empty clears, an exact label match that names\n   *  ONE entity commits, anything else reverts to the selected label.\n   *\n   *  Unique by VALUE, not by row. An option may deliberately appear twice — Keksdose\n   *  repeats recently-used categories in a \"Recent\" group at the top (live #203) — and\n   *  counting rows made every such option uncommittable: two hits, so nothing fired and\n   *  the field reverted to whatever was selected before. Typing a category you had just\n   *  used, then tabbing away, silently discarded it, and the more categories you used\n   *  the more of them stopped working. Two rows naming the same id are not an ambiguity;\n   *  two ids sharing a label are. */\n  const create = () => {\n    if (!onCreate || locked || createLocked) return;\n    onCreate(createQuery);\n    setText(null);\n    close();\n  };\n  const reconcile = () => {\n    // Locked, loose text is dropped rather than judged: nothing reaches `onChange`.\n    if (text !== null && !locked) {\n      const q = text.trim();\n      if (!q) {\n        if (value != null) onChange(clearValue);\n      } else {\n        // A disabled option's label typed out in full is not a way round `disabled`:\n        // it is not a hit, so the text reverts like any other non-answer.\n        const hits = options.filter(\n          (o) => !o.disabled && o.label.toLowerCase() === q.toLowerCase(),\n        );\n        const ids = new Set(hits.map((h) => h.value));\n        if (ids.size === 1 && hits[0].value !== value) onChange(hits[0].value);\n      }\n    }\n    setText(null);\n    close();\n  };\n\n  // The create row's inside, one for both shells: a \"+\" (it is an action, not a record),\n  // the words, and — while a write lock holds it — the lock's reason as a second line.\n  // Both lines wrap from Large up (text size §10.17, round 0.34 T1): the words hold what\n  // the reader typed, which an ellipsis would cut.\n  const createRowContent = (\n    <>\n      <Plus aria-hidden className=\"size-4 shrink-0\" />\n      <span className=\"min-w-0 flex-1\">\n        <span className=\"block truncate-until-large\">{createText}</span>\n        {createLocked && (\n          <span className=\"block truncate-until-large text-xs font-normal text-placeholder\">\n            {createReason}\n          </span>\n        )}\n      </span>\n    </>\n  );\n  // While locked the field sits in the reason's Tooltip — see Combobox.\n  const withLock = (box: ReactNode) =>\n    locked ? (\n      <LockedReason lock={lock} display={disabledReasonDisplay} className=\"block\">\n        {box}\n      </LockedReason>\n    ) : (\n      box\n    );\n\n  return (\n    // `rest` dresses the outer box — a `data-tour` anchor, a test id. Not the NAME,\n    // description, invalid or required state: those belong on the <input> below,\n    // which is the combobox a reader meets. Spread FIRST, so the field's ARIA and the\n    // handlers carrying live #309 and dev#549 cannot be replaced from outside.\n    <div {...rest} ref={wrapperRef} className={cn(\"relative\", className)}>\n      {/* A real <label for> — see {@link Combobox}; with a \"?\", in a row after the field. */}\n      {label !== undefined && hintParts.labelHint === undefined && (\n        <ComboboxFieldLabel htmlFor={fieldId} className={inert ? \"opacity-50\" : undefined}>\n          {label}\n        </ComboboxFieldLabel>\n      )}\n      <EndHintRow {...endHintRowProps(\"hint\" in props, label !== undefined, hintParts.labelHint)}>\n        {withLock(\n          /* Inner wrapper for chevron centering — same reasoning as Combobox above.\n              It is also what the portalled list anchors to.\n              Dimmed as a whole when disabled (or locked), the way EntityCombobox dims its\n              trigger. FIELD_BASE's grey alone left a disabled picker looking like a\n              filled-in one beside the pickers that do dim (the label is not the input's\n              `peer`, so it is dimmed by hand above). */\n          <div ref={fieldRef} className={cn(\"relative\", inert && \"cursor-not-allowed opacity-50\")}>\n            <input\n              ref={ref}\n              id={fieldId}\n              value={shown}\n              placeholder={placeholder}\n              // The caller's name, over the <label for> above. Just the label, never\n              // \"label: value\" the way a trigger button has to compose it: an input\n              // already exposes its value separately.\n              aria-label={ariaLabel}\n              role=\"combobox\"\n              aria-expanded={open}\n              // Required by the role, and the half that was missing: the field said it\n              // was expanded and never said what it had expanded (ESLint's\n              // `role-has-required-aria-props`, the audit's §a11y).\n              aria-controls={listboxId}\n              aria-activedescendant={activeId}\n              aria-autocomplete=\"list\"\n              aria-invalid={field.isInvalid || undefined}\n              aria-describedby={mergeDescribedBy(field.describedBy, locked && lock.reasonId)}\n              aria-required={ariaRequired}\n              autoComplete=\"off\"\n              // Locked: focusable, `readOnly`, `aria-disabled` — see `lockedKeyDown`.\n              disabled={locked ? undefined : disabled}\n              readOnly={locked || undefined}\n              aria-disabled={locked || undefined}\n              // eslint-disable-next-line jsx-a11y/no-autofocus -- a documented prop the caller opts into (off by default); the field never takes focus on its own.\n              autoFocus={autoFocus}\n              // `inputMode=\"none\"` rather than readOnly, for the same reason Combobox\n              // above gives: the sheet carries the keyboard, and a readOnly field would\n              // take FIELD_BASE's settled look on a field that is perfectly editable.\n              inputMode={isPhone ? \"none\" : undefined}\n              onMouseDown={primaryOnly.onMouseDown}\n              onFocus={(e) => {\n                // See {@link usePrimaryPressOnly}: a back/forward button lands here on\n                // its way to navigating, and neither the list nor the select-all is\n                // anything it asked for (live #309 rework). A locked field takes focus to\n                // say why, and opens nothing.\n                if (primaryOnly.fromAuxButton() || locked) return;\n                setText(shown);\n                e.currentTarget.select();\n                setOpen(true);\n                // The sheet has its own input; the field behind it must not also pull up\n                // the keyboard and scroll the page under the dialog.\n                if (isPhone) sheetInputRef.current?.focus();\n              }}\n              onBlur={() => {\n                // On a phone the blur is the SHEET taking focus, not the user leaving the\n                // field — reconciling there would close the sheet the instant it opened.\n                if (!isPhone) reconcile();\n              }}\n              onChange={(e) => {\n                if (locked) return;\n                setText(e.target.value);\n                setOpen(true);\n                setActive(-1);\n              }}\n              onKeyDown={(e) => {\n                if (locked) return lockedKeyDown(e);\n                // Disabled rows are passed over; Up from \"nothing highlighted\" lands on\n                // the first takeable row, as it always landed on row 0. The create row is\n                // the last row the arrows reach.\n                if (e.key === \"ArrowDown\") {\n                  e.preventDefault();\n                  setOpen(true);\n                  setActive((i) => stepEnabled(rows, i, 1));\n                } else if (e.key === \"ArrowUp\") {\n                  e.preventDefault();\n                  setActive((i) => (i < 0 ? stepEnabled(rows, -1, 1) : stepEnabled(rows, i, -1)));\n                } else if (e.key === \"Enter\") {\n                  // An IME's Enter takes nothing, and judges no loose text (BUG-9).\n                  if (isImeEnter(e)) return;\n                  if (open && isOptionEnabled(rows[active])) {\n                    e.preventDefault();\n                    if (active === createIndex && showCreate) create();\n                    else take(matches[active]);\n                  } else {\n                    reconcile();\n                  }\n                } else if (e.key === \"Escape\") {\n                  // A showing list takes the key and stops it — see the twin in\n                  // {@link Combobox} (round 0.34 BUG-1).\n                  if (showing && takeEscape(e)) return;\n                  setText(null);\n                  close();\n                } else if (e.key === \"Tab\") {\n                  // Focus is in THIS input and stays there, so the browser's own Tab is\n                  // left alone; all that is needed is that the list stop covering what\n                  // the user is tabbing to. `reconcile` rather than `close`, because\n                  // leaving the field is exactly when loose text has to be judged.\n                  reconcile();\n                }\n                // Home/End stay with the caret — see the note in {@link Combobox}: this\n                // field is editable, and its text is what `reconcile` judges.\n              }}\n              className={cn(\n                FIELD_BASE,\n                label !== undefined && FIELD_FLOATING_PAD,\n                \"pe-9\",\n                field.isInvalid && FIELD_INVALID,\n              )}\n            />\n            {showClear ? (\n              <button\n                type=\"button\"\n                // Out of the tab order, like the clear on `EntityCombobox`: the keyboard\n                // already clears this field by selecting its text and deleting, and a\n                // second stop between every picker and the next field is a worse trade\n                // than the one gesture it saves.\n                tabIndex={-1}\n                aria-label={labels.clear}\n                // preventDefault, exactly as the chevron does: without it the press\n                // focuses the input, which on a phone opens the sheet over the field the\n                // press was clearing.\n                onMouseDown={(e) => e.preventDefault()}\n                onClick={() => {\n                  setText(null);\n                  close();\n                  if (!locked) onChange(clearValue);\n                }}\n                className={cn(\n                  \"absolute end-2 top-1/2 -translate-y-1/2 rounded p-0.5 text-placeholder\",\n                  \"hover:text-secondary\",\n                )}\n              >\n                <X aria-hidden className=\"size-4\" />\n              </button>\n            ) : (\n              <ChevronDown\n                aria-hidden\n                onMouseDown={(e) => {\n                  // Toggle on the chevron without stealing focus from the input — and\n                  // not at all on a disabled or locked field, which the input's own\n                  // `disabled`/`readOnly` does not stop from here.\n                  e.preventDefault();\n                  if (!inert) setOpen((o) => !o);\n                }}\n                className={cn(\n                  \"absolute end-2.5 top-1/2 size-4 -translate-y-1/2 text-placeholder\",\n                  // The box above does the dimming; dimming here too would halve it again.\n                  !inert && \"cursor-pointer\",\n                )}\n              />\n            )}\n          </div>,\n        )}\n      </EndHintRow>\n      {label !== undefined && hintParts.labelHint !== undefined && (\n        <StaticLabelRow hint={hintParts.labelHint}>\n          <ComboboxFieldLabel htmlFor={fieldId} className={cn(LABEL_IN_ROW, inert && \"opacity-50\")}>\n            {label}\n          </ComboboxFieldLabel>\n        </StaticLabelRow>\n      )}\n      <FieldCaption parts={hintParts} />\n      {field.errorEl}\n      {isPhone && (\n        <PickerSheet\n          open={open && !inert}\n          // Closing without choosing keeps the value: `text` was never emptied, so\n          // reconcile has nothing to undo — it just puts the label back.\n          onClose={reconcile}\n          title={sheetTitle ?? label}\n          query={sheetQuery}\n          onQueryChange={(v) => {\n            setSheetQuery(v);\n            setActive(-1);\n          }}\n          searchPlaceholder={searchPlaceholder ?? placeholder ?? labels.search}\n          inputRef={sheetInputRef}\n          closeLabel={closeLabel}\n        >\n          <ul id={listboxId} role=\"listbox\">\n            {matches.map((o, i) => (\n              // Keyed by group AND value, like combobox-core.tsx: an option may\n              // deliberately appear twice (see `reconcile`), and a bare value key\n              // would collide.\n              <Fragment key={`${o.group ?? \"\"}|${String(o.value)}`}>\n                {o.group && o.group !== matches[i - 1]?.group && (\n                  <li\n                    role=\"presentation\"\n                    className=\"px-4 pb-0.5 pt-3 text-caption font-semibold uppercase tracking-wide text-muted\"\n                  >\n                    {o.group}\n                  </li>\n                )}\n                <li role=\"presentation\">\n                  <button\n                    type=\"button\"\n                    role=\"option\"\n                    aria-selected={o.value === value}\n                    aria-disabled={o.disabled || undefined}\n                    onClick={() => take(o)}\n                    className={cn(\n                      SHEET_ROW_CLASS,\n                      o.value === value && \"font-medium\",\n                      o.disabled && DISABLED_ROW_CLASS,\n                    )}\n                  >\n                    {o.label}\n                  </button>\n                </li>\n              </Fragment>\n            ))}\n            {showCreate && (\n              <li role=\"presentation\">\n                <button\n                  type=\"button\"\n                  role=\"option\"\n                  // An action, never chosen — see `onCreate`.\n                  aria-selected={false}\n                  aria-disabled={createLocked || undefined}\n                  onClick={create}\n                  className={cn(\n                    SHEET_ROW_CLASS,\n                    CREATE_ROW_CLASS,\n                    createLocked && DISABLED_ROW_CLASS,\n                  )}\n                >\n                  {createRowContent}\n                </button>\n              </li>\n            )}\n            {/* \"Nothing matched\" only when there is nothing to do either: with a create\n                row the list is not empty, it is offering to fill itself. */}\n            {matches.length === 0 && !showCreate && (\n              <li className=\"px-4 py-3 text-sm text-muted\">{labels.noResults}</li>\n            )}\n          </ul>\n        </PickerSheet>\n      )}\n      {showing && (\n        <SuggestionList id={listboxId} anchorRef={fieldRef} panelRef={panelRef}>\n          {matches.map((o, i) => (\n            // A group heading is emitted at each group boundary rather than repeating\n            // the group on every row (feedback #136). `matches` is group-contiguous,\n            // so comparing with the previous row is enough. Fragment key sits here;\n            // the heading and the option carry their own list semantics — keyed by\n            // group AND value, because an option may deliberately appear twice (see\n            // `reconcile`).\n            <Fragment key={`${o.group ?? \"\"}|${String(o.value)}`}>\n              {o.group && o.group !== matches[i - 1]?.group && (\n                <li\n                  role=\"presentation\"\n                  className=\"px-3 pb-0.5 pt-2 text-caption font-semibold uppercase tracking-wide text-muted first:pt-1\"\n                >\n                  {o.group}\n                </li>\n              )}\n              <li role=\"presentation\">\n                <button\n                  type=\"button\"\n                  id={optionId(i)}\n                  // See {@link Combobox}: the role rides the button, `aria-selected`\n                  // is the CHOSEN row, and the keyboard's row is the field's\n                  // `aria-activedescendant`.\n                  role=\"option\"\n                  aria-selected={o.value === value}\n                  aria-disabled={o.disabled || undefined}\n                  tabIndex={-1}\n                  onMouseDown={(e) => {\n                    // mousedown (not click) so the input's blur can't close the\n                    // list before the selection registers. Prevented on a disabled\n                    // row too, so pressing one leaves the field focused and open.\n                    e.preventDefault();\n                    take(o);\n                  }}\n                  onMouseEnter={() => {\n                    if (!o.disabled) setActive(i);\n                  }}\n                  className={cn(\n                    rowClass(i === active && !o.disabled),\n                    o.disabled && DISABLED_ROW_CLASS,\n                    // Indented under its heading, so the hierarchy is readable at a\n                    // glance instead of inferred from grey trailing text.\n                    o.group && \"ps-6\",\n                    o.value === value && \"font-medium\",\n                  )}\n                >\n                  {o.label}\n                  {o.sublabel && (\n                    <span className=\"ms-2 text-xs text-placeholder\">\n                      {o.sublabel}\n                    </span>\n                  )}\n                </button>\n              </li>\n            </Fragment>\n          ))}\n          {showCreate && (\n            <li role=\"presentation\">\n              <button\n                type=\"button\"\n                id={optionId(createIndex)}\n                role=\"option\"\n                // An action, never chosen; whether the keyboard is ON it is the field's\n                // `aria-activedescendant`'s to say.\n                aria-selected={false}\n                aria-disabled={createLocked || undefined}\n                tabIndex={-1}\n                onMouseDown={(e) => {\n                  // mousedown, like the rows above: the input's blur would otherwise\n                  // reconcile and close the list before the click landed.\n                  e.preventDefault();\n                  create();\n                }}\n                onMouseEnter={() => {\n                  if (!createLocked) setActive(createIndex);\n                }}\n                className={cn(\n                  rowClass(active === createIndex && !createLocked),\n                  CREATE_ROW_CLASS,\n                  createLocked && DISABLED_ROW_CLASS,\n                )}\n              >\n                {createRowContent}\n              </button>\n            </li>\n          )}\n        </SuggestionList>\n      )}\n    </div>\n  );\n}\n"],"mappings":"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","names":["Fragment","rest"]}
+{"version":3,"sources":["../../src/components/inline-entity-combobox.tsx"],"sourcesContent":["// The id-keyed sibling of Combobox. Moved out of combobox.tsx as it was (MOD-9,\n// refactor audit 2026-10); combobox still exports `InlineEntityCombobox` and its props.\nimport { Fragment, useId, useMemo, useRef, useState } from \"react\";\nimport type { ComponentPropsWithoutRef, ReactNode, Ref } from \"react\";\nimport { ChevronDown, Plus, X } from \"lucide-react\";\nimport { FIELD_BASE, FIELD_FLOATING_PAD, FIELD_INVALID } from \"./field-base\";\nimport { cn } from \"../lib/cn\";\nimport { useDropdown } from \"./dropdown\";\nimport { takeEscape, useDismissLayer } from \"../hooks/use-dismiss\";\nimport { isImeEnter } from \"../lib/ime\";\nimport { usePhoneLayout } from \"../hooks/use-breakpoint\";\nimport { PickerSheet, SHEET_ROW_CLASS } from \"./picker-sheet\";\nimport {\n  ComboboxFieldLabel,\n  DISABLED_ROW_CLASS,\n  endHintRowProps,\n  GROUP_HEADING_STICKY,\n  isOptionEnabled,\n  offersCreate,\n  stepEnabled,\n  useActiveOptionScroll,\n  type ComboClearValue,\n  type ComboOption,\n} from \"./combobox-core\";\nimport { DEFAULT_COMBOBOX_LABELS, useKitLabels, useKitLocale } from \"../i18n/kit-labels\";\nimport { foldForSearch, rankMatch } from \"../lib/text-match\";\nimport {\n  EndHintRow,\n  FieldCaption,\n  LABEL_IN_ROW,\n  LockedReason,\n  mergeDescribedBy,\n  StaticLabelRow,\n  useFieldError,\n  useFieldHint,\n  useLockReason,\n  type DisabledReasonDisplay,\n  type FieldHelpProps,\n} from \"./field-parts\";\nimport { hasContent } from \"../lib/presence\";\nimport { useCommitReason, type CommitScope } from \"./write-lock\";\nimport { lockedKeyDown, rowClass, SuggestionList, usePrimaryPressOnly } from \"./combobox-suggestions\";\n\n/** {@link InlineEntityCombobox}'s create row over the shared row look: in the brand\n *  colour {@link Combobox}'s own create row wears, with a leading \"+\" as the panel\n *  pickers' has — an action at the foot of the list, not one more record. */\nconst CREATE_ROW_CLASS = \"flex items-center gap-2 font-medium text-brand\";\n\n/** `id` is the INPUT's and `onChange` is the field's — see {@link ComboboxProps}\n *  for why the div's spellings of them are omitted. */\nexport interface InlineEntityComboboxProps<V extends string | number, C extends ComboClearValue = null>\n  extends Omit<ComponentPropsWithoutRef<\"div\">, \"id\" | \"onChange\">,\n    FieldHelpProps {\n  /** Selected option id; `null` or `clearValue` when nothing is selected. */\n  value: V | C | null;\n  /** Required and unanswered — see {@link Combobox}'s `invalid`. */\n  invalid?: boolean;\n  /** What is wrong with the value — see {@link Combobox}'s `error`. */\n  error?: ReactNode;\n  /** Standing advice — see {@link Combobox}'s `hint` (keksdose K4). */\n  hint?: ReactNode;\n  /** A picked/typed option emits its id; emptying the field, or the \"×\", emits\n   *  `clearValue`. */\n  onChange: (v: V | C) => void;\n  /** What a clear emits — `null` by default, `\"\"` for a schema that wants an empty\n   *  string. See {@link EntityCombobox}'s `clearValue`. */\n  clearValue?: C;\n  options: ComboOption<V>[];\n  /** The visible label — see {@link Combobox}'s `label` (a ReactNode since 0.34, API-9). */\n  label?: ReactNode;\n  id?: string;\n  placeholder?: string;\n  className?: string;\n  disabled?: boolean;\n  /** Focus on mount, the way `<input autoFocus>` does — and, through `onFocus`\n   *  below, open the list with it. A click-the-value editor needs it: the cell\n   *  the user clicked names the field the editor should land the caret in, and\n   *  without a passthrough this component's fixed prop list puts the `<input>`\n   *  out of a caller's reach entirely (Keksdose feedback live #218). */\n  autoFocus?: boolean;\n  /** Phone sheet only — the anchored list has the field itself to type in. Falls\n   *  back to `placeholder`, then to `combobox.search` from the {@link UiKitProvider}. */\n  searchPlaceholder?: string;\n  /** Phone sheet only: a full screen showing nothing has to say why. The anchored\n   *  list simply does not open. Default: `combobox.noResults` from the provider. */\n  emptyLabel?: string;\n  closeLabel?: string;\n  /** The phone sheet's heading (and, as a string, its accessible name) for a field\n   *  whose label is drawn by someone else — a bound field's label;\n   *  `RhfInlineEntityCombobox` hands its label over here (0.24). Default: `label`.\n   *  See {@link Combobox}'s `sheetTitle`. */\n  sheetTitle?: ReactNode;\n  /** Offer a clear \"×\" in place of the chevron whenever something is selected.\n   *\n   *  Emptying the text already clears (see {@link reconcile}), and on a desktop that\n   *  is the fast way. It is not a way at all on a PHONE: touching the field opens the\n   *  full-screen sheet, which covers the very input the text would have been deleted\n   *  from — so a field that had been answered could not be UNanswered by any gesture\n   *  the screen offered (Keksdose live #236, filed from a phone). The \"×\" is the one\n   *  affordance both shells share, and it clears without opening anything. */\n  clearable?: boolean;\n  clearLabel?: string;\n  /**\n   * Why the choice cannot be changed — {@link Button}'s `disabledReason`, for a picker\n   * that SAVES on change. keksdose G2: the statement review's account picker IS the\n   * write (picking re-runs the duplicate check on the server), and on the read-only demo\n   * the app wrapped it in a hand-made Tooltip over a native `disabled` — out of the tab\n   * order, so the reason never reached a keyboard.\n   *\n   * With a reason the input stays focusable and `aria-disabled`, is `readOnly` (the\n   * settled grey), opens no list or sheet, offers no clear \"×\", and no pick, typed\n   * label or clear reaches `onChange`; the reason is in the kit {@link Tooltip} and on\n   * the input's `aria-describedby`. Wins over `disabled`. Use it CONTROLLED, as the\n   * component always is: the shown label is `value`'s.\n   */\n  disabledReason?: ReactNode;\n  /**\n   * This picker COMMITS — choosing saves. Under a locked {@link WriteLockProvider} it is\n   * locked the `disabledReason` way with the lock's reason (which wins over its own).\n   * A picker inside a form with its own Save stays editable under the lock — leave this\n   * off there and put `commit` on the Save. No provider, or an unlocked one: no effect.\n   */\n  commit?: CommitScope;\n  /** Where the reason shows — {@link Button}'s `disabledReasonDisplay`: a line under the\n   *  field at Large and on a touch screen by default, the tooltip otherwise (DUP-3). */\n  disabledReasonDisplay?: DisabledReasonDisplay;\n  /**\n   * A last row that makes a new record from what was typed — keksdose G9, whose \"Create\n   * cash account\" had to become a separate button because this picker had no such row.\n   *\n   * Shown while the typed query is non-empty and names no option exactly\n   * (case-insensitive — an exact hit is a record the list already shows), worded\n   * `createLabel(query)`, default `combobox.create`: \"Create “{query}”\". The arrow keys\n   * reach it like an option; Enter or a click calls `onCreate(query)` and closes the\n   * list. Making the record, and then passing its id as `value`, is the caller's: the\n   * field shows the old selection until it does.\n   *\n   * The same rule as {@link EntityCombobox}'s `onCreate`, so the family agrees. It is a\n   * row of the LIST, not an option: it is never `aria-selected`, never matched by a\n   * typed label on blur, and never sorted among the records the way a sentinel option\n   * would be (the reason keksdose gave for the separate button).\n   */\n  onCreate?: (query: string) => void;\n  /** The create row's words for a query. Default: `combobox.create` from the\n   *  {@link UiKitProvider}, else English `Create “{query}”`. */\n  createLabel?: (query: string) => string;\n  /**\n   * Offer the create row with NOTHING typed too, worded as this — keksdose's \"Create cash\n   * account\", which mints an account under a default name and so needs no query.\n   * `onCreate` then receives `\"\"`, and the caller supplies the name. Left out, the row\n   * needs a query.\n   *\n   * One string rather than a switch: a row with no query has nothing to quote, so the\n   * kit cannot word it — \"Create “”\" says nothing — and naming it is what turns it on.\n   * With both, one handler serves both rows:\n   *\n   * ```tsx\n   * onCreate={(name) => createCash(name || t(\"cash_account_default_name\"))}\n   * createEmptyLabel={t(\"create_cash_account\")}\n   * ```\n   */\n  createEmptyLabel?: string;\n  /**\n   * The create row WRITES while picking does not — keksdose dev#496: on the read-only\n   * demo choosing the cash account is draft state and stays live, minting one is a\n   * write. Under a locked {@link WriteLockProvider} the row stays in the list, dimmed and\n   * passed over by the arrows, with the lock's reason as its second line (a hover is the\n   * one explanation a phone cannot show), and `onCreate` is not called. Not needed with\n   * `commit`: a locked field opens no list at all.\n   */\n  createCommit?: CommitScope;\n  /**\n   * The `<input>` — the focusable control, the one a reader types in — as a React 19\n   * ref prop (0.24, kastlan). Its account picker is this component inside an\n   * `RhfField` render, and react-hook-form's focus-on-error calls `focus()` on whatever\n   * `field.ref` is handed: with no ref there was nothing to hand it, so a line-item form\n   * whose account was missing failed its submit and left the caret where it was. Pass\n   * `field.ref` here, or use `RhfInlineEntityCombobox`, which does. The wrapper is not\n   * reachable this way — focus and selection are the input's. See {@link Combobox}'s `ref`.\n   */\n  ref?: Ref<HTMLInputElement>;\n}\n\n/**\n * The id-keyed sibling of {@link Combobox}: identical anatomy (a real text input\n * with the shared field styling, chevron and inline as-you-type filtering) but\n * the value is an option id, not free text. Built so an entity picker can sit\n * next to a free-text combobox without any visible difference — a button-trigger\n * panel picker ({@link EntityCombobox}) never matches an input field exactly.\n *\n * Text-vs-value reconciliation: the input's text is transient. Picking a row or\n * typing an exact (unique) label commits that option; emptying the text commits\n * a clear; anything else reverts to the selected option's label on blur/Escape.\n *\n * **On a phone the list opens as a full-screen sheet**, exactly like {@link Combobox}\n * beside it (Keksdose live #200, extended by dev#477 — the account picker moved onto\n * this component and must not lose its sheet). The sheet carries its OWN query state\n * rather than reusing `text`: `text` is what {@link reconcile} judges on blur, so a\n * sheet that emptied it to show the full list would read as \"the user cleared the\n * field\" the moment it closed.\n */\nexport function InlineEntityCombobox<V extends string | number, C extends ComboClearValue = null>(\n  props: InlineEntityComboboxProps<V, C>,\n) {\n  const {\n    value: rawValue,\n    onChange,\n    clearValue = null as C,\n    options,\n    label,\n    id,\n    placeholder,\n    className,\n    disabled,\n    autoFocus,\n    searchPlaceholder,\n    emptyLabel,\n    closeLabel,\n    sheetTitle,\n    clearable,\n    clearLabel,\n    disabledReason,\n    disabledReasonDisplay,\n    commit,\n    onCreate,\n    createLabel,\n    createEmptyLabel,\n    createCommit,\n    invalid,\n    error,\n    hint,\n    help,\n    ref,\n    \"aria-label\": ariaLabel,\n    // Off `rest` and onto the <input>, which is the combobox a reader meets: `Field`'s\n    // render-prop spreads `{ id, aria-describedby, aria-invalid, aria-required }`, and\n    // on the wrapper div the hint and required state described nothing.\n    \"aria-describedby\": ariaDescribedBy,\n    \"aria-invalid\": ariaInvalid,\n    \"aria-required\": ariaRequired,\n    ...rest\n  } = props;\n  // The clear value reads as \"nothing selected\", whichever one the caller picked —\n  // so from here down `value` is the id or `null`, as it always was.\n  const value: V | null = rawValue == null || rawValue === clearValue ? null : (rawValue as V);\n  const hintParts = useFieldHint(hint, ariaDescribedBy, { help, name: label ?? ariaLabel });\n  const field = useFieldError(error, invalid, hintParts.describedBy, ariaInvalid);\n  const generated = useId();\n  const fieldId = id ?? generated;\n  // See the twin above on why these hang off the generated id.\n  const listboxId = `${generated}-listbox`;\n  const optionId = (index: number) => `${generated}-option-${index}`;\n  const isPhone = usePhoneLayout();\n  // See the twin above: the phone sheet owns its own Back entry (live #309), and the\n  // Escape layer is this field's own.\n  const { open, setOpen, wrapperRef, panelRef } = useDropdown({ backCloses: !isPhone, escapeLayer: false });\n  const primaryOnly = usePrimaryPressOnly();\n  const [active, setActive] = useState(-1);\n  // null = not editing → the input shows the selected option's label.\n  const [text, setText] = useState<string | null>(null);\n  const sheetInputRef = useRef<HTMLInputElement | null>(null);\n  // The box the portalled list hangs off — see {@link SuggestionList}.\n  const fieldRef = useRef<HTMLDivElement>(null);\n  // The sheet's search box. Starts empty on every open, so a field that already\n  // holds a value still offers the whole list — the shape a native <select> has\n  // on a phone, and what the anchored panel gets from `query` below.\n  const [sheetQuery, setSheetQuery] = useState(\"\");\n  // Props first, provider second — see `EntityCombobox`. `emptyLabel` used to render\n  // nothing when omitted, which left a phone user staring at a blank full-screen\n  // sheet; now an omitted one says \"No results\" in the provider's language.\n  const labels = useKitLabels(\"combobox\", DEFAULT_COMBOBOX_LABELS, {\n    search: searchPlaceholder,\n    noResults: emptyLabel,\n    clear: clearLabel,\n    create: createLabel,\n  });\n  // The lock (see `lockedKeyDown` above). A lock arriving mid-edit closes the list and\n  // drops the loose text, adjusted while rendering: nothing typed before it may be\n  // judged by `reconcile` after it.\n  const lock = useLockReason(commit, disabledReason);\n  const locked = lock.locked;\n  const inert = locked || Boolean(disabled);\n  if (locked && (open || text !== null)) {\n    setOpen(false);\n    setText(null);\n  }\n  // The create row's own lock (`createCommit`): the list stays live, the row does not.\n  const createReason = useCommitReason(createCommit, undefined);\n  const createLocked = hasContent(createReason);\n\n  const selected = useMemo(\n    () => (value == null ? null : (options.find((o) => o.value === value) ?? null)),\n    [options, value],\n  );\n  const shown = text ?? selected?.label ?? \"\";\n  // Nothing selected has nothing to clear, and the chevron comes back — the field\n  // keeps exactly one trailing control, so the \"×\" never crowds the value it sits on.\n  const showClear = Boolean(clearable && value != null && !inert);\n\n  // Focusing select-alls the current label; filtering only kicks in once the\n  // text actually differs from it, so an already-filled field still opens on\n  // the FULL list instead of a single-row \"filter\" of its own value.\n  const typedQuery = text !== null && text !== (selected?.label ?? \"\") ? text.trim() : \"\";\n  const query = isPhone ? sheetQuery.trim() : typedQuery;\n  // Folded as every kit list folds (DUP-5): accents off and the locale's case, so\n  // \"zurich\" finds Zürich and, in Turkish, \"ı\" finds \"IRMAK\".\n  const locale = useKitLocale();\n  const matches = useMemo(() => {\n    let ranked = options;\n    if (query) {\n      const q = foldForSearch(query, locale);\n      const hit = (s: string | undefined) => s !== undefined && foldForSearch(s, locale).includes(q);\n      // The label's whole name or its start first (`rankMatch` 0 and 1), then a match\n      // anywhere in the label or the sublabel. Not the group (0.40, kk run 79): with\n      // first-letter groups one typed letter matched its whole group.\n      const leads = (o: ComboOption<V>) => {\n        const rank = rankMatch(o.label, query, { locale });\n        return rank === 0 || rank === 1;\n      };\n      const starts = options.filter(leads);\n      const rest = options.filter((o) => !leads(o) && (hit(o.label) || hit(o.sublabel)));\n      ranked = [...starts, ...rest];\n    }\n    if (!ranked.some((o) => o.group)) return ranked;\n    // Keep each group contiguous so the headings below appear once instead of\n    // re-appearing every time the ranking interleaves two groups — while preserving\n    // \"best match first\": a Map keeps insertion order, so groups come out ordered by\n    // their best-ranked member and members keep their rank order inside the group.\n    const blocks = new Map<string, ComboOption<V>[]>();\n    for (const o of ranked) {\n      const key = o.group ?? \"\";\n      if (!blocks.has(key)) blocks.set(key, []);\n      blocks.get(key)!.push(o);\n    }\n    return [...blocks.values()].flat();\n  }, [options, query, locale]);\n\n  // The create row (`onCreate`), on the query as typed — not lowercased: it becomes a\n  // name. Compared against EVERY option, not `matches`: an exact hit anywhere is a\n  // record that exists, disabled or not. Restated from `text` rather than derived from\n  // `typedQuery`: this value is handed to the caller's `onCreate`, and the React\n  // Compiler cannot then keep `matches` memoised on anything it was derived from.\n  const createQuery = isPhone\n    ? sheetQuery.trim()\n    : text !== null && text !== (selected?.label ?? \"\")\n      ? text.trim()\n      : \"\";\n  const showCreate = offersCreate(\n    onCreate,\n    createQuery,\n    options.map((o) => o.label),\n    createEmptyLabel,\n  );\n  const createText = createQuery ? labels.create(createQuery) : createEmptyLabel;\n  // Every row the keyboard can land on: the options, then the create row — passed over\n  // like a disabled option while a write lock holds it.\n  const rows: readonly { disabled?: boolean }[] = showCreate\n    ? [...matches, { disabled: createLocked }]\n    : matches;\n  const createIndex = matches.length;\n\n  // Pointer-device only: the phone's rows live in a {@link PickerSheet} whose own\n  // search box holds focus, so the field behind it must not claim to be pointing at\n  // one of them.\n  // A disabled row is never the keyboard's, even if the list changed under it.\n  const activeId = !isPhone && isOptionEnabled(rows[active]) ? optionId(active) : undefined;\n  useActiveOptionScroll(activeId);\n\n  const close = () => {\n    setOpen(false);\n    setActive(-1);\n    setSheetQuery(\"\");\n  };\n  // See the twin above: a layer while the list SHOWS, and Escape puts the label back.\n  const showing = !isPhone && open && !inert && (matches.length > 0 || showCreate);\n  useDismissLayer(showing, () => {\n    setText(null);\n    close();\n  });\n  const take = (o: ComboOption<V>) => {\n    // A `disabled` option is listed, never taken — by any path; nor is anything while\n    // the field is locked.\n    if (o.disabled || locked) return;\n    if (o.value !== value) onChange(o.value);\n    setText(null);\n    close();\n  };\n  /** Turn loose text into a decision: empty clears, an exact label match that names\n   *  ONE entity commits, anything else reverts to the selected label.\n   *\n   *  Unique by VALUE, not by row. An option may deliberately appear twice — Keksdose\n   *  repeats recently-used categories in a \"Recent\" group at the top (live #203) — and\n   *  counting rows made every such option uncommittable: two hits, so nothing fired and\n   *  the field reverted to whatever was selected before. Typing a category you had just\n   *  used, then tabbing away, silently discarded it, and the more categories you used\n   *  the more of them stopped working. Two rows naming the same id are not an ambiguity;\n   *  two ids sharing a label are. */\n  const create = () => {\n    if (!onCreate || locked || createLocked) return;\n    onCreate(createQuery);\n    setText(null);\n    close();\n  };\n  const reconcile = () => {\n    // Locked, loose text is dropped rather than judged: nothing reaches `onChange`.\n    if (text !== null && !locked) {\n      const q = text.trim();\n      if (!q) {\n        if (value != null) onChange(clearValue);\n      } else {\n        // A disabled option's label typed out in full is not a way round `disabled`:\n        // it is not a hit, so the text reverts like any other non-answer.\n        const hits = options.filter(\n          (o) => !o.disabled && o.label.toLowerCase() === q.toLowerCase(),\n        );\n        const ids = new Set(hits.map((h) => h.value));\n        if (ids.size === 1 && hits[0].value !== value) onChange(hits[0].value);\n      }\n    }\n    setText(null);\n    close();\n  };\n\n  // The create row's inside, one for both shells: a \"+\" (it is an action, not a record),\n  // the words, and — while a write lock holds it — the lock's reason as a second line.\n  // Both lines wrap from Large up (text size §10.17, round 0.34 T1): the words hold what\n  // the reader typed, which an ellipsis would cut.\n  const createRowContent = (\n    <>\n      <Plus aria-hidden className=\"size-4 shrink-0\" />\n      <span className=\"min-w-0 flex-1\">\n        <span className=\"block truncate-until-large\">{createText}</span>\n        {createLocked && (\n          <span className=\"block truncate-until-large text-xs font-normal text-placeholder\">\n            {createReason}\n          </span>\n        )}\n      </span>\n    </>\n  );\n  // While locked the field sits in the reason's Tooltip — see Combobox.\n  const withLock = (box: ReactNode) =>\n    locked ? (\n      <LockedReason lock={lock} display={disabledReasonDisplay} className=\"block\">\n        {box}\n      </LockedReason>\n    ) : (\n      box\n    );\n\n  return (\n    // `rest` dresses the outer box — a `data-tour` anchor, a test id. Not the NAME,\n    // description, invalid or required state: those belong on the <input> below,\n    // which is the combobox a reader meets. Spread FIRST, so the field's ARIA and the\n    // handlers carrying live #309 and dev#549 cannot be replaced from outside.\n    <div {...rest} ref={wrapperRef} className={cn(\"relative\", className)}>\n      {/* A real <label for> — see {@link Combobox}; with a \"?\", in a row after the field. */}\n      {label !== undefined && hintParts.labelHint === undefined && (\n        <ComboboxFieldLabel htmlFor={fieldId} className={inert ? \"opacity-50\" : undefined}>\n          {label}\n        </ComboboxFieldLabel>\n      )}\n      <EndHintRow {...endHintRowProps(\"hint\" in props, label !== undefined, hintParts.labelHint)}>\n        {withLock(\n          /* Inner wrapper for chevron centering — same reasoning as Combobox above.\n              It is also what the portalled list anchors to.\n              Dimmed as a whole when disabled (or locked), the way EntityCombobox dims its\n              trigger. FIELD_BASE's grey alone left a disabled picker looking like a\n              filled-in one beside the pickers that do dim (the label is not the input's\n              `peer`, so it is dimmed by hand above). */\n          <div ref={fieldRef} className={cn(\"relative\", inert && \"cursor-not-allowed opacity-50\")}>\n            <input\n              ref={ref}\n              id={fieldId}\n              value={shown}\n              placeholder={placeholder}\n              // The caller's name, over the <label for> above. Just the label, never\n              // \"label: value\" the way a trigger button has to compose it: an input\n              // already exposes its value separately.\n              aria-label={ariaLabel}\n              role=\"combobox\"\n              aria-expanded={open}\n              // Required by the role, and the half that was missing: the field said it\n              // was expanded and never said what it had expanded (ESLint's\n              // `role-has-required-aria-props`, the audit's §a11y).\n              aria-controls={listboxId}\n              aria-activedescendant={activeId}\n              aria-autocomplete=\"list\"\n              aria-invalid={field.isInvalid || undefined}\n              aria-describedby={mergeDescribedBy(field.describedBy, locked && lock.reasonId)}\n              aria-required={ariaRequired}\n              autoComplete=\"off\"\n              // Locked: focusable, `readOnly`, `aria-disabled` — see `lockedKeyDown`.\n              disabled={locked ? undefined : disabled}\n              readOnly={locked || undefined}\n              aria-disabled={locked || undefined}\n              // eslint-disable-next-line jsx-a11y/no-autofocus -- a documented prop the caller opts into (off by default); the field never takes focus on its own.\n              autoFocus={autoFocus}\n              // `inputMode=\"none\"` rather than readOnly, for the same reason Combobox\n              // above gives: the sheet carries the keyboard, and a readOnly field would\n              // take FIELD_BASE's settled look on a field that is perfectly editable.\n              inputMode={isPhone ? \"none\" : undefined}\n              onMouseDown={primaryOnly.onMouseDown}\n              onFocus={(e) => {\n                // See {@link usePrimaryPressOnly}: a back/forward button lands here on\n                // its way to navigating, and neither the list nor the select-all is\n                // anything it asked for (live #309 rework). A locked field takes focus to\n                // say why, and opens nothing.\n                if (primaryOnly.fromAuxButton() || locked) return;\n                setText(shown);\n                e.currentTarget.select();\n                setOpen(true);\n                // The sheet has its own input; the field behind it must not also pull up\n                // the keyboard and scroll the page under the dialog.\n                if (isPhone) sheetInputRef.current?.focus();\n              }}\n              onBlur={() => {\n                // On a phone the blur is the SHEET taking focus, not the user leaving the\n                // field — reconciling there would close the sheet the instant it opened.\n                if (!isPhone) reconcile();\n              }}\n              onChange={(e) => {\n                if (locked) return;\n                setText(e.target.value);\n                setOpen(true);\n                setActive(-1);\n              }}\n              onKeyDown={(e) => {\n                if (locked) return lockedKeyDown(e);\n                // Disabled rows are passed over; Up from \"nothing highlighted\" lands on\n                // the first takeable row, as it always landed on row 0. The create row is\n                // the last row the arrows reach.\n                if (e.key === \"ArrowDown\") {\n                  e.preventDefault();\n                  setOpen(true);\n                  setActive((i) => stepEnabled(rows, i, 1));\n                } else if (e.key === \"ArrowUp\") {\n                  e.preventDefault();\n                  setActive((i) => (i < 0 ? stepEnabled(rows, -1, 1) : stepEnabled(rows, i, -1)));\n                } else if (e.key === \"Enter\") {\n                  // An IME's Enter takes nothing, and judges no loose text (BUG-9).\n                  if (isImeEnter(e)) return;\n                  if (open && isOptionEnabled(rows[active])) {\n                    e.preventDefault();\n                    if (active === createIndex && showCreate) create();\n                    else take(matches[active]);\n                  } else {\n                    reconcile();\n                  }\n                } else if (e.key === \"Escape\") {\n                  // A showing list takes the key and stops it — see the twin in\n                  // {@link Combobox} (round 0.34 BUG-1).\n                  if (showing && takeEscape(e)) return;\n                  setText(null);\n                  close();\n                } else if (e.key === \"Tab\") {\n                  // Focus is in THIS input and stays there, so the browser's own Tab is\n                  // left alone; all that is needed is that the list stop covering what\n                  // the user is tabbing to. `reconcile` rather than `close`, because\n                  // leaving the field is exactly when loose text has to be judged.\n                  reconcile();\n                }\n                // Home/End stay with the caret — see the note in {@link Combobox}: this\n                // field is editable, and its text is what `reconcile` judges.\n              }}\n              className={cn(\n                FIELD_BASE,\n                label !== undefined && FIELD_FLOATING_PAD,\n                \"pe-9\",\n                field.isInvalid && FIELD_INVALID,\n              )}\n            />\n            {showClear ? (\n              <button\n                type=\"button\"\n                // Out of the tab order, like the clear on `EntityCombobox`: the keyboard\n                // already clears this field by selecting its text and deleting, and a\n                // second stop between every picker and the next field is a worse trade\n                // than the one gesture it saves.\n                tabIndex={-1}\n                aria-label={labels.clear}\n                // preventDefault, exactly as the chevron does: without it the press\n                // focuses the input, which on a phone opens the sheet over the field the\n                // press was clearing.\n                onMouseDown={(e) => e.preventDefault()}\n                onClick={() => {\n                  setText(null);\n                  close();\n                  if (!locked) onChange(clearValue);\n                }}\n                className={cn(\n                  \"absolute end-2 top-1/2 -translate-y-1/2 rounded p-0.5 text-placeholder\",\n                  \"hover:text-secondary\",\n                )}\n              >\n                <X aria-hidden className=\"size-4\" />\n              </button>\n            ) : (\n              <ChevronDown\n                aria-hidden\n                onMouseDown={(e) => {\n                  // Toggle on the chevron without stealing focus from the input — and\n                  // not at all on a disabled or locked field, which the input's own\n                  // `disabled`/`readOnly` does not stop from here.\n                  e.preventDefault();\n                  if (!inert) setOpen((o) => !o);\n                }}\n                className={cn(\n                  \"absolute end-2.5 top-1/2 size-4 -translate-y-1/2 text-placeholder\",\n                  // The box above does the dimming; dimming here too would halve it again.\n                  !inert && \"cursor-pointer\",\n                )}\n              />\n            )}\n          </div>,\n        )}\n      </EndHintRow>\n      {label !== undefined && hintParts.labelHint !== undefined && (\n        <StaticLabelRow hint={hintParts.labelHint}>\n          <ComboboxFieldLabel htmlFor={fieldId} className={cn(LABEL_IN_ROW, inert && \"opacity-50\")}>\n            {label}\n          </ComboboxFieldLabel>\n        </StaticLabelRow>\n      )}\n      <FieldCaption parts={hintParts} />\n      {field.errorEl}\n      {isPhone && (\n        <PickerSheet\n          open={open && !inert}\n          // Closing without choosing keeps the value: `text` was never emptied, so\n          // reconcile has nothing to undo — it just puts the label back.\n          onClose={reconcile}\n          title={sheetTitle ?? label}\n          query={sheetQuery}\n          onQueryChange={(v) => {\n            setSheetQuery(v);\n            setActive(-1);\n          }}\n          searchPlaceholder={searchPlaceholder ?? placeholder ?? labels.search}\n          inputRef={sheetInputRef}\n          closeLabel={closeLabel}\n        >\n          <ul id={listboxId} role=\"listbox\">\n            {matches.map((o, i) => (\n              // Keyed by group AND value, like combobox-core.tsx: an option may\n              // deliberately appear twice (see `reconcile`), and a bare value key\n              // would collide.\n              <Fragment key={`${o.group ?? \"\"}|${String(o.value)}`}>\n                {o.group && o.group !== matches[i - 1]?.group && (\n                  <li\n                    role=\"presentation\"\n                    className={cn(\n                      GROUP_HEADING_STICKY,\n                      \"px-4 pb-0.5 pt-3 text-caption font-semibold uppercase tracking-wide text-muted\",\n                    )}\n                  >\n                    {o.group}\n                  </li>\n                )}\n                <li role=\"presentation\">\n                  <button\n                    type=\"button\"\n                    role=\"option\"\n                    aria-selected={o.value === value}\n                    aria-disabled={o.disabled || undefined}\n                    onClick={() => take(o)}\n                    className={cn(\n                      SHEET_ROW_CLASS,\n                      o.value === value && \"font-medium\",\n                      o.disabled && DISABLED_ROW_CLASS,\n                    )}\n                  >\n                    {o.label}\n                  </button>\n                </li>\n              </Fragment>\n            ))}\n            {showCreate && (\n              <li role=\"presentation\">\n                <button\n                  type=\"button\"\n                  role=\"option\"\n                  // An action, never chosen — see `onCreate`.\n                  aria-selected={false}\n                  aria-disabled={createLocked || undefined}\n                  onClick={create}\n                  className={cn(\n                    SHEET_ROW_CLASS,\n                    CREATE_ROW_CLASS,\n                    createLocked && DISABLED_ROW_CLASS,\n                  )}\n                >\n                  {createRowContent}\n                </button>\n              </li>\n            )}\n            {/* \"Nothing matched\" only when there is nothing to do either: with a create\n                row the list is not empty, it is offering to fill itself. */}\n            {matches.length === 0 && !showCreate && (\n              <li className=\"px-4 py-3 text-sm text-muted\">{labels.noResults}</li>\n            )}\n          </ul>\n        </PickerSheet>\n      )}\n      {showing && (\n        <SuggestionList id={listboxId} anchorRef={fieldRef} panelRef={panelRef}>\n          {matches.map((o, i) => (\n            // A group heading is emitted at each group boundary rather than repeating\n            // the group on every row (feedback #136). `matches` is group-contiguous,\n            // so comparing with the previous row is enough. Fragment key sits here;\n            // the heading and the option carry their own list semantics — keyed by\n            // group AND value, because an option may deliberately appear twice (see\n            // `reconcile`).\n            <Fragment key={`${o.group ?? \"\"}|${String(o.value)}`}>\n              {o.group && o.group !== matches[i - 1]?.group && (\n                <li\n                  role=\"presentation\"\n                  className={cn(\n                    GROUP_HEADING_STICKY,\n                    \"px-3 pb-0.5 pt-2 text-caption font-semibold uppercase tracking-wide text-muted first:pt-1\",\n                  )}\n                >\n                  {o.group}\n                </li>\n              )}\n              <li role=\"presentation\">\n                <button\n                  type=\"button\"\n                  id={optionId(i)}\n                  // See {@link Combobox}: the role rides the button, `aria-selected`\n                  // is the CHOSEN row, and the keyboard's row is the field's\n                  // `aria-activedescendant`.\n                  role=\"option\"\n                  aria-selected={o.value === value}\n                  aria-disabled={o.disabled || undefined}\n                  tabIndex={-1}\n                  onMouseDown={(e) => {\n                    // mousedown (not click) so the input's blur can't close the\n                    // list before the selection registers. Prevented on a disabled\n                    // row too, so pressing one leaves the field focused and open.\n                    e.preventDefault();\n                    take(o);\n                  }}\n                  onMouseEnter={() => {\n                    if (!o.disabled) setActive(i);\n                  }}\n                  className={cn(\n                    rowClass(i === active && !o.disabled),\n                    o.disabled && DISABLED_ROW_CLASS,\n                    // Indented under its heading, so the hierarchy is readable at a\n                    // glance instead of inferred from grey trailing text.\n                    o.group && \"ps-6\",\n                    o.value === value && \"font-medium\",\n                  )}\n                >\n                  {o.label}\n                  {o.sublabel && (\n                    <span className=\"ms-2 text-xs text-placeholder\">\n                      {o.sublabel}\n                    </span>\n                  )}\n                </button>\n              </li>\n            </Fragment>\n          ))}\n          {showCreate && (\n            <li role=\"presentation\">\n              <button\n                type=\"button\"\n                id={optionId(createIndex)}\n                role=\"option\"\n                // An action, never chosen; whether the keyboard is ON it is the field's\n                // `aria-activedescendant`'s to say.\n                aria-selected={false}\n                aria-disabled={createLocked || undefined}\n                tabIndex={-1}\n                onMouseDown={(e) => {\n                  // mousedown, like the rows above: the input's blur would otherwise\n                  // reconcile and close the list before the click landed.\n                  e.preventDefault();\n                  create();\n                }}\n                onMouseEnter={() => {\n                  if (!createLocked) setActive(createIndex);\n                }}\n                className={cn(\n                  rowClass(active === createIndex && !createLocked),\n                  CREATE_ROW_CLASS,\n                  createLocked && DISABLED_ROW_CLASS,\n                )}\n              >\n                {createRowContent}\n              </button>\n            </li>\n          )}\n        </SuggestionList>\n      )}\n    </div>\n  );\n}\n"],"mappings":"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","names":["Fragment","rest"]}

package/dist/components/picker-sheet.d.ts

@@ -31,6 +31,23 @@ export interface PickerSheetProps extends Omit<ComponentPropsWithoutRef<"div">,
     /** The option the arrow keys are on, for the search box's `aria-activedescendant`. */
     activeId?: string;
     children: ReactNode;
+    /**
+     * A row pinned under the scrolling list — {@link FullBleedDialog}'s `footer`, on the
+     * picker's sheet (kk run 79 gap 2). Outside the scroller, so it stays put however long
+     * the list; padded for the home indicator, since it is the sheet's bottom edge.
+     */
+    footer?: ReactNode;
+    /**
+     * The kit's one sticky "Done" at the foot of the sheet (Marcel, keksdose #412): the
+     * button a multi-select sheet is left by once its rows are ticked. Ticks apply as
+     * they are made, so it closes (`onClose`) rather than saves. After any `footer`.
+     * {@link ComboboxPanel} turns it on for every `multi` list — `MultiSelect` and
+     * `MultiEntityCombobox` — and a single-select sheet, which closes on the tap that
+     * picks, has no use for it. Label: `pickerSheet.done`, else "Done" (`doneLabel`).
+     */
+    done?: boolean;
+    /** Default: `pickerSheet.done` from the {@link UiKitProvider}, else "Done". */
+    doneLabel?: string;
     /** The sheet, where the rest of the props go (0.34, API-2, refactor audit 2026-10) —
      *  merged with the sheet's own ref, which its focus trap holds. */
     ref?: Ref<HTMLDivElement>;
@@ -58,7 +75,7 @@ export interface PickerSheetProps extends Omit<ComponentPropsWithoutRef<"div">,
  * scrolls, the header does not, and the body behind it is scroll-locked so a drag
  * that overshoots the list does not move the page underneath.
  */
-export declare function PickerSheet({ open, onClose, title, query, onQueryChange, searchPlaceholder, searchLabel, inputRef, closeLabel, onSearchKeyDown, listboxId, activeId, children, "aria-label": ariaLabel, className, style, ref, ...rest }: PickerSheetProps): import("react").ReactPortal | null;
+export declare function PickerSheet({ open, onClose, title, query, onQueryChange, searchPlaceholder, searchLabel, inputRef, closeLabel, onSearchKeyDown, listboxId, activeId, children, footer, done, doneLabel, "aria-label": ariaLabel, className, style, ref, ...rest }: PickerSheetProps): import("react").ReactPortal | null;
 /** A row inside a {@link PickerSheet} — the phone-sized version of a dropdown row,
  *  so a list is comfortable to hit with a thumb rather than merely legible. */
 export declare const SHEET_ROW_CLASS: string;

package/dist/components/picker-sheet.js

@@ -7,6 +7,7 @@ import { cn } from "../lib/cn.js";
 import { mergeRefs } from "./field-parts.js";
 import { CLIPS_ATTRIBUTE } from "../lib/clipping.js";
 import { DropdownSearchHeader } from "./dropdown.js";
+import { Button } from "./button.js";
 import { useBodyScrollLock } from "../hooks/use-body-scroll-lock.js";
 import { useOverlayHistory } from "../hooks/use-overlay-history.js";
 import { useFocusTrap } from "../hooks/use-focus-trap.js";
@@ -27,13 +28,17 @@ function PickerSheet({
   listboxId,
   activeId,
   children,
+  footer,
+  done,
+  doneLabel,
   "aria-label": ariaLabel,
   className,
   style,
   ref,
   ...rest
 }) {
-  const labels = useKitLabels("pickerSheet", DEFAULT_PICKER_SHEET_LABELS, { close: closeLabel });
+  const labels = useKitLabels("pickerSheet", DEFAULT_PICKER_SHEET_LABELS, { close: closeLabel, done: doneLabel });
+  const hasFooter = footer !== void 0 && footer !== null && footer !== false || Boolean(done);
   useBodyScrollLock(open);
   useOverlayHistory(open, onClose);
   const vv = useVisualViewport(open);
@@ -95,7 +100,20 @@ function PickerSheet({
               activeId
             }
           ),
-          /* @__PURE__ */ jsx("div", { ...{ [CLIPS_ATTRIBUTE]: "" }, className: "min-h-0 flex-1 overflow-y-auto overscroll-contain", children })
+          /* @__PURE__ */ jsx("div", { ...{ [CLIPS_ATTRIBUTE]: "" }, className: "min-h-0 flex-1 overflow-y-auto overscroll-contain", children }),
+          hasFooter && /* @__PURE__ */ jsxs(
+            "div",
+            {
+              "data-picker-sheet-footer": "",
+              className: "flex shrink-0 flex-wrap items-center justify-end gap-2 border-t border-subtle bg-surface px-3 pt-3",
+              style: { paddingBottom: "max(0.75rem, env(safe-area-inset-bottom))" },
+              children: [
+                footer,
+                done && // Full width: the one thing left to do on the sheet, under the thumb.
+                /* @__PURE__ */ jsx(Button, { type: "button", className: "flex-1", onClick: onClose, children: labels.done })
+              ]
+            }
+          )
         ]
       }
     ),

package/dist/components/picker-sheet.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/picker-sheet.tsx"],"sourcesContent":["import { useMemo, useRef } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { X } from \"lucide-react\";\nimport type { ComponentPropsWithoutRef, KeyboardEvent, ReactNode, Ref, RefObject } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { mergeRefs } from \"./field-parts\";\nimport { CLIPS_ATTRIBUTE } from \"../lib/clipping\";\nimport { DropdownSearchHeader } from \"./dropdown\";\nimport { useBodyScrollLock } from \"../hooks/use-body-scroll-lock\";\nimport { useOverlayHistory } from \"../hooks/use-overlay-history\";\nimport { useFocusTrap } from \"../hooks/use-focus-trap\";\nimport { takeEscape, useDismissLayer } from \"../hooks/use-dismiss\";\nimport { useVisualViewport } from \"../hooks/use-anchored-panel\";\nimport { DEFAULT_PICKER_SHEET_LABELS, useKitLabels } from \"../i18n/kit-labels\";\n\n/**\n * Two of the div's own attributes are omitted because this component already owns\n * the name: `title` here is the sheet's HEADING (and a ReactNode), not the browser's\n * tooltip string, and `onClose` is \"the sheet was dismissed\", not the DOM's\n * `<dialog>` close event. Everything else a caller can pass reaches the sheet.\n */\nexport interface PickerSheetProps\n  extends Omit<ComponentPropsWithoutRef<\"div\">, \"title\" | \"onClose\"> {\n  open: boolean;\n  onClose: () => void;\n  /** The field's own label — a sheet that fills the screen has to say what it is\n   *  asking for, which the anchored panel got for free by sitting under it. */\n  title?: ReactNode;\n  query: string;\n  onQueryChange: (value: string) => void;\n  searchPlaceholder?: string;\n  /** The search box's accessible name. Default: `searchPlaceholder` — a placeholder is\n   *  gone the moment a character is typed, and is no name to many readers at all. */\n  searchLabel?: string;\n  inputRef?: RefObject<HTMLInputElement | null>;\n  /** Default: `pickerSheet.close` from the {@link UiKitProvider}, else \"Close\". */\n  closeLabel?: string;\n  /**\n   * The list's keyboard, on the search box — where focus is while the sheet is up:\n   * Up/Down/Home/End/Enter (round 0.34 Wave 2, BUG-5). `ComboboxPanel` passes its own;\n   * without it arrows and Enter in the sheet did nothing at all.\n   */\n  onSearchKeyDown?: (e: KeyboardEvent<HTMLInputElement>) => void;\n  /** The `role=\"listbox\"` the search box filters, for its `aria-controls`. */\n  listboxId?: string;\n  /** The option the arrow keys are on, for the search box's `aria-activedescendant`. */\n  activeId?: string;\n  children: ReactNode;\n  /** The sheet, where the rest of the props go (0.34, API-2, refactor audit 2026-10) —\n   *  merged with the sheet's own ref, which its focus trap holds. */\n  ref?: Ref<HTMLDivElement>;\n}\n\n/**\n * The PHONE presentation of a picker: a full-screen dialog with a search box at\n * the top and the list filling everything below it (Keksdose live #200).\n *\n * *\"Paid as full screen dialog with input. Similar to the account select that\n * already appears as full screen.\"* The account field is a native `<select>`, and\n * a phone browser renders that as a full-screen list — so the app's own pickers,\n * which are anchored dropdown panels, were the odd ones out: a 320px-tall panel\n * squeezed between the field and the keyboard, showing three or four rows of a\n * list that might have two hundred entries.\n *\n * What this fixes beyond size: the panel had to be *placed* (above/below, tracking\n * the visual viewport as the keyboard opened — see `useAnchoredPanel`), and every\n * one of those decisions is a chance to be wrong on a screen this small. A sheet\n * has no placement. It also gives the search input somewhere unambiguous to live,\n * which is the other half of the request: *\"add filler possibility to the account\n * select or even better right to the hoc the account select is derived from\"* —\n * so this lives in the shared picker, not in one form's copy of it.\n *\n * Rows are `min-h-11` (44px): the touch target the rest of the app uses. The list\n * scrolls, the header does not, and the body behind it is scroll-locked so a drag\n * that overshoots the list does not move the page underneath.\n */\nexport function PickerSheet({\n  open,\n  onClose,\n  title,\n  query,\n  onQueryChange,\n  searchPlaceholder,\n  searchLabel,\n  inputRef,\n  closeLabel,\n  onSearchKeyDown,\n  listboxId,\n  activeId,\n  children,\n  \"aria-label\": ariaLabel,\n  className,\n  style,\n  ref,\n  ...rest\n}: PickerSheetProps) {\n  // Every picker in the kit opens one of these on a phone, and most of them pass\n  // their own `closeLabel` through as `undefined` — so this lookup is what makes the\n  // one way out of a full-screen sheet speak the app's language without each of\n  // them having to (see the prop's note in `EntityCombobox`).\n  const labels = useKitLabels(\"pickerSheet\", DEFAULT_PICKER_SHEET_LABELS, { close: closeLabel });\n  useBodyScrollLock(open);\n  /**\n   * Back closes THE SHEET, not the dialog it was opened from (Keksdose live #309:\n   * *\"Mouse Back does not only close the select but also the whole edit or create\n   * dialog which is cumbersome.\"*).\n   *\n   * The sheet is a full-screen overlay over whatever opened it, and on a phone that\n   * is almost always the row editor — which DOES push a history entry\n   * (`data-table.tsx`). So the sheet was invisible to Back: one press popped the\n   * editor's entry and took the whole dialog with it, discarding an edit in progress\n   * in order to dismiss a list.\n   *\n   * `useOverlayHistory` was built for exactly this nesting — its stack unwinds\n   * last-in-first-out, and the U-12 regression test in its own suite is written\n   * around \"a Modal and a PickerSheet inside it\". The sheet simply never called it.\n   *\n   * Nothing else has to change: the hook is a no-op while `open` is false, and it\n   * pops its own entry when the sheet closes some other way (the X, a row, the\n   * backdrop) so history does not accumulate husks.\n   */\n  useOverlayHistory(open, onClose);\n  // The visible region, while the sheet is up — see the `style` below for why a\n  // full-screen sheet cannot simply be `inset-0` on a phone (live #328).\n  const vv = useVisualViewport(open);\n  // A fallback ref so a caller that does not need the handle still gets the opening\n  // focus, rather than the behaviour depending on whether a prop was passed. What that\n  // focus is FOR is on the trap below.\n  const ownRef = useRef<HTMLInputElement | null>(null);\n  const searchRef = inputRef ?? ownRef;\n\n  const sheetRef = useRef<HTMLDivElement>(null);\n  const setSheet = useMemo(() => mergeRefs(sheetRef, ref), [ref]);\n  /**\n   * The sheet said `aria-modal=\"true\"` and then left focus on the field behind it, so\n   * a screen reader was told to hide the page the user's cursor was still standing in\n   * (the audit's *\"Only Modal manages focus\"*). Through the shared hook rather than\n   * the bare `.focus()` that used to live here: the hook re-reads the tabbable list on\n   * every Tab, which this panel needs more than most — its list is filtered as you\n   * type, so the rows a trap captured at open time are gone by the second keystroke.\n   *\n   * **`initialFocus` is the search box**, not the container, and this is the one place\n   * in the package that overrides `Modal`'s rule. The sheet exists in order to be typed\n   * into (live #212: *\"make the text input filter active on select click\"*), and the\n   * callers cannot do it themselves — `Combobox`'s field runs\n   * `setOpen(true); sheetInputRef.current?.focus()` in a single `onFocus`, so the focus\n   * call happens while this sheet is still unmounted and the ref is null. Only the\n   * sheet knows when its own input exists. Popping the keyboard is the POINT here,\n   * where in a form dialog it is the cost.\n   *\n   * **`restoreFocus` is off**, which is the uncomfortable half. Every caller in this\n   * kit opens the sheet from the field's own `onFocus` handler, so handing focus back\n   * to that field on close re-opens the sheet the user has just dismissed — a row tap\n   * would select a value and immediately put the list back over it. The field that\n   * opened it is the only thing that knows whether re-focusing it means \"open\"; a sheet\n   * that cannot tell must not guess. The cost is that focus lands on `<body>` after a\n   * dismissal, which on the phone this shape is for costs nothing, and on a pointer\n   * device is what happened before this change too.\n   */\n  useFocusTrap(sheetRef, {\n    active: open,\n    restoreFocus: false,\n    initialFocus: () => searchRef.current,\n  });\n\n  // The sheet is almost always the INNERMOST overlay — it opens from a field inside a\n  // `Modal` or a `FullBleedDialog`. It is a layer on the Escape stack (Wave 2, DUP-1),\n  // above the dialog, and takes the key on its own element: one press dismissing this\n  // list and the dialog underneath with it was Keksdose live #309 (*\"Mouse Back does\n  // not only close the select but also the whole edit or create dialog which is\n  // cumbersome\"*), which the Back gesture already learned, on the key a desktop user\n  // reaches for instead.\n  useDismissLayer(open, onClose);\n  const handleKeyDown = (e: KeyboardEvent<HTMLDivElement>) => {\n    takeEscape(e);\n  };\n\n  if (!open || typeof document === \"undefined\") return null;\n  return createPortal(\n    /* eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- the dialog\n       container, per the APG dialog pattern: `onKeyDown` is Escape-to-close for whatever\n       inside it holds focus, and `onMouseDown` only stops propagation (live #328). */\n    <div\n      // Spread FIRST, and every attribute below it deliberately wins: `style`,\n      // `onMouseDown` and `onKeyDown` here are not styling choices, they are live\n      // #328, dev#477 and live #309 respectively, and a caller who passed one by\n      // accident would re-open a bug three apps have already paid for. `style` is\n      // MERGED rather than won outright (see below), which is the one case where a\n      // caller has something to add.\n      {...rest}\n      ref={setSheet}\n      role=\"dialog\"\n      aria-modal=\"true\"\n      // Without it the container cannot take focus, and `useFocusTrap` has nothing to\n      // fall back to when the list is empty and the search box is the only thing in\n      // here — see the hook's \"nothing tabbable\" branch.\n      tabIndex={-1}\n      onKeyDown={handleKeyDown}\n      // The caller's own name wins over the heading: a sheet titled \"Account\" in a\n      // form with two of them needs to say WHICH, and `title` is what the user reads\n      // rather than what a reader announces.\n      aria-label={ariaLabel ?? (typeof title === \"string\" ? title : undefined)}\n      // The sheet is PORTALLED to <body>, so it is not inside the field's own\n      // wrapper — and `useDropdown` closes on any document mousedown landing\n      // outside that wrapper. Tapping a row therefore unmounted the row (open →\n      // false) before its CLICK could fire, so the tap selected nothing at all and\n      // the sheet just vanished (Keksdose dev#477).\n      //\n      // It bit whichever sheet commits on `onClick` — the payee field's, since live\n      // #200, where it hid behind the free-text value the search box was already\n      // setting; and the account field's the moment dev#477 moved it onto the inline\n      // picker. `ComboboxPanel`'s rows happen to commit on `onMouseDown`, so they\n      // beat the document listener and were never affected — which is luck, not a\n      // design, and exactly why the fix belongs to the sheet.\n      //\n      // Stopping the mousedown here rather than teaching every caller about the\n      // portal: the sheet is modal and full-screen, so \"a click in here is not an\n      // outside click\" is a property of the sheet, not of whoever opened it.\n      onMouseDown={(e) => e.stopPropagation()}\n      // ⚠️ `inset-0` was the whole of Keksdose live #328: *\"When the keyboard overlays\n      // the entries I cannot scroll past them … to see also the last entries. Happens\n      // when browsing the account select.\"*\n      //\n      // This sheet FOCUSES ITS OWN SEARCH BOX on open (see above), so the keyboard is\n      // up every single time it is used on a phone. On Android that shrinks the visual\n      // viewport and leaves the LAYOUT viewport alone — `inset-0` is the layout\n      // viewport — so the sheet kept its full height with its bottom third behind the\n      // keyboard. The list below is `flex-1 overflow-y-auto`, so it sized itself to\n      // that hidden height too: it scrolled to ITS end while the last rows were still\n      // under the keys, and no gesture could bring them out. Nothing was clipped and\n      // nothing looked broken, which is why it reads as \"I cannot scroll past them\".\n      //\n      // `visualViewport` is the API that answers rather than hints (the live #292\n      // lesson): it reports the region actually on screen, keyboard and pinch-pan\n      // included, and it fires on the keyboard opening and closing. Pinned to that box,\n      // the sheet ends where the keys begin and the list's own scroll covers the rest.\n      // `useVisualViewport` returns null when there is nothing to correct, and then\n      // this is character-for-character the sheet that was here before.\n      // A caller's `style` is kept and the correction laid OVER it: the three values\n      // below are the whole of live #328, so they are not negotiable, but a z-index\n      // or a transition from outside has nothing to do with them. Without a visual\n      // viewport to correct for this is character-for-character what the caller passed.\n      style={vv ? { ...style, top: vv.top, height: vv.height, bottom: \"auto\" } : style}\n      className={cn(\"fixed inset-0 z-50 flex flex-col bg-surface outline-none\", className)}\n    >\n      <div className=\"flex items-center gap-2 border-b border-subtle px-3 py-2\">\n        <span className=\"min-w-0 flex-1 truncate text-sm font-semibold text-primary\">\n          {title}\n        </span>\n        <button\n          type=\"button\"\n          aria-label={labels.close}\n          onClick={onClose}\n          className=\"rounded p-1.5 text-muted hover:bg-hover\"\n        >\n          <X className=\"size-5\" />\n        </button>\n      </div>\n      <DropdownSearchHeader\n        query={query}\n        onQueryChange={onQueryChange}\n        inputRef={searchRef}\n        placeholder={searchPlaceholder}\n        aria-label={searchLabel ?? searchPlaceholder}\n        // Focus is in this box while the sheet is up, so this is where the list's keys\n        // land and what has to name the list and the row the arrows are on (BUG-5).\n        onKeyDown={onSearchKeyDown}\n        listboxId={listboxId}\n        activeId={activeId}\n      />\n      {/* min-h-0 so the LIST scrolls rather than the dialog growing past the\n          viewport — a flex child defaults to min-height:auto. */}\n      {/* Marked as the scroller it is (`CLIPS_ATTRIBUTE`), so a Tooltip in a row —\n          `Combobox`'s `optionAdornment` — portals out under jsdom as it does in the\n          browser rather than joining the option's name (keksdose E8). */}\n      <div {...{ [CLIPS_ATTRIBUTE]: \"\" }} className=\"min-h-0 flex-1 overflow-y-auto overscroll-contain\">\n        {children}\n      </div>\n    </div>,\n    document.body,\n  );\n}\n\n/** A row inside a {@link PickerSheet} — the phone-sized version of a dropdown row,\n *  so a list is comfortable to hit with a thumb rather than merely legible. */\nexport const SHEET_ROW_CLASS = cn(\n  \"flex min-h-11 w-full items-center gap-2 px-4 py-2 text-start text-base\",\n  \"text-primary hover:bg-hover\",\n);\n"],"mappings":";AAqPM,SACE,KADF;AArPN,SAAS,SAAS,cAAc;AAChC,SAAS,oBAAoB;AAC7B,SAAS,SAAS;AAElB,SAAS,UAAU;AACnB,SAAS,iBAAiB;AAC1B,SAAS,uBAAuB;AAChC,SAAS,4BAA4B;AACrC,SAAS,yBAAyB;AAClC,SAAS,yBAAyB;AAClC,SAAS,oBAAoB;AAC7B,SAAS,YAAY,uBAAuB;AAC5C,SAAS,yBAAyB;AAClC,SAAS,6BAA6B,oBAAoB;AA+DnD,SAAS,YAAY;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAqB;AAKnB,QAAM,SAAS,aAAa,eAAe,6BAA6B,EAAE,OAAO,WAAW,CAAC;AAC7F,oBAAkB,IAAI;AAoBtB,oBAAkB,MAAM,OAAO;AAG/B,QAAM,KAAK,kBAAkB,IAAI;AAIjC,QAAM,SAAS,OAAgC,IAAI;AACnD,QAAM,YAAY,YAAY;AAE9B,QAAM,WAAW,OAAuB,IAAI;AAC5C,QAAM,WAAW,QAAQ,MAAM,UAAU,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC;AA2B9D,eAAa,UAAU;AAAA,IACrB,QAAQ;AAAA,IACR,cAAc;AAAA,IACd,cAAc,MAAM,UAAU;AAAA,EAChC,CAAC;AASD,kBAAgB,MAAM,OAAO;AAC7B,QAAM,gBAAgB,CAAC,MAAqC;AAC1D,eAAW,CAAC;AAAA,EACd;AAEA,MAAI,CAAC,QAAQ,OAAO,aAAa,YAAa,QAAO;AACrD,SAAO;AAAA;AAAA;AAAA;AAAA,IAIL;AAAA,MAAC;AAAA;AAAA,QAOE,GAAG;AAAA,QACJ,KAAK;AAAA,QACL,MAAK;AAAA,QACL,cAAW;AAAA,QAIX,UAAU;AAAA,QACV,WAAW;AAAA,QAIX,cAAY,cAAc,OAAO,UAAU,WAAW,QAAQ;AAAA,QAiB9D,aAAa,CAAC,MAAM,EAAE,gBAAgB;AAAA,QAwBtC,OAAO,KAAK,EAAE,GAAG,OAAO,KAAK,GAAG,KAAK,QAAQ,GAAG,QAAQ,QAAQ,OAAO,IAAI;AAAA,QAC3E,WAAW,GAAG,4DAA4D,SAAS;AAAA,QAEnF;AAAA,+BAAC,SAAI,WAAU,4DACb;AAAA,gCAAC,UAAK,WAAU,8DACb,iBACH;AAAA,YACA;AAAA,cAAC;AAAA;AAAA,gBACC,MAAK;AAAA,gBACL,cAAY,OAAO;AAAA,gBACnB,SAAS;AAAA,gBACT,WAAU;AAAA,gBAEV,8BAAC,KAAE,WAAU,UAAS;AAAA;AAAA,YACxB;AAAA,aACF;AAAA,UACA;AAAA,YAAC;AAAA;AAAA,cACC;AAAA,cACA;AAAA,cACA,UAAU;AAAA,cACV,aAAa;AAAA,cACb,cAAY,eAAe;AAAA,cAG3B,WAAW;AAAA,cACX;AAAA,cACA;AAAA;AAAA,UACF;AAAA,UAMA,oBAAC,SAAK,GAAG,EAAE,CAAC,eAAe,GAAG,GAAG,GAAG,WAAU,qDAC3C,UACH;AAAA;AAAA;AAAA,IACF;AAAA,IACA,SAAS;AAAA,EACX;AACF;AAIO,MAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AACF;","names":[]}
+{"version":3,"sources":["../../src/components/picker-sheet.tsx"],"sourcesContent":["import { useMemo, useRef } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { X } from \"lucide-react\";\nimport type { ComponentPropsWithoutRef, KeyboardEvent, ReactNode, Ref, RefObject } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { mergeRefs } from \"./field-parts\";\nimport { CLIPS_ATTRIBUTE } from \"../lib/clipping\";\nimport { DropdownSearchHeader } from \"./dropdown\";\nimport { Button } from \"./button\";\nimport { useBodyScrollLock } from \"../hooks/use-body-scroll-lock\";\nimport { useOverlayHistory } from \"../hooks/use-overlay-history\";\nimport { useFocusTrap } from \"../hooks/use-focus-trap\";\nimport { takeEscape, useDismissLayer } from \"../hooks/use-dismiss\";\nimport { useVisualViewport } from \"../hooks/use-anchored-panel\";\nimport { DEFAULT_PICKER_SHEET_LABELS, useKitLabels } from \"../i18n/kit-labels\";\n\n/**\n * Two of the div's own attributes are omitted because this component already owns\n * the name: `title` here is the sheet's HEADING (and a ReactNode), not the browser's\n * tooltip string, and `onClose` is \"the sheet was dismissed\", not the DOM's\n * `<dialog>` close event. Everything else a caller can pass reaches the sheet.\n */\nexport interface PickerSheetProps\n  extends Omit<ComponentPropsWithoutRef<\"div\">, \"title\" | \"onClose\"> {\n  open: boolean;\n  onClose: () => void;\n  /** The field's own label — a sheet that fills the screen has to say what it is\n   *  asking for, which the anchored panel got for free by sitting under it. */\n  title?: ReactNode;\n  query: string;\n  onQueryChange: (value: string) => void;\n  searchPlaceholder?: string;\n  /** The search box's accessible name. Default: `searchPlaceholder` — a placeholder is\n   *  gone the moment a character is typed, and is no name to many readers at all. */\n  searchLabel?: string;\n  inputRef?: RefObject<HTMLInputElement | null>;\n  /** Default: `pickerSheet.close` from the {@link UiKitProvider}, else \"Close\". */\n  closeLabel?: string;\n  /**\n   * The list's keyboard, on the search box — where focus is while the sheet is up:\n   * Up/Down/Home/End/Enter (round 0.34 Wave 2, BUG-5). `ComboboxPanel` passes its own;\n   * without it arrows and Enter in the sheet did nothing at all.\n   */\n  onSearchKeyDown?: (e: KeyboardEvent<HTMLInputElement>) => void;\n  /** The `role=\"listbox\"` the search box filters, for its `aria-controls`. */\n  listboxId?: string;\n  /** The option the arrow keys are on, for the search box's `aria-activedescendant`. */\n  activeId?: string;\n  children: ReactNode;\n  /**\n   * A row pinned under the scrolling list — {@link FullBleedDialog}'s `footer`, on the\n   * picker's sheet (kk run 79 gap 2). Outside the scroller, so it stays put however long\n   * the list; padded for the home indicator, since it is the sheet's bottom edge.\n   */\n  footer?: ReactNode;\n  /**\n   * The kit's one sticky \"Done\" at the foot of the sheet (Marcel, keksdose #412): the\n   * button a multi-select sheet is left by once its rows are ticked. Ticks apply as\n   * they are made, so it closes (`onClose`) rather than saves. After any `footer`.\n   * {@link ComboboxPanel} turns it on for every `multi` list — `MultiSelect` and\n   * `MultiEntityCombobox` — and a single-select sheet, which closes on the tap that\n   * picks, has no use for it. Label: `pickerSheet.done`, else \"Done\" (`doneLabel`).\n   */\n  done?: boolean;\n  /** Default: `pickerSheet.done` from the {@link UiKitProvider}, else \"Done\". */\n  doneLabel?: string;\n  /** The sheet, where the rest of the props go (0.34, API-2, refactor audit 2026-10) —\n   *  merged with the sheet's own ref, which its focus trap holds. */\n  ref?: Ref<HTMLDivElement>;\n}\n\n/**\n * The PHONE presentation of a picker: a full-screen dialog with a search box at\n * the top and the list filling everything below it (Keksdose live #200).\n *\n * *\"Paid as full screen dialog with input. Similar to the account select that\n * already appears as full screen.\"* The account field is a native `<select>`, and\n * a phone browser renders that as a full-screen list — so the app's own pickers,\n * which are anchored dropdown panels, were the odd ones out: a 320px-tall panel\n * squeezed between the field and the keyboard, showing three or four rows of a\n * list that might have two hundred entries.\n *\n * What this fixes beyond size: the panel had to be *placed* (above/below, tracking\n * the visual viewport as the keyboard opened — see `useAnchoredPanel`), and every\n * one of those decisions is a chance to be wrong on a screen this small. A sheet\n * has no placement. It also gives the search input somewhere unambiguous to live,\n * which is the other half of the request: *\"add filler possibility to the account\n * select or even better right to the hoc the account select is derived from\"* —\n * so this lives in the shared picker, not in one form's copy of it.\n *\n * Rows are `min-h-11` (44px): the touch target the rest of the app uses. The list\n * scrolls, the header does not, and the body behind it is scroll-locked so a drag\n * that overshoots the list does not move the page underneath.\n */\nexport function PickerSheet({\n  open,\n  onClose,\n  title,\n  query,\n  onQueryChange,\n  searchPlaceholder,\n  searchLabel,\n  inputRef,\n  closeLabel,\n  onSearchKeyDown,\n  listboxId,\n  activeId,\n  children,\n  footer,\n  done,\n  doneLabel,\n  \"aria-label\": ariaLabel,\n  className,\n  style,\n  ref,\n  ...rest\n}: PickerSheetProps) {\n  // Every picker in the kit opens one of these on a phone, and most of them pass\n  // their own `closeLabel` through as `undefined` — so this lookup is what makes the\n  // one way out of a full-screen sheet speak the app's language without each of\n  // them having to (see the prop's note in `EntityCombobox`).\n  const labels = useKitLabels(\"pickerSheet\", DEFAULT_PICKER_SHEET_LABELS, { close: closeLabel, done: doneLabel });\n  const hasFooter = (footer !== undefined && footer !== null && footer !== false) || Boolean(done);\n  useBodyScrollLock(open);\n  /**\n   * Back closes THE SHEET, not the dialog it was opened from (Keksdose live #309:\n   * *\"Mouse Back does not only close the select but also the whole edit or create\n   * dialog which is cumbersome.\"*).\n   *\n   * The sheet is a full-screen overlay over whatever opened it, and on a phone that\n   * is almost always the row editor — which DOES push a history entry\n   * (`data-table.tsx`). So the sheet was invisible to Back: one press popped the\n   * editor's entry and took the whole dialog with it, discarding an edit in progress\n   * in order to dismiss a list.\n   *\n   * `useOverlayHistory` was built for exactly this nesting — its stack unwinds\n   * last-in-first-out, and the U-12 regression test in its own suite is written\n   * around \"a Modal and a PickerSheet inside it\". The sheet simply never called it.\n   *\n   * Nothing else has to change: the hook is a no-op while `open` is false, and it\n   * pops its own entry when the sheet closes some other way (the X, a row, the\n   * backdrop) so history does not accumulate husks.\n   */\n  useOverlayHistory(open, onClose);\n  // The visible region, while the sheet is up — see the `style` below for why a\n  // full-screen sheet cannot simply be `inset-0` on a phone (live #328).\n  const vv = useVisualViewport(open);\n  // A fallback ref so a caller that does not need the handle still gets the opening\n  // focus, rather than the behaviour depending on whether a prop was passed. What that\n  // focus is FOR is on the trap below.\n  const ownRef = useRef<HTMLInputElement | null>(null);\n  const searchRef = inputRef ?? ownRef;\n\n  const sheetRef = useRef<HTMLDivElement>(null);\n  const setSheet = useMemo(() => mergeRefs(sheetRef, ref), [ref]);\n  /**\n   * The sheet said `aria-modal=\"true\"` and then left focus on the field behind it, so\n   * a screen reader was told to hide the page the user's cursor was still standing in\n   * (the audit's *\"Only Modal manages focus\"*). Through the shared hook rather than\n   * the bare `.focus()` that used to live here: the hook re-reads the tabbable list on\n   * every Tab, which this panel needs more than most — its list is filtered as you\n   * type, so the rows a trap captured at open time are gone by the second keystroke.\n   *\n   * **`initialFocus` is the search box**, not the container, and this is the one place\n   * in the package that overrides `Modal`'s rule. The sheet exists in order to be typed\n   * into (live #212: *\"make the text input filter active on select click\"*), and the\n   * callers cannot do it themselves — `Combobox`'s field runs\n   * `setOpen(true); sheetInputRef.current?.focus()` in a single `onFocus`, so the focus\n   * call happens while this sheet is still unmounted and the ref is null. Only the\n   * sheet knows when its own input exists. Popping the keyboard is the POINT here,\n   * where in a form dialog it is the cost.\n   *\n   * **`restoreFocus` is off**, which is the uncomfortable half. Every caller in this\n   * kit opens the sheet from the field's own `onFocus` handler, so handing focus back\n   * to that field on close re-opens the sheet the user has just dismissed — a row tap\n   * would select a value and immediately put the list back over it. The field that\n   * opened it is the only thing that knows whether re-focusing it means \"open\"; a sheet\n   * that cannot tell must not guess. The cost is that focus lands on `<body>` after a\n   * dismissal, which on the phone this shape is for costs nothing, and on a pointer\n   * device is what happened before this change too.\n   */\n  useFocusTrap(sheetRef, {\n    active: open,\n    restoreFocus: false,\n    initialFocus: () => searchRef.current,\n  });\n\n  // The sheet is almost always the INNERMOST overlay — it opens from a field inside a\n  // `Modal` or a `FullBleedDialog`. It is a layer on the Escape stack (Wave 2, DUP-1),\n  // above the dialog, and takes the key on its own element: one press dismissing this\n  // list and the dialog underneath with it was Keksdose live #309 (*\"Mouse Back does\n  // not only close the select but also the whole edit or create dialog which is\n  // cumbersome\"*), which the Back gesture already learned, on the key a desktop user\n  // reaches for instead.\n  useDismissLayer(open, onClose);\n  const handleKeyDown = (e: KeyboardEvent<HTMLDivElement>) => {\n    takeEscape(e);\n  };\n\n  if (!open || typeof document === \"undefined\") return null;\n  return createPortal(\n    /* eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- the dialog\n       container, per the APG dialog pattern: `onKeyDown` is Escape-to-close for whatever\n       inside it holds focus, and `onMouseDown` only stops propagation (live #328). */\n    <div\n      // Spread FIRST, and every attribute below it deliberately wins: `style`,\n      // `onMouseDown` and `onKeyDown` here are not styling choices, they are live\n      // #328, dev#477 and live #309 respectively, and a caller who passed one by\n      // accident would re-open a bug three apps have already paid for. `style` is\n      // MERGED rather than won outright (see below), which is the one case where a\n      // caller has something to add.\n      {...rest}\n      ref={setSheet}\n      role=\"dialog\"\n      aria-modal=\"true\"\n      // Without it the container cannot take focus, and `useFocusTrap` has nothing to\n      // fall back to when the list is empty and the search box is the only thing in\n      // here — see the hook's \"nothing tabbable\" branch.\n      tabIndex={-1}\n      onKeyDown={handleKeyDown}\n      // The caller's own name wins over the heading: a sheet titled \"Account\" in a\n      // form with two of them needs to say WHICH, and `title` is what the user reads\n      // rather than what a reader announces.\n      aria-label={ariaLabel ?? (typeof title === \"string\" ? title : undefined)}\n      // The sheet is PORTALLED to <body>, so it is not inside the field's own\n      // wrapper — and `useDropdown` closes on any document mousedown landing\n      // outside that wrapper. Tapping a row therefore unmounted the row (open →\n      // false) before its CLICK could fire, so the tap selected nothing at all and\n      // the sheet just vanished (Keksdose dev#477).\n      //\n      // It bit whichever sheet commits on `onClick` — the payee field's, since live\n      // #200, where it hid behind the free-text value the search box was already\n      // setting; and the account field's the moment dev#477 moved it onto the inline\n      // picker. `ComboboxPanel`'s rows happen to commit on `onMouseDown`, so they\n      // beat the document listener and were never affected — which is luck, not a\n      // design, and exactly why the fix belongs to the sheet.\n      //\n      // Stopping the mousedown here rather than teaching every caller about the\n      // portal: the sheet is modal and full-screen, so \"a click in here is not an\n      // outside click\" is a property of the sheet, not of whoever opened it.\n      onMouseDown={(e) => e.stopPropagation()}\n      // ⚠️ `inset-0` was the whole of Keksdose live #328: *\"When the keyboard overlays\n      // the entries I cannot scroll past them … to see also the last entries. Happens\n      // when browsing the account select.\"*\n      //\n      // This sheet FOCUSES ITS OWN SEARCH BOX on open (see above), so the keyboard is\n      // up every single time it is used on a phone. On Android that shrinks the visual\n      // viewport and leaves the LAYOUT viewport alone — `inset-0` is the layout\n      // viewport — so the sheet kept its full height with its bottom third behind the\n      // keyboard. The list below is `flex-1 overflow-y-auto`, so it sized itself to\n      // that hidden height too: it scrolled to ITS end while the last rows were still\n      // under the keys, and no gesture could bring them out. Nothing was clipped and\n      // nothing looked broken, which is why it reads as \"I cannot scroll past them\".\n      //\n      // `visualViewport` is the API that answers rather than hints (the live #292\n      // lesson): it reports the region actually on screen, keyboard and pinch-pan\n      // included, and it fires on the keyboard opening and closing. Pinned to that box,\n      // the sheet ends where the keys begin and the list's own scroll covers the rest.\n      // `useVisualViewport` returns null when there is nothing to correct, and then\n      // this is character-for-character the sheet that was here before.\n      // A caller's `style` is kept and the correction laid OVER it: the three values\n      // below are the whole of live #328, so they are not negotiable, but a z-index\n      // or a transition from outside has nothing to do with them. Without a visual\n      // viewport to correct for this is character-for-character what the caller passed.\n      style={vv ? { ...style, top: vv.top, height: vv.height, bottom: \"auto\" } : style}\n      className={cn(\"fixed inset-0 z-50 flex flex-col bg-surface outline-none\", className)}\n    >\n      <div className=\"flex items-center gap-2 border-b border-subtle px-3 py-2\">\n        <span className=\"min-w-0 flex-1 truncate text-sm font-semibold text-primary\">\n          {title}\n        </span>\n        <button\n          type=\"button\"\n          aria-label={labels.close}\n          onClick={onClose}\n          className=\"rounded p-1.5 text-muted hover:bg-hover\"\n        >\n          <X className=\"size-5\" />\n        </button>\n      </div>\n      <DropdownSearchHeader\n        query={query}\n        onQueryChange={onQueryChange}\n        inputRef={searchRef}\n        placeholder={searchPlaceholder}\n        aria-label={searchLabel ?? searchPlaceholder}\n        // Focus is in this box while the sheet is up, so this is where the list's keys\n        // land and what has to name the list and the row the arrows are on (BUG-5).\n        onKeyDown={onSearchKeyDown}\n        listboxId={listboxId}\n        activeId={activeId}\n      />\n      {/* min-h-0 so the LIST scrolls rather than the dialog growing past the\n          viewport — a flex child defaults to min-height:auto. */}\n      {/* Marked as the scroller it is (`CLIPS_ATTRIBUTE`), so a Tooltip in a row —\n          `Combobox`'s `optionAdornment` — portals out under jsdom as it does in the\n          browser rather than joining the option's name (keksdose E8). */}\n      <div {...{ [CLIPS_ATTRIBUTE]: \"\" }} className=\"min-h-0 flex-1 overflow-y-auto overscroll-contain\">\n        {children}\n      </div>\n      {hasFooter && (\n        <div\n          data-picker-sheet-footer=\"\"\n          className=\"flex shrink-0 flex-wrap items-center justify-end gap-2 border-t border-subtle bg-surface px-3 pt-3\"\n          style={{ paddingBottom: \"max(0.75rem, env(safe-area-inset-bottom))\" }}\n        >\n          {footer}\n          {done && (\n            // Full width: the one thing left to do on the sheet, under the thumb.\n            <Button type=\"button\" className=\"flex-1\" onClick={onClose}>\n              {labels.done}\n            </Button>\n          )}\n        </div>\n      )}\n    </div>,\n    document.body,\n  );\n}\n\n/** A row inside a {@link PickerSheet} — the phone-sized version of a dropdown row,\n *  so a list is comfortable to hit with a thumb rather than merely legible. */\nexport const SHEET_ROW_CLASS = cn(\n  \"flex min-h-11 w-full items-center gap-2 px-4 py-2 text-start text-base\",\n  \"text-primary hover:bg-hover\",\n);\n"],"mappings":"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","names":[]}

package/dist/components/tabs.d.ts

@@ -36,6 +36,10 @@ 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". */
+    more: string;
+    /** The `overflowCue` caret at the strip's end, which goes back to the first tab. */
+    backToFirst: string;
 }
 export { DEFAULT_TABS_LABELS };
 /**
@@ -79,8 +83,28 @@ export interface TabsProps<T extends string> extends Omit<ComponentPropsWithoutR
      *
      *  Opt-in on purpose. The three-tab strips (invoices, statements, bank imports)
      *  already fit a phone row, and turning those into chips would be an unrequested
-     *  redesign of three other pages. */
+     *  redesign of three other pages.
+     *
+     *  @deprecated 0.40 — use the scrolling strip with `overflowCue`; removed in 0.41. No
+     *  consumer is left (keksdose went back to one scrolling row, live #410); the caret
+     *  says a phone's row goes on. */
     wrap?: boolean;
+    /**
+     * The caret beside a SCROLLING strip below `md` (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.
+     *
+     * 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. From `md` up nothing changes. Ignored on
+     * a `wrap` strip and a vertical one (a side nav is a column, not a row). Names:
+     * `tabs.more` / `tabs.backToFirst`.
+     */
+    overflowCue?: boolean;
     /**
      * `id` of the element the caller renders the open tab's content into — the missing
      * half of `role="tab"`. A tab that controls nothing is a tab in name only: a screen
@@ -179,4 +203,4 @@ export interface TabsProps<T extends string> extends Omit<ComponentPropsWithoutR
      *  view and measures the fade, so neither loses the element. */
     ref?: Ref<HTMLDivElement>;
 }
-export declare function Tabs<T extends string>({ tabs, active, onChange, className, wrap, panelId, onRemove, removeOn, onAdd, addLabel, labels, busy, orientation, "aria-label": ariaLabel, ref, ...rest }: TabsProps<T>): import("react").JSX.Element;
+export declare function Tabs<T extends string>({ tabs, active, onChange, className, wrap, overflowCue, panelId, onRemove, removeOn, onAdd, addLabel, labels, busy, orientation, "aria-label": ariaLabel, ref, ...rest }: TabsProps<T>): import("react").JSX.Element;

package/dist/components/tabs.js

@@ -1,12 +1,13 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useLayoutEffect, useMemo, useRef } from "react";
-import { Plus, X } from "lucide-react";
+import { ChevronLeft, ChevronRight, Plus, X } from "lucide-react";
 import { cn } from "../lib/cn.js";
 import { FOCUS_RING_WIDTH } from "./focus-ring.js";
 import { scrollIntoStrip, useStripFade } from "../lib/strip-fade.js";
 import { horizontalStep } from "../lib/direction.js";
 import { usePhoneLayout } from "../hooks/use-breakpoint.js";
+import { prefersReducedMotion } from "../lib/reduced-motion.js";
 import { useKitLabels } from "../i18n/kit-labels.js";
 import { mergeRefs } from "./field-parts.js";
 import { DEFAULT_TABS_LABELS } from "./ui-labels.js";
@@ -34,6 +35,7 @@ function Tabs({
   onChange,
   className,
   wrap = false,
+  overflowCue = false,
   panelId,
   onRemove,
   removeOn = "every",
@@ -52,6 +54,35 @@ function Tabs({
   const stripRef = useRef(null);
   const setStrip = useMemo(() => mergeRefs(stripRef, ref), [ref]);
   const fade = useStripFade(stripRef);
+  const cue = overflowCue && !wrap && !vertical && fade.overflow !== void 0;
+  const cueAtEnd = fade.overflow === "start";
+  const onCue = () => {
+    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 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 md:hidden", 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;
   useLayoutEffect(() => {
     const strip = stripRef.current;
     const tab = strip?.querySelector('[role="tab"][aria-selected="true"]');
@@ -112,7 +143,7 @@ function Tabs({
       "data-overflow": fade.overflow,
       className: cn(
         vertical ? TABLIST_VERTICAL_CLASSES : wrap ? TABLIST_WRAP_CLASSES : TABLIST_CLASSES,
-        onAdd ? "min-w-0" : className
+        onAdd ? "min-w-0" : overflowCue && !wrap && !vertical ? "min-w-0 flex-1" : className
       ),
       children: tabs.map((tab) => {
         const isActive = tab.id === active;
@@ -253,6 +284,13 @@ function Tabs({
       children: text.remove(nameOf(activeTab))
     }
   ) : null;
+  if (!onAdd && overflowCue && !wrap && !vertical) {
+    return /* @__PURE__ */ jsxs("div", { className: cn("flex items-end", className), children: [
+      tablist,
+      removeButton,
+      cueButton
+    ] });
+  }
   if (!onAdd) {
     return removeButton ? /* @__PURE__ */ jsxs(Fragment, { children: [
       tablist,
@@ -279,6 +317,7 @@ function Tabs({
       children: [
         tablist,
         removeButton,
+        cueButton,
         /* @__PURE__ */ jsx(
           "div",
           {