@eifi1/ui-kit 0.6.0 → 0.7.0

package/dist/rhf/form.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/rhf/form.tsx"],"sourcesContent":["/**\n * The react-hook-form adapter: the five parts every form is built from, and the hook\n * they share. `@eifi1/ui-kit/rhf`.\n *\n * ```tsx\n * <Form {...form}>\n *   <FormField control={form.control} name=\"amount\" render={({ field }) => (\n *     <FormItem>\n *       <FormLabel required>Amount</FormLabel>\n *       <FormControl>\n *         <NumberField value={field.value} onCommit={field.onChange} />\n *       </FormControl>\n *       <FormMessage />\n *     </FormItem>\n *   )} />\n * </Form>\n * ```\n *\n * The shape is shadcn's `form.tsx`, on purpose: Kastlan builds every form from that\n * file, so moving onto this one is an import line rather than a rewrite. What differs\n * is what the shadcn file gets wrong:\n *\n *  - **`aria-describedby` names only what is on screen.** shadcn always points the\n *    control at a description id, rendered or not, and at the message id whenever the\n *    field has an error, whether a message was rendered for it or not. A reference to\n *    a node that does not exist describes the field as nothing. Here the description\n *    and the message say when they are mounted, and the control points at exactly\n *    those.\n *  - **Merged, never replaced.** A control that already carries its own\n *    `aria-describedby` keeps it, first — the same rule as the kit's `error` prop\n *    (see `useFieldError` in components/ui.tsx).\n *  - **No Radix.** `FormControl` is a one-child `cloneElement`, not `Slot`, and the\n *    label is the kit's own `Label` — the kit carries no Radix dependency and this\n *    entry is not the place to start.\n *\n * ## Why this is its own entry\n *\n * The main barrel once shipped a react-hook-form hook (`use-rhf-wizard-step`) and\n * removed it: it made react-hook-form an install every consumer's typecheck paid for,\n * for a hook nobody called (see the wizard section of src/index.ts). This is the\n * answer to that, not a reversal of it. Nothing outside `src/rhf*` imports\n * react-hook-form — `__tests__/packaging-contract.test.ts` holds that — and the peer is\n * optional, so an app that does not use it installs nothing and imports nothing.\n *\n * ## Painting the field\n *\n * `FormControl` sets `aria-invalid` on its child. `NumberField` and the pickers paint\n * from that attribute; `Input`, `Select` and `Textarea` paint only from their\n * `invalid` prop (see its note in components/ui.tsx: a bare attribute announces but\n * does not paint), so pass it from the render prop —\n * `<Input {...field} invalid={fieldState.invalid} />`. `FormControl` does not inject\n * `invalid` itself because its child may be a native element, which would print it\n * into the DOM as an unknown attribute.\n */\nimport {\n  Children,\n  cloneElement,\n  createContext,\n  isValidElement,\n  useCallback,\n  useContext,\n  useId,\n  useLayoutEffect,\n  useMemo,\n  useState,\n  type ComponentProps,\n  type ReactElement,\n} from \"react\";\nimport {\n  Controller,\n  FormProvider,\n  useFormContext,\n  useFormState,\n  type ControllerProps,\n  type FieldPath,\n  type FieldValues,\n} from \"react-hook-form\";\nimport { Label, type LabelProps } from \"../components/ui\";\nimport { cn } from \"../lib/cn\";\n\n/** The form's `useForm()` return, spread in: `<Form {...form}>`. react-hook-form's own\n *  `FormProvider`, under the name the shadcn file gave it. */\nexport const Form = FormProvider;\n\n// ── contexts ─────────────────────────────────────────────────────────────────\n\nconst FormFieldContext = createContext<{ name: string } | null>(null);\n\n/** The two optional nodes a control can be described by. */\ntype Described = \"description\" | \"message\";\n\ninterface FormItemContextValue {\n  id: string;\n  mounted: Record<Described, boolean>;\n  mark: (slot: Described, on: boolean) => void;\n}\n\nconst FormItemContext = createContext<FormItemContextValue | null>(null);\n\n// ── FormField ────────────────────────────────────────────────────────────────\n\n/**\n * react-hook-form's `Controller`, with the field's name put in context for the parts\n * below it. Takes exactly `Controller`'s props.\n */\nexport function FormField<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformedValues = TFieldValues,\n>(props: ControllerProps<TFieldValues, TName, TTransformedValues>) {\n  const value = useMemo(() => ({ name: props.name as string }), [props.name]);\n  return (\n    <FormFieldContext.Provider value={value}>\n      <Controller {...props} />\n    </FormFieldContext.Provider>\n  );\n}\n\n// ── useFormField ─────────────────────────────────────────────────────────────\n\n/**\n * The ids and the state of the field around the caller: for a part of your own that\n * sits beside the kit's (a character counter that belongs in `aria-describedby`, a\n * label with a different look).\n *\n * Throws outside a `FormField` + `FormItem` pair. shadcn's version answered there with\n * ids like `undefined-form-item`, which label nothing and fail nowhere.\n */\nexport function useFormField() {\n  const field = useContext(FormFieldContext);\n  const item = useContext(FormItemContext);\n  if (!field) throw new Error(\"useFormField must be used inside <FormField>.\");\n  if (!item) throw new Error(\"useFormField must be used inside <FormItem>.\");\n  const { getFieldState } = useFormContext();\n  // Subscribes this part to the field's state, so a label or message re-renders when\n  // the field's error changes without the whole form doing so.\n  const formState = useFormState({ name: field.name });\n  const state = getFieldState(field.name, formState);\n  const formDescriptionId = `${item.id}-description`;\n  const formMessageId = `${item.id}-message`;\n  const describedBy = [\n    item.mounted.description && formDescriptionId,\n    item.mounted.message && formMessageId,\n  ]\n    .filter(Boolean)\n    .join(\" \");\n  return {\n    id: item.id,\n    name: field.name,\n    formItemId: `${item.id}-control`,\n    formDescriptionId,\n    formMessageId,\n    /** The ids of the description and message that are actually rendered, or\n     *  `undefined` when neither is. */\n    describedBy: describedBy || undefined,\n    ...state,\n  };\n}\n\n// ── FormItem ─────────────────────────────────────────────────────────────────\n\nexport type FormItemProps = ComponentProps<\"div\">;\n\n/** One field's box: mints the id its label, control, description and message share. */\nexport function FormItem({ className, ...rest }: FormItemProps) {\n  const id = useId();\n  const [mounted, setMounted] = useState<Record<Described, boolean>>({\n    description: false,\n    message: false,\n  });\n  const mark = useCallback(\n    (slot: Described, on: boolean) =>\n      setMounted((prev) => (prev[slot] === on ? prev : { ...prev, [slot]: on })),\n    [],\n  );\n  const value = useMemo(() => ({ id, mounted, mark }), [id, mounted, mark]);\n  return (\n    <FormItemContext.Provider value={value}>\n      <div data-slot=\"form-item\" {...rest} className={cn(\"grid gap-1\", className)} />\n    </FormItemContext.Provider>\n  );\n}\n\n/** Report a describing node's presence to the item, so the control points at it only\n *  while it is on screen. A layout effect, so the reference lands before paint. */\nfunction useDescribes(slot: Described, on: boolean) {\n  const item = useContext(FormItemContext);\n  const mark = item?.mark;\n  useLayoutEffect(() => {\n    if (!on || !mark) return;\n    mark(slot, true);\n    return () => mark(slot, false);\n  }, [slot, on, mark]);\n}\n\n// ── FormLabel ────────────────────────────────────────────────────────────────\n\nexport type FormLabelProps = LabelProps;\n\n/**\n * The kit's {@link Label}, bound to the control by `htmlFor` and turned to the danger\n * colour while the field is invalid. `required` draws the kit's `aria-hidden` mark:\n * whether the field is required is the control's to announce.\n */\nexport function FormLabel({ className, ...rest }: FormLabelProps) {\n  const { error, formItemId } = useFormField();\n  return (\n    <Label\n      data-slot=\"form-label\"\n      data-error={error ? true : undefined}\n      htmlFor={formItemId}\n      {...rest}\n      className={cn(\"data-[error=true]:text-[var(--danger)]\", className)}\n    />\n  );\n}\n\n// ── FormControl ──────────────────────────────────────────────────────────────\n\nexport interface FormControlProps {\n  /** Exactly one element: the kit field, or a native one. It receives `id`,\n   *  `aria-describedby` and `aria-invalid`. */\n  children: ReactElement;\n}\n\ntype AriaProps = {\n  id?: string;\n  \"aria-describedby\"?: string;\n  \"aria-invalid\"?: ComponentProps<\"input\">[\"aria-invalid\"];\n};\n\n/**\n * Wires its one child to the item: the `id` the label points at, `aria-describedby`\n * naming the rendered description and message, and `aria-invalid` while the field has\n * an error.\n *\n * The child's own values win where it has them (an explicit `id`, a set\n * `aria-invalid`), as they did under Radix `Slot`; its own `aria-describedby` is\n * merged in front of the item's rather than replaced.\n */\nexport function FormControl({ children }: FormControlProps) {\n  const { invalid, formItemId, describedBy } = useFormField();\n  const child = Children.only(children);\n  if (!isValidElement<AriaProps>(child)) return child;\n  const own = child.props;\n  const merged = [own[\"aria-describedby\"], describedBy].filter(Boolean).join(\" \");\n  return cloneElement(child, {\n    id: own.id ?? formItemId,\n    \"aria-describedby\": merged || undefined,\n    \"aria-invalid\": own[\"aria-invalid\"] ?? (invalid || undefined),\n  });\n}\n\n// ── FormDescription / FormMessage ────────────────────────────────────────────\n\nexport type FormDescriptionProps = ComponentProps<\"p\">;\n\n/** Standing advice under the field (\"at least twelve characters\"). */\nexport function FormDescription({ className, ...rest }: FormDescriptionProps) {\n  const { formDescriptionId } = useFormField();\n  useDescribes(\"description\", true);\n  return (\n    <p\n      data-slot=\"form-description\"\n      {...rest}\n      id={formDescriptionId}\n      className={cn(\"text-[11px] leading-tight text-[var(--text-muted)]\", className)}\n    />\n  );\n}\n\nexport type FormMessageProps = ComponentProps<\"p\">;\n\n/**\n * The field's error message, from the form — the kit renders no string of its own\n * here; the schema or the `rules` carry the words. Without an error it renders its\n * `children`, if any, and otherwise nothing.\n *\n * Deliberately NOT `role=\"alert\"`, for the reason the kit's `error` prop gives: the\n * message is read when focus reaches the control, which is where a field's own error\n * is wanted, and an alert would interrupt on every keystroke of a form that\n * re-validates as you type.\n */\nexport function FormMessage({ className, children, ...rest }: FormMessageProps) {\n  const { error, formMessageId } = useFormField();\n  const body = error ? String(error.message ?? \"\") : children;\n  const shown = body !== undefined && body !== null && body !== false && body !== \"\";\n  useDescribes(\"message\", shown);\n  if (!shown) return null;\n  return (\n    <p\n      data-slot=\"form-message\"\n      {...rest}\n      id={formMessageId}\n      className={cn(\"text-[11px] leading-tight text-[var(--danger)]\", className)}\n    >\n      {body}\n    </p>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/rhf/form.tsx"],"sourcesContent":["/**\n * The react-hook-form adapter: the five parts every form is built from, and the hook\n * they share. `@eifi1/ui-kit/rhf`.\n *\n * ```tsx\n * <Form {...form}>\n *   <FormField control={form.control} name=\"amount\" render={({ field }) => (\n *     <FormItem>\n *       <FormLabel required>Amount</FormLabel>\n *       <FormControl>\n *         <NumberField value={field.value} onCommit={field.onChange} />\n *       </FormControl>\n *       <FormMessage />\n *     </FormItem>\n *   )} />\n * </Form>\n * ```\n *\n * The shape is shadcn's `form.tsx`, on purpose: Kastlan builds every form from that\n * file, so moving onto this one is an import line rather than a rewrite. What differs\n * is what the shadcn file gets wrong:\n *\n *  - **`aria-describedby` names only what is on screen.** shadcn always points the\n *    control at a description id, rendered or not, and at the message id whenever the\n *    field has an error, whether a message was rendered for it or not. A reference to\n *    a node that does not exist describes the field as nothing. Here the description\n *    and the message say when they are mounted, and the control points at exactly\n *    those.\n *  - **Merged, never replaced.** A control that already carries its own\n *    `aria-describedby` keeps it, first — the same rule as the kit's `error` prop\n *    (see `useFieldError` in components/ui.tsx).\n *  - **No Radix.** `FormControl` is a one-child `cloneElement`, not `Slot`, and the\n *    label is the kit's own `Label` — the kit carries no Radix dependency and this\n *    entry is not the place to start.\n *\n * ## Why this is its own entry\n *\n * The main barrel once shipped a react-hook-form hook (`use-rhf-wizard-step`) and\n * removed it: it made react-hook-form an install every consumer's typecheck paid for,\n * for a hook nobody called (see the wizard section of src/index.ts). This is the\n * answer to that, not a reversal of it. Nothing outside `src/rhf*` imports\n * react-hook-form — `__tests__/packaging-contract.test.ts` holds that — and the peer is\n * optional, so an app that does not use it installs nothing and imports nothing.\n *\n * ## Painting the field\n *\n * `FormControl` sets `aria-invalid` on its child. `NumberField` and the pickers paint\n * from that attribute; `Input`, `Select` and `Textarea` paint only from their\n * `invalid` prop (see its note in components/ui.tsx: a bare attribute announces but\n * does not paint), so pass it from the render prop —\n * `<Input {...field} invalid={fieldState.invalid} />`. `FormControl` does not inject\n * `invalid` itself because its child may be a native element, which would print it\n * into the DOM as an unknown attribute.\n *\n * ## Clearing a picker: `null`, unless the picker is told otherwise\n *\n * Nothing here touches a value. `FormField` is `Controller`, so what a control hands\n * `field.onChange` is exactly what lands in the form — and what the entity pickers\n * hand it on a clear is `null`: `EntityCombobox`'s \"×\", `InlineEntityCombobox`'s \"×\"\n * and its emptied text. (`MultiEntityCombobox` and `MultiSelect` clear to `[]`.)\n *\n * A zod schema that spells \"no choice\" as `\"\"` (`z.string()`, or `z.literal(\"\")` in a\n * union) then fails on the `null`. Say so on the PICKER, not here:\n *\n * ```tsx\n * <EntityCombobox clearValue=\"\" value={field.value} onChange={field.onChange} … />\n * ```\n *\n * `clearValue` also types `onChange` (`(v: V | \"\") => void` rather than\n * `V | null`) and reads `\"\"` back as \"nothing selected\", so an initial `defaultValues`\n * of `\"\"` shows the placeholder rather than an unresolvable id. The adapter does not\n * coerce because it cannot see the schema: mapping `null` to `\"\"` for every field\n * would break every schema that wants `null` (`z.string().nullable()`), which is the\n * pickers' default for a reason — it is the one value no option can have.\n */\nimport {\n  Children,\n  cloneElement,\n  createContext,\n  isValidElement,\n  useCallback,\n  useContext,\n  useId,\n  useLayoutEffect,\n  useMemo,\n  useState,\n  type ComponentProps,\n  type ReactElement,\n} from \"react\";\nimport {\n  Controller,\n  FormProvider,\n  useFormContext,\n  useFormState,\n  type ControllerProps,\n  type FieldPath,\n  type FieldValues,\n} from \"react-hook-form\";\nimport { Label, type LabelProps } from \"../components/ui\";\nimport { cn } from \"../lib/cn\";\n\n/** The form's `useForm()` return, spread in: `<Form {...form}>`. react-hook-form's own\n *  `FormProvider`, under the name the shadcn file gave it. */\nexport const Form = FormProvider;\n\n// ── contexts ─────────────────────────────────────────────────────────────────\n\nconst FormFieldContext = createContext<{ name: string } | null>(null);\n\n/** The two optional nodes a control can be described by. */\ntype Described = \"description\" | \"message\";\n\ninterface FormItemContextValue {\n  id: string;\n  mounted: Record<Described, boolean>;\n  mark: (slot: Described, on: boolean) => void;\n}\n\nconst FormItemContext = createContext<FormItemContextValue | null>(null);\n\n// ── FormField ────────────────────────────────────────────────────────────────\n\n/**\n * react-hook-form's `Controller`, with the field's name put in context for the parts\n * below it. Takes exactly `Controller`'s props.\n */\nexport function FormField<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n  TTransformedValues = TFieldValues,\n>(props: ControllerProps<TFieldValues, TName, TTransformedValues>) {\n  const value = useMemo(() => ({ name: props.name as string }), [props.name]);\n  return (\n    <FormFieldContext.Provider value={value}>\n      <Controller {...props} />\n    </FormFieldContext.Provider>\n  );\n}\n\n// ── useFormField ─────────────────────────────────────────────────────────────\n\n/**\n * The ids and the state of the field around the caller: for a part of your own that\n * sits beside the kit's (a character counter that belongs in `aria-describedby`, a\n * label with a different look).\n *\n * Throws outside a `FormField` + `FormItem` pair. shadcn's version answered there with\n * ids like `undefined-form-item`, which label nothing and fail nowhere.\n */\nexport function useFormField() {\n  const field = useContext(FormFieldContext);\n  const item = useContext(FormItemContext);\n  if (!field) throw new Error(\"useFormField must be used inside <FormField>.\");\n  if (!item) throw new Error(\"useFormField must be used inside <FormItem>.\");\n  const { getFieldState } = useFormContext();\n  // Subscribes this part to the field's state, so a label or message re-renders when\n  // the field's error changes without the whole form doing so.\n  const formState = useFormState({ name: field.name });\n  const state = getFieldState(field.name, formState);\n  const formDescriptionId = `${item.id}-description`;\n  const formMessageId = `${item.id}-message`;\n  const describedBy = [\n    item.mounted.description && formDescriptionId,\n    item.mounted.message && formMessageId,\n  ]\n    .filter(Boolean)\n    .join(\" \");\n  return {\n    id: item.id,\n    name: field.name,\n    formItemId: `${item.id}-control`,\n    formDescriptionId,\n    formMessageId,\n    /** The ids of the description and message that are actually rendered, or\n     *  `undefined` when neither is. */\n    describedBy: describedBy || undefined,\n    ...state,\n  };\n}\n\n// ── FormItem ─────────────────────────────────────────────────────────────────\n\nexport type FormItemProps = ComponentProps<\"div\">;\n\n/** One field's box: mints the id its label, control, description and message share. */\nexport function FormItem({ className, ...rest }: FormItemProps) {\n  const id = useId();\n  const [mounted, setMounted] = useState<Record<Described, boolean>>({\n    description: false,\n    message: false,\n  });\n  const mark = useCallback(\n    (slot: Described, on: boolean) =>\n      setMounted((prev) => (prev[slot] === on ? prev : { ...prev, [slot]: on })),\n    [],\n  );\n  const value = useMemo(() => ({ id, mounted, mark }), [id, mounted, mark]);\n  return (\n    <FormItemContext.Provider value={value}>\n      <div data-slot=\"form-item\" {...rest} className={cn(\"grid gap-1\", className)} />\n    </FormItemContext.Provider>\n  );\n}\n\n/** Report a describing node's presence to the item, so the control points at it only\n *  while it is on screen. A layout effect, so the reference lands before paint. */\nfunction useDescribes(slot: Described, on: boolean) {\n  const item = useContext(FormItemContext);\n  const mark = item?.mark;\n  useLayoutEffect(() => {\n    if (!on || !mark) return;\n    mark(slot, true);\n    return () => mark(slot, false);\n  }, [slot, on, mark]);\n}\n\n// ── FormLabel ────────────────────────────────────────────────────────────────\n\nexport type FormLabelProps = LabelProps;\n\n/**\n * The kit's {@link Label}, bound to the control by `htmlFor` and turned to the danger\n * colour while the field is invalid. `required` draws the kit's `aria-hidden` mark:\n * whether the field is required is the control's to announce.\n */\nexport function FormLabel({ className, ...rest }: FormLabelProps) {\n  const { error, formItemId } = useFormField();\n  return (\n    <Label\n      data-slot=\"form-label\"\n      data-error={error ? true : undefined}\n      htmlFor={formItemId}\n      {...rest}\n      className={cn(\"data-[error=true]:text-[var(--danger)]\", className)}\n    />\n  );\n}\n\n// ── FormControl ──────────────────────────────────────────────────────────────\n\nexport interface FormControlProps {\n  /** Exactly one element: the kit field, or a native one. It receives `id`,\n   *  `aria-describedby` and `aria-invalid`. */\n  children: ReactElement;\n}\n\ntype AriaProps = {\n  id?: string;\n  \"aria-describedby\"?: string;\n  \"aria-invalid\"?: ComponentProps<\"input\">[\"aria-invalid\"];\n};\n\n/**\n * Wires its one child to the item: the `id` the label points at, `aria-describedby`\n * naming the rendered description and message, and `aria-invalid` while the field has\n * an error.\n *\n * The child's own values win where it has them (an explicit `id`, a set\n * `aria-invalid`), as they did under Radix `Slot`; its own `aria-describedby` is\n * merged in front of the item's rather than replaced.\n */\nexport function FormControl({ children }: FormControlProps) {\n  const { invalid, formItemId, describedBy } = useFormField();\n  const child = Children.only(children);\n  if (!isValidElement<AriaProps>(child)) return child;\n  const own = child.props;\n  const merged = [own[\"aria-describedby\"], describedBy].filter(Boolean).join(\" \");\n  return cloneElement(child, {\n    id: own.id ?? formItemId,\n    \"aria-describedby\": merged || undefined,\n    \"aria-invalid\": own[\"aria-invalid\"] ?? (invalid || undefined),\n  });\n}\n\n// ── FormDescription / FormMessage ────────────────────────────────────────────\n\nexport type FormDescriptionProps = ComponentProps<\"p\">;\n\n/** Standing advice under the field (\"at least twelve characters\"). */\nexport function FormDescription({ className, ...rest }: FormDescriptionProps) {\n  const { formDescriptionId } = useFormField();\n  useDescribes(\"description\", true);\n  return (\n    <p\n      data-slot=\"form-description\"\n      {...rest}\n      id={formDescriptionId}\n      className={cn(\"text-[11px] leading-tight text-[var(--text-muted)]\", className)}\n    />\n  );\n}\n\nexport type FormMessageProps = ComponentProps<\"p\">;\n\n/**\n * The field's error message, from the form — the kit renders no string of its own\n * here; the schema or the `rules` carry the words. Without an error it renders its\n * `children`, if any, and otherwise nothing.\n *\n * Deliberately NOT `role=\"alert\"`, for the reason the kit's `error` prop gives: the\n * message is read when focus reaches the control, which is where a field's own error\n * is wanted, and an alert would interrupt on every keystroke of a form that\n * re-validates as you type.\n */\nexport function FormMessage({ className, children, ...rest }: FormMessageProps) {\n  const { error, formMessageId } = useFormField();\n  const body = error ? String(error.message ?? \"\") : children;\n  const shown = body !== undefined && body !== null && body !== false && body !== \"\";\n  useDescribes(\"message\", shown);\n  if (!shown) return null;\n  return (\n    <p\n      data-slot=\"form-message\"\n      {...rest}\n      id={formMessageId}\n      className={cn(\"text-[11px] leading-tight text-[var(--danger)]\", className)}\n    >\n      {body}\n    </p>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/search/command-palette.d.ts

@@ -36,6 +36,11 @@ interface CommandPaletteLabels {
      * `CommandPaletteLabels` keeps compiling; the default always carries it.
      */
     dialog?: string;
+    /**
+     * Shown in place of the results when the `search` provider throws or its promise
+     * rejects. Optional for the same reason as `dialog`; the default always carries it.
+     */
+    error?: string;
 }
 declare const DEFAULT_COMMAND_PALETTE_LABELS: CommandPaletteLabels;
 interface CommandPaletteProps {

package/dist/search/command-palette.js

@@ -1,16 +1,19 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { useEffect, useMemo, useRef, useState } from "react";
+import { useEffect, useId, useMemo, useRef, useState } from "react";
 import { createPortal } from "react-dom";
 import { Search } from "lucide-react";
 import { cn } from "../lib/cn.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";
 const DEFAULT_COMMAND_PALETTE_LABELS = {
   placeholder: "Search\u2026",
   empty: "No results",
   loading: "Searching\u2026",
-  dialog: "Search"
+  dialog: "Search",
+  error: "Search failed. Try again."
 };
 const { dialog: DEFAULT_DIALOG_NAME, ...DEFAULTS_WITHOUT_DIALOG } = DEFAULT_COMMAND_PALETTE_LABELS;
 function useCommandKey(onOpen) {
@@ -37,19 +40,25 @@ function CommandPalette({
   const [query, setQuery] = useState("");
   const [results, setResults] = useState([]);
   const [loading, setLoading] = useState(false);
+  const [failed, setFailed] = useState(false);
   const [active, setActive] = useState(0);
+  const uid = useId();
+  const listId = `${uid}-list`;
+  const itemId = (id) => `${uid}-item-${id}`;
+  const groupId = (index) => `${uid}-group-${index}`;
+  const dialogRef = useRef(null);
   const inputRef = useRef(null);
   const listRef = useRef(null);
   const searchRef = useRef(search);
   searchRef.current = search;
   const reqId = useRef(0);
   useOverlayHistory(open, onClose);
+  useFocusTrap(dialogRef, { active: open, initialFocus: () => inputRef.current });
+  useBodyScrollLock(open);
   useEffect(() => {
     if (!open) return;
     setQuery("");
     setActive(0);
-    const id = requestAnimationFrame(() => inputRef.current?.focus());
-    return () => cancelAnimationFrame(id);
   }, [open]);
   useEffect(() => {
     if (!open) return;
@@ -60,8 +69,16 @@ function CommandPalette({
         const r = await Promise.resolve(searchRef.current(query));
         if (reqId.current === id) {
           setResults(r);
+          setFailed(false);
           setActive(0);
         }
+      } catch (err) {
+        if (reqId.current === id) {
+          setResults([]);
+          setFailed(true);
+          setActive(0);
+        }
+        console.error("CommandPalette: search failed", err);
       } finally {
         if (reqId.current === id) setLoading(false);
       }
@@ -99,7 +116,10 @@ function CommandPalette({
     } else if (e.key === "Enter") {
       e.preventDefault();
       choose(flat[active]);
-    } else if (e.key === "Escape") {
+    }
+  };
+  const onDialogKeyDown = (e) => {
+    if (e.key === "Escape") {
       e.preventDefault();
       onClose();
     }
@@ -121,10 +141,13 @@ function CommandPalette({
         children: /* @__PURE__ */ jsxs(
           "div",
           {
+            ref: dialogRef,
             role: "dialog",
             "aria-modal": "true",
             "aria-label": dialogName,
-            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",
+            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",
             children: [
               /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 border-b border-[var(--border)] px-3", children: [
                 /* @__PURE__ */ jsx(Search, { className: "size-4 shrink-0 text-[var(--text-placeholder)]" }),
@@ -134,8 +157,8 @@ function CommandPalette({
                     ref: inputRef,
                     role: "combobox",
                     "aria-expanded": true,
-                    "aria-controls": "command-palette-list",
-                    "aria-activedescendant": flat[active] ? `command-item-${flat[active].id}` : void 0,
+                    "aria-controls": listId,
+                    "aria-activedescendant": flat[active] ? itemId(flat[active].id) : void 0,
                     value: query,
                     onChange: (e) => setQuery(e.target.value),
                     onKeyDown,
@@ -145,48 +168,55 @@ function CommandPalette({
                 ),
                 loading && /* @__PURE__ */ jsx("span", { className: "shrink-0 text-[11px] text-[var(--text-placeholder)]", children: l.loading })
               ] }),
-              /* @__PURE__ */ jsxs("ul", { id: "command-palette-list", ref: listRef, role: "listbox", className: "min-h-0 flex-1 overflow-y-auto py-1", children: [
-                flat.length === 0 && !loading && /* @__PURE__ */ jsx("li", { className: "px-3 py-6 text-center text-sm text-[var(--text-muted)]", children: l.empty }),
-                groups.map(({ group, items }) => /* @__PURE__ */ jsxs("li", { children: [
-                  /* @__PURE__ */ jsx("div", { className: "px-3 pb-0.5 pt-2 text-[10px] font-semibold uppercase tracking-wide text-[var(--text-placeholder)]", children: group }),
-                  /* @__PURE__ */ jsx("ul", { children: items.map((item) => {
-                    flatIndex += 1;
-                    const idx = flatIndex;
-                    const isActive = idx === active;
-                    const shared = {
-                      id: `command-item-${item.id}`,
-                      role: "option",
-                      "aria-selected": isActive,
-                      "data-index": idx,
-                      onMouseMove: () => setActive(idx),
-                      className: cn(
-                        "flex w-full items-center gap-2.5 px-3 py-2 text-left text-sm",
-                        isActive ? "bg-[var(--bg-active)] text-[var(--text-primary)]" : "text-[var(--text-secondary)]"
-                      )
-                    };
-                    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 })
-                    ] });
-                    return /* @__PURE__ */ jsx("li", { children: item.href ? /* @__PURE__ */ jsx(
-                      "a",
-                      {
-                        ...shared,
-                        href: item.href,
-                        draggable: false,
-                        onClick: (e) => {
-                          if (e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey)
-                            return;
-                          e.preventDefault();
-                          choose(item);
-                        },
-                        children: inner
-                      }
-                    ) : /* @__PURE__ */ jsx("button", { type: "button", ...shared, onClick: () => choose(item), children: inner }) }, item.id);
-                  }) })
-                ] }, group))
-              ] }),
+              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 }),
+              /* @__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",
+                  {
+                    id: groupId(groupIndex),
+                    role: "presentation",
+                    className: "px-3 pb-0.5 pt-2 text-[10px] font-semibold uppercase tracking-wide text-[var(--text-placeholder)]",
+                    children: group
+                  }
+                ),
+                /* @__PURE__ */ jsx("ul", { role: "group", "aria-labelledby": groupId(groupIndex), children: items.map((item) => {
+                  flatIndex += 1;
+                  const idx = flatIndex;
+                  const isActive = idx === active;
+                  const shared = {
+                    id: itemId(item.id),
+                    role: "option",
+                    "aria-selected": isActive,
+                    "data-index": idx,
+                    onMouseMove: () => setActive(idx),
+                    className: cn(
+                      "flex w-full items-center gap-2.5 px-3 py-2 text-start text-sm",
+                      isActive ? "bg-[var(--bg-active)] text-[var(--text-primary)]" : "text-[var(--text-secondary)]"
+                    )
+                  };
+                  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 })
+                  ] });
+                  return /* @__PURE__ */ jsx("li", { role: "presentation", children: item.href ? /* @__PURE__ */ jsx(
+                    "a",
+                    {
+                      ...shared,
+                      href: item.href,
+                      draggable: false,
+                      onClick: (e) => {
+                        if (e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey)
+                          return;
+                        e.preventDefault();
+                        choose(item);
+                      },
+                      children: inner
+                    }
+                  ) : /* @__PURE__ */ jsx("button", { type: "button", ...shared, onClick: () => choose(item), children: inner }) }, item.id);
+                }) })
+              ] }, group)) }),
               l.hint && /* @__PURE__ */ jsx("div", { className: "border-t border-[var(--border)] px-3 py-1.5 text-[11px] text-[var(--text-placeholder)]", children: l.hint })
             ]
           }

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/search/command-palette.tsx"],"sourcesContent":["import { useEffect, 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 { 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\nexport const DEFAULT_COMMAND_PALETTE_LABELS: CommandPaletteLabels = {\n  placeholder: \"Search…\",\n  empty: \"No results\",\n  loading: \"Searching…\",\n  dialog: \"Search\",\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  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  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 [query, setQuery] = useState(\"\");\n  const [results, setResults] = useState<CommandItem[]>([]);\n  const [loading, setLoading] = useState(false);\n  const [active, setActive] = useState(0);\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  // Reset + focus when opened.\n  useEffect(() => {\n    if (!open) return;\n    setQuery(\"\");\n    setActive(0);\n    const id = requestAnimationFrame(() => inputRef.current?.focus());\n    return () => cancelAnimationFrame(id);\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          setActive(0);\n        }\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    } else 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      <div\n        role=\"dialog\"\n        aria-modal=\"true\"\n        aria-label={dialogName}\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\"\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=\"command-palette-list\"\n            aria-activedescendant={flat[active] ? `command-item-${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        <ul id=\"command-palette-list\" ref={listRef} role=\"listbox\" className=\"min-h-0 flex-1 overflow-y-auto py-1\">\n          {flat.length === 0 && !loading && (\n            <li className=\"px-3 py-6 text-center text-sm text-[var(--text-muted)]\">{l.empty}</li>\n          )}\n          {groups.map(({ group, items }) => (\n            <li key={group}>\n              <div className=\"px-3 pb-0.5 pt-2 text-[10px] font-semibold uppercase tracking-wide text-[var(--text-placeholder)]\">\n                {group}\n              </div>\n              <ul>\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: `command-item-${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-left 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}>\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 { 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  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  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 [query, setQuery] = useState(\"\");\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.\n  useEffect(() => {\n    if (!open) return;\n    setQuery(\"\");\n    setActive(0);\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":[]}

package/dist/shell/app-shell.d.ts

@@ -80,6 +80,18 @@ interface AppShellProps extends ComponentPropsWithoutRef<"div"> {
      *  bottom bar — the phone's counterpart of the sidebar's second level. Default true;
      *  `false` keeps the single bar, where a group entry only links to its own `to`. */
     mobileSubNav?: boolean;
+    /**
+     * Lay the shell out inside its PARENT'S box instead of the viewport: `h-full` rather
+     * than `h-dvh`, its own scroll container at every width, a bottom bar pinned to the
+     * shell rather than the window, `--app-nav-h` published on the shell alone, and no
+     * persisted collapse state unless `collapseStorageKey` is passed. For an app preview,
+     * a device frame, a docs example.
+     *
+     * Implied for a shell rendered inside another AppShell, which is the case this
+     * exists for: the inner one used to publish its own nav height on `<html>`, fight
+     * the outer one over it, and remove it on unmount from under the outer app.
+     */
+    embedded?: boolean;
 }
 /**
  * The responsive application shell: a top bar, a collapsible desktop sidebar
@@ -88,6 +100,6 @@ interface AppShellProps extends ComponentPropsWithoutRef<"div"> {
  * `NavLink`; domain-free — nav items, brand, footer and the top bar's actions
  * are all supplied by the app.
  */
-declare function AppShell({ nav, topBar, children, footer, sidebarFooter, collapseStorageKey, collapseLabel, expandLabel, subNav, mobileSubNav, toggleGroupLabel, className, ...rest }: AppShellProps): react.JSX.Element;
+declare function AppShell({ nav, topBar, children, footer, sidebarFooter, collapseStorageKey: collapseStorageKeyProp, collapseLabel, expandLabel, subNav, mobileSubNav, toggleGroupLabel, embedded: embeddedProp, className, ...rest }: AppShellProps): react.JSX.Element;
 
 export { AppShell, type AppShellNavItem, type AppShellProps, type AppShellSubItem };