@dashforge/tw 1.1.1 → 1.3.0

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

@@ -0,0 +1,279 @@
+import type { ReactNode } from 'react';
+import type { Engine } from '@dashforge/ui-core';
+import type { AccessRequirement } from '@dashforge/rbac';
+import type { SliderVariants } from './slider.variants.js';
+/**
+ * The value shape a `<Slider>` accepts.
+ *
+ * - `number` — single-value mode (default). Common: volume, opacity,
+ *   threshold, rating.
+ * - `readonly [number, number]` — range mode (`range={true}`). Common:
+ *   price range, min/max filter, time window.
+ */
+export type SliderValue = number | readonly [number, number];
+/**
+ * A tick on the track.
+ *
+ * @property value — the numeric position on the track (must be within
+ *                   `[min, max]`).
+ * @property label — optional display node under the tick. Passing
+ *                   `undefined` renders only the tick, no text.
+ */
+export interface SliderMark {
+    value: number;
+    label?: ReactNode;
+}
+/**
+ * Subset of `<Slider>` props theme-configurable via
+ * `theme.components.Slider.defaults` (Option C).
+ *
+ * These are the visual axes a DS typically pins application-wide —
+ * density, layout, color intent. `error` / `disabled` / `fullWidth`
+ * are per-instance state axes, not visual identity.
+ */
+export type SliderVariantProps = Pick<SliderVariants, 'size' | 'layout' | 'color' | 'fullWidth'>;
+/**
+ * Per-slot override map. See {@link sliderVariants} for the full slot
+ * roster.
+ */
+export interface SliderSlotProps {
+    root?: {
+        className?: string;
+    };
+    label?: {
+        className?: string;
+    };
+    requiredMark?: {
+        className?: string;
+    };
+    controlWrapper?: {
+        className?: string;
+    };
+    track?: {
+        className?: string;
+    };
+    rangeSegment?: {
+        className?: string;
+    };
+    thumb?: {
+        className?: string;
+    };
+    mark?: {
+        className?: string;
+    };
+    markLabel?: {
+        className?: string;
+    };
+    valueLabel?: {
+        className?: string;
+    };
+    helperText?: {
+        className?: string;
+    };
+    errorText?: {
+        className?: string;
+    };
+}
+declare module '@dashforge/tw-tokens' {
+    interface TWComponentDefaults {
+        Slider?: {
+            defaults?: Partial<SliderVariantProps>;
+            slotProps?: SliderSlotProps;
+        };
+    }
+}
+interface SliderCommonProps {
+    /**
+     * Field name. Required — matches every other tw form widget. Enforced
+     * at the type level to prevent the "silent no-op" family of bugs
+     * (see #113).
+     */
+    name: string;
+    /**
+     * RHF rules. Forwarded to `bridge.register(name, rules)` inside a
+     * `<DashFormProvider>`. Ignored standalone.
+     */
+    rules?: unknown;
+    /** Text or node above (or to the left in `inline` layout) the control. */
+    label?: ReactNode;
+    /** Descriptive line below the control. Replaced by the validation error message when the field is invalid. */
+    helperText?: ReactNode;
+    /** Force error state (danger colour on track + thumb, `aria-invalid` on the thumb). */
+    error?: boolean;
+    /** Renders the red `*` next to the label. */
+    required?: boolean;
+    /** Grays out the control; blocks drag + keyboard. */
+    disabled?: boolean;
+    /** Stretches the root to `w-full`. */
+    fullWidth?: boolean;
+    /**
+     * Layout — `stacked` (label above) or `inline` (label left of the
+     * control). Matches TextField / Select / Autocomplete.
+     * @default 'stacked'
+     */
+    layout?: SliderVariants['layout'];
+    /**
+     * Density knob.
+     * @default 'md'
+     */
+    size?: SliderVariants['size'];
+    /**
+     * Colour intent for the range segment + thumb + value label.
+     * `neutral` auto-inverts via the preset CSS-var swap. Configurable
+     * application-wide via `theme.components.Slider.defaults.color`.
+     * @default 'primary'
+     */
+    color?: SliderVariants['color'];
+    /** Reactive visibility predicate. Falsy → renders null. */
+    visibleWhen?: (engine: Engine) => boolean;
+    /** RBAC gate — see `useAccessState`. */
+    access?: AccessRequirement;
+    /** Lower bound of the track. @default 0 */
+    min?: number;
+    /** Upper bound of the track. @default 100 */
+    max?: number;
+    /**
+     * Step size between valid values. `keyboardStep` in Radix defaults
+     * to this. Set to `1` for integers, `0.1` / `0.01` for fractional.
+     * @default 1
+     */
+    step?: number;
+    /**
+     * Tick marks on the track.
+     *
+     * - `readonly SliderMark[]` — explicit marks with optional labels.
+     * - `true` — auto-generate marks at every `step` position (only up to
+     *   a reasonable density; skipped if the resulting count > 21).
+     * - `false` / omitted — no marks.
+     */
+    marks?: readonly SliderMark[] | boolean;
+    /**
+     * Show the current value as a tooltip above the thumb.
+     *
+     * - `'auto'` — visible on hover, drag, or keyboard focus.
+     * - `'always'` — always visible.
+     * - `'off'` — never rendered.
+     *
+     * @default 'off'
+     */
+    showValueLabel?: 'auto' | 'always' | 'off';
+    /**
+     * Format the display value in the value label tooltip and in the
+     * marks' labels when `marks: true` auto-labelling kicks in.
+     * @default (value) => String(value)
+     */
+    formatValue?: (value: number) => ReactNode;
+    /**
+     * When true, writes to the form bridge on every drag tick instead of
+     * only on drag-end. Costs 60 setValue/sec during drag but gives the
+     * "value in form == value shown" semantic if the consumer's form
+     * depends on the value reactively (e.g. price-range filter feeding a
+     * live product list).
+     *
+     * Keyboard changes always commit immediately regardless of this
+     * setting — each arrow-key press is a single tick + commit.
+     *
+     * @default false
+     */
+    commitOnChange?: boolean;
+    /**
+     * Utility-class shortcut for `slotProps.controlWrapper.className` —
+     * mirrors the Dashforge idiom on other primitives.
+     */
+    sx?: string;
+    /** Per-slot overrides. */
+    slotProps?: SliderSlotProps;
+    /** `data-testid` on the root wrapper. */
+    testId?: string;
+}
+/**
+ * Single-value mode — `range` omitted or `false`. `value` /
+ * `defaultValue` are `number`; `onChange` / `onCommit` receive `number`.
+ */
+export interface SliderSingleProps extends SliderCommonProps {
+    /**
+     * Discriminator — omit or set `false` for single-value mode. Selects
+     * the `number` value/callback shapes over the range tuple.
+     * @default false
+     */
+    range?: false;
+    /** Controlled value. */
+    value?: number;
+    /** Uncontrolled initial value. */
+    defaultValue?: number;
+    /**
+     * Fires on every drag tick + keyboard step. UI-side handler — does
+     * NOT write to the bridge unless `commitOnChange` is true.
+     */
+    onChange?: (value: number) => void;
+    /**
+     * Fires on drag-end (pointer up) and on every keyboard step. This is
+     * what writes to the form bridge — matches MUI / Ant defaults.
+     */
+    onCommit?: (value: number) => void;
+    /** Fires when the thumb loses focus (after a commit). */
+    onBlur?: () => void;
+}
+/**
+ * Range mode — `range={true}`. `value` / `defaultValue` are
+ * `[number, number]`; `onChange` / `onCommit` receive the tuple.
+ */
+export interface SliderRangeProps extends SliderCommonProps {
+    /**
+     * Discriminator — set `true` for range mode. Selects the
+     * `[number, number]` tuple value/callback shapes over the single number.
+     */
+    range: true;
+    /** Controlled `[min, max]` tuple. */
+    value?: readonly [number, number];
+    /** Uncontrolled initial `[min, max]` tuple. */
+    defaultValue?: readonly [number, number];
+    /** UI-side per-tick callback. */
+    onChange?: (value: readonly [number, number]) => void;
+    /** Drag-end / keyboard-step callback. Writes to the bridge. */
+    onCommit?: (value: readonly [number, number]) => void;
+    /** Fires when a thumb loses focus (after a commit). */
+    onBlur?: () => void;
+}
+/**
+ * Props for `<Slider>`.
+ *
+ * Discriminated on `range` — TypeScript narrows `value` / `onChange` /
+ * `onCommit` to `number` (single) or `[number, number]` (range) based
+ * on the runtime `range` prop.
+ *
+ * @example Single-value (volume slider)
+ * ```tsx
+ * <Slider name="volume" min={0} max={100} value={volume} onCommit={setVolume} />
+ * ```
+ *
+ * @example Range (price filter)
+ * ```tsx
+ * <Slider
+ *   name="priceRange"
+ *   range
+ *   min={0}
+ *   max={1000}
+ *   value={[100, 500]}
+ *   onCommit={setPriceRange}
+ * />
+ * ```
+ *
+ * @example Marks with labels + custom formatter
+ * ```tsx
+ * <Slider
+ *   name="brightness"
+ *   min={0} max={100} step={25}
+ *   marks={[
+ *     { value: 0,   label: 'Off' },
+ *     { value: 50,  label: 'Med' },
+ *     { value: 100, label: 'Max' },
+ *   ]}
+ *   showValueLabel="auto"
+ *   formatValue={(v) => `${v}%`}
+ * />
+ * ```
+ */
+export type SliderProps = SliderSingleProps | SliderRangeProps;
+export {};
+//# sourceMappingURL=slider.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slider.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Slider/slider.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,cAAc,EACd,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,CAC1C,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,cAAc,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,mBAAmB;QAC3B,MAAM,CAAC,EAAE;YACP,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;YACvC,SAAS,CAAC,EAAE,eAAe,CAAC;SAC7B,CAAC;KACH;CACF;AAGD,UAAU,iBAAiB;IAEzB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAGhB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,8GAA8G;IAC9G,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,uFAAuF;IACvF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAElC;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAE9B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAGhC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,wCAAwC;IACxC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAG3B,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC;IAGxC;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAE3C;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAG3C;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAGzB;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,0BAA0B;IAC1B,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD;;;OAGG;IACH,KAAK,EAAE,IAAI,CAAC;IACZ,qCAAqC;IACrC,KAAK,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,iCAAiC;IACjC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IACtD,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IACtD,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG,gBAAgB,CAAC"}

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"}