@alfadocs/ui-kit 0.37.0 → 0.39.0

package/dist/components/fiscal-code-input/calculate-codice-fiscale.d.ts

@@ -0,0 +1,24 @@
+/** Identity inputs needed to derive the (non-omocodic) codice fiscale. */
+export interface CodiceFiscaleInput {
+    /** Family name (cognome). Diacritics are folded; non-letters ignored. */
+    surname: string;
+    /** Given name (nome). Diacritics are folded; non-letters ignored. */
+    name: string;
+    /** Date of birth — a `Date` or an ISO `YYYY-MM-DD` (or full ISO) string. */
+    birthDate: Date | string;
+    /** Biological sex as recorded for the fiscal code: 'M' or 'F'. */
+    sex: 'M' | 'F';
+    /** 4-character cadastral / Belfiore code of the birthplace (e.g. H501). */
+    belfioreCode: string;
+}
+/**
+ * Compute the full 16-character (non-omocodic) codice fiscale from a
+ * person's identity data. The caller supplies the 4-char Belfiore code of
+ * the birthplace (the kit does not bundle the municipality table).
+ *
+ * Throws if `birthDate` is unparseable or `belfioreCode` is not 4
+ * `[A-Z][0-9]{3}`-shaped characters — i.e. a letter followed by 3 digits,
+ * the canonical Belfiore shape.
+ */
+export declare function calculateCodiceFiscale(input: CodiceFiscaleInput): string;
+//# sourceMappingURL=calculate-codice-fiscale.d.ts.map

package/dist/components/fiscal-code-input/fiscal-code-input.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { FiscalCodeInputHandle } from './fiscal-code-input';
+export declare const fiscalCodeInputAgent: AgentAdapter<FiscalCodeInputHandle>;
+//# sourceMappingURL=fiscal-code-input.agent.d.ts.map

package/dist/components/fiscal-code-input/fiscal-code-input.d.ts

@@ -0,0 +1,61 @@
+import { type FiscalCodeReason } from './is-valid-codice-fiscale';
+import { type CodiceFiscaleInput } from './calculate-codice-fiscale';
+/** Agent-readiness curated handle for FiscalCodeInput. */
+export interface FiscalCodeInputHandle {
+    getValue: () => string;
+    setValue: (value: string) => void;
+    clear: () => void;
+    focus: () => void;
+    isValid: () => boolean;
+}
+/** Structured payload emitted on every keystroke alongside the raw value. */
+export interface FiscalCodeChangeMeta {
+    /** Structurally sound AND control character matches (always 16 chars). */
+    isValid: boolean;
+    /** Whether all 16 characters are present (regardless of validity). */
+    isComplete: boolean;
+    /** Why the value is (in)valid — drives consumer messaging. */
+    reason: FiscalCodeReason;
+}
+export interface FiscalCodeInputProps {
+    /** Controlled value (raw, uppercased, no spaces). Pair with onChange. */
+    value?: string;
+    /** Uncontrolled initial value. Normalised on mount. */
+    defaultValue?: string;
+    /** Fires on every keystroke with the normalised raw string + meta. */
+    onChange?: (raw: string, meta: FiscalCodeChangeMeta) => void;
+    size?: 'sm' | 'md' | 'lg';
+    tone?: 'default' | 'error';
+    /** When the invalid tone + error string surface. Never marks partial input invalid. */
+    validateOn?: 'change' | 'blur' | 'submit';
+    /** Controlled escape hatch to force the invalid state (e.g. server rejection). */
+    showError?: boolean;
+    /** Overrides the kit's default i18n error string. */
+    errorMessage?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    required?: boolean;
+    placeholder?: string;
+    /** Render the "16 characters" caption when NOT inside a FormField. */
+    showFormatHint?: boolean;
+    /**
+     * OPT-IN. When the consuming form already holds the person's identity
+     * data, supply it here to render an inline "calculate" affordance: a
+     * small icon button that derives the codice fiscale and fills the field.
+     * The caller supplies the 4-char `belfioreCode` of the birthplace — the
+     * kit does not bundle the municipality lookup table. Omit to render
+     * nothing extra (no behavioural change). Ignored when readOnly/disabled.
+     */
+    calculateFrom?: CodiceFiscaleInput;
+    id?: string;
+    name?: string;
+    className?: string;
+    'aria-label'?: string;
+}
+declare const wrapperVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    tone?: "default" | "error" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export declare const FiscalCodeInput: import("react").ForwardRefExoticComponent<FiscalCodeInputProps & import("react").RefAttributes<HTMLInputElement>>;
+export { wrapperVariants as fiscalCodeWrapperVariants };
+//# sourceMappingURL=fiscal-code-input.d.ts.map

package/dist/components/fiscal-code-input/index.d.ts

@@ -0,0 +1,6 @@
+export { FiscalCodeInput, fiscalCodeWrapperVariants, } from './fiscal-code-input';
+export type { FiscalCodeInputProps, FiscalCodeInputHandle, FiscalCodeChangeMeta, } from './fiscal-code-input';
+export { fiscalCodeInputAgent } from './fiscal-code-input.agent';
+export { classifyCodiceFiscale, isValidCodiceFiscale, computeControlChar, type FiscalCodeReason, } from './is-valid-codice-fiscale';
+export { calculateCodiceFiscale, type CodiceFiscaleInput, } from './calculate-codice-fiscale';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/fiscal-code-input/index.js

@@ -0,0 +1,11 @@
+import { F as c, c as e, a as i, b as l, f as o, w as t, i as C } from "../../_chunks/fiscal-code-input-BZ0FxwUl.js";
+export {
+  c as FiscalCodeInput,
+  e as calculateCodiceFiscale,
+  i as classifyCodiceFiscale,
+  l as computeControlChar,
+  o as fiscalCodeInputAgent,
+  t as fiscalCodeWrapperVariants,
+  C as isValidCodiceFiscale
+};
+//# sourceMappingURL=index.js.map

package/dist/components/fiscal-code-input/is-valid-codice-fiscale.d.ts

@@ -0,0 +1,21 @@
+/** Outcome of a structural + checksum check on a 16-char candidate. */
+export type FiscalCodeReason = 'empty' | 'incomplete' | 'badFormat' | 'badChecksum' | 'valid';
+/**
+ * Compute the expected 16th control character from the first 15
+ * informative characters. The input MUST already be 15 uppercase
+ * `[A-Z0-9]` characters (callers guard with `hasValidStructure`).
+ */
+export declare function computeControlChar(first15: string): string;
+/**
+ * Classify a normalised (uppercased, `[A-Z0-9]`-only) candidate.
+ *
+ * - `empty` — no characters.
+ * - `incomplete` — fewer than 16 characters.
+ * - `badFormat` — 16 characters but the position-class pattern fails.
+ * - `badChecksum` — 16 well-formed characters but the control char is wrong.
+ * - `valid` — structurally sound and the control char matches.
+ */
+export declare function classifyCodiceFiscale(raw: string): FiscalCodeReason;
+/** Convenience boolean: structurally sound AND control character matches. */
+export declare function isValidCodiceFiscale(raw: string): boolean;
+//# sourceMappingURL=is-valid-codice-fiscale.d.ts.map

package/dist/components/freemium-paywall/index.js

@@ -1,4 +1,4 @@
-import { F as m, f as l } from "../../_chunks/freemium-paywall-D1N02Oam.js";
+import { F as m, f as l } from "../../_chunks/freemium-paywall-BAk3a6er.js";
 export {
   m as FreemiumPaywall,
   l as freemiumPaywallAgent

package/dist/components/gestational-age-calculator/gestational-age-calculator.d.ts

@@ -0,0 +1,27 @@
+import { type VariantProps } from 'class-variance-authority';
+import { type InsertPayload } from '../_shared/insert-result';
+import { type Trimester, type GestationalAge } from '../due-date-calculator';
+declare const rootVariants: (props?: ({
+    width?: "auto" | "full" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type DateMethod = 'lmp' | 'edd';
+export interface GestationalAgeResult {
+    gestationalAge: GestationalAge | null;
+    trimester: Trimester;
+    dueDate: Date;
+}
+export interface GestationalAgeCalculatorProps extends VariantProps<typeof rootVariants> {
+    /** Whether the input date is the last period (`lmp`) or the due date (`edd`). */
+    defaultMethod?: DateMethod;
+    /** Fires whenever a result can be computed (and `null` when it can't). */
+    onResultChange?: (result: GestationalAgeResult | null) => void;
+    /** When provided, shows an "Insert" button that emits the result for an editor. */
+    onInsert?: (payload: InsertPayload) => void;
+    /** Opaque instance id, emitted as `data-component-id`. */
+    id?: string;
+    /** Extra class names on the wrapper. */
+    className?: string;
+}
+export declare const GestationalAgeCalculator: import("react").ForwardRefExoticComponent<GestationalAgeCalculatorProps & import("react").RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=gestational-age-calculator.d.ts.map

package/dist/components/gestational-age-calculator/index.d.ts

@@ -0,0 +1,3 @@
+export { GestationalAgeCalculator } from './gestational-age-calculator';
+export type { GestationalAgeCalculatorProps, GestationalAgeResult, } from './gestational-age-calculator';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/gestational-age-calculator/index.js

@@ -0,0 +1,5 @@
+import { G as t } from "../../_chunks/gestational-age-calculator-CsQ05qDy.js";
+export {
+  t as GestationalAgeCalculator
+};
+//# sourceMappingURL=index.js.map

package/dist/components/header-settings/header-settings.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { HeaderSettingsHandle } from './header-settings';
+export declare const headerSettingsAgent: AgentAdapter<HeaderSettingsHandle>;
+//# sourceMappingURL=header-settings.agent.d.ts.map

package/dist/components/header-settings/header-settings.d.ts

@@ -0,0 +1,36 @@
+import { type HTMLAttributes } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+import { type AccessibilityPreference, type ThemePreference } from '../../hooks';
+declare const wrapperVariants: (props?: ({
+    align?: "end" | "start" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface HeaderSettingsProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'>, VariantProps<typeof wrapperVariants> {
+    /** Anchor side for the dropdown. Defaults to `end` (matches LTR + RTL). */
+    align?: 'start' | 'end';
+    /**
+     * Size of the cog trigger only. Forwards to the underlying
+     * `IconButton`. Defaults to `md` to preserve the existing visual.
+     * Use `sm` when composing alongside other `<Button size="sm">`
+     * actions in a header row — keeps the visual rhythm consistent.
+     *
+     * The internal dropdown chrome (Appearance toggle group, locale
+     * picker, accessibility switch) stays at kit defaults regardless
+     * — this prop only sizes the trigger.
+     */
+    size?: 'sm' | 'md' | 'lg';
+    /** Disable the trigger entirely. */
+    disabled?: boolean;
+}
+export interface HeaderSettingsHandle {
+    /**
+     * Switch the active locale. Widened to `string` (vs. `Locale`) so
+     * agent surfaces with untyped inputs can call through without
+     * extra casting — invalid tags no-op silently.
+     */
+    setLocale: (next: string) => void;
+    setTheme: (next: ThemePreference) => void;
+    setAccessibility: (next: AccessibilityPreference) => void;
+}
+export declare const HeaderSettings: import("react").ForwardRefExoticComponent<HeaderSettingsProps & import("react").RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=header-settings.d.ts.map

package/dist/components/header-settings/index.d.ts

@@ -0,0 +1,2 @@
+export { HeaderSettings, type HeaderSettingsProps, type HeaderSettingsHandle, } from './header-settings';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/header-settings/index.js

@@ -1,244 +1,5 @@
-import { jsx as e, jsxs as l } from "react/jsx-runtime";
-import { forwardRef as A, useRef as p, useImperativeHandle as C, useCallback as x, useMemo as I } from "react";
-import { c as N } from "../../_chunks/index-D2ZczOXr.js";
-import { useTranslation as E } from "react-i18next";
-import { I as o } from "../../_chunks/icon-button-CKEOrN37.js";
-import { I as M } from "../../_chunks/icon-button-group-C48khLE0.js";
-import { D as r } from "../../_chunks/dropdown-menu-BC5ZdOMo.js";
-import { S as R } from "../../_chunks/switch-BJ6HD3Mn.js";
-import { c as v, a as _, L as H } from "../../_chunks/locale-picker-D99UyZVJ.js";
-import { u as O } from "../../_chunks/use-locale-BkCIHujH.js";
-import { u as P } from "../../_chunks/use-theme-C2dHKUAN.js";
-import { u as j } from "../../_chunks/registry-nPAVE19X.js";
-import { S as K } from "../../_chunks/settings-ca2Yi9R8.js";
-import { S as D, M as z } from "../../_chunks/sun-BuXE0xUS.js";
-import { M as V } from "../../_chunks/monitor-D-SFdbrU.js";
-const B = {
-  id: "header-settings",
-  capabilities: ["view_change"],
-  state: {},
-  actions: {
-    set_locale: {
-      safety: "write",
-      argsType: "{ locale: string }",
-      descriptionKey: "ui.agent.headerSettings.actions.setLocale",
-      description: "Switch the active locale to the given IETF tag.",
-      invoke: (t, i) => {
-        t.setLocale(i.locale);
-      }
-    },
-    set_theme: {
-      safety: "write",
-      argsType: '{ theme: "light" | "dark" | "system" }',
-      descriptionKey: "ui.agent.headerSettings.actions.setTheme",
-      description: "Switch the theme preference.",
-      invoke: (t, i) => {
-        t.setTheme(i.theme);
-      }
-    },
-    set_accessibility: {
-      safety: "write",
-      argsType: '{ accessibility: "default" | "accessible" }',
-      descriptionKey: "ui.agent.headerSettings.actions.setAccessibility",
-      description: "Switch the accessibility preference.",
-      invoke: (t, i) => {
-        t.setAccessibility(i.accessibility);
-      }
-    }
-  },
-  domHooks: {
-    root: {
-      attr: "data-component",
-      value: "header-settings",
-      description: "Marks the HeaderSettings wrapper."
-    }
-  }
-};
-function G(t, i) {
-  if (!(typeof window > "u"))
-    try {
-      window.localStorage.setItem(t, i);
-    } catch {
-    }
-}
-function W(t) {
-  if (typeof document > "u") return;
-  const i = document.documentElement;
-  i.lang = t, i.dir = v[t].dir;
-}
-const F = N("ds:inline-flex ds:items-center", {
-  variants: {
-    align: {
-      start: "",
-      end: ""
-    }
-  },
-  defaultVariants: { align: "end" }
-}), U = [
-  "ds:w-[20rem] ds:p-[var(--spacing-xs)]",
-  "ds:rounded-[var(--radius-md)] ds:border ds:border-border",
-  "ds:bg-background ds:text-foreground ds:shadow-[var(--shadow-lg)]"
-].join(" "), Y = A(
-  (t, i) => {
-    const {
-      align: g = "end",
-      size: y = "md",
-      disabled: S = !1,
-      className: w,
-      id: m,
-      ...L
-    } = t, { t: s } = E(), n = P(), { setLocale: h } = O(), u = p(null);
-    C(i, () => u.current, []);
-    const f = x(
-      (a) => {
-        h(a), W(a), G(H, a);
-      },
-      [h]
-    ), b = p(f);
-    b.current = f;
-    const c = p(n);
-    c.current = n;
-    const k = I(
-      () => ({
-        setLocale: (a) => {
-          Object.prototype.hasOwnProperty.call(v, a) && b.current(a);
-        },
-        setTheme: (a) => c.current.setTheme(a),
-        setAccessibility: (a) => c.current.setAccessibility(a)
-      }),
-      []
-    );
-    j(B, k, m);
-    const T = n.accessibility === "accessible";
-    return /* @__PURE__ */ e(
-      "div",
-      {
-        ref: u,
-        "data-component": "header-settings",
-        "data-component-id": m,
-        className: F({ align: g, className: w }),
-        ...L,
-        children: /* @__PURE__ */ l(r.Root, { children: [
-          /* @__PURE__ */ e(r.Trigger, { asChild: !0, children: /* @__PURE__ */ e(
-            o,
-            {
-              size: y,
-              disabled: S,
-              icon: /* @__PURE__ */ e(K, { "aria-hidden": !0 }),
-              "aria-label": s("navigation.headerSettings.trigger")
-            }
-          ) }),
-          /* @__PURE__ */ e(r.Portal, { children: /* @__PURE__ */ l(
-            r.Content,
-            {
-              align: g,
-              sideOffset: 8,
-              className: U,
-              onKeyDownCapture: (a) => {
-                const d = a.target;
-                (d == null ? void 0 : d.tagName) === "INPUT" && // Always allow Escape so the menu can close.
-                a.key !== "Escape" && a.stopPropagation();
-              },
-              children: [
-                /* @__PURE__ */ e(r.Label, { children: s("navigation.headerSettings.language.label") }),
-                /* @__PURE__ */ e(
-                  "div",
-                  {
-                    role: "group",
-                    "aria-label": s("navigation.headerSettings.language.label"),
-                    className: [
-                      "ds:px-[var(--spacing-sm)] ds:py-[var(--spacing-xs)]",
-                      // Stretch the compact LocalePicker to the full menu
-                      // width so it reads as a single row affordance (not
-                      // a centred pill). The picker's root is
-                      // inline-flex; the `*:` child selector + `flex-1`
-                      // gives it `flex: 1 1 0%` once it's a child of the
-                      // flex container we make this div into.
-                      "ds:flex ds:[&>*]:flex-1"
-                    ].join(" "),
-                    children: /* @__PURE__ */ e(_, { variant: "compact", popoverSide: "end" })
-                  }
-                ),
-                /* @__PURE__ */ e(r.Separator, {}),
-                /* @__PURE__ */ e(r.Label, { children: s("navigation.headerSettings.appearance.label") }),
-                /* @__PURE__ */ e(
-                  "div",
-                  {
-                    role: "group",
-                    "aria-label": s("navigation.headerSettings.appearance.label"),
-                    className: "ds:px-[var(--spacing-sm)] ds:py-[var(--spacing-xs)]",
-                    children: /* @__PURE__ */ l(
-                      M,
-                      {
-                        role: "radiogroup",
-                        mode: "toggle-single",
-                        size: "sm",
-                        "aria-label": s("navigation.headerSettings.appearance.label"),
-                        value: n.theme,
-                        onValueChange: (a) => n.setTheme(a),
-                        children: [
-                          /* @__PURE__ */ e(
-                            o,
-                            {
-                              icon: /* @__PURE__ */ e(D, { "aria-hidden": !0 }),
-                              "aria-label": s("navigation.headerSettings.appearance.light"),
-                              value: "light"
-                            }
-                          ),
-                          /* @__PURE__ */ e(
-                            o,
-                            {
-                              icon: /* @__PURE__ */ e(z, { "aria-hidden": !0 }),
-                              "aria-label": s("navigation.headerSettings.appearance.dark"),
-                              value: "dark"
-                            }
-                          ),
-                          /* @__PURE__ */ e(
-                            o,
-                            {
-                              icon: /* @__PURE__ */ e(V, { "aria-hidden": !0 }),
-                              "aria-label": s(
-                                "navigation.headerSettings.appearance.system"
-                              ),
-                              value: "system"
-                            }
-                          )
-                        ]
-                      }
-                    )
-                  }
-                ),
-                /* @__PURE__ */ e(r.Separator, {}),
-                /* @__PURE__ */ e(
-                  "div",
-                  {
-                    role: "group",
-                    "aria-label": s(
-                      "navigation.headerSettings.appearance.accessible"
-                    ),
-                    className: "ds:px-[var(--spacing-sm)] ds:py-[var(--spacing-sm)]",
-                    children: /* @__PURE__ */ e(
-                      R,
-                      {
-                        label: s("navigation.headerSettings.appearance.accessible"),
-                        labelSide: "start",
-                        size: "sm",
-                        checked: T,
-                        onCheckedChange: (a) => n.setAccessibility(a ? "accessible" : "default")
-                      }
-                    )
-                  }
-                )
-              ]
-            }
-          ) })
-        ] })
-      }
-    );
-  }
-);
-Y.displayName = "HeaderSettings";
+import { H as t } from "../../_chunks/header-settings-CBLwUK6t.js";
 export {
-  Y as HeaderSettings
+  t as HeaderSettings
 };
 //# sourceMappingURL=index.js.map

package/dist/components/index.d.ts

@@ -19,6 +19,7 @@ export * from './date-picker';
 export * from './date-range-picker';
 export * from './date-time-picker';
 export * from './due-date-calculator';
+export * from './gestational-age-calculator';
 export * from './email-input';
 export * from './file-upload';
 export * from './form-field';
@@ -37,11 +38,14 @@ export * from './switch';
 export * from './text-area';
 export * from './text-input';
 export * from './time-picker';
+export { InsertButton, type InsertButtonProps, type InsertPayload, type InsertMode, type InsertCardData, type InsertCardField, } from './_shared/insert-result';
 export * from './accordion';
 export * from './avatar';
 export * from './badge';
 export * from './benefit-card';
 export * from './bmi-calculator';
+export * from './calculator-dialog';
+export * from './cycle-calculator';
 export * from './card';
 export * from './carousel';
 export * from './contact-card';
@@ -89,6 +93,7 @@ export * from './message-tray';
 export * from './notification-card';
 export * from './notification-tray';
 export * from './popover';
+export * from './pregnancy-weight-gain';
 export * from './privacy-lock';
 export * from './progress';
 export * from './sheet';
@@ -105,6 +110,7 @@ export * from './resizable';
 export * from './scroll-area';
 export * from './separator';
 export * from './theme-root';
+export * from './unit-converter';
 export * from './visually-hidden';
 export * from './chart';
 export * from './ai-prompt-input';
@@ -129,6 +135,7 @@ export * from './pdf-viewer';
 export * from './reviews-panel';
 export * from './rich-text-editor';
 export * from './signature-capture';
+export * from './sign-document';
 export * from './slot-grid';
 export * from './tooth-scheme';
 export * from './transaction-chip';
@@ -137,4 +144,11 @@ export * from './workflow';
 export * from '../patterns/alia-assistant';
 export * from '../patterns/patient-shell';
 export * from '../patterns/marketplace-app-shell';
+export * from './dependent-selector';
+export * from './document-scanner';
+export * from './fiscal-code-input';
+export * from './qr-code';
+export * from './session-countdown';
+export * from './social-sign-in-button';
+export * from './wallet-pay-button';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/locale-picker/locale-picker.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { LocalePickerHandle } from './locale-picker';
+export declare const localePickerAgent: AgentAdapter<LocalePickerHandle>;
+//# sourceMappingURL=locale-picker.agent.d.ts.map

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

@@ -0,0 +1,80 @@
+import { type HTMLAttributes } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+import { type Locale } from '../../i18n/locale-meta';
+export declare const LOCALE_STORAGE_KEY = "alfadocs-ui.locale";
+/**
+ * Sentinel value (and Combobox-row key) for "follow the browser /
+ * OS locale". Mirrors the ThemeToggle's `'system'` preference: the
+ * picker doesn't store a concrete locale code; the runtime resolves
+ * to `navigator.language` on each mount.
+ */
+export declare const LOCALE_SYSTEM_DEFAULT: "system";
+export type LocalePreference = Locale | typeof LOCALE_SYSTEM_DEFAULT;
+declare const wrapperVariants: (props?: ({
+    variant?: "icon" | "compact" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type LocalePickerVariant = 'icon' | 'compact';
+export interface LocalePickerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'>, VariantProps<typeof wrapperVariants> {
+    variant?: LocalePickerVariant;
+    /**
+     * Controlled escape hatch — when omitted the picker reads/writes
+     * `useLocale()` directly so a bare `<LocalePicker />` works with no
+     * wiring. Pass both to opt into controlled mode.
+     */
+    value?: Locale;
+    onValueChange?: (next: LocalePreference) => void;
+    /** Disable interaction (greys out the trigger). */
+    disabled?: boolean;
+    /** Mark as busy (kept open / focusable but read-only). */
+    loading?: boolean;
+    /**
+     * Side the search popover opens onto, relative to the trigger.
+     * Defaults to `bottom` (standard dropdown). Use `end` (inline-end —
+     * right in LTR, left in RTL) when nesting the LocalePicker inside
+     * another popover/menu so the search surface flies out to the side
+     * rather than stacking below.
+     */
+    popoverSide?: 'top' | 'bottom' | 'start' | 'end';
+}
+/**
+ * Curated imperative handle for agent / external automation. The
+ * `setLocale` parameter is widened to `string` (rather than the
+ * narrower `Locale`) so untyped agent inputs don't have to thread the
+ * `LOCALES_WITH_BUNDLES` constraint at the call site — the
+ * implementation validates internally and no-ops on an unsupported
+ * tag.
+ */
+export interface LocalePickerHandle {
+    setLocale: (next: string) => void;
+}
+export interface LocalePickerSearchListProps {
+    /**
+     * Active selection. Either a `Locale` code or the
+     * `LOCALE_SYSTEM_DEFAULT` sentinel (when the user hasn't made an
+     * explicit choice and the kit is following `navigator.language`).
+     * Defaults to the shared store.
+     */
+    value?: LocalePreference;
+    /**
+     * Fires after a successful selection. Accepts a concrete `Locale`
+     * or `LOCALE_SYSTEM_DEFAULT` (when the user picks the "System
+     * Default" row at the top of the list).
+     *
+     * Defaults to the shared setter (delegates to useLocale, persists
+     * or clears storage, updates document.dir/lang).
+     */
+    onValueChange?: (next: LocalePreference) => void;
+    /** Optional id for the search input (axe `aria-labelledby` chain). */
+    inputId?: string;
+    /** Disable the input + list interactions. */
+    disabled?: boolean;
+    /** Mark as busy (read-only). */
+    loading?: boolean;
+    className?: string;
+}
+export declare const LocalePickerSearchList: import("react").ForwardRefExoticComponent<LocalePickerSearchListProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const LocalePicker: import("react").ForwardRefExoticComponent<LocalePickerProps & import("react").RefAttributes<HTMLDivElement>> & {
+    SearchList: import("react").ForwardRefExoticComponent<LocalePickerSearchListProps & import("react").RefAttributes<HTMLDivElement>>;
+};
+export {};
+//# sourceMappingURL=locale-picker.d.ts.map

package/dist/components/logo/index.js

@@ -1,4 +1,4 @@
-import { L } from "../../_chunks/logo-_Z-jLq80.js";
+import { L } from "../../_chunks/logo-yituK7sE.js";
 export {
   L as Logo
 };

package/dist/components/map-view/index.js

@@ -1,4 +1,4 @@
-import { M as o } from "../../_chunks/map-view-vD5pvWs9.js";
+import { M as o } from "../../_chunks/map-view-qJLybrmN.js";
 export {
   o as MapView
 };

package/dist/components/message-card/index.js

@@ -1,4 +1,4 @@
-import { M as a, i as r } from "../../_chunks/message-card-BbRhZkDI.js";
+import { M as a, i as r } from "../../_chunks/message-card-DSPw5ghw.js";
 import { m } from "../../_chunks/message-card.agent-4IeIgrnJ.js";
 export {
   a as MessageCard,

package/dist/components/message-tray/index.js

@@ -1,4 +1,4 @@
-import { M as s, m as r } from "../../_chunks/message-tray-B762TKuv.js";
+import { M as s, m as r } from "../../_chunks/message-tray-hSQff9u4.js";
 export {
   s as MessageTray,
   r as messageTrayAgent

package/dist/components/notification-card/index.js

@@ -1,4 +1,4 @@
-import { N as a, i as t } from "../../_chunks/notification-card-DMdO4g54.js";
+import { N as a, i as t } from "../../_chunks/notification-card-CObnGdJu.js";
 import { n as f } from "../../_chunks/notification-card.agent-Rqt3ofk9.js";
 export {
   a as NotificationCard,