@alfadocs/ui-kit-debug 1.50.1 → 1.51.0

package/dist/_chunks/header-settings-D0M3WNTS.js

@@ -0,0 +1,305 @@
+import { jsx as s, jsxs as h } from "react/jsx-runtime";
+import { forwardRef as C, useRef as p, useImperativeHandle as E, useCallback as I, useMemo as R } from "react";
+import { c as K } from "./index-D2ZczOXr.js";
+import { useTranslation as T } from "react-i18next";
+import { I as _ } from "./icon-button-JAXAkqWC.js";
+import { D as n } from "./dropdown-menu-DIzxr_lp.js";
+import { u as H, c as g, L as O, a as j } from "./locale-picker-Z42P8T-i.js";
+import { u as N } from "./use-locale-BkCIHujH.js";
+import { u as x } from "./use-theme-CAuo6EYT.js";
+import { u as D } from "./registry-DvAUVLHh.js";
+import { S as P } from "./settings-d25ju_6L.js";
+const F = {
+  id: "header-settings",
+  // Each setter persists a single preference value (locale / theme /
+  // accessibility) — `set_value` semantics, not an ephemeral view switch.
+  capabilities: ["set_value"],
+  // Read-back for all three setters. None of these preferences is
+  // recoverable from the DOM — `useTheme` resolves preference + OS into
+  // a single applied class, so `theme: 'system'` and `theme: 'light'`
+  // both paint `.theme-light` — and `set_locale` swallows unknown tags.
+  // Without these slots an agent cannot distinguish "switched to
+  // Italian" from "the tag was dropped on the floor". All four are UI
+  // preferences: no PHI, no patient-identifiable data (§7).
+  state: {
+    locale: {
+      type: "string",
+      descriptionKey: "ui.agent.headerSettings.state.locale",
+      description: 'Active IETF language tag (e.g. "en", "it", "ar"). Read after `set_locale` to confirm the switch landed — an unknown tag is silently dropped and leaves this unchanged.',
+      read: (e) => e.getLocale()
+    },
+    theme: {
+      type: "'light' | 'dark' | 'system'",
+      descriptionKey: "ui.agent.headerSettings.state.theme",
+      description: "Stored base-theme preference. `'system'` means no override is set and the OS decides — read `resolvedTheme` for what is actually painted.",
+      read: (e) => e.getTheme()
+    },
+    accessibility: {
+      type: "'default' | 'accessible' | 'system'",
+      descriptionKey: "ui.agent.headerSettings.state.accessibility",
+      description: "Stored AAA-contrast preference. `'system'` means no override is set and `prefers-contrast` decides.",
+      read: (e) => e.getAccessibility()
+    },
+    resolvedTheme: {
+      type: "'light' | 'dark' | 'light-accessible' | 'dark-accessible'",
+      descriptionKey: "ui.agent.headerSettings.state.resolvedTheme",
+      description: 'The theme actually applied to the document once preference and OS signals resolve. This is what makes a `set_theme("system")` or `set_accessibility("system")` write verifiable.',
+      read: (e) => e.getResolvedTheme()
+    }
+  },
+  actions: {
+    set_locale: {
+      safety: "write",
+      argsType: "{ locale: string }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          locale: {
+            type: "string",
+            description: 'IETF language tag (e.g. "en", "it", "ar"). Unknown tags are silently dropped.'
+          }
+        },
+        required: ["locale"]
+      },
+      idempotent: !0,
+      descriptionKey: "ui.agent.headerSettings.actions.setLocale",
+      description: "Switch the active locale to the given IETF tag. Unknown tags are silently dropped — read the `locale` state slot afterwards to confirm.",
+      errors: [
+        "Silently ignored when the tag names a locale the kit ships no bundle for — `locale` is unchanged."
+      ],
+      examples: [{ args: { locale: "it" }, note: "Switch to Italian." }],
+      invoke: (e, a) => {
+        e.setLocale(a.locale);
+      }
+    },
+    set_theme: {
+      safety: "write",
+      argsType: '{ theme: "light" | "dark" | "system" }',
+      argsSchema: {
+        type: "object",
+        properties: { theme: { enum: ["light", "dark", "system"] } },
+        required: ["theme"]
+      },
+      idempotent: !0,
+      descriptionKey: "ui.agent.headerSettings.actions.setTheme",
+      description: "Switch the theme preference. Verify with the `theme` slot (the stored preference) and `resolvedTheme` (what is actually painted).",
+      examples: [
+        { args: { theme: "dark" }, note: "Switch to the dark theme." }
+      ],
+      invoke: (e, a) => {
+        e.setTheme(a.theme);
+      }
+    },
+    set_accessibility: {
+      safety: "write",
+      argsType: '{ accessibility: "default" | "accessible" | "system" }',
+      argsSchema: {
+        type: "object",
+        properties: {
+          accessibility: {
+            enum: ["default", "accessible", "system"],
+            description: "`'system'` clears the override and follows `prefers-contrast`."
+          }
+        },
+        required: ["accessibility"]
+      },
+      idempotent: !0,
+      descriptionKey: "ui.agent.headerSettings.actions.setAccessibility",
+      description: "Switch the accessibility preference. Verify with the `accessibility` slot (the stored preference) and `resolvedTheme` (what is actually painted).",
+      examples: [
+        {
+          args: { accessibility: "accessible" },
+          note: "Enable the AAA-accessible profile."
+        }
+      ],
+      invoke: (e, a) => {
+        e.setAccessibility(a.accessibility);
+      }
+    }
+  },
+  domHooks: {
+    root: {
+      attr: "data-component",
+      value: "header-settings",
+      description: "Marks the HeaderSettings wrapper."
+    },
+    instanceId: {
+      attr: "data-component-id",
+      sourceProp: "id",
+      description: "Sourced from the id prop (forwarded via HTMLAttributes)."
+    }
+  }
+};
+function M(e, a) {
+  if (!(typeof window > "u"))
+    try {
+      window.localStorage.setItem(e, a);
+    } catch {
+    }
+}
+function V(e) {
+  if (typeof document > "u") return;
+  const a = document.documentElement;
+  a.lang = e, a.dir = g[e].dir;
+}
+const q = K("ds:inline-flex ds:items-center", {
+  variants: {
+    align: {
+      start: "",
+      end: ""
+    }
+  },
+  defaultVariants: { align: "end" }
+}), z = "ds:w-[var(--popover-size-md)]";
+function U(e) {
+  return Object.prototype.hasOwnProperty.call(g, e);
+}
+function W({ locale: e }) {
+  const { t: a } = T(), o = g[U(e) ? e : "en"], m = (t) => {
+    var r;
+    t.target === t.currentTarget && ((r = t.currentTarget.querySelector("input")) == null || r.focus({ preventScroll: !0 }));
+  }, u = (t) => {
+    const r = t.target;
+    if (r instanceof HTMLInputElement) {
+      if (t.nativeEvent.isComposing) {
+        t.stopPropagation();
+        return;
+      }
+      t.key !== "ArrowLeft" && t.key !== "ArrowRight" || (r.selectionStart !== 0 || r.selectionEnd !== 0) && t.stopPropagation();
+    }
+  };
+  return /* @__PURE__ */ h(n.Sub, { children: [
+    /* @__PURE__ */ s(n.SubTrigger, { "aria-haspopup": "dialog", "data-value": o.code, children: /* @__PURE__ */ h("span", { className: "ds:flex ds:min-w-0 ds:items-center ds:justify-between ds:gap-[var(--spacing-sm)]", children: [
+      /* @__PURE__ */ s("span", { className: "ds:truncate", children: a("navigation.headerSettings.language.label") }),
+      /* @__PURE__ */ s(
+        "span",
+        {
+          lang: o.code,
+          className: "ds:shrink-0 ds:text-[color:var(--muted-foreground)] ds:[[data-highlighted]_&]:text-current",
+          children: o.nativeName
+        }
+      )
+    ] }) }),
+    /* @__PURE__ */ s(
+      n.SubContent,
+      {
+        role: "dialog",
+        "aria-orientation": void 0,
+        className: z,
+        onFocus: m,
+        onKeyDownCapture: u,
+        onEscapeKeyDown: (t) => {
+          t.isComposing && t.preventDefault();
+        },
+        children: /* @__PURE__ */ s(j.SearchList, {})
+      }
+    )
+  ] });
+}
+const B = C(
+  (e, a) => {
+    const {
+      align: o = "end",
+      size: m = "md",
+      disabled: u = !1,
+      className: t,
+      id: r,
+      ...k
+    } = e, { t: c } = T(), l = x(), { locale: y, setLocale: f } = N();
+    H();
+    const b = p(null);
+    E(a, () => b.current, []);
+    const S = I(
+      (i) => {
+        f(i), V(i), M(O, i);
+      },
+      [f]
+    ), w = p(S);
+    w.current = S;
+    const v = p(y);
+    v.current = y;
+    const d = p(l);
+    d.current = l;
+    const A = R(
+      () => ({
+        setLocale: (i) => {
+          Object.prototype.hasOwnProperty.call(g, i) && w.current(i);
+        },
+        setTheme: (i) => d.current.setTheme(i),
+        setAccessibility: (i) => d.current.setAccessibility(i),
+        // Read-back. None of the three preferences is recoverable from
+        // the DOM: `useTheme` resolves preference + OS into one applied
+        // class, so `theme: 'system'` and `theme: 'light'` both paint
+        // `.theme-light`. Without these an agent cannot tell a switch
+        // that landed from one that was dropped.
+        getLocale: () => v.current,
+        getTheme: () => d.current.theme,
+        getAccessibility: () => d.current.accessibility,
+        getResolvedTheme: () => d.current.resolvedTheme
+      }),
+      []
+    );
+    D(F, A, r);
+    const L = l.accessibility === "accessible";
+    return /* @__PURE__ */ s(
+      "div",
+      {
+        ref: b,
+        "data-component": "header-settings",
+        "data-component-id": r,
+        className: q({ align: o, className: t }),
+        ...k,
+        children: /* @__PURE__ */ h(n.Root, { children: [
+          /* @__PURE__ */ s(n.Trigger, { asChild: !0, children: /* @__PURE__ */ s(
+            _,
+            {
+              size: m,
+              disabled: u,
+              icon: /* @__PURE__ */ s(P, { "aria-hidden": !0 }),
+              "aria-label": c("navigation.headerSettings.trigger")
+            }
+          ) }),
+          /* @__PURE__ */ h(n.Content, { align: o, children: [
+            /* @__PURE__ */ s(W, { locale: y }),
+            /* @__PURE__ */ s(n.Separator, {}),
+            /* @__PURE__ */ s(
+              n.ChoiceSub,
+              {
+                label: c("navigation.headerSettings.appearance.label"),
+                value: l.theme,
+                onValueChange: l.setTheme,
+                options: [
+                  {
+                    value: "light",
+                    label: c("navigation.headerSettings.appearance.light")
+                  },
+                  {
+                    value: "dark",
+                    label: c("navigation.headerSettings.appearance.dark")
+                  },
+                  {
+                    value: "system",
+                    label: c("navigation.headerSettings.appearance.system")
+                  }
+                ]
+              }
+            ),
+            /* @__PURE__ */ s(
+              n.SwitchItem,
+              {
+                checked: L,
+                onCheckedChange: (i) => l.setAccessibility(i ? "accessible" : "default"),
+                children: c("navigation.headerSettings.appearance.accessible")
+              }
+            )
+          ] })
+        ] })
+      }
+    );
+  }
+);
+B.displayName = "HeaderSettings";
+export {
+  B as H
+};
+//# sourceMappingURL=header-settings-D0M3WNTS.js.map

package/dist/_chunks/header-settings-D0M3WNTS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-settings-D0M3WNTS.js","sources":["../../src/components/header-settings/header-settings.agent.ts","../../src/components/header-settings/header-settings.tsx"],"sourcesContent":["/* -------------------------------------------------------------------- */\n/* Agent adapter — HeaderSettings.                                        */\n/* -------------------------------------------------------------------- */\n\nimport type { AgentAdapter } from '../../agent/types';\nimport type { HeaderSettingsHandle } from './header-settings';\n\nexport const headerSettingsAgent: AgentAdapter<HeaderSettingsHandle> = {\n  id: 'header-settings',\n  // Each setter persists a single preference value (locale / theme /\n  // accessibility) — `set_value` semantics, not an ephemeral view switch.\n  capabilities: ['set_value'],\n  // Read-back for all three setters. None of these preferences is\n  // recoverable from the DOM — `useTheme` resolves preference + OS into\n  // a single applied class, so `theme: 'system'` and `theme: 'light'`\n  // both paint `.theme-light` — and `set_locale` swallows unknown tags.\n  // Without these slots an agent cannot distinguish \"switched to\n  // Italian\" from \"the tag was dropped on the floor\". All four are UI\n  // preferences: no PHI, no patient-identifiable data (§7).\n  state: {\n    locale: {\n      type: 'string',\n      descriptionKey: 'ui.agent.headerSettings.state.locale',\n      description:\n        'Active IETF language tag (e.g. \"en\", \"it\", \"ar\"). Read after `set_locale` to confirm the switch landed — an unknown tag is silently dropped and leaves this unchanged.',\n      read: (handle) => handle.getLocale(),\n    },\n    theme: {\n      type: \"'light' | 'dark' | 'system'\",\n      descriptionKey: 'ui.agent.headerSettings.state.theme',\n      description:\n        \"Stored base-theme preference. `'system'` means no override is set and the OS decides — read `resolvedTheme` for what is actually painted.\",\n      read: (handle) => handle.getTheme(),\n    },\n    accessibility: {\n      type: \"'default' | 'accessible' | 'system'\",\n      descriptionKey: 'ui.agent.headerSettings.state.accessibility',\n      description:\n        \"Stored AAA-contrast preference. `'system'` means no override is set and `prefers-contrast` decides.\",\n      read: (handle) => handle.getAccessibility(),\n    },\n    resolvedTheme: {\n      type: \"'light' | 'dark' | 'light-accessible' | 'dark-accessible'\",\n      descriptionKey: 'ui.agent.headerSettings.state.resolvedTheme',\n      description:\n        'The theme actually applied to the document once preference and OS signals resolve. This is what makes a `set_theme(\"system\")` or `set_accessibility(\"system\")` write verifiable.',\n      read: (handle) => handle.getResolvedTheme(),\n    },\n  },\n  actions: {\n    set_locale: {\n      safety: 'write',\n      argsType: '{ locale: string }',\n      argsSchema: {\n        type: 'object',\n        properties: {\n          locale: {\n            type: 'string',\n            description:\n              'IETF language tag (e.g. \"en\", \"it\", \"ar\"). Unknown tags are silently dropped.',\n          },\n        },\n        required: ['locale'],\n      },\n      idempotent: true,\n      descriptionKey: 'ui.agent.headerSettings.actions.setLocale',\n      description:\n        'Switch the active locale to the given IETF tag. Unknown tags are silently dropped — read the `locale` state slot afterwards to confirm.',\n      errors: [\n        'Silently ignored when the tag names a locale the kit ships no bundle for — `locale` is unchanged.',\n      ],\n      examples: [{ args: { locale: 'it' }, note: 'Switch to Italian.' }],\n      invoke: (handle, args: { locale: string }) => {\n        // Validation happens inside the handle so the agent surface\n        // accepts arbitrary tags and silently drops unknown ones.\n        handle.setLocale(args.locale);\n      },\n    },\n    set_theme: {\n      safety: 'write',\n      argsType: '{ theme: \"light\" | \"dark\" | \"system\" }',\n      argsSchema: {\n        type: 'object',\n        properties: { theme: { enum: ['light', 'dark', 'system'] } },\n        required: ['theme'],\n      },\n      idempotent: true,\n      descriptionKey: 'ui.agent.headerSettings.actions.setTheme',\n      description:\n        'Switch the theme preference. Verify with the `theme` slot (the stored preference) and `resolvedTheme` (what is actually painted).',\n      examples: [\n        { args: { theme: 'dark' }, note: 'Switch to the dark theme.' },\n      ],\n      invoke: (handle, args: { theme: 'light' | 'dark' | 'system' }) => {\n        handle.setTheme(args.theme);\n      },\n    },\n    set_accessibility: {\n      safety: 'write',\n      argsType: '{ accessibility: \"default\" | \"accessible\" | \"system\" }',\n      argsSchema: {\n        type: 'object',\n        properties: {\n          accessibility: {\n            enum: ['default', 'accessible', 'system'],\n            description:\n              \"`'system'` clears the override and follows `prefers-contrast`.\",\n          },\n        },\n        required: ['accessibility'],\n      },\n      idempotent: true,\n      descriptionKey: 'ui.agent.headerSettings.actions.setAccessibility',\n      description:\n        'Switch the accessibility preference. Verify with the `accessibility` slot (the stored preference) and `resolvedTheme` (what is actually painted).',\n      examples: [\n        {\n          args: { accessibility: 'accessible' },\n          note: 'Enable the AAA-accessible profile.',\n        },\n      ],\n      invoke: (\n        handle,\n        args: { accessibility: 'default' | 'accessible' | 'system' },\n      ) => {\n        handle.setAccessibility(args.accessibility);\n      },\n    },\n  },\n  domHooks: {\n    root: {\n      attr: 'data-component',\n      value: 'header-settings',\n      description: 'Marks the HeaderSettings wrapper.',\n    },\n    instanceId: {\n      attr: 'data-component-id',\n      sourceProp: 'id',\n      description: 'Sourced from the id prop (forwarded via HTMLAttributes).',\n    },\n  },\n};\n","import {\n  forwardRef,\n  useCallback,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  type FocusEvent,\n  type HTMLAttributes,\n  type KeyboardEvent,\n} from 'react';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { useTranslation } from 'react-i18next';\nimport { Settings } from 'lucide-react';\nimport { IconButton } from '../button/icon-button';\nimport { DropdownMenu } from '../dropdown-menu/dropdown-menu';\nimport {\n  LocalePicker,\n  LOCALE_STORAGE_KEY,\n  useInitialLocale,\n} from '../locale-picker/locale-picker';\nimport {\n  useTheme,\n  type AccessibilityPreference,\n  type ResolvedTheme,\n  type ThemePreference,\n} from '../../hooks';\nimport { useLocale } from '../../hooks/use-locale';\nimport { LOCALE_META, type Locale } from '../../i18n/locale-meta';\nimport { useAgentRegistration } from '../../agent/registry';\nimport { headerSettingsAgent } from './header-settings.agent';\n\nfunction safeWriteStorage(key: string, value: string): void {\n  if (typeof window === 'undefined') return;\n  try {\n    window.localStorage.setItem(key, value);\n  } catch {\n    /* Storage can throw in private mode — silent-fail per use-theme.ts. */\n  }\n}\n\nfunction applyDocumentAttrs(locale: Locale): void {\n  if (typeof document === 'undefined') return;\n  const root = document.documentElement;\n  root.lang = locale;\n  root.dir = LOCALE_META[locale].dir;\n}\n\n/* ------------------------------------------------------------------ */\n/* CVA                                                                 */\n/* ------------------------------------------------------------------ */\n\nconst wrapperVariants = cva('ds:inline-flex ds:items-center', {\n  variants: {\n    align: {\n      start: '',\n      end: '',\n    },\n  },\n  defaultVariants: { align: 'end' },\n});\n\n// The language flyout hosts the searchable locale list, so it takes a\n// popover width rather than the menu's minimum.\nconst languageFlyoutClasses = 'ds:w-[var(--popover-size-md)]';\n\nfunction isLocale(tag: string): tag is Locale {\n  return Object.prototype.hasOwnProperty.call(LOCALE_META, tag);\n}\n\n/* ------------------------------------------------------------------ */\n/* LanguageSub                                                         */\n/*                                                                     */\n/* One menu row naming the setting and showing the current language    */\n/* (\"Language · English ›\"), laid out like DropdownMenu.ChoiceSub. It  */\n/* opens a flyout beside the menu holding LocalePicker.SearchList, so  */\n/* the 18 locales stay searchable. The flyout is a dialog, not a menu: */\n/* it holds a search combobox and a listbox, which a menu may not own. */\n/* ------------------------------------------------------------------ */\n\nfunction LanguageSub({ locale }: { locale: string }) {\n  const { t } = useTranslation();\n  const current = LOCALE_META[isLocale(locale) ? locale : 'en'];\n\n  // Radix focuses the flyout itself when a keyboard user opens it. Hand\n  // that focus on to the search field so typing filters at once.\n  const handleFocus = (event: FocusEvent<HTMLDivElement>) => {\n    if (event.target !== event.currentTarget) return;\n    event.currentTarget\n      .querySelector<HTMLInputElement>('input')\n      ?.focus({ preventScroll: true });\n  };\n\n  // The flyout closes on the \"back\" arrow (ArrowLeft, or ArrowRight in\n  // RTL). Inside the search field that key moves the caret instead,\n  // unless the caret is already at the start of the field. Capture\n  // phase, so Radix's own handler on the flyout never sees the key.\n  const handleKeyDownCapture = (event: KeyboardEvent<HTMLDivElement>) => {\n    const target = event.target;\n    if (!(target instanceof HTMLInputElement)) return;\n    // Keys pressed while an IME is composing (Japanese, Chinese) belong to\n    // the composition, never to the menu.\n    if (event.nativeEvent.isComposing) {\n      event.stopPropagation();\n      return;\n    }\n    if (event.key !== 'ArrowLeft' && event.key !== 'ArrowRight') return;\n    if (target.selectionStart !== 0 || target.selectionEnd !== 0) {\n      event.stopPropagation();\n    }\n  };\n\n  return (\n    <DropdownMenu.Sub>\n      <DropdownMenu.SubTrigger aria-haspopup=\"dialog\" data-value={current.code}>\n        <span className=\"ds:flex ds:min-w-0 ds:items-center ds:justify-between ds:gap-[var(--spacing-sm)]\">\n          <span className=\"ds:truncate\">\n            {t('navigation.headerSettings.language.label')}\n          </span>\n          <span\n            lang={current.code}\n            className=\"ds:shrink-0 ds:text-[color:var(--muted-foreground)] ds:[[data-highlighted]_&]:text-current\"\n          >\n            {current.nativeName}\n          </span>\n        </span>\n      </DropdownMenu.SubTrigger>\n      {/* Radix renders a `menu`; override to `dialog` and drop the\n          menu-only `aria-orientation`, which a dialog may not carry. */}\n      <DropdownMenu.SubContent\n        role=\"dialog\"\n        aria-orientation={undefined}\n        className={languageFlyoutClasses}\n        onFocus={handleFocus}\n        onKeyDownCapture={handleKeyDownCapture}\n        // Escape that cancels an IME conversion must not close the menu.\n        onEscapeKeyDown={(escapeEvent) => {\n          if (escapeEvent.isComposing) escapeEvent.preventDefault();\n        }}\n      >\n        <LocalePicker.SearchList />\n      </DropdownMenu.SubContent>\n    </DropdownMenu.Sub>\n  );\n}\n\n/* ------------------------------------------------------------------ */\n/* Public types                                                        */\n/* ------------------------------------------------------------------ */\n\nexport interface HeaderSettingsProps\n  extends\n    Omit<HTMLAttributes<HTMLDivElement>, 'onChange'>,\n    VariantProps<typeof wrapperVariants> {\n  /** Anchor side for the dropdown. Defaults to `end` (matches LTR + RTL). */\n  align?: 'start' | 'end';\n  /**\n   * Size of the cog trigger only. Forwards to the underlying\n   * `IconButton`. Defaults to `md` to preserve the existing visual.\n   * Use `sm` when composing alongside other `<Button size=\"sm\">`\n   * actions in a header row — keeps the visual rhythm consistent.\n   *\n   * The menu itself (language, appearance and accessible-mode rows)\n   * stays at kit defaults regardless — this prop only sizes the\n   * trigger.\n   */\n  size?: 'sm' | 'md' | 'lg';\n  /** Disable the trigger entirely. */\n  disabled?: boolean;\n}\n\nexport interface HeaderSettingsHandle {\n  /**\n   * Switch the active locale. Widened to `string` (vs. `Locale`) so\n   * agent surfaces with untyped inputs can call through without\n   * extra casting — invalid tags no-op silently.\n   */\n  setLocale: (next: string) => void;\n  setTheme: (next: ThemePreference) => void;\n  setAccessibility: (next: AccessibilityPreference) => void;\n  /* ---- read-back for the three setters above -------------------- */\n  /** Active IETF language tag, as i18next resolved it. */\n  getLocale: () => string;\n  /** Stored base-theme preference (`'system'` when no override is set). */\n  getTheme: () => ThemePreference;\n  /** Stored AAA-contrast preference (`'system'` when no override is set). */\n  getAccessibility: () => AccessibilityPreference;\n  /**\n   * The theme actually painted once preference + OS signals resolve.\n   * `theme: 'system'` and `theme: 'light'` both render `.theme-light`,\n   * so this is what makes a `setTheme('system')` write verifiable.\n   */\n  getResolvedTheme: () => ResolvedTheme;\n}\n\n/* ------------------------------------------------------------------ */\n/* HeaderSettings                                                      */\n/*                                                                     */\n/* Single button → single DropdownMenu surface, laid out as a View     */\n/* menu: a Language row whose flyout holds the searchable locale list, */\n/* an Appearance ChoiceSub (light / dark / system) and an Accessible   */\n/* mode SwitchItem. Every row reads and writes the same hooks          */\n/* (`useLocale`, `useTheme`) as the standalone components, so there is */\n/* no state duplication.                                               */\n/* ------------------------------------------------------------------ */\n\nexport const HeaderSettings = forwardRef<HTMLDivElement, HeaderSettingsProps>(\n  (props, ref) => {\n    const {\n      align = 'end',\n      size = 'md',\n      disabled = false,\n      className,\n      id,\n      ...rest\n    } = props as HeaderSettingsProps & { id?: string };\n\n    const { t } = useTranslation();\n    const theme = useTheme();\n    const { locale, setLocale: setLocaleI18n } = useLocale();\n    // The language search only mounts with its flyout, so apply the saved\n    // (or browser) language here, on mount.\n    useInitialLocale();\n\n    const forwardedRef = useRef<HTMLDivElement | null>(null);\n    useImperativeHandle(ref, () => forwardedRef.current as HTMLDivElement, []);\n\n    // Same side-effect chain as LocalePicker's internal helper:\n    //   i18next.changeLanguage → document.dir/lang → persist.\n    // Inlined here (rather than exported from locale-picker) because\n    // it's three small calls; the LocalePicker.SearchList component\n    // continues to own its own copy for inline use, and both apply\n    // the same persistence key (`alfadocs-ui.locale`) so a write from\n    // either path is visible to the other on next mount.\n    const setLocaleWithPersistence = useCallback(\n      (next: Locale) => {\n        void setLocaleI18n(next);\n        applyDocumentAttrs(next);\n        safeWriteStorage(LOCALE_STORAGE_KEY, next);\n      },\n      [setLocaleI18n],\n    );\n    const setLocaleRef = useRef(setLocaleWithPersistence);\n    setLocaleRef.current = setLocaleWithPersistence;\n    // Assigned during render (not in an effect) so an agent reading the\n    // slot immediately after `set_locale` sees the settled value rather\n    // than the pre-commit one.\n    const localeRef = useRef(locale);\n    localeRef.current = locale;\n\n    const themeRef = useRef(theme);\n    themeRef.current = theme;\n    const agentHandle = useMemo<HeaderSettingsHandle>(\n      () => ({\n        setLocale: (next: string) => {\n          // Mirrors LocalePicker's gating — silently drop unknown tags\n          // rather than crash mid-cascade. `LOCALES_WITH_BUNDLES` is\n          // re-imported via the LOCALE_META keys so this file doesn't\n          // need the resources module on the build-agent-catalog path.\n          if (Object.prototype.hasOwnProperty.call(LOCALE_META, next)) {\n            setLocaleRef.current(next as Locale);\n          }\n        },\n        setTheme: (next) => themeRef.current.setTheme(next),\n        setAccessibility: (next) => themeRef.current.setAccessibility(next),\n        // Read-back. None of the three preferences is recoverable from\n        // the DOM: `useTheme` resolves preference + OS into one applied\n        // class, so `theme: 'system'` and `theme: 'light'` both paint\n        // `.theme-light`. Without these an agent cannot tell a switch\n        // that landed from one that was dropped.\n        getLocale: () => localeRef.current,\n        getTheme: () => themeRef.current.theme,\n        getAccessibility: () => themeRef.current.accessibility,\n        getResolvedTheme: () => themeRef.current.resolvedTheme,\n      }),\n      [],\n    );\n    useAgentRegistration(headerSettingsAgent, agentHandle, id);\n\n    const accessibleChecked = theme.accessibility === 'accessible';\n\n    return (\n      <div\n        ref={forwardedRef}\n        data-component=\"header-settings\"\n        data-component-id={id}\n        className={wrapperVariants({ align, className })}\n        {...rest}\n      >\n        <DropdownMenu.Root>\n          <DropdownMenu.Trigger asChild>\n            <IconButton\n              size={size}\n              disabled={disabled}\n              icon={<Settings aria-hidden />}\n              aria-label={t('navigation.headerSettings.trigger')}\n            />\n          </DropdownMenu.Trigger>\n          <DropdownMenu.Content align={align}>\n            <LanguageSub locale={locale} />\n            <DropdownMenu.Separator />\n            <DropdownMenu.ChoiceSub\n              label={t('navigation.headerSettings.appearance.label')}\n              value={theme.theme}\n              onValueChange={theme.setTheme}\n              options={[\n                {\n                  value: 'light',\n                  label: t('navigation.headerSettings.appearance.light'),\n                },\n                {\n                  value: 'dark',\n                  label: t('navigation.headerSettings.appearance.dark'),\n                },\n                {\n                  value: 'system',\n                  label: t('navigation.headerSettings.appearance.system'),\n                },\n              ]}\n            />\n            {/* Writes through useTheme, so the document gets the\n                `theme-accessible` class at once (including the Lexend\n                swap for Latin scripts, see src/tokens/index.css). */}\n            <DropdownMenu.SwitchItem\n              checked={accessibleChecked}\n              onCheckedChange={(next) =>\n                theme.setAccessibility(next ? 'accessible' : 'default')\n              }\n            >\n              {t('navigation.headerSettings.appearance.accessible')}\n            </DropdownMenu.SwitchItem>\n          </DropdownMenu.Content>\n        </DropdownMenu.Root>\n      </div>\n    );\n  },\n);\n\nHeaderSettings.displayName = 'HeaderSettings';\n"],"names":["headerSettingsAgent","handle","args","safeWriteStorage","key","value","applyDocumentAttrs","locale","root","LOCALE_META","wrapperVariants","cva","languageFlyoutClasses","isLocale","tag","LanguageSub","t","useTranslation","current","handleFocus","event","_a","handleKeyDownCapture","target","jsxs","DropdownMenu","jsx","escapeEvent","LocalePicker","HeaderSettings","forwardRef","props","ref","align","size","disabled","className","id","rest","theme","useTheme","setLocaleI18n","useLocale","useInitialLocale","forwardedRef","useRef","useImperativeHandle","setLocaleWithPersistence","useCallback","next","LOCALE_STORAGE_KEY","setLocaleRef","localeRef","themeRef","agentHandle","useMemo","useAgentRegistration","accessibleChecked","IconButton","Settings"],"mappings":";;;;;;;;;;;AAOO,MAAMA,IAA0D;AAAA,EACrE,IAAI;AAAA;AAAA;AAAA,EAGJ,cAAc,CAAC,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ1B,OAAO;AAAA,IACL,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,gBAAgB;AAAA,MAChB,aACE;AAAA,MACF,MAAM,CAACC,MAAWA,EAAO,UAAA;AAAA,IAAU;AAAA,IAErC,OAAO;AAAA,MACL,MAAM;AAAA,MACN,gBAAgB;AAAA,MAChB,aACE;AAAA,MACF,MAAM,CAACA,MAAWA,EAAO,SAAA;AAAA,IAAS;AAAA,IAEpC,eAAe;AAAA,MACb,MAAM;AAAA,MACN,gBAAgB;AAAA,MAChB,aACE;AAAA,MACF,MAAM,CAACA,MAAWA,EAAO,iBAAA;AAAA,IAAiB;AAAA,IAE5C,eAAe;AAAA,MACb,MAAM;AAAA,MACN,gBAAgB;AAAA,MAChB,aACE;AAAA,MACF,MAAM,CAACA,MAAWA,EAAO,iBAAA;AAAA,IAAiB;AAAA,EAC5C;AAAA,EAEF,SAAS;AAAA,IACP,YAAY;AAAA,MACV,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,YAAY;AAAA,QACV,MAAM;AAAA,QACN,YAAY;AAAA,UACV,QAAQ;AAAA,YACN,MAAM;AAAA,YACN,aACE;AAAA,UAAA;AAAA,QACJ;AAAA,QAEF,UAAU,CAAC,QAAQ;AAAA,MAAA;AAAA,MAErB,YAAY;AAAA,MACZ,gBAAgB;AAAA,MAChB,aACE;AAAA,MACF,QAAQ;AAAA,QACN;AAAA,MAAA;AAAA,MAEF,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,QAAQ,MAAM,sBAAsB;AAAA,MACjE,QAAQ,CAACA,GAAQC,MAA6B;AAG5C,QAAAD,EAAO,UAAUC,EAAK,MAAM;AAAA,MAC9B;AAAA,IAAA;AAAA,IAEF,WAAW;AAAA,MACT,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,YAAY;AAAA,QACV,MAAM;AAAA,QACN,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,QAAQ,QAAQ,IAAE;AAAA,QACzD,UAAU,CAAC,OAAO;AAAA,MAAA;AAAA,MAEpB,YAAY;AAAA,MACZ,gBAAgB;AAAA,MAChB,aACE;AAAA,MACF,UAAU;AAAA,QACR,EAAE,MAAM,EAAE,OAAO,OAAA,GAAU,MAAM,4BAAA;AAAA,MAA4B;AAAA,MAE/D,QAAQ,CAACD,GAAQC,MAAiD;AAChE,QAAAD,EAAO,SAASC,EAAK,KAAK;AAAA,MAC5B;AAAA,IAAA;AAAA,IAEF,mBAAmB;AAAA,MACjB,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,YAAY;AAAA,QACV,MAAM;AAAA,QACN,YAAY;AAAA,UACV,eAAe;AAAA,YACb,MAAM,CAAC,WAAW,cAAc,QAAQ;AAAA,YACxC,aACE;AAAA,UAAA;AAAA,QACJ;AAAA,QAEF,UAAU,CAAC,eAAe;AAAA,MAAA;AAAA,MAE5B,YAAY;AAAA,MACZ,gBAAgB;AAAA,MAChB,aACE;AAAA,MACF,UAAU;AAAA,QACR;AAAA,UACE,MAAM,EAAE,eAAe,aAAA;AAAA,UACvB,MAAM;AAAA,QAAA;AAAA,MACR;AAAA,MAEF,QAAQ,CACND,GACAC,MACG;AACH,QAAAD,EAAO,iBAAiBC,EAAK,aAAa;AAAA,MAC5C;AAAA,IAAA;AAAA,EACF;AAAA,EAEF,UAAU;AAAA,IACR,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IAAA;AAAA,IAEf,YAAY;AAAA,MACV,MAAM;AAAA,MACN,YAAY;AAAA,MACZ,aAAa;AAAA,IAAA;AAAA,EACf;AAEJ;AC9GA,SAASC,EAAiBC,GAAaC,GAAqB;AAC1D,MAAI,SAAO,SAAW;AACtB,QAAI;AACF,aAAO,aAAa,QAAQD,GAAKC,CAAK;AAAA,IACxC,QAAQ;AAAA,IAER;AACF;AAEA,SAASC,EAAmBC,GAAsB;AAChD,MAAI,OAAO,WAAa,IAAa;AACrC,QAAMC,IAAO,SAAS;AACtB,EAAAA,EAAK,OAAOD,GACZC,EAAK,MAAMC,EAAYF,CAAM,EAAE;AACjC;AAMA,MAAMG,IAAkBC,EAAI,kCAAkC;AAAA,EAC5D,UAAU;AAAA,IACR,OAAO;AAAA,MACL,OAAO;AAAA,MACP,KAAK;AAAA,IAAA;AAAA,EACP;AAAA,EAEF,iBAAiB,EAAE,OAAO,MAAA;AAC5B,CAAC,GAIKC,IAAwB;AAE9B,SAASC,EAASC,GAA4B;AAC5C,SAAO,OAAO,UAAU,eAAe,KAAKL,GAAaK,CAAG;AAC9D;AAYA,SAASC,EAAY,EAAE,QAAAR,KAA8B;AACnD,QAAM,EAAE,GAAAS,EAAA,IAAMC,EAAA,GACRC,IAAUT,EAAYI,EAASN,CAAM,IAAIA,IAAS,IAAI,GAItDY,IAAc,CAACC,MAAsC;;AACzD,IAAIA,EAAM,WAAWA,EAAM,mBAC3BC,IAAAD,EAAM,cACH,cAAgC,OAAO,MAD1C,QAAAC,EAEI,MAAM,EAAE,eAAe;EAC7B,GAMMC,IAAuB,CAACF,MAAyC;AACrE,UAAMG,IAASH,EAAM;AACrB,QAAMG,aAAkB,kBAGxB;AAAA,UAAIH,EAAM,YAAY,aAAa;AACjC,QAAAA,EAAM,gBAAA;AACN;AAAA,MACF;AACA,MAAIA,EAAM,QAAQ,eAAeA,EAAM,QAAQ,iBAC3CG,EAAO,mBAAmB,KAAKA,EAAO,iBAAiB,MACzDH,EAAM,gBAAA;AAAA;AAAA,EAEV;AAEA,SACE,gBAAAI,EAACC,EAAa,KAAb,EACC,UAAA;AAAA,IAAA,gBAAAC,EAACD,EAAa,YAAb,EAAwB,iBAAc,UAAS,cAAYP,EAAQ,MAClE,UAAA,gBAAAM,EAAC,QAAA,EAAK,WAAU,oFACd,UAAA;AAAA,MAAA,gBAAAE,EAAC,QAAA,EAAK,WAAU,eACb,UAAAV,EAAE,0CAA0C,GAC/C;AAAA,MACA,gBAAAU;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,MAAMR,EAAQ;AAAA,UACd,WAAU;AAAA,UAET,UAAAA,EAAQ;AAAA,QAAA;AAAA,MAAA;AAAA,IACX,EAAA,CACF,EAAA,CACF;AAAA,IAGA,gBAAAQ;AAAA,MAACD,EAAa;AAAA,MAAb;AAAA,QACC,MAAK;AAAA,QACL,oBAAkB;AAAA,QAClB,WAAWb;AAAA,QACX,SAASO;AAAA,QACT,kBAAkBG;AAAA,QAElB,iBAAiB,CAACK,MAAgB;AAChC,UAAIA,EAAY,eAAaA,EAAY,eAAA;AAAA,QAC3C;AAAA,QAEA,UAAA,gBAAAD,EAACE,EAAa,YAAb,CAAA,CAAwB;AAAA,MAAA;AAAA,IAAA;AAAA,EAC3B,GACF;AAEJ;AA8DO,MAAMC,IAAiBC;AAAA,EAC5B,CAACC,GAAOC,MAAQ;AACd,UAAM;AAAA,MACJ,OAAAC,IAAQ;AAAA,MACR,MAAAC,IAAO;AAAA,MACP,UAAAC,IAAW;AAAA,MACX,WAAAC;AAAA,MACA,IAAAC;AAAA,MACA,GAAGC;AAAA,IAAA,IACDP,GAEE,EAAE,GAAAf,EAAA,IAAMC,EAAA,GACRsB,IAAQC,EAAA,GACR,EAAE,QAAAjC,GAAQ,WAAWkC,EAAA,IAAkBC,EAAA;AAG7C,IAAAC,EAAA;AAEA,UAAMC,IAAeC,EAA8B,IAAI;AACvD,IAAAC,EAAoBd,GAAK,MAAMY,EAAa,SAA2B,CAAA,CAAE;AASzE,UAAMG,IAA2BC;AAAA,MAC/B,CAACC,MAAiB;AAChB,QAAKR,EAAcQ,CAAI,GACvB3C,EAAmB2C,CAAI,GACvB9C,EAAiB+C,GAAoBD,CAAI;AAAA,MAC3C;AAAA,MACA,CAACR,CAAa;AAAA,IAAA,GAEVU,IAAeN,EAAOE,CAAwB;AACpD,IAAAI,EAAa,UAAUJ;AAIvB,UAAMK,IAAYP,EAAOtC,CAAM;AAC/B,IAAA6C,EAAU,UAAU7C;AAEpB,UAAM8C,IAAWR,EAAON,CAAK;AAC7B,IAAAc,EAAS,UAAUd;AACnB,UAAMe,IAAcC;AAAA,MAClB,OAAO;AAAA,QACL,WAAW,CAACN,MAAiB;AAK3B,UAAI,OAAO,UAAU,eAAe,KAAKxC,GAAawC,CAAI,KACxDE,EAAa,QAAQF,CAAc;AAAA,QAEvC;AAAA,QACA,UAAU,CAACA,MAASI,EAAS,QAAQ,SAASJ,CAAI;AAAA,QAClD,kBAAkB,CAACA,MAASI,EAAS,QAAQ,iBAAiBJ,CAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAMlE,WAAW,MAAMG,EAAU;AAAA,QAC3B,UAAU,MAAMC,EAAS,QAAQ;AAAA,QACjC,kBAAkB,MAAMA,EAAS,QAAQ;AAAA,QACzC,kBAAkB,MAAMA,EAAS,QAAQ;AAAA,MAAA;AAAA,MAE3C,CAAA;AAAA,IAAC;AAEH,IAAAG,EAAqBxD,GAAqBsD,GAAajB,CAAE;AAEzD,UAAMoB,IAAoBlB,EAAM,kBAAkB;AAElD,WACE,gBAAAb;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,KAAKkB;AAAA,QACL,kBAAe;AAAA,QACf,qBAAmBP;AAAA,QACnB,WAAW3B,EAAgB,EAAE,OAAAuB,GAAO,WAAAG,GAAW;AAAA,QAC9C,GAAGE;AAAA,QAEJ,UAAA,gBAAAd,EAACC,EAAa,MAAb,EACC,UAAA;AAAA,UAAA,gBAAAC,EAACD,EAAa,SAAb,EAAqB,SAAO,IAC3B,UAAA,gBAAAC;AAAA,YAACgC;AAAA,YAAA;AAAA,cACC,MAAAxB;AAAA,cACA,UAAAC;AAAA,cACA,MAAM,gBAAAT,EAACiC,GAAA,EAAS,eAAW,GAAA,CAAC;AAAA,cAC5B,cAAY3C,EAAE,mCAAmC;AAAA,YAAA;AAAA,UAAA,GAErD;AAAA,UACA,gBAAAQ,EAACC,EAAa,SAAb,EAAqB,OAAAQ,GACpB,UAAA;AAAA,YAAA,gBAAAP,EAACX,KAAY,QAAAR,GAAgB;AAAA,YAC7B,gBAAAmB,EAACD,EAAa,WAAb,EAAuB;AAAA,YACxB,gBAAAC;AAAA,cAACD,EAAa;AAAA,cAAb;AAAA,gBACC,OAAOT,EAAE,4CAA4C;AAAA,gBACrD,OAAOuB,EAAM;AAAA,gBACb,eAAeA,EAAM;AAAA,gBACrB,SAAS;AAAA,kBACP;AAAA,oBACE,OAAO;AAAA,oBACP,OAAOvB,EAAE,4CAA4C;AAAA,kBAAA;AAAA,kBAEvD;AAAA,oBACE,OAAO;AAAA,oBACP,OAAOA,EAAE,2CAA2C;AAAA,kBAAA;AAAA,kBAEtD;AAAA,oBACE,OAAO;AAAA,oBACP,OAAOA,EAAE,6CAA6C;AAAA,kBAAA;AAAA,gBACxD;AAAA,cACF;AAAA,YAAA;AAAA,YAKF,gBAAAU;AAAA,cAACD,EAAa;AAAA,cAAb;AAAA,gBACC,SAASgC;AAAA,gBACT,iBAAiB,CAACR,MAChBV,EAAM,iBAAiBU,IAAO,eAAe,SAAS;AAAA,gBAGvD,YAAE,iDAAiD;AAAA,cAAA;AAAA,YAAA;AAAA,UACtD,EAAA,CACF;AAAA,QAAA,EAAA,CACF;AAAA,MAAA;AAAA,IAAA;AAAA,EAGN;AACF;AAEApB,EAAe,cAAc;"}

package/dist/_chunks/{help-me-write-templates-DQtT1qs_.js → help-me-write-templates-CYAKuXZ3.js}

@@ -3,11 +3,11 @@ import { useState as b, useEffect as U, useId as ee, useRef as V, useCallback as
 import { useTranslation as $ } from "react-i18next";
 import { c as ce } from "./index-D2ZczOXr.js";
 import { A as O } from "./alert-CiQ5Pa3Q.js";
-import { B as N } from "./button-18oBsI3n.js";
-import { I as B } from "./icon-button-CY7GU_Se.js";
+import { B as N } from "./button-CYPx2xFq.js";
+import { I as B } from "./icon-button-JAXAkqWC.js";
 import { D as x } from "./dialog-BJiLqhx6.js";
-import { E as de } from "./editor-overlay-BDiBvQmL.js";
-import { E as me } from "./empty-state-DTBZ1ENT.js";
+import { E as de } from "./editor-overlay-DsA7vR5C.js";
+import { E as me } from "./empty-state-Ck1wVWdN.js";
 import { F as Z } from "./form-field-CahJzTxp.js";
 import { P as pe } from "./progress-CK8otcQ-.js";
 import { S as ue } from "./spinner-hbwuKwMf.js";
@@ -744,4 +744,4 @@ export {
   Le as c,
   mr as u
 };
-//# sourceMappingURL=help-me-write-templates-DQtT1qs_.js.map
+//# sourceMappingURL=help-me-write-templates-CYAKuXZ3.js.map