@dashforge/tw 1.1.0 → 1.2.0

package/dist/src/components/Slider/slider.variants.d.ts

@@ -0,0 +1,313 @@
+import { type VariantProps } from 'tailwind-variants';
+/**
+ * Tailwind-variants recipe for `<Slider>` — token-driven numeric value
+ * picker (single value or [min, max] range).
+ *
+ * Slots:
+ *   - `root`            — outer wrapper (label + control + helper/error)
+ *   - `label`           — text above the control
+ *   - `requiredMark`    — `*` for required
+ *   - `controlWrapper`  — flex container holding the Radix Slider.Root
+ *   - `track`           — the full horizontal bar (Radix Slider.Track)
+ *   - `rangeSegment`    — highlighted portion between thumbs
+ *                         (Radix Slider.Range — start→thumb for single,
+ *                         thumb1→thumb2 for range)
+ *   - `thumb`           — draggable handle (one per value tick)
+ *   - `mark`            — tick on the track for a discrete step
+ *   - `markLabel`       — text label under a mark
+ *   - `valueLabel`      — tooltip above the thumb showing current value
+ *   - `helperText`      — descriptive line below the control
+ *   - `errorText`       — semantic counterpart for error mode
+ *
+ * Color intents follow the palette convention used elsewhere in the
+ * catalog. `neutral` auto-inverts via the preset CSS-var swap; the
+ * other five carry `dark:` variants where needed for visual cohesion.
+ */
+export declare const sliderVariants: import("tailwind-variants").TVReturnType<{
+    color: {
+        primary: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        secondary: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        success: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        warning: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        danger: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        neutral: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+    };
+    size: {
+        sm: {
+            controlWrapper: string;
+            track: string;
+            thumb: string;
+            mark: string;
+            valueLabel: string;
+        };
+        md: {
+            controlWrapper: string;
+            track: string;
+            thumb: string;
+            mark: string;
+            valueLabel: string;
+        };
+        lg: {
+            controlWrapper: string;
+            track: string;
+            thumb: string;
+            mark: string;
+            valueLabel: string;
+        };
+    };
+    layout: {
+        stacked: {
+            root: string;
+        };
+        inline: {
+            root: string;
+            label: string;
+        };
+    };
+    error: {
+        true: {
+            thumb: string;
+            rangeSegment: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+        };
+    };
+    disabled: {
+        true: {
+            controlWrapper: string;
+            thumb: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    requiredMark: string;
+    controlWrapper: string;
+    track: string[];
+    rangeSegment: string[];
+    thumb: string[];
+    mark: string[];
+    markLabel: string[];
+    valueLabel: string[];
+    helperText: string;
+    errorText: string;
+}, undefined, {
+    color: {
+        primary: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        secondary: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        success: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        warning: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        danger: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        neutral: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+    };
+    size: {
+        sm: {
+            controlWrapper: string;
+            track: string;
+            thumb: string;
+            mark: string;
+            valueLabel: string;
+        };
+        md: {
+            controlWrapper: string;
+            track: string;
+            thumb: string;
+            mark: string;
+            valueLabel: string;
+        };
+        lg: {
+            controlWrapper: string;
+            track: string;
+            thumb: string;
+            mark: string;
+            valueLabel: string;
+        };
+    };
+    layout: {
+        stacked: {
+            root: string;
+        };
+        inline: {
+            root: string;
+            label: string;
+        };
+    };
+    error: {
+        true: {
+            thumb: string;
+            rangeSegment: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+        };
+    };
+    disabled: {
+        true: {
+            controlWrapper: string;
+            thumb: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    requiredMark: string;
+    controlWrapper: string;
+    track: string[];
+    rangeSegment: string[];
+    thumb: string[];
+    mark: string[];
+    markLabel: string[];
+    valueLabel: string[];
+    helperText: string;
+    errorText: string;
+}, import("tailwind-variants").TVReturnType<{
+    color: {
+        primary: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        secondary: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        success: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        warning: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        danger: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+        neutral: {
+            rangeSegment: string;
+            thumb: string;
+            valueLabel: string;
+        };
+    };
+    size: {
+        sm: {
+            controlWrapper: string;
+            track: string;
+            thumb: string;
+            mark: string;
+            valueLabel: string;
+        };
+        md: {
+            controlWrapper: string;
+            track: string;
+            thumb: string;
+            mark: string;
+            valueLabel: string;
+        };
+        lg: {
+            controlWrapper: string;
+            track: string;
+            thumb: string;
+            mark: string;
+            valueLabel: string;
+        };
+    };
+    layout: {
+        stacked: {
+            root: string;
+        };
+        inline: {
+            root: string;
+            label: string;
+        };
+    };
+    error: {
+        true: {
+            thumb: string;
+            rangeSegment: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+        };
+    };
+    disabled: {
+        true: {
+            controlWrapper: string;
+            thumb: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    requiredMark: string;
+    controlWrapper: string;
+    track: string[];
+    rangeSegment: string[];
+    thumb: string[];
+    mark: string[];
+    markLabel: string[];
+    valueLabel: string[];
+    helperText: string;
+    errorText: string;
+}, undefined, unknown, unknown, undefined>>;
+export type SliderVariants = VariantProps<typeof sliderVariants>;
+//# sourceMappingURL=slider.variants.d.ts.map

package/dist/src/components/Slider/slider.variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slider.variants.d.ts","sourceRoot":"","sources":["../../../../src/components/Slider/slider.variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAuIzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/src/components/Snackbar/Snackbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Snackbar.d.ts","sourceRoot":"","sources":["../../../../src/components/Snackbar/Snackbar.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,WAAW,EAEX,qBAAqB,EAEtB,MAAM,qBAAqB,CAAC;AAI7B;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,WAAW,CAQzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,2CAwP5D"}
+{"version":3,"file":"Snackbar.d.ts","sourceRoot":"","sources":["../../../../src/components/Snackbar/Snackbar.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,WAAW,EAEX,qBAAqB,EAEtB,MAAM,qBAAqB,CAAC;AAI7B;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,WAAW,CAQzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,2CA8P5D"}

package/dist/src/components/Snackbar/snackbar.types.d.ts

@@ -1,5 +1,4 @@
 import type { ReactNode } from 'react';
-import type { SnackbarVariants } from './snackbar.variants.js';
 import type { Severity, SeverityVariant } from '../_shared/severity/severity.types.js';
 /**
  * Visual severity — drives icon color + accent on the snackbar surface.
@@ -106,18 +105,43 @@ export interface SnackbarApi {
     /** Dismiss every visible snackbar. */
     dismissAll: () => void;
 }
-export interface SnackbarProviderProps extends SnackbarVariants {
+export interface SnackbarProviderProps {
+    /** App tree to wrap. Required. */
     children: ReactNode;
-    /** Corner the stack anchors to. @default 'bottom-right' */
+    /**
+     * Corner the stack anchors to.
+     * @default 'bottom-right'
+     */
     position?: SnackbarPosition;
     /**
      * Hard cap on simultaneously visible snackbars. Excess enqueued
-     * items wait FIFO until a slot frees up. @default 5
+     * items wait FIFO until a slot frees up.
+     * @default 5
      */
     maxVisible?: number;
     /** Defaults merged into every enqueue. */
     defaults?: Pick<SnackbarOptions, 'severity' | 'variant' | 'autoHideMs' | 'showClose'>;
-    /** Per-slot className overrides. */
+    /** Per-slot className overrides applied to every snackbar. */
     slotProps?: SnackbarSlotProps;
 }
+/**
+ * Subset of `<SnackbarProvider>` props theme-configurable via
+ * `theme.components.Snackbar.defaults` (Option C).
+ *
+ * `enqueueDefaults` is theme-level per-enqueue defaults — merged BEFORE
+ * the provider's own `defaults` prop (which wins).
+ */
+export interface SnackbarVariantProps {
+    position?: SnackbarPosition;
+    maxVisible?: number;
+    enqueueDefaults?: Pick<SnackbarOptions, 'severity' | 'variant' | 'autoHideMs' | 'showClose'>;
+}
+declare module '@dashforge/tw-tokens' {
+    interface TWComponentDefaults {
+        Snackbar?: {
+            defaults?: Partial<SnackbarVariantProps>;
+            slotProps?: SnackbarSlotProps;
+        };
+    }
+}
 //# sourceMappingURL=snackbar.types.d.ts.map

package/dist/src/components/Snackbar/snackbar.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snackbar.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Snackbar/snackbar.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EAChB,MAAM,uCAAuC,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAExC;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,eAAe,CAAC;AAE9C,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,YAAY,GACZ,WAAW,GACX,aAAa,GACb,eAAe,GACf,cAAc,CAAC;AAEnB,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,OAAO,EAAE,SAAS,CAAC;IACnB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;IACzB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IACnD,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,0EAA0E;AAC1E,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,WAAW,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,kFAAkF;IAClF,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,MAAM,CAAC;IAC9C,mCAAmC;IACnC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,sCAAsC;IACtC,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,QAAQ,EAAE,SAAS,CAAC;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,IAAI,CACb,eAAe,EACf,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CACpD,CAAC;IACF,oCAAoC;IACpC,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B"}
+{"version":3,"file":"snackbar.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Snackbar/snackbar.types.ts"],"names":[],"mappings":"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"}

package/dist/src/components/Spinner/Spinner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Spinner.d.ts","sourceRoot":"","sources":["../../../../src/components/Spinner/Spinner.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,OAAO,0GAwGlB,CAAC"}
+{"version":3,"file":"Spinner.d.ts","sourceRoot":"","sources":["../../../../src/components/Spinner/Spinner.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,OAAO,0GA0GlB,CAAC"}

package/dist/src/components/Spinner/spinner.types.d.ts

@@ -26,7 +26,10 @@ export type SpinnerThickness = 'thin' | 'md' | 'thick';
  * under `prefers-reduced-motion`).
  */
 export interface SpinnerProps {
-    /** @default 'md' */
+    /**
+     * Diameter tier — xs:12px, sm:16px, md:20px, lg:24px, xl:32px.
+     * @default 'md'
+     */
     size?: SpinnerSize;
     /**
      * Intent color. **When omitted, inherits parent's text color via
@@ -35,7 +38,10 @@ export interface SpinnerProps {
      * for standalone usage on neutral surfaces.
      */
     color?: SpinnerColor;
-    /** @default 'md' */
+    /**
+     * SVG stroke-width — thin:1.5, md:2.25, thick:3.
+     * @default 'md'
+     */
     thickness?: SpinnerThickness;
     /**
      * Renders a faint "ghost ring" behind the spinning arc (20%
@@ -83,7 +89,21 @@ export interface SpinnerProps {
      * otherwise display-only.
      */
     visibleWhen?: (engine: Engine) => boolean;
+    /** Standard React `className` — appended to the root via `cn()`. */
     className?: string;
+    /** Root-element class shortcut (string or clsx-compatible value). Wins over variant classes via `tailwind-merge`. */
     sx?: ClassValue;
 }
+/**
+ * Subset of `<Spinner>` props theme-configurable via
+ * `theme.components.Spinner.defaults` (Option C).
+ */
+export type SpinnerVariantProps = Pick<SpinnerProps, 'size' | 'color' | 'thickness' | 'withTrack'>;
+declare module '@dashforge/tw-tokens' {
+    interface TWComponentDefaults {
+        Spinner?: {
+            defaults?: Partial<SpinnerVariantProps>;
+        };
+    }
+}
 //# sourceMappingURL=spinner.types.d.ts.map

package/dist/src/components/Spinner/spinner.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spinner.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Spinner/spinner.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,WAAW,GACX,SAAS,GACT,SAAS,GACT,QAAQ,GACR,MAAM,CAAC;AAEX,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAE3B,oBAAoB;IACpB,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB,oBAAoB;IACpB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAGpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAM1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,UAAU,CAAC;CACjB"}
+{"version":3,"file":"spinner.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Spinner/spinner.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,WAAW,GACX,SAAS,GACT,SAAS,GACT,QAAQ,GACR,MAAM,CAAC;AAEX,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAE3B;;;OAGG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAGpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAM1C,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qHAAqH;IACrH,EAAE,CAAC,EAAE,UAAU,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,YAAY,EACZ,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,CAC7C,CAAC;AAEF,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,mBAAmB;QAC3B,OAAO,CAAC,EAAE;YACR,QAAQ,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;SACzC,CAAC;KACH;CACF"}

package/dist/src/components/Stack/Stack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Stack.d.ts","sourceRoot":"","sources":["../../../../src/components/Stack/Stack.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAqCnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,KAAK,oGAyCjB,CAAC"}
+{"version":3,"file":"Stack.d.ts","sourceRoot":"","sources":["../../../../src/components/Stack/Stack.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA6CnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,KAAK,oGAgGjB,CAAC"}

package/dist/src/components/Stack/stack.types.d.ts

@@ -1,5 +1,23 @@
 import type { ElementType, HTMLAttributes, ReactNode } from 'react';
-import type { StackVariants } from './stack.variants.js';
+import type { StackGap, StackVariants } from './stack.variants.js';
+/**
+ * Subset of `<Stack>` props theme-configurable via
+ * `theme.components.Stack.defaults` (Option C).
+ *
+ * `gap` is deliberately overridden to the strict `StackGap` literal
+ * union rather than the `VariantProps`-widened `string` — see
+ * `stack.variants.ts` and issue #111 (G-27) for the widening bug.
+ */
+export type StackVariantProps = Pick<StackVariants, 'direction' | 'align' | 'justify' | 'wrap' | 'fullWidth' | 'fullHeight'> & {
+    gap?: StackGap;
+};
+declare module '@dashforge/tw-tokens' {
+    interface TWComponentDefaults {
+        Stack?: {
+            defaults?: Partial<StackVariantProps>;
+        };
+    }
+}
 /**
  * Props for `<Stack>` — flex container 1D, the layout primitive.
  *
@@ -21,7 +39,40 @@ import type { StackVariants } from './stack.variants.js';
  *   • 2D layout (rows AND columns)          → use <Grid>
  *   • Text styling                          → <Typography>
  */
-export interface StackProps extends Omit<HTMLAttributes<HTMLDivElement>, 'className'>, Pick<StackVariants, 'direction' | 'align' | 'justify' | 'gap' | 'wrap' | 'fullWidth' | 'fullHeight'> {
+export interface StackProps extends Omit<HTMLAttributes<HTMLDivElement>, 'className'> {
+    /**
+     * Flex direction.
+     * @default 'col'
+     */
+    direction?: StackVariants['direction'];
+    /** Cross-axis alignment (`items-*`). */
+    align?: StackVariants['align'];
+    /** Main-axis alignment (`justify-*`). */
+    justify?: StackVariants['justify'];
+    /**
+     * Gap between children — spacing token step. Accepts one of eleven
+     * numeric literals matching Box's spacing scale: `0 | 0.5 | 1 | 2 |
+     * 3 | 4 | 6 | 8 | 12 | 16 | 24`. Token strings (`'xs' | 'sm' | 'md'`)
+     * are **not** accepted — TypeScript rejects them at compile time,
+     * and a runtime pass through with an unknown value emits a
+     * dev-only `console.warn` (issue #111 / G-27).
+     */
+    gap?: StackGap;
+    /**
+     * Allow children to wrap to the next line (`flex-wrap`).
+     * @default false
+     */
+    wrap?: StackVariants['wrap'];
+    /**
+     * Stretch to fill the container's width.
+     * @default false
+     */
+    fullWidth?: StackVariants['fullWidth'];
+    /**
+     * Stretch to fill the container's height.
+     * @default false
+     */
+    fullHeight?: StackVariants['fullHeight'];
     /**
      * Node rendered N-1 times BETWEEN children — mirror of MUI Stack's
      * divider prop. Useful for visual separators (a `<hr>`, a thin

package/dist/src/components/Stack/stack.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stack.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Stack/stack.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,EACjD,IAAI,CAAC,aAAa,EAChB,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,GAChD,WAAW,GAAG,YAAY,CAAC;IACvC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;;;;;;OAOG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;IAEjB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb"}
+{"version":3,"file":"stack.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Stack/stack.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,aAAa,EACb,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CACxE,GAAG;IACF,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEF,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,mBAAmB;QAC3B,KAAK,CAAC,EAAE;YACN,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;SACvC,CAAC;KACH;CACF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC;IACzD;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAEvC,wCAAwC;IACxC,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAE/B,yCAAyC;IACzC,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAEnC;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,QAAQ,CAAC;IAEf;;;OAGG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAE7B;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAEvC;;;OAGG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAEzC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;;;;;;OAOG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;IAEjB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb"}

package/dist/src/components/Stack/stack.variants.d.ts

@@ -160,4 +160,27 @@ export declare const stackVariants: import("tailwind-variants").TVReturnType<{
     };
 }, undefined, "flex", unknown, unknown, undefined>>;
 export type StackVariants = VariantProps<typeof stackVariants>;
+/**
+ * The 11 accepted values for `<Stack gap>` — same set as Box's spacing
+ * axes (p, m, etc.). Exported so the JSDoc, the runtime dev-warn, and
+ * the `<Stack>` prop type all speak the same list.
+ *
+ * Why re-declared instead of derived from `stackVariants.variants.gap`
+ * via `VariantProps`: `tailwind-variants` 3.x widens variant value
+ * types to `string | undefined` when the variant object has mixed-type
+ * keys (numeric literals + string literals like `'0.5'`), which is why
+ * TS silently accepted `<Stack gap="md">` before #111 — that's the
+ * whole bug this literal union closes. Keep this list in sync with
+ * the `gap` object in the `variants` block above.
+ *
+ * @see Issue #111 — silent-fail when `gap` receives a token value that
+ * isn't on the numeric scale (G-27).
+ */
+export type StackGap = 0 | 0.5 | 1 | 2 | 3 | 4 | 6 | 8 | 12 | 16 | 24;
+/**
+ * Runtime allow-list, for the dev-warn to check against a passed
+ * `gap` value at render time. Same set as {@link StackGap}. Frozen
+ * so callers can't mutate the source of truth.
+ */
+export declare const STACK_GAP_VALUES: readonly StackGap[];
 //# sourceMappingURL=stack.variants.d.ts.map

package/dist/src/components/Stack/stack.variants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stack.variants.d.ts","sourceRoot":"","sources":["../../../../src/components/Stack/stack.variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mDAgDxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"stack.variants.d.ts","sourceRoot":"","sources":["../../../../src/components/Stack/stack.variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mDAgDxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,CAAC;AAE/D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,QAAQ,GAChB,CAAC,GACD,GAAG,GACH,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,EAAE,GACF,EAAE,GACF,EAAE,CAAC;AAEP;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,QAAQ,EAE9C,CAAC"}

package/dist/src/components/Stepper/Step.d.ts

@@ -0,0 +1,30 @@
+import type { StepProps } from './stepper.types.js';
+/**
+ * `<Step>` — a config-carrier child of `<Stepper>`.
+ *
+ * Renders NOTHING on its own — the parent `<Stepper>` walks its children
+ * with `React.Children.toArray`, extracts each `<Step>`'s props to build
+ * the visible sequence, and drives the strip + content rendering from
+ * there. This mirrors the MUI Tabs / Chakra Tabs "compound children as
+ * config" pattern.
+ *
+ * Placement rule (enforced by the parent's dev-warn): `<Step>` must be a
+ * DIRECT child of `<Stepper>`. Wrapping steps in a fragment is fine
+ * (`React.Children.toArray` flattens fragments); wrapping in an arbitrary
+ * `<div>` is not — the parent won't see the step and will skip it.
+ *
+ * @see StepProps for the full config surface.
+ */
+export declare function Step(_props: StepProps): null;
+export declare namespace Step {
+    var displayName: string;
+}
+/**
+ * Marker used by `<Stepper>` to recognize its own compound child type
+ * without pulling in `React.ReactElement<StepProps>` machinery. The
+ * parent traverses `React.Children.toArray(children)` and matches on
+ * `child.type === Step` — matching on `displayName` would be brittle
+ * against React tree cloning.
+ */
+export declare const __IS_STEP: unique symbol;
+//# sourceMappingURL=Step.d.ts.map

package/dist/src/components/Stepper/Step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Step.d.ts","sourceRoot":"","sources":["../../../../src/components/Stepper/Step.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAE5C;yBAFe,IAAI;;;AAMpB;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,eAAmC,CAAC"}

package/dist/src/components/Stepper/Stepper.d.ts

@@ -0,0 +1,15 @@
+import type { StepperProps } from './stepper.types.js';
+/**
+ * `<Stepper>` — declarative multi-step navigation with compound `<Step>`
+ * children. The parent walks its children, extracts each `<Step>`'s
+ * props, filters by `visibleWhen`, and drives the strip + content
+ * rendering. Consumers reach the current step state + navigation API
+ * via the `useStep()` hook.
+ *
+ * See {@link StepperProps} for the full API surface.
+ */
+export declare function Stepper(props: StepperProps): import("react/jsx-runtime").JSX.Element | null;
+export declare namespace Stepper {
+    var displayName: string;
+}
+//# sourceMappingURL=Stepper.d.ts.map

package/dist/src/components/Stepper/Stepper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stepper.d.ts","sourceRoot":"","sources":["../../../../src/components/Stepper/Stepper.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAEV,YAAY,EAIb,MAAM,oBAAoB,CAAC;AAqC5B;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,kDAia1C;yBAjae,OAAO"}

package/dist/src/components/Stepper/StepperContext.d.ts

@@ -0,0 +1,8 @@
+import type { UseStepReturn } from './stepper.types.js';
+/**
+ * Internal context wired by `<Stepper>` and read by `useStep()`. Not
+ * exported from the package — consumers reach the state only via the
+ * `useStep()` hook.
+ */
+export declare const StepperContext: import("react").Context<UseStepReturn | null>;
+//# sourceMappingURL=StepperContext.d.ts.map

package/dist/src/components/Stepper/StepperContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepperContext.d.ts","sourceRoot":"","sources":["../../../../src/components/Stepper/StepperContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,cAAc,+CAA4C,CAAC"}