@starci/grammar 0.4.12 → 0.5.0

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

@@ -0,0 +1,59 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { AlertDialog as HeroAlertDialog } from "@heroui/react";
+import { useEffect, useId, useRef, useState } from "react";
+import { overlayOpenProps, useOverlayContainer, vendorStatusFor } from "../../overlayScope.js";
+import { Button } from "../../primitive/Button/index.js";
+/** Holds the safe (cancel) action and takes initial focus when the dialog opens (WAI-ARIA APG). */
+const SafeAction = ({ children }) => {
+    const ref = useRef(null);
+    useEffect(() => {
+        ref.current?.querySelector("button, a[href]")?.focus();
+    }, []);
+    return _jsx("span", { ref: ref, "data-grammar-overlay-action": "cancel", children: children });
+};
+const isPromiseLike = (value) => (typeof value === "object" && value !== null && typeof value.then === "function");
+/**
+ * BRANCH - `AlertDialog`: an interrupting confirmation (`role="alertdialog"`).
+ *
+ * Dismiss rules differ from `Dialog` on purpose: an outside press never dismisses (the decision must
+ * be explicit), Escape cancels, and the cancel action is first in focus order so initial focus lands
+ * on the safe choice. Focus trap/return, scroll lock and the scoped portal are the `Dialog` rules.
+ * Contract: confirm CTA-4 ACTION-2 FEEDBACK-3 (explicit destructive authority, pending on the initiator,
+ * closes only on settlement); surface and container as `Dialog`.
+ */
+export const AlertDialog = ({ title, description, children, tone = "negative", confirmLabel, cancelLabel, onConfirm, onCancel, isConfirmPending = false, trigger, isKeyboardDismissDisabled = false, ...openState }) => {
+    const { anchor, container } = useOverlayContainer("AlertDialog");
+    const descriptionId = useId();
+    const [isRunning, setIsRunning] = useState(false);
+    const confirmedRef = useRef(false);
+    const pending = isConfirmPending || isRunning;
+    const onOpenChange = (isOpen) => {
+        if (isOpen)
+            confirmedRef.current = false;
+        else if (confirmedRef.current)
+            confirmedRef.current = false;
+        else
+            onCancel?.();
+        openState.onOpenChange?.(isOpen);
+    };
+    return (_jsxs(HeroAlertDialog, { ...overlayOpenProps({ ...openState, onOpenChange }), children: [trigger, anchor, container === null ? null : (_jsx(HeroAlertDialog.Backdrop, { UNSTABLE_portalContainer: container, isDismissable: false, isKeyboardDismissDisabled: isKeyboardDismissDisabled || pending, "data-grammar-overlay-backdrop": "AlertDialog", className: "starci-core-overlay-backdrop", children: _jsx(HeroAlertDialog.Container, { placement: "center", size: "sm", "data-size": "sm", "data-contract": "MOTION-2", className: "starci-core-dialog-container", children: _jsx(HeroAlertDialog.Dialog, { "data-tier": "branch", "data-component": "AlertDialog", "data-grammar-tone": tone, "data-grammar-overlay-surface": "dialog", "data-contract": "FOCUS-3 LAYOUT-4 CORE-BOUNDARY-4", ...(description === undefined ? {} : { "aria-describedby": descriptionId }), className: "starci-core-dialog starci-core-alert-dialog", children: ({ close }) => {
+                            const confirm = () => {
+                                const result = onConfirm();
+                                if (!isPromiseLike(result)) {
+                                    if (!isConfirmPending) {
+                                        confirmedRef.current = true;
+                                        close();
+                                    }
+                                    return;
+                                }
+                                setIsRunning(true);
+                                result.then(() => {
+                                    setIsRunning(false);
+                                    confirmedRef.current = true;
+                                    close();
+                                }, () => { setIsRunning(false); });
+                            };
+                            return (_jsxs(_Fragment, { children: [_jsxs(HeroAlertDialog.Header, { className: "starci-core-overlay-header", children: [_jsx(HeroAlertDialog.Icon, { status: vendorStatusFor(tone), className: "starci-core-alert-dialog-icon" }), _jsxs("div", { className: "starci-core-overlay-heading-group", children: [_jsx(HeroAlertDialog.Heading, { className: "starci-core-overlay-title", children: title }), description === undefined ? null : (_jsx("p", { id: descriptionId, className: "starci-core-overlay-description", children: description }))] })] }), children === undefined ? null : (_jsx(HeroAlertDialog.Body, { className: "starci-core-overlay-body", children: children })), _jsxs(HeroAlertDialog.Footer, { className: "starci-core-overlay-footer", children: [_jsx(SafeAction, { children: _jsx(Button, { variant: "secondary", isDisabled: pending, onPress: close, children: cancelLabel }) }), _jsx("span", { "data-grammar-overlay-action": "confirm", "data-grammar-tone": tone, "data-contract": "CTA-4 ACTION-2 FEEDBACK-3", children: _jsx(Button, { variant: "primary", isPending: pending, onPress: confirm, children: confirmLabel }) })] })] }));
+                        } }) }) }))] }));
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/core/branch/Calendar/index.d.ts

@@ -0,0 +1,26 @@
+import { type DateValue } from "@heroui/react";
+export type CalendarProps = {
+    /** Names the calendar, e.g. "Delivery date". */
+    readonly label: string;
+    /** Controlled selected date. Omit for uncontrolled use with `defaultValue`. */
+    readonly value?: DateValue | null;
+    readonly defaultValue?: DateValue;
+    readonly onChange?: (value: DateValue) => void;
+    readonly minValue?: DateValue;
+    readonly maxValue?: DateValue;
+    readonly isDateUnavailable?: (date: DateValue) => boolean;
+    readonly isDisabled?: boolean;
+    readonly isReadOnly?: boolean;
+    /** App-owned accessible names of the month navigation buttons. */
+    readonly previousLabel: string;
+    readonly nextLabel: string;
+    readonly className?: string;
+};
+/**
+ * A standalone month calendar (not a date field). Arrow keys move by day/week, Page Up/Down by
+ * month, Home/End to the week edges; today, the selected date and unavailable dates are exposed by
+ * the vendor as `data-*` states on each cell, with `aria-selected` on the chosen day.
+ * Contract: root CONTROL-STATE-3 (app-owned date), grid FOCUS-2, nav A11Y-2 ICON-5, day TRUTH-2.
+ */
+export declare const Calendar: ({ label, value, defaultValue, onChange, minValue, maxValue, isDateUnavailable, isDisabled, isReadOnly, previousLabel, nextLabel, className, }: CalendarProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/branch/Calendar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/Calendar/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAGxE,MAAM,MAAM,aAAa,GAAG;IACxB,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAA;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAA;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAQD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,+IAatB,aAAa,gCA8Bf,CAAA"}

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

@@ -0,0 +1,17 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Calendar as HeroCalendar } from "@heroui/react";
+import { navigationClassName } from "../../navigationClassNames.js";
+/*
+ * Consumer hooks: `starci-core-calendar-heading`, `starci-core-calendar-weekday` name HeroUI parts
+ * whose vendor paint Common leaves as it is. No shipped sheet paints them; the Grammar name lets a
+ * consumer or family select those parts without reaching for vendor class names.
+ */
+/**
+ * A standalone month calendar (not a date field). Arrow keys move by day/week, Page Up/Down by
+ * month, Home/End to the week edges; today, the selected date and unavailable dates are exposed by
+ * the vendor as `data-*` states on each cell, with `aria-selected` on the chosen day.
+ * Contract: root CONTROL-STATE-3 (app-owned date), grid FOCUS-2, nav A11Y-2 ICON-5, day TRUTH-2.
+ */
+export const Calendar = ({ label, value, defaultValue, onChange, minValue, maxValue, isDateUnavailable, isDisabled = false, isReadOnly = false, previousLabel, nextLabel, className, }) => (_jsxs(HeroCalendar, { "aria-label": label, className: navigationClassName("starci-core-calendar", className), "data-component": "Calendar", "data-contract": "CONTROL-STATE-3", "data-tier": "branch", isDisabled: isDisabled, isReadOnly: isReadOnly, ...(value === undefined ? {} : { value }), ...(defaultValue === undefined ? {} : { defaultValue }), ...(onChange === undefined ? {} : { onChange }), ...(minValue === undefined ? {} : { minValue }), ...(maxValue === undefined ? {} : { maxValue }), ...(isDateUnavailable === undefined ? {} : { isDateUnavailable }), children: [_jsxs(HeroCalendar.Header, { className: "starci-core-calendar-header", children: [_jsx(HeroCalendar.NavButton, { "aria-label": previousLabel, className: "starci-core-calendar-nav", "data-contract": "A11Y-2 ICON-5", slot: "previous" }), _jsx(HeroCalendar.Heading, { className: "starci-core-calendar-heading" }), _jsx(HeroCalendar.NavButton, { "aria-label": nextLabel, className: "starci-core-calendar-nav", "data-contract": "A11Y-2 ICON-5", slot: "next" })] }), _jsxs(HeroCalendar.Grid, { className: "starci-core-calendar-month", "data-contract": "FOCUS-2", children: [_jsx(HeroCalendar.GridHeader, { children: (day) => _jsx(HeroCalendar.HeaderCell, { className: "starci-core-calendar-weekday", children: day }) }), _jsx(HeroCalendar.GridBody, { children: (date) => _jsx(HeroCalendar.Cell, { className: "starci-core-calendar-day", "data-contract": "TRUTH-2", "data-grammar-calendar-day": "true", date: date }) })] })] }));
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/Calendar/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAkB,MAAM,eAAe,CAAA;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAoBnE;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EACrB,KAAK,EACL,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,UAAU,GAAG,KAAK,EAClB,UAAU,GAAG,KAAK,EAClB,aAAa,EACb,SAAS,EACT,SAAS,GACG,EAAE,EAAE,CAAC,CACjB,MAAC,YAAY,kBACG,KAAK,EACjB,SAAS,EAAE,mBAAmB,CAAC,sBAAsB,EAAE,SAAS,CAAC,oBAClD,UAAU,mBACX,iBAAiB,eACrB,QAAQ,EAClB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,UAAU,KAClB,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KACtC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,KACpD,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAC5C,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAC5C,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAC5C,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,aAElE,MAAC,YAAY,CAAC,MAAM,IAAC,SAAS,EAAC,6BAA6B,aACxD,KAAC,YAAY,CAAC,SAAS,kBAAa,aAAa,EAAE,SAAS,EAAC,0BAA0B,mBAAe,eAAe,EAAC,IAAI,EAAC,UAAU,GAAG,EACxI,KAAC,YAAY,CAAC,OAAO,IAAC,SAAS,EAAC,8BAA8B,GAAG,EACjE,KAAC,YAAY,CAAC,SAAS,kBAAa,SAAS,EAAE,SAAS,EAAC,0BAA0B,mBAAe,eAAe,EAAC,IAAI,EAAC,MAAM,GAAG,IAC9G,EACtB,MAAC,YAAY,CAAC,IAAI,IAAC,SAAS,EAAC,4BAA4B,mBAAe,SAAS,aAC7E,KAAC,YAAY,CAAC,UAAU,cACnB,CAAC,GAAW,EAAE,EAAE,CAAC,KAAC,YAAY,CAAC,UAAU,IAAC,SAAS,EAAC,8BAA8B,YAAE,GAAG,GAA2B,GAC7F,EAC1B,KAAC,YAAY,CAAC,QAAQ,cACjB,CAAC,IAAI,EAAE,EAAE,CAAC,KAAC,YAAY,CAAC,IAAI,IAAC,SAAS,EAAC,0BAA0B,mBAAe,SAAS,+BAA2B,MAAM,EAAC,IAAI,EAAE,IAAI,GAAI,GACtH,IACR,IACT,CAClB,CAAA"}

package/dist/core/branch/ComboBox/index.d.ts

@@ -0,0 +1,32 @@
+import type { ReactNode } from "react";
+import { type FieldControlProps } from "../../primitive/Field/index.js";
+import { type ListOption } from "../Select/index.js";
+export type ComboBoxProps = FieldControlProps & {
+    readonly id?: string;
+    readonly options: ReadonlyArray<ListOption>;
+    readonly placeholder?: string;
+    /** Selected option id. */
+    readonly value?: string | null;
+    readonly defaultValue?: string | null;
+    readonly onValueChange?: (value: string | null) => void;
+    /** Typed text. Control it to filter or fetch options yourself. */
+    readonly inputValue?: string;
+    readonly defaultInputValue?: string;
+    readonly onInputChange?: (value: string) => void;
+    /** Keeps typed text that matches no option as the field value (autocomplete / free entry). */
+    readonly allowsCustomValue?: boolean;
+    /** Shown inside the open list when nothing matches. The copy is the app's. */
+    readonly emptyState?: ReactNode;
+    /** Options are being fetched for the typed text. */
+    readonly isPending?: boolean;
+    /** When the list opens: while typing (default), on focus, or only from the trigger/arrow keys. */
+    readonly menuTrigger?: "input" | "focus" | "manual";
+};
+/**
+ * Type to filter a list, then pick (combobox / autocomplete).
+ *
+ * The vendor owns the combobox role, `aria-expanded`, `aria-activedescendant`, arrow/Enter/Escape
+ * handling and the "contains" filter. Pending keeps the input editable and marks the list busy.
+ */
+export declare const ComboBox: ({ id, options, placeholder, value, defaultValue, onValueChange, inputValue, defaultInputValue, onInputChange, allowsCustomValue, emptyState, isPending, menuTrigger, ...field }: ComboBoxProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/branch/ComboBox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/ComboBox/index.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAMH,KAAK,iBAAiB,EACzB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEjE,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG;IAC5C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACvD,kEAAkE;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,8FAA8F;IAC9F,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAA;IAC/B,oDAAoD;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,kGAAkG;IAClG,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;CACtD,CAAA;AAcD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,iLAetB,aAAa,gCA8Cf,CAAA"}

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

@@ -0,0 +1,28 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ComboBox as HeroComboBox, Input as HeroInput, ListBox as HeroListBox, Spinner as HeroSpinner, } from "@heroui/react";
+import { FieldDescription, FieldErrorText, FieldLabel, useGrammarPortal, vendorFieldProps, } from "../../primitive/Field/index.js";
+import { ListOptions } from "../Select/index.js";
+/*
+ * Consumer hook: `starci-core-combo-box` 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 hooks: `starci-core-list-popover`, `starci-core-list` name HeroUI parts whose vendor
+ * paint Common leaves as it is. No shipped sheet paints them; the Grammar name lets a consumer or
+ * family select those parts without reaching for vendor class names.
+ */
+/**
+ * Type to filter a list, then pick (combobox / autocomplete).
+ *
+ * The vendor owns the combobox role, `aria-expanded`, `aria-activedescendant`, arrow/Enter/Escape
+ * handling and the "contains" filter. Pending keeps the input editable and marks the list busy.
+ */
+export const ComboBox = ({ id, options, placeholder, value, defaultValue, onValueChange, inputValue, defaultInputValue, onInputChange, allowsCustomValue = false, emptyState, isPending = false, menuTrigger = "input", ...field }) => {
+    const { anchor, portalProps } = useGrammarPortal();
+    return (_jsxs(HeroComboBox, { "data-tier": "branch", "data-component": "ComboBox", "data-contract": "A11Y-1 FIELD-1 FIELD-2 CONTROL-STATE-2", className: "starci-core-field starci-core-combo-box", fullWidth: true, ...vendorFieldProps({ ...field, isPending }), isReadOnly: field.isReadOnly === true, allowsCustomValue: allowsCustomValue, menuTrigger: menuTrigger, ...(value === undefined ? defaultValue === undefined ? {} : { defaultValue } : { value }), ...(inputValue === undefined ? defaultInputValue === undefined ? {} : { defaultInputValue } : { inputValue }), ...(onInputChange === undefined ? {} : { onInputChange }), onChange: (key) => onValueChange?.(key === null ? null : String(key)), children: [anchor, _jsx(FieldLabel, { isHidden: field.isLabelHidden, isRequired: field.isRequired, children: field.label }), _jsxs(HeroComboBox.InputGroup, { className: "starci-core-combo-box-group", "data-grammar-field-control": "true", children: [_jsx(HeroInput, { ...(id === undefined ? {} : { id }), ...(placeholder === undefined ? {} : { placeholder }), className: "starci-core-combo-box-input", ...(isPending ? { "aria-busy": true } : {}) }), _jsx(HeroComboBox.Trigger, { className: "starci-core-combo-box-trigger", children: isPending ? _jsx(HeroSpinner, { size: "sm", color: "current", "aria-hidden": "true", className: "starci-core-field-spinner" }) : undefined })] }), _jsx(FieldDescription, { children: field.description }), _jsx(FieldErrorText, { children: field.errorMessage }), _jsx(HeroComboBox.Popover, { className: "starci-core-list-popover", "data-grammar-popover": "ComboBox", "data-contract": "LAYOUT-4", ...portalProps, children: _jsx(HeroListBox, { className: "starci-core-list", ...(isPending ? { "aria-busy": true } : {}), ...(emptyState == null ? {} : {
+                        renderEmptyState: () => _jsx("div", { className: "starci-core-list-empty", "data-grammar-list-empty": "true", "data-contract": "STATE-3", children: emptyState }),
+                    }), children: _jsx(ListOptions, { options: options }) }) })] }));
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/core/branch/DataTable/index.d.ts

@@ -0,0 +1,52 @@
+import { type ReactNode } from "react";
+export type DataTableColumn = {
+    readonly id: string;
+    readonly label: string;
+    /** The column that names each row for assistive technology. Defaults to the first column. */
+    readonly isRowHeader?: boolean;
+    readonly allowsSorting?: boolean;
+    readonly align?: "start" | "end";
+};
+export type DataTableSort = {
+    readonly columnId: string;
+    readonly direction: "ascending" | "descending";
+};
+export type DataTableRow = {
+    readonly id: string;
+};
+export type DataTableProps<Row extends DataTableRow> = {
+    /** Names the table, e.g. "Invoices". */
+    readonly label: string;
+    readonly columns: ReadonlyArray<DataTableColumn>;
+    readonly rows: ReadonlyArray<Row>;
+    readonly renderCell: (row: Row, columnId: string) => ReactNode;
+    /** Controlled sort. Sorting the rows stays with the app; the table announces `aria-sort`. */
+    readonly sort?: DataTableSort;
+    readonly onSortChange?: (sort: DataTableSort) => void;
+    readonly selectionMode?: "none" | "single" | "multiple";
+    readonly selectedIds?: ReadonlyArray<string> | "all";
+    readonly defaultSelectedIds?: ReadonlyArray<string> | "all";
+    readonly onSelectionChange?: (ids: ReadonlyArray<string> | "all") => void;
+    /** App-owned accessible names of the selection checkboxes in multiple mode. */
+    readonly selectAllLabel?: string;
+    readonly selectRowLabel?: (row: Row) => string;
+    /** Replaces the rows with `loadingContent` and marks the table busy. */
+    readonly isLoading?: boolean;
+    readonly loadingContent?: ReactNode;
+    /** Shown when there are no rows and the table is not loading. */
+    readonly emptyContent: ReactNode;
+    /** Keep the column header visible while the body scrolls inside `maxBlockSize`. */
+    readonly stickyHeader?: boolean;
+    /** Bounds the body so the table owns vertical scroll, e.g. "24rem". */
+    readonly maxBlockSize?: string;
+    readonly onRowAction?: (id: string) => void;
+    readonly className?: string;
+};
+/**
+ * Tabular data with sortable columns (`aria-sort`), row selection (`aria-selected`,
+ * `data-grammar-selected`), empty and loading states, an optional sticky header, and its own
+ * horizontal scroll so a wide table never widens a 360px page.
+ * Contract: scroll LAYOUT-3, grid FOCUS-2 CONTROL-STATE-3, row FOCUS-1, empty STATE-3.
+ */
+export declare const DataTable: <Row extends DataTableRow>({ label, columns, rows, renderCell, sort, onSortChange, selectionMode, selectedIds, defaultSelectedIds, onSelectionChange, selectAllLabel, selectRowLabel, isLoading, loadingContent, emptyContent, stickyHeader, maxBlockSize, onRowAction, className, }: DataTableProps<Row>) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/branch/DataTable/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/DataTable/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGpE,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,6FAA6F;IAC7F,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,YAAY,CAAA;CACjD,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAElD,MAAM,MAAM,cAAc,CAAC,GAAG,SAAS,YAAY,IAAI;IACnD,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;IAChD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,KAAK,SAAS,CAAA;IAC9D,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAA;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;IACrD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAA;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,KAAK,CAAA;IACpD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,KAAK,CAAA;IAC3D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,KAAK,KAAK,IAAI,CAAA;IACzE,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAA;IAC9C,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,CAAA;IACnC,iEAAiE;IACjE,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAA;IAChC,mFAAmF;IACnF,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AA2BD;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,GAAG,SAAS,YAAY,EAAE,2PAoBjD,cAAc,CAAC,GAAG,CAAC,gCA4FrB,CAAA"}

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

@@ -0,0 +1,46 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Checkbox as HeroCheckbox, Table as HeroTable } from "@heroui/react";
+import { useState } from "react";
+import { navigationClassName } from "../../navigationClassNames.js";
+const SELECTION_COLUMN = "starci-data-table-selection";
+const toSortDescriptor = (sort) => ({ column: sort.columnId, direction: sort.direction });
+const toIds = (selection) => selection === "all" ? "all" : [...selection].map(String);
+const toSelection = (ids) => ids === "all" ? "all" : new Set(ids);
+const SelectionCheckbox = ({ label }) => (_jsx(HeroCheckbox, { className: "starci-core-data-table-checkbox", slot: "selection", ...(label === undefined ? {} : { "aria-label": label }), children: _jsx(HeroCheckbox.Content, { children: _jsx(HeroCheckbox.Control, { children: _jsx(HeroCheckbox.Indicator, {}) }) }) }));
+/*
+ * Consumer hooks: `starci-core-data-table-sort`, `starci-core-data-table-body`,
+ * `starci-core-data-table-checkbox` name HeroUI parts whose vendor paint Common leaves as it is. No
+ * shipped sheet paints them; the Grammar name lets a consumer or family select those parts without
+ * reaching for vendor class names.
+ */
+/**
+ * Tabular data with sortable columns (`aria-sort`), row selection (`aria-selected`,
+ * `data-grammar-selected`), empty and loading states, an optional sticky header, and its own
+ * horizontal scroll so a wide table never widens a 360px page.
+ * Contract: scroll LAYOUT-3, grid FOCUS-2 CONTROL-STATE-3, row FOCUS-1, empty STATE-3.
+ */
+export const DataTable = ({ label, columns, rows, renderCell, sort, onSortChange, selectionMode = "none", selectedIds, defaultSelectedIds, onSelectionChange, selectAllLabel, selectRowLabel, isLoading = false, loadingContent, emptyContent, stickyHeader = false, maxBlockSize, onRowAction, className, }) => {
+    const rowHeaderId = columns.find((column) => column.isRowHeader)?.id ?? columns[0]?.id;
+    const multiple = selectionMode === "multiple";
+    // Selection is always held here so every row can expose its own `data-grammar-selected`.
+    const [uncontrolledSelection, setUncontrolledSelection] = useState(defaultSelectedIds ?? []);
+    const selection = selectedIds ?? uncontrolledSelection;
+    const isRowSelected = (id) => selection === "all" || selection.includes(id);
+    const visibleRows = isLoading ? [] : rows;
+    const state = isLoading ? "loading" : rows.length === 0 ? "empty" : "ready";
+    const scrollStyle = maxBlockSize === undefined ? undefined : { "--starci-core-data-table-max-block-size": maxBlockSize };
+    return (_jsx(HeroTable, { "aria-busy": isLoading || undefined, className: navigationClassName("starci-core-data-table", className), "data-component": "DataTable", "data-tier": "branch", "data-grammar-table-state": state, "data-grammar-table-sticky": stickyHeader ? "true" : "false", "data-grammar-table-bounded": maxBlockSize === undefined ? "false" : "true", children: _jsx(HeroTable.ScrollContainer, { className: "starci-core-data-table-scroll", "data-contract": "LAYOUT-3", "data-grammar-table-scroll": "true", style: scrollStyle, children: _jsxs(HeroTable.Content, { "aria-label": label, className: "starci-core-data-table-content", "data-contract": "FOCUS-2 CONTROL-STATE-3", selectionMode: selectionMode, ...(sort === undefined ? {} : { sortDescriptor: toSortDescriptor(sort) }), ...(onSortChange === undefined ? {} : {
+                    onSortChange: (descriptor) => onSortChange({ columnId: String(descriptor.column), direction: descriptor.direction }),
+                }), selectedKeys: toSelection(selection), onSelectionChange: (next) => {
+                    const ids = toIds(next);
+                    if (selectedIds === undefined)
+                        setUncontrolledSelection(ids);
+                    onSelectionChange?.(ids);
+                }, ...(onRowAction === undefined ? {} : { onRowAction: (key) => onRowAction(String(key)) }), children: [_jsxs(HeroTable.Header, { className: "starci-core-data-table-header", children: [multiple ? (_jsx(HeroTable.Column, { className: "starci-core-data-table-column", "data-grammar-table-selection": "true", id: SELECTION_COLUMN, children: _jsx(SelectionCheckbox, { label: selectAllLabel }) })) : null, columns.map((column) => (_jsx(HeroTable.Column, { id: column.id, allowsSorting: column.allowsSorting === true, className: "starci-core-data-table-column", "data-grammar-table-align": column.align ?? "start", isRowHeader: column.id === rowHeaderId, textValue: column.label, children: ({ sortDirection }) => column.allowsSorting === true
+                                    ? _jsx(HeroTable.SortableColumnHeader, { className: "starci-core-data-table-sort", ...(sortDirection === undefined ? {} : { sortDirection }), children: column.label })
+                                    : column.label }, column.id)))] }), _jsx(HeroTable.Body, { className: "starci-core-data-table-body", renderEmptyState: () => isLoading
+                            ? _jsx("div", { className: "starci-core-data-table-placeholder", "data-grammar-table-loading": "true", role: "status", children: loadingContent })
+                            : _jsx("div", { className: "starci-core-data-table-placeholder", "data-contract": "STATE-3", "data-grammar-table-empty": "true", children: emptyContent }), children: visibleRows.map((row) => (_jsxs(HeroTable.Row, { id: row.id, className: "starci-core-data-table-row", "data-contract": "FOCUS-1", "data-grammar-table-row": "true", "data-grammar-selected": selectionMode !== "none" && isRowSelected(row.id) ? "true" : "false", children: [multiple ? (_jsx(HeroTable.Cell, { className: "starci-core-data-table-cell", "data-grammar-table-selection": "true", children: _jsx(SelectionCheckbox, { label: selectRowLabel?.(row) }) })) : null, columns.map((column) => (_jsx(HeroTable.Cell, { className: "starci-core-data-table-cell", "data-grammar-table-align": column.align ?? "start", children: renderCell(row, column.id) }, column.id)))] }, row.id))) })] }) }) }));
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/core/branch/DatePicker/index.d.ts

@@ -0,0 +1,23 @@
+import { type DateValue } from "@heroui/react";
+import { type FieldControlProps } from "../../primitive/Field/index.js";
+import { type DateGranularity } from "../../primitive/DateField/index.js";
+export type DatePickerProps = FieldControlProps & {
+    readonly value?: DateValue | null;
+    readonly defaultValue?: DateValue | null;
+    readonly onValueChange?: (value: DateValue | null) => void;
+    readonly minValue?: DateValue;
+    readonly maxValue?: DateValue;
+    /** Days the reader may not pick; they stay visible and are announced unavailable. */
+    readonly isDateUnavailable?: (date: DateValue) => boolean;
+    readonly granularity?: DateGranularity;
+};
+/** Month grid used by DatePicker: heading, previous/next, and the day grid (arrow-key navigable). */
+export declare const PickerCalendar: () => import("react").JSX.Element;
+/** Month grid used by DateRangePicker: the same anatomy, selecting a start and an end. */
+export declare const PickerRangeCalendar: () => import("react").JSX.Element;
+/**
+ * A date typed in segments or picked from a month grid in a popover. The trigger is a named button,
+ * the popover is a dialog that traps and returns focus, and the grid is the vendor's.
+ */
+export declare const DatePicker: ({ value, defaultValue, onValueChange, minValue, maxValue, isDateUnavailable, granularity, ...field }: DatePickerProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/branch/DatePicker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/DatePicker/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAKH,KAAK,SAAS,EACjB,MAAM,eAAe,CAAA;AACtB,OAAO,EAMH,KAAK,iBAAiB,EACzB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAEvF,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAA;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,qFAAqF;IACrF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAA;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAA;CACzC,CAAA;AAED,qGAAqG;AACrG,eAAO,MAAM,cAAc,mCAY1B,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,mBAAmB,mCAY/B,CAAA;AAeD;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,sGASxB,eAAe,gCAkCjB,CAAA"}

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

@@ -0,0 +1,29 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Calendar as HeroCalendar, DateField as HeroDateField, DatePicker as HeroDatePicker, RangeCalendar as HeroRangeCalendar, } from "@heroui/react";
+import { FieldDescription, FieldErrorText, FieldLabel, useGrammarPortal, vendorFieldProps, } from "../../primitive/Field/index.js";
+import { DateSegments } from "../../primitive/DateField/index.js";
+/** Month grid used by DatePicker: heading, previous/next, and the day grid (arrow-key navigable). */
+export const PickerCalendar = () => (_jsxs(HeroCalendar, { className: "starci-core-calendar", "data-grammar-calendar": "single", children: [_jsxs(HeroCalendar.Header, { className: "starci-core-calendar-header", children: [_jsx(HeroCalendar.NavButton, { slot: "previous", className: "starci-core-calendar-nav" }), _jsx(HeroCalendar.Heading, { className: "starci-core-calendar-heading" }), _jsx(HeroCalendar.NavButton, { slot: "next", className: "starci-core-calendar-nav" })] }), _jsxs(HeroCalendar.Grid, { className: "starci-core-calendar-grid", children: [_jsx(HeroCalendar.GridHeader, { children: (day) => _jsx(HeroCalendar.HeaderCell, { children: day }) }), _jsx(HeroCalendar.GridBody, { children: (date) => _jsx(HeroCalendar.Cell, { date: date, className: "starci-core-calendar-cell", "data-grammar-calendar-cell": "true" }) })] })] }));
+/** Month grid used by DateRangePicker: the same anatomy, selecting a start and an end. */
+export const PickerRangeCalendar = () => (_jsxs(HeroRangeCalendar, { className: "starci-core-calendar", "data-grammar-calendar": "range", children: [_jsxs(HeroRangeCalendar.Header, { className: "starci-core-calendar-header", children: [_jsx(HeroRangeCalendar.NavButton, { slot: "previous", className: "starci-core-calendar-nav" }), _jsx(HeroRangeCalendar.Heading, { className: "starci-core-calendar-heading" }), _jsx(HeroRangeCalendar.NavButton, { slot: "next", className: "starci-core-calendar-nav" })] }), _jsxs(HeroRangeCalendar.Grid, { className: "starci-core-calendar-grid", children: [_jsx(HeroRangeCalendar.GridHeader, { children: (day) => _jsx(HeroRangeCalendar.HeaderCell, { children: day }) }), _jsx(HeroRangeCalendar.GridBody, { children: (date) => _jsx(HeroRangeCalendar.Cell, { date: date, className: "starci-core-calendar-cell", "data-grammar-calendar-cell": "true" }) })] })] }));
+/*
+ * Consumer hook: `starci-core-date-picker` 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 hooks: `starci-core-date-popover`, `starci-core-date-suffix`,
+ * `starci-core-calendar-heading`, `starci-core-calendar-grid` name HeroUI parts whose vendor paint
+ * Common leaves as it is. No shipped sheet paints them; the Grammar name lets a consumer or family
+ * select those parts without reaching for vendor class names.
+ */
+/**
+ * A date typed in segments or picked from a month grid in a popover. The trigger is a named button,
+ * the popover is a dialog that traps and returns focus, and the grid is the vendor's.
+ */
+export const DatePicker = ({ value, defaultValue, onValueChange, minValue, maxValue, isDateUnavailable, granularity = "day", ...field }) => {
+    const { anchor, portalProps } = useGrammarPortal();
+    return (_jsxs(HeroDatePicker, { "data-tier": "branch", "data-component": "DatePicker", "data-contract": "A11Y-1 FIELD-1 FIELD-2", className: "starci-core-field starci-core-date-picker", ...vendorFieldProps(field), isReadOnly: field.isReadOnly === true, granularity: granularity, ...(value === undefined ? defaultValue === undefined ? {} : { defaultValue } : { value }), ...(onValueChange === undefined ? {} : { onChange: onValueChange }), ...(minValue === undefined ? {} : { minValue }), ...(maxValue === undefined ? {} : { maxValue }), ...(isDateUnavailable === undefined ? {} : { isDateUnavailable }), children: [anchor, _jsx(FieldLabel, { isHidden: field.isLabelHidden, isRequired: field.isRequired, children: field.label }), _jsxs(HeroDateField.Group, { className: "starci-core-date-group", "data-grammar-field-control": "true", children: [_jsx(DateSegments, {}), _jsx(HeroDateField.Suffix, { className: "starci-core-date-suffix", children: _jsx(HeroDatePicker.Trigger, { className: "starci-core-date-trigger", children: _jsx(HeroDatePicker.TriggerIndicator, {}) }) })] }), _jsx(FieldDescription, { children: field.description }), _jsx(FieldErrorText, { children: field.errorMessage }), _jsx(HeroDatePicker.Popover, { className: "starci-core-date-popover", "data-grammar-popover": "DatePicker", "data-contract": "LAYOUT-4 FOCUS-3", ...portalProps, children: _jsx(PickerCalendar, {}) })] }));
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/core/branch/DateRangePicker/index.d.ts

@@ -0,0 +1,21 @@
+import { type DateValue, type RangeValue } from "@heroui/react";
+import { type FieldControlProps } from "../../primitive/Field/index.js";
+import { type DateGranularity } from "../../primitive/DateField/index.js";
+export type DateRangeValue = RangeValue<DateValue>;
+export type DateRangePickerProps = Omit<FieldControlProps, "name"> & {
+    readonly value?: DateRangeValue | null;
+    readonly defaultValue?: DateRangeValue | null;
+    readonly onValueChange?: (value: DateRangeValue | null) => void;
+    readonly minValue?: DateValue;
+    readonly maxValue?: DateValue;
+    readonly isDateUnavailable?: (date: DateValue) => boolean;
+    /** Lets a range span unavailable days; by default such a range is invalid. */
+    readonly allowsNonContiguousRanges?: boolean;
+    readonly granularity?: DateGranularity;
+    /** Form names for the two ends of the range. */
+    readonly startName?: string;
+    readonly endName?: string;
+};
+/** A start and an end date, typed in two segment groups or picked as a span on a month grid. */
+export declare const DateRangePicker: ({ value, defaultValue, onValueChange, minValue, maxValue, isDateUnavailable, allowsNonContiguousRanges, granularity, startName, endName, ...field }: DateRangePickerProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/branch/DateRangePicker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/DateRangePicker/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAGH,KAAK,SAAS,EACd,KAAK,UAAU,EAClB,MAAM,eAAe,CAAA;AACtB,OAAO,EAMH,KAAK,iBAAiB,EACzB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAGvF,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;AAElD,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAA;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAA;IACzD,8EAA8E;IAC9E,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAA;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAA;IACtC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAcD,gGAAgG;AAChG,eAAO,MAAM,eAAe,GAAI,qJAY7B,oBAAoB,gCAuCtB,CAAA"}

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

@@ -0,0 +1,22 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { DateField as HeroDateField, DateRangePicker as HeroDateRangePicker, } from "@heroui/react";
+import { FieldDescription, FieldErrorText, FieldLabel, useGrammarPortal, vendorFieldProps, } from "../../primitive/Field/index.js";
+import { DateSegments } from "../../primitive/DateField/index.js";
+import { PickerRangeCalendar } from "../DatePicker/index.js";
+/*
+ * Consumer hook: `starci-core-date-picker` 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 hooks: `starci-core-date-popover`, `starci-core-date-suffix` name HeroUI parts whose
+ * vendor paint Common leaves as it is. No shipped sheet paints them; the Grammar name lets a
+ * consumer or family select those parts without reaching for vendor class names.
+ */
+/** A start and an end date, typed in two segment groups or picked as a span on a month grid. */
+export const DateRangePicker = ({ value, defaultValue, onValueChange, minValue, maxValue, isDateUnavailable, allowsNonContiguousRanges = false, granularity = "day", startName, endName, ...field }) => {
+    const { anchor, portalProps } = useGrammarPortal();
+    return (_jsxs(HeroDateRangePicker, { "data-tier": "branch", "data-component": "DateRangePicker", "data-contract": "A11Y-1 FIELD-1 FIELD-2", className: "starci-core-field starci-core-date-picker", ...vendorFieldProps(field), isReadOnly: field.isReadOnly === true, granularity: granularity, allowsNonContiguousRanges: allowsNonContiguousRanges, ...(value === undefined ? defaultValue === undefined ? {} : { defaultValue } : { value }), ...(onValueChange === undefined ? {} : { onChange: onValueChange }), ...(minValue === undefined ? {} : { minValue }), ...(maxValue === undefined ? {} : { maxValue }), ...(isDateUnavailable === undefined ? {} : { isDateUnavailable }), ...(startName === undefined ? {} : { startName }), ...(endName === undefined ? {} : { endName }), children: [anchor, _jsx(FieldLabel, { isHidden: field.isLabelHidden, isRequired: field.isRequired, children: field.label }), _jsxs(HeroDateField.Group, { className: "starci-core-date-group", "data-grammar-field-control": "true", children: [_jsx(DateSegments, { slot: "start" }), _jsx(HeroDateRangePicker.RangeSeparator, { className: "starci-core-date-range-separator" }), _jsx(DateSegments, { slot: "end" }), _jsx(HeroDateField.Suffix, { className: "starci-core-date-suffix", children: _jsx(HeroDateRangePicker.Trigger, { className: "starci-core-date-trigger", children: _jsx(HeroDateRangePicker.TriggerIndicator, {}) }) })] }), _jsx(FieldDescription, { children: field.description }), _jsx(FieldErrorText, { children: field.errorMessage }), _jsx(HeroDateRangePicker.Popover, { className: "starci-core-date-popover", "data-grammar-popover": "DateRangePicker", "data-contract": "LAYOUT-4 FOCUS-3", ...portalProps, children: _jsx(PickerRangeCalendar, {}) })] }));
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/core/branch/Dialog/index.d.ts

@@ -0,0 +1,36 @@
+import { type ReactNode } from "react";
+import { type OverlayOpenState } from "../../overlayScope.js";
+export type DialogSize = "sm" | "md" | "lg" | "full";
+/** Footer content, or a function receiving `close` for actions that should dismiss the dialog. */
+export type OverlayFooter = ReactNode | ((close: () => void) => ReactNode);
+export type DialogProps = OverlayOpenState & {
+    /** Visible heading; it is the dialog's accessible name (`aria-labelledby`). */
+    readonly title: string;
+    /** Supporting sentence under the heading, wired as `aria-describedby`. */
+    readonly description?: ReactNode;
+    readonly children?: ReactNode;
+    readonly footer?: OverlayFooter;
+    /**
+     * The control that opens the dialog: a Common `Button`/`IconButton` (any React Aria pressable).
+     * Omit it and drive `isOpen` for a dialog opened by app state.
+     */
+    readonly trigger?: ReactNode;
+    /** Name for the header close button. Omit only when the footer offers its own way out. */
+    readonly closeLabel?: string;
+    readonly size?: DialogSize;
+    /** Close when the person presses outside the dialog. Default `true`. */
+    readonly isDismissable?: boolean;
+    /** Disable Escape. Default `false`; keep Escape unless leaving would lose unsaved work. */
+    readonly isKeyboardDismissDisabled?: boolean;
+};
+/**
+ * BRANCH - `Dialog` (modal): a focused task above the page.
+ *
+ * React Aria owns the behaviour: focus moves into the dialog and is trapped there, Escape and an
+ * outside press dismiss it (each can be turned off), page scroll is locked, everything outside is
+ * hidden from assistive tech, and focus returns to the trigger on close. The portal lands inside the
+ * nearest `.grammar-common-root` (see `useOverlayContainer`), so the family scope still applies.
+ * Contract: surface FOCUS-3 (modal trap/return) LAYOUT-4 (portalled) CORE-BOUNDARY-4 (shadow); container MOTION-2.
+ */
+export declare const Dialog: ({ title, description, children, footer, trigger, closeLabel, size, isDismissable, isKeyboardDismissDisabled, ...openState }: DialogProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/branch/Dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/Dialog/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAyC,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAGpG,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAA;AAEpD,kGAAkG;AAClG,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC,CAAA;AAE1E,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG;IACzC,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAA;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAA;IAC/B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAA;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAChC,2FAA2F;IAC3F,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAA;CAC/C,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,GAAI,6HAWpB,WAAW,gCAqDb,CAAA"}

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

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Modal as HeroModal } from "@heroui/react";
+import { useId } from "react";
+import { overlayOpenProps, useOverlayContainer } from "../../overlayScope.js";
+import { CloseButton } from "../../primitive/CloseButton/index.js";
+/**
+ * BRANCH - `Dialog` (modal): a focused task above the page.
+ *
+ * React Aria owns the behaviour: focus moves into the dialog and is trapped there, Escape and an
+ * outside press dismiss it (each can be turned off), page scroll is locked, everything outside is
+ * hidden from assistive tech, and focus returns to the trigger on close. The portal lands inside the
+ * nearest `.grammar-common-root` (see `useOverlayContainer`), so the family scope still applies.
+ * Contract: surface FOCUS-3 (modal trap/return) LAYOUT-4 (portalled) CORE-BOUNDARY-4 (shadow); container MOTION-2.
+ */
+export const Dialog = ({ title, description, children, footer, trigger, closeLabel, size = "md", isDismissable = true, isKeyboardDismissDisabled = false, ...openState }) => {
+    const { anchor, container } = useOverlayContainer("Dialog");
+    const descriptionId = useId();
+    return (_jsxs(HeroModal, { ...overlayOpenProps(openState), children: [trigger, anchor, container === null ? null : (_jsx(HeroModal.Backdrop, { UNSTABLE_portalContainer: container, isDismissable: isDismissable, isKeyboardDismissDisabled: isKeyboardDismissDisabled, "data-grammar-overlay-backdrop": "Dialog", className: "starci-core-overlay-backdrop", children: _jsx(HeroModal.Container, { placement: "center", size: size, scroll: "inside", "data-size": size, "data-contract": "MOTION-2", className: "starci-core-dialog-container", children: _jsx(HeroModal.Dialog, { "data-tier": "branch", "data-component": "Dialog", "data-size": size, "data-grammar-overlay-surface": "dialog", "data-contract": "FOCUS-3 LAYOUT-4 CORE-BOUNDARY-4", ...(description === undefined ? {} : { "aria-describedby": descriptionId }), className: "starci-core-dialog", children: ({ close }) => (_jsxs(_Fragment, { children: [_jsxs(HeroModal.Header, { className: "starci-core-overlay-header", children: [_jsxs("div", { className: "starci-core-overlay-heading-group", children: [_jsx(HeroModal.Heading, { className: "starci-core-overlay-title", children: title }), description === undefined ? null : (_jsx("p", { id: descriptionId, className: "starci-core-overlay-description", children: description }))] }), closeLabel === undefined ? null : _jsx(CloseButton, { label: closeLabel, onPress: close })] }), children === undefined ? null : (_jsx(HeroModal.Body, { className: "starci-core-overlay-body", children: children })), footer === undefined ? null : (_jsx(HeroModal.Footer, { className: "starci-core-overlay-footer", children: typeof footer === "function" ? footer(close) : footer }))] })) }) }) }))] }));
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/Dialog/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,KAAK,EAAkB,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAyB,MAAM,uBAAuB,CAAA;AACpG,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAA;AA4BlE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,EACnB,KAAK,EACL,WAAW,EACX,QAAQ,EACR,MAAM,EACN,OAAO,EACP,UAAU,EACV,IAAI,GAAG,IAAI,EACX,aAAa,GAAG,IAAI,EACpB,yBAAyB,GAAG,KAAK,EACjC,GAAG,SAAS,EACF,EAAE,EAAE;IACd,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAA;IAC3D,MAAM,aAAa,GAAG,KAAK,EAAE,CAAA;IAE7B,OAAO,CACH,MAAC,SAAS,OAAK,gBAAgB,CAAC,SAAS,CAAC,aACrC,OAAO,EACP,MAAM,EACN,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACzB,KAAC,SAAS,CAAC,QAAQ,IACf,wBAAwB,EAAE,SAAS,EACnC,aAAa,EAAE,aAAa,EAC5B,yBAAyB,EAAE,yBAAyB,mCACtB,QAAQ,EACtC,SAAS,EAAC,8BAA8B,YAExC,KAAC,SAAS,CAAC,SAAS,IAAC,SAAS,EAAC,QAAQ,EAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAC,QAAQ,eAAY,IAAI,mBAAgB,UAAU,EAAC,SAAS,EAAC,8BAA8B,YAClJ,KAAC,SAAS,CAAC,MAAM,iBACH,QAAQ,oBACH,QAAQ,eACZ,IAAI,kCACc,QAAQ,mBACvB,kCAAkC,KAC5C,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,aAAa,EAAE,CAAC,EAC5E,SAAS,EAAC,oBAAoB,YAE7B,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CACZ,8BACI,MAAC,SAAS,CAAC,MAAM,IAAC,SAAS,EAAC,4BAA4B,aACpD,eAAK,SAAS,EAAC,mCAAmC,aAC9C,KAAC,SAAS,CAAC,OAAO,IAAC,SAAS,EAAC,2BAA2B,YAAE,KAAK,GAAqB,EACnF,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAChC,YAAG,EAAE,EAAE,aAAa,EAAE,SAAS,EAAC,iCAAiC,YAAE,WAAW,GAAK,CACtF,IACC,EACL,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAC,WAAW,IAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,GAAI,IACtE,EAClB,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC7B,KAAC,SAAS,CAAC,IAAI,IAAC,SAAS,EAAC,0BAA0B,YAAE,QAAQ,GAAkB,CACnF,EACA,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC3B,KAAC,SAAS,CAAC,MAAM,IAAC,SAAS,EAAC,4BAA4B,YACnD,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GACvC,CACtB,IACF,CACN,GACc,GACD,GACL,CACxB,IACO,CACf,CAAA;AACL,CAAC,CAAA"}

package/dist/core/branch/Disclosure/index.d.ts

@@ -0,0 +1,22 @@
+import { type ReactNode } from "react";
+export type DisclosureProps = {
+    /** The always-visible trigger text. */
+    readonly title: ReactNode;
+    readonly children: ReactNode;
+    /** Controlled expansion. Omit for uncontrolled use with `defaultExpanded`. */
+    readonly isExpanded?: boolean;
+    readonly defaultExpanded?: boolean;
+    readonly onExpandedChange?: (isExpanded: boolean) => void;
+    readonly isDisabled?: boolean;
+    /** Heading level of the trigger's heading element. */
+    readonly headingLevel?: 2 | 3 | 4 | 5 | 6;
+    readonly className?: string;
+};
+/**
+ * One show/hide section (the generic, unframed disclosure; `SurfaceAccordionCard` is the framed
+ * card form). The trigger is a real button inside a heading with `aria-expanded`/`aria-controls`;
+ * `data-grammar-disclosure-state` mirrors the open state for the stylesheet.
+ * Contract: root STATE-7 (controlled expansion), trigger FOCUS-1, indicator MOTION-2.
+ */
+export declare const Disclosure: ({ title, children, isExpanded, defaultExpanded, onExpandedChange, isDisabled, headingLevel, className, }: DisclosureProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/branch/Disclosure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/Disclosure/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGhD,MAAM,MAAM,eAAe,GAAG;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAA;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAQD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,0GASxB,eAAe,gCA4BjB,CAAA"}