@gratiaos/ui 1.0.0

package/dist/pad/Card.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+type CardProps = React.HTMLAttributes<HTMLDivElement> & {
+    as?: React.ElementType;
+    padding?: 'sm' | 'md' | 'lg';
+};
+export declare const Card: React.FC<CardProps>;
+export {};
+//# sourceMappingURL=Card.d.ts.map

package/dist/pad/Card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../src/pad/Card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,KAAK,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG;IACtD,EAAE,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;IACvB,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,CAEpC,CAAC"}

package/dist/pad/Card.js

@@ -0,0 +1,3 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+export const Card = ({ as: Tag = 'section', padding = 'md', className = '', ...rest }) => (_jsx(Tag, { "data-ui": "pad-card", className: `pad-card ${padding === 'sm' ? 'p-3' : padding === 'lg' ? 'p-6' : 'p-4'} ${className}`, ...rest }));
+//# sourceMappingURL=Card.js.map

package/dist/pad/Card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Card.js","sourceRoot":"","sources":["../../src/pad/Card.tsx"],"names":[],"mappings":";AAOA,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,EAAE,EAAE,EAAE,GAAG,GAAG,SAAS,EAAE,OAAO,GAAG,IAAI,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,CAC7G,KAAC,GAAG,eAAS,UAAU,EAAC,SAAS,EAAE,YAAY,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,SAAS,EAAE,KAAM,IAAI,GAAI,CACxI,CAAC"}

package/dist/primitives/badge.d.ts

@@ -0,0 +1,66 @@
+import * as React from 'react';
+/**
+ * Garden UI — Badge primitive (headless)
+ * --------------------------------------
+ * Whisper: "small truths, softly visible." 🌬️
+ *
+ * Purpose
+ *  • Compact status/metadata label (denser than Pill, squarer radius).
+ *  • Headless: emits data-attributes only; visuals live in styles/badge.css.
+ *
+ * Data API
+ *  • [data-ui="badge"]                      — root hook
+ *  • [data-variant="soft|solid|outline|subtle"]
+ *  • [data-tone="subtle|accent|positive|warning|danger"]
+ *  • [data-size="sm|md"]                    — default: sm
+ *
+ * A11y
+ *  • Content is the accessible label; leading/trailing are aria-hidden.
+ *  • When rendered as <button>, defaults type="button" (no accidental submits).
+ *
+ * Theming
+ *  • Colors, borders, radius are defined in styles/badge.css via tokens.
+ *
+ * When to use
+ *  • Inline facts (e.g., "Car", "Bridge", counts) where space is tight.
+ *  • Use Pill when you want a rounder / more prominent chip.
+ */
+/** Visual tone (mapped by the skin). */
+export type BadgeTone = 'subtle' | 'accent' | 'positive' | 'warning' | 'danger' | (string & {});
+/** Visual weight (see skin for rendering). */
+export type BadgeVariant = 'soft' | 'solid' | 'outline' | 'subtle' | (string & {});
+/** Component size scale. Defaults to "sm". */
+export type BadgeSize = 'sm' | 'md' | (string & {});
+type BaseProps = {
+    /** Visual weight. Defaults to "soft". */
+    variant?: BadgeVariant;
+    /** Color tone. Defaults to "subtle". */
+    tone?: BadgeTone;
+    /** Component size. Defaults to "sm". */
+    size?: BadgeSize;
+    /** Optional leading adornment (icon, dot, avatar). */
+    leading?: React.ReactNode;
+    /** Optional trailing adornment (icon, counter, close). */
+    trailing?: React.ReactNode;
+    /** Additional class names forwarded to the root. */
+    className?: string;
+    /** Visible label/content (accessible name). */
+    children?: React.ReactNode;
+};
+/** Render as a different element. Defaults to span. */
+type BadgeSpanProps = BaseProps & React.ComponentPropsWithoutRef<'span'> & {
+    as?: 'span';
+};
+/** Render as a button element. */
+type BadgeButtonProps = BaseProps & React.ComponentPropsWithoutRef<'button'> & {
+    as: 'button';
+};
+/** Render as a link element. */
+type BadgeAnchorProps = BaseProps & React.ComponentPropsWithoutRef<'a'> & {
+    as: 'a';
+};
+/** Discriminated union of supported render targets (defaults to <span>). */
+type BadgeProps = BadgeSpanProps | BadgeButtonProps | BadgeAnchorProps;
+export declare const Badge: React.ForwardRefExoticComponent<BadgeProps & React.RefAttributes<HTMLElement>>;
+export default Badge;
+//# sourceMappingURL=badge.d.ts.map

package/dist/primitives/badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../src/primitives/badge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,wCAAwC;AACxC,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAChG,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AACnF,8CAA8C;AAC9C,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEpD,KAAK,SAAS,GAAG;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,wCAAwC;IACxC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,wCAAwC;IACxC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,CAAC;AAEF,uDAAuD;AACvD,KAAK,cAAc,GAAG,SAAS,GAAG,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3F,kCAAkC;AAClC,KAAK,gBAAgB,GAAG,SAAS,GAAG,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC,GAAG;IAAE,EAAE,EAAE,QAAQ,CAAA;CAAE,CAAC;AAChG,gCAAgC;AAChC,KAAK,gBAAgB,GAAG,SAAS,GAAG,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC,GAAG;IAAE,EAAE,EAAE,GAAG,CAAA;CAAE,CAAC;AAEtF,4EAA4E;AAC5E,KAAK,UAAU,GAAG,cAAc,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAyBvE,eAAO,MAAM,KAAK,gFA+ChB,CAAC;AAIH,eAAe,KAAK,CAAC"}

package/dist/primitives/badge.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+/** Compose visual slots and hide icons from assistive tech (text is the name). */
+function renderContent(leading, trailing, children) {
+    return (_jsxs(_Fragment, { children: [leading ? (
+            // Presentational — hidden from AT since the text already conveys the label
+            _jsx("span", { "aria-hidden": "true", "data-slot": "icon leading", children: leading })) : null, children, trailing ? (_jsx("span", { "aria-hidden": "true", "data-slot": "icon trailing", children: trailing })) : null] }));
+}
+export const Badge = React.forwardRef((props, ref) => {
+    if (props.as === 'button') {
+        const { as, variant = 'soft', tone = 'subtle', size = 'sm', leading, trailing, className, type, children, ...rest } = props;
+        return (_jsx("button", { ref: ref, "data-ui": "badge", "data-variant": variant, "data-tone": tone, "data-size": size, className: className, type: type ?? 'button', ...rest, children: renderContent(leading, trailing, children) }));
+    }
+    if (props.as === 'a') {
+        const { as, variant = 'soft', tone = 'subtle', size = 'sm', leading, trailing, className, children, ...rest } = props;
+        return (_jsx("a", { ref: ref, "data-ui": "badge", "data-variant": variant, "data-tone": tone, "data-size": size, className: className, ...rest, children: renderContent(leading, trailing, children) }));
+    }
+    const { as, variant = 'soft', tone = 'subtle', size = 'sm', leading, trailing, className, children, ...rest } = props;
+    return (_jsx("span", { ref: ref, "data-ui": "badge", "data-variant": variant, "data-tone": tone, "data-size": size, className: className, ...rest, children: renderContent(leading, trailing, children) }));
+});
+Badge.displayName = 'Badge';
+export default Badge;
+//# sourceMappingURL=badge.js.map

package/dist/primitives/badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.js","sourceRoot":"","sources":["../../src/primitives/badge.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkE/B,kFAAkF;AAClF,SAAS,aAAa,CAAC,OAAwB,EAAE,QAAyB,EAAE,QAAyB;IACnG,OAAO,CACL,8BACG,OAAO,CAAC,CAAC,CAAC;YACT,2EAA2E;YAC3E,8BAAkB,MAAM,eAAW,cAAc,YAC9C,OAAO,GACH,CACR,CAAC,CAAC,CAAC,IAAI,EACP,QAAQ,EACR,QAAQ,CAAC,CAAC,CAAC,CACV,8BAAkB,MAAM,eAAW,eAAe,YAC/C,QAAQ,GACJ,CACR,CAAC,CAAC,CAAC,IAAI,IACP,CACJ,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAA2B,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAC7E,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,EAAE,IAAI,GAAG,QAAQ,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;QAC5H,OAAO,CACL,iBACE,GAAG,EAAE,GAAmC,aAChC,OAAO,kBACD,OAAO,eACV,IAAI,eACJ,IAAI,EACf,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,IAAI,IAAI,QAAQ,KAClB,IAAI,YACP,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,GACpC,CACV,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC;QACrB,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,EAAE,IAAI,GAAG,QAAQ,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;QACtH,OAAO,CACL,YACE,GAAG,EAAE,GAAmC,aAChC,OAAO,kBACD,OAAO,eACV,IAAI,eACJ,IAAI,EACf,SAAS,EAAE,SAAS,KAChB,IAAI,YACP,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,GACzC,CACL,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,EAAE,IAAI,GAAG,QAAQ,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACtH,OAAO,CACL,eACE,GAAG,EAAE,GAAiC,aAC9B,OAAO,kBACD,OAAO,eACV,IAAI,eACJ,IAAI,EACf,SAAS,EAAE,SAAS,KAChB,IAAI,YACP,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,GACtC,CACR,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC;AAE5B,eAAe,KAAK,CAAC"}

package/dist/primitives/button.d.ts

@@ -0,0 +1,60 @@
+import * as React from 'react';
+/**
+ * Garden UI — Button primitive (headless)
+ * ---------------------------------------
+ * Whisper: "action should feel grounded, never frantic." 🌬️
+ *
+ * Purpose
+ *  • Accessible trigger for primary/secondary actions.
+ *  • Headless: visuals live in styles/button.css; this file emits structure + data-attrs.
+ *
+ * Data API
+ *  • [data-ui="button"] root
+ *  • [data-variant="solid|outline|ghost|subtle"] [data-tone] [data-density]
+ *  • [data-state="idle|loading|disabled"]
+ *  • [data-loading-mode="inline|blocking"] (when loading)
+ *  • [data-slot="icon leading|label|icon trailing|spinner|overlay"] parts for skins
+ *
+ * A11y
+ *  • Native <button> covers keyboard/role by default.
+ *  • When `asChild` renders a <span>, we emulate button behavior:
+ *    role="button", tabIndex, Space/Enter→click and respect disabled/loading.
+ *  • Spinner/overlay are presentational and marked `aria-hidden`.
+ *
+ * Theming
+ *  • Skin reads tokens: --color-*, --radius-*, --shadow-*.
+ *
+ * Notes
+ *  • “blocking” overlays the content for long ops; avoid overuse.
+ */
+/** Visual tone (mapped by the skin). */
+export type ButtonTone = 'default' | 'accent' | 'positive' | 'warning' | 'danger';
+/** Visual weight (see skin for rendering). */
+export type ButtonVariant = 'solid' | 'outline' | 'ghost' | 'subtle';
+/** Vertical density (compact vs roomy). */
+export type ButtonDensity = 'cozy' | 'snug';
+/** Loading presentation. */
+export type ButtonLoadingMode = 'inline' | 'blocking';
+type ButtonOwnProps = {
+    /** Render as a span that mimics a button (role/keys). Defaults to false. */
+    asChild?: boolean;
+    /** Color tone. Defaults to "default". */
+    tone?: ButtonTone;
+    /** Visual weight. Defaults to "solid". */
+    variant?: ButtonVariant;
+    /** Vertical density. Defaults to "cozy". */
+    density?: ButtonDensity;
+    /** Show progress affordance. */
+    loading?: boolean;
+    /** Loading presentation: "inline" (default) or "blocking". */
+    loadingMode?: ButtonLoadingMode;
+    /** Optional leading adornment (icon). */
+    leadingIcon?: React.ReactNode;
+    /** Optional trailing adornment (icon). */
+    trailingIcon?: React.ReactNode;
+};
+/** Public props for Button (native button attrs + headless options). */
+export type ButtonProps = ButtonOwnProps & React.ButtonHTMLAttributes<HTMLButtonElement>;
+export declare const Button: React.ForwardRefExoticComponent<ButtonOwnProps & React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export default Button;
+//# sourceMappingURL=button.d.ts.map

package/dist/primitives/button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../src/primitives/button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,wCAAwC;AACxC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAClF,8CAA8C;AAC9C,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AACrE,2CAA2C;AAC3C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAC5C,4BAA4B;AAC5B,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtD,KAAK,cAAc,GAAG;IACpB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,yCAAyC;IACzC,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,0CAA0C;IAC1C,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAChC,CAAC;AAEF,wEAAwE;AACxE,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;AAEzF,eAAO,MAAM,MAAM,0IAqGlB,CAAC;AAIF,eAAe,MAAM,CAAC"}

package/dist/primitives/button.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+export const Button = React.forwardRef(({ asChild, tone = 'default', variant = 'solid', density = 'cozy', loading = false, loadingMode = 'inline', leadingIcon, trailingIcon, children, type, disabled, onClick, onKeyDown, ...rest }, ref) => {
+    const dataAttrs = {
+        'data-ui': 'button',
+        'data-tone': tone,
+        'data-variant': variant,
+        'data-density': density,
+        'data-state': loading ? 'loading' : disabled ? 'disabled' : 'idle',
+        'data-loading-mode': loading ? loadingMode : undefined,
+    };
+    const content = (_jsxs(_Fragment, { children: [leadingIcon ? (_jsx("span", { "data-slot": "icon leading", "aria-hidden": "true", children: leadingIcon })) : null, children != null ? _jsx("span", { "data-slot": "label", children: children }) : null, trailingIcon ? (_jsx("span", { "data-slot": "icon trailing", "aria-hidden": "true", children: trailingIcon })) : null, loading && loadingMode === 'inline' ? _jsx("span", { "data-slot": "spinner", "aria-hidden": "true" }) : null, loading && loadingMode === 'blocking' ? (_jsx("span", { "data-slot": "overlay", "aria-hidden": "true", children: _jsx("span", { "data-slot": "spinner" }) })) : null] }));
+    if (asChild) {
+        const handleClick = (e) => {
+            if (disabled || loading) {
+                e.preventDefault();
+                e.stopPropagation();
+                return;
+            }
+            onClick?.(e);
+        };
+        const handleKeyDown = (e) => {
+            onKeyDown?.(e);
+            if (e.defaultPrevented)
+                return;
+            if (disabled || loading)
+                return;
+            if (e.key === 'Enter' || e.key === ' ') {
+                e.preventDefault();
+                e.currentTarget.click();
+            }
+        };
+        return (_jsx("span", { ref: ref, role: "button", "aria-busy": loading || undefined, "aria-disabled": disabled || undefined, tabIndex: disabled ? -1 : 0, onClick: handleClick, onKeyDown: handleKeyDown, ...dataAttrs, ...rest, children: content }));
+    }
+    return (_jsx("button", { ref: ref, type: type ?? 'button', "aria-busy": loading || undefined, disabled: disabled, onClick: onClick, onKeyDown: onKeyDown, ...dataAttrs, ...rest, children: content }));
+});
+Button.displayName = 'Button';
+export default Button;
+//# sourceMappingURL=button.js.map

package/dist/primitives/button.js.map

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

package/dist/primitives/card.d.ts

@@ -0,0 +1,54 @@
+import * as React from 'react';
+/**
+ * Garden UI — Card primitive (headless)
+ * -------------------------------------
+ * Whisper: "surfaces should invite, not insist." 🌬️
+ *
+ * Purpose
+ *   • Lightweight surface wrapper for grouping content.
+ *   • Headless by design — visuals come from tokens & optional skins.
+ *
+ * Data API (for skins)
+ *   • [data-ui="card"]
+ *   • [data-variant="plain|elev|glow|outline|inset|ghost|…"] — depth/outline semantics (extensible)
+ *   • [data-padding="none|sm|md|lg"]     — inner spacing
+ *
+ * A11y
+ *   • Card is purely presentational; pass semantics via props (e.g., role="region", aria-labelledby).
+ *   • No tabIndex by default; avoid using Card as an interactive control.
+ *
+ * Theming
+ *   • Uses tokens: --color-surface, --color-elev, --color-border, --sheet-radius, --ring-accent.
+ *   • Depth via utility `shadow-depth-*` (theme-controlled); glow uses an accent outline.
+ *
+ * When to use
+ *   • As a neutral container in dashboards, pads, and panels.
+ *   • Keep padding modest; compose layout with Stack/Grid instead of adding layout logic here.
+ *
+ * Notes
+ *   • Variants are **pass‑through** to CSS skins; adding values here doesn't change visuals unless your skin targets them.
+ *   • The type allows custom strings so downstream apps can trial variants without changing this file again.
+ */
+/** Visual depth/outline semantics (skin renders). */
+type Variant = 'plain' | 'elev' | 'glow' | 'outline' | 'inset' | 'ghost' | (string & {});
+/** Inner spacing scale for content. */
+type Padding = 'none' | 'sm' | 'md' | 'lg';
+export type CardProps<T extends React.ElementType = 'div'> = {
+    /** Render as a different element. Defaults to div. */
+    as?: T;
+    /** Visual depth/outline semantics. Defaults to "elev". */
+    variant?: Variant;
+    /** Inner spacing scale. Defaults to "md". */
+    padding?: Padding;
+    /** Additional class names forwarded to the root. */
+    className?: string;
+    /** Content inside the card (accessible name comes from content/aria props). */
+    children?: React.ReactNode;
+} & Omit<React.ComponentPropsWithoutRef<T>, 'as' | 'children' | 'className'>;
+export declare const Card: ((props: CardProps<any> & {
+    ref?: React.Ref<Element>;
+}) => React.ReactElement | null) & {
+    displayName?: string;
+};
+export {};
+//# sourceMappingURL=card.d.ts.map

package/dist/primitives/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/primitives/card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,qDAAqD;AACrD,KAAK,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AACzF,uCAAuC;AACvC,KAAK,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,KAAK,CAAC,WAAW,GAAG,KAAK,IAAI;IAC3D,sDAAsD;IACtD,EAAE,CAAC,EAAE,CAAC,CAAC;IACP,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;AAqB7E,eAAO,MAAM,IAAI,EAAuB,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;CAAE,KAAK,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG;IAC9H,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/dist/primitives/card.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from 'react';
+const _Card = React.forwardRef(({ as, variant = 'elev', padding = 'md', className, children, ...rest }, ref) => {
+    const Comp = (as || 'div'); // polymorphic root
+    return (_jsx(Comp, { ref: ref, "data-ui": "card", "data-variant": variant, "data-padding": padding, className: className, ...rest, children: children }));
+});
+// Set displayName on the uncast component (avoids TS2339 after casting)
+_Card.displayName = 'Card';
+// Now cast to the polymorphic callable signature and export
+export const Card = _Card;
+//# sourceMappingURL=card.js.map

package/dist/primitives/card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.js","sourceRoot":"","sources":["../../src/primitives/card.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAmD/B,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAC5B,CACE,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAgB,EACpF,GAAuB,EACvB,EAAE;IACF,MAAM,IAAI,GAAG,CAAC,EAAE,IAAI,KAAK,CAAsB,CAAC,CAAC,mBAAmB;IAEpE,OAAO,CACL,KAAC,IAAI,IAAC,GAAG,EAAE,GAAG,aAAU,MAAM,kBAAe,OAAO,kBAAgB,OAAO,EAAE,SAAS,EAAE,SAAS,KAAM,IAAI,YACxG,QAAQ,GACJ,CACR,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,wEAAwE;AACxE,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC;AAE3B,4DAA4D;AAC5D,MAAM,CAAC,MAAM,IAAI,GAAG,KAEnB,CAAC"}

package/dist/primitives/field.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Garden UI — Field primitive (headless)
+ * -------------------------------------
+ * Whisper: "clarity first; comfort follows." 🌬️
+ *
+ * Purpose
+ *   • A tiny accessibility wrapper that wires one control to its label & helper text.
+ *   • Headless by design — visuals live in the skin (styles/field.css) via data‑attrs.
+ *
+ * Data API (for skins)
+ *   • [data-ui="field"]                — root wrapper
+ *   • [data-state="valid|invalid"]     — validation state
+ *   • [data-disabled] on root when `disabled` is true
+ *   • [data-tone="subtle|accent|positive|warning|danger"] — hint for skins
+ *   • [data-part="label|control|error|description|hint|optional"]
+ *   • [data-required] on label when `required` is true (skins style this calmly)
+ *
+ * A11y decisions
+ *   • IDs: stable `controlId` from (prop.id || child.id || useId()).
+ *   • `aria-describedby`: merges description + hint + error ids.
+ *   • Errors: `role="alert"` only on the error node — no wrapper `aria-live` to avoid double reads.
+ *   • Disabled: sets `aria-disabled` on the control and `data-disabled` on the wrapper.
+ *   • Required: sets `aria-required` on control; we avoid noisy "(Optional)" by default.
+ *
+ * Children API
+ *   • Element:  <Field><input /></Field> — cloned with merged aria/id props.
+ *   • Render fn: <Field>{(a) => <input {...a} />}</Field> — you render; we pass wiring.
+ *
+ * Dev notes / next
+ *   • Docs: add README/Storybook examples (Basic, WithHint, WithError, RenderProp, Required).
+ *   • Tests: describedby merge; required wiring; error flips data-state + aria-invalid; cloning preserves aria props.
+ *   • DX: warn in dev when `children` is neither a function nor a valid element (implemented below).
+ *   • Optional UX: default keeps "Optional" hidden; style required via label[data-required].
+ */
+import * as React from 'react';
+export type Tone = 'accent' | 'positive' | 'warning' | 'danger' | 'subtle';
+export type State = 'valid' | 'invalid';
+type FieldRenderProps = {
+    id: string;
+    'aria-describedby'?: string;
+    'aria-invalid'?: true;
+    'aria-required'?: true;
+    'aria-disabled'?: true;
+    /** Convenience: many HTML controls accept `disabled`; renderers can spread it. */
+    disabled?: true;
+};
+type FieldChild = React.ReactNode | ((control: FieldRenderProps) => React.ReactNode);
+export interface FieldProps {
+    /** Provide a stable id to wire label + messages. Defaults to an auto-generated id. */
+    id?: string;
+    /** Primary label rendered inside a <label>. */
+    label?: React.ReactNode;
+    /** Optional helper text shown beneath the control. */
+    description?: React.ReactNode;
+    /** Additional hint text (legacy alias for description). */
+    hint?: React.ReactNode;
+    /** Error message. When present the field is marked invalid. */
+    error?: React.ReactNode;
+    /** Mark control as required. Also sets aria-required. */
+    required?: boolean;
+    /** Custom copy for optional indicator (e.g. "Optional"). Set to null to hide. */
+    optionalText?: React.ReactNode;
+    /** Tone for styling hooks. */
+    tone?: Tone;
+    /** Rendered control element or render function receiving aria wiring. */
+    children: FieldChild;
+    /** Additional props spread onto the outer label. */
+    labelProps?: React.LabelHTMLAttributes<HTMLLabelElement>;
+    /** Optional class names applied to the outer wrapper. */
+    className?: string;
+    /** Disable the control and mark the field inert. Applies `data-disabled` on root. */
+    disabled?: boolean;
+    /** Extra ids to merge into `aria-describedby` (string or array). */
+    extraDescribedBy?: string | string[];
+    /** Hide the visual label while keeping it for screen readers (adds `sr-only`). */
+    labelVisuallyHidden?: boolean;
+}
+/**
+ * Field
+ *
+ * A lightweight accessibility wrapper that wires a label, helper messages, and
+ * error state to a single form control.
+ *
+ * ### ID strategy
+ * - Generates a stable id with `React.useId()`.
+ * - If the child element already provides an `id`, that wins.
+ * - You can also pass an explicit `id` prop to override both.
+ *
+ * The resolved control id is used to derive `-description`, `-hint`, and `-error`
+ * ids which are merged into `aria-describedby` as needed.
+ *
+ * ### Children API
+ * - **Element**: `<Field><input /></Field>` — The element is cloned and receives
+ *   merged `id`, `aria-describedby`, `aria-invalid`, and `aria-required`.
+ * - **Render function**: `<Field>{(aria) => <input {...aria} />}</Field>` — You render
+ *   the control yourself with the provided ARIA wiring (`id`, `aria-describedby`, etc.).
+ *
+ * ### Data attributes for skins
+ * - `data-ui="field"`, `data-state`, `data-tone`, and `data-part` markers on internal nodes.
+ *
+ * ### A11y rationale
+ * - Error messages use `role="alert"` for assertive announcements.
+ * - Wrapper does NOT set `aria-live` to avoid duplicate SR reads.
+ */
+export declare const Field: React.ForwardRefExoticComponent<FieldProps & React.RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=field.d.ts.map

package/dist/primitives/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/primitives/field.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3E,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,SAAS,CAAC;AAExC,KAAK,gBAAgB,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,eAAe,CAAC,EAAE,IAAI,CAAC;IACvB,eAAe,CAAC,EAAE,IAAI,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF,KAAK,UAAU,GAAG,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,OAAO,EAAE,gBAAgB,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;AAErF,MAAM,WAAW,UAAU;IACzB,sFAAsF;IACtF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,sDAAsD;IACtD,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,yEAAyE;IACzE,QAAQ,EAAE,UAAU,CAAC;IACrB,oDAAoD;IACpD,UAAU,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACzD,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACrC,kFAAkF;IAClF,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,KAAK,mFAqIhB,CAAC"}

package/dist/primitives/field.js

@@ -0,0 +1,154 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Garden UI — Field primitive (headless)
+ * -------------------------------------
+ * Whisper: "clarity first; comfort follows." 🌬️
+ *
+ * Purpose
+ *   • A tiny accessibility wrapper that wires one control to its label & helper text.
+ *   • Headless by design — visuals live in the skin (styles/field.css) via data‑attrs.
+ *
+ * Data API (for skins)
+ *   • [data-ui="field"]                — root wrapper
+ *   • [data-state="valid|invalid"]     — validation state
+ *   • [data-disabled] on root when `disabled` is true
+ *   • [data-tone="subtle|accent|positive|warning|danger"] — hint for skins
+ *   • [data-part="label|control|error|description|hint|optional"]
+ *   • [data-required] on label when `required` is true (skins style this calmly)
+ *
+ * A11y decisions
+ *   • IDs: stable `controlId` from (prop.id || child.id || useId()).
+ *   • `aria-describedby`: merges description + hint + error ids.
+ *   • Errors: `role="alert"` only on the error node — no wrapper `aria-live` to avoid double reads.
+ *   • Disabled: sets `aria-disabled` on the control and `data-disabled` on the wrapper.
+ *   • Required: sets `aria-required` on control; we avoid noisy "(Optional)" by default.
+ *
+ * Children API
+ *   • Element:  <Field><input /></Field> — cloned with merged aria/id props.
+ *   • Render fn: <Field>{(a) => <input {...a} />}</Field> — you render; we pass wiring.
+ *
+ * Dev notes / next
+ *   • Docs: add README/Storybook examples (Basic, WithHint, WithError, RenderProp, Required).
+ *   • Tests: describedby merge; required wiring; error flips data-state + aria-invalid; cloning preserves aria props.
+ *   • DX: warn in dev when `children` is neither a function nor a valid element (implemented below).
+ *   • Optional UX: default keeps "Optional" hidden; style required via label[data-required].
+ */
+import * as React from 'react';
+const defaultOptionalText = null; // default: do not show optional text; mark required via CSS using [data-required]
+// Join non-empty id parts into a single space-separated string for aria-describedby.
+function joinIds(...parts) {
+    return parts.filter(Boolean).join(' ') || undefined;
+}
+function normalizeIds(ids) {
+    if (!ids)
+        return undefined;
+    return Array.isArray(ids) ? ids.filter(Boolean).join(' ') || undefined : ids || undefined;
+}
+// Narrow unknown to a string (safely) when reading potential child props.
+function toString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function hasAriaLabel(props) {
+    if (!props)
+        return false;
+    const a = props['aria-label'];
+    const b = props['aria-labelledby'];
+    return (typeof a === 'string' && a.trim().length > 0) || (typeof b === 'string' && b.trim().length > 0);
+}
+// Detect dev mode without importing Node types (works in browser ESM).
+function isDevEnvironment() {
+    const globalProcess = globalThis.process;
+    const env = globalProcess && typeof globalProcess === 'object' ? globalProcess.env : undefined;
+    const mode = env && typeof env === 'object' && 'NODE_ENV' in env ? env.NODE_ENV : undefined;
+    return mode !== 'production';
+}
+// Tiny class join helper (no runtime deps).
+/**
+ * Field
+ *
+ * A lightweight accessibility wrapper that wires a label, helper messages, and
+ * error state to a single form control.
+ *
+ * ### ID strategy
+ * - Generates a stable id with `React.useId()`.
+ * - If the child element already provides an `id`, that wins.
+ * - You can also pass an explicit `id` prop to override both.
+ *
+ * The resolved control id is used to derive `-description`, `-hint`, and `-error`
+ * ids which are merged into `aria-describedby` as needed.
+ *
+ * ### Children API
+ * - **Element**: `<Field><input /></Field>` — The element is cloned and receives
+ *   merged `id`, `aria-describedby`, `aria-invalid`, and `aria-required`.
+ * - **Render function**: `<Field>{(aria) => <input {...aria} />}</Field>` — You render
+ *   the control yourself with the provided ARIA wiring (`id`, `aria-describedby`, etc.).
+ *
+ * ### Data attributes for skins
+ * - `data-ui="field"`, `data-state`, `data-tone`, and `data-part` markers on internal nodes.
+ *
+ * ### A11y rationale
+ * - Error messages use `role="alert"` for assertive announcements.
+ * - Wrapper does NOT set `aria-live` to avoid duplicate SR reads.
+ */
+export const Field = React.forwardRef(function Field({ id: idProp, label, description, hint, error, required, optionalText = defaultOptionalText, tone, children, labelProps, className, disabled, extraDescribedBy, labelVisuallyHidden, }, ref) {
+    const generatedId = React.useId();
+    const childElement = React.isValidElement(children) ? children : null;
+    const childProps = childElement?.props ?? {};
+    const childId = toString(childProps.id);
+    const controlId = idProp ?? childId ?? generatedId;
+    const descriptionId = description ? `${controlId}-description` : undefined;
+    const hintId = hint ? `${controlId}-hint` : undefined;
+    const errorId = error ? `${controlId}-error` : undefined;
+    const computedTone = tone ?? (error ? 'danger' : 'subtle');
+    const controlRenderProps = {
+        id: controlId,
+        'aria-describedby': joinIds(descriptionId, hintId, errorId, normalizeIds(extraDescribedBy)),
+        'aria-invalid': error ? true : undefined,
+        'aria-required': required ? true : undefined,
+        'aria-disabled': disabled ? true : undefined,
+        disabled: disabled ? true : undefined,
+    };
+    let control;
+    if (isDevEnvironment()) {
+        const isFn = typeof children === 'function';
+        const isElement = !!childElement;
+        if (!isFn && !isElement) {
+            // Intentionally gentle — helps catch misuse without throwing.
+            // eslint-disable-next-line no-console
+            console.warn('[Field] `children` should be a React element or a render function. Received:', children);
+        }
+        const hasLabelNode = !!label;
+        const hasChildName = hasAriaLabel(childProps);
+        if (!hasLabelNode && !hasChildName) {
+            // eslint-disable-next-line no-console
+            console.warn('[Field] Accessible name missing: provide `label` or give the control `aria-label`/`aria-labelledby`.');
+        }
+    }
+    if (typeof children === 'function') {
+        control = children(controlRenderProps);
+    }
+    else if (childElement) {
+        const mergedDescribedBy = joinIds(toString(childProps['aria-describedby']), descriptionId, hintId, errorId, normalizeIds(extraDescribedBy));
+        control = React.cloneElement(childElement, {
+            id: childProps.id ?? controlId,
+            'aria-describedby': mergedDescribedBy,
+            'aria-invalid': childProps['aria-invalid'] ?? (error ? true : undefined),
+            'aria-required': childProps['aria-required'] ?? (required ? true : undefined),
+            'aria-disabled': childProps['aria-disabled'] ?? (disabled ? true : undefined),
+            // @ts-ignore: not all elements accept `disabled`, that's OK — consumers control the tag.
+            disabled: childProps.disabled ?? (disabled ? true : undefined),
+        });
+    }
+    else {
+        control = children;
+    }
+    const state = error ? 'invalid' : 'valid';
+    const { className: labelClassName, ...restLabelProps } = labelProps ?? {};
+    const optionalIndicator = !required && optionalText != null ? (_jsx("span", { "data-part": "optional", "aria-hidden": "true", children: optionalText })) : null;
+    return (_jsxs("div", { ref: ref, "data-ui": "field", "data-state": state, "data-tone": computedTone, "data-disabled": disabled ? '' : undefined, className: className, children: [label ? (_jsxs("label", { htmlFor: controlId, "data-part": "label", "data-required": required ? '' : undefined, className: labelVisuallyHidden ? [labelClassName, 'sr-only'].filter(Boolean).join(' ') : labelClassName, ...restLabelProps, children: [_jsx("span", { children: label }), optionalIndicator] })) : null, _jsx("div", { "data-part": "control", children: control }), error ? (
+            // a11y: We use role="alert" on the error message for assertive announcement and
+            // do not set aria-live on the wrapper to avoid duplicate reads by screen readers.
+            _jsx("div", { id: errorId, "data-part": "error", role: "alert", children: error })) : null, description ? (_jsx("div", { id: descriptionId, "data-part": "description", children: description })) : null, hint ? (_jsx("div", { id: hintId, "data-part": "hint", children: hint })) : null] }));
+});
+Field.displayName = 'Field';
+//# sourceMappingURL=field.js.map

package/dist/primitives/field.js.map

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