@eifi1/ui-kit 0.54.0 → 0.55.0

package/dist/feedback.js

@@ -65,6 +65,10 @@ export * from "./feedback/feedback-vote-button.js";
 export * from "./feedback/feedback-comment-thread.js";
 export * from "./feedback/feedback-replies.js";
 export * from "./feedback/feedback-entry-file.js";
+import {
+  useFeedbackInbox,
+  FeedbackInbox
+} from "./feedback/feedback-inbox-page.js";
 export {
   DEFAULT_ATTACHMENT_ACCEPT,
   DEFAULT_FEEDBACK_DETAIL_LABELS,
@@ -83,6 +87,7 @@ export {
   FEEDBACK_REWORKABLE_STATUSES,
   FeedbackAwaitingToggle,
   FeedbackEmptyState,
+  FeedbackInbox,
   FeedbackMobileCard,
   FeedbackPublicSwitch,
   FeedbackReworkSection,
@@ -101,6 +106,7 @@ export {
   splitBodyAttachments,
   splitDescription,
   useFeedbackColumns,
+  useFeedbackInbox,
   useFeedbackPageLabels,
   useFeedbackRenderDate,
   useFeedbackStatusUndo

package/dist/feedback.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/feedback.ts"],"sourcesContent":["// `@eifi1/ui-kit/feedback` — the report form and the parts an inbox is built from.\n//\n// A re-slicing of the main barrel, not a new API. The kit owns the status vocabulary,\n// the transition policy and the look; each app still wires its own API, columns,\n// strings and permissions — see the note at the top of feedback/feedback-inbox.tsx.\nexport * from \"./feedback/feedback-attachment\";\nexport * from \"./feedback/feedback-dialog\";\nexport * from \"./feedback/feedback-inbox\";\nexport * from \"./feedback/feedback-thread\";\n// 0.27.0: the feedback harmonization (docs/feedback-harmonization.md) — one record,\n// one menu, dialog, table, detail and crash reporter for keksdose, kastlan, Kurvenschmiede.\n//\n// Named, not `*`, for six of its modules: 0.53 took the slice's share of the 55 names no app\n// reads off the surface (deprecated in 0.52, refactor audit 2026-10-30, API-4) —\n// `feedbackAttachmentLine`, `FEEDBACK_UNDO_DURATION`, `FEEDBACK_SWIPE_ACTIONS`,\n// `feedbackColumns`, `feedbackSubmitter`, `feedbackSubmitterEmail`, `feedbackEnvironment`,\n// `feedbackPagePath`, `feedbackAttachmentUrls`, `feedbackRowAccess`, `useFeedbackDetailLabels`\n// and `feedbackPublicSwitchAllowed`, which their modules keep for the kit's own use.\n// `feedbackPageHref` and `feedbackPageUrl` went whole: nothing read them.\nexport {\n  DEFAULT_ATTACHMENT_ACCEPT,\n  DEFAULT_MAX_ATTACHMENT_BYTES,\n  DEFAULT_MAX_ATTACHMENTS,\n  FEEDBACK_ATTACHMENT_ACCEPT,\n  FEEDBACK_PICKABLE_CATEGORIES,\n  FEEDBACK_REWORKABLE_STATUSES,\n  FEEDBACK_QUEUE_STATUSES,\n  FEEDBACK_AUTHOR_EDITABLE_STATUSES,\n  FEEDBACK_AWAITING_STATUSES,\n  FEEDBACK_DECIDED_STATUSES,\n  FEEDBACK_COMMENT_MAX,\n  FEEDBACK_REPLY_MAX,\n  appendRework,\n  reworkCount,\n  feedbackReworkCount,\n  splitBodyAttachments,\n  splitDescription,\n  replaceDescription,\n  isImageAttachment,\n  attachmentName,\n  type FeedbackEnvironment,\n  type FeedbackContext,\n  type FeedbackRecord,\n} from \"./feedback/feedback-record\";\nexport * from \"./feedback/feedback-labels\";\nexport {\n  useFeedbackStatusUndo,\n  type FeedbackStatusPatch,\n  type FeedbackStatusMutateAsync,\n  type FeedbackStatusRow,\n  type FeedbackStatusChange,\n  type FeedbackStatusUndoOptions,\n} from \"./feedback/feedback-status-undo\";\nexport {\n  DEFAULT_FEEDBACK_SWIPE,\n  feedbackSwipePlan,\n  feedbackSwipeOmitShown,\n  type FeedbackSwipeAction,\n  type FeedbackSwipeBinding,\n  type FeedbackSwipeOptions,\n} from \"./feedback/feedback-swipe\";\nexport * from \"./feedback/feedback-menu\";\nexport * from \"./feedback/feedback-context\";\nexport * from \"./feedback/feedback-capture\";\nexport * from \"./feedback/feedback-submit\";\nexport {\n  DEFAULT_FEEDBACK_PAGE_LABELS,\n  useFeedbackPageLabels,\n  isFeedbackAwaiting,\n  useFeedbackRenderDate,\n  FeedbackSubject,\n  useFeedbackColumns,\n  feedbackMobileGroupBy,\n  FeedbackMobileCard,\n  FeedbackAwaitingToggle,\n  FeedbackEmptyState,\n  type FeedbackPageLabels,\n  type FeedbackTableRow,\n  type FeedbackRenderDate,\n  type FeedbackSubjectProps,\n  type FeedbackColumnsOptions,\n  type UseFeedbackColumnsOptions,\n  type FeedbackMobileCardProps,\n  type FeedbackAwaitingToggleProps,\n  type FeedbackEmptyStateProps,\n} from \"./feedback/feedback-table\";\nexport {\n  DEFAULT_FEEDBACK_DETAIL_LABELS,\n  FeedbackReworkSection,\n  FeedbackRowDetail,\n  type FeedbackDetailLabels,\n  type FeedbackRowAccess,\n  type FeedbackDetailPatch,\n  type FeedbackDetailUpdateAsync,\n  type FeedbackUpload,\n  type FeedbackReworkSend,\n  type FeedbackReworkSectionProps,\n  type FeedbackRowDetailProps,\n} from \"./feedback/feedback-row-detail\";\nexport * from \"./feedback/feedback-crash\";\n// 0.38.0: the public pages (§9.15) — the \"Visible to others\" switch, the list every user\n// reads and one report opened.\nexport {\n  FeedbackPublicSwitch,\n  type FeedbackPublicSwitchRow,\n  type FeedbackPublicSwitchViewer,\n  type FeedbackPublicSwitchProps,\n} from \"./feedback/feedback-public-switch\";\nexport * from \"./feedback/feedback-public-list\";\n// 0.38.0: public feedback (docs/feedback-harmonization.md §9) — the shapes, the vote, the\n// comment thread, the replies' timeline and composer.\nexport * from \"./feedback/feedback-public-types\";\nexport * from \"./feedback/feedback-vote-button\";\nexport * from \"./feedback/feedback-comment-thread\";\nexport * from \"./feedback/feedback-replies\";\nexport * from \"./feedback/feedback-entry-file\";\n"],"mappings":";AAKA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAWd;AAAA,EACE;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;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,cAAc;AACd;AAAA,EACE;AAAA,OAMK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAUK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OASK;AACP,cAAc;AAGd;AAAA,EACE;AAAA,OAIK;AACP,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}
+{"version":3,"sources":["../src/feedback.ts"],"sourcesContent":["// `@eifi1/ui-kit/feedback` — the report form and the parts an inbox is built from.\n//\n// A re-slicing of the main barrel, not a new API. The kit owns the status vocabulary,\n// the transition policy and the look; each app still wires its own API, columns,\n// strings and permissions — see the note at the top of feedback/feedback-inbox.tsx.\nexport * from \"./feedback/feedback-attachment\";\nexport * from \"./feedback/feedback-dialog\";\nexport * from \"./feedback/feedback-inbox\";\nexport * from \"./feedback/feedback-thread\";\n// 0.27.0: the feedback harmonization (docs/feedback-harmonization.md) — one record,\n// one menu, dialog, table, detail and crash reporter for keksdose, kastlan, Kurvenschmiede.\n//\n// Named, not `*`, for six of its modules: 0.53 took the slice's share of the 55 names no app\n// reads off the surface (deprecated in 0.52, refactor audit 2026-10-30, API-4) —\n// `feedbackAttachmentLine`, `FEEDBACK_UNDO_DURATION`, `FEEDBACK_SWIPE_ACTIONS`,\n// `feedbackColumns`, `feedbackSubmitter`, `feedbackSubmitterEmail`, `feedbackEnvironment`,\n// `feedbackPagePath`, `feedbackAttachmentUrls`, `feedbackRowAccess`, `useFeedbackDetailLabels`\n// and `feedbackPublicSwitchAllowed`, which their modules keep for the kit's own use.\n// `feedbackPageHref` and `feedbackPageUrl` went whole: nothing read them.\nexport {\n  DEFAULT_ATTACHMENT_ACCEPT,\n  DEFAULT_MAX_ATTACHMENT_BYTES,\n  DEFAULT_MAX_ATTACHMENTS,\n  FEEDBACK_ATTACHMENT_ACCEPT,\n  FEEDBACK_PICKABLE_CATEGORIES,\n  FEEDBACK_REWORKABLE_STATUSES,\n  FEEDBACK_QUEUE_STATUSES,\n  FEEDBACK_AUTHOR_EDITABLE_STATUSES,\n  FEEDBACK_AWAITING_STATUSES,\n  FEEDBACK_DECIDED_STATUSES,\n  FEEDBACK_COMMENT_MAX,\n  FEEDBACK_REPLY_MAX,\n  appendRework,\n  reworkCount,\n  feedbackReworkCount,\n  splitBodyAttachments,\n  splitDescription,\n  replaceDescription,\n  isImageAttachment,\n  attachmentName,\n  type FeedbackEnvironment,\n  type FeedbackContext,\n  type FeedbackRecord,\n} from \"./feedback/feedback-record\";\nexport * from \"./feedback/feedback-labels\";\nexport {\n  useFeedbackStatusUndo,\n  type FeedbackStatusPatch,\n  type FeedbackStatusMutateAsync,\n  type FeedbackStatusRow,\n  type FeedbackStatusChange,\n  type FeedbackStatusUndoOptions,\n} from \"./feedback/feedback-status-undo\";\nexport {\n  DEFAULT_FEEDBACK_SWIPE,\n  feedbackSwipePlan,\n  feedbackSwipeOmitShown,\n  type FeedbackSwipeAction,\n  type FeedbackSwipeBinding,\n  type FeedbackSwipeOptions,\n} from \"./feedback/feedback-swipe\";\nexport * from \"./feedback/feedback-menu\";\nexport * from \"./feedback/feedback-context\";\nexport * from \"./feedback/feedback-capture\";\nexport * from \"./feedback/feedback-submit\";\nexport {\n  DEFAULT_FEEDBACK_PAGE_LABELS,\n  useFeedbackPageLabels,\n  isFeedbackAwaiting,\n  useFeedbackRenderDate,\n  FeedbackSubject,\n  useFeedbackColumns,\n  feedbackMobileGroupBy,\n  FeedbackMobileCard,\n  FeedbackAwaitingToggle,\n  FeedbackEmptyState,\n  type FeedbackPageLabels,\n  type FeedbackTableRow,\n  type FeedbackRenderDate,\n  type FeedbackSubjectProps,\n  type FeedbackColumnsOptions,\n  type UseFeedbackColumnsOptions,\n  type FeedbackMobileCardProps,\n  type FeedbackAwaitingToggleProps,\n  type FeedbackEmptyStateProps,\n} from \"./feedback/feedback-table\";\nexport {\n  DEFAULT_FEEDBACK_DETAIL_LABELS,\n  FeedbackReworkSection,\n  FeedbackRowDetail,\n  type FeedbackDetailLabels,\n  type FeedbackRowAccess,\n  type FeedbackDetailPatch,\n  type FeedbackDetailUpdateAsync,\n  type FeedbackUpload,\n  type FeedbackReworkSend,\n  type FeedbackReworkSectionProps,\n  type FeedbackRowDetailProps,\n} from \"./feedback/feedback-row-detail\";\nexport * from \"./feedback/feedback-crash\";\n// 0.38.0: the public pages (§9.15) — the \"Visible to others\" switch, the list every user\n// reads and one report opened.\nexport {\n  FeedbackPublicSwitch,\n  type FeedbackPublicSwitchRow,\n  type FeedbackPublicSwitchViewer,\n  type FeedbackPublicSwitchProps,\n} from \"./feedback/feedback-public-switch\";\nexport * from \"./feedback/feedback-public-list\";\n// 0.38.0: public feedback (docs/feedback-harmonization.md §9) — the shapes, the vote, the\n// comment thread, the replies' timeline and composer.\nexport * from \"./feedback/feedback-public-types\";\nexport * from \"./feedback/feedback-vote-button\";\nexport * from \"./feedback/feedback-comment-thread\";\nexport * from \"./feedback/feedback-replies\";\nexport * from \"./feedback/feedback-entry-file\";\n// 0.55.0: the inbox assembled once (kastlan reuse audit 2026-11-02, proposal 2;\n// docs/feedback-harmonization.md §13) — the wiring the three pages each wrote, as a hook\n// and the component that draws it.\nexport {\n  useFeedbackInbox,\n  FeedbackInbox,\n  type FeedbackInboxMutation,\n  type FeedbackReplyPost,\n  type FeedbackReworkPost,\n  type UseFeedbackInboxOptions,\n  type FeedbackInboxState,\n  type FeedbackInboxProps,\n} from \"./feedback/feedback-inbox-page\";\n"],"mappings":";AAKA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAWd;AAAA,EACE;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;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,cAAc;AACd;AAAA,EACE;AAAA,OAMK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAUK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OASK;AACP,cAAc;AAGd;AAAA,EACE;AAAA,OAIK;AACP,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAId;AAAA,EACE;AAAA,EACA;AAAA,OAOK;","names":[]}

package/dist/hooks/use-debounce.d.ts

@@ -9,16 +9,43 @@
  * The first render returns `value` itself, not `undefined`: a list filtered by the
  * debounced query must render its initial state immediately, not after `ms`.
  *
- * **It re-arms when `value`'s IDENTITY changes** (an effect on `[value, ms]`), not its
- * content. Pass a primitive — the typed query, a JSON string — or a value whose
+ * **By default it re-arms when `value`'s IDENTITY changes** (an effect on `[value, ms]`),
+ * not its content. Pass a primitive — the typed query, a JSON string — or a value whose
  * identity is stable (state, a `useMemo`). An object or array built in render is a new
  * one every render, so the timer is re-armed on every render and the value never
  * settles — or, when the debounced value feeds the render that built it, settles,
  * renders, builds another and fires again, every `ms`, with nobody typing
- * (Kurvenschmiede's control page, KS U9). Debounce `JSON.stringify(body)`, or a key that
- * changes exactly when the content does, and build the object from that.
+ * (Kurvenschmiede's control page, KS U9).
+ *
+ * **For such a value, name its content: `{ key }`** (0.55, KS U9). The timer then re-arms
+ * when the key changes and only then, and a new object under the same key is the value
+ * already on its way, not news. What comes back is the object that arrived with the key,
+ * and it keeps that identity until the key changes and settles — so it can go straight
+ * into a query key or a request without a `useMemo` round it. A key that comes back
+ * before the wait is over (A → B → A) settles on nothing new: the caller keeps the object
+ * it already had. Kurvenschmiede's own `useDebounced` (shared/lib/use-debounced.ts)
+ * settles the same way, and its four callers key one of two ways, both of which this
+ * takes:
+ *
+ * ```ts
+ * // A body that is small: its JSON is its content.
+ * const settled = useDebounce(geometry, 400, { key: JSON.stringify(geometry) });
+ * // A body too large to stringify on every render (twenty thousand samples twice
+ * // over): the few fields that say what the signal IS.
+ * const settled = useDebounce(request, settleMs, { key: JSON.stringify(request?.key ?? null) });
+ * ```
  */
-export declare function useDebounce<T>(value: T, ms: number): T;
+export declare function useDebounce<T>(value: T, ms: number, { key }?: DebounceOptions): T;
+export interface DebounceOptions {
+    /**
+     * What the value IS, for a value whose identity changes on every render — a request
+     * body or a filter built in render: a string or number that changes exactly when the
+     * content does (`JSON.stringify(body)`, or the few fields that decide it). The wait
+     * restarts when the key changes, never on a new object under the same key. Without it,
+     * the value's identity is its key.
+     */
+    key?: string | number;
+}
 export interface DebouncedCallbackOptions {
     /**
      * The longest a call may be held back, however often it is re-triggered. Without

package/dist/hooks/use-debounce.js

@@ -1,12 +1,13 @@
 "use client";
 import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
-function useDebounce(value, ms) {
-  const [debounced, setDebounced] = useState(value);
+function useDebounce(value, ms, { key } = {}) {
+  const id = key === void 0 ? value : key;
+  const [settled, setSettled] = useState(() => ({ id, value }));
   useEffect(() => {
-    const timer = setTimeout(() => setDebounced(value), ms);
+    const timer = setTimeout(() => setSettled((prev) => Object.is(prev.id, id) ? prev : { id, value }), ms);
     return () => clearTimeout(timer);
-  }, [value, ms]);
-  return debounced;
+  }, [id, ms]);
+  return settled.value;
 }
 function useDebouncedCallback(fn, ms, { maxWait } = {}) {
   const fnRef = useRef(fn);

package/dist/hooks/use-debounce.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/use-debounce.ts"],"sourcesContent":["import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from \"react\";\n\n/**\n * A value that follows `value`, but only once it has stopped changing for `ms`.\n *\n * kastlan asked for the pair in this module because each of its search boxes carried\n * its own copy of the same six lines — a `useEffect` with a `setTimeout` — and two of\n * them forgot the cleanup, so a stale query landed AFTER the fresh one and replaced\n * its results. The cleanup is the whole point of having one implementation.\n *\n * The first render returns `value` itself, not `undefined`: a list filtered by the\n * debounced query must render its initial state immediately, not after `ms`.\n *\n * **It re-arms when `value`'s IDENTITY changes** (an effect on `[value, ms]`), not its\n * content. Pass a primitive — the typed query, a JSON string — or a value whose\n * identity is stable (state, a `useMemo`). An object or array built in render is a new\n * one every render, so the timer is re-armed on every render and the value never\n * settles — or, when the debounced value feeds the render that built it, settles,\n * renders, builds another and fires again, every `ms`, with nobody typing\n * (Kurvenschmiede's control page, KS U9). Debounce `JSON.stringify(body)`, or a key that\n * changes exactly when the content does, and build the object from that.\n */\nexport function useDebounce<T>(value: T, ms: number): T {\n  const [debounced, setDebounced] = useState(value);\n  useEffect(() => {\n    const timer = setTimeout(() => setDebounced(value), ms);\n    return () => clearTimeout(timer);\n  }, [value, ms]);\n  return debounced;\n}\n\nexport interface DebouncedCallbackOptions {\n  /**\n   * The longest a call may be held back, however often it is re-triggered. Without\n   * it a user who never stops typing never saves; with it, a draft autosave still\n   * lands every `maxWait` ms while the typing goes on.\n   */\n  maxWait?: number;\n}\n\n/** The debounced function, plus the two escapes a caller needs around it. */\nexport type DebouncedFunction<A extends unknown[]> = ((...args: A) => void) & {\n  /** Drop the pending call, if there is one. */\n  cancel: () => void;\n  /** Run the pending call now, if there is one — e.g. on blur or before navigating\n   *  away, so the last keystrokes of a form are not lost. */\n  flush: () => void;\n  /** Whether a call is waiting. */\n  pending: () => boolean;\n};\n\n/**\n * `fn`, called only once calls have stopped arriving for `ms` — with the arguments\n * of the LAST call.\n *\n * The returned function keeps its identity across renders (so it can sit in an\n * effect's dependency list or be handed to a memoised child) and always calls the\n * LATEST `fn`, so a handler that closes over current state never runs a stale copy.\n * A pending call is cancelled on unmount: a debounced save firing into an unmounted\n * form is the bug kastlan reported, not a feature.\n */\nexport function useDebouncedCallback<A extends unknown[]>(\n  fn: (...args: A) => void,\n  ms: number,\n  { maxWait }: DebouncedCallbackOptions = {},\n): DebouncedFunction<A> {\n  const fnRef = useRef(fn);\n  // Layout effect, not render-time assignment: a ref written during render is a\n  // side effect React may replay or discard. Nothing can call the debounced function\n  // between this commit and the layout effect, so it is never one render behind.\n  useLayoutEffect(() => {\n    fnRef.current = fn;\n  });\n\n  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const maxTimer = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const lastArgs = useRef<A | null>(null);\n\n  const clear = useCallback(() => {\n    if (timer.current) clearTimeout(timer.current);\n    if (maxTimer.current) clearTimeout(maxTimer.current);\n    timer.current = null;\n    maxTimer.current = null;\n  }, []);\n\n  const invoke = useCallback(() => {\n    const args = lastArgs.current;\n    clear();\n    lastArgs.current = null;\n    if (args) fnRef.current(...args);\n  }, [clear]);\n\n  useEffect(() => clear, [clear]);\n\n  return useMemo(() => {\n    const debounced = ((...args: A) => {\n      lastArgs.current = args;\n      if (timer.current) clearTimeout(timer.current);\n      timer.current = setTimeout(invoke, ms);\n      if (maxWait !== undefined && !maxTimer.current) {\n        maxTimer.current = setTimeout(invoke, maxWait);\n      }\n    }) as DebouncedFunction<A>;\n    debounced.cancel = () => {\n      clear();\n      lastArgs.current = null;\n    };\n    debounced.flush = () => {\n      if (lastArgs.current) invoke();\n    };\n    debounced.pending = () => lastArgs.current !== null;\n    return debounced;\n  }, [ms, maxWait, invoke, clear]);\n}\n"],"mappings":";AAAA,SAAS,aAAa,WAAW,iBAAiB,SAAS,QAAQ,gBAAgB;AAsB5E,SAAS,YAAe,OAAU,IAAe;AACtD,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,KAAK;AAChD,YAAU,MAAM;AACd,UAAM,QAAQ,WAAW,MAAM,aAAa,KAAK,GAAG,EAAE;AACtD,WAAO,MAAM,aAAa,KAAK;AAAA,EACjC,GAAG,CAAC,OAAO,EAAE,CAAC;AACd,SAAO;AACT;AAgCO,SAAS,qBACd,IACA,IACA,EAAE,QAAQ,IAA8B,CAAC,GACnB;AACtB,QAAM,QAAQ,OAAO,EAAE;AAIvB,kBAAgB,MAAM;AACpB,UAAM,UAAU;AAAA,EAClB,CAAC;AAED,QAAM,QAAQ,OAA6C,IAAI;AAC/D,QAAM,WAAW,OAA6C,IAAI;AAClE,QAAM,WAAW,OAAiB,IAAI;AAEtC,QAAM,QAAQ,YAAY,MAAM;AAC9B,QAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAC7C,QAAI,SAAS,QAAS,cAAa,SAAS,OAAO;AACnD,UAAM,UAAU;AAChB,aAAS,UAAU;AAAA,EACrB,GAAG,CAAC,CAAC;AAEL,QAAM,SAAS,YAAY,MAAM;AAC/B,UAAM,OAAO,SAAS;AACtB,UAAM;AACN,aAAS,UAAU;AACnB,QAAI,KAAM,OAAM,QAAQ,GAAG,IAAI;AAAA,EACjC,GAAG,CAAC,KAAK,CAAC;AAEV,YAAU,MAAM,OAAO,CAAC,KAAK,CAAC;AAE9B,SAAO,QAAQ,MAAM;AACnB,UAAM,aAAa,IAAI,SAAY;AACjC,eAAS,UAAU;AACnB,UAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAC7C,YAAM,UAAU,WAAW,QAAQ,EAAE;AACrC,UAAI,YAAY,UAAa,CAAC,SAAS,SAAS;AAC9C,iBAAS,UAAU,WAAW,QAAQ,OAAO;AAAA,MAC/C;AAAA,IACF;AACA,cAAU,SAAS,MAAM;AACvB,YAAM;AACN,eAAS,UAAU;AAAA,IACrB;AACA,cAAU,QAAQ,MAAM;AACtB,UAAI,SAAS,QAAS,QAAO;AAAA,IAC/B;AACA,cAAU,UAAU,MAAM,SAAS,YAAY;AAC/C,WAAO;AAAA,EACT,GAAG,CAAC,IAAI,SAAS,QAAQ,KAAK,CAAC;AACjC;","names":[]}
+{"version":3,"sources":["../../src/hooks/use-debounce.ts"],"sourcesContent":["import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from \"react\";\n\n/**\n * A value that follows `value`, but only once it has stopped changing for `ms`.\n *\n * kastlan asked for the pair in this module because each of its search boxes carried\n * its own copy of the same six lines — a `useEffect` with a `setTimeout` — and two of\n * them forgot the cleanup, so a stale query landed AFTER the fresh one and replaced\n * its results. The cleanup is the whole point of having one implementation.\n *\n * The first render returns `value` itself, not `undefined`: a list filtered by the\n * debounced query must render its initial state immediately, not after `ms`.\n *\n * **By default it re-arms when `value`'s IDENTITY changes** (an effect on `[value, ms]`),\n * not its content. Pass a primitive — the typed query, a JSON string — or a value whose\n * identity is stable (state, a `useMemo`). An object or array built in render is a new\n * one every render, so the timer is re-armed on every render and the value never\n * settles — or, when the debounced value feeds the render that built it, settles,\n * renders, builds another and fires again, every `ms`, with nobody typing\n * (Kurvenschmiede's control page, KS U9).\n *\n * **For such a value, name its content: `{ key }`** (0.55, KS U9). The timer then re-arms\n * when the key changes and only then, and a new object under the same key is the value\n * already on its way, not news. What comes back is the object that arrived with the key,\n * and it keeps that identity until the key changes and settles — so it can go straight\n * into a query key or a request without a `useMemo` round it. A key that comes back\n * before the wait is over (A → B → A) settles on nothing new: the caller keeps the object\n * it already had. Kurvenschmiede's own `useDebounced` (shared/lib/use-debounced.ts)\n * settles the same way, and its four callers key one of two ways, both of which this\n * takes:\n *\n * ```ts\n * // A body that is small: its JSON is its content.\n * const settled = useDebounce(geometry, 400, { key: JSON.stringify(geometry) });\n * // A body too large to stringify on every render (twenty thousand samples twice\n * // over): the few fields that say what the signal IS.\n * const settled = useDebounce(request, settleMs, { key: JSON.stringify(request?.key ?? null) });\n * ```\n */\nexport function useDebounce<T>(value: T, ms: number, { key }: DebounceOptions = {}): T {\n  // What arms the timer: the value itself, as it always has, or the caller's name for it.\n  const id: unknown = key === undefined ? value : key;\n  // Held WITH the id it settled under, so a later render under the same id can be told\n  // from news. Without a key the id is the value, and this is the value as it was.\n  const [settled, setSettled] = useState(() => ({ id, value }));\n  useEffect(() => {\n    const timer = setTimeout(() => setSettled((prev) => (Object.is(prev.id, id) ? prev : { id, value })), ms);\n    return () => clearTimeout(timer);\n    // `value` is read as it was in the render that brought `id`: under a key, a later\n    // object with the same key is the same value, and re-arming on it is KS U9's\n    // metronome. Without a key `id` IS `value`, so these are today's `[value, ms]`.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [id, ms]);\n  return settled.value;\n}\n\nexport interface DebounceOptions {\n  /**\n   * What the value IS, for a value whose identity changes on every render — a request\n   * body or a filter built in render: a string or number that changes exactly when the\n   * content does (`JSON.stringify(body)`, or the few fields that decide it). The wait\n   * restarts when the key changes, never on a new object under the same key. Without it,\n   * the value's identity is its key.\n   */\n  key?: string | number;\n}\n\nexport interface DebouncedCallbackOptions {\n  /**\n   * The longest a call may be held back, however often it is re-triggered. Without\n   * it a user who never stops typing never saves; with it, a draft autosave still\n   * lands every `maxWait` ms while the typing goes on.\n   */\n  maxWait?: number;\n}\n\n/** The debounced function, plus the two escapes a caller needs around it. */\nexport type DebouncedFunction<A extends unknown[]> = ((...args: A) => void) & {\n  /** Drop the pending call, if there is one. */\n  cancel: () => void;\n  /** Run the pending call now, if there is one — e.g. on blur or before navigating\n   *  away, so the last keystrokes of a form are not lost. */\n  flush: () => void;\n  /** Whether a call is waiting. */\n  pending: () => boolean;\n};\n\n/**\n * `fn`, called only once calls have stopped arriving for `ms` — with the arguments\n * of the LAST call.\n *\n * The returned function keeps its identity across renders (so it can sit in an\n * effect's dependency list or be handed to a memoised child) and always calls the\n * LATEST `fn`, so a handler that closes over current state never runs a stale copy.\n * A pending call is cancelled on unmount: a debounced save firing into an unmounted\n * form is the bug kastlan reported, not a feature.\n */\nexport function useDebouncedCallback<A extends unknown[]>(\n  fn: (...args: A) => void,\n  ms: number,\n  { maxWait }: DebouncedCallbackOptions = {},\n): DebouncedFunction<A> {\n  const fnRef = useRef(fn);\n  // Layout effect, not render-time assignment: a ref written during render is a\n  // side effect React may replay or discard. Nothing can call the debounced function\n  // between this commit and the layout effect, so it is never one render behind.\n  useLayoutEffect(() => {\n    fnRef.current = fn;\n  });\n\n  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const maxTimer = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const lastArgs = useRef<A | null>(null);\n\n  const clear = useCallback(() => {\n    if (timer.current) clearTimeout(timer.current);\n    if (maxTimer.current) clearTimeout(maxTimer.current);\n    timer.current = null;\n    maxTimer.current = null;\n  }, []);\n\n  const invoke = useCallback(() => {\n    const args = lastArgs.current;\n    clear();\n    lastArgs.current = null;\n    if (args) fnRef.current(...args);\n  }, [clear]);\n\n  useEffect(() => clear, [clear]);\n\n  return useMemo(() => {\n    const debounced = ((...args: A) => {\n      lastArgs.current = args;\n      if (timer.current) clearTimeout(timer.current);\n      timer.current = setTimeout(invoke, ms);\n      if (maxWait !== undefined && !maxTimer.current) {\n        maxTimer.current = setTimeout(invoke, maxWait);\n      }\n    }) as DebouncedFunction<A>;\n    debounced.cancel = () => {\n      clear();\n      lastArgs.current = null;\n    };\n    debounced.flush = () => {\n      if (lastArgs.current) invoke();\n    };\n    debounced.pending = () => lastArgs.current !== null;\n    return debounced;\n  }, [ms, maxWait, invoke, clear]);\n}\n"],"mappings":";AAAA,SAAS,aAAa,WAAW,iBAAiB,SAAS,QAAQ,gBAAgB;AAuC5E,SAAS,YAAe,OAAU,IAAY,EAAE,IAAI,IAAqB,CAAC,GAAM;AAErF,QAAM,KAAc,QAAQ,SAAY,QAAQ;AAGhD,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,OAAO,EAAE,IAAI,MAAM,EAAE;AAC5D,YAAU,MAAM;AACd,UAAM,QAAQ,WAAW,MAAM,WAAW,CAAC,SAAU,OAAO,GAAG,KAAK,IAAI,EAAE,IAAI,OAAO,EAAE,IAAI,MAAM,CAAE,GAAG,EAAE;AACxG,WAAO,MAAM,aAAa,KAAK;AAAA,EAKjC,GAAG,CAAC,IAAI,EAAE,CAAC;AACX,SAAO,QAAQ;AACjB;AA2CO,SAAS,qBACd,IACA,IACA,EAAE,QAAQ,IAA8B,CAAC,GACnB;AACtB,QAAM,QAAQ,OAAO,EAAE;AAIvB,kBAAgB,MAAM;AACpB,UAAM,UAAU;AAAA,EAClB,CAAC;AAED,QAAM,QAAQ,OAA6C,IAAI;AAC/D,QAAM,WAAW,OAA6C,IAAI;AAClE,QAAM,WAAW,OAAiB,IAAI;AAEtC,QAAM,QAAQ,YAAY,MAAM;AAC9B,QAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAC7C,QAAI,SAAS,QAAS,cAAa,SAAS,OAAO;AACnD,UAAM,UAAU;AAChB,aAAS,UAAU;AAAA,EACrB,GAAG,CAAC,CAAC;AAEL,QAAM,SAAS,YAAY,MAAM;AAC/B,UAAM,OAAO,SAAS;AACtB,UAAM;AACN,aAAS,UAAU;AACnB,QAAI,KAAM,OAAM,QAAQ,GAAG,IAAI;AAAA,EACjC,GAAG,CAAC,KAAK,CAAC;AAEV,YAAU,MAAM,OAAO,CAAC,KAAK,CAAC;AAE9B,SAAO,QAAQ,MAAM;AACnB,UAAM,aAAa,IAAI,SAAY;AACjC,eAAS,UAAU;AACnB,UAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAC7C,YAAM,UAAU,WAAW,QAAQ,EAAE;AACrC,UAAI,YAAY,UAAa,CAAC,SAAS,SAAS;AAC9C,iBAAS,UAAU,WAAW,QAAQ,OAAO;AAAA,MAC/C;AAAA,IACF;AACA,cAAU,SAAS,MAAM;AACvB,YAAM;AACN,eAAS,UAAU;AAAA,IACrB;AACA,cAAU,QAAQ,MAAM;AACtB,UAAI,SAAS,QAAS,QAAO;AAAA,IAC/B;AACA,cAAU,UAAU,MAAM,SAAS,YAAY;AAC/C,WAAO;AAAA,EACT,GAAG,CAAC,IAAI,SAAS,QAAQ,KAAK,CAAC;AACjC;","names":[]}

package/dist/hooks/use-file-picker.d.ts

@@ -125,7 +125,9 @@ export interface UseFilePickerOptions extends FileScreenOptions {
      * Ask a phone for its camera instead of the file chooser: `"environment"` is the
      * back camera, `"user"` the front. A HINT — desktop browsers ignore it, and Chrome
      * drops it when `multiple` is also set (a camera cannot deliver a list), which is why
-     * keksdose's camera input has no `multiple`. Pass one or the other.
+     * keksdose's camera input has no `multiple`. Pass one or the other. Android Chrome may
+     * still show its Camera-or-Files sheet for it (keksdose live #292); `CameraButton` (0.55)
+     * opens the camera in the page instead and keeps this as its fallback.
      */
     capture?: boolean | "user" | "environment";
     /** The files that passed, in pick order. Never called with an empty array.

package/dist/hooks/use-file-picker.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/use-file-picker.tsx"],"sourcesContent":["import { useRef } from \"react\";\nimport type { ReactElement } from \"react\";\nimport { useAnnounce } from \"./use-announce\";\nimport { useKitFileLabels, useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { DEFAULT_FILE_PICKER_LABELS } from \"./use-file-picker-labels\";\n\n/**\n * The file pickers' headless half: the hidden input, the screening of a pick and the\n * announcement of a refusal, which {@link FileButton}, `FileDropzone` and {@link useFileDrop}\n * are built on.\n *\n * In hooks/ since 0.34 (MOD-8, refactor audit 2026-10). It lived in\n * components/file-button.tsx, and `useFileDrop` — a hook — imported it from there, so\n * hooks/ reached up into components/. components/file-button re-exports all of it, so an\n * import from there keeps working.\n */\n\n/* ── Labels ──────────────────────────────────────────────────────────────── */\n\n/** Every string the file pickers ({@link FileButton}, `FileDropzone`) render or speak.\n *  Messages are functions of the file name so a translation can put it anywhere. */\nexport interface FilePickerLabels {\n  /** The file's type is not in `accept`, when no `accept` is known to name (see\n   *  `rejectedTypeOnly`). */\n  rejectedType: (name: string) => string;\n  /** The file's type is not in `accept`, naming what IS accepted: `accept`'s tokens,\n   *  lower-cased and joined with \", \" (`\".csv\"` => \"Only .csv files\"). Used whenever\n   *  `accept` is set — kastlan kept a custom `isValid` + `invalidMessage` per form only\n   *  to say this, and `accept` already knows it. */\n  rejectedTypeOnly: (accept: string, name: string) => string;\n  /** The file is larger than `maxSize`; `maxSize` arrives formatted (\"5 MB\"). */\n  rejectedSize: (name: string, maxSize: string) => string;\n  /** The file was one too many for `maxFiles`. */\n  rejectedCount: (name: string, maxFiles: number) => string;\n  /** `isValid` said no and the caller gave no `invalidMessage`. */\n  rejectedInvalid: (name: string) => string;\n  /** Spoken instead of the per-file message when more than one file was refused. */\n  rejectedMany: (count: number) => string;\n  /** Spoken (and shown, on a dropzone) when `onPick` refused the WHOLE pick.\n   *  Receives the number of files in it. */\n  rejectedPick: (count: number) => string;\n  /** Spoken after a pick the component itself echoes (the dropzone). */\n  selected: (count: number, firstName: string) => string;\n  /** The dropzone's remove button for one file. */\n  remove: (name: string) => string;\n  /** The dropzone's remove-everything button in `multiple` mode. */\n  clearAll: string;\n  /** Spoken after a remove / clear, since the button that was pressed is gone. */\n  removed: (name: string) => string;\n  cleared: string;\n  /** The dropzone's accessible name, when the host passes no `dropLabel`. */\n  dropzone: string;\n  /** The dropzone's Browse button, when the host passes no `browseLabel`. */\n  browse: string;\n  /** What an empty single-file dropzone says (no `emptyLabel` given). */\n  empty: string;\n  /** …and an empty `multiple` one. */\n  emptyMultiple: string;\n  /** The dropzone's second line (no `hint` given). Receives `accept` as a person\n   *  reads it (`\".pdf, image/png\"`), or `\"\"` when anything goes. */\n  hint: (accept: string) => string;\n  /** What a `busy` dropzone says in place of its body (\"Uploading…\"). */\n  busy: string;\n}\n\n/* ── Screening ───────────────────────────────────────────────────────────── */\n\nexport type FileRejectionReason = \"type\" | \"size\" | \"count\" | \"invalid\";\n\n/** One file the picker refused, and why. `message` is already translated (see\n *  {@link FilePickerLabels}, or the caller's `invalidMessage`), so a host that just\n *  wants to show it can render `rejections[0].message` as is. */\nexport interface FileRejection {\n  file: File;\n  reason: FileRejectionReason;\n  message: string;\n}\n\n/**\n * Does `file` satisfy an `accept` string, the way the browser's dialog reads it?\n * Comma-separated tokens: `.ext` (case-insensitive suffix of the name), `type/*`\n * (a MIME family) or an exact MIME type. An empty or absent `accept` takes anything.\n *\n * A file with no `type` — common for `.step`, `.dat`, anything the OS has no MIME\n * mapping for — can only match by extension, which is why lenkbank lists `.stp` AND\n * `model/step`: that is how `accept` has to be written for the dialog anyway.\n */\nexport function matchesAccept(file: File, accept: string | undefined): boolean {\n  const tokens = (accept ?? \"\")\n    .split(\",\")\n    .map((t) => t.trim().toLowerCase())\n    .filter(Boolean);\n  if (tokens.length === 0) return true;\n  const name = file.name.toLowerCase();\n  // An EMPTY type is the browser saying \"I don't know\", not \"it's something else\": HEIC\n  // photos on Windows without the codec arrive with `type === \"\"`. Refusing them\n  // (0.6.0) refused iPhone photos the picker itself had just offered (keksdose). So a\n  // missing type is inferred from the extension where that is unambiguous, and a file\n  // whose type cannot be known at all is given the benefit of the doubt — nothing here\n  // proves it does not match, and the server validates what it receives anyway.\n  const type = (file.type || typeFromExtension(name) || \"\").toLowerCase();\n  if (!type && !tokens.every((t) => t.startsWith(\".\"))) return true;\n  return tokens.some((token) => {\n    if (token.startsWith(\".\")) return name.endsWith(token);\n    if (!type) return false;\n    if (token.endsWith(\"/*\")) return type.startsWith(token.slice(0, -1));\n    return type === token;\n  });\n}\n\n/** MIME types for the extensions a browser most often leaves untyped. */\nconst EXTENSION_TYPES: Record<string, string> = {\n  heic: \"image/heic\",\n  heif: \"image/heif\",\n  avif: \"image/avif\",\n  webp: \"image/webp\",\n  jpg: \"image/jpeg\",\n  jpeg: \"image/jpeg\",\n  png: \"image/png\",\n  gif: \"image/gif\",\n  pdf: \"application/pdf\",\n  csv: \"text/csv\",\n  txt: \"text/plain\",\n};\n\nfunction typeFromExtension(name: string): string | undefined {\n  const dot = name.lastIndexOf(\".\");\n  return dot === -1 ? undefined : EXTENSION_TYPES[name.slice(dot + 1)];\n}\n\n/** @internal `\" .PDF, image/png ,\"` => `\".pdf, image/png\"` — `accept` as a person reads\n *  it. Also the dropzone's default hint. */\nexport function formatAccept(accept: string): string {\n  return accept\n    .split(\",\")\n    .map((t) => t.trim().toLowerCase())\n    .filter(Boolean)\n    .join(\", \");\n}\n\n/** What the pickers screen a pick with. All optional; nothing set accepts everything. */\nexport interface FileScreenOptions {\n  accept?: string;\n  /** Bytes. Larger files are refused with reason `\"size\"`. */\n  maxSize?: number;\n  /** How many files one pick may deliver. The rest are refused with reason `\"count\"`\n   *  — first come, first kept. For a running cap (\"at most 5 attachments\") pass what\n   *  is LEFT: `maxFiles={5 - attachments.length}`. */\n  maxFiles?: number;\n  /** The caller's own check, after `accept` and `maxSize`. */\n  isValid?: (file: File) => boolean;\n  /** The message for an `isValid` refusal; `labels.rejectedInvalid` otherwise. */\n  invalidMessage?: string;\n}\n\n/** @internal Split a pick into the files that pass and the ones that do not. */\nexport function screenFiles(\n  files: readonly File[],\n  opts: FileScreenOptions,\n  labels: FilePickerLabels,\n  formatSize: (bytes: number) => string,\n): { accepted: File[]; rejected: FileRejection[] } {\n  const accepted: File[] = [];\n  const rejected: FileRejection[] = [];\n  // Name what `accept` takes (\"Only .csv files\") — unless the host translated\n  // `rejectedType` but not yet `rejectedTypeOnly`: its own sentence beats an English one.\n  const acceptText = opts.accept ? formatAccept(opts.accept) : \"\";\n  const useOnly =\n    acceptText !== \"\" &&\n    (labels.rejectedTypeOnly !== DEFAULT_FILE_PICKER_LABELS.rejectedTypeOnly ||\n      labels.rejectedType === DEFAULT_FILE_PICKER_LABELS.rejectedType);\n  const typeMessage = (name: string) =>\n    useOnly ? labels.rejectedTypeOnly(acceptText, name) : labels.rejectedType(name);\n  for (const file of files) {\n    let reason: FileRejectionReason | null = null;\n    if (!matchesAccept(file, opts.accept)) reason = \"type\";\n    else if (opts.maxSize !== undefined && file.size > opts.maxSize) reason = \"size\";\n    else if (opts.isValid && !opts.isValid(file)) reason = \"invalid\";\n    // Count last, and only against files that passed everything else: a refused\n    // file should not use up one of the slots a good one could have had.\n    else if (opts.maxFiles !== undefined && accepted.length >= opts.maxFiles) reason = \"count\";\n    if (reason === null) {\n      accepted.push(file);\n      continue;\n    }\n    const message =\n      reason === \"type\"\n        ? typeMessage(file.name)\n        : reason === \"size\"\n          ? labels.rejectedSize(file.name, formatSize(opts.maxSize ?? 0))\n          : reason === \"count\"\n            ? labels.rejectedCount(file.name, Math.max(0, opts.maxFiles ?? 0))\n            : (opts.invalidMessage ?? labels.rejectedInvalid(file.name));\n    rejected.push({ file, reason, message });\n  }\n  return { accepted, rejected };\n}\n\n/**\n * Judges a pick as a whole — keksdose's \"refuse the pick if any file is bad\", which\n * with `onFiles` + `onReject` alone had to be rebuilt from two calls in a microtask.\n *\n * Called ONCE per pick, after screening and before `onFiles` / `onReject`, with both\n * halves (either may be empty). Return `false` to refuse the whole pick: the accepted\n * files are not delivered, `onReject` still receives what screening refused, and one\n * sentence (`labels.rejectedPick`) is spoken for the pick instead of a per-file one.\n * Return nothing to let the pick through as usual.\n *\n * ```tsx\n * onPick={(ok, bad) => bad.length === 0 || false}  // all or nothing\n * ```\n */\nexport type FilePickHandler = (accepted: File[], rejected: FileRejection[]) => boolean | void;\n\n/** @internal The shared tail of both pickers: run `onPick`, and say whether the pick\n *  stands. A pick with nothing accepted has nothing to refuse, so `false` there is\n *  treated as no verdict and the usual per-file messages are kept. */\nexport function judgePick(onPick: FilePickHandler | undefined, accepted: File[], rejected: FileRejection[]): boolean {\n  if (!onPick) return true;\n  return onPick(accepted, rejected) !== false || accepted.length === 0;\n}\n\n/** One sentence for a whole batch of refusals: the file's own message for one, a\n *  count for several — reading out five sentences in a row helps nobody. */\nexport function summariseRejections(rejected: readonly FileRejection[], labels: FilePickerLabels): string {\n  if (rejected.length === 0) return \"\";\n  if (rejected.length === 1) return rejected[0].message;\n  return labels.rejectedMany(rejected.length);\n}\n\n/* ── useFilePicker ───────────────────────────────────────────────────────── */\n\nexport interface UseFilePickerOptions extends FileScreenOptions {\n  /** Let one pick deliver several files. Without it a drop of several keeps the first. */\n  multiple?: boolean;\n  /**\n   * Ask a phone for its camera instead of the file chooser: `\"environment\"` is the\n   * back camera, `\"user\"` the front. A HINT — desktop browsers ignore it, and Chrome\n   * drops it when `multiple` is also set (a camera cannot deliver a list), which is why\n   * keksdose's camera input has no `multiple`. Pass one or the other.\n   */\n  capture?: boolean | \"user\" | \"environment\";\n  /** The files that passed, in pick order. Never called with an empty array.\n   *  Optional since 0.7 for a caller that takes the pick through `onPick` alone. */\n  onFiles?: (files: File[]) => void;\n  /** See {@link FilePickHandler}: the whole pick at once, with the power to refuse it. */\n  onPick?: FilePickHandler;\n  /** The files that did not, with a translated message each. The refusals are also\n   *  spoken through a live region, so this is for SHOWING them, not for a11y. */\n  onReject?: (rejections: FileRejection[]) => void;\n  /** `open()` and `take()` do nothing while set. */\n  disabled?: boolean;\n  /** Per-instance overrides of the `filePicker` label namespace. */\n  labels?: LabelOverride<FilePickerLabels>;\n}\n\nexport interface UseFilePickerReturn {\n  /** Open the system picker. Call it from a click handler — browsers only open a file\n   *  dialog in response to a user gesture. */\n  open: () => void;\n  /** Screen and deliver files that arrived some other way — a drop, a paste. Honours\n   *  `multiple` (only the first file without it) and every check. */\n  take: (files: ArrayLike<File> | null | undefined) => void;\n  /** The hidden input and the live region. Render it once, anywhere — it takes no\n   *  space and needs no positioned ancestor. */\n  element: ReactElement;\n}\n\n/**\n * The headless half of {@link FileButton}: a hidden file input you can open from any\n * control, with the reset, the screening and the announcement built in.\n *\n * ```tsx\n * const picker = useFilePicker({ accept: \".pdf\", onFiles: ([f]) => upload(f) });\n * return <>{picker.element}<DetailTableCard onAdd={picker.open} … /></>;\n * ```\n */\nexport function useFilePicker({\n  accept,\n  multiple,\n  capture,\n  maxSize,\n  maxFiles,\n  isValid,\n  invalidMessage,\n  onFiles,\n  onPick,\n  onReject,\n  disabled,\n  labels: labelsProp,\n}: UseFilePickerOptions): UseFilePickerReturn {\n  const inputRef = useRef<HTMLInputElement>(null);\n  const labels = useKitLabels(\"filePicker\", DEFAULT_FILE_PICKER_LABELS, labelsProp);\n  const fileText = useKitFileLabels();\n  // Assertive: a refusal is a failure the user has to hear before they move on, and\n  // it is the only thing this region ever says.\n  const { announce, regionProps } = useAnnounce({ politeness: \"assertive\" });\n\n  const take = (list: ArrayLike<File> | null | undefined) => {\n    if (disabled || !list || list.length === 0) return;\n    const all = Array.from(list);\n    const files = multiple ? all : all.slice(0, 1);\n    const { accepted, rejected } = screenFiles(\n      files,\n      // A single-file picker holds one file by definition; `maxFiles` is a multi-mode\n      // cap and would only ever say \"0\" there if a caller passed it by mistake.\n      { accept, maxSize, maxFiles: multiple ? maxFiles : undefined, isValid, invalidMessage },\n      labels,\n      fileText.size,\n    );\n    if (!judgePick(onPick, accepted, rejected)) {\n      if (rejected.length > 0) onReject?.(rejected);\n      announce(labels.rejectedPick(files.length));\n      return;\n    }\n    if (accepted.length > 0) onFiles?.(accepted);\n    if (rejected.length > 0) {\n      onReject?.(rejected);\n      announce(summariseRejections(rejected, labels));\n    }\n  };\n\n  const element = (\n    <>\n      <input\n        ref={inputRef}\n        type=\"file\"\n        accept={accept}\n        multiple={multiple}\n        capture={capture}\n        disabled={disabled}\n        // `hidden` (display: none), not `sr-only`: the control a user reaches is the\n        // button, and a second, nameless tab stop for the same action is noise. A\n        // display:none file input still opens on `.click()` in every current browser —\n        // and, unlike `sr-only`, it cannot escape to the initial containing block and\n        // stretch the page (see the note in `file-dropzone.tsx`).\n        className=\"hidden\"\n        tabIndex={-1}\n        aria-hidden\n        onChange={(e) => {\n          // Copy BEFORE the reset: `files` is a live view of the input's value, and\n          // clearing the value empties it.\n          const picked = Array.from(e.currentTarget.files ?? []);\n          e.currentTarget.value = \"\";\n          take(picked);\n        }}\n      />\n      <span {...regionProps} />\n    </>\n  );\n\n  return {\n    open: () => {\n      if (!disabled) inputRef.current?.click();\n    },\n    take,\n    element,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/hooks/use-file-picker.tsx"],"sourcesContent":["import { useRef } from \"react\";\nimport type { ReactElement } from \"react\";\nimport { useAnnounce } from \"./use-announce\";\nimport { useKitFileLabels, useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { DEFAULT_FILE_PICKER_LABELS } from \"./use-file-picker-labels\";\n\n/**\n * The file pickers' headless half: the hidden input, the screening of a pick and the\n * announcement of a refusal, which {@link FileButton}, `FileDropzone` and {@link useFileDrop}\n * are built on.\n *\n * In hooks/ since 0.34 (MOD-8, refactor audit 2026-10). It lived in\n * components/file-button.tsx, and `useFileDrop` — a hook — imported it from there, so\n * hooks/ reached up into components/. components/file-button re-exports all of it, so an\n * import from there keeps working.\n */\n\n/* ── Labels ──────────────────────────────────────────────────────────────── */\n\n/** Every string the file pickers ({@link FileButton}, `FileDropzone`) render or speak.\n *  Messages are functions of the file name so a translation can put it anywhere. */\nexport interface FilePickerLabels {\n  /** The file's type is not in `accept`, when no `accept` is known to name (see\n   *  `rejectedTypeOnly`). */\n  rejectedType: (name: string) => string;\n  /** The file's type is not in `accept`, naming what IS accepted: `accept`'s tokens,\n   *  lower-cased and joined with \", \" (`\".csv\"` => \"Only .csv files\"). Used whenever\n   *  `accept` is set — kastlan kept a custom `isValid` + `invalidMessage` per form only\n   *  to say this, and `accept` already knows it. */\n  rejectedTypeOnly: (accept: string, name: string) => string;\n  /** The file is larger than `maxSize`; `maxSize` arrives formatted (\"5 MB\"). */\n  rejectedSize: (name: string, maxSize: string) => string;\n  /** The file was one too many for `maxFiles`. */\n  rejectedCount: (name: string, maxFiles: number) => string;\n  /** `isValid` said no and the caller gave no `invalidMessage`. */\n  rejectedInvalid: (name: string) => string;\n  /** Spoken instead of the per-file message when more than one file was refused. */\n  rejectedMany: (count: number) => string;\n  /** Spoken (and shown, on a dropzone) when `onPick` refused the WHOLE pick.\n   *  Receives the number of files in it. */\n  rejectedPick: (count: number) => string;\n  /** Spoken after a pick the component itself echoes (the dropzone). */\n  selected: (count: number, firstName: string) => string;\n  /** The dropzone's remove button for one file. */\n  remove: (name: string) => string;\n  /** The dropzone's remove-everything button in `multiple` mode. */\n  clearAll: string;\n  /** Spoken after a remove / clear, since the button that was pressed is gone. */\n  removed: (name: string) => string;\n  cleared: string;\n  /** The dropzone's accessible name, when the host passes no `dropLabel`. */\n  dropzone: string;\n  /** The dropzone's Browse button, when the host passes no `browseLabel`. */\n  browse: string;\n  /** What an empty single-file dropzone says (no `emptyLabel` given). */\n  empty: string;\n  /** …and an empty `multiple` one. */\n  emptyMultiple: string;\n  /** The dropzone's second line (no `hint` given). Receives `accept` as a person\n   *  reads it (`\".pdf, image/png\"`), or `\"\"` when anything goes. */\n  hint: (accept: string) => string;\n  /** What a `busy` dropzone says in place of its body (\"Uploading…\"). */\n  busy: string;\n}\n\n/* ── Screening ───────────────────────────────────────────────────────────── */\n\nexport type FileRejectionReason = \"type\" | \"size\" | \"count\" | \"invalid\";\n\n/** One file the picker refused, and why. `message` is already translated (see\n *  {@link FilePickerLabels}, or the caller's `invalidMessage`), so a host that just\n *  wants to show it can render `rejections[0].message` as is. */\nexport interface FileRejection {\n  file: File;\n  reason: FileRejectionReason;\n  message: string;\n}\n\n/**\n * Does `file` satisfy an `accept` string, the way the browser's dialog reads it?\n * Comma-separated tokens: `.ext` (case-insensitive suffix of the name), `type/*`\n * (a MIME family) or an exact MIME type. An empty or absent `accept` takes anything.\n *\n * A file with no `type` — common for `.step`, `.dat`, anything the OS has no MIME\n * mapping for — can only match by extension, which is why lenkbank lists `.stp` AND\n * `model/step`: that is how `accept` has to be written for the dialog anyway.\n */\nexport function matchesAccept(file: File, accept: string | undefined): boolean {\n  const tokens = (accept ?? \"\")\n    .split(\",\")\n    .map((t) => t.trim().toLowerCase())\n    .filter(Boolean);\n  if (tokens.length === 0) return true;\n  const name = file.name.toLowerCase();\n  // An EMPTY type is the browser saying \"I don't know\", not \"it's something else\": HEIC\n  // photos on Windows without the codec arrive with `type === \"\"`. Refusing them\n  // (0.6.0) refused iPhone photos the picker itself had just offered (keksdose). So a\n  // missing type is inferred from the extension where that is unambiguous, and a file\n  // whose type cannot be known at all is given the benefit of the doubt — nothing here\n  // proves it does not match, and the server validates what it receives anyway.\n  const type = (file.type || typeFromExtension(name) || \"\").toLowerCase();\n  if (!type && !tokens.every((t) => t.startsWith(\".\"))) return true;\n  return tokens.some((token) => {\n    if (token.startsWith(\".\")) return name.endsWith(token);\n    if (!type) return false;\n    if (token.endsWith(\"/*\")) return type.startsWith(token.slice(0, -1));\n    return type === token;\n  });\n}\n\n/** MIME types for the extensions a browser most often leaves untyped. */\nconst EXTENSION_TYPES: Record<string, string> = {\n  heic: \"image/heic\",\n  heif: \"image/heif\",\n  avif: \"image/avif\",\n  webp: \"image/webp\",\n  jpg: \"image/jpeg\",\n  jpeg: \"image/jpeg\",\n  png: \"image/png\",\n  gif: \"image/gif\",\n  pdf: \"application/pdf\",\n  csv: \"text/csv\",\n  txt: \"text/plain\",\n};\n\nfunction typeFromExtension(name: string): string | undefined {\n  const dot = name.lastIndexOf(\".\");\n  return dot === -1 ? undefined : EXTENSION_TYPES[name.slice(dot + 1)];\n}\n\n/** @internal `\" .PDF, image/png ,\"` => `\".pdf, image/png\"` — `accept` as a person reads\n *  it. Also the dropzone's default hint. */\nexport function formatAccept(accept: string): string {\n  return accept\n    .split(\",\")\n    .map((t) => t.trim().toLowerCase())\n    .filter(Boolean)\n    .join(\", \");\n}\n\n/** What the pickers screen a pick with. All optional; nothing set accepts everything. */\nexport interface FileScreenOptions {\n  accept?: string;\n  /** Bytes. Larger files are refused with reason `\"size\"`. */\n  maxSize?: number;\n  /** How many files one pick may deliver. The rest are refused with reason `\"count\"`\n   *  — first come, first kept. For a running cap (\"at most 5 attachments\") pass what\n   *  is LEFT: `maxFiles={5 - attachments.length}`. */\n  maxFiles?: number;\n  /** The caller's own check, after `accept` and `maxSize`. */\n  isValid?: (file: File) => boolean;\n  /** The message for an `isValid` refusal; `labels.rejectedInvalid` otherwise. */\n  invalidMessage?: string;\n}\n\n/** @internal Split a pick into the files that pass and the ones that do not. */\nexport function screenFiles(\n  files: readonly File[],\n  opts: FileScreenOptions,\n  labels: FilePickerLabels,\n  formatSize: (bytes: number) => string,\n): { accepted: File[]; rejected: FileRejection[] } {\n  const accepted: File[] = [];\n  const rejected: FileRejection[] = [];\n  // Name what `accept` takes (\"Only .csv files\") — unless the host translated\n  // `rejectedType` but not yet `rejectedTypeOnly`: its own sentence beats an English one.\n  const acceptText = opts.accept ? formatAccept(opts.accept) : \"\";\n  const useOnly =\n    acceptText !== \"\" &&\n    (labels.rejectedTypeOnly !== DEFAULT_FILE_PICKER_LABELS.rejectedTypeOnly ||\n      labels.rejectedType === DEFAULT_FILE_PICKER_LABELS.rejectedType);\n  const typeMessage = (name: string) =>\n    useOnly ? labels.rejectedTypeOnly(acceptText, name) : labels.rejectedType(name);\n  for (const file of files) {\n    let reason: FileRejectionReason | null = null;\n    if (!matchesAccept(file, opts.accept)) reason = \"type\";\n    else if (opts.maxSize !== undefined && file.size > opts.maxSize) reason = \"size\";\n    else if (opts.isValid && !opts.isValid(file)) reason = \"invalid\";\n    // Count last, and only against files that passed everything else: a refused\n    // file should not use up one of the slots a good one could have had.\n    else if (opts.maxFiles !== undefined && accepted.length >= opts.maxFiles) reason = \"count\";\n    if (reason === null) {\n      accepted.push(file);\n      continue;\n    }\n    const message =\n      reason === \"type\"\n        ? typeMessage(file.name)\n        : reason === \"size\"\n          ? labels.rejectedSize(file.name, formatSize(opts.maxSize ?? 0))\n          : reason === \"count\"\n            ? labels.rejectedCount(file.name, Math.max(0, opts.maxFiles ?? 0))\n            : (opts.invalidMessage ?? labels.rejectedInvalid(file.name));\n    rejected.push({ file, reason, message });\n  }\n  return { accepted, rejected };\n}\n\n/**\n * Judges a pick as a whole — keksdose's \"refuse the pick if any file is bad\", which\n * with `onFiles` + `onReject` alone had to be rebuilt from two calls in a microtask.\n *\n * Called ONCE per pick, after screening and before `onFiles` / `onReject`, with both\n * halves (either may be empty). Return `false` to refuse the whole pick: the accepted\n * files are not delivered, `onReject` still receives what screening refused, and one\n * sentence (`labels.rejectedPick`) is spoken for the pick instead of a per-file one.\n * Return nothing to let the pick through as usual.\n *\n * ```tsx\n * onPick={(ok, bad) => bad.length === 0 || false}  // all or nothing\n * ```\n */\nexport type FilePickHandler = (accepted: File[], rejected: FileRejection[]) => boolean | void;\n\n/** @internal The shared tail of both pickers: run `onPick`, and say whether the pick\n *  stands. A pick with nothing accepted has nothing to refuse, so `false` there is\n *  treated as no verdict and the usual per-file messages are kept. */\nexport function judgePick(onPick: FilePickHandler | undefined, accepted: File[], rejected: FileRejection[]): boolean {\n  if (!onPick) return true;\n  return onPick(accepted, rejected) !== false || accepted.length === 0;\n}\n\n/** One sentence for a whole batch of refusals: the file's own message for one, a\n *  count for several — reading out five sentences in a row helps nobody. */\nexport function summariseRejections(rejected: readonly FileRejection[], labels: FilePickerLabels): string {\n  if (rejected.length === 0) return \"\";\n  if (rejected.length === 1) return rejected[0].message;\n  return labels.rejectedMany(rejected.length);\n}\n\n/* ── useFilePicker ───────────────────────────────────────────────────────── */\n\nexport interface UseFilePickerOptions extends FileScreenOptions {\n  /** Let one pick deliver several files. Without it a drop of several keeps the first. */\n  multiple?: boolean;\n  /**\n   * Ask a phone for its camera instead of the file chooser: `\"environment\"` is the\n   * back camera, `\"user\"` the front. A HINT — desktop browsers ignore it, and Chrome\n   * drops it when `multiple` is also set (a camera cannot deliver a list), which is why\n   * keksdose's camera input has no `multiple`. Pass one or the other. Android Chrome may\n   * still show its Camera-or-Files sheet for it (keksdose live #292); `CameraButton` (0.55)\n   * opens the camera in the page instead and keeps this as its fallback.\n   */\n  capture?: boolean | \"user\" | \"environment\";\n  /** The files that passed, in pick order. Never called with an empty array.\n   *  Optional since 0.7 for a caller that takes the pick through `onPick` alone. */\n  onFiles?: (files: File[]) => void;\n  /** See {@link FilePickHandler}: the whole pick at once, with the power to refuse it. */\n  onPick?: FilePickHandler;\n  /** The files that did not, with a translated message each. The refusals are also\n   *  spoken through a live region, so this is for SHOWING them, not for a11y. */\n  onReject?: (rejections: FileRejection[]) => void;\n  /** `open()` and `take()` do nothing while set. */\n  disabled?: boolean;\n  /** Per-instance overrides of the `filePicker` label namespace. */\n  labels?: LabelOverride<FilePickerLabels>;\n}\n\nexport interface UseFilePickerReturn {\n  /** Open the system picker. Call it from a click handler — browsers only open a file\n   *  dialog in response to a user gesture. */\n  open: () => void;\n  /** Screen and deliver files that arrived some other way — a drop, a paste. Honours\n   *  `multiple` (only the first file without it) and every check. */\n  take: (files: ArrayLike<File> | null | undefined) => void;\n  /** The hidden input and the live region. Render it once, anywhere — it takes no\n   *  space and needs no positioned ancestor. */\n  element: ReactElement;\n}\n\n/**\n * The headless half of {@link FileButton}: a hidden file input you can open from any\n * control, with the reset, the screening and the announcement built in.\n *\n * ```tsx\n * const picker = useFilePicker({ accept: \".pdf\", onFiles: ([f]) => upload(f) });\n * return <>{picker.element}<DetailTableCard onAdd={picker.open} … /></>;\n * ```\n */\nexport function useFilePicker({\n  accept,\n  multiple,\n  capture,\n  maxSize,\n  maxFiles,\n  isValid,\n  invalidMessage,\n  onFiles,\n  onPick,\n  onReject,\n  disabled,\n  labels: labelsProp,\n}: UseFilePickerOptions): UseFilePickerReturn {\n  const inputRef = useRef<HTMLInputElement>(null);\n  const labels = useKitLabels(\"filePicker\", DEFAULT_FILE_PICKER_LABELS, labelsProp);\n  const fileText = useKitFileLabels();\n  // Assertive: a refusal is a failure the user has to hear before they move on, and\n  // it is the only thing this region ever says.\n  const { announce, regionProps } = useAnnounce({ politeness: \"assertive\" });\n\n  const take = (list: ArrayLike<File> | null | undefined) => {\n    if (disabled || !list || list.length === 0) return;\n    const all = Array.from(list);\n    const files = multiple ? all : all.slice(0, 1);\n    const { accepted, rejected } = screenFiles(\n      files,\n      // A single-file picker holds one file by definition; `maxFiles` is a multi-mode\n      // cap and would only ever say \"0\" there if a caller passed it by mistake.\n      { accept, maxSize, maxFiles: multiple ? maxFiles : undefined, isValid, invalidMessage },\n      labels,\n      fileText.size,\n    );\n    if (!judgePick(onPick, accepted, rejected)) {\n      if (rejected.length > 0) onReject?.(rejected);\n      announce(labels.rejectedPick(files.length));\n      return;\n    }\n    if (accepted.length > 0) onFiles?.(accepted);\n    if (rejected.length > 0) {\n      onReject?.(rejected);\n      announce(summariseRejections(rejected, labels));\n    }\n  };\n\n  const element = (\n    <>\n      <input\n        ref={inputRef}\n        type=\"file\"\n        accept={accept}\n        multiple={multiple}\n        capture={capture}\n        disabled={disabled}\n        // `hidden` (display: none), not `sr-only`: the control a user reaches is the\n        // button, and a second, nameless tab stop for the same action is noise. A\n        // display:none file input still opens on `.click()` in every current browser —\n        // and, unlike `sr-only`, it cannot escape to the initial containing block and\n        // stretch the page (see the note in `file-dropzone.tsx`).\n        className=\"hidden\"\n        tabIndex={-1}\n        aria-hidden\n        onChange={(e) => {\n          // Copy BEFORE the reset: `files` is a live view of the input's value, and\n          // clearing the value empties it.\n          const picked = Array.from(e.currentTarget.files ?? []);\n          e.currentTarget.value = \"\";\n          take(picked);\n        }}\n      />\n      <span {...regionProps} />\n    </>\n  );\n\n  return {\n    open: () => {\n      if (!disabled) inputRef.current?.click();\n    },\n    take,\n    element,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/hooks/use-focus-trap.d.ts

@@ -20,7 +20,9 @@
  *     filtered away). Calling `.focus()` on a detached node silently drops focus to
  *     `<body>`, which for a keyboard user means losing their place in the page
  *     entirely. When the target is gone, focus falls back to the nearest thing that
- *     still exists rather than to nothing.
+ *     still exists rather than to nothing — the kit's one rule for it, lib/focus-left's
+ *     `returnFocus` (0.52 code review 2026-10-31, held to 0.55; see the cleanup). Until
+ *     then this said so and did not: a gone opener left the focus on `<body>`.
  *   - **Leaves an app's own autofocus alone** (0.33.1). React honours a child's
  *     `autoFocus` while it commits, and this hook's effect runs AFTER that commit, so
  *     focusing the container there took focus straight back off the field the app had
@@ -36,8 +38,22 @@ export { firstTabStop, tabStops } from "../lib/focus-left.js";
 export interface FocusTrapOptions {
     /** Trap only while this is true. Mount-time `true` is the common case. */
     active?: boolean;
-    /** Return focus to whatever had it before the trap engaged. Default `true`. */
+    /**
+     * Give the focus back as the trap is released — the kit's one rule, lib/focus-left's
+     * `returnFocus` (0.52 code review 2026-10-31, held to 0.55): only a focus that was lost
+     * or is still inside the container is moved; to the {@link opener}, else to what had
+     * the focus as the trap engaged, else to the tab stops that stood around that, nearest
+     * first; never to `<body>`. Default `true`.
+     */
     restoreFocus?: boolean;
+    /**
+     * The control this overlay was opened from, when it knows it — its trigger. The focus
+     * goes back there first, and to what had it as the trap engaged only when the trigger
+     * cannot take it. Read as the trap is released. A Popover names its trigger: on Safari
+     * (and Firefox on macOS) a click does not focus the button it lands on, so "what had the
+     * focus" was the page, and the focus fell to `<body>` on close (0.55).
+     */
+    opener?: () => Element | null;
     /**
      * What to focus when the trap engages. Default is the container itself, which is
      * what `Modal` does and why: focusing the first FIELD pops the software keyboard on
@@ -54,4 +70,4 @@ export interface FocusTrapOptions {
      */
     initialFocus?: "container" | "first" | (() => HTMLElement | null);
 }
-export declare function useFocusTrap(containerRef: React.RefObject<HTMLElement | null>, { active, restoreFocus, initialFocus }?: FocusTrapOptions): void;
+export declare function useFocusTrap(containerRef: React.RefObject<HTMLElement | null>, { active, restoreFocus, initialFocus, opener: namedOpener }?: FocusTrapOptions): void;

package/dist/hooks/use-focus-trap.js

@@ -1,15 +1,15 @@
 "use client";
 import { useEffect, useLayoutEffect, useRef, useState } from "react";
-import { tabStops } from "../lib/focus-left.js";
+import { returnFocus, tabStops, tabStopsAround } from "../lib/focus-left.js";
 import { firstTabStop, tabStops as tabStops2 } from "../lib/focus-left.js";
 const TRAP_ATTR = "data-focus-trap";
 function focusedElement() {
   return typeof document === "undefined" ? null : document.activeElement;
 }
-function useFocusTrap(containerRef, { active = true, restoreFocus = true, initialFocus = "container" } = {}) {
-  const optsRef = useRef({ active, restoreFocus, initialFocus });
+function useFocusTrap(containerRef, { active = true, restoreFocus = true, initialFocus = "container", opener: namedOpener } = {}) {
+  const optsRef = useRef({ active, restoreFocus, initialFocus, opener: namedOpener });
   useLayoutEffect(() => {
-    optsRef.current = { active, restoreFocus, initialFocus };
+    optsRef.current = { active, restoreFocus, initialFocus, opener: namedOpener };
   });
   const [opener, setOpener] = useState(void 0);
   if (active && opener === void 0) setOpener(focusedElement());
@@ -30,6 +30,11 @@ function useFocusTrap(containerRef, { active = true, restoreFocus = true, initia
       // inner panel's last control wraps to the OUTER panel's first.
       (el) => !inNestedTrap(el)
     );
+    const around = [];
+    if (optsRef.current.restoreFocus && opener instanceof Element && opener.isConnected && opener !== document.body) {
+      const { after, before } = tabStopsAround(opener, 3);
+      for (const stop of [...after, ...before]) if (!container.contains(stop)) around.push(stop);
+    }
     const { initialFocus: how } = optsRef.current;
     const focused = document.activeElement;
     const childHasFocus = focused !== container && container.contains(focused);
@@ -64,7 +69,12 @@ function useFocusTrap(containerRef, { active = true, restoreFocus = true, initia
       container.removeAttribute(TRAP_ATTR);
       if (container.isConnected && optsRef.current.active) return;
       if (!optsRef.current.restoreFocus) return;
-      if (opener?.isConnected) opener.focus?.();
+      const named = optsRef.current.opener?.();
+      returnFocus({
+        opener: named ?? opener,
+        fallback: [named ? opener : null, ...around],
+        closing: container.isConnected ? container : null
+      });
     };
   }, [active, containerRef, opener]);
 }

package/dist/hooks/use-focus-trap.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/use-focus-trap.ts"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef, useState } from \"react\";\nimport { tabStops } from \"../lib/focus-left\";\n\n/**\n * Keep keyboard focus inside an open overlay, and give it back when it closes.\n *\n * Extracted from `Modal`, which was the ONLY component in this package that did any of\n * this. Every other overlay — the full-bleed dialog a phone's row editor opens, the\n * picker sheet, the numpad, the tour card — declared `role=\"dialog\" aria-modal=\"true\"`\n * and then left focus on the page behind it. That is the worst of the two possible\n * bugs: assistive technology hides the page because of `aria-modal`, while the user's\n * focus is still down there in the part that is now hidden, so Tab walks through\n * controls the screen reader refuses to describe.\n *\n * What this does beyond Modal's original copy:\n *\n *   - **Recomputes the tabbable list on every Tab**, not once when the overlay opens.\n *     These panels have conditionally-rendered contents — a search box that appears\n *     once options load, a \"clear\" button that exists only while a filter is set — and\n *     a list captured at open time traps focus against elements that have since gone.\n *   - **Guards the restore target.** The element focused before opening may have left\n *     the DOM by the time the overlay closes (the row that owned the button was\n *     filtered away). Calling `.focus()` on a detached node silently drops focus to\n *     `<body>`, which for a keyboard user means losing their place in the page\n *     entirely. When the target is gone, focus falls back to the nearest thing that\n *     still exists rather than to nothing.\n *   - **Leaves an app's own autofocus alone** (0.33.1). React honours a child's\n *     `autoFocus` while it commits, and this hook's effect runs AFTER that commit, so\n *     focusing the container there took focus straight back off the field the app had\n *     asked for. See `initialFocus`.\n *   - **Nests.** An overlay can open another — a picker inside a dialog. Only the\n *     innermost trap handles a keystroke, and closing it hands control back to the one\n *     underneath. Innermost is decided by DOM containment rather than by mount order;\n *     see the note on `TRAP_ATTR` for why the obvious stack is wrong.\n *     `use-overlay-history.ts` reasons about the same nesting problem for the back\n *     button; this is the focus half of it.\n */\n\n// The trap's reading of \"a Tab lands here\" is lib/focus-left's `tabStops` — the kit's one\n// copy of the rule since the 0.52 code review (round 0.34 BUG-4's history is there).\n// Re-exported where refactor audit 2026-10-30, DUP-9 put them, for a part that walks Tab\n// over something that is not a trap (the tour's field + card ring).\nexport { firstTabStop, tabStops } from \"../lib/focus-left\";\n\n/**\n * Marks a container whose trap is currently active.\n *\n * \"Which trap is innermost?\" is answered by DOM CONTAINMENT, not by mount order. The\n * obvious implementation — a module-level stack pushed in the effect — is wrong, and\n * wrong in a way that passes a casual reading: React runs CHILD effects before PARENT\n * effects, so a nested overlay pushes first and the outer one ends up on top of the\n * stack, claiming to be innermost. The outer trap then handles the keystroke and wraps\n * focus to its own first element, jumping the user out of the picker they had open.\n *\n * An attribute on the live DOM cannot disagree with the DOM.\n */\nconst TRAP_ATTR = \"data-focus-trap\";\n\nexport interface FocusTrapOptions {\n  /** Trap only while this is true. Mount-time `true` is the common case. */\n  active?: boolean;\n  /** Return focus to whatever had it before the trap engaged. Default `true`. */\n  restoreFocus?: boolean;\n  /**\n   * What to focus when the trap engages. Default is the container itself, which is\n   * what `Modal` does and why: focusing the first FIELD pops the software keyboard on\n   * a phone the moment a dialog opens, before the user has asked to type.\n   * The container needs `tabIndex={-1}` for this to work.\n   *\n   * `\"container\"` and `\"first\"` both step aside when focus is ALREADY inside the\n   * container, on something other than the container itself. That is a child the app\n   * focused on purpose — an `autoFocus`, which React honours before this hook's effect\n   * runs — and the keyboard it brings up is the one the user was promised. Moving focus\n   * off it lost keksdose's create card its amount field the instant it got it, and on a\n   * phone the numpad sheet with it, which shows only while the field is focused (live\n   * #402). A function is the caller's explicit choice and is always followed.\n   */\n  initialFocus?: \"container\" | \"first\" | (() => HTMLElement | null);\n}\n\n/** Whatever has focus right now; nothing on the server, where there is no document. */\nfunction focusedElement(): Element | null {\n  return typeof document === \"undefined\" ? null : document.activeElement;\n}\n\nexport function useFocusTrap(\n  containerRef: React.RefObject<HTMLElement | null>,\n  { active = true, restoreFocus = true, initialFocus = \"container\" }: FocusTrapOptions = {},\n): void {\n  // Latest-ref so a caller passing an inline `initialFocus` thunk — which every caller\n  // will — does not tear the trap down and re-engage it on each render, stealing focus\n  // back to the top of the panel mid-interaction. Written in a LAYOUT effect so that\n  // the trap's cleanup, which runs after the layout effects of the same commit, reads\n  // this render's `active` rather than the last one's — see the cleanup for why.\n  const optsRef = useRef({ active, restoreFocus, initialFocus });\n  useLayoutEffect(() => {\n    optsRef.current = { active, restoreFocus, initialFocus };\n  });\n\n  // Where focus was BEFORE the trap engaged: the element it is given back to on close.\n  //\n  // Read DURING the render that turns the trap on, and that timing is the point. React\n  // honours a child's `autoFocus` while it commits that render, before any effect runs,\n  // so the effect below asking `document.activeElement` would get the child, inside the\n  // overlay. Restoring to that on close aimed focus at the dialog that was closing —\n  // already out of the DOM, so focus fell to <body> rather than going back to the\n  // button that opened it.\n  //\n  // State adjusted during render (the pattern `Modal` uses for `open`) rather than a\n  // ref written there: set once per opening and cleared on release, so a re-render\n  // while open cannot replace it with something inside, and StrictMode's second render\n  // and second effect both see the same element. `undefined` means \"not captured\";\n  // `null` is a capture that found nothing.\n  const [opener, setOpener] = useState<Element | null | undefined>(undefined);\n  if (active && opener === undefined) setOpener(focusedElement());\n  else if (!active && opener !== undefined) setOpener(undefined);\n\n  useEffect(() => {\n    if (!active) return;\n    const container = containerRef.current;\n    if (!container) return;\n\n    container.setAttribute(TRAP_ATTR, \"\");\n\n    /** Is `node` inside a trap nested within this one? */\n    const inNestedTrap = (node: Element | null) => {\n      if (!node) return false;\n      const owner = node.closest(`[${TRAP_ATTR}]`);\n      return owner !== null && owner !== container;\n    };\n\n    const tabbables = () =>\n      tabStops(container, { includeSelf: false }).filter(\n        // A tabbable inside a NESTED open overlay belongs to that overlay's trap, not\n        // to this one — otherwise the outer list spans both panels and Tab from the\n        // inner panel's last control wraps to the OUTER panel's first.\n        (el) => !inNestedTrap(el),\n      );\n\n    const { initialFocus: how } = optsRef.current;\n    const focused = document.activeElement;\n    // A child that already has focus was given it on purpose — see `initialFocus`.\n    const childHasFocus = focused !== container && container.contains(focused);\n    if (typeof how === \"function\") {\n      (how() ?? container).focus();\n    } else if (!childHasFocus) {\n      (how === \"first\" ? (tabbables()[0] ?? container) : container).focus();\n    }\n\n    const onKeyDown = (e: KeyboardEvent) => {\n      if (e.key !== \"Tab\") return;\n      // Only the innermost trap acts. The event bubbles through every ancestor\n      // container, so without this an outer dialog and an inner picker both handle one\n      // Tab and fight over where focus lands.\n      if (inNestedTrap(document.activeElement)) return;\n\n      // Recomputed per keystroke — see the note at the top of this file.\n      const items = tabbables();\n      if (items.length === 0) {\n        e.preventDefault();\n        container.focus();\n        return;\n      }\n      const first = items[0];\n      const last = items[items.length - 1];\n      const activeEl = document.activeElement;\n      if (e.shiftKey && (activeEl === first || activeEl === container)) {\n        e.preventDefault();\n        last.focus();\n      } else if (!e.shiftKey && activeEl === last) {\n        e.preventDefault();\n        first.focus();\n      }\n    };\n\n    // On the container, not the document: a portalled child panel (an open dropdown\n    // rendered to <body>) is outside this subtree and manages its own focus, which is\n    // the behaviour Modal's comment describes and consumers already depend on.\n    container.addEventListener(\"keydown\", onKeyDown);\n\n    return () => {\n      container.removeEventListener(\"keydown\", onKeyDown);\n      container.removeAttribute(TRAP_ATTR);\n\n      // Only when the trap is really being released: the container has left the page,\n      // or `active` has turned false. StrictMode runs this cleanup once more right after\n      // mounting, with the overlay still up, and then the effect again — and React does\n      // not re-apply `autoFocus` for that second run. Restoring here would pull focus\n      // out of the autofocused field for good: live #402 again, in development.\n      if (container.isConnected && optsRef.current.active) return;\n      if (!optsRef.current.restoreFocus) return;\n      // `isConnected` is the whole point: restoring to a node that has been removed\n      // sends focus to <body> and the user loses their place entirely. When the\n      // original is gone, leave focus where the browser put it rather than moving it\n      // somewhere arbitrary — a wrong guess is worse than no move.\n      if (opener?.isConnected) (opener as HTMLElement).focus?.();\n    };\n  }, [active, containerRef, opener]);\n}\n"],"mappings":";AAAA,SAAS,WAAW,iBAAiB,QAAQ,gBAAgB;AAC7D,SAAS,gBAAgB;AAyCzB,SAAS,cAAc,YAAAA,iBAAgB;AAcvC,MAAM,YAAY;AAyBlB,SAAS,iBAAiC;AACxC,SAAO,OAAO,aAAa,cAAc,OAAO,SAAS;AAC3D;AAEO,SAAS,aACd,cACA,EAAE,SAAS,MAAM,eAAe,MAAM,eAAe,YAAY,IAAsB,CAAC,GAClF;AAMN,QAAM,UAAU,OAAO,EAAE,QAAQ,cAAc,aAAa,CAAC;AAC7D,kBAAgB,MAAM;AACpB,YAAQ,UAAU,EAAE,QAAQ,cAAc,aAAa;AAAA,EACzD,CAAC;AAgBD,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAqC,MAAS;AAC1E,MAAI,UAAU,WAAW,OAAW,WAAU,eAAe,CAAC;AAAA,WACrD,CAAC,UAAU,WAAW,OAAW,WAAU,MAAS;AAE7D,YAAU,MAAM;AACd,QAAI,CAAC,OAAQ;AACb,UAAM,YAAY,aAAa;AAC/B,QAAI,CAAC,UAAW;AAEhB,cAAU,aAAa,WAAW,EAAE;AAGpC,UAAM,eAAe,CAAC,SAAyB;AAC7C,UAAI,CAAC,KAAM,QAAO;AAClB,YAAM,QAAQ,KAAK,QAAQ,IAAI,SAAS,GAAG;AAC3C,aAAO,UAAU,QAAQ,UAAU;AAAA,IACrC;AAEA,UAAM,YAAY,MAChB,SAAS,WAAW,EAAE,aAAa,MAAM,CAAC,EAAE;AAAA;AAAA;AAAA;AAAA,MAI1C,CAAC,OAAO,CAAC,aAAa,EAAE;AAAA,IAC1B;AAEF,UAAM,EAAE,cAAc,IAAI,IAAI,QAAQ;AACtC,UAAM,UAAU,SAAS;AAEzB,UAAM,gBAAgB,YAAY,aAAa,UAAU,SAAS,OAAO;AACzE,QAAI,OAAO,QAAQ,YAAY;AAC7B,OAAC,IAAI,KAAK,WAAW,MAAM;AAAA,IAC7B,WAAW,CAAC,eAAe;AACzB,OAAC,QAAQ,UAAW,UAAU,EAAE,CAAC,KAAK,YAAa,WAAW,MAAM;AAAA,IACtE;AAEA,UAAM,YAAY,CAAC,MAAqB;AACtC,UAAI,EAAE,QAAQ,MAAO;AAIrB,UAAI,aAAa,SAAS,aAAa,EAAG;AAG1C,YAAM,QAAQ,UAAU;AACxB,UAAI,MAAM,WAAW,GAAG;AACtB,UAAE,eAAe;AACjB,kBAAU,MAAM;AAChB;AAAA,MACF;AACA,YAAM,QAAQ,MAAM,CAAC;AACrB,YAAM,OAAO,MAAM,MAAM,SAAS,CAAC;AACnC,YAAM,WAAW,SAAS;AAC1B,UAAI,EAAE,aAAa,aAAa,SAAS,aAAa,YAAY;AAChE,UAAE,eAAe;AACjB,aAAK,MAAM;AAAA,MACb,WAAW,CAAC,EAAE,YAAY,aAAa,MAAM;AAC3C,UAAE,eAAe;AACjB,cAAM,MAAM;AAAA,MACd;AAAA,IACF;AAKA,cAAU,iBAAiB,WAAW,SAAS;AAE/C,WAAO,MAAM;AACX,gBAAU,oBAAoB,WAAW,SAAS;AAClD,gBAAU,gBAAgB,SAAS;AAOnC,UAAI,UAAU,eAAe,QAAQ,QAAQ,OAAQ;AACrD,UAAI,CAAC,QAAQ,QAAQ,aAAc;AAKnC,UAAI,QAAQ,YAAa,CAAC,OAAuB,QAAQ;AAAA,IAC3D;AAAA,EACF,GAAG,CAAC,QAAQ,cAAc,MAAM,CAAC;AACnC;","names":["tabStops"]}
+{"version":3,"sources":["../../src/hooks/use-focus-trap.ts"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef, useState } from \"react\";\nimport { returnFocus, tabStops, tabStopsAround } from \"../lib/focus-left\";\n\n/**\n * Keep keyboard focus inside an open overlay, and give it back when it closes.\n *\n * Extracted from `Modal`, which was the ONLY component in this package that did any of\n * this. Every other overlay — the full-bleed dialog a phone's row editor opens, the\n * picker sheet, the numpad, the tour card — declared `role=\"dialog\" aria-modal=\"true\"`\n * and then left focus on the page behind it. That is the worst of the two possible\n * bugs: assistive technology hides the page because of `aria-modal`, while the user's\n * focus is still down there in the part that is now hidden, so Tab walks through\n * controls the screen reader refuses to describe.\n *\n * What this does beyond Modal's original copy:\n *\n *   - **Recomputes the tabbable list on every Tab**, not once when the overlay opens.\n *     These panels have conditionally-rendered contents — a search box that appears\n *     once options load, a \"clear\" button that exists only while a filter is set — and\n *     a list captured at open time traps focus against elements that have since gone.\n *   - **Guards the restore target.** The element focused before opening may have left\n *     the DOM by the time the overlay closes (the row that owned the button was\n *     filtered away). Calling `.focus()` on a detached node silently drops focus to\n *     `<body>`, which for a keyboard user means losing their place in the page\n *     entirely. When the target is gone, focus falls back to the nearest thing that\n *     still exists rather than to nothing — the kit's one rule for it, lib/focus-left's\n *     `returnFocus` (0.52 code review 2026-10-31, held to 0.55; see the cleanup). Until\n *     then this said so and did not: a gone opener left the focus on `<body>`.\n *   - **Leaves an app's own autofocus alone** (0.33.1). React honours a child's\n *     `autoFocus` while it commits, and this hook's effect runs AFTER that commit, so\n *     focusing the container there took focus straight back off the field the app had\n *     asked for. See `initialFocus`.\n *   - **Nests.** An overlay can open another — a picker inside a dialog. Only the\n *     innermost trap handles a keystroke, and closing it hands control back to the one\n *     underneath. Innermost is decided by DOM containment rather than by mount order;\n *     see the note on `TRAP_ATTR` for why the obvious stack is wrong.\n *     `use-overlay-history.ts` reasons about the same nesting problem for the back\n *     button; this is the focus half of it.\n */\n\n// The trap's reading of \"a Tab lands here\" is lib/focus-left's `tabStops` — the kit's one\n// copy of the rule since the 0.52 code review (round 0.34 BUG-4's history is there).\n// Re-exported where refactor audit 2026-10-30, DUP-9 put them, for a part that walks Tab\n// over something that is not a trap (the tour's field + card ring).\nexport { firstTabStop, tabStops } from \"../lib/focus-left\";\n\n/**\n * Marks a container whose trap is currently active.\n *\n * \"Which trap is innermost?\" is answered by DOM CONTAINMENT, not by mount order. The\n * obvious implementation — a module-level stack pushed in the effect — is wrong, and\n * wrong in a way that passes a casual reading: React runs CHILD effects before PARENT\n * effects, so a nested overlay pushes first and the outer one ends up on top of the\n * stack, claiming to be innermost. The outer trap then handles the keystroke and wraps\n * focus to its own first element, jumping the user out of the picker they had open.\n *\n * An attribute on the live DOM cannot disagree with the DOM.\n */\nconst TRAP_ATTR = \"data-focus-trap\";\n\nexport interface FocusTrapOptions {\n  /** Trap only while this is true. Mount-time `true` is the common case. */\n  active?: boolean;\n  /**\n   * Give the focus back as the trap is released — the kit's one rule, lib/focus-left's\n   * `returnFocus` (0.52 code review 2026-10-31, held to 0.55): only a focus that was lost\n   * or is still inside the container is moved; to the {@link opener}, else to what had\n   * the focus as the trap engaged, else to the tab stops that stood around that, nearest\n   * first; never to `<body>`. Default `true`.\n   */\n  restoreFocus?: boolean;\n  /**\n   * The control this overlay was opened from, when it knows it — its trigger. The focus\n   * goes back there first, and to what had it as the trap engaged only when the trigger\n   * cannot take it. Read as the trap is released. A Popover names its trigger: on Safari\n   * (and Firefox on macOS) a click does not focus the button it lands on, so \"what had the\n   * focus\" was the page, and the focus fell to `<body>` on close (0.55).\n   */\n  opener?: () => Element | null;\n  /**\n   * What to focus when the trap engages. Default is the container itself, which is\n   * what `Modal` does and why: focusing the first FIELD pops the software keyboard on\n   * a phone the moment a dialog opens, before the user has asked to type.\n   * The container needs `tabIndex={-1}` for this to work.\n   *\n   * `\"container\"` and `\"first\"` both step aside when focus is ALREADY inside the\n   * container, on something other than the container itself. That is a child the app\n   * focused on purpose — an `autoFocus`, which React honours before this hook's effect\n   * runs — and the keyboard it brings up is the one the user was promised. Moving focus\n   * off it lost keksdose's create card its amount field the instant it got it, and on a\n   * phone the numpad sheet with it, which shows only while the field is focused (live\n   * #402). A function is the caller's explicit choice and is always followed.\n   */\n  initialFocus?: \"container\" | \"first\" | (() => HTMLElement | null);\n}\n\n/** Whatever has focus right now; nothing on the server, where there is no document. */\nfunction focusedElement(): Element | null {\n  return typeof document === \"undefined\" ? null : document.activeElement;\n}\n\nexport function useFocusTrap(\n  containerRef: React.RefObject<HTMLElement | null>,\n  { active = true, restoreFocus = true, initialFocus = \"container\", opener: namedOpener }: FocusTrapOptions = {},\n): void {\n  // Latest-ref so a caller passing an inline `initialFocus` thunk — which every caller\n  // will — does not tear the trap down and re-engage it on each render, stealing focus\n  // back to the top of the panel mid-interaction. Written in a LAYOUT effect so that\n  // the trap's cleanup, which runs after the layout effects of the same commit, reads\n  // this render's `active` rather than the last one's — see the cleanup for why.\n  const optsRef = useRef({ active, restoreFocus, initialFocus, opener: namedOpener });\n  useLayoutEffect(() => {\n    optsRef.current = { active, restoreFocus, initialFocus, opener: namedOpener };\n  });\n\n  // Where focus was BEFORE the trap engaged: the element it is given back to on close.\n  //\n  // Read DURING the render that turns the trap on, and that timing is the point. React\n  // honours a child's `autoFocus` while it commits that render, before any effect runs,\n  // so the effect below asking `document.activeElement` would get the child, inside the\n  // overlay. Restoring to that on close aimed focus at the dialog that was closing —\n  // already out of the DOM, so focus fell to <body> rather than going back to the\n  // button that opened it.\n  //\n  // State adjusted during render (the pattern `Modal` uses for `open`) rather than a\n  // ref written there: set once per opening and cleared on release, so a re-render\n  // while open cannot replace it with something inside, and StrictMode's second render\n  // and second effect both see the same element. `undefined` means \"not captured\";\n  // `null` is a capture that found nothing.\n  const [opener, setOpener] = useState<Element | null | undefined>(undefined);\n  if (active && opener === undefined) setOpener(focusedElement());\n  else if (!active && opener !== undefined) setOpener(undefined);\n\n  useEffect(() => {\n    if (!active) return;\n    const container = containerRef.current;\n    if (!container) return;\n\n    container.setAttribute(TRAP_ATTR, \"\");\n\n    /** Is `node` inside a trap nested within this one? */\n    const inNestedTrap = (node: Element | null) => {\n      if (!node) return false;\n      const owner = node.closest(`[${TRAP_ATTR}]`);\n      return owner !== null && owner !== container;\n    };\n\n    const tabbables = () =>\n      tabStops(container, { includeSelf: false }).filter(\n        // A tabbable inside a NESTED open overlay belongs to that overlay's trap, not\n        // to this one — otherwise the outer list spans both panels and Tab from the\n        // inner panel's last control wraps to the OUTER panel's first.\n        (el) => !inNestedTrap(el),\n      );\n\n    // Where the focus goes if the opener has left by the release (the row that owned it\n    // was filtered away, deleted from the dialog it opened): the stops that stood around\n    // it, nearest first — after it, then before — as AlertBanner's × reads them. Read\n    // NOW, while the opener still has a place in the page to measure from; held by this\n    // closure only, so it goes with the trap. Three a side: one that takes the focus is\n    // all that is wanted.\n    const around: HTMLElement[] = [];\n    if (optsRef.current.restoreFocus && opener instanceof Element && opener.isConnected && opener !== document.body) {\n      const { after, before } = tabStopsAround(opener, 3);\n      for (const stop of [...after, ...before]) if (!container.contains(stop)) around.push(stop);\n    }\n\n    const { initialFocus: how } = optsRef.current;\n    const focused = document.activeElement;\n    // A child that already has focus was given it on purpose — see `initialFocus`.\n    const childHasFocus = focused !== container && container.contains(focused);\n    if (typeof how === \"function\") {\n      (how() ?? container).focus();\n    } else if (!childHasFocus) {\n      (how === \"first\" ? (tabbables()[0] ?? container) : container).focus();\n    }\n\n    const onKeyDown = (e: KeyboardEvent) => {\n      if (e.key !== \"Tab\") return;\n      // Only the innermost trap acts. The event bubbles through every ancestor\n      // container, so without this an outer dialog and an inner picker both handle one\n      // Tab and fight over where focus lands.\n      if (inNestedTrap(document.activeElement)) return;\n\n      // Recomputed per keystroke — see the note at the top of this file.\n      const items = tabbables();\n      if (items.length === 0) {\n        e.preventDefault();\n        container.focus();\n        return;\n      }\n      const first = items[0];\n      const last = items[items.length - 1];\n      const activeEl = document.activeElement;\n      if (e.shiftKey && (activeEl === first || activeEl === container)) {\n        e.preventDefault();\n        last.focus();\n      } else if (!e.shiftKey && activeEl === last) {\n        e.preventDefault();\n        first.focus();\n      }\n    };\n\n    // On the container, not the document: a portalled child panel (an open dropdown\n    // rendered to <body>) is outside this subtree and manages its own focus, which is\n    // the behaviour Modal's comment describes and consumers already depend on.\n    container.addEventListener(\"keydown\", onKeyDown);\n\n    return () => {\n      container.removeEventListener(\"keydown\", onKeyDown);\n      container.removeAttribute(TRAP_ATTR);\n\n      // Only when the trap is really being released: the container has left the page,\n      // or `active` has turned false. StrictMode runs this cleanup once more right after\n      // mounting, with the overlay still up, and then the effect again — and React does\n      // not re-apply `autoFocus` for that second run. Restoring here would pull focus\n      // out of the autofocused field for good: live #402 again, in development.\n      if (container.isConnected && optsRef.current.active) return;\n      if (!optsRef.current.restoreFocus) return;\n      // The kit's one rule (lib/focus-left `returnFocus`; 0.52 code review 2026-10-31,\n      // held to 0.55), in this, the releasing commit. Only a focus that fell with the\n      // panel, or is still in one on its way out, is moved: an app's own `focus()` in\n      // `onClose` is kept, where this used to put the opener over it. Then the named\n      // trigger, what had the focus as the trap engaged, and the stops that stood around\n      // that — where a gone opener used to leave the focus on <body> (\"a wrong guess is\n      // worse than no move\"; the header promised the nearest thing that still exists).\n      // `isConnected` and the focus are checked for each, as restoring to a removed or a\n      // disabled node is the drop to <body> this guards against.\n      const named = optsRef.current.opener?.();\n      returnFocus({\n        opener: named ?? opener,\n        fallback: [named ? opener : null, ...around],\n        closing: container.isConnected ? container : null,\n      });\n    };\n  }, [active, containerRef, opener]);\n}\n"],"mappings":"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","names":["tabStops"]}

package/dist/hooks/use-has-camera.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Does this device have a camera to take a photo WITH? keksdose's `useHasCamera`
+ * (shared/hooks/use-has-camera.ts:28, live #292 round three: *"If there is no device to
+ * take a photo can the take photo button be hidden? … If they do not have a web cam?"*),
+ * for every app — kastlan's handover photo buttons offer the camera on a desktop that has
+ * none (kastlan reuse audit 2026-11-02, proposal 8).
+ *
+ * `navigator.mediaDevices.enumerateDevices()` is the only honest answer there is. It
+ * reports the PRESENCE of a video input without a permission: the spec hides a device's
+ * label and id until the camera is granted, not the device, so counting `videoinput`
+ * entries asks the user nothing and opens no prompt. A webcam plugged in later fires
+ * `devicechange`, which asks again.
+ *
+ * **It fails OPEN, as keksdose's does.** Every answer that is not a positive "no" keeps
+ * the camera: no `mediaDevices` at all (an insecure context — `http://` on a LAN address
+ * is how the apps are developed), an `enumerateDevices` that rejects (a permissions
+ * policy), and — the one place this goes further than keksdose — a list with nothing in
+ * it whatever its kind: a device with no camera still has a speaker or a microphone to
+ * list, so an empty list is a browser declining to say (older WebKit, a hardened
+ * privacy mode), not a device without one. Hiding the control that opens the camera
+ * because the browser would not say takes the feature away from the phone it is for;
+ * showing it on a desktop that cannot use it costs one tap.
+ *
+ * **Cached**, unlike keksdose's: one answer for the page, shared by every button that
+ * asks. The first to mount asks the browser and listens for `devicechange`; the rest
+ * read the answer, and a button mounted later starts from it — so a desktop with no
+ * webcam does not show "Take photo" for a frame on every page that has the button.
+ * When the last one unmounts the listener goes, and the next first mount asks again (a
+ * camera may have come or gone in between). Before an answer, on the server and in
+ * jsdom (which has no `mediaDevices`), it is `true`.
+ *
+ * What it does not answer is whether a file input's `capture` will be HONOURED — a
+ * desktop Chrome with a webcam reports a video input and then ignores `capture`. That is
+ * why {@link CameraButton} opens the camera with `getUserMedia`, not with `capture`.
+ */
+export declare function useHasCamera(): boolean;

package/dist/hooks/use-has-camera.js

@@ -0,0 +1,53 @@
+"use client";
+import { useSyncExternalStore } from "react";
+function useHasCamera() {
+  return useSyncExternalStore(subscribe, snapshot, serverSnapshot);
+}
+let known;
+const listeners = /* @__PURE__ */ new Set();
+let watched = null;
+function settle(next) {
+  if (next === known) return;
+  known = next;
+  for (const listener of listeners) listener();
+}
+function ask() {
+  const media = watched;
+  if (!media) return;
+  media.enumerateDevices().then(
+    (devices) => {
+      settle(devices.length === 0 ? void 0 : devices.some((d) => d.kind === "videoinput"));
+    },
+    // A refusal is not an absence — see "fails open" above.
+    () => settle(void 0)
+  );
+}
+function subscribe(listener) {
+  listeners.add(listener);
+  if (listeners.size === 1) {
+    const media = typeof navigator === "undefined" ? void 0 : navigator.mediaDevices;
+    if (media && typeof media.enumerateDevices === "function") {
+      watched = media;
+      media.addEventListener?.("devicechange", ask);
+      ask();
+    } else {
+      settle(void 0);
+    }
+  }
+  return () => {
+    listeners.delete(listener);
+    if (listeners.size > 0 || !watched) return;
+    watched.removeEventListener?.("devicechange", ask);
+    watched = null;
+  };
+}
+function snapshot() {
+  return known ?? true;
+}
+function serverSnapshot() {
+  return true;
+}
+export {
+  useHasCamera
+};
+//# sourceMappingURL=use-has-camera.js.map

package/dist/hooks/use-has-camera.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/use-has-camera.ts"],"sourcesContent":["import { useSyncExternalStore } from \"react\";\n\n/**\n * Does this device have a camera to take a photo WITH? keksdose's `useHasCamera`\n * (shared/hooks/use-has-camera.ts:28, live #292 round three: *\"If there is no device to\n * take a photo can the take photo button be hidden? … If they do not have a web cam?\"*),\n * for every app — kastlan's handover photo buttons offer the camera on a desktop that has\n * none (kastlan reuse audit 2026-11-02, proposal 8).\n *\n * `navigator.mediaDevices.enumerateDevices()` is the only honest answer there is. It\n * reports the PRESENCE of a video input without a permission: the spec hides a device's\n * label and id until the camera is granted, not the device, so counting `videoinput`\n * entries asks the user nothing and opens no prompt. A webcam plugged in later fires\n * `devicechange`, which asks again.\n *\n * **It fails OPEN, as keksdose's does.** Every answer that is not a positive \"no\" keeps\n * the camera: no `mediaDevices` at all (an insecure context — `http://` on a LAN address\n * is how the apps are developed), an `enumerateDevices` that rejects (a permissions\n * policy), and — the one place this goes further than keksdose — a list with nothing in\n * it whatever its kind: a device with no camera still has a speaker or a microphone to\n * list, so an empty list is a browser declining to say (older WebKit, a hardened\n * privacy mode), not a device without one. Hiding the control that opens the camera\n * because the browser would not say takes the feature away from the phone it is for;\n * showing it on a desktop that cannot use it costs one tap.\n *\n * **Cached**, unlike keksdose's: one answer for the page, shared by every button that\n * asks. The first to mount asks the browser and listens for `devicechange`; the rest\n * read the answer, and a button mounted later starts from it — so a desktop with no\n * webcam does not show \"Take photo\" for a frame on every page that has the button.\n * When the last one unmounts the listener goes, and the next first mount asks again (a\n * camera may have come or gone in between). Before an answer, on the server and in\n * jsdom (which has no `mediaDevices`), it is `true`.\n *\n * What it does not answer is whether a file input's `capture` will be HONOURED — a\n * desktop Chrome with a webcam reports a video input and then ignores `capture`. That is\n * why {@link CameraButton} opens the camera with `getUserMedia`, not with `capture`.\n */\nexport function useHasCamera(): boolean {\n  return useSyncExternalStore(subscribe, snapshot, serverSnapshot);\n}\n\n/** The last answer: `undefined` until there is one, or when the browser would not say. */\nlet known: boolean | undefined;\nconst listeners = new Set<() => void>();\n/** The `MediaDevices` the `devicechange` listener is on, while anyone listens. */\nlet watched: MediaDevices | null = null;\n\nfunction settle(next: boolean | undefined) {\n  if (next === known) return;\n  known = next;\n  for (const listener of listeners) listener();\n}\n\nfunction ask() {\n  const media = watched;\n  if (!media) return;\n  media.enumerateDevices().then(\n    (devices) => {\n      // An answer that arrives after the last listener left still counts: it is about\n      // the device, and the next mount starts from it.\n      settle(devices.length === 0 ? undefined : devices.some((d) => d.kind === \"videoinput\"));\n    },\n    // A refusal is not an absence — see \"fails open\" above.\n    () => settle(undefined),\n  );\n}\n\nfunction subscribe(listener: () => void): () => void {\n  listeners.add(listener);\n  if (listeners.size === 1) {\n    const media = typeof navigator === \"undefined\" ? undefined : navigator.mediaDevices;\n    if (media && typeof media.enumerateDevices === \"function\") {\n      watched = media;\n      media.addEventListener?.(\"devicechange\", ask);\n      ask();\n    } else {\n      // Nothing to ask: an unknown, whatever an earlier page (or test) found.\n      settle(undefined);\n    }\n  }\n  return () => {\n    listeners.delete(listener);\n    if (listeners.size > 0 || !watched) return;\n    watched.removeEventListener?.(\"devicechange\", ask);\n    watched = null;\n  };\n}\n\nfunction snapshot(): boolean {\n  return known ?? true;\n}\n\nfunction serverSnapshot(): boolean {\n  return true;\n}\n"],"mappings":";AAAA,SAAS,4BAA4B;AAqC9B,SAAS,eAAwB;AACtC,SAAO,qBAAqB,WAAW,UAAU,cAAc;AACjE;AAGA,IAAI;AACJ,MAAM,YAAY,oBAAI,IAAgB;AAEtC,IAAI,UAA+B;AAEnC,SAAS,OAAO,MAA2B;AACzC,MAAI,SAAS,MAAO;AACpB,UAAQ;AACR,aAAW,YAAY,UAAW,UAAS;AAC7C;AAEA,SAAS,MAAM;AACb,QAAM,QAAQ;AACd,MAAI,CAAC,MAAO;AACZ,QAAM,iBAAiB,EAAE;AAAA,IACvB,CAAC,YAAY;AAGX,aAAO,QAAQ,WAAW,IAAI,SAAY,QAAQ,KAAK,CAAC,MAAM,EAAE,SAAS,YAAY,CAAC;AAAA,IACxF;AAAA;AAAA,IAEA,MAAM,OAAO,MAAS;AAAA,EACxB;AACF;AAEA,SAAS,UAAU,UAAkC;AACnD,YAAU,IAAI,QAAQ;AACtB,MAAI,UAAU,SAAS,GAAG;AACxB,UAAM,QAAQ,OAAO,cAAc,cAAc,SAAY,UAAU;AACvE,QAAI,SAAS,OAAO,MAAM,qBAAqB,YAAY;AACzD,gBAAU;AACV,YAAM,mBAAmB,gBAAgB,GAAG;AAC5C,UAAI;AAAA,IACN,OAAO;AAEL,aAAO,MAAS;AAAA,IAClB;AAAA,EACF;AACA,SAAO,MAAM;AACX,cAAU,OAAO,QAAQ;AACzB,QAAI,UAAU,OAAO,KAAK,CAAC,QAAS;AACpC,YAAQ,sBAAsB,gBAAgB,GAAG;AACjD,cAAU;AAAA,EACZ;AACF;AAEA,SAAS,WAAoB;AAC3B,SAAO,SAAS;AAClB;AAEA,SAAS,iBAA0B;AACjC,SAAO;AACT;","names":[]}

package/dist/hooks/use-hotkey.js

@@ -1,5 +1,6 @@
 "use client";
 import { useEffect, useRef } from "react";
+import { isEditableContent } from "../lib/editable-content.js";
 function isApplePlatform() {
   if (typeof navigator === "undefined") return false;
   const nav = navigator;
@@ -57,16 +58,6 @@ function matchesHotkey(e, combo) {
   const symbol = want.length === 1 && !/[a-z0-9 ]/.test(want);
   return symbol && !combo.shift ? true : e.shiftKey === combo.shift;
 }
-function isEditableContent(el) {
-  const native = el.isContentEditable;
-  if (native !== void 0) return native;
-  for (let at = el.closest("[contenteditable]"); at; at = at.parentElement?.closest("[contenteditable]") ?? null) {
-    const state = (at.getAttribute("contenteditable") ?? "").toLowerCase();
-    if (state === "" || state === "true" || state === "plaintext-only") return true;
-    if (state === "false") return false;
-  }
-  return el.ownerDocument.designMode === "on";
-}
 function isTypingTarget(target) {
   if (!(target instanceof HTMLElement)) return false;
   if (isEditableContent(target)) return true;