@rookcom/monarch-react 0.0.0-stage → 0.3.0

package/dist/components/feedback/toast/toast.js

@@ -0,0 +1,187 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useId, useMemo, useRef, useState, } from 'react';
+import * as ToastPrimitive from '@radix-ui/react-toast';
+import { cx } from '../../../internal/cx.js';
+import { CloseGlyph, InfoGlyph, SuccessGlyph, WarningGlyph } from '../../../internal/icons.js';
+const ToastContext = createContext(null);
+/** Longer than the exit animation (--mn-duration-base). */
+const EXIT_MS = 600;
+const SHORT_MS = 5000;
+const LONG_MS = 10000;
+let counter = 0;
+/**
+ * Mount once near the root. Provides `useToast()` and renders the viewport.
+ *
+ * Toasts never take focus. They pause while hovered or focused, can be reached
+ * with F8 (the `hotkey`), and close with Escape. Each one is announced once
+ * through a live region: assertively for `danger`, politely otherwise.
+ */
+export function ToastProvider({ label = 'Notifications', position = 'bottom-right', hotkey = DEFAULT_HOTKEY, durationScale = 1, limit = 3, dismissLabel = 'Dismiss', children, }) {
+    const [toasts, setToasts] = useState([]);
+    const timers = useRef(new Set());
+    useEffect(() => {
+        const pending = timers.current;
+        return () => {
+            for (const t of pending)
+                clearTimeout(t);
+            pending.clear();
+        };
+    }, []);
+    /** Drops closed records once the exit animation has had time to run. */
+    const sweep = useCallback(() => {
+        const t = setTimeout(() => {
+            timers.current.delete(t);
+            setToasts((list) => list.filter((r) => r.open));
+        }, EXIT_MS);
+        timers.current.add(t);
+    }, []);
+    const dismiss = useCallback((id) => {
+        setToasts((list) => list.map((t) => (t.open && (id === undefined || t.id === id) ? { ...t, open: false } : t)));
+        sweep();
+    }, [sweep]);
+    const show = useCallback((options) => {
+        const id = `mn-toast-${++counter}`;
+        setToasts((list) => {
+            const next = [...list, { ...options, id, open: true }];
+            const openOnes = next.filter((t) => t.open);
+            const overflow = openOnes.length - Math.max(1, limit);
+            if (overflow > 0) {
+                const set = new Set(openOnes.slice(0, overflow).map((t) => t.id));
+                return next.map((t) => (set.has(t.id) ? { ...t, open: false } : t));
+            }
+            return next;
+        });
+        sweep();
+        return { id, dismiss: () => dismiss(id) };
+    }, [dismiss, sweep, limit]);
+    const toast = useMemo(() => {
+        const fn = ((options) => show(options));
+        const tone = (t) => (title, options) => show({ ...options, title, tone: t });
+        fn.success = tone('success');
+        fn.error = tone('danger');
+        fn.warning = tone('warning');
+        fn.info = tone('info');
+        return fn;
+    }, [show]);
+    const value = useMemo(() => ({ toast, dismiss }), [toast, dismiss]);
+    return (_jsx(ToastContext.Provider, { value: value, children: _jsxs(ToastPrimitive.Provider, { swipeDirection: position.endsWith('right') ? 'right' : 'down', label: label, children: [children, toasts.map((t) => (_jsx(ToastItem, { record: t, durationScale: durationScale, dismissLabel: dismissLabel, onOpenChange: (open) => (open ? undefined : dismiss(t.id)) }, t.id))), _jsx(ToastPrimitive.Viewport, { className: "mn-toast-viewport", "data-position": position, hotkey: hotkey, label: hotkey.length ? `${label} ({hotkey})` : label })] }) }));
+}
+const DEFAULT_HOTKEY = ['F8'];
+const toneIcon = {
+    neutral: null,
+    info: _jsx(InfoGlyph, {}),
+    success: _jsx(SuccessGlyph, {}),
+    warning: _jsx(WarningGlyph, {}),
+    danger: _jsx(WarningGlyph, {}),
+};
+/** The duration Radix should use: scaled, and Infinity when auto-dismiss is off. */
+function toastDuration(record, scale) {
+    const base = record.duration ?? (record.tone === 'danger' || record.action ? LONG_MS : SHORT_MS);
+    const scaled = base * (scale > 0 ? scale : 1);
+    return Number.isFinite(scaled) ? Math.round(scaled) : Infinity;
+}
+function ToastItem({ record, durationScale, dismissLabel, onOpenChange, }) {
+    const titleId = useId();
+    const tone = record.tone ?? 'neutral';
+    const politeness = record.politeness ?? (tone === 'danger' ? 'assertive' : 'polite');
+    const icon = toneIcon[tone];
+    // onDismiss fires once, the first time the record closes.
+    const notified = useRef(false);
+    const onDismiss = record.onDismiss;
+    useEffect(() => {
+        if (!record.open && !notified.current) {
+            notified.current = true;
+            onDismiss?.();
+        }
+    }, [record.open, onDismiss]);
+    return (
+    // No role on the <li>: it must stay a list item of the viewport's <ol>.
+    // Radix announces the text through its own live region, whose politeness
+    // follows `type` (foreground = assertive, background = polite).
+    _jsxs(ToastPrimitive.Root, { open: record.open, onOpenChange: onOpenChange, duration: toastDuration(record, durationScale), type: politeness === 'assertive' ? 'foreground' : 'background', className: "mn-toast", "data-tone": tone, "data-politeness": politeness, "aria-labelledby": titleId, children: [icon ? (_jsx("span", { className: "mn-toast__icon", "aria-hidden": true, children: icon })) : null, _jsxs("div", { className: "mn-toast__body", children: [_jsx(ToastPrimitive.Title, { id: titleId, className: "mn-toast__title", children: record.title }), record.description ? (_jsx(ToastPrimitive.Description, { className: "mn-toast__description", children: record.description })) : null] }), record.action ? (_jsx(ToastPrimitive.Action, { asChild: true, altText: record.action.altText || record.action.label, children: _jsx("button", { type: "button", className: cx('mn-button', 'mn-toast__action'), "data-variant": "secondary", "data-size": "xs", onClick: record.action.onClick, children: record.action.label }) })) : null, _jsx(ToastPrimitive.Close, { className: "mn-toast__close", "aria-label": dismissLabel, "aria-describedby": titleId, children: _jsx(CloseGlyph, {}) })] }));
+}
+/**
+ * Returns `toast` (callable, with `.success`, `.error`, `.warning`, `.info`)
+ * and `dismiss(id?)`. Must be used inside ToastProvider.
+ */
+export function useToast() {
+    const ctx = useContext(ToastContext);
+    if (!ctx)
+        throw new Error('useToast must be used inside <ToastProvider>');
+    return ctx;
+}
+/** Messages that describe the transport, not the problem; replaced by the fallback. */
+const GENERIC = [
+    /^request failed with status code \d{3}$/i,
+    /^network ?error$/i,
+    /^failed to fetch$/i,
+    /^load failed$/i,
+    /^networkerror when attempting to fetch resource\.?$/i,
+    /^internal server error$/i,
+    /^\[object object\]$/i,
+    // An HTML error page from a proxy or gateway.
+    /^<(!doctype|html|head|body)\b/i,
+];
+function text(value) {
+    if (typeof value === 'string') {
+        const t = value.trim();
+        return t && !GENERIC.some((re) => re.test(t)) ? t : undefined;
+    }
+    if (Array.isArray(value)) {
+        const parts = value
+            .map((v) => text(typeof v === 'object' && v
+            ? (v.message ?? v.detail)
+            : v))
+            .filter(Boolean);
+        return parts.length ? parts.join(' ') : undefined;
+    }
+    return undefined;
+}
+function fromBody(body) {
+    if (!body || typeof body !== 'object')
+        return text(body);
+    const b = body;
+    const details = b.details;
+    const fields = (details?.fields ?? b.fields ?? b.fieldErrors);
+    if (fields && typeof fields === 'object') {
+        const flat = Object.values(fields).flatMap((v) => (Array.isArray(v) ? v : [v]));
+        const joined = text(flat);
+        if (joined)
+            return joined;
+    }
+    return text(b.message) ?? text(b.errors) ?? text(b.detail) ?? text(b.error) ?? text(b.title);
+}
+/**
+ * Turns anything thrown or rejected into one sentence a person can read, for
+ * `toast.error()` or an inline error. Pure; it knows no product's API.
+ *
+ * Looks, in order, at: a string; field errors (`details.fields`, `fields`,
+ * `fieldErrors`, flattened); `message` (string or list); `errors[]`
+ * (`message`/`detail`); `detail`; `error`; `title`, on the response body
+ * (`error.response.data`, `error.data`, `error.body`) and then the error
+ * itself. Transport messages ("Request failed with status code 500",
+ * "Failed to fetch") are never shown; the fallback is.
+ */
+export function getErrorMessage(error, options = {}) {
+    const fallback = options.fallback ?? 'Something went wrong. Try again.';
+    if (error == null)
+        return fallback;
+    if (typeof error === 'string')
+        return text(error) ?? fallback;
+    if (typeof error !== 'object')
+        return fallback;
+    const e = error;
+    const response = e.response;
+    const found = fromBody(response?.data) ?? fromBody(e.data) ?? fromBody(e.body) ?? fromBody(e);
+    if (found)
+        return found;
+    const raw = typeof e.message === 'string' ? e.message.trim() : '';
+    const isNetwork = e.name === 'TypeError' ||
+        e.code === 'ERR_NETWORK' ||
+        /^(network ?error|failed to fetch|load failed|networkerror)/i.test(raw);
+    if (isNetwork && options.network)
+        return options.network;
+    return fallback;
+}
+//# sourceMappingURL=toast.js.map

package/dist/components/feedback/toast/toast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.js","sourceRoot":"","sources":["../../../../src/components/feedback/toast/toast.tsx"],"names":[],"mappings":"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"}

package/dist/components/forms/checkbox/checkbox.d.ts

@@ -0,0 +1,15 @@
+import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
+import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
+export interface CheckboxProps extends ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root> {
+    /** Inline label. Omit when the checkbox sits inside a Field with a FieldLabel. */
+    label?: ReactNode;
+    /** Secondary text under an inline label. */
+    description?: ReactNode;
+    invalid?: boolean;
+}
+/**
+ * A checkbox with optional inline label. Supports `checked="indeterminate"`.
+ * Space toggles it; it participates in native forms via `name`/`value`.
+ */
+export declare const Checkbox: import("react").ForwardRefExoticComponent<CheckboxProps & import("react").RefAttributes<HTMLButtonElement>>;
+//# sourceMappingURL=checkbox.d.ts.map

package/dist/components/forms/checkbox/checkbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox.d.ts","sourceRoot":"","sources":["../../../../src/components/forms/checkbox/checkbox.tsx"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,wBAAwB,EAE7B,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,iBAAiB,MAAM,0BAA0B,CAAC;AAK9D,MAAM,WAAW,aAAc,SAAQ,wBAAwB,CAAC,OAAO,iBAAiB,CAAC,IAAI,CAAC;IAC5F,kFAAkF;IAClF,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,6GAqCpB,CAAC"}

package/dist/components/forms/checkbox/checkbox.js

@@ -0,0 +1,23 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef, useId, } from 'react';
+import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
+import { cx } from '../../../internal/cx.js';
+import { CheckGlyph, DashGlyph } from '../../../internal/icons.js';
+import { useFieldControl } from '../form-field/index.js';
+/**
+ * A checkbox with optional inline label. Supports `checked="indeterminate"`.
+ * Space toggles it; it participates in native forms via `name`/`value`.
+ */
+export const Checkbox = forwardRef(function Checkbox({ label, description, invalid, className, ...rest }, ref) {
+    const auto = useId();
+    const props = useFieldControl(rest, { invalid });
+    const id = props.id ?? `mn-checkbox-${auto}`;
+    const descriptionId = description ? `${id}-description` : undefined;
+    const describedBy = cx(props['aria-describedby'], descriptionId);
+    const control = (_jsx(CheckboxPrimitive.Root, { ref: ref, ...props, id: id, "aria-describedby": describedBy, className: cx('mn-checkbox', label ? undefined : className), children: _jsx(CheckboxPrimitive.Indicator, { className: "mn-checkbox__indicator", children: props.checked === 'indeterminate' ? _jsx(DashGlyph, {}) : _jsx(CheckGlyph, {}) }) }));
+    if (!label)
+        return control;
+    return (_jsxs("div", { className: cx('mn-choice', className), "data-disabled": props.disabled || undefined, children: [control, _jsxs("div", { className: "mn-choice__text", children: [_jsx("label", { htmlFor: id, className: "mn-choice__label", children: label }), description ? (_jsx("p", { id: descriptionId, className: "mn-choice__description", children: description })) : null] })] }));
+});
+//# sourceMappingURL=checkbox.js.map

package/dist/components/forms/checkbox/checkbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox.js","sourceRoot":"","sources":["../../../../src/components/forms/checkbox/checkbox.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EACL,UAAU,EACV,KAAK,GAIN,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,iBAAiB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,EAAE,EAAE,MAAM,yBAAyB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAUzD;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAChC,SAAS,QAAQ,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG;IACxE,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;IACrB,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,eAAe,IAAI,EAAE,CAAC;IAC7C,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,MAAM,WAAW,GAAG,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,aAAa,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,CACd,KAAC,iBAAiB,CAAC,IAAI,IACrB,GAAG,EAAE,GAAG,KACJ,KAAK,EACT,EAAE,EAAE,EAAE,sBACY,WAAW,EAC7B,SAAS,EAAE,EAAE,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,YAE3D,KAAC,iBAAiB,CAAC,SAAS,IAAC,SAAS,EAAC,wBAAwB,YAC5D,KAAK,CAAC,OAAO,KAAK,eAAe,CAAC,CAAC,CAAC,KAAC,SAAS,KAAG,CAAC,CAAC,CAAC,KAAC,UAAU,KAAG,GACvC,GACP,CAC1B,CAAC;IACF,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAC3B,OAAO,CACL,eAAK,SAAS,EAAE,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,mBAAiB,KAAK,CAAC,QAAQ,IAAI,SAAS,aACnF,OAAO,EACR,eAAK,SAAS,EAAC,iBAAiB,aAC9B,gBAAO,OAAO,EAAE,EAAE,EAAE,SAAS,EAAC,kBAAkB,YAC7C,KAAK,GACA,EACP,WAAW,CAAC,CAAC,CAAC,CACb,YAAG,EAAE,EAAE,aAAa,EAAE,SAAS,EAAC,wBAAwB,YACrD,WAAW,GACV,CACL,CAAC,CAAC,CAAC,IAAI,IACJ,IACF,CACP,CAAC;AACJ,CAAC,CACF,CAAC"}

package/dist/components/forms/checkbox/index.d.ts

@@ -0,0 +1,2 @@
+export * from './checkbox.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/forms/checkbox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/forms/checkbox/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/components/forms/checkbox/index.js

@@ -0,0 +1,2 @@
+export * from './checkbox.js';
+//# sourceMappingURL=index.js.map

package/dist/components/forms/checkbox/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/forms/checkbox/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/components/forms/combobox/combobox.d.ts

@@ -0,0 +1,35 @@
+import { type InputHTMLAttributes, type ReactNode } from 'react';
+export interface ComboboxOption {
+    value: string;
+    label: string;
+    /** Secondary text under the label. */
+    description?: string;
+    disabled?: boolean;
+}
+export interface ComboboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'defaultValue' | 'onChange' | 'size' | 'type'> {
+    options: ComboboxOption[];
+    /** Selected option value (controlled). */
+    value?: string | null;
+    defaultValue?: string | null;
+    onValueChange?: (value: string | null) => void;
+    /** Text typed in the input (controlled). Use for server-side filtering. */
+    inputValue?: string;
+    onInputValueChange?: (text: string) => void;
+    /** Custom filter. Default: case-insensitive label match. Pass `() => true` for server-filtered lists. */
+    filter?: (option: ComboboxOption, query: string) => boolean;
+    /** Shown while options load. */
+    loading?: boolean;
+    /** Shown when no option matches. */
+    emptyMessage?: ReactNode;
+    invalid?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    /** Allow clearing the selection with the clear button / Backspace on empty input. */
+    clearable?: boolean;
+}
+/**
+ * Single-select with typeahead. The input is the combobox; the list is a
+ * listbox positioned by Radix Popover. Keyboard: Down/Up move, Home/End jump,
+ * Enter selects, Escape closes, typing filters.
+ */
+export declare const Combobox: import("react").ForwardRefExoticComponent<ComboboxProps & import("react").RefAttributes<HTMLInputElement>>;
+//# sourceMappingURL=combobox.d.ts.map

package/dist/components/forms/combobox/combobox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../../../src/components/forms/combobox/combobox.tsx"],"names":[],"mappings":"AAEA,OAAO,EAOL,KAAK,mBAAmB,EAExB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAOf,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAc,SAAQ,IAAI,CACzC,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,OAAO,GAAG,cAAc,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CACxD;IACC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/C,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,yGAAyG;IACzG,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5D,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAKD;;;;GAIG;AACH,eAAO,MAAM,QAAQ,4GAwPnB,CAAC"}

package/dist/components/forms/combobox/combobox.js

@@ -0,0 +1,152 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef, useEffect, useId, useMemo, useRef, useState, } from 'react';
+import * as PopoverPrimitive from '@radix-ui/react-popover';
+import { cx } from '../../../internal/cx.js';
+import { CheckGlyph, ChevronDownGlyph } from '../../../internal/icons.js';
+import { useFieldControl } from '../form-field/index.js';
+import { Spinner } from '../../feedback/spinner/index.js';
+const defaultFilter = (o, q) => o.label.toLowerCase().includes(q.toLowerCase());
+/**
+ * Single-select with typeahead. The input is the combobox; the list is a
+ * listbox positioned by Radix Popover. Keyboard: Down/Up move, Home/End jump,
+ * Enter selects, Escape closes, typing filters.
+ */
+export const Combobox = forwardRef(function Combobox({ options, value: valueProp, defaultValue = null, onValueChange, inputValue: inputProp, onInputValueChange, filter = defaultFilter, loading = false, emptyMessage = 'No matches', invalid, size = 'md', clearable = true, placeholder, className, onKeyDown, onBlur, ...rest }, ref) {
+    const id = useId();
+    const listId = `mn-combobox-${id}-list`;
+    const [open, setOpen] = useState(false);
+    const [internalValue, setInternalValue] = useState(defaultValue);
+    const value = valueProp !== undefined ? valueProp : internalValue;
+    const selected = useMemo(() => options.find((o) => o.value === value) ?? null, [options, value]);
+    const [internalInput, setInternalInput] = useState(selected?.label ?? '');
+    const inputValue = inputProp !== undefined ? inputProp : internalInput;
+    const [active, setActive] = useState(0);
+    const inputRef = useRef(null);
+    const listRef = useRef(null);
+    const setInput = (text) => {
+        if (inputProp === undefined)
+            setInternalInput(text);
+        onInputValueChange?.(text);
+    };
+    const select = (next) => {
+        if (valueProp === undefined)
+            setInternalValue(next?.value ?? null);
+        onValueChange?.(next?.value ?? null);
+        setInput(next?.label ?? '');
+        setOpen(false);
+    };
+    // Keep the text in sync when the selection changes from outside.
+    useEffect(() => {
+        if (!open && inputProp === undefined)
+            setInternalInput(selected?.label ?? '');
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [selected?.label]);
+    const visible = useMemo(() => {
+        const q = inputValue.trim();
+        const typedNew = q !== '' && q !== (selected?.label ?? '');
+        return typedNew ? options.filter((o) => filter(o, q)) : options;
+    }, [options, inputValue, selected?.label, filter]);
+    useEffect(() => {
+        setActive((a) => Math.min(a, Math.max(0, visible.length - 1)));
+    }, [visible.length]);
+    useEffect(() => {
+        if (!open)
+            return;
+        const el = listRef.current?.querySelector(`[data-index="${active}"]`);
+        el?.scrollIntoView?.({ block: 'nearest' });
+    }, [active, open]);
+    const activeId = open && visible[active] ? `${listId}-opt-${active}` : undefined;
+    const handleKey = (e) => {
+        // Radix's dismissable layer prevents default on Escape before this runs,
+        // so only a consumer's own preventDefault stops the built-in handling.
+        const preventedBefore = e.defaultPrevented;
+        onKeyDown?.(e);
+        if (e.defaultPrevented && !preventedBefore)
+            return;
+        switch (e.key) {
+            case 'ArrowDown':
+                e.preventDefault();
+                if (!open)
+                    setOpen(true);
+                else
+                    setActive((a) => Math.min(a + 1, visible.length - 1));
+                break;
+            case 'ArrowUp':
+                e.preventDefault();
+                if (!open)
+                    setOpen(true);
+                else
+                    setActive((a) => Math.max(a - 1, 0));
+                break;
+            case 'Home':
+                if (open) {
+                    e.preventDefault();
+                    setActive(0);
+                }
+                break;
+            case 'End':
+                if (open) {
+                    e.preventDefault();
+                    setActive(visible.length - 1);
+                }
+                break;
+            case 'Enter':
+                if (open) {
+                    e.preventDefault();
+                    const opt = visible[active];
+                    if (opt && !opt.disabled)
+                        select(opt);
+                }
+                break;
+            case 'Escape':
+                if (open) {
+                    e.preventDefault();
+                    setOpen(false);
+                    setInput(selected?.label ?? '');
+                }
+                break;
+            case 'Backspace':
+                if (clearable && inputValue === '' && selected)
+                    select(null);
+                break;
+        }
+    };
+    const fieldProps = useFieldControl(rest, { invalid });
+    return (_jsxs(PopoverPrimitive.Root, { open: open, onOpenChange: (next) => {
+            setOpen(next);
+            if (!next)
+                setInput(selected?.label ?? '');
+        }, children: [_jsx(PopoverPrimitive.Anchor, { asChild: true, children: _jsxs("div", { className: cx('mn-input', 'mn-combobox', className), "data-size": size, "data-disabled": fieldProps.disabled || undefined, children: [_jsx("input", { ref: (node) => {
+                                inputRef.current = node;
+                                if (typeof ref === 'function')
+                                    ref(node);
+                                else if (ref)
+                                    ref.current = node;
+                            }, ...fieldProps, type: "text", role: "combobox", autoComplete: "off", "aria-autocomplete": "list", "aria-expanded": open, "aria-controls": open ? listId : undefined, "aria-activedescendant": activeId, className: "mn-combobox__input", placeholder: placeholder, value: inputValue, onChange: (e) => {
+                                setInput(e.target.value);
+                                setActive(0);
+                                if (!open)
+                                    setOpen(true);
+                            }, onKeyDown: handleKey, onBlur: (e) => {
+                                onBlur?.(e);
+                                // Revert unmatched text so the input always reflects the selection.
+                                if (!listRef.current?.contains(e.relatedTarget))
+                                    setInput(selected?.label ?? '');
+                            } }), loading ? _jsx(Spinner, { size: "sm", className: "mn-combobox__spinner" }) : null, _jsx("button", { type: "button", tabIndex: -1, "aria-label": open ? 'Close options' : 'Show options', className: "mn-combobox__toggle", disabled: fieldProps.disabled, onMouseDown: (e) => e.preventDefault(), onClick: () => {
+                                setOpen((o) => !o);
+                                inputRef.current?.focus();
+                            }, children: _jsx(ChevronDownGlyph, {}) })] }) }), _jsx(PopoverPrimitive.Portal, { children: _jsx(PopoverPrimitive.Content, { align: "start", sideOffset: 4, onOpenAutoFocus: (e) => e.preventDefault(), onCloseAutoFocus: (e) => e.preventDefault(), onInteractOutside: (e) => {
+                        if (inputRef.current?.contains(e.target))
+                            e.preventDefault();
+                    }, className: "mn-menu mn-combobox__content", children: _jsx("div", { ref: listRef, id: listId, role: "listbox", "aria-label": rest['aria-label'] ?? 'Options', className: "mn-combobox__list", children: loading && visible.length === 0 ? (_jsx("div", { className: "mn-combobox__status", role: "status", children: "Loading\u2026" })) : visible.length === 0 ? (_jsx("div", { className: "mn-combobox__status", role: "status", children: emptyMessage })) : (visible.map((o, i) => (
+                        // Options follow the aria-activedescendant pattern: the input keeps
+                        // focus and handles every key, so options are deliberately not focusable.
+                        // monarch-ignore-next-line a11y/click-without-key -- aria-activedescendant pattern: the input handles all keys
+                        // eslint-disable-next-line jsx-a11y/click-events-have-key-events, jsx-a11y/interactive-supports-focus
+                        _jsxs("div", { id: `${listId}-opt-${i}`, role: "option", "aria-selected": o.value === value, "aria-disabled": o.disabled || undefined, "data-index": i, "data-highlighted": i === active || undefined, className: "mn-menu__item", onMouseEnter: () => setActive(i), onMouseDown: (e) => e.preventDefault(), onClick: () => {
+                                if (!o.disabled)
+                                    select(o);
+                            }, children: [_jsxs("span", { className: "mn-menu__text", children: [o.label, o.description ? (_jsx("span", { className: "mn-combobox__description", children: o.description })) : null] }), o.value === value ? (_jsx("span", { className: "mn-menu__indicator", children: _jsx(CheckGlyph, {}) })) : null] }, o.value)))) }) }) })] }));
+});
+//# sourceMappingURL=combobox.js.map

package/dist/components/forms/combobox/combobox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox.js","sourceRoot":"","sources":["../../../../src/components/forms/combobox/combobox.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EACL,UAAU,EACV,SAAS,EACT,KAAK,EACL,OAAO,EACP,MAAM,EACN,QAAQ,GAIT,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,EAAE,EAAE,MAAM,yBAAyB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAkC1D,MAAM,aAAa,GAAG,CAAC,CAAiB,EAAE,CAAS,EAAE,EAAE,CACrD,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAElD;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAkC,SAAS,QAAQ,CACnF,EACE,OAAO,EACP,KAAK,EAAE,SAAS,EAChB,YAAY,GAAG,IAAI,EACnB,aAAa,EACb,UAAU,EAAE,SAAS,EACrB,kBAAkB,EAClB,MAAM,GAAG,aAAa,EACtB,OAAO,GAAG,KAAK,EACf,YAAY,GAAG,YAAY,EAC3B,OAAO,EACP,IAAI,GAAG,IAAI,EACX,SAAS,GAAG,IAAI,EAChB,WAAW,EACX,SAAS,EACT,SAAS,EACT,MAAM,EACN,GAAG,IAAI,EACR,EACD,GAAG;IAEH,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,MAAM,MAAM,GAAG,eAAe,EAAE,OAAO,CAAC;IACxC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAgB,YAAY,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;IAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACjG,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;IACvE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,CAA0B,IAAI,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE;QAChC,IAAI,SAAS,KAAK,SAAS;YAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACpD,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,IAA2B,EAAE,EAAE;QAC7C,IAAI,SAAS,KAAK,SAAS;YAAE,gBAAgB,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC;QACnE,aAAa,EAAE,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC;QACrC,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC,CAAC;IAEF,iEAAiE;IACjE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,IAAI,SAAS,KAAK,SAAS;YAAE,gBAAgB,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9E,uDAAuD;IACzD,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAEtB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3B,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3D,OAAO,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAClE,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAEnD,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAErB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,aAAa,CAAc,gBAAgB,MAAM,IAAI,CAAC,CAAC;QACnF,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7C,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAEnB,MAAM,QAAQ,GAAG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,QAAQ,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjF,MAAM,SAAS,GAAG,CAAC,CAAkC,EAAE,EAAE;QACvD,yEAAyE;QACzE,uEAAuE;QACvE,MAAM,eAAe,GAAG,CAAC,CAAC,gBAAgB,CAAC;QAC3C,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QACf,IAAI,CAAC,CAAC,gBAAgB,IAAI,CAAC,eAAe;YAAE,OAAO;QACnD,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC;YACd,KAAK,WAAW;gBACd,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;;oBACpB,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC3D,MAAM;YACR,KAAK,SAAS;gBACZ,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;;oBACpB,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC1C,MAAM;YACR,KAAK,MAAM;gBACT,IAAI,IAAI,EAAE,CAAC;oBACT,CAAC,CAAC,cAAc,EAAE,CAAC;oBACnB,SAAS,CAAC,CAAC,CAAC,CAAC;gBACf,CAAC;gBACD,MAAM;YACR,KAAK,KAAK;gBACR,IAAI,IAAI,EAAE,CAAC;oBACT,CAAC,CAAC,cAAc,EAAE,CAAC;oBACnB,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAChC,CAAC;gBACD,MAAM;YACR,KAAK,OAAO;gBACV,IAAI,IAAI,EAAE,CAAC;oBACT,CAAC,CAAC,cAAc,EAAE,CAAC;oBACnB,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;oBAC5B,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ;wBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;gBACxC,CAAC;gBACD,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,IAAI,EAAE,CAAC;oBACT,CAAC,CAAC,cAAc,EAAE,CAAC;oBACnB,OAAO,CAAC,KAAK,CAAC,CAAC;oBACf,QAAQ,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;gBAClC,CAAC;gBACD,MAAM;YACR,KAAK,WAAW;gBACd,IAAI,SAAS,IAAI,UAAU,KAAK,EAAE,IAAI,QAAQ;oBAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC7D,MAAM;QACV,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAEtD,OAAO,CACL,MAAC,gBAAgB,CAAC,IAAI,IACpB,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE;YACrB,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,IAAI,CAAC,IAAI;gBAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC,aAED,KAAC,gBAAgB,CAAC,MAAM,IAAC,OAAO,kBAC9B,eACE,SAAS,EAAE,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,CAAC,eACxC,IAAI,mBACA,UAAU,CAAC,QAAQ,IAAI,SAAS,aAE/C,gBACE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;gCACZ,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;gCACxB,IAAI,OAAO,GAAG,KAAK,UAAU;oCAAE,GAAG,CAAC,IAAI,CAAC,CAAC;qCACpC,IAAI,GAAG;oCAAE,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;4BACnC,CAAC,KACG,UAAU,EACd,IAAI,EAAC,MAAM,EACX,IAAI,EAAC,UAAU,EACf,YAAY,EAAC,KAAK,uBACA,MAAM,mBACT,IAAI,mBACJ,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,2BACjB,QAAQ,EAC/B,SAAS,EAAC,oBAAoB,EAC9B,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;gCACd,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gCACzB,SAAS,CAAC,CAAC,CAAC,CAAC;gCACb,IAAI,CAAC,IAAI;oCAAE,OAAO,CAAC,IAAI,CAAC,CAAC;4BAC3B,CAAC,EACD,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;gCACZ,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;gCACZ,oEAAoE;gCACpE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,aAA4B,CAAC;oCAC5D,QAAQ,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;4BACpC,CAAC,GACD,EACD,OAAO,CAAC,CAAC,CAAC,KAAC,OAAO,IAAC,IAAI,EAAC,IAAI,EAAC,SAAS,EAAC,sBAAsB,GAAG,CAAC,CAAC,CAAC,IAAI,EACxE,iBACE,IAAI,EAAC,QAAQ,EACb,QAAQ,EAAE,CAAC,CAAC,gBACA,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,cAAc,EACnD,SAAS,EAAC,qBAAqB,EAC/B,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAC7B,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,EAAE,EACtC,OAAO,EAAE,GAAG,EAAE;gCACZ,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gCACnB,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;4BAC5B,CAAC,YAED,KAAC,gBAAgB,KAAG,GACb,IACL,GACkB,EAC1B,KAAC,gBAAgB,CAAC,MAAM,cACtB,KAAC,gBAAgB,CAAC,OAAO,IACvB,KAAK,EAAC,OAAO,EACb,UAAU,EAAE,CAAC,EACb,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,EAAE,EAC1C,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,EAAE,EAC3C,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE;wBACvB,IAAI,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAc,CAAC;4BAAE,CAAC,CAAC,cAAc,EAAE,CAAC;oBACvE,CAAC,EACD,SAAS,EAAC,8BAA8B,YAExC,cACE,GAAG,EAAE,OAAO,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,EAAC,SAAS,gBACF,IAAI,CAAC,YAAY,CAAC,IAAI,SAAS,EAC3C,SAAS,EAAC,mBAAmB,YAE5B,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CACjC,cAAK,SAAS,EAAC,qBAAqB,EAAC,IAAI,EAAC,QAAQ,8BAE5C,CACP,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CACzB,cAAK,SAAS,EAAC,qBAAqB,EAAC,IAAI,EAAC,QAAQ,YAC/C,YAAY,GACT,CACP,CAAC,CAAC,CAAC,CACF,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;wBACpB,oEAAoE;wBACpE,0EAA0E;wBAC1E,+GAA+G;wBAC/G,sGAAsG;wBACtG,eAEE,EAAE,EAAE,GAAG,MAAM,QAAQ,CAAC,EAAE,EACxB,IAAI,EAAC,QAAQ,mBACE,CAAC,CAAC,KAAK,KAAK,KAAK,mBACjB,CAAC,CAAC,QAAQ,IAAI,SAAS,gBAC1B,CAAC,sBACK,CAAC,KAAK,MAAM,IAAI,SAAS,EAC3C,SAAS,EAAC,eAAe,EACzB,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAChC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,EAAE,EACtC,OAAO,EAAE,GAAG,EAAE;gCACZ,IAAI,CAAC,CAAC,CAAC,QAAQ;oCAAE,MAAM,CAAC,CAAC,CAAC,CAAC;4BAC7B,CAAC,aAED,gBAAM,SAAS,EAAC,eAAe,aAC5B,CAAC,CAAC,KAAK,EACP,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CACf,eAAM,SAAS,EAAC,0BAA0B,YAAE,CAAC,CAAC,WAAW,GAAQ,CAClE,CAAC,CAAC,CAAC,IAAI,IACH,EACN,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CACnB,eAAM,SAAS,EAAC,oBAAoB,YAClC,KAAC,UAAU,KAAG,GACT,CACR,CAAC,CAAC,CAAC,IAAI,KAxBH,CAAC,CAAC,KAAK,CAyBR,CACP,CAAC,CACH,GACG,GACmB,GACH,IACJ,CACzB,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/components/forms/combobox/index.d.ts

@@ -0,0 +1,2 @@
+export * from './combobox.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/forms/combobox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/forms/combobox/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/components/forms/combobox/index.js

@@ -0,0 +1,2 @@
+export * from './combobox.js';
+//# sourceMappingURL=index.js.map

package/dist/components/forms/combobox/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/forms/combobox/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/components/forms/form-field/form-field.d.ts

@@ -0,0 +1,104 @@
+import { type HTMLAttributes, type LabelHTMLAttributes, type ReactNode, type SelectHTMLAttributes } from 'react';
+interface FieldContextValue {
+    controlId: string;
+    labelId: string;
+    descriptionId: string;
+    errorId: string;
+    invalid: boolean;
+    required: boolean;
+    disabled: boolean;
+    hasDescription: boolean;
+    hasError: boolean;
+    register: (part: 'description' | 'error', present: boolean) => void;
+}
+export interface FieldProps extends HTMLAttributes<HTMLDivElement> {
+    /** Override the generated control id (e.g. to match an existing label). */
+    id?: string;
+    invalid?: boolean;
+    required?: boolean;
+    disabled?: boolean;
+    /**
+     * `stack` (default): label, control, help and error in a column.
+     * `row`: label and help on the left, the control on the right, for a
+     * Switch (or Checkbox, or a compact NativeSelect) with a description.
+     * Exposed as `data-layout="row"`.
+     */
+    layout?: 'stack' | 'row';
+    children: ReactNode;
+}
+/**
+ * Groups a label, a control, help text and an error message, and wires their
+ * ids together: the control gets `id`, `aria-describedby`, `aria-invalid`,
+ * `aria-required` and `disabled` automatically. Descriptions and errors
+ * register themselves, so `aria-describedby` only names elements that exist.
+ *
+ *   <Field invalid={!!error}>
+ *     <FieldLabel>Email</FieldLabel>
+ *     <Input type="email" />
+ *     <FieldError>{error}</FieldError>
+ *   </Field>
+ */
+export declare function Field({ id, invalid, required, disabled, layout, className, children, ...rest }: FieldProps): import("react").JSX.Element;
+export declare function useFieldContext(): FieldContextValue | null;
+export interface FieldControlProps {
+    id?: string | undefined;
+    disabled?: boolean | undefined;
+    required?: boolean | undefined;
+    'aria-describedby'?: string | undefined;
+    'aria-invalid'?: boolean | 'true' | 'false' | 'grammar' | 'spelling' | undefined;
+}
+/**
+ * Merges Field context into a control's props. Explicit props win, so a
+ * control can still be used outside a Field.
+ */
+export declare function useFieldControl<P extends FieldControlProps>(props: P, options?: {
+    invalid?: boolean | undefined;
+}): P & {
+    'aria-required'?: true;
+    'aria-invalid'?: true;
+};
+export interface FieldLabelProps extends LabelHTMLAttributes<HTMLLabelElement> {
+    /** Text shown after the label for optional fields, e.g. "Optional". */
+    optionalText?: string;
+}
+export declare const FieldLabel: import("react").ForwardRefExoticComponent<FieldLabelProps & import("react").RefAttributes<HTMLLabelElement>>;
+export declare function FieldDescription({ className, ...rest }: HTMLAttributes<HTMLParagraphElement>): import("react").JSX.Element;
+/**
+ * Renders nothing when empty, so it can always be present. Announced politely
+ * when it appears.
+ */
+export declare function FieldError({ className, children, ...rest }: HTMLAttributes<HTMLParagraphElement>): import("react").JSX.Element | null;
+export interface NativeSelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface NativeSelectProps extends Omit<SelectHTMLAttributes<HTMLSelectElement>, 'size'> {
+    /** Control height. `sm` is the compact toolbar size (`--mn-control-sm`). Default `md`. */
+    size?: 'sm' | 'md' | 'lg';
+    /** Marks the value invalid. Inside a Field, the Field's `invalid` is used. */
+    invalid?: boolean;
+    /** Options as data. `children` (`<option>`, `<optgroup>`) are rendered after them. */
+    options?: readonly NativeSelectOption[];
+    /**
+     * First, empty option shown while no value is chosen. It is disabled once
+     * the control is `required`, so it cannot be submitted.
+     */
+    placeholder?: string;
+    /**
+     * Visible label rendered inline before the select, for toolbars and filter
+     * rows outside a Field ("Sort  Newest ▾"). Inside a Field use FieldLabel.
+     */
+    label?: ReactNode;
+    /** Class for the wrapper `<span class="mn-native-select">`; `className` goes on the `<select>`. */
+    wrapperClassName?: string;
+}
+/**
+ * The platform `<select>`, styled like Input and wired to Field. Use it where
+ * the native picker is right: long option lists on mobile, forms that must
+ * work without JavaScript, compact toolbar filters. For a styled listbox use
+ * Select; for search use Combobox.
+ */
+export declare const NativeSelect: import("react").ForwardRefExoticComponent<NativeSelectProps & import("react").RefAttributes<HTMLSelectElement>>;
+export {};
+//# sourceMappingURL=form-field.d.ts.map

package/dist/components/forms/form-field/form-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-field.d.ts","sourceRoot":"","sources":["../../../../src/components/forms/form-field/form-field.tsx"],"names":[],"mappings":"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"}