@starci/grammar 0.4.12 → 0.5.0

package/dist/core/branch/Toast/index.js

@@ -0,0 +1,145 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Spinner as HeroSpinner } from "@heroui/react";
+import { useEffect, useRef, useState, useSyncExternalStore } from "react";
+import { Button } from "../../primitive/Button/index.js";
+import { CloseButton } from "../../primitive/CloseButton/index.js";
+export const DEFAULT_TOAST_TIMEOUT = 6000;
+/** Resolve the effective auto-dismiss delay; `0` means the toast persists. */
+export const toastTimeoutFor = (toast) => {
+    if (toast.timeout !== undefined)
+        return Math.max(0, toast.timeout);
+    if (toast.action !== undefined || toast.tone === "negative" || toast.tone === "pending")
+        return 0;
+    return DEFAULT_TOAST_TIMEOUT;
+};
+/** Create an isolated toast queue (one per app shell, or per test). */
+export const createToastQueue = () => {
+    let toasts = [];
+    let sequence = 0;
+    const listeners = new Set();
+    const emit = () => { for (const listener of listeners)
+        listener(); };
+    return {
+        add: (options) => {
+            sequence += 1;
+            const id = `grammar-toast-${sequence}`;
+            toasts = [{ ...options, id, version: 0 }, ...toasts];
+            emit();
+            return id;
+        },
+        update: (id, options) => {
+            toasts = toasts.map((toast) => toast.id === id ? { ...toast, ...options, id, version: toast.version + 1 } : toast);
+            emit();
+        },
+        dismiss: (id) => {
+            const next = toasts.filter((toast) => toast.id !== id);
+            if (next.length === toasts.length)
+                return;
+            toasts = next;
+            emit();
+        },
+        clear: () => {
+            if (toasts.length === 0)
+                return;
+            toasts = [];
+            emit();
+        },
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => { listeners.delete(listener); };
+        },
+        getSnapshot: () => toasts,
+    };
+};
+/** The shared app-wide queue a `Toaster` reads when no `queue` prop is given. */
+export const toastQueue = createToastQueue();
+/**
+ * BRANCH - `Toast`: one transient notification, rendered by `Toaster`.
+ *
+ * Escape dismisses a focused toast. The timer counts only while not paused, and restarts when the
+ * toast is updated. Tone is echoed on `data-grammar-tone`.
+ * Contract: A11Y-4 (decisions never time out) FOCUS-5 (Escape = close button) CORE-BOUNDARY-4 MOTION-2.
+ */
+export const Toast = ({ toast, dismissLabel, onDismiss, isPaused = false }) => {
+    const tone = toast.tone ?? "neutral";
+    const timeout = toastTimeoutFor(toast);
+    const remaining = useRef(timeout);
+    const seenVersion = useRef(toast.version);
+    const dismissRef = useRef(onDismiss);
+    dismissRef.current = onDismiss;
+    useEffect(() => {
+        if (seenVersion.current !== toast.version) {
+            seenVersion.current = toast.version;
+            remaining.current = timeout;
+        }
+        if (isPaused || timeout <= 0)
+            return;
+        const startedAt = Date.now();
+        const handle = setTimeout(() => dismissRef.current(), Math.max(0, remaining.current));
+        return () => {
+            clearTimeout(handle);
+            remaining.current -= Date.now() - startedAt;
+        };
+    }, [isPaused, timeout, toast.version]);
+    const onKeyDown = (event) => {
+        if (event.key !== "Escape")
+            return;
+        event.stopPropagation();
+        onDismiss();
+    };
+    return (_jsxs("div", { "data-tier": "branch", "data-component": "Toast", "data-grammar-tone": tone, "data-grammar-overlay-surface": "toast", "data-persistent": timeout <= 0 ? "true" : "false", "data-contract": "A11Y-4 FOCUS-5 CORE-BOUNDARY-4 MOTION-2", className: "starci-core-toast", onKeyDown: onKeyDown, children: [tone === "pending" ? (_jsx("span", { className: "starci-core-toast-indicator", "aria-hidden": "true", "data-contract": "ICON-6", children: _jsx(HeroSpinner, { role: "presentation", "aria-hidden": "true", size: "sm", color: "current" }) })) : _jsx("span", { className: "starci-core-toast-indicator", "data-grammar-toast-indicator": tone, "aria-hidden": "true", "data-contract": "ICON-6" }), _jsxs("div", { className: "starci-core-toast-copy", children: [_jsx("p", { className: "starci-core-toast-title", children: toast.title }), toast.description === undefined ? null : _jsx("p", { className: "starci-core-toast-description", children: toast.description })] }), toast.action === undefined ? null : (_jsx("span", { className: "starci-core-toast-action", "data-grammar-toast-action": "true", children: _jsx(Button, { size: "sm", variant: "secondary", onPress: () => {
+                        toast.action?.onAction();
+                        onDismiss();
+                    }, children: toast.action.label }) })), _jsx(CloseButton, { label: dismissLabel, size: "sm", onPress: onDismiss })] }));
+};
+const announcementFor = (toast) => (toast.description === undefined ? toast.title : `${toast.title}. ${toast.description}`);
+const usePageHidden = () => {
+    const [hidden, setHidden] = useState(false);
+    useEffect(() => {
+        const update = () => setHidden(document.visibilityState === "hidden");
+        update();
+        document.addEventListener("visibilitychange", update);
+        return () => document.removeEventListener("visibilitychange", update);
+    }, []);
+    return hidden;
+};
+/**
+ * BRANCH - `Toaster`: the fixed notification region that renders a toast queue.
+ *
+ * Mount it ONCE inside the app's `GrammarRoot`: it is rendered in place (no portal), so it is always
+ * inside the family scope that mounted it. Announcements go through two persistent, visually hidden
+ * live regions (polite `role="status"`, assertive `role="alert"`) that exist before any toast
+ * arrives; the visible toasts are a labelled region of ordinary, keyboard-reachable content.
+ * Contract: region LAYOUT-4 (fixed); each live region FEEDBACK-3 (one announcement owner per urgency).
+ */
+export const Toaster = ({ label, dismissLabel, queue = toastQueue, placement = "bottom-end", maxVisible = 3 }) => {
+    const toasts = useSyncExternalStore(queue.subscribe, queue.getSnapshot, queue.getSnapshot);
+    const [isHovered, setIsHovered] = useState(false);
+    const [hasFocus, setHasFocus] = useState(false);
+    const pageHidden = usePageHidden();
+    const [polite, setPolite] = useState("");
+    const [assertive, setAssertive] = useState("");
+    const announced = useRef(new Map());
+    const visible = toasts.slice(0, Math.max(1, maxVisible));
+    const isPaused = isHovered || hasFocus || pageHidden;
+    useEffect(() => {
+        const seen = announced.current;
+        for (const toast of [...visible].reverse()) {
+            if (seen.get(toast.id) === toast.version)
+                continue;
+            seen.set(toast.id, toast.version);
+            if (toast.tone === "negative")
+                setAssertive(announcementFor(toast));
+            else
+                setPolite(announcementFor(toast));
+        }
+        for (const id of seen.keys())
+            if (!toasts.some((toast) => toast.id === id))
+                seen.delete(id);
+    });
+    return (_jsxs("section", { "data-tier": "branch", "data-component": "Toaster", "data-placement": placement, "data-paused": isPaused ? "true" : "false", "data-contract": "LAYOUT-4", "aria-label": label, className: "starci-core-toaster", onPointerEnter: () => setIsHovered(true), onPointerLeave: () => setIsHovered(false), onFocus: () => setHasFocus(true), onBlur: (event) => {
+            if (!event.currentTarget.contains(event.relatedTarget))
+                setHasFocus(false);
+        }, children: [_jsx("span", { role: "status", "aria-live": "polite", "aria-atomic": "true", className: "starci-core-visually-hidden", "data-grammar-toaster-live": "polite", "data-contract": "FEEDBACK-3", children: polite }), _jsx("span", { role: "alert", "aria-live": "assertive", "aria-atomic": "true", className: "starci-core-visually-hidden", "data-grammar-toaster-live": "assertive", "data-contract": "FEEDBACK-3", children: assertive }), _jsx("ol", { className: "starci-core-toaster-list", children: visible.map((toast) => (_jsx("li", { className: "starci-core-toaster-item", children: _jsx(Toast, { toast: toast, dismissLabel: dismissLabel, isPaused: isPaused, onDismiss: () => queue.dismiss(toast.id) }) }, toast.id))) })] }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/branch/Toast/index.js.map

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

package/dist/core/composite/Alert/index.d.ts

@@ -0,0 +1,40 @@
+import { type ReactNode } from "react";
+import type { PresentationState } from "../../../common/state.js";
+export type AlertUrgency = "polite" | "assertive";
+export type AlertAction = {
+    readonly label: string;
+    readonly onAction: () => void;
+};
+type AlertBase = {
+    readonly title: string;
+    readonly description?: ReactNode;
+    /** Render-neutral meaning of the banner. Default `informative`. */
+    readonly tone?: PresentationState;
+    readonly action?: AlertAction;
+    /**
+     * How the banner is announced when it appears. Default: `assertive` (`role="alert"`) for a
+     * `negative` tone, `polite` (`role="status"`) for everything else.
+     */
+    readonly urgency?: AlertUrgency;
+};
+/** A dismissible banner must name its close action; a permanent one has neither prop. */
+type Dismissible = {
+    readonly dismissLabel: string;
+    readonly onDismiss?: () => void;
+};
+type Permanent = {
+    readonly dismissLabel?: never;
+    readonly onDismiss?: never;
+};
+export type AlertProps = AlertBase & (Dismissible | Permanent);
+/**
+ * COMPOSITE - `Alert`: an inline, in-flow banner about the region it sits in.
+ *
+ * It is not an overlay: it takes layout space and stays until resolved or dismissed. Dismissal is
+ * uncontrolled (the banner removes itself) and `onDismiss` reports it. Tone is echoed on
+ * `data-grammar-tone`; the vendor status supplies the default glyph, `pending` swaps it for a spinner.
+ * Contract: root FEEDBACK-3 (status/alert urgency on the owner); actions FEEDBACK-2 (recovery in place).
+ */
+export declare const Alert: (props: AlertProps) => import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/core/composite/Alert/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composite/Alert/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAKjE,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAA;AAEjD,MAAM,MAAM,WAAW,GAAG;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;CAChC,CAAA;AAED,KAAK,SAAS,GAAG;IACb,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAA;IAChC,mEAAmE;IACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAClC,CAAA;AAED,yFAAyF;AACzF,KAAK,WAAW,GAAG;IACf,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CAClC,CAAA;AAED,KAAK,SAAS,GAAG;IACb,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC,CAAA;AAE9D;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,UAAU,uCA2CtC,CAAA"}

package/dist/core/composite/Alert/index.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Alert as HeroAlert, Spinner as HeroSpinner } from "@heroui/react";
+import { useState } from "react";
+import { vendorStatusFor } from "../../overlayScope.js";
+import { Button } from "../../primitive/Button/index.js";
+import { CloseButton } from "../../primitive/CloseButton/index.js";
+/**
+ * COMPOSITE - `Alert`: an inline, in-flow banner about the region it sits in.
+ *
+ * It is not an overlay: it takes layout space and stays until resolved or dismissed. Dismissal is
+ * uncontrolled (the banner removes itself) and `onDismiss` reports it. Tone is echoed on
+ * `data-grammar-tone`; the vendor status supplies the default glyph, `pending` swaps it for a spinner.
+ * Contract: root FEEDBACK-3 (status/alert urgency on the owner); actions FEEDBACK-2 (recovery in place).
+ */
+export const Alert = (props) => {
+    const { title, description, tone = "informative", action, urgency } = props;
+    const [isDismissed, setIsDismissed] = useState(false);
+    if (isDismissed)
+        return null;
+    const resolvedUrgency = urgency ?? (tone === "negative" ? "assertive" : "polite");
+    const dismiss = () => {
+        setIsDismissed(true);
+        props.onDismiss?.();
+    };
+    return (_jsxs(HeroAlert, { "data-tier": "composite", "data-component": "Alert", "data-grammar-tone": tone, "data-urgency": resolvedUrgency, "data-contract": "FEEDBACK-3", role: resolvedUrgency === "assertive" ? "alert" : "status", status: vendorStatusFor(tone), className: "starci-core-alert", children: [_jsx(HeroAlert.Indicator, { className: "starci-core-alert-indicator", children: tone === "pending" ? _jsx(HeroSpinner, { "aria-hidden": "true", role: "presentation", size: "sm", color: "current" }) : undefined }), _jsxs(HeroAlert.Content, { className: "starci-core-alert-content", children: [_jsx(HeroAlert.Title, { className: "starci-core-alert-title", children: title }), description === undefined ? null : (_jsx(HeroAlert.Description, { className: "starci-core-alert-description", children: description }))] }), action === undefined && props.dismissLabel === undefined ? null : (_jsxs("span", { className: "starci-core-alert-actions", "data-grammar-alert-actions": "true", "data-contract": "FEEDBACK-2", children: [action === undefined ? null : (_jsx(Button, { size: "sm", variant: "secondary", onPress: action.onAction, children: action.label })), props.dismissLabel === undefined ? null : (_jsx(CloseButton, { label: props.dismissLabel, size: "sm", onPress: dismiss }))] }))] }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/composite/Alert/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composite/Alert/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAA;AAC1E,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAA;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAA;AAmClE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAiB,EAAE,EAAE;IACvC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,GAAG,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAA;IAC3E,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACrD,IAAI,WAAW;QAAE,OAAO,IAAI,CAAA;IAE5B,MAAM,eAAe,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IACjF,MAAM,OAAO,GAAG,GAAG,EAAE;QACjB,cAAc,CAAC,IAAI,CAAC,CAAA;QACpB,KAAK,CAAC,SAAS,EAAE,EAAE,CAAA;IACvB,CAAC,CAAA;IAED,OAAO,CACH,MAAC,SAAS,iBACI,WAAW,oBACN,OAAO,uBACH,IAAI,kBACT,eAAe,mBACf,YAAY,EAC1B,IAAI,EAAE,eAAe,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAC1D,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,EAC7B,SAAS,EAAC,mBAAmB,aAE7B,KAAC,SAAS,CAAC,SAAS,IAAC,SAAS,EAAC,6BAA6B,YACvD,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAC,WAAW,mBAAa,MAAM,EAAC,IAAI,EAAC,cAAc,EAAC,IAAI,EAAC,IAAI,EAAC,KAAK,EAAC,SAAS,GAAG,CAAC,CAAC,CAAC,SAAS,GAChG,EACtB,MAAC,SAAS,CAAC,OAAO,IAAC,SAAS,EAAC,2BAA2B,aACpD,KAAC,SAAS,CAAC,KAAK,IAAC,SAAS,EAAC,yBAAyB,YAAE,KAAK,GAAmB,EAC7E,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAChC,KAAC,SAAS,CAAC,WAAW,IAAC,SAAS,EAAC,+BAA+B,YAAE,WAAW,GAAyB,CACzG,IACe,EACnB,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC/D,gBAAM,SAAS,EAAC,2BAA2B,gCAA4B,MAAM,mBAAe,YAAY,aACnG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC3B,KAAC,MAAM,IAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAC,WAAW,EAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,YAAG,MAAM,CAAC,KAAK,GAAU,CAC1F,EACA,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACvC,KAAC,WAAW,IAAC,KAAK,EAAE,KAAK,CAAC,YAAY,EAAE,IAAI,EAAC,IAAI,EAAC,OAAO,EAAE,OAAO,GAAI,CACzE,IACE,CACV,IACO,CACf,CAAA;AACL,CAAC,CAAA"}

package/dist/core/composite/AvatarGroup/index.d.ts

@@ -0,0 +1,23 @@
+import { type AvatarSize } from "../../primitive/Avatar/index.js";
+export type AvatarGroupItem = {
+    readonly id: string;
+    readonly name: string;
+    readonly src?: string;
+};
+export type AvatarGroupProps = {
+    /** Names the group, e.g. who is in a space. */
+    readonly label: string;
+    readonly items: ReadonlyArray<AvatarGroupItem>;
+    /** Visible avatars before the rest collapse into an overflow count. */
+    readonly max?: number;
+    readonly size?: AvatarSize;
+    /** App-owned accessible text for the overflow count, e.g. "3 more people". */
+    readonly overflowLabel: (hiddenCount: number) => string;
+    readonly className?: string;
+};
+/**
+ * A stacked set of avatars with one accessible overflow count.
+ * Contract: each avatar ICON-6 MEDIA-5 (named once, initials fallback), count ICON-6 (named, digits silent).
+ */
+export declare const AvatarGroup: ({ label, items, max, size, overflowLabel, className }: AvatarGroupProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/composite/AvatarGroup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composite/AvatarGroup/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAG/F,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;IAC9C,uEAAuE;IACvE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAA;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAA;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,uDAAkE,gBAAgB,gCAiC7G,CAAA"}

package/dist/core/composite/AvatarGroup/index.js

@@ -0,0 +1,15 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Avatar as HeroAvatar, AvatarGroup as HeroAvatarGroup } from "@heroui/react";
+import { avatarA11yProps, avatarParts } from "../../primitive/Avatar/index.js";
+import { navigationClassName } from "../../navigationClassNames.js";
+/**
+ * A stacked set of avatars with one accessible overflow count.
+ * Contract: each avatar ICON-6 MEDIA-5 (named once, initials fallback), count ICON-6 (named, digits silent).
+ */
+export const AvatarGroup = ({ label, items, max = 4, size = "md", overflowLabel, className }) => {
+    const visible = items.slice(0, Math.max(0, max));
+    const hidden = items.length - visible.length;
+    return (_jsxs(HeroAvatarGroup, { "aria-label": label, className: navigationClassName("starci-core-avatar-group", className), "data-component": "AvatarGroup", "data-tier": "composite", "data-grammar-avatar-overflow": hidden > 0 ? "true" : "false", overlap: "ring", role: "group", size: size, children: [visible.map((item) => (_jsx(HeroAvatar, { ...avatarA11yProps(item.name, false), className: "starci-core-avatar", "data-component": "Avatar", "data-contract": "ICON-6 MEDIA-5", "data-grammar-avatar-size": size, children: avatarParts(item.name, item.src, undefined) }, item.id))), hidden > 0 ? (_jsx(HeroAvatarGroup.Count, { "aria-label": overflowLabel(hidden), "data-contract": "ICON-6", "data-grammar-avatar-count": "true", role: "img", children: _jsx("span", { "aria-hidden": "true", children: `+${hidden}` }) })) : null] }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/composite/AvatarGroup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composite/AvatarGroup/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,eAAe,CAAA;AACpF,OAAO,EAAE,eAAe,EAAE,WAAW,EAAmB,MAAM,iCAAiC,CAAA;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAoBnE;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,aAAa,EAAE,SAAS,EAAoB,EAAE,EAAE;IAC9G,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAC5C,OAAO,CACH,MAAC,eAAe,kBACA,KAAK,EACjB,SAAS,EAAE,mBAAmB,CAAC,0BAA0B,EAAE,SAAS,CAAC,oBACtD,aAAa,eAClB,WAAW,kCACS,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAC3D,OAAO,EAAC,MAAM,EACd,IAAI,EAAC,OAAO,EACZ,IAAI,EAAE,IAAI,aAET,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,KAAC,UAAU,OAEH,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EACrC,SAAS,EAAC,oBAAoB,oBACf,QAAQ,mBACT,gBAAgB,8BACJ,IAAI,YAE7B,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,IAPvC,IAAI,CAAC,EAAE,CAQH,CAChB,CAAC,EACD,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CACV,KAAC,eAAe,CAAC,KAAK,kBAAa,aAAa,CAAC,MAAM,CAAC,mBAAgB,QAAQ,+BAA2B,MAAM,EAAC,IAAI,EAAC,KAAK,YACxH,8BAAkB,MAAM,YAAE,IAAI,MAAM,EAAE,GAAQ,GAC1B,CAC3B,CAAC,CAAC,CAAC,IAAI,IACM,CACrB,CAAA;AACL,CAAC,CAAA"}

package/dist/core/composite/Breadcrumbs/index.d.ts

@@ -0,0 +1,27 @@
+import type { ReactNode } from "react";
+export type BreadcrumbItem = {
+    readonly id: string;
+    readonly label: string;
+    /** Ancestors carry a destination; the last item is the current page and needs none. */
+    readonly href?: string;
+    readonly leading?: ReactNode;
+};
+export type BreadcrumbsProps = {
+    /** Names the trail landmark, e.g. "Breadcrumb". */
+    readonly label: string;
+    readonly items: ReadonlyArray<BreadcrumbItem>;
+    /** Decorative separator; defaults to the vendor chevron. */
+    readonly separator?: ReactNode;
+    /** Same-document navigation for router-owned trails. */
+    readonly onAction?: (id: string) => void;
+    readonly className?: string;
+};
+/**
+ * The hierarchical trail to the current page.
+ *
+ * The last item is the current page (`aria-current="page"`, not a link). At narrow widths the trail
+ * keeps one line and scrolls instead of wrapping, and long ancestor labels truncate.
+ * Contract: nav LAYOUT-3 OVERFLOW-3 (owns its inline scroll), item ACTION-3 (link vs current), leading ICON-6.
+ */
+export declare const Breadcrumbs: ({ label, items, separator, onAction, className }: BreadcrumbsProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/composite/Breadcrumbs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composite/Breadcrumbs/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,MAAM,MAAM,cAAc,GAAG;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,uFAAuF;IACvF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;IAC7C,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,kDAAkD,gBAAgB,gCAoC7F,CAAA"}

package/dist/core/composite/Breadcrumbs/index.js

@@ -0,0 +1,16 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Breadcrumbs as HeroBreadcrumbs } from "@heroui/react";
+import { navigationClassName } from "../../navigationClassNames.js";
+/**
+ * The hierarchical trail to the current page.
+ *
+ * The last item is the current page (`aria-current="page"`, not a link). At narrow widths the trail
+ * keeps one line and scrolls instead of wrapping, and long ancestor labels truncate.
+ * Contract: nav LAYOUT-3 OVERFLOW-3 (owns its inline scroll), item ACTION-3 (link vs current), leading ICON-6.
+ */
+export const Breadcrumbs = ({ label, items, separator, onAction, className }) => (_jsx("nav", { "aria-label": label, className: navigationClassName("starci-core-breadcrumbs", className), "data-component": "Breadcrumbs", "data-contract": "LAYOUT-3 OVERFLOW-3", "data-tier": "composite", children: _jsx(HeroBreadcrumbs, { className: "starci-core-breadcrumbs-list", ...(separator === undefined ? {} : { separator }), ...(onAction === undefined ? {} : { onAction: (key) => onAction(String(key)) }), children: items.map((item, index) => {
+            const isCurrent = index === items.length - 1;
+            return (_jsx(HeroBreadcrumbs.Item, { id: item.id, className: "starci-core-breadcrumb", "data-contract": "ACTION-3", ...(item.href === undefined || isCurrent ? {} : { href: item.href }), children: _jsxs("span", { className: "starci-core-breadcrumb-label", "data-grammar-breadcrumb": "true", "data-grammar-current": isCurrent ? "true" : "false", children: [item.leading === undefined ? null : _jsx("span", { "aria-hidden": "true", className: "starci-core-breadcrumb-leading", "data-contract": "ICON-6", children: item.leading }), item.label] }) }, item.id));
+        }) }) }));
+//# sourceMappingURL=index.js.map

package/dist/core/composite/Breadcrumbs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composite/Breadcrumbs/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,eAAe,CAAA;AAE9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAqBnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAoB,EAAE,EAAE,CAAC,CAC/F,4BACgB,KAAK,EACjB,SAAS,EAAE,mBAAmB,CAAC,yBAAyB,EAAE,SAAS,CAAC,oBACrD,aAAa,mBACd,qBAAqB,eACzB,WAAW,YAErB,KAAC,eAAe,IACZ,SAAS,EAAC,8BAA8B,KACpC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,KAC9C,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAoB,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,YAEhG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,SAAS,GAAG,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;YAC5C,OAAO,CACH,KAAC,eAAe,CAAC,IAAI,IAEjB,EAAE,EAAE,IAAI,CAAC,EAAE,EACX,SAAS,EAAC,wBAAwB,mBACpB,UAAU,KACpB,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,YAErE,gBACI,SAAS,EAAC,8BAA8B,6BAChB,MAAM,0BACR,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,aAEjD,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,8BAAkB,MAAM,EAAC,SAAS,EAAC,gCAAgC,mBAAe,QAAQ,YAAE,IAAI,CAAC,OAAO,GAAQ,EACpJ,IAAI,CAAC,KAAK,IACR,IAbF,IAAI,CAAC,EAAE,CAcO,CAC1B,CAAA;QACL,CAAC,CAAC,GACY,GAChB,CACT,CAAA"}

package/dist/core/composite/ButtonGroup/index.d.ts

@@ -0,0 +1,14 @@
+import { type ReactNode } from "react";
+export type ButtonGroupProps = {
+    /** Names the group (`role="group"`) for assistive technology. */
+    readonly label: string;
+    /** Grammar `Button`s (or `IconButton`s). They join visually and keep their own names. */
+    readonly children: ReactNode;
+    readonly orientation?: "horizontal" | "vertical";
+    /** Disables every Grammar Button and IconButton in the group. */
+    readonly isDisabled?: boolean;
+    readonly width?: "content" | "fill";
+};
+/** Related actions joined into one visual unit. Each button stays its own tab stop. */
+export declare const ButtonGroup: ({ label, children, orientation, isDisabled, width }: ButtonGroupProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/composite/ButtonGroup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composite/ButtonGroup/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAA0C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAI9E,MAAM,MAAM,gBAAgB,GAAG;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IAChD,iEAAiE;IACjE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;CACtC,CAAA;AAaD,uFAAuF;AACvF,eAAO,MAAM,WAAW,GAAI,qDAAwF,gBAAgB,gCAgBnI,CAAA"}

package/dist/core/composite/ButtonGroup/index.js

@@ -0,0 +1,17 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ButtonGroup as HeroButtonGroup } from "@heroui/react";
+import { Children, cloneElement, isValidElement } from "react";
+import { Button } from "../../primitive/Button/index.js";
+import { IconButton } from "../../primitive/IconButton/index.js";
+/*
+ * Grammar Button always states its own `isDisabled`, so the vendor group's disabled context (read
+ * only when a button leaves the prop unset) never reaches it. A disabled group therefore hands the
+ * state to its direct Grammar action children itself.
+ */
+const disableActions = (children) => Children.map(children, (child) => (isValidElement(child) && (child.type === Button || child.type === IconButton)
+    ? cloneElement(child, { isDisabled: true })
+    : child));
+/** Related actions joined into one visual unit. Each button stays its own tab stop. */
+export const ButtonGroup = ({ label, children, orientation = "horizontal", isDisabled = false, width = "content" }) => (_jsx(HeroButtonGroup, { "data-tier": "composite", "data-component": "ButtonGroup", "data-contract": "FOCUS-2 TRUTH-2", "data-grammar-orientation": orientation, "data-grammar-disabled": isDisabled ? "true" : "false", "data-width": width, "aria-label": label, orientation: orientation, isDisabled: isDisabled, fullWidth: width === "fill", className: "starci-core-button-group", children: isDisabled ? disableActions(children) : children }));
+//# sourceMappingURL=index.js.map

package/dist/core/composite/ButtonGroup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composite/ButtonGroup/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAkB,MAAM,OAAO,CAAA;AAC9E,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAA;AAahE;;;;GAIG;AACH,MAAM,cAAc,GAAG,CAAC,QAAmB,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAC9E,cAAc,CAAoC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;IAC5G,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC,CAAC,KAAK,CACd,CAAC,CAAA;AAEF,uFAAuF;AACvF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,GAAG,YAAY,EAAE,UAAU,GAAG,KAAK,EAAE,KAAK,GAAG,SAAS,EAAoB,EAAE,EAAE,CAAC,CACrI,KAAC,eAAe,iBACF,WAAW,oBACN,aAAa,mBACd,iBAAiB,8BACL,WAAW,2BACd,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,gBACxC,KAAK,gBACL,KAAK,EACjB,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,KAAK,KAAK,MAAM,EAC3B,SAAS,EAAC,0BAA0B,YAEnC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,GACnC,CACrB,CAAA"}

package/dist/core/composite/CheckboxGroup/index.d.ts

@@ -0,0 +1,23 @@
+import type { ReactNode } from "react";
+import { type FieldControlProps } from "../../primitive/Field/index.js";
+/** One option in a choice group. */
+export type ChoiceOption = {
+    readonly value: string;
+    readonly label: ReactNode;
+    readonly description?: ReactNode;
+    readonly isDisabled?: boolean;
+};
+export type ChoiceOrientation = "vertical" | "horizontal";
+export type CheckboxGroupProps = FieldControlProps & {
+    readonly options: ReadonlyArray<ChoiceOption>;
+    readonly value?: ReadonlyArray<string>;
+    readonly defaultValue?: ReadonlyArray<string>;
+    readonly onValueChange?: (value: Array<string>) => void;
+    readonly orientation?: ChoiceOrientation;
+};
+/**
+ * Several independent choices under one group name (`role="group"`, labelled by the group label).
+ * Required means "at least one", validated by the vendor; the group owns the one error slot.
+ */
+export declare const CheckboxGroup: ({ options, value, defaultValue, onValueChange, orientation, ...field }: CheckboxGroupProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/composite/CheckboxGroup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composite/CheckboxGroup/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,gCAAgC,CAAA;AAGvC,oCAAoC;AACpC,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAA;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,YAAY,CAAA;AAEzD,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG;IACjD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAA;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAA;CAC3C,CAAA;AAcD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,wEAO3B,kBAAkB,gCA6BpB,CAAA"}

package/dist/core/composite/CheckboxGroup/index.js

@@ -0,0 +1,21 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Checkbox as HeroCheckbox, CheckboxGroup as HeroCheckboxGroup } from "@heroui/react";
+import { FieldDescription, FieldErrorText, FieldLabel, vendorFieldProps, } from "../../primitive/Field/index.js";
+import { CheckboxItem } from "../../primitive/Checkbox/index.js";
+/*
+ * Consumer hook: `starci-core-choice-group` names this control's root for a consumer or family
+ * stylesheet. No shipped sheet paints it: the root is drawn as a whole by `.starci-core-field`, so
+ * a rule on the hook adds to the shared anatomy and never has to replace it.
+ */
+/*
+ * Consumer hook: `starci-core-checkbox` names each option's root for a consumer or family
+ * stylesheet. No shipped sheet paints it: the root is drawn as a whole by `.starci-core-choice`, so
+ * a rule on the hook adds to the shared anatomy and never has to replace it.
+ */
+/**
+ * Several independent choices under one group name (`role="group"`, labelled by the group label).
+ * Required means "at least one", validated by the vendor; the group owns the one error slot.
+ */
+export const CheckboxGroup = ({ options, value, defaultValue, onValueChange, orientation = "vertical", ...field }) => (_jsxs(HeroCheckboxGroup, { "data-tier": "composite", "data-component": "CheckboxGroup", "data-contract": "A11Y-1 FIELD-1 FIELD-2 CONTROL-STATE-3", "data-grammar-orientation": orientation, className: "starci-core-field starci-core-choice-group", ...vendorFieldProps(field), isReadOnly: field.isReadOnly === true, ...(value === undefined ? defaultValue === undefined ? {} : { defaultValue: [...defaultValue] } : { value: [...value] }), ...(onValueChange === undefined ? {} : { onChange: onValueChange }), children: [_jsx(FieldLabel, { isHidden: field.isLabelHidden, isRequired: field.isRequired, children: field.label }), _jsx(FieldDescription, { children: field.description }), _jsx("div", { className: "starci-core-choice-group-options", "data-grammar-field-control": "true", children: options.map((option) => (_jsx(HeroCheckbox, { value: option.value, isDisabled: option.isDisabled === true, className: "starci-core-choice starci-core-checkbox", "data-grammar-option": "true", children: _jsx(CheckboxItem, { label: option.label, description: option.description, isStandalone: false }) }, option.value))) }), _jsx(FieldErrorText, { children: field.errorMessage })] }));
+//# sourceMappingURL=index.js.map

package/dist/core/composite/CheckboxGroup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composite/CheckboxGroup/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAE5F,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,gBAAgB,GAEnB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAoBhE;;;;GAIG;AAEH;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAC1B,OAAO,EACP,KAAK,EACL,YAAY,EACZ,aAAa,EACb,WAAW,GAAG,UAAU,EACxB,GAAG,KAAK,EACS,EAAE,EAAE,CAAC,CACtB,MAAC,iBAAiB,iBACJ,WAAW,oBACN,eAAe,mBAChB,wCAAwC,8BAC5B,WAAW,EACrC,SAAS,EAAC,4CAA4C,KAClD,gBAAgB,CAAC,KAAK,CAAC,EAC3B,UAAU,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,KACjC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,KACrH,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,aAEpE,KAAC,UAAU,IAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,YAAG,KAAK,CAAC,KAAK,GAAc,EACnG,KAAC,gBAAgB,cAAE,KAAK,CAAC,WAAW,GAAoB,EACxD,cAAK,SAAS,EAAC,kCAAkC,gCAA4B,MAAM,YAC9E,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACrB,KAAC,YAAY,IAET,KAAK,EAAE,MAAM,CAAC,KAAK,EACnB,UAAU,EAAE,MAAM,CAAC,UAAU,KAAK,IAAI,EACtC,SAAS,EAAC,yCAAyC,yBAC/B,MAAM,YAE1B,KAAC,YAAY,IAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,GAAI,IANtF,MAAM,CAAC,KAAK,CAON,CAClB,CAAC,GACA,EACN,KAAC,cAAc,cAAE,KAAK,CAAC,YAAY,GAAkB,IACrC,CACvB,CAAA"}

package/dist/core/composite/DescriptionList/index.d.ts

@@ -0,0 +1,23 @@
+import type { ReactNode } from "react";
+export type DescriptionListItem = {
+    readonly id: string;
+    readonly term: ReactNode;
+    readonly description: ReactNode;
+};
+export type DescriptionListProps = {
+    readonly items: ReadonlyArray<DescriptionListItem>;
+    /**
+     * `columns` pairs each term with its value on one row and falls back to `stacked` below 30rem;
+     * `stacked` always puts the value under its term.
+     */
+    readonly layout?: "columns" | "stacked";
+    /** Draw a separator between pairs. */
+    readonly isDivided?: boolean;
+    readonly className?: string;
+};
+/**
+ * Term/value pairs (details, metadata, settings summaries) as a real `<dl>`.
+ * Contract: HIERARCHY-3 (term precedes value in source and paint), TRUTH-1 (no tone carrier on facts).
+ */
+export declare const DescriptionList: ({ items, layout, isDivided, className }: DescriptionListProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/composite/DescriptionList/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composite/DescriptionList/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;IAClD;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IACvC,sCAAsC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,yCAA4D,oBAAoB,gCAgB/G,CAAA"}

package/dist/core/composite/DescriptionList/index.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { navigationClassName } from "../../navigationClassNames.js";
+/**
+ * Term/value pairs (details, metadata, settings summaries) as a real `<dl>`.
+ * Contract: HIERARCHY-3 (term precedes value in source and paint), TRUTH-1 (no tone carrier on facts).
+ */
+export const DescriptionList = ({ items, layout = "columns", isDivided = true, className }) => (_jsx("dl", { className: navigationClassName("starci-core-description-list", className), "data-component": "DescriptionList", "data-contract": "HIERARCHY-3 TRUTH-1", "data-tier": "composite", "data-grammar-description-layout": layout, "data-grammar-description-divided": isDivided ? "true" : "false", children: items.map((item) => (_jsxs("div", { className: "starci-core-description-pair", "data-grammar-description-pair": "true", children: [_jsx("dt", { className: "starci-core-description-term", children: item.term }), _jsx("dd", { className: "starci-core-description-value", children: item.description })] }, item.id))) }));
+//# sourceMappingURL=index.js.map

package/dist/core/composite/DescriptionList/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composite/DescriptionList/index.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAoBnE;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,GAAG,IAAI,EAAE,SAAS,EAAwB,EAAE,EAAE,CAAC,CACjH,aACI,SAAS,EAAE,mBAAmB,CAAC,8BAA8B,EAAE,SAAS,CAAC,oBAC1D,iBAAiB,mBAClB,qBAAqB,eACzB,WAAW,qCACY,MAAM,sCACL,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,YAE7D,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACjB,eAAmB,SAAS,EAAC,8BAA8B,mCAA+B,MAAM,aAC5F,aAAI,SAAS,EAAC,8BAA8B,YAAE,IAAI,CAAC,IAAI,GAAM,EAC7D,aAAI,SAAS,EAAC,+BAA+B,YAAE,IAAI,CAAC,WAAW,GAAM,KAF/D,IAAI,CAAC,EAAE,CAGX,CACT,CAAC,GACD,CACR,CAAA"}

package/dist/core/composite/Fieldset/index.d.ts

@@ -0,0 +1,17 @@
+import { type ReactNode } from "react";
+export type FieldsetProps = {
+    /** The group's name, announced before every control inside it. */
+    readonly legend: ReactNode;
+    readonly isLegendHidden?: boolean;
+    readonly description?: ReactNode;
+    /** A cross-field problem (e.g. two values that disagree), not a single control's error. */
+    readonly errorMessage?: ReactNode;
+    readonly children: ReactNode;
+    /** Buttons that act on this group, laid out after the fields. */
+    readonly actions?: ReactNode;
+    /** Disables every control inside, including the ones rendered as `div` by the vendor. */
+    readonly isDisabled?: boolean;
+};
+/** A named group of related fields: a native `fieldset` + `legend` with the field rhythm. */
+export declare const Fieldset: ({ legend, isLegendHidden, description, errorMessage, children, actions, isDisabled }: FieldsetProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/composite/Fieldset/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composite/Fieldset/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAG7C,MAAM,MAAM,aAAa,GAAG;IACxB,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAA;IAChC,2FAA2F;IAC3F,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAA;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AAED,6FAA6F;AAC7F,eAAO,MAAM,QAAQ,GAAI,sFAAsG,aAAa,gCAkC3I,CAAA"}

package/dist/core/composite/Fieldset/index.js

@@ -0,0 +1,14 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fieldset as HeroFieldset } from "@heroui/react";
+import { useId } from "react";
+import { fieldStateAttributes } from "../../primitive/Field/index.js";
+/** A named group of related fields: a native `fieldset` + `legend` with the field rhythm. */
+export const Fieldset = ({ legend, isLegendHidden = false, description, errorMessage, children, actions, isDisabled = false }) => {
+    const id = useId().replace(/:/g, "");
+    const descriptionId = description == null ? undefined : `fieldset${id}-description`;
+    const errorId = errorMessage == null ? undefined : `fieldset${id}-error`;
+    const describedBy = [descriptionId, errorId].filter((part) => part !== undefined).join(" ");
+    return (_jsxs(HeroFieldset, { "data-tier": "composite", "data-component": "Fieldset", "data-contract": "A11Y-1 FIELD-2", className: "starci-core-fieldset", disabled: isDisabled, ...(describedBy === "" ? {} : { "aria-describedby": describedBy }), ...fieldStateAttributes({ isInvalid: errorMessage != null, isDisabled }), children: [_jsx(HeroFieldset.Legend, { className: isLegendHidden ? "starci-core-fieldset-legend starci-core-form-label--screen-reader" : "starci-core-fieldset-legend", "data-grammar-fieldset-legend": "true", children: legend }), descriptionId === undefined ? null : (_jsx("p", { id: descriptionId, className: "starci-core-field-description", "data-grammar-field-description": "true", children: description })), _jsx(HeroFieldset.Group, { className: "starci-core-fieldset-fields", "data-grammar-fieldset-fields": "true", children: children }), errorId === undefined ? null : (_jsx("p", { id: errorId, className: "starci-core-field-error", "data-grammar-field-error": "true", "data-contract": "FEEDBACK-1", children: errorMessage })), actions == null ? null : (_jsx(HeroFieldset.Actions, { className: "starci-core-fieldset-actions", "data-grammar-fieldset-actions": "true", children: actions }))] }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/composite/Fieldset/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composite/Fieldset/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,EAAE,KAAK,EAAkB,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AAgBrE,6FAA6F;AAC7F,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,GAAG,KAAK,EAAiB,EAAE,EAAE;IAC5I,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACpC,MAAM,aAAa,GAAG,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,cAAc,CAAA;IACnF,MAAM,OAAO,GAAG,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAA;IACxE,MAAM,WAAW,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAE3F,OAAO,CACH,MAAC,YAAY,iBACC,WAAW,oBACN,UAAU,mBACX,gBAAgB,EAC9B,SAAS,EAAC,sBAAsB,EAChC,QAAQ,EAAE,UAAU,KAChB,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,WAAW,EAAE,CAAC,KAC/D,oBAAoB,CAAC,EAAE,SAAS,EAAE,YAAY,IAAI,IAAI,EAAE,UAAU,EAAE,CAAC,aAEzE,KAAC,YAAY,CAAC,MAAM,IAChB,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,mEAAmE,CAAC,CAAC,CAAC,6BAA6B,kCAClG,MAAM,YAElC,MAAM,GACW,EACrB,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAClC,YAAG,EAAE,EAAE,aAAa,EAAE,SAAS,EAAC,+BAA+B,oCAAgC,MAAM,YAAE,WAAW,GAAK,CAC1H,EACD,KAAC,YAAY,CAAC,KAAK,IAAC,SAAS,EAAC,6BAA6B,kCAA8B,MAAM,YAAE,QAAQ,GAAsB,EAC9H,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC5B,YAAG,EAAE,EAAE,OAAO,EAAE,SAAS,EAAC,yBAAyB,8BAA0B,MAAM,mBAAe,YAAY,YAAE,YAAY,GAAK,CACpI,EACA,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACtB,KAAC,YAAY,CAAC,OAAO,IAAC,SAAS,EAAC,8BAA8B,mCAA+B,MAAM,YAAE,OAAO,GAAwB,CACvI,IACU,CAClB,CAAA;AACL,CAAC,CAAA"}

package/dist/core/composite/Form/index.d.ts

@@ -0,0 +1,32 @@
+import type { FormEvent, ReactNode } from "react";
+/** Server-side errors keyed by field `name`; each named control shows its own. */
+export type FormValidationErrors = Readonly<Record<string, string | ReadonlyArray<string>>>;
+export type FormProps = {
+    readonly children: ReactNode;
+    /** Accessible name; gives the form the `form` landmark role. */
+    readonly label?: string;
+    readonly id?: string;
+    /**
+     * Client submit. The browser navigation is prevented and the values arrive as `FormData`.
+     * Omit it and pass `action` for a native submit.
+     */
+    readonly onSubmit?: (data: FormData, event: FormEvent<HTMLFormElement>) => void;
+    readonly onReset?: () => void;
+    readonly action?: string;
+    readonly method?: "get" | "post";
+    readonly validationErrors?: FormValidationErrors;
+    /**
+     * `native` (default) blocks submit and focuses the first invalid control; `aria` marks controls
+     * invalid in real time and lets the submit through for the app to decide.
+     */
+    readonly validationBehavior?: "native" | "aria";
+    /** A submit is in flight: the form announces busy and ignores another submit. */
+    readonly isPending?: boolean;
+};
+/**
+ * The form boundary. Controls inside validate on submit (native constraint validation, required
+ * values, and any `validationErrors` from the server matched by field name) and show the message in
+ * their own error slot; the first invalid control receives focus.
+ */
+export declare const Form: ({ children, label, id, onSubmit, onReset, action, method, validationErrors, validationBehavior, isPending, }: FormProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/composite/Form/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composite/Form/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGjD,kFAAkF;AAClF,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;AAE3F,MAAM,MAAM,SAAS,GAAG;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,eAAe,CAAC,KAAK,IAAI,CAAA;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,oBAAoB,CAAA;IAChD;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;IAC/C,iFAAiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC/B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,IAAI,GAAI,8GAWlB,SAAS,gCAkCX,CAAA"}