@starci/grammar 0.4.12 → 0.5.0

package/dist/core/primitive/CloseButton/index.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { CloseButton as HeroCloseButton } from "@heroui/react";
+/**
+ * ATOM - `CloseButton`: the glyph-only dismiss action used by dialogs, drawers, toasts and banners.
+ *
+ * It is the vendor close button (a real `<button type="button">` with the platform close glyph) with
+ * a mandatory name. Its pressable floor and focus ring are SHIPPED by `.starci-core-close-button` in
+ * `src/common/components-overlays.css`.
+ */
+export const CloseButton = ({ label, onPress, isDisabled = false, size = "md" }) => (_jsx(HeroCloseButton, { "data-tier": "atom", "data-component": "CloseButton", "data-size": size, "aria-label": label, "data-contract": "A11Y-2 ICON-5 FOCUS-1", isDisabled: isDisabled, className: "starci-core-close-button", ...(isDisabled || onPress === undefined ? {} : { onPress }) }));
+//# sourceMappingURL=index.js.map

package/dist/core/primitive/CloseButton/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/CloseButton/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,eAAe,CAAA;AAY9D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,GAAG,KAAK,EAAE,IAAI,GAAG,IAAI,EAAoB,EAAE,EAAE,CAAC,CAClG,KAAC,eAAe,iBACF,MAAM,oBACD,aAAa,eACjB,IAAI,gBACH,KAAK,mBACH,uBAAuB,EACrC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAC,0BAA0B,KAChC,CAAC,UAAU,IAAI,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAC9D,CACL,CAAA"}

package/dist/core/primitive/DateField/index.d.ts

@@ -0,0 +1,33 @@
+import { type DateValue } from "@heroui/react";
+import type { ReactNode } from "react";
+import { type FieldControlProps } from "../Field/index.js";
+export type DateGranularity = "day" | "hour" | "minute" | "second";
+export type DateFieldProps = FieldControlProps & {
+    readonly value?: DateValue | null;
+    readonly defaultValue?: DateValue | null;
+    readonly onValueChange?: (value: DateValue | null) => void;
+    readonly minValue?: DateValue;
+    readonly maxValue?: DateValue;
+    /** Smallest editable unit. `day` is a date; finer units add a time. */
+    readonly granularity?: DateGranularity;
+};
+/** The segmented date input (each part a spinbutton) shared by DateField, TimeField and the pickers. */
+export declare const DateSegments: ({ slot }: {
+    readonly slot?: "start" | "end";
+}) => import("react").JSX.Element;
+/**
+ * The field box around a standalone date or time input. A plain element with the vendor's group
+ * paint, NOT the vendor `Group`: the date input already renders the one labelled `role="group"`,
+ * and a second vendor Group would take the same id and name from the field context.
+ */
+export declare const DateFieldBox: ({ children, isInvalid, isDisabled }: {
+    readonly children: ReactNode;
+    readonly isInvalid: boolean;
+    readonly isDisabled: boolean;
+}) => import("react").JSX.Element;
+/**
+ * A typed date: locale-ordered segments that each take digits and arrow keys, the vendor's. Values
+ * are `@internationalized/date` objects (the vendor's `DateValue`), never ambiguous strings.
+ */
+export declare const DateField: ({ value, defaultValue, onValueChange, minValue, maxValue, granularity, ...field }: DateFieldProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/primitive/DateField/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/DateField/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAMH,KAAK,iBAAiB,EACzB,MAAM,mBAAmB,CAAA;AAE1B,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAElE,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG;IAC7C,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,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAA;CACzC,CAAA;AAQD,wGAAwG;AACxG,eAAO,MAAM,YAAY,GAAI,UAAU;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;CAAE,gCAIzE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,qCAAqC;IAC9D,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAC/B,gCAUA,CAAA;AAcD;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,mFAQvB,cAAc,gCAsBhB,CAAA"}

package/dist/core/primitive/DateField/index.js

@@ -0,0 +1,33 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { DateField as HeroDateField } from "@heroui/react";
+import { FieldDescription, FieldErrorText, FieldLabel, isFieldInvalid, vendorFieldProps, } from "../Field/index.js";
+// The vendor's own date-group slot classes. `DateField.Group` would stamp them from its context; the
+// standalone box below renders without that Group (see DateFieldBox), so it names them itself.
+const DATE_GROUP_CLASS = "date-input-group date-input-group--primary date-input-group--full-width starci-core-date-group";
+const DATE_INPUT_CLASS = "date-input-group__input starci-core-date-input";
+const DATE_SEGMENT_CLASS = "date-input-group__segment starci-core-date-segment";
+/** The segmented date input (each part a spinbutton) shared by DateField, TimeField and the pickers. */
+export const DateSegments = ({ slot }) => (_jsx(HeroDateField.Input, { className: DATE_INPUT_CLASS, ...(slot === undefined ? {} : { slot }), children: (segment) => _jsx(HeroDateField.Segment, { segment: segment, className: DATE_SEGMENT_CLASS }) }));
+/**
+ * The field box around a standalone date or time input. A plain element with the vendor's group
+ * paint, NOT the vendor `Group`: the date input already renders the one labelled `role="group"`,
+ * and a second vendor Group would take the same id and name from the field context.
+ */
+export const DateFieldBox = ({ children, isInvalid, isDisabled }) => (_jsx("div", { className: DATE_GROUP_CLASS, "data-slot": "date-input-group", "data-grammar-field-control": "true", ...(isInvalid ? { "data-invalid": "true" } : {}), ...(isDisabled ? { "data-disabled": "true" } : {}), children: children }));
+/*
+ * Consumer hook: `starci-core-date-field` 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-segment` names a HeroUI part whose vendor paint Common leaves
+ * as it is. No shipped sheet paints it; the Grammar name lets a consumer or family select that part
+ * without reaching for vendor class names.
+ */
+/**
+ * A typed date: locale-ordered segments that each take digits and arrow keys, the vendor's. Values
+ * are `@internationalized/date` objects (the vendor's `DateValue`), never ambiguous strings.
+ */
+export const DateField = ({ value, defaultValue, onValueChange, minValue, maxValue, granularity = "day", ...field }) => (_jsxs(HeroDateField, { "data-tier": "atom", "data-component": "DateField", "data-contract": "A11Y-1 FIELD-1 FIELD-2 FIELD-3", className: "starci-core-field starci-core-date-field", fullWidth: true, ...vendorFieldProps(field), isReadOnly: field.isReadOnly === true, granularity: granularity, ...(value === undefined ? defaultValue === undefined ? {} : { defaultValue } : { value }), ...(onValueChange === undefined ? {} : { onChange: onValueChange }), ...(minValue === undefined ? {} : { minValue }), ...(maxValue === undefined ? {} : { maxValue }), children: [_jsx(FieldLabel, { isHidden: field.isLabelHidden, isRequired: field.isRequired, children: field.label }), _jsx(DateFieldBox, { isInvalid: isFieldInvalid(field), isDisabled: field.isDisabled === true, children: _jsx(DateSegments, {}) }), _jsx(FieldDescription, { children: field.description }), _jsx(FieldErrorText, { children: field.errorMessage })] }));
+//# sourceMappingURL=index.js.map

package/dist/core/primitive/DateField/index.js.map

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

package/dist/core/primitive/Field/index.d.ts

@@ -0,0 +1,127 @@
+import { type ReactNode } from "react";
+import type { PresentationState } from "../../../common/state.js";
+/**
+ * The one field contract every Grammar form control shares.
+ *
+ * A control owns its label, its guidance and its validation copy, so a reader never meets a control
+ * whose error is painted somewhere the screen reader cannot find. Every form control in the package
+ * takes these props, renders the same label / description / error anatomy, and stamps the same
+ * `data-grammar-*` state hooks on its root, so a visual family targets one vocabulary instead of one
+ * per vendor part.
+ */
+export type FieldControlProps = {
+    /** The visible accessible name. Required: a placeholder is never a name. */
+    readonly label: ReactNode;
+    /** Keeps the label for assistive technology only; the name stays in the accessibility tree. */
+    readonly isLabelHidden?: boolean;
+    /** Guidance the control's `aria-describedby` points at. */
+    readonly description?: ReactNode;
+    /** Validation copy. Supplying it marks the control invalid, the same rule `Input` follows. */
+    readonly errorMessage?: ReactNode;
+    readonly isInvalid?: boolean;
+    readonly isRequired?: boolean;
+    readonly isDisabled?: boolean;
+    readonly isReadOnly?: boolean;
+    /** The form field name submitted with the value. */
+    readonly name?: string;
+};
+export type FieldStateInput = {
+    readonly isInvalid?: boolean | undefined;
+    readonly isDisabled?: boolean | undefined;
+    readonly isReadOnly?: boolean | undefined;
+    readonly isRequired?: boolean | undefined;
+    readonly isPending?: boolean | undefined;
+};
+/** Folds the control's state into the render-neutral presentation vocabulary. */
+export declare const fieldPresentationState: ({ isInvalid, isDisabled, isPending }: FieldStateInput) => PresentationState;
+/** The state hooks every form control root carries. Families read these, never vendor internals. */
+export declare const fieldStateAttributes: (state: FieldStateInput) => {
+    readonly "data-grammar-field": "true";
+    readonly "data-grammar-field-state": "neutral" | "informative" | "affirmative" | "cautionary" | "negative" | "pending" | "unavailable";
+    readonly "data-grammar-invalid": "true" | "false";
+    readonly "data-grammar-disabled": "true" | "false";
+    readonly "data-grammar-readonly": "true" | "false";
+    readonly "data-grammar-required": "true" | "false";
+    readonly "data-grammar-pending": "true" | "false";
+};
+/** A control is invalid when it says so or when it carries validation copy. */
+export declare const isFieldInvalid: ({ isInvalid, errorMessage }: {
+    readonly isInvalid?: boolean | undefined;
+    readonly errorMessage?: ReactNode;
+}) => boolean;
+/** Label wired through the vendor's field context, so the control is named without an id handshake. */
+export declare const FieldLabel: ({ children, isHidden, isRequired }: {
+    readonly children: ReactNode;
+    readonly isHidden?: boolean | undefined;
+    readonly isRequired?: boolean | undefined;
+}) => import("react").JSX.Element;
+/** Description slot; the vendor wires it into the control's `aria-describedby`. */
+export declare const FieldDescription: ({ children }: {
+    readonly children?: ReactNode;
+}) => import("react").JSX.Element | null;
+/**
+ * Error slot. It shows the supplied copy, or - when none is supplied - the messages the control's
+ * own validation produced (a required value, a native constraint, a Form `validationErrors` entry),
+ * and is referenced by the control's `aria-describedby` only while the control is invalid.
+ */
+export declare const FieldErrorText: ({ children }: {
+    readonly children?: ReactNode;
+}) => import("react").JSX.Element;
+/** The shared anatomy props every vendor field root gets. */
+export declare const vendorFieldProps: (props: FieldControlProps & {
+    readonly isPending?: boolean | undefined;
+}) => {
+    "data-grammar-field": "true";
+    "data-grammar-field-state": "neutral" | "informative" | "affirmative" | "cautionary" | "negative" | "pending" | "unavailable";
+    "data-grammar-invalid": "true" | "false";
+    "data-grammar-disabled": "true" | "false";
+    "data-grammar-readonly": "true" | "false";
+    "data-grammar-required": "true" | "false";
+    "data-grammar-pending": "true" | "false";
+    name?: string;
+    isRequired?: boolean;
+    isDisabled?: boolean;
+    isInvalid?: boolean;
+};
+/**
+ * Keeps a control's popover inside the Grammar root it was rendered in.
+ *
+ * The vendor portals popovers to `document.body`, which is outside `.grammar-common-root`: the
+ * family's scoped variables (accent, field paint, radii) and scoped rules would not reach the open
+ * list or calendar, so a Core or Offset Pop picker would open onto the vendor's default theme. The
+ * anchor finds the nearest root once mounted and the popover portals there instead; with no root
+ * (bare usage) nothing changes.
+ */
+export declare const useGrammarPortal: () => {
+    anchor: import("react").JSX.Element;
+    portalProps: {
+        UNSTABLE_portalContainer?: never;
+    } | {
+        UNSTABLE_portalContainer: Element;
+    };
+};
+/** What `Field` hands the control it wraps: the id and ARIA wiring for a native or custom control. */
+export type FieldControlAttributes = {
+    readonly id: string;
+    readonly name?: string;
+    readonly "aria-describedby"?: string;
+    readonly "aria-invalid"?: true;
+    readonly "aria-required"?: true;
+    readonly required?: true;
+    readonly disabled?: true;
+    readonly readOnly?: true;
+};
+export type FieldProps = FieldControlProps & {
+    /** Control id. Generated when omitted. */
+    readonly id?: string;
+    /** Renders the control with the attributes that bind it to this field's label, guidance and error. */
+    readonly children: (control: FieldControlAttributes) => ReactNode;
+};
+/**
+ * Label + description + error for ANY control: a native element, a third-party widget, or an app's
+ * own input. Grammar's own form controls already render this anatomy; `Field` is the same anatomy
+ * for everything else, with the id and `aria-describedby` / `aria-invalid` wiring handed to the
+ * control so a custom control is announced exactly like a Grammar one.
+ */
+export declare const Field: ({ id: idProp, label, isLabelHidden, description, errorMessage, isInvalid, isRequired, isDisabled, isReadOnly, name, children, }: FieldProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/primitive/Field/index.d.ts.map

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

package/dist/core/primitive/Field/index.js

@@ -0,0 +1,100 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Description as HeroDescription, FieldError as HeroFieldError, Label as HeroLabel, } from "@heroui/react";
+import { useCallback, useId, useState } from "react";
+/** Folds the control's state into the render-neutral presentation vocabulary. */
+export const fieldPresentationState = ({ isInvalid, isDisabled, isPending }) => {
+    if (isDisabled === true)
+        return "unavailable";
+    if (isPending === true)
+        return "pending";
+    if (isInvalid === true)
+        return "negative";
+    return "neutral";
+};
+const flag = (value) => (value === true ? "true" : "false");
+/** The state hooks every form control root carries. Families read these, never vendor internals. */
+export const fieldStateAttributes = (state) => ({
+    "data-grammar-field": "true",
+    "data-grammar-field-state": fieldPresentationState(state),
+    "data-grammar-invalid": flag(state.isInvalid),
+    "data-grammar-disabled": flag(state.isDisabled),
+    "data-grammar-readonly": flag(state.isReadOnly),
+    "data-grammar-required": flag(state.isRequired),
+    "data-grammar-pending": flag(state.isPending),
+});
+/** A control is invalid when it says so or when it carries validation copy. */
+export const isFieldInvalid = ({ isInvalid, errorMessage }) => isInvalid === true || errorMessage != null;
+const labelClassName = (isHidden) => isHidden === true ? "starci-core-field-label starci-core-form-label--screen-reader" : "starci-core-field-label";
+/** Label wired through the vendor's field context, so the control is named without an id handshake. */
+export const FieldLabel = ({ children, isHidden, isRequired }) => (_jsx(HeroLabel, { className: labelClassName(isHidden), "data-grammar-field-label": "true", ...(isRequired === true ? { isRequired: true } : {}), children: children }));
+/** Description slot; the vendor wires it into the control's `aria-describedby`. */
+export const FieldDescription = ({ children }) => (children == null ? null : (_jsx(HeroDescription, { className: "starci-core-field-description", "data-grammar-field-description": "true", children: children })));
+/**
+ * Error slot. It shows the supplied copy, or - when none is supplied - the messages the control's
+ * own validation produced (a required value, a native constraint, a Form `validationErrors` entry),
+ * and is referenced by the control's `aria-describedby` only while the control is invalid.
+ */
+export const FieldErrorText = ({ children }) => (_jsx(HeroFieldError, { className: "starci-core-field-error", "data-grammar-field-error": "true", "data-contract": "FEEDBACK-1", children: (validation) => children ?? validation.validationErrors.join(" ") }));
+/** The shared anatomy props every vendor field root gets. */
+export const vendorFieldProps = (props) => {
+    const invalid = isFieldInvalid(props);
+    // Only a true state is stated: an explicit `false` would override what a Fieldset (disabled) or a
+    // Form (`validationErrors`) hands the control through the vendor's context.
+    return {
+        ...(invalid ? { isInvalid: true } : {}),
+        ...(props.isDisabled === true ? { isDisabled: true } : {}),
+        ...(props.isRequired === true ? { isRequired: true } : {}),
+        ...(props.name === undefined ? {} : { name: props.name }),
+        ...fieldStateAttributes({
+            isInvalid: invalid,
+            isDisabled: props.isDisabled,
+            isReadOnly: props.isReadOnly,
+            isRequired: props.isRequired,
+            isPending: props.isPending,
+        }),
+    };
+};
+/**
+ * Keeps a control's popover inside the Grammar root it was rendered in.
+ *
+ * The vendor portals popovers to `document.body`, which is outside `.grammar-common-root`: the
+ * family's scoped variables (accent, field paint, radii) and scoped rules would not reach the open
+ * list or calendar, so a Core or Offset Pop picker would open onto the vendor's default theme. The
+ * anchor finds the nearest root once mounted and the popover portals there instead; with no root
+ * (bare usage) nothing changes.
+ */
+export const useGrammarPortal = () => {
+    const [container, setContainer] = useState(undefined);
+    const anchor = useCallback((node) => {
+        setContainer(node?.closest(".grammar-common-root") ?? undefined);
+    }, []);
+    return {
+        anchor: _jsx("span", { ref: anchor, hidden: true, "data-grammar-portal-anchor": "true" }),
+        portalProps: container === undefined ? {} : { UNSTABLE_portalContainer: container },
+    };
+};
+/**
+ * Label + description + error for ANY control: a native element, a third-party widget, or an app's
+ * own input. Grammar's own form controls already render this anatomy; `Field` is the same anatomy
+ * for everything else, with the id and `aria-describedby` / `aria-invalid` wiring handed to the
+ * control so a custom control is announced exactly like a Grammar one.
+ */
+export const Field = ({ id: idProp, label, isLabelHidden, description, errorMessage, isInvalid, isRequired, isDisabled, isReadOnly, name, children, }) => {
+    const generated = useId();
+    const id = idProp ?? `field${generated.replace(/:/g, "")}`;
+    const invalid = isFieldInvalid({ isInvalid, errorMessage });
+    const descriptionId = description == null ? undefined : `${id}-description`;
+    const errorId = invalid && errorMessage != null ? `${id}-error` : undefined;
+    const describedBy = [descriptionId, errorId].filter((part) => part !== undefined).join(" ");
+    return (_jsxs("div", { "data-tier": "atom", "data-component": "Field", "data-contract": "A11Y-1 FIELD-1 FIELD-2", className: "starci-core-field", ...fieldStateAttributes({ isInvalid: invalid, isDisabled, isReadOnly, isRequired }), children: [_jsxs("label", { htmlFor: id, className: labelClassName(isLabelHidden), "data-grammar-field-label": "true", "data-required": isRequired === true ? "true" : undefined, children: [label, isRequired === true ? _jsx("span", { "aria-hidden": "true", className: "starci-core-field-required", children: "*" }) : null] }), description == null ? null : (_jsx("span", { id: descriptionId, className: "starci-core-field-description", "data-grammar-field-description": "true", children: description })), _jsx("div", { className: "starci-core-field-control", "data-grammar-field-control": "true", children: children({
+                    id,
+                    ...(name === undefined ? {} : { name }),
+                    ...(describedBy === "" ? {} : { "aria-describedby": describedBy }),
+                    ...(invalid ? { "aria-invalid": true } : {}),
+                    ...(isRequired === true ? { "aria-required": true, required: true } : {}),
+                    ...(isDisabled === true ? { disabled: true } : {}),
+                    ...(isReadOnly === true ? { readOnly: true } : {}),
+                }) }), errorId === undefined ? null : (_jsx("span", { id: errorId, className: "starci-core-field-error", "data-grammar-field-error": "true", "data-contract": "FEEDBACK-1", children: errorMessage }))] }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/primitive/Field/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/Field/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EACH,WAAW,IAAI,eAAe,EAC9B,UAAU,IAAI,cAAc,EAC5B,KAAK,IAAI,SAAS,GACrB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAA;AAqCpE,iFAAiF;AACjF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAmB,EAAqB,EAAE;IAC/G,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,aAAa,CAAA;IAC7C,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAA;IACxC,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,UAAU,CAAA;IACzC,OAAO,SAAS,CAAA;AACpB,CAAC,CAAA;AAED,MAAM,IAAI,GAAG,CAAC,KAA0B,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;AAEhF,oGAAoG;AACpG,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAsB,EAAE,EAAE,CAAC,CAAC;IAC7D,oBAAoB,EAAE,MAAM;IAC5B,0BAA0B,EAAE,sBAAsB,CAAC,KAAK,CAAC;IACzD,sBAAsB,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;IAC7C,uBAAuB,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;IAC/C,uBAAuB,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;IAC/C,uBAAuB,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;IAC/C,sBAAsB,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;CAChD,CAAU,CAAA;AAEX,+EAA+E;AAC/E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAE,SAAS,EAAE,YAAY,EAGvD,EAAE,EAAE,CACD,SAAS,KAAK,IAAI,IAAI,YAAY,IAAI,IAAI,CAAA;AAE9C,MAAM,cAAc,GAAG,CAAC,QAA6B,EAAE,EAAE,CACrD,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,+DAA+D,CAAC,CAAC,CAAC,yBAAyB,CAAA;AAEnH,uGAAuG;AACvG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAI1D,EAAE,EAAE,CAAC,CACF,KAAC,SAAS,IACN,SAAS,EAAE,cAAc,CAAC,QAAQ,CAAC,8BACV,MAAM,KAC3B,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YAEpD,QAAQ,GACD,CACf,CAAA;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAAE,QAAQ,EAAqC,EAAE,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC5G,KAAC,eAAe,IAAC,SAAS,EAAC,+BAA+B,oCAAgC,MAAM,YAC3F,QAAQ,GACK,CACrB,CAAC,CAAA;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAE,QAAQ,EAAqC,EAAE,EAAE,CAAC,CAC/E,KAAC,cAAc,IAAC,SAAS,EAAC,yBAAyB,8BAA0B,MAAM,mBAAe,YAAY,YACzG,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,IAAI,UAAU,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,GACrD,CACpB,CAAA;AAED,6DAA6D;AAC7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAuE,EAAE,EAAE;IACxG,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;IACrC,kGAAkG;IAClG,4EAA4E;IAC5E,OAAO;QACH,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACzD,GAAG,oBAAoB,CAAC;YACpB,SAAS,EAAE,OAAO;YAClB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;SAC7B,CAAC;KACL,CAAA;AACL,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,EAAE;IACjC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAsB,SAAS,CAAC,CAAA;IAC1E,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,IAAwB,EAAE,EAAE;QACpD,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,sBAAsB,CAAC,IAAI,SAAS,CAAC,CAAA;IACpE,CAAC,EAAE,EAAE,CAAC,CAAA;IACN,OAAO;QACH,MAAM,EAAE,eAAM,GAAG,EAAE,MAAM,EAAE,MAAM,sCAA4B,MAAM,GAAG;QACtE,WAAW,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,wBAAwB,EAAE,SAAS,EAAE;KACtF,CAAA;AACL,CAAC,CAAA;AAqBD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAClB,EAAE,EAAE,MAAM,EACV,KAAK,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,IAAI,EACJ,QAAQ,GACC,EAAE,EAAE;IACb,MAAM,SAAS,GAAG,KAAK,EAAE,CAAA;IACzB,MAAM,EAAE,GAAG,MAAM,IAAI,QAAQ,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAA;IAC1D,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAA;IAC3D,MAAM,aAAa,GAAG,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,cAAc,CAAA;IAC3E,MAAM,OAAO,GAAG,OAAO,IAAI,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAA;IAC3E,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,4BACc,MAAM,oBACD,OAAO,mBACR,wBAAwB,EACtC,SAAS,EAAC,mBAAmB,KACzB,oBAAoB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,aAEpF,iBACI,OAAO,EAAE,EAAE,EACX,SAAS,EAAE,cAAc,CAAC,aAAa,CAAC,8BACf,MAAM,mBAChB,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,aAEtD,KAAK,EACL,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,8BAAkB,MAAM,EAAC,SAAS,EAAC,4BAA4B,kBAAS,CAAC,CAAC,CAAC,IAAI,IAClG,EACP,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC1B,eAAM,EAAE,EAAE,aAAa,EAAE,SAAS,EAAC,+BAA+B,oCAAgC,MAAM,YACnG,WAAW,GACT,CACV,EACD,cAAK,SAAS,EAAC,2BAA2B,gCAA4B,MAAM,YACvE,QAAQ,CAAC;oBACN,EAAE;oBACF,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;oBACvC,GAAG,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,WAAW,EAAE,CAAC;oBAClE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5C,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzE,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAClD,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACrD,CAAC,GACA,EACL,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC5B,eAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAC,yBAAyB,8BAA0B,MAAM,mBAAe,YAAY,YAC5G,YAAY,GACV,CACV,IACC,CACT,CAAA;AACL,CAAC,CAAA"}

package/dist/core/primitive/FileDropzone/index.d.ts

@@ -0,0 +1,25 @@
+import { type ReactNode } from "react";
+import { type FieldControlProps } from "../Field/index.js";
+export type FileDropzoneProps = FieldControlProps & {
+    readonly id?: string;
+    /** Native `accept` list, e.g. `image/*,.pdf`. A hint to the picker, not a security check. */
+    readonly accept?: string;
+    readonly multiple?: boolean;
+    /** The files now in the input. Upload, size checks and previews are the app's. */
+    readonly onFilesChange?: (files: Array<File>) => void;
+    /** Copy inside the drop target. The words are the app's. */
+    readonly prompt: ReactNode;
+    /** Decorative glyph above the prompt. */
+    readonly icon?: ReactNode;
+    /** Hides the list of chosen file names under the target. */
+    readonly hideFileList?: boolean;
+};
+/**
+ * A native file input stretched over a drop target.
+ *
+ * The browser owns picking, keyboard activation, the "choose file" announcement and dropping (a
+ * file dropped on a file input is a native change), so the files land in the real input and submit
+ * with the form. Grammar adds only the drag-over state, the field anatomy, and the chosen names.
+ */
+export declare const FileDropzone: ({ id: idProp, accept, multiple, onFilesChange, prompt, icon, hideFileList, label, isLabelHidden, description, errorMessage, isInvalid, isRequired, isDisabled, isReadOnly, name, }: FileDropzoneProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/primitive/FileDropzone/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/FileDropzone/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACvD,OAAO,EAAwC,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAEhG,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG;IAChD,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,kFAAkF;IAClF,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;IACrD,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAClC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,oLAiB1B,iBAAiB,gCA8EnB,CAAA"}

package/dist/core/primitive/FileDropzone/index.js

@@ -0,0 +1,35 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId, useState } from "react";
+import { fieldStateAttributes, isFieldInvalid } from "../Field/index.js";
+/**
+ * A native file input stretched over a drop target.
+ *
+ * The browser owns picking, keyboard activation, the "choose file" announcement and dropping (a
+ * file dropped on a file input is a native change), so the files land in the real input and submit
+ * with the form. Grammar adds only the drag-over state, the field anatomy, and the chosen names.
+ */
+export const FileDropzone = ({ id: idProp, accept, multiple = false, onFilesChange, prompt, icon, hideFileList = false, label, isLabelHidden, description, errorMessage, isInvalid, isRequired, isDisabled, isReadOnly, name, }) => {
+    const generated = useId().replace(/:/g, "");
+    const id = idProp ?? `file${generated}`;
+    const [isDragging, setIsDragging] = useState(false);
+    const [files, setFiles] = useState([]);
+    const invalid = isFieldInvalid({ isInvalid, errorMessage });
+    const blocked = isDisabled === true || isReadOnly === true;
+    const descriptionId = description == null ? undefined : `${id}-description`;
+    const errorId = invalid && errorMessage != null ? `${id}-error` : undefined;
+    const describedBy = [descriptionId, errorId].filter((part) => part !== undefined).join(" ");
+    return (_jsxs("div", { "data-tier": "atom", "data-component": "FileDropzone", "data-contract": "A11Y-1 FIELD-1 FIELD-2 FIELD-3", className: "starci-core-field starci-core-file-dropzone", ...fieldStateAttributes({ isInvalid: invalid, isDisabled, isReadOnly, isRequired }), children: [_jsxs("label", { htmlFor: id, className: isLabelHidden === true ? "starci-core-field-label starci-core-form-label--screen-reader" : "starci-core-field-label", "data-grammar-field-label": "true", "data-required": isRequired === true ? "true" : undefined, children: [label, isRequired === true ? _jsx("span", { "aria-hidden": "true", className: "starci-core-field-required", children: "*" }) : null] }), descriptionId === undefined ? null : (_jsx("span", { id: descriptionId, className: "starci-core-field-description", "data-grammar-field-description": "true", children: description })), _jsxs("div", { className: "starci-core-file-dropzone-target", "data-grammar-field-control": "true", "data-grammar-drag": isDragging ? "over" : "idle", "data-contract": "FOCUS-5", onDragEnter: () => { if (!blocked)
+                    setIsDragging(true); }, onDragOver: (event) => { if (blocked)
+                    event.preventDefault(); }, onDragLeave: () => setIsDragging(false), onDrop: (event) => {
+                    setIsDragging(false);
+                    if (blocked)
+                        event.preventDefault();
+                }, children: [_jsx("input", { id: id, type: "file", className: "starci-core-file-dropzone-input", ...(accept === undefined ? {} : { accept }), ...(name === undefined ? {} : { name }), multiple: multiple, disabled: isDisabled === true, required: isRequired === true, "aria-readonly": isReadOnly === true ? true : undefined, ...(invalid ? { "aria-invalid": true } : {}), ...(describedBy === "" ? {} : { "aria-describedby": describedBy }), onClick: (event) => { if (isReadOnly === true)
+                            event.preventDefault(); }, onChange: (event) => {
+                            const next = Array.from(event.currentTarget.files ?? []);
+                            setFiles(next);
+                            onFilesChange?.(next);
+                        } }), _jsxs("span", { className: "starci-core-file-dropzone-prompt", children: [icon == null ? null : _jsx("span", { "aria-hidden": "true", className: "starci-core-file-dropzone-icon", "data-contract": "ICON-6", children: icon }), _jsx("span", { children: prompt })] })] }), hideFileList || files.length === 0 ? null : (_jsx("ul", { className: "starci-core-file-dropzone-files", "data-grammar-file-list": "true", "aria-live": "polite", children: files.map((file, index) => _jsx("li", { children: file.name }, `${file.name}-${index}`)) })), errorId === undefined ? null : (_jsx("span", { id: errorId, className: "starci-core-field-error", "data-grammar-field-error": "true", "data-contract": "FEEDBACK-1", children: errorMessage }))] }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/primitive/FileDropzone/index.js.map

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

package/dist/core/primitive/GrammarRoot/index.d.ts

@@ -5,6 +5,11 @@ export type GrammarRootProps = Omit<ComponentPropsWithoutRef<"div">, "color"> &
     /** Visual families install their scoped material contract on this neutral root. */
     readonly "data-grammar-family"?: string;
 };
-/** Neutral Common boundary. Select a visual family with its `scopeProps`. */
+/**
+ * Neutral Common boundary. Select a visual family with its `scopeProps`.
+ *
+ * Contract: COLOR-5 - the root publishes the theme scope (`data-grammar-theme`) every family keys its
+ * light, dark and system token blocks on.
+ */
 export declare const GrammarRoot: ({ className, theme, ...props }: GrammarRootProps) => import("react").JSX.Element;
 //# sourceMappingURL=index.d.ts.map

package/dist/core/primitive/GrammarRoot/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/GrammarRoot/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,OAAO,CAAA;AAErD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,GAAG;IAC5E,uFAAuF;IACvF,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAA;IAC5C,mFAAmF;IACnF,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC1C,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,WAAW,GAAI,gCAA2C,gBAAgB,gCAOtF,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/GrammarRoot/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,OAAO,CAAA;AAErD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,GAAG;IAC5E,uFAAuF;IACvF,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAA;IAC5C,mFAAmF;IACnF,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC1C,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,gCAA2C,gBAAgB,gCAQtF,CAAA"}

package/dist/core/primitive/GrammarRoot/index.js

@@ -1,5 +1,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { cn } from "@heroui/react";
-/** Neutral Common boundary. Select a visual family with its `scopeProps`. */
-export const GrammarRoot = ({ className, theme = "system", ...props }) => (_jsx("div", { ...props, className: cn("grammar-common-root", className), "data-grammar": "common", "data-grammar-theme": theme }));
+/**
+ * Neutral Common boundary. Select a visual family with its `scopeProps`.
+ *
+ * Contract: COLOR-5 - the root publishes the theme scope (`data-grammar-theme`) every family keys its
+ * light, dark and system token blocks on.
+ */
+export const GrammarRoot = ({ className, theme = "system", ...props }) => (_jsx("div", { ...props, className: cn("grammar-common-root", className), "data-contract": "COLOR-5", "data-grammar": "common", "data-grammar-theme": theme }));
 //# sourceMappingURL=index.js.map

package/dist/core/primitive/GrammarRoot/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/GrammarRoot/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAUlC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAoB,EAAE,EAAE,CAAC,CACxF,iBACQ,KAAK,EACT,SAAS,EAAE,EAAE,CAAC,qBAAqB,EAAE,SAAS,CAAC,kBAClC,QAAQ,wBACD,KAAK,GAC3B,CACL,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/GrammarRoot/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAUlC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAoB,EAAE,EAAE,CAAC,CACxF,iBACQ,KAAK,EACT,SAAS,EAAE,EAAE,CAAC,qBAAqB,EAAE,SAAS,CAAC,mBACjC,SAAS,kBACV,QAAQ,wBACD,KAAK,GAC3B,CACL,CAAA"}

package/dist/core/primitive/Icon/index.d.ts

@@ -15,6 +15,7 @@ export type IconSourceProps = {
     readonly "data-tier"?: string;
     readonly "data-component"?: string;
     readonly "data-usage"?: string;
+    readonly "data-contract"?: string;
 };
 /** Function or class SVG glyph selected by the consuming app's icon registry. */
 export type IconSource = ((props: IconSourceProps) => unknown) | (new (props: IconSourceProps) => unknown);
@@ -26,6 +27,11 @@ export type IconProps = {
     readonly ariaLabel?: string;
     readonly isSkeleton?: boolean;
 };
-/** Product-neutral icon carrier; semantic glyph names and libraries remain app authority. */
+/**
+ * Product-neutral icon carrier; semantic glyph names and libraries remain app authority.
+ *
+ * Contract: ICON-1 (the app resolves the glyph, Common owns its box) and ICON-6 (named once when it
+ * carries meaning, `aria-hidden` when it does not).
+ */
 export declare const Icon: ({ source: Source, usage, ariaLabel, isSkeleton }: IconProps) => import("react").JSX.Element;
 //# sourceMappingURL=index.d.ts.map

package/dist/core/primitive/Icon/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/Icon/index.tsx"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA;AACtD;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CACjC,CAAA;AAED,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAChB,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,GACrC,CAAC,KAAK,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,CAAA;AAE/C,MAAM,MAAM,SAAS,GAAG;IACpB,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AAaD,6FAA6F;AAC7F,eAAO,MAAM,IAAI,GAAI,kDAAmE,SAAS,gCAoBhG,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/Icon/index.tsx"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA;AACtD;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CACpC,CAAA;AAED,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAChB,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,GACrC,CAAC,KAAK,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,CAAA;AAE/C,MAAM,MAAM,SAAS,GAAG;IACpB,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AAaD;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GAAI,kDAAmE,SAAS,gCAqBhG,CAAA"}

package/dist/core/primitive/Icon/index.js

@@ -9,7 +9,12 @@ const ICON_CLASS_NAME = "starci-core-icon";
 const SKELETON_CLASS_NAME = skeletonVariants({ animationType: "shimmer" }).base({
     className: "starci-core-icon-skeleton",
 });
-/** Product-neutral icon carrier; semantic glyph names and libraries remain app authority. */
+/**
+ * Product-neutral icon carrier; semantic glyph names and libraries remain app authority.
+ *
+ * Contract: ICON-1 (the app resolves the glyph, Common owns its box) and ICON-6 (named once when it
+ * carries meaning, `aria-hidden` when it does not).
+ */
 export const Icon = ({ source: Source, usage = "chip", ariaLabel, isSkeleton = false }) => {
     if (isSkeleton) {
         return _jsx("span", { "data-tier": "atom", "data-component": "Icon", "data-loading": "true", "aria-hidden": true, className: SKELETON_CLASS_NAME });
@@ -17,7 +22,7 @@ export const Icon = ({ source: Source, usage = "chip", ariaLabel, isSkeleton = f
     // The private cast is the only React-type identity boundary. Consumers see the structural
     // IconSource contract above, while JSX still receives the local React component type.
     const SourceComponent = Source;
-    return (_jsx(SourceComponent, { "data-tier": "atom", "data-component": "Icon", "data-usage": usage, focusable: "false", className: ICON_CLASS_NAME, ...(ariaLabel === undefined
+    return (_jsx(SourceComponent, { "data-tier": "atom", "data-component": "Icon", "data-usage": usage, "data-contract": "ICON-1 ICON-6", focusable: "false", className: ICON_CLASS_NAME, ...(ariaLabel === undefined
             ? { "aria-hidden": true }
             : { "aria-label": ariaLabel, role: "img" }) }));
 };

package/dist/core/primitive/Icon/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/Icon/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAoChD;;;;GAIG;AACH,MAAM,eAAe,GAAG,kBAAkB,CAAA;AAE1C,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC;IAC5E,SAAS,EAAE,2BAA2B;CACzC,CAAC,CAAA;AAEF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,KAAK,EAAa,EAAE,EAAE;IACjG,IAAI,UAAU,EAAE,CAAC;QACb,OAAO,4BAAgB,MAAM,oBAAgB,MAAM,kBAAc,MAAM,uBAAa,SAAS,EAAE,mBAAmB,GAAI,CAAA;IAC1H,CAAC;IAED,0FAA0F;IAC1F,sFAAsF;IACtF,MAAM,eAAe,GAAG,MAAgD,CAAA;IACxE,OAAO,CACH,KAAC,eAAe,iBACF,MAAM,oBACD,MAAM,gBACT,KAAK,EACjB,SAAS,EAAC,OAAO,EACjB,SAAS,EAAE,eAAe,KACtB,CAAC,SAAS,KAAK,SAAS;YACxB,CAAC,CAAC,EAAE,aAAa,EAAE,IAAa,EAAE;YAClC,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,KAAc,EAAE,CAAC,GAC1D,CACL,CAAA;AACL,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/Icon/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAqChD;;;;GAIG;AACH,MAAM,eAAe,GAAG,kBAAkB,CAAA;AAE1C,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC;IAC5E,SAAS,EAAE,2BAA2B;CACzC,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,KAAK,EAAa,EAAE,EAAE;IACjG,IAAI,UAAU,EAAE,CAAC;QACb,OAAO,4BAAgB,MAAM,oBAAgB,MAAM,kBAAc,MAAM,uBAAa,SAAS,EAAE,mBAAmB,GAAI,CAAA;IAC1H,CAAC;IAED,0FAA0F;IAC1F,sFAAsF;IACtF,MAAM,eAAe,GAAG,MAAgD,CAAA;IACxE,OAAO,CACH,KAAC,eAAe,iBACF,MAAM,oBACD,MAAM,gBACT,KAAK,mBACH,eAAe,EAC7B,SAAS,EAAC,OAAO,EACjB,SAAS,EAAE,eAAe,KACtB,CAAC,SAAS,KAAK,SAAS;YACxB,CAAC,CAAC,EAAE,aAAa,EAAE,IAAa,EAAE;YAClC,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,KAAc,EAAE,CAAC,GAC1D,CACL,CAAA;AACL,CAAC,CAAA"}

package/dist/core/primitive/IconButton/index.d.ts

@@ -8,6 +8,6 @@ export type IconButtonProps = {
     readonly isSkeleton?: boolean;
     readonly onPress?: () => void;
 };
-/** Circular glyph-only action with a mandatory accessible name. */
+/** Circular glyph-only action with a mandatory accessible name (A11Y-2, ICON-5). */
 export declare const IconButton: ({ source, label, isActive, isDisabled, isSkeleton, onPress, }: IconButtonProps) => import("react").JSX.Element;
 //# sourceMappingURL=index.d.ts.map

package/dist/core/primitive/IconButton/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/IconButton/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAExD,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CAChC,CAAA;AAQD,mEAAmE;AACnE,eAAO,MAAM,UAAU,GAAI,+DAOxB,eAAe,gCAgBjB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/IconButton/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAExD,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CAChC,CAAA;AAQD,oFAAoF;AACpF,eAAO,MAAM,UAAU,GAAI,+DAOxB,eAAe,gCAiBjB,CAAA"}

package/dist/core/primitive/IconButton/index.js

@@ -6,6 +6,6 @@ import { Icon } from "../Icon/index.js";
  * resolved action and its resting shimmer alike; only the shimmer itself comes from the vendor.
  */
 const SKELETON_CLASS_NAME = skeletonVariants({ animationType: "shimmer" }).base();
-/** Circular glyph-only action with a mandatory accessible name. */
-export const IconButton = ({ source, label, isActive = false, isDisabled = false, isSkeleton = false, onPress, }) => (_jsx(HeroButton, { "data-tier": "atom", "data-component": "IconButton", "data-active": isActive ? "true" : "false", "data-loading": isSkeleton ? "true" : "false", type: "button", variant: "tertiary", className: cn("starci-core-icon-button", isSkeleton ? SKELETON_CLASS_NAME : undefined) ?? "starci-core-icon-button", isIconOnly: true, isDisabled: isDisabled || isSkeleton, "aria-label": label, ...(isDisabled || isSkeleton || onPress === undefined ? {} : { onPress }), children: isSkeleton ? null : _jsx(Icon, { source: source, usage: "leading" }) }));
+/** Circular glyph-only action with a mandatory accessible name (A11Y-2, ICON-5). */
+export const IconButton = ({ source, label, isActive = false, isDisabled = false, isSkeleton = false, onPress, }) => (_jsx(HeroButton, { "data-tier": "atom", "data-component": "IconButton", "data-contract": "A11Y-2 ICON-5", "data-active": isActive ? "true" : "false", "data-loading": isSkeleton ? "true" : "false", type: "button", variant: "tertiary", className: cn("starci-core-icon-button", isSkeleton ? SKELETON_CLASS_NAME : undefined) ?? "starci-core-icon-button", isIconOnly: true, isDisabled: isDisabled || isSkeleton, "aria-label": label, ...(isDisabled || isSkeleton || onPress === undefined ? {} : { onPress }), children: isSkeleton ? null : _jsx(Icon, { source: source, usage: "leading" }) }));
 //# sourceMappingURL=index.js.map

package/dist/core/primitive/IconButton/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/IconButton/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC1E,OAAO,EAAE,IAAI,EAAmB,MAAM,kBAAkB,CAAA;AAYxD;;;GAGG;AACH,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;AAEjF,mEAAmE;AACnE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EACvB,MAAM,EACN,KAAK,EACL,QAAQ,GAAG,KAAK,EAChB,UAAU,GAAG,KAAK,EAClB,UAAU,GAAG,KAAK,EAClB,OAAO,GACO,EAAE,EAAE,CAAC,CACnB,KAAC,UAAU,iBACG,MAAM,oBACD,YAAY,iBACd,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,kBAC1B,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAC3C,IAAI,EAAC,QAAQ,EACb,OAAO,EAAC,UAAU,EAClB,SAAS,EAAE,EAAE,CAAC,yBAAyB,EAAE,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,yBAAyB,EACnH,UAAU,QACV,UAAU,EAAE,UAAU,IAAI,UAAU,gBACxB,KAAK,KACb,CAAC,UAAU,IAAI,UAAU,IAAI,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,YAEzE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAC,IAAI,IAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAC,SAAS,GAAG,GACpD,CAChB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/IconButton/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC1E,OAAO,EAAE,IAAI,EAAmB,MAAM,kBAAkB,CAAA;AAYxD;;;GAGG;AACH,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;AAEjF,oFAAoF;AACpF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EACvB,MAAM,EACN,KAAK,EACL,QAAQ,GAAG,KAAK,EAChB,UAAU,GAAG,KAAK,EAClB,UAAU,GAAG,KAAK,EAClB,OAAO,GACO,EAAE,EAAE,CAAC,CACnB,KAAC,UAAU,iBACG,MAAM,oBACD,YAAY,mBACb,eAAe,iBAChB,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,kBAC1B,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAC3C,IAAI,EAAC,QAAQ,EACb,OAAO,EAAC,UAAU,EAClB,SAAS,EAAE,EAAE,CAAC,yBAAyB,EAAE,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,yBAAyB,EACnH,UAAU,QACV,UAAU,EAAE,UAAU,IAAI,UAAU,gBACxB,KAAK,KACb,CAAC,UAAU,IAAI,UAAU,IAAI,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,YAEzE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAC,IAAI,IAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAC,SAAS,GAAG,GACpD,CAChB,CAAA"}

package/dist/core/primitive/Image/index.d.ts

@@ -0,0 +1,30 @@
+import { type ReactNode } from "react";
+export type ImageAspect = "square" | "landscape" | "portrait" | "wide" | "auto";
+export type ImageLoadState = "loading" | "loaded" | "error";
+export type ImageProps = {
+    readonly src: string;
+    /** Required. Pass "" only for a purely decorative image. */
+    readonly alt: string;
+    /** square 1:1, landscape 4:3, portrait 3:4, wide 16:9; auto keeps the intrinsic ratio. */
+    readonly aspect?: ImageAspect;
+    readonly fit?: "cover" | "contain";
+    /** Rendered instead of the image when it fails to load. */
+    readonly fallback?: ReactNode;
+    /** Offscreen images defer by default; above-the-fold art may be eager. */
+    readonly loading?: "lazy" | "eager";
+    readonly srcSet?: string;
+    readonly sizes?: string;
+    readonly width?: number;
+    readonly height?: number;
+    readonly onLoadStateChange?: (state: ImageLoadState) => void;
+    readonly className?: string;
+};
+/**
+ * A reserved-ratio image with loading, loaded and error states.
+ *
+ * The box claims its aspect ratio before the bytes arrive, so lazy images never shift the page.
+ * `MediaFrame` frames approved art with a caption; `Image` is the element inside or outside it.
+ * Contract: box MEDIA-2 MEDIA-5 (reserved ratio, load states), img MEDIA-4 MOTION-2, fallback MEDIA-4 MEDIA-5.
+ */
+export declare const Image: ({ src, alt, aspect, fit, fallback, loading, srcSet, sizes, width, height, onLoadStateChange, className, }: ImageProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map