@eifi1/ui-kit 0.8.1 → 0.9.0

package/dist/search/command-palette.js

@@ -2,18 +2,38 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useId, useMemo, useRef, useState } from "react";
 import { createPortal } from "react-dom";
-import { Search } from "lucide-react";
+import { CornerDownLeft, Search, X } from "lucide-react";
 import { cn } from "../lib/cn.js";
+import { PHONE_QUERY } from "../components/ui.js";
+import { useMediaQuery } from "../hooks/use-media-query.js";
 import { useOverlayHistory } from "../hooks/use-overlay-history.js";
 import { useFocusTrap } from "../hooks/use-focus-trap.js";
 import { useBodyScrollLock } from "../hooks/use-body-scroll-lock.js";
 import { useKitLabels } from "../i18n/kit-labels.js";
+function groupItems(items) {
+  const order = [];
+  const byGroup = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    if (!byGroup.has(item.group)) {
+      byGroup.set(item.group, []);
+      order.push(item.group);
+    }
+    byGroup.get(item.group).push(item);
+  }
+  return {
+    groups: order.map((g) => ({ group: g, items: byGroup.get(g) })),
+    flat: order.flatMap((g) => byGroup.get(g)).filter((item) => item.kind !== "status")
+  };
+}
 const DEFAULT_COMMAND_PALETTE_LABELS = {
   placeholder: "Search\u2026",
   empty: "No results",
   loading: "Searching\u2026",
   dialog: "Search",
-  error: "Search failed. Try again."
+  error: "Search failed. Try again.",
+  clear: "Clear search",
+  submit: "Search",
+  close: "Close"
 };
 const { dialog: DEFAULT_DIALOG_NAME, ...DEFAULTS_WITHOUT_DIALOG } = DEFAULT_COMMAND_PALETTE_LABELS;
 function useCommandKey(onOpen) {
@@ -35,6 +55,9 @@ function CommandPalette({
   revision,
   query: queryProp,
   onQueryChange,
+  searchOn = "input",
+  redactLabels = false,
+  fullScreenOnPhone = true,
   labels
 }) {
   const l = useKitLabels("commandPalette", DEFAULTS_WITHOUT_DIALOG, labels);
@@ -46,6 +69,20 @@ function CommandPalette({
     if (!controlled) setOwnQuery(next);
     onQueryChange?.(next);
   };
+  const submitMode = searchOn === "submit";
+  const [draft, setDraft] = useState(query);
+  const [draftBase, setDraftBase] = useState(query);
+  if (draftBase !== query) {
+    setDraftBase(query);
+    setDraft(query);
+  }
+  const fieldText = submitMode ? draft : query;
+  const commit = (next) => {
+    setDraft(next);
+    setQuery(next);
+  };
+  const dirty = submitMode && draft !== query;
+  const isPhone = useMediaQuery(PHONE_QUERY, false) && fullScreenOnPhone;
   const [results, setResults] = useState([]);
   const [loading, setLoading] = useState(false);
   const [failed, setFailed] = useState(false);
@@ -60,13 +97,17 @@ function CommandPalette({
   const searchRef = useRef(search);
   searchRef.current = search;
   const reqId = useRef(0);
+  const shownQuery = useRef(null);
+  const activeIdRef = useRef(void 0);
   useOverlayHistory(open, onClose);
   useFocusTrap(dialogRef, { active: open, initialFocus: () => inputRef.current });
   useBodyScrollLock(open);
   useEffect(() => {
     if (!open) return;
     if (!controlled) setOwnQuery("");
+    setDraft(controlled ? query : "");
     setActive(0);
+    shownQuery.current = null;
   }, [open]);
   useEffect(() => {
     if (!open) return;
@@ -76,12 +117,16 @@ function CommandPalette({
       try {
         const r = await Promise.resolve(searchRef.current(query));
         if (reqId.current === id) {
+          const keep = shownQuery.current === query ? activeIdRef.current : void 0;
+          const at = keep === void 0 ? -1 : groupItems(r).flat.findIndex((item) => item.id === keep);
+          shownQuery.current = query;
           setResults(r);
           setFailed(false);
-          setActive(0);
+          setActive(Math.max(at, 0));
         }
       } catch (err) {
         if (reqId.current === id) {
+          shownQuery.current = null;
           setResults([]);
           setFailed(true);
           setActive(0);
@@ -94,21 +139,10 @@ function CommandPalette({
     const t = setTimeout(run, query ? 150 : 0);
     return () => clearTimeout(t);
   }, [query, open, revision]);
-  const { groups, flat } = useMemo(() => {
-    const order = [];
-    const byGroup = /* @__PURE__ */ new Map();
-    for (const item of results) {
-      if (!byGroup.has(item.group)) {
-        byGroup.set(item.group, []);
-        order.push(item.group);
-      }
-      byGroup.get(item.group).push(item);
-    }
-    return {
-      groups: order.map((g) => ({ group: g, items: byGroup.get(g) })),
-      flat: order.flatMap((g) => byGroup.get(g))
-    };
-  }, [results]);
+  const { groups, flat } = useMemo(() => groupItems(results), [results]);
+  useEffect(() => {
+    activeIdRef.current = flat[active]?.id;
+  });
   const choose = (item) => {
     if (!item) return;
     onClose();
@@ -123,7 +157,8 @@ function CommandPalette({
       setActive((i) => Math.max(i - 1, 0));
     } else if (e.key === "Enter") {
       e.preventDefault();
-      choose(flat[active]);
+      if (dirty) commit(draft);
+      else choose(flat[active]);
     }
   };
   const onDialogKeyDown = (e) => {
@@ -142,7 +177,10 @@ function CommandPalette({
     /* @__PURE__ */ jsx(
       "div",
       {
-        className: "fixed inset-0 z-[70] flex items-start justify-center bg-black/40 p-4 pt-[10vh]",
+        className: cn(
+          "fixed inset-0 z-[70] flex items-start justify-center bg-black/40",
+          isPhone ? "p-0" : "p-4 pt-[10vh]"
+        ),
         onMouseDown: (e) => {
           if (e.target === e.currentTarget) onClose();
         },
@@ -155,9 +193,19 @@ function CommandPalette({
             "aria-label": dialogName,
             tabIndex: -1,
             onKeyDown: onDialogKeyDown,
-            className: "flex max-h-[70vh] w-full max-w-xl flex-col overflow-hidden rounded-xl border border-[var(--border)] bg-[var(--bg-surface)] shadow-2xl outline-none",
+            "data-fullscreen": isPhone || void 0,
+            className: cn(
+              "flex w-full flex-col overflow-hidden bg-[var(--bg-surface)] outline-none",
+              isPhone ? "h-full" : "max-h-[70vh] max-w-xl rounded-xl border border-[var(--border)] shadow-2xl"
+            ),
+            style: isPhone ? {
+              paddingTop: "max(0px, env(safe-area-inset-top))",
+              paddingBottom: "max(0px, env(safe-area-inset-bottom))",
+              paddingLeft: "max(0px, env(safe-area-inset-left))",
+              paddingRight: "max(0px, env(safe-area-inset-right))"
+            } : void 0,
             children: [
-              /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 border-b border-[var(--border)] px-3", children: [
+              /* @__PURE__ */ jsxs("div", { className: "flex shrink-0 items-center gap-2 border-b border-[var(--border)] px-3", children: [
                 /* @__PURE__ */ jsx(Search, { className: "size-4 shrink-0 text-[var(--text-placeholder)]" }),
                 /* @__PURE__ */ jsx(
                   "input",
@@ -167,17 +215,57 @@ function CommandPalette({
                     "aria-expanded": true,
                     "aria-controls": listId,
                     "aria-activedescendant": flat[active] ? itemId(flat[active].id) : void 0,
-                    value: query,
-                    onChange: (e) => setQuery(e.target.value),
+                    value: fieldText,
+                    onChange: (e) => submitMode ? setDraft(e.target.value) : setQuery(e.target.value),
                     onKeyDown,
                     placeholder: l.placeholder,
-                    className: "w-full bg-transparent py-3 text-sm outline-none placeholder:text-[var(--text-placeholder)] text-[var(--text-primary)]"
+                    enterKeyHint: submitMode ? "search" : void 0,
+                    className: cn(
+                      "w-full bg-transparent py-3 outline-none placeholder:text-[var(--text-placeholder)] text-[var(--text-primary)]",
+                      // 16px on a phone, or iOS zooms the page in on focus.
+                      isPhone ? "text-base" : "text-sm"
+                    )
                   }
                 ),
-                loading && /* @__PURE__ */ jsx("span", { className: "shrink-0 text-[11px] text-[var(--text-placeholder)]", children: l.loading })
+                loading && /* @__PURE__ */ jsx("span", { className: "shrink-0 text-[11px] text-[var(--text-placeholder)]", children: l.loading }),
+                fieldText !== "" && /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    "aria-label": l.clear ?? DEFAULT_COMMAND_PALETTE_LABELS.clear,
+                    onClick: () => {
+                      commit("");
+                      inputRef.current?.focus();
+                    },
+                    className: "shrink-0 rounded p-1 text-[var(--text-placeholder)] hover:text-[var(--text-secondary)]",
+                    children: /* @__PURE__ */ jsx(X, { className: "size-4" })
+                  }
+                ),
+                dirty && /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    "aria-label": l.submit ?? DEFAULT_COMMAND_PALETTE_LABELS.submit,
+                    onClick: () => {
+                      commit(draft);
+                      inputRef.current?.focus();
+                    },
+                    className: "shrink-0 rounded p-1 text-[var(--text-secondary)] hover:text-[var(--text-primary)]",
+                    children: /* @__PURE__ */ jsx(CornerDownLeft, { className: "size-4" })
+                  }
+                ),
+                isPhone && /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    onClick: onClose,
+                    className: "-me-1 shrink-0 rounded px-1 py-2 text-sm text-[var(--text-secondary)] hover:text-[var(--text-primary)]",
+                    children: l.close ?? DEFAULT_COMMAND_PALETTE_LABELS.close
+                  }
+                )
               ] }),
               failed && !loading && /* @__PURE__ */ jsx("div", { role: "alert", className: "px-3 py-6 text-center text-sm text-[var(--text-muted)]", children: l.error ?? DEFAULT_COMMAND_PALETTE_LABELS.error }),
-              !failed && flat.length === 0 && !loading && /* @__PURE__ */ jsx("div", { className: "px-3 py-6 text-center text-sm text-[var(--text-muted)]", children: l.empty }),
+              !failed && results.length === 0 && !loading && /* @__PURE__ */ jsx("div", { className: "px-3 py-6 text-center text-sm text-[var(--text-muted)]", children: l.empty }),
               /* @__PURE__ */ jsx("ul", { id: listId, ref: listRef, role: "listbox", "aria-label": dialogName, className: "min-h-0 flex-1 overflow-y-auto py-1", children: groups.map(({ group, items }, groupIndex) => /* @__PURE__ */ jsxs("li", { role: "presentation", children: [
                 /* @__PURE__ */ jsx(
                   "div",
@@ -189,9 +277,24 @@ function CommandPalette({
                   }
                 ),
                 /* @__PURE__ */ jsx("ul", { role: "group", "aria-labelledby": groupId(groupIndex), children: items.map((item) => {
+                  if (item.kind === "status") {
+                    return /* @__PURE__ */ jsxs(
+                      "li",
+                      {
+                        role: "presentation",
+                        className: "flex items-center gap-2.5 px-3 py-2 text-xs text-[var(--text-placeholder)]",
+                        children: [
+                          item.icon && /* @__PURE__ */ jsx("span", { className: "flex size-4 shrink-0 items-center justify-center", children: item.icon }),
+                          /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate", children: item.label })
+                        ]
+                      },
+                      item.id
+                    );
+                  }
                   flatIndex += 1;
                   const idx = flatIndex;
                   const isActive = idx === active;
+                  const redact = item.redact ?? redactLabels;
                   const shared = {
                     id: itemId(item.id),
                     role: "option",
@@ -205,8 +308,8 @@ function CommandPalette({
                   };
                   const inner = /* @__PURE__ */ jsxs(Fragment, { children: [
                     item.icon && /* @__PURE__ */ jsx("span", { className: "flex size-4 shrink-0 items-center justify-center text-[var(--text-placeholder)]", children: item.icon }),
-                    /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate", children: item.label }),
-                    item.hint && /* @__PURE__ */ jsx("span", { className: "shrink-0 text-xs text-[var(--text-placeholder)]", children: item.hint })
+                    /* @__PURE__ */ jsx("span", { "data-private": redact || void 0, className: "min-w-0 flex-1 truncate", children: item.label }),
+                    item.hint && /* @__PURE__ */ jsx("span", { "data-private": redact || void 0, className: "shrink-0 text-xs text-[var(--text-placeholder)]", children: item.hint })
                   ] });
                   return /* @__PURE__ */ jsx("li", { role: "presentation", children: item.href ? /* @__PURE__ */ jsx(
                     "a",

package/dist/search/command-palette.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/search/command-palette.tsx"],"sourcesContent":["import { useEffect, useId, useMemo, useRef, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { Search } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { useOverlayHistory } from \"../hooks/use-overlay-history\";\nimport { useFocusTrap } from \"../hooks/use-focus-trap\";\nimport { useBodyScrollLock } from \"../hooks/use-body-scroll-lock\";\nimport { useKitLabels } from \"../i18n/kit-labels\";\n\nexport interface CommandItem {\n  id: string;\n  /** Primary text. */\n  label: string;\n  /** Secondary text on the right (e.g. an amount, a date, a group hint). */\n  hint?: string;\n  /** Heading this item is grouped under. */\n  group: string;\n  /** Leading icon / element. */\n  icon?: ReactNode;\n  /** Invoked when the item is chosen (navigate, run an action, …). */\n  onSelect: () => void;\n  /** Where this item leads, when it is a navigation rather than an action. Renders\n   *  the row as a real anchor so it can be middle-/⌘-clicked into a new tab\n   *  (Keksdose feedback #451); `onSelect` still runs for a plain click and for ↵, so\n   *  in-app navigation stays client-side. `href` only adds what the browser can do\n   *  with a link and JavaScript cannot fake — the rejected alternative, an\n   *  `onAuxClick` calling `window.open`, gets the middle click and nothing else. */\n  href?: string;\n}\n\nexport interface CommandPaletteLabels {\n  placeholder: string;\n  empty: string;\n  loading: string;\n  /** Hint shown in the footer, e.g. \"↑↓ to navigate · ↵ to select · esc to close\". */\n  hint?: string;\n  /**\n   * Accessible name of the dialog itself. It used to borrow `placeholder`, which is\n   * written to sit greyed-out in an empty box (\"Search…\", \"Type a command\"), not to\n   * name a window — and a reader heard the ellipsis read out as part of the name.\n   *\n   * Optional, unlike `placeholder`, so a translation annotated as\n   * `CommandPaletteLabels` keeps compiling; the default always carries it.\n   */\n  dialog?: string;\n  /**\n   * Shown in place of the results when the `search` provider throws or its promise\n   * rejects. Optional for the same reason as `dialog`; the default always carries it.\n   */\n  error?: string;\n}\n\nexport const DEFAULT_COMMAND_PALETTE_LABELS: CommandPaletteLabels = {\n  placeholder: \"Search…\",\n  empty: \"No results\",\n  loading: \"Searching…\",\n  dialog: \"Search\",\n  error: \"Search failed. Try again.\",\n};\n\n/** The defaults minus `dialog`, so a resolved `dialog` means someone SUPPLIED one —\n *  see the dialog's `aria-label` for why that distinction matters. */\nconst { dialog: DEFAULT_DIALOG_NAME, ...DEFAULTS_WITHOUT_DIALOG } = DEFAULT_COMMAND_PALETTE_LABELS;\n\ninterface CommandPaletteProps {\n  open: boolean;\n  onClose: () => void;\n  /**\n   * Returns results for a query (called debounced as the user types; an empty\n   * query is allowed — return defaults like pages/recent). Sync or async; stale\n   * async responses are ignored.\n   *\n   * Its IDENTITY is not a re-run signal — it is read through a ref, so the palette\n   * never re-searches merely because the caller rebuilt the callback. That is\n   * deliberate: a provider closing over a list rendered from a query allocates a new\n   * function on most renders, and re-running the search on each would make typing\n   * stutter. Use {@link CommandPaletteProps.revision} when the DATA behind the\n   * provider changes.\n   */\n  search: (query: string) => CommandItem[] | Promise<CommandItem[]>;\n  /**\n   * Anything whose change means the current results are out of date — typically the\n   * arrays the provider searches over. Compared by identity (as an effect dependency\n   * would be), so pass stable references: a `data = []` default allocates a fresh\n   * array on every render while a query is pending and would re-search forever.\n   *\n   * Without it, a provider whose data arrives AFTER the palette opened never gets\n   * asked again: the user's last keystroke settles the debounce, the queries resolve a\n   * moment later, and the groups they would have contributed are simply absent until\n   * another keystroke. That is the ordinary first open on a cold cache.\n   */\n  revision?: unknown;\n  /**\n   * The search text, CONTROLLED. Keksdose binds it to the URL's `q`, so a search\n   * survives a reload, can be shared as a link, and Back walks through it — none of\n   * which state inside the palette can do.\n   *\n   * Leave it out and the palette keeps its own, as before, starting empty on every\n   * open. Given, it is never reset on open: the owner decides what an open shows, and\n   * a palette that blanked the URL's `q` each time would fight its own address bar.\n   * `onQueryChange` is then how a keystroke gets anywhere, since it is the only writer.\n   */\n  query?: string;\n  /** Every edit of the field's text. Fires in both modes — uncontrolled, it only\n   *  observes. */\n  onQueryChange?: (query: string) => void;\n  labels?: Partial<CommandPaletteLabels>;\n}\n\n/** Registers a global ⌘K / Ctrl-K shortcut that calls `onOpen`. */\nexport function useCommandKey(onOpen: () => void): void {\n  useEffect(() => {\n    const handler = (e: KeyboardEvent) => {\n      if ((e.metaKey || e.ctrlKey) && (e.key === \"k\" || e.key === \"K\")) {\n        e.preventDefault();\n        onOpen();\n      }\n    };\n    document.addEventListener(\"keydown\", handler);\n    return () => document.removeEventListener(\"keydown\", handler);\n  }, [onOpen]);\n}\n\n/**\n * A ⌘K-style command palette: a top-centred modal with a search field and a\n * grouped, keyboard-navigable result list. Domain-free — the app supplies\n * results via the `search` provider (pages, actions, records, …); each result\n * carries its own `onSelect`.\n */\nexport function CommandPalette({\n  open,\n  onClose,\n  search,\n  revision,\n  query: queryProp,\n  onQueryChange,\n  labels,\n}: CommandPaletteProps) {\n  const l = useKitLabels(\"commandPalette\", DEFAULTS_WITHOUT_DIALOG, labels);\n  // `dialog` is new, and until it existed the dialog was named by `placeholder`. An\n  // app that translated `placeholder` and has not heard of `dialog` would otherwise\n  // go from a German name to an English \"Search\" on update — so a translated\n  // placeholder keeps doing the job until a `dialog` is supplied.\n  const dialogName =\n    l.dialog ??\n    (l.placeholder !== DEFAULT_COMMAND_PALETTE_LABELS.placeholder ? l.placeholder : DEFAULT_DIALOG_NAME);\n  const [ownQuery, setOwnQuery] = useState(\"\");\n  const controlled = queryProp !== undefined;\n  const query = controlled ? queryProp : ownQuery;\n  const setQuery = (next: string) => {\n    if (!controlled) setOwnQuery(next);\n    onQueryChange?.(next);\n  };\n  const [results, setResults] = useState<CommandItem[]>([]);\n  const [loading, setLoading] = useState(false);\n  const [failed, setFailed] = useState(false);\n  const [active, setActive] = useState(0);\n  // Per instance: these were the literal \"command-palette-list\" / \"command-item-<id>\",\n  // so two palettes on one page (an app-wide one and a scoped one) pointed each\n  // other's `aria-controls` and `aria-activedescendant` at the wrong list.\n  const uid = useId();\n  const listId = `${uid}-list`;\n  const itemId = (id: string) => `${uid}-item-${id}`;\n  const groupId = (index: number) => `${uid}-group-${index}`;\n  const dialogRef = useRef<HTMLDivElement>(null);\n  const inputRef = useRef<HTMLInputElement>(null);\n  const listRef = useRef<HTMLUListElement>(null);\n  const searchRef = useRef(search);\n  searchRef.current = search;\n  const reqId = useRef(0);\n\n  // Back dismisses the palette (Keksdose feedback #172). Declared with the other\n  // hooks, above the `if (!open) return null` below — a hook past a conditional\n  // return changes the hook order between renders. Passing `open` rather than\n  // mounting-while-open is what lets it sit here.\n  useOverlayHistory(open, onClose);\n\n  // A modal like any other: Tab stays inside, the page behind does not scroll, and\n  // focus goes back to whatever opened it — the palette used to drop it on <body>.\n  // Initial focus is the field, not the container: typing is the only reason to open it.\n  useFocusTrap(dialogRef, { active: open, initialFocus: () => inputRef.current });\n  useBodyScrollLock(open);\n\n  // Reset when opened — the palette's OWN text only; a controlled query belongs to\n  // its owner (see the prop).\n  useEffect(() => {\n    if (!open) return;\n    if (!controlled) setOwnQuery(\"\");\n    setActive(0);\n    // `controlled` is read at the open, not watched: a caller switching modes while\n    // the palette is open is not a reason to wipe what is typed.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [open]);\n\n  // Debounced, race-safe search.\n  useEffect(() => {\n    if (!open) return;\n    const id = ++reqId.current;\n    setLoading(true);\n    const run = async () => {\n      try {\n        const r = await Promise.resolve(searchRef.current(query));\n        if (reqId.current === id) {\n          setResults(r);\n          setFailed(false);\n          setActive(0);\n        }\n      } catch (err) {\n        // There was no catch: the previous query's results stayed on screen as if they\n        // answered this one, and the rejection went unhandled. Clear them and say so.\n        if (reqId.current === id) {\n          setResults([]);\n          setFailed(true);\n          setActive(0);\n        }\n        console.error(\"CommandPalette: search failed\", err);\n      } finally {\n        if (reqId.current === id) setLoading(false);\n      }\n    };\n    const t = setTimeout(run, query ? 150 : 0);\n    return () => clearTimeout(t);\n    // `revision`, not `search`: see the prop's docstring. The debounce is re-armed on a\n    // revision change, which is right — data arriving is not a keystroke and there is\n    // nothing to feel laggy about.\n  }, [query, open, revision]);\n\n  // Group results, preserving first-seen group order; keep a flat list for nav.\n  const { groups, flat } = useMemo(() => {\n    const order: string[] = [];\n    const byGroup = new Map<string, CommandItem[]>();\n    for (const item of results) {\n      if (!byGroup.has(item.group)) {\n        byGroup.set(item.group, []);\n        order.push(item.group);\n      }\n      byGroup.get(item.group)!.push(item);\n    }\n    return {\n      groups: order.map((g) => ({ group: g, items: byGroup.get(g)! })),\n      flat: order.flatMap((g) => byGroup.get(g)!),\n    };\n  }, [results]);\n\n  const choose = (item: CommandItem | undefined) => {\n    if (!item) return;\n    onClose();\n    item.onSelect();\n  };\n\n  const onKeyDown = (e: React.KeyboardEvent) => {\n    if (e.key === \"ArrowDown\") {\n      e.preventDefault();\n      setActive((i) => Math.min(i + 1, flat.length - 1));\n    } else if (e.key === \"ArrowUp\") {\n      e.preventDefault();\n      setActive((i) => Math.max(i - 1, 0));\n    } else if (e.key === \"Enter\") {\n      e.preventDefault();\n      choose(flat[active]);\n    }\n  };\n\n  // Escape on the whole dialog, not only the field: once Tab has moved focus to a row\n  // (or a footer control), Escape used to do nothing at all.\n  const onDialogKeyDown = (e: React.KeyboardEvent) => {\n    if (e.key === \"Escape\") {\n      e.preventDefault();\n      onClose();\n    }\n  };\n\n  // Keep the active row scrolled into view.\n  useEffect(() => {\n    const el = listRef.current?.querySelector<HTMLElement>(`[data-index=\"${active}\"]`);\n    el?.scrollIntoView({ block: \"nearest\" });\n  }, [active]);\n\n  if (!open) return null;\n\n  let flatIndex = -1;\n  return createPortal(\n    <div\n      className=\"fixed inset-0 z-[70] flex items-start justify-center bg-black/40 p-4 pt-[10vh]\"\n      onMouseDown={(e) => {\n        if (e.target === e.currentTarget) onClose();\n      }}\n    >\n      {/* eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- Escape from anywhere in the dialog */}\n      <div\n        ref={dialogRef}\n        role=\"dialog\"\n        aria-modal=\"true\"\n        aria-label={dialogName}\n        // The trap's fallback target when the field is not there to take focus.\n        tabIndex={-1}\n        // Escape bubbling up from anything inside — a dialog is where it belongs.\n        onKeyDown={onDialogKeyDown}\n        className=\"flex max-h-[70vh] w-full max-w-xl flex-col overflow-hidden rounded-xl border border-[var(--border)] bg-[var(--bg-surface)] shadow-2xl outline-none\"\n      >\n        <div className=\"flex items-center gap-2 border-b border-[var(--border)] px-3\">\n          <Search className=\"size-4 shrink-0 text-[var(--text-placeholder)]\" />\n          <input\n            ref={inputRef}\n            role=\"combobox\"\n            aria-expanded\n            aria-controls={listId}\n            aria-activedescendant={flat[active] ? itemId(flat[active].id) : undefined}\n            value={query}\n            onChange={(e) => setQuery(e.target.value)}\n            onKeyDown={onKeyDown}\n            placeholder={l.placeholder}\n            className=\"w-full bg-transparent py-3 text-sm outline-none placeholder:text-[var(--text-placeholder)] text-[var(--text-primary)]\"\n          />\n          {loading && <span className=\"shrink-0 text-[11px] text-[var(--text-placeholder)]\">{l.loading}</span>}\n        </div>\n\n        {/* The status lines sit outside the listbox: a listbox owns options and groups,\n            and \"No results\" is neither. */}\n        {failed && !loading && (\n          <div role=\"alert\" className=\"px-3 py-6 text-center text-sm text-[var(--text-muted)]\">\n            {l.error ?? DEFAULT_COMMAND_PALETTE_LABELS.error}\n          </div>\n        )}\n        {!failed && flat.length === 0 && !loading && (\n          <div className=\"px-3 py-6 text-center text-sm text-[var(--text-muted)]\">{l.empty}</div>\n        )}\n        {/* Listbox grouping: each group is a `role=\"group\"` named by its heading, and\n            the list markup in between is presentational so the listbox's children are\n            groups and options only — as a plain <li>/<ul> tree a reader announced\n            \"list, 2 items\" between options and never tied the heading to its rows. */}\n        <ul id={listId} ref={listRef} role=\"listbox\" aria-label={dialogName} className=\"min-h-0 flex-1 overflow-y-auto py-1\">\n          {groups.map(({ group, items }, groupIndex) => (\n            <li key={group} role=\"presentation\">\n              <div\n                id={groupId(groupIndex)}\n                role=\"presentation\"\n                className=\"px-3 pb-0.5 pt-2 text-[10px] font-semibold uppercase tracking-wide text-[var(--text-placeholder)]\"\n              >\n                {group}\n              </div>\n              <ul role=\"group\" aria-labelledby={groupId(groupIndex)}>\n                {items.map((item) => {\n                  flatIndex += 1;\n                  const idx = flatIndex;\n                  const isActive = idx === active;\n                  // Written once and worn by either tag below, so the anchor and the\n                  // button can never drift apart in looks or in listbox semantics.\n                  // `role=\"option\"` on an <a href> is fine: the browser's middle-click\n                  // behaviour keys off the element, not the ARIA role.\n                  const shared = {\n                    id: itemId(item.id),\n                    role: \"option\" as const,\n                    \"aria-selected\": isActive,\n                    \"data-index\": idx,\n                    onMouseMove: () => setActive(idx),\n                    className: cn(\n                      \"flex w-full items-center gap-2.5 px-3 py-2 text-start text-sm\",\n                      isActive\n                        ? \"bg-[var(--bg-active)] text-[var(--text-primary)]\"\n                        : \"text-[var(--text-secondary)]\",\n                    ),\n                  };\n                  const inner = (\n                    <>\n                      {item.icon && (\n                        <span className=\"flex size-4 shrink-0 items-center justify-center text-[var(--text-placeholder)]\">\n                          {item.icon}\n                        </span>\n                      )}\n                      <span className=\"min-w-0 flex-1 truncate\">{item.label}</span>\n                      {item.hint && (\n                        <span className=\"shrink-0 text-xs text-[var(--text-placeholder)]\">{item.hint}</span>\n                      )}\n                    </>\n                  );\n                  return (\n                    <li key={item.id} role=\"presentation\">\n                      {item.href ? (\n                        <a\n                          {...shared}\n                          href={item.href}\n                          draggable={false}\n                          onClick={(e) => {\n                            // A modified click belongs to the browser (feedback\n                            // #451) — and the palette deliberately stays OPEN for\n                            // it: ⌘-clicking three results in a row is the reason to\n                            // want this, and closing after the first would undo it.\n                            if (\n                              e.button !== 0 ||\n                              e.metaKey ||\n                              e.ctrlKey ||\n                              e.shiftKey ||\n                              e.altKey\n                            )\n                              return;\n                            e.preventDefault();\n                            choose(item);\n                          }}\n                        >\n                          {inner}\n                        </a>\n                      ) : (\n                        <button type=\"button\" {...shared} onClick={() => choose(item)}>\n                          {inner}\n                        </button>\n                      )}\n                    </li>\n                  );\n                })}\n              </ul>\n            </li>\n          ))}\n        </ul>\n\n        {l.hint && (\n          <div className=\"border-t border-[var(--border)] px-3 py-1.5 text-[11px] text-[var(--text-placeholder)]\">\n            {l.hint}\n          </div>\n        )}\n      </div>\n    </div>,\n    document.body,\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/search/command-palette.tsx"],"sourcesContent":["import { useEffect, useId, useMemo, useRef, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { CornerDownLeft, Search, X } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { PHONE_QUERY } from \"../components/ui\";\nimport { useMediaQuery } from \"../hooks/use-media-query\";\nimport { useOverlayHistory } from \"../hooks/use-overlay-history\";\nimport { useFocusTrap } from \"../hooks/use-focus-trap\";\nimport { useBodyScrollLock } from \"../hooks/use-body-scroll-lock\";\nimport { useKitLabels } from \"../i18n/kit-labels\";\n\nexport interface CommandItem {\n  id: string;\n  /** Primary text. */\n  label: string;\n  /** Secondary text on the right (e.g. an amount, a date, a group hint). */\n  hint?: string;\n  /** Heading this item is grouped under. */\n  group: string;\n  /** Leading icon / element. */\n  icon?: ReactNode;\n  /** Invoked when the item is chosen (navigate, run an action, …). */\n  onSelect: () => void;\n  /** Where this item leads, when it is a navigation rather than an action. Renders\n   *  the row as a real anchor so it can be middle-/⌘-clicked into a new tab\n   *  (Keksdose feedback #451); `onSelect` still runs for a plain click and for ↵, so\n   *  in-app navigation stays client-side. `href` only adds what the browser can do\n   *  with a link and JavaScript cannot fake — the rejected alternative, an\n   *  `onAuxClick` calling `window.open`, gets the middle click and nothing else. */\n  href?: string;\n  /** Marks this row's label and hint `data-private`, so session replay and screenshot\n   *  tooling masks them — a payee, an account name, an amount. Overrides the palette's\n   *  {@link CommandPaletteProps.redactLabels} either way, so `false` un-masks one\n   *  harmless row (\"Settings\") in a palette that masks by default. */\n  redact?: boolean;\n  /**\n   * `\"status\"` makes the row a line of text rather than a choice — a group's\n   * \"Searching…\" while its source is still out, or its error. It is skipped by the\n   * arrow keys and ↵, has no hover highlight, and its `onSelect` is never called.\n   * Default `\"option\"`.\n   */\n  kind?: \"option\" | \"status\";\n}\n\n/** Group items preserving first-seen group order; `flat` is the navigable rows only. */\nfunction groupItems(items: CommandItem[]) {\n  const order: string[] = [];\n  const byGroup = new Map<string, CommandItem[]>();\n  for (const item of items) {\n    if (!byGroup.has(item.group)) {\n      byGroup.set(item.group, []);\n      order.push(item.group);\n    }\n    byGroup.get(item.group)!.push(item);\n  }\n  return {\n    groups: order.map((g) => ({ group: g, items: byGroup.get(g)! })),\n    flat: order.flatMap((g) => byGroup.get(g)!).filter((item) => item.kind !== \"status\"),\n  };\n}\n\nexport interface CommandPaletteLabels {\n  placeholder: string;\n  empty: string;\n  loading: string;\n  /** Hint shown in the footer, e.g. \"↑↓ to navigate · ↵ to select · esc to close\". */\n  hint?: string;\n  /**\n   * Accessible name of the dialog itself. It used to borrow `placeholder`, which is\n   * written to sit greyed-out in an empty box (\"Search…\", \"Type a command\"), not to\n   * name a window — and a reader heard the ellipsis read out as part of the name.\n   *\n   * Optional, unlike `placeholder`, so a translation annotated as\n   * `CommandPaletteLabels` keeps compiling; the default always carries it.\n   */\n  dialog?: string;\n  /**\n   * Shown in place of the results when the `search` provider throws or its promise\n   * rejects. Optional for the same reason as `dialog`; the default always carries it.\n   */\n  error?: string;\n  /** Names the \"×\" that empties the field. Optional like `dialog`. */\n  clear?: string;\n  /** Names the button that commits the typed text when `searchOn=\"submit\"`. */\n  submit?: string;\n  /** Names the close button of the full-screen phone presentation, which has no\n   *  backdrop to tap and, on a phone, no Escape key. */\n  close?: string;\n}\n\nexport const DEFAULT_COMMAND_PALETTE_LABELS: CommandPaletteLabels = {\n  placeholder: \"Search…\",\n  empty: \"No results\",\n  loading: \"Searching…\",\n  dialog: \"Search\",\n  error: \"Search failed. Try again.\",\n  clear: \"Clear search\",\n  submit: \"Search\",\n  close: \"Close\",\n};\n\n/** The defaults minus `dialog`, so a resolved `dialog` means someone SUPPLIED one —\n *  see the dialog's `aria-label` for why that distinction matters. */\nconst { dialog: DEFAULT_DIALOG_NAME, ...DEFAULTS_WITHOUT_DIALOG } = DEFAULT_COMMAND_PALETTE_LABELS;\n\ninterface CommandPaletteProps {\n  open: boolean;\n  onClose: () => void;\n  /**\n   * Returns results for a query (called debounced as the user types; an empty\n   * query is allowed — return defaults like pages/recent). Sync or async; stale\n   * async responses are ignored.\n   *\n   * Its IDENTITY is not a re-run signal — it is read through a ref, so the palette\n   * never re-searches merely because the caller rebuilt the callback. That is\n   * deliberate: a provider closing over a list rendered from a query allocates a new\n   * function on most renders, and re-running the search on each would make typing\n   * stutter. Use {@link CommandPaletteProps.revision} when the DATA behind the\n   * provider changes.\n   */\n  search: (query: string) => CommandItem[] | Promise<CommandItem[]>;\n  /**\n   * Anything whose change means the current results are out of date — typically the\n   * arrays the provider searches over. Compared by identity (as an effect dependency\n   * would be), so pass stable references: a `data = []` default allocates a fresh\n   * array on every render while a query is pending and would re-search forever.\n   *\n   * Without it, a provider whose data arrives AFTER the palette opened never gets\n   * asked again: the user's last keystroke settles the debounce, the queries resolve a\n   * moment later, and the groups they would have contributed are simply absent until\n   * another keystroke. That is the ordinary first open on a cold cache.\n   */\n  revision?: unknown;\n  /**\n   * The search text, CONTROLLED. Keksdose binds it to the URL's `q`, so a search\n   * survives a reload, can be shared as a link, and Back walks through it — none of\n   * which state inside the palette can do.\n   *\n   * Leave it out and the palette keeps its own, as before, starting empty on every\n   * open. Given, it is never reset on open: the owner decides what an open shows, and\n   * a palette that blanked the URL's `q` each time would fight its own address bar.\n   * `onQueryChange` is then how a keystroke gets anywhere, since it is the only writer.\n   */\n  query?: string;\n  /** Every edit of the field's text. Fires in both modes — uncontrolled, it only\n   *  observes. */\n  onQueryChange?: (query: string) => void;\n  /**\n   * When the typed text becomes THE query — the one `search` runs on and\n   * `onQueryChange` reports.\n   *\n   * - `\"input\"` (default): every keystroke, debounced for the search, as before.\n   * - `\"submit\"`: typing edits a draft; the query is committed by ↵ or the submit\n   *   button beside the field. Until then the results stay on the last committed query\n   *   and `onQueryChange` stays quiet — which is what an owner binding `query` to the\n   *   URL's `q` needs, or every keystroke re-filters the page behind and pushes history.\n   *   ↵ with a draft that differs from the committed query COMMITS; ↵ with nothing new\n   *   typed chooses the highlighted row, as in `\"input\"` mode. The draft follows any\n   *   outside change of the committed query (Back through the URL), and an uncommitted\n   *   draft is dropped when the palette is closed.\n   *\n   * The clear \"×\" commits the empty query in both modes: an emptied box over results\n   * (or a page) still filtered by the old text is the stuck state Keksdose #423 was.\n   */\n  searchOn?: \"input\" | \"submit\";\n  /** Mark every row's label and hint `data-private` (see {@link CommandItem.redact},\n   *  which overrides it per row). Off by default. */\n  redactLabels?: boolean;\n  /**\n   * Below the phone breakpoint ({@link PHONE_QUERY}) the palette fills the screen:\n   * no inset, no rounded panel, the field pinned at the top inside the safe areas and\n   * the list scrolling under it, with a close button since there is no backdrop to tap.\n   * On by default — a top-centred card at 70vh leaves little room once the keyboard is\n   * up. `false` keeps the card on every viewport.\n   */\n  fullScreenOnPhone?: boolean;\n  labels?: Partial<CommandPaletteLabels>;\n}\n\n/** Registers a global ⌘K / Ctrl-K shortcut that calls `onOpen`. */\nexport function useCommandKey(onOpen: () => void): void {\n  useEffect(() => {\n    const handler = (e: KeyboardEvent) => {\n      if ((e.metaKey || e.ctrlKey) && (e.key === \"k\" || e.key === \"K\")) {\n        e.preventDefault();\n        onOpen();\n      }\n    };\n    document.addEventListener(\"keydown\", handler);\n    return () => document.removeEventListener(\"keydown\", handler);\n  }, [onOpen]);\n}\n\n/**\n * A ⌘K-style command palette: a top-centred modal with a search field and a\n * grouped, keyboard-navigable result list. Domain-free — the app supplies\n * results via the `search` provider (pages, actions, records, …); each result\n * carries its own `onSelect`.\n */\nexport function CommandPalette({\n  open,\n  onClose,\n  search,\n  revision,\n  query: queryProp,\n  onQueryChange,\n  searchOn = \"input\",\n  redactLabels = false,\n  fullScreenOnPhone = true,\n  labels,\n}: CommandPaletteProps) {\n  const l = useKitLabels(\"commandPalette\", DEFAULTS_WITHOUT_DIALOG, labels);\n  // `dialog` is new, and until it existed the dialog was named by `placeholder`. An\n  // app that translated `placeholder` and has not heard of `dialog` would otherwise\n  // go from a German name to an English \"Search\" on update — so a translated\n  // placeholder keeps doing the job until a `dialog` is supplied.\n  const dialogName =\n    l.dialog ??\n    (l.placeholder !== DEFAULT_COMMAND_PALETTE_LABELS.placeholder ? l.placeholder : DEFAULT_DIALOG_NAME);\n  const [ownQuery, setOwnQuery] = useState(\"\");\n  const controlled = queryProp !== undefined;\n  const query = controlled ? queryProp : ownQuery;\n  const setQuery = (next: string) => {\n    if (!controlled) setOwnQuery(next);\n    onQueryChange?.(next);\n  };\n  const submitMode = searchOn === \"submit\";\n  // The field's text in `\"submit\"` mode. It follows the committed query whenever that\n  // changes — adjusted during render, React's pattern for state derived from a prop,\n  // rather than in an effect that would paint the stale draft first.\n  const [draft, setDraft] = useState(query);\n  const [draftBase, setDraftBase] = useState(query);\n  if (draftBase !== query) {\n    setDraftBase(query);\n    setDraft(query);\n  }\n  const fieldText = submitMode ? draft : query;\n  const commit = (next: string) => {\n    setDraft(next);\n    setQuery(next);\n  };\n  const dirty = submitMode && draft !== query;\n  const isPhone = useMediaQuery(PHONE_QUERY, false) && fullScreenOnPhone;\n  const [results, setResults] = useState<CommandItem[]>([]);\n  const [loading, setLoading] = useState(false);\n  const [failed, setFailed] = useState(false);\n  const [active, setActive] = useState(0);\n  // Per instance: these were the literal \"command-palette-list\" / \"command-item-<id>\",\n  // so two palettes on one page (an app-wide one and a scoped one) pointed each\n  // other's `aria-controls` and `aria-activedescendant` at the wrong list.\n  const uid = useId();\n  const listId = `${uid}-list`;\n  const itemId = (id: string) => `${uid}-item-${id}`;\n  const groupId = (index: number) => `${uid}-group-${index}`;\n  const dialogRef = useRef<HTMLDivElement>(null);\n  const inputRef = useRef<HTMLInputElement>(null);\n  const listRef = useRef<HTMLUListElement>(null);\n  const searchRef = useRef(search);\n  searchRef.current = search;\n  const reqId = useRef(0);\n  /** The query the results on screen answer, and the row highlighted in them — so a\n   *  re-run for the SAME query (a `revision` change: a source streaming in) keeps the\n   *  highlight on its row instead of throwing it back to the top mid-arrow. */\n  const shownQuery = useRef<string | null>(null);\n  const activeIdRef = useRef<string | undefined>(undefined);\n\n  // Back dismisses the palette (Keksdose feedback #172). Declared with the other\n  // hooks, above the `if (!open) return null` below — a hook past a conditional\n  // return changes the hook order between renders. Passing `open` rather than\n  // mounting-while-open is what lets it sit here.\n  useOverlayHistory(open, onClose);\n\n  // A modal like any other: Tab stays inside, the page behind does not scroll, and\n  // focus goes back to whatever opened it — the palette used to drop it on <body>.\n  // Initial focus is the field, not the container: typing is the only reason to open it.\n  useFocusTrap(dialogRef, { active: open, initialFocus: () => inputRef.current });\n  useBodyScrollLock(open);\n\n  // Reset when opened — the palette's OWN text only; a controlled query belongs to\n  // its owner (see the prop).\n  useEffect(() => {\n    if (!open) return;\n    if (!controlled) setOwnQuery(\"\");\n    // An uncommitted draft does not outlive the open it was typed in.\n    setDraft(controlled ? query : \"\");\n    setActive(0);\n    shownQuery.current = null;\n    // `controlled` is read at the open, not watched: a caller switching modes while\n    // the palette is open is not a reason to wipe what is typed.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [open]);\n\n  // Debounced, race-safe search.\n  useEffect(() => {\n    if (!open) return;\n    const id = ++reqId.current;\n    setLoading(true);\n    const run = async () => {\n      try {\n        const r = await Promise.resolve(searchRef.current(query));\n        if (reqId.current === id) {\n          const keep = shownQuery.current === query ? activeIdRef.current : undefined;\n          const at = keep === undefined ? -1 : groupItems(r).flat.findIndex((item) => item.id === keep);\n          shownQuery.current = query;\n          setResults(r);\n          setFailed(false);\n          setActive(Math.max(at, 0));\n        }\n      } catch (err) {\n        // There was no catch: the previous query's results stayed on screen as if they\n        // answered this one, and the rejection went unhandled. Clear them and say so.\n        if (reqId.current === id) {\n          shownQuery.current = null;\n          setResults([]);\n          setFailed(true);\n          setActive(0);\n        }\n        console.error(\"CommandPalette: search failed\", err);\n      } finally {\n        if (reqId.current === id) setLoading(false);\n      }\n    };\n    const t = setTimeout(run, query ? 150 : 0);\n    return () => clearTimeout(t);\n    // `revision`, not `search`: see the prop's docstring. The debounce is re-armed on a\n    // revision change, which is right — data arriving is not a keystroke and there is\n    // nothing to feel laggy about.\n  }, [query, open, revision]);\n\n  // Group results, preserving first-seen group order; keep a flat list for nav.\n  const { groups, flat } = useMemo(() => groupItems(results), [results]);\n  useEffect(() => {\n    activeIdRef.current = flat[active]?.id;\n  });\n\n  const choose = (item: CommandItem | undefined) => {\n    if (!item) return;\n    onClose();\n    item.onSelect();\n  };\n\n  const onKeyDown = (e: React.KeyboardEvent) => {\n    if (e.key === \"ArrowDown\") {\n      e.preventDefault();\n      setActive((i) => Math.min(i + 1, flat.length - 1));\n    } else if (e.key === \"ArrowUp\") {\n      e.preventDefault();\n      setActive((i) => Math.max(i - 1, 0));\n    } else if (e.key === \"Enter\") {\n      e.preventDefault();\n      if (dirty) commit(draft);\n      else choose(flat[active]);\n    }\n  };\n\n  // Escape on the whole dialog, not only the field: once Tab has moved focus to a row\n  // (or a footer control), Escape used to do nothing at all.\n  const onDialogKeyDown = (e: React.KeyboardEvent) => {\n    if (e.key === \"Escape\") {\n      e.preventDefault();\n      onClose();\n    }\n  };\n\n  // Keep the active row scrolled into view.\n  useEffect(() => {\n    const el = listRef.current?.querySelector<HTMLElement>(`[data-index=\"${active}\"]`);\n    el?.scrollIntoView({ block: \"nearest\" });\n  }, [active]);\n\n  if (!open) return null;\n\n  let flatIndex = -1;\n  return createPortal(\n    <div\n      className={cn(\n        \"fixed inset-0 z-[70] flex items-start justify-center bg-black/40\",\n        isPhone ? \"p-0\" : \"p-4 pt-[10vh]\",\n      )}\n      onMouseDown={(e) => {\n        if (e.target === e.currentTarget) onClose();\n      }}\n    >\n      {/* eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- Escape from anywhere in the dialog */}\n      <div\n        ref={dialogRef}\n        role=\"dialog\"\n        aria-modal=\"true\"\n        aria-label={dialogName}\n        // The trap's fallback target when the field is not there to take focus.\n        tabIndex={-1}\n        // Escape bubbling up from anything inside — a dialog is where it belongs.\n        onKeyDown={onDialogKeyDown}\n        data-fullscreen={isPhone || undefined}\n        className={cn(\n          \"flex w-full flex-col overflow-hidden bg-[var(--bg-surface)] outline-none\",\n          isPhone\n            ? \"h-full\"\n            : \"max-h-[70vh] max-w-xl rounded-xl border border-[var(--border)] shadow-2xl\",\n        )}\n        // Full screen means edge to edge, so the notch, the home indicator and the\n        // rounded corners are the panel's to keep clear of.\n        style={\n          isPhone\n            ? {\n                paddingTop: \"max(0px, env(safe-area-inset-top))\",\n                paddingBottom: \"max(0px, env(safe-area-inset-bottom))\",\n                paddingLeft: \"max(0px, env(safe-area-inset-left))\",\n                paddingRight: \"max(0px, env(safe-area-inset-right))\",\n              }\n            : undefined\n        }\n      >\n        <div className=\"flex shrink-0 items-center gap-2 border-b border-[var(--border)] px-3\">\n          <Search className=\"size-4 shrink-0 text-[var(--text-placeholder)]\" />\n          <input\n            ref={inputRef}\n            role=\"combobox\"\n            aria-expanded\n            aria-controls={listId}\n            aria-activedescendant={flat[active] ? itemId(flat[active].id) : undefined}\n            value={fieldText}\n            onChange={(e) => (submitMode ? setDraft(e.target.value) : setQuery(e.target.value))}\n            onKeyDown={onKeyDown}\n            placeholder={l.placeholder}\n            enterKeyHint={submitMode ? \"search\" : undefined}\n            className={cn(\n              \"w-full bg-transparent py-3 outline-none placeholder:text-[var(--text-placeholder)] text-[var(--text-primary)]\",\n              // 16px on a phone, or iOS zooms the page in on focus.\n              isPhone ? \"text-base\" : \"text-sm\",\n            )}\n          />\n          {loading && <span className=\"shrink-0 text-[11px] text-[var(--text-placeholder)]\">{l.loading}</span>}\n          {fieldText !== \"\" && (\n            <button\n              type=\"button\"\n              aria-label={l.clear ?? DEFAULT_COMMAND_PALETTE_LABELS.clear}\n              onClick={() => {\n                commit(\"\");\n                // Clearing starts the next query far more often than it ends this one.\n                inputRef.current?.focus();\n              }}\n              className=\"shrink-0 rounded p-1 text-[var(--text-placeholder)] hover:text-[var(--text-secondary)]\"\n            >\n              <X className=\"size-4\" />\n            </button>\n          )}\n          {dirty && (\n            <button\n              type=\"button\"\n              aria-label={l.submit ?? DEFAULT_COMMAND_PALETTE_LABELS.submit}\n              onClick={() => {\n                commit(draft);\n                inputRef.current?.focus();\n              }}\n              className=\"shrink-0 rounded p-1 text-[var(--text-secondary)] hover:text-[var(--text-primary)]\"\n            >\n              <CornerDownLeft className=\"size-4\" />\n            </button>\n          )}\n          {isPhone && (\n            <button\n              type=\"button\"\n              onClick={onClose}\n              className=\"-me-1 shrink-0 rounded px-1 py-2 text-sm text-[var(--text-secondary)] hover:text-[var(--text-primary)]\"\n            >\n              {l.close ?? DEFAULT_COMMAND_PALETTE_LABELS.close}\n            </button>\n          )}\n        </div>\n\n        {/* The status lines sit outside the listbox: a listbox owns options and groups,\n            and \"No results\" is neither. */}\n        {failed && !loading && (\n          <div role=\"alert\" className=\"px-3 py-6 text-center text-sm text-[var(--text-muted)]\">\n            {l.error ?? DEFAULT_COMMAND_PALETTE_LABELS.error}\n          </div>\n        )}\n        {/* `results`, not `flat`: a group whose only row is its \"Searching…\" line is not\n            an empty result. */}\n        {!failed && results.length === 0 && !loading && (\n          <div className=\"px-3 py-6 text-center text-sm text-[var(--text-muted)]\">{l.empty}</div>\n        )}\n        {/* Listbox grouping: each group is a `role=\"group\"` named by its heading, and\n            the list markup in between is presentational so the listbox's children are\n            groups and options only — as a plain <li>/<ul> tree a reader announced\n            \"list, 2 items\" between options and never tied the heading to its rows. */}\n        <ul id={listId} ref={listRef} role=\"listbox\" aria-label={dialogName} className=\"min-h-0 flex-1 overflow-y-auto py-1\">\n          {groups.map(({ group, items }, groupIndex) => (\n            <li key={group} role=\"presentation\">\n              <div\n                id={groupId(groupIndex)}\n                role=\"presentation\"\n                className=\"px-3 pb-0.5 pt-2 text-[10px] font-semibold uppercase tracking-wide text-[var(--text-placeholder)]\"\n              >\n                {group}\n              </div>\n              <ul role=\"group\" aria-labelledby={groupId(groupIndex)}>\n                {items.map((item) => {\n                  if (item.kind === \"status\") {\n                    return (\n                      <li\n                        key={item.id}\n                        role=\"presentation\"\n                        className=\"flex items-center gap-2.5 px-3 py-2 text-xs text-[var(--text-placeholder)]\"\n                      >\n                        {item.icon && <span className=\"flex size-4 shrink-0 items-center justify-center\">{item.icon}</span>}\n                        <span className=\"min-w-0 flex-1 truncate\">{item.label}</span>\n                      </li>\n                    );\n                  }\n                  flatIndex += 1;\n                  const idx = flatIndex;\n                  const isActive = idx === active;\n                  const redact = item.redact ?? redactLabels;\n                  // Written once and worn by either tag below, so the anchor and the\n                  // button can never drift apart in looks or in listbox semantics.\n                  // `role=\"option\"` on an <a href> is fine: the browser's middle-click\n                  // behaviour keys off the element, not the ARIA role.\n                  const shared = {\n                    id: itemId(item.id),\n                    role: \"option\" as const,\n                    \"aria-selected\": isActive,\n                    \"data-index\": idx,\n                    onMouseMove: () => setActive(idx),\n                    className: cn(\n                      \"flex w-full items-center gap-2.5 px-3 py-2 text-start text-sm\",\n                      isActive\n                        ? \"bg-[var(--bg-active)] text-[var(--text-primary)]\"\n                        : \"text-[var(--text-secondary)]\",\n                    ),\n                  };\n                  const inner = (\n                    <>\n                      {item.icon && (\n                        <span className=\"flex size-4 shrink-0 items-center justify-center text-[var(--text-placeholder)]\">\n                          {item.icon}\n                        </span>\n                      )}\n                      <span data-private={redact || undefined} className=\"min-w-0 flex-1 truncate\">\n                        {item.label}\n                      </span>\n                      {item.hint && (\n                        <span data-private={redact || undefined} className=\"shrink-0 text-xs text-[var(--text-placeholder)]\">\n                          {item.hint}\n                        </span>\n                      )}\n                    </>\n                  );\n                  return (\n                    <li key={item.id} role=\"presentation\">\n                      {item.href ? (\n                        <a\n                          {...shared}\n                          href={item.href}\n                          draggable={false}\n                          onClick={(e) => {\n                            // A modified click belongs to the browser (feedback\n                            // #451) — and the palette deliberately stays OPEN for\n                            // it: ⌘-clicking three results in a row is the reason to\n                            // want this, and closing after the first would undo it.\n                            if (\n                              e.button !== 0 ||\n                              e.metaKey ||\n                              e.ctrlKey ||\n                              e.shiftKey ||\n                              e.altKey\n                            )\n                              return;\n                            e.preventDefault();\n                            choose(item);\n                          }}\n                        >\n                          {inner}\n                        </a>\n                      ) : (\n                        <button type=\"button\" {...shared} onClick={() => choose(item)}>\n                          {inner}\n                        </button>\n                      )}\n                    </li>\n                  );\n                })}\n              </ul>\n            </li>\n          ))}\n        </ul>\n\n        {l.hint && (\n          <div className=\"border-t border-[var(--border)] px-3 py-1.5 text-[11px] text-[var(--text-placeholder)]\">\n            {l.hint}\n          </div>\n        )}\n      </div>\n    </div>,\n    document.body,\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/search/global-search.d.ts

@@ -0,0 +1,141 @@
+import { CommandPaletteLabels } from './command-palette.js';
+import { SearchEntry, SearchIndexOptions } from './search-index.js';
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+interface GlobalSearchLabels {
+    /** The trigger's accessible name, and the dialog's. */
+    trigger: string;
+    /** The field's placeholder — says WHAT can be found, which "Search…" does not. */
+    placeholder: string;
+    /** The trigger's tooltip, given the shortcut as the platform writes it ("⌘K",
+     *  "Ctrl K"). A function so a language can put the keys where its grammar wants. */
+    shortcut: (keys: string) => string;
+    /** Heading of the suggestions shown for an empty query. */
+    suggestions: string;
+    /** Heading for entries that name no `group`. */
+    results: string;
+}
+declare const DEFAULT_GLOBAL_SEARCH_LABELS: GlobalSearchLabels;
+/**
+ * A place results come from that is not the static index — a server search, a
+ * local-first store too large to hand over whole. Each source is its own group, with its
+ * own debounce, its own "Searching…" line and its own failure: the static groups never
+ * wait for it, and one source failing never takes another's results with it.
+ */
+interface GlobalSearchSource {
+    /** Stable key — the effect that runs the source is keyed by it, not by identity. */
+    id: string;
+    /** The group its results are shown under (an entry's own `group` is ignored). */
+    group: string;
+    /** Called with the trimmed query. Its results are shown AS GIVEN — the source ranked
+     *  them — and never re-filtered by the index's matcher. `signal` aborts when the query
+     *  moves on or the palette closes; a stale answer is dropped either way. */
+    search: (query: string, signal: AbortSignal) => Promise<readonly SearchEntry[]> | readonly SearchEntry[];
+    /** Shortest query it is asked for. Default 2 — one letter matches half a database. */
+    minChars?: number;
+    /** Quiet period after the last keystroke before it is asked. Default 200ms. */
+    debounceMs?: number;
+    /** Rows kept. Default: `indexOptions.groupLimit` (8). */
+    limit?: number;
+    /** Mask every row of this source for session replay, hints (amounts) included. An
+     *  entry's own `redact` still wins. */
+    redact?: boolean;
+    /** Told when `search` throws or rejects (not when it is aborted). The group then
+     *  shows the palette's `error` line instead of rows. */
+    onError?: (error: unknown) => void;
+}
+/** What a custom trigger gets: everything the default button uses. */
+interface GlobalSearchTriggerProps {
+    open: () => void;
+    /** Resolved `trigger` label — the accessible name. */
+    label: string;
+    /** Resolved `shortcut(keys)` — the tooltip. */
+    tooltip: string;
+    /** "⌘K" on Apple platforms, "Ctrl K" elsewhere. */
+    keys: string;
+    /** For the trigger's `aria-keyshortcuts`. */
+    ariaKeyShortcuts: string;
+}
+/** A suggestion for the empty query: an entry, the `id` of one in `entries`, or a query
+ *  to type into the field. */
+type GlobalSearchSuggestion = SearchEntry | string | {
+    query: string;
+};
+interface GlobalSearchProps {
+    /**
+     * The static index: pages, actions, settings rows — already filtered by the app (by
+     * role, by privacy mode). Matched and ranked by {@link createSearchIndex}.
+     *
+     * Changing it re-runs the open search by itself. Nothing has to be stable: the index is
+     * rebuilt only when the entries' TEXT changes (ids, titles, keywords, …), so a list
+     * rebuilt on every render — `data = []` while a query is pending, icons as fresh JSX —
+     * neither re-indexes nor loops, and the icons and handlers used are always the latest.
+     */
+    entries?: readonly SearchEntry[];
+    /** The async sources, each streamed into its own group. */
+    sources?: readonly GlobalSearchSource[];
+    /** What the empty query shows, under the `suggestions` heading. */
+    suggestions?: readonly GlobalSearchSuggestion[];
+    /** Groups listed here come first, in this order; the rest follow in ranking order. */
+    groupOrder?: readonly string[];
+    /** Ranking and capping — `groupLimit` (default 8) applies to every group. */
+    indexOptions?: SearchIndexOptions;
+    /**
+     * How an entry's `href` is followed on a plain click or ↵. Default: react-router's
+     * `navigate` when the search is rendered inside a router, else a full page load.
+     */
+    navigate?: (href: string) => void;
+    /**
+     * The browser URL of an `href`, for the row's real link (middle-/⌘-click opens a tab).
+     * Default inside a router: the router's own (`#/page` under a hash router, the
+     * basename prefixed under a browser router); outside one, the href itself.
+     */
+    hrefFor?: (href: string) => string;
+    /** Register ⌘K / Ctrl K. Default true; turn it off for a second, scoped search on a
+     *  page that already has the app-wide one. */
+    shortcut?: boolean;
+    /** Controlled open state — so a button anywhere can open it. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Controlled query, as on `CommandPalette` (keksdose binds it to the URL's `q`). */
+    query?: string;
+    onQueryChange?: (query: string) => void;
+    searchOn?: "input" | "submit";
+    /** Mask every row for session replay (see `CommandPalette`). A source's or an entry's
+     *  own `redact` wins. */
+    redactLabels?: boolean;
+    fullScreenOnPhone?: boolean;
+    /** `"button"` (default): the top-bar icon button. `"none"`: no trigger — the shortcut
+     *  or a controlled `open` opens it. A function renders a trigger of your own. */
+    trigger?: "button" | "none" | ((props: GlobalSearchTriggerProps) => ReactNode);
+    /** Hide the default trigger below `sm` (kastlan's phone top bar has no room). */
+    hideTriggerOnPhone?: boolean;
+    /** Class for the default trigger button, merged over `TOPBAR_TRIGGER_CLASS`. */
+    triggerClassName?: string;
+    labels?: Partial<GlobalSearchLabels>;
+    /** Passed through to the palette (`empty`, `loading`, `error`, `hint`, …). */
+    paletteLabels?: Partial<CommandPaletteLabels>;
+}
+/**
+ * The app-wide ⌘K search, whole: the top-bar trigger, the shortcut, and a
+ * {@link CommandPalette} fed from a ranked index ({@link createSearchIndex}) and any
+ * number of async sources.
+ *
+ * Every consumer had built this out of `CommandPalette` by hand, and each copy had the
+ * same holes — a substring match, no ranking, no typo tolerance, results in declaration
+ * order, one monolithic provider in which the static groups waited on the slowest
+ * request. This is that wrapper once:
+ *
+ *     <GlobalSearch
+ *       entries={pages}              // { id, title, keywords, group, href, icon }
+ *       sources={[{ id: "tx", group: "Transactions", search: (q, signal) => api.search(q, { signal }) }]}
+ *       suggestions={["page-budget", "action-new-account"]}
+ *     />
+ *
+ * Inside a react-router tree it navigates with the router and builds its links with it;
+ * outside one, pass `navigate` (or accept full page loads).
+ */
+declare function GlobalSearch(props: GlobalSearchProps): react.JSX.Element;
+
+export { DEFAULT_GLOBAL_SEARCH_LABELS, GlobalSearch, type GlobalSearchLabels, type GlobalSearchProps, type GlobalSearchSource, type GlobalSearchSuggestion, type GlobalSearchTriggerProps };