@dashforge/tw 1.1.0 → 1.2.0

package/dist/src/components/Progress/progress.variants.d.ts

@@ -0,0 +1,224 @@
+import { type VariantProps } from 'tailwind-variants';
+/**
+ * Tailwind-variants recipe for `<Progress>` — display-only determinate
+ * progress bar. Two visual flavors:
+ *
+ *   - `variant='linear'`   — horizontal bar with a filled `bar` slot
+ *   - `variant='circular'` — SVG arc with a filled `arc` slot
+ *
+ * Slots:
+ *   - `root`       — outer wrapper (label + control + value label)
+ *   - `label`      — optional field-style label above the control
+ *   - `control`    — the linear track OR the SVG viewport for circular
+ *   - `track`      — the grey background (linear bar OR circular ring)
+ *   - `bar`        — the filled portion on the linear variant
+ *   - `arc`        — the filled arc on the circular variant
+ *   - `valueLabel` — the `%` text (positioned differently per variant)
+ *
+ * Colour intents match the rest of the catalog. `neutral` skips
+ * `dark:` variants — the preset CSS-var swap handles inversion.
+ * Thickness axis controls the track height on `linear` and the arc
+ * `stroke-width` on `circular`.
+ */
+export declare const progressVariants: import("tailwind-variants").TVReturnType<{
+    variant: {
+        linear: {
+            control: string;
+            track: string;
+        };
+        circular: {
+            control: string;
+            track: string;
+            valueLabel: string;
+        };
+    };
+    color: {
+        primary: {
+            bar: string;
+            arc: string;
+        };
+        secondary: {
+            bar: string;
+            arc: string;
+        };
+        success: {
+            bar: string;
+            arc: string;
+        };
+        warning: {
+            bar: string;
+            arc: string;
+        };
+        danger: {
+            bar: string;
+            arc: string;
+        };
+        neutral: {
+            bar: string;
+            arc: string;
+        };
+    };
+    size: {
+        sm: {
+            control: string;
+        };
+        md: {
+            control: string;
+        };
+        lg: {
+            control: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    control: string;
+    track: string;
+    bar: string[];
+    arc: string[];
+    valueLabel: string;
+}, undefined, {
+    variant: {
+        linear: {
+            control: string;
+            track: string;
+        };
+        circular: {
+            control: string;
+            track: string;
+            valueLabel: string;
+        };
+    };
+    color: {
+        primary: {
+            bar: string;
+            arc: string;
+        };
+        secondary: {
+            bar: string;
+            arc: string;
+        };
+        success: {
+            bar: string;
+            arc: string;
+        };
+        warning: {
+            bar: string;
+            arc: string;
+        };
+        danger: {
+            bar: string;
+            arc: string;
+        };
+        neutral: {
+            bar: string;
+            arc: string;
+        };
+    };
+    size: {
+        sm: {
+            control: string;
+        };
+        md: {
+            control: string;
+        };
+        lg: {
+            control: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    control: string;
+    track: string;
+    bar: string[];
+    arc: string[];
+    valueLabel: string;
+}, import("tailwind-variants").TVReturnType<{
+    variant: {
+        linear: {
+            control: string;
+            track: string;
+        };
+        circular: {
+            control: string;
+            track: string;
+            valueLabel: string;
+        };
+    };
+    color: {
+        primary: {
+            bar: string;
+            arc: string;
+        };
+        secondary: {
+            bar: string;
+            arc: string;
+        };
+        success: {
+            bar: string;
+            arc: string;
+        };
+        warning: {
+            bar: string;
+            arc: string;
+        };
+        danger: {
+            bar: string;
+            arc: string;
+        };
+        neutral: {
+            bar: string;
+            arc: string;
+        };
+    };
+    size: {
+        sm: {
+            control: string;
+        };
+        md: {
+            control: string;
+        };
+        lg: {
+            control: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    control: string;
+    track: string;
+    bar: string[];
+    arc: string[];
+    valueLabel: string;
+}, undefined, unknown, unknown, undefined>>;
+export type ProgressVariants = VariantProps<typeof progressVariants>;
+/**
+ * Linear track height (in px) per (size × thickness) pair. Derived
+ * inline in the component to avoid a compound-variant explosion.
+ */
+export declare const LINEAR_TRACK_HEIGHTS: Record<'sm' | 'md' | 'lg', Record<'thin' | 'md' | 'thick', number>>;
+/**
+ * Circular geometry per size — SVG viewBox is a square. Radius +
+ * stroke-width define the visible arc. Derived inline.
+ */
+export declare const CIRCULAR_GEOMETRY: Record<'sm' | 'md' | 'lg', Record<'thin' | 'md' | 'thick', {
+    size: number;
+    stroke: number;
+}>>;
+//# sourceMappingURL=progress.variants.d.ts.map

package/dist/src/components/Progress/progress.variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.variants.d.ts","sourceRoot":"","sources":["../../../../src/components/Progress/progress.variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAuE3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CACvC,IAAI,GAAG,IAAI,GAAG,IAAI,EAClB,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE,MAAM,CAAC,CAKxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CACpC,IAAI,GAAG,IAAI,GAAG,IAAI,EAClB,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAKlE,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"RadioGroup.d.ts","sourceRoot":"","sources":["../../../../src/components/RadioGroup/RadioGroup.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,kDA+OhD"}
+{"version":3,"file":"RadioGroup.d.ts","sourceRoot":"","sources":["../../../../src/components/RadioGroup/RadioGroup.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,kDA6PhD"}

package/dist/src/components/RadioGroup/radioGroup.types.d.ts

@@ -2,6 +2,19 @@ import type { ReactNode } from 'react';
 import type { Engine } from '@dashforge/ui-core';
 import type { AccessRequirement } from '@dashforge/rbac';
 import type { RadioGroupVariants } from './radioGroup.variants.js';
+/**
+ * Subset of `<RadioGroup>` props theme-configurable via
+ * `theme.components.RadioGroup.defaults` (Option C).
+ */
+export type RadioGroupVariantProps = Pick<RadioGroupVariants, 'size' | 'layout'>;
+declare module '@dashforge/tw-tokens' {
+    interface TWComponentDefaults {
+        RadioGroup?: {
+            defaults?: Partial<RadioGroupVariantProps>;
+            slotProps?: RadioGroupSlotProps;
+        };
+    }
+}
 /**
  * A single selectable option in a `<RadioGroup>`.
  */
@@ -68,7 +81,18 @@ export interface RadioGroupSlotProps {
  * same `name` / `rules` / `visibleWhen` / `access` semantics, same
  * Form Closure v1 error gating, same option-level RBAC.
  */
-export interface RadioGroupProps extends RadioGroupVariants {
+export interface RadioGroupProps {
+    /**
+     * Density tier — drives radio dot size + label font-size.
+     * @default 'md'
+     */
+    size?: RadioGroupVariants['size'];
+    /**
+     * Option list direction. `'stacked'` (default) is vertical;
+     * `'row'` is horizontal.
+     * @default 'stacked'
+     */
+    layout?: RadioGroupVariants['layout'];
     /** Field name registered with the bridge. */
     name: string;
     /** Array of selectable options. Order is render order. */

package/dist/src/components/RadioGroup/radioGroup.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"radioGroup.types.d.ts","sourceRoot":"","sources":["../../../../src/components/RadioGroup/radioGroup.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,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,KAAK,EAAE,SAAS,CAAC;IACjB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,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,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,WAAW,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,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;;;;;;GAMG;AACH,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;IACzD,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uEAAuE;IACvE,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,mEAAmE;IACnE,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,oEAAoE;IACpE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC"}
+{"version":3,"file":"radioGroup.types.d.ts","sourceRoot":"","sources":["../../../../src/components/RadioGroup/radioGroup.types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,14 @@
+import { type ReactElement } from 'react';
+import type { SelectProps, SelectValue } from './select.types.js';
+/**
+ * `<Select>` — generic-friendly forwardRef wrapper.
+ *
+ * The type dance below preserves the `V` type parameter through
+ * `forwardRef`, which by default would strip it. Consumers can either
+ * let TypeScript infer `V` from `options` or pass it explicitly:
+ *   `<Select<'a' | 'b'> options={…} onChange={…} />`.
+ */
+export declare const Select: <V extends SelectValue = string>(props: SelectProps<V> & {
+    ref?: React.Ref<HTMLButtonElement>;
+}) => ReactElement | null;
+//# sourceMappingURL=Select.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../../src/components/Select/Select.tsx"],"names":[],"mappings":"AAAA,OAAO,EAUL,KAAK,YAAY,EAElB,MAAM,OAAO,CAAC;AAWf,OAAO,KAAK,EAIV,WAAW,EACX,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAqlB3B;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,EAA8B,CAAC,CAAC,SAAS,WAAW,GAAG,MAAM,EAC9E,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,KAC3D,YAAY,GAAG,IAAI,CAAC"}

package/dist/src/components/Select/select.types.d.ts

@@ -0,0 +1,272 @@
+import type { ReactNode } from 'react';
+import type { Engine } from '@dashforge/ui-core';
+import type { AccessRequirement } from '@dashforge/rbac';
+import type { SelectVariants } from './select.variants.js';
+/**
+ * The primitive types `<Select>` accepts as an option value.
+ *
+ * `string` for enum tokens (`'solid' | 'outline'`), `number` for numeric
+ * IDs (typical when the backend stores integer foreign keys). Union-of-
+ * strings is inferred from the options array so `V` narrows precisely at
+ * the consumer site — `<Select options={[{value:'a',...},{value:'b',...}]} />`
+ * gives `onChange: (value: 'a' | 'b', ...) => void`.
+ */
+export type SelectValue = string | number;
+/**
+ * A single option in the picker's list.
+ *
+ * Mirrors `AutocompleteOption` on purpose — Blueprint's `TwSelect`
+ * binding (and any consumer alternating between Autocomplete and Select)
+ * pastes the same array between the two.
+ *
+ * @typeParam V — the primitive that gets committed to the form when the
+ *              option is selected. Defaults to `string`; pass `number`
+ *              for enums whose identity is a numeric ID.
+ *
+ * `label` is `ReactNode` (not `string`) on purpose: it lets consumers
+ * pass a `<Trans i18nKey="…" />` / `<FormattedMessage …/>` for reactive
+ * i18n without wrapping the whole options array in a `useMemo`. If the
+ * app's i18n exposes a `t()` function that returns a string, the same
+ * `useMemo` pattern applies — see the "Static enum options with i18n"
+ * section of the docs.
+ */
+export interface SelectOption<V extends SelectValue = string> {
+    /** The primitive persisted on the form and matched against `value`. */
+    value: V;
+    /** Display label — accepts any React node for icons / rich content / i18n. */
+    label: ReactNode;
+    /** Per-option explicit disable — grays the row and blocks selection. */
+    disabled?: boolean;
+}
+/**
+ * Subset of `<Select>` props theme-configurable via
+ * `theme.components.Select.defaults` (Option C).
+ *
+ * These are the axes a design system typically pins application-wide
+ * (density, layout convention, fullWidth default in a compact panel).
+ */
+export type SelectVariantProps = Pick<SelectVariants, 'size' | 'layout' | 'fullWidth'>;
+/**
+ * Per-slot override map. Each entry accepts `{ className?: string }`.
+ * See {@link selectVariants} for the full slot roster.
+ */
+export interface SelectSlotProps {
+    root?: {
+        className?: string;
+    };
+    label?: {
+        className?: string;
+    };
+    requiredMark?: {
+        className?: string;
+    };
+    trigger?: {
+        className?: string;
+    };
+    triggerText?: {
+        className?: string;
+    };
+    triggerPlaceholder?: {
+        className?: string;
+    };
+    chevron?: {
+        className?: string;
+    };
+    popover?: {
+        className?: string;
+    };
+    listBox?: {
+        className?: string;
+    };
+    listItem?: {
+        className?: string;
+    };
+    listItemIndicator?: {
+        className?: string;
+    };
+    emptyState?: {
+        className?: string;
+    };
+    helperText?: {
+        className?: string;
+    };
+    errorText?: {
+        className?: string;
+    };
+    chipsList?: {
+        className?: string;
+    };
+    chip?: {
+        className?: string;
+    };
+    chipRemove?: {
+        className?: string;
+    };
+}
+declare module '@dashforge/tw-tokens' {
+    interface TWComponentDefaults {
+        Select?: {
+            defaults?: Partial<SelectVariantProps>;
+            slotProps?: SelectSlotProps;
+        };
+    }
+}
+/**
+ * Change handler signature.
+ *
+ * Fires with the primitive value AND the full `SelectOption` object so
+ * the consumer can:
+ *   - Simple case: `onChange={setVariant}` — TS narrows `value` to the
+ *     literal union inferred from options.
+ *   - Rich case: destructure `(value, option) => …` to access custom
+ *     fields the consumer put on the option (icon, region metadata,
+ *     server-side row identifier, etc.).
+ *
+ * For `multiple: true`, the signature carries the full array of selected
+ * values and the full array of matching options — same ergonomic in
+ * both directions.
+ */
+export type SelectChangeHandler<V extends SelectValue = string> = (value: V, option: SelectOption<V>) => void;
+export type SelectMultiChangeHandler<V extends SelectValue = string> = (values: V[], options: SelectOption<V>[]) => void;
+/**
+ * Props for `<Select>`. The primitive shipped in Sprint 6 as the
+ * dedicated enum picker — chosen over extending `<Autocomplete>` with
+ * a `disableSearch` flag so the two components have clean boundaries
+ * (Autocomplete = search / async / typeahead; Select = static enum /
+ * 3–10 options / no search).
+ *
+ * Behaviour parity with the rest of the tw form catalog:
+ *   - Bridge integration inside `<DashFormProvider>` (registers via
+ *     `bridge.register(name, rules)`, subscribes reactively via
+ *     `useDashFieldMeta(name)`, commits via `bridge.setValue`).
+ *   - Standalone controlled outside a form (pass `value` + `onChange`).
+ *   - RBAC (`access`) + visibility (`visibleWhen`) forwarded to the
+ *     `useAccessState` / `useEngineVisibility` hooks used everywhere
+ *     else in the catalog.
+ *
+ * @typeParam V — the primitive type of the option values. Inferred from
+ *              the options array — `<Select options={[{value:'a'},...]}/>`
+ *              narrows `value` and `onChange` to the union of the passed
+ *              literals.
+ */
+export interface SelectProps<V extends SelectValue = string> {
+    /**
+     * Field name — required at the TypeScript level. Consistent with the
+     * rest of the tw form catalog: enforcing `name` at compile time
+     * prevents the "silent no-op" family of bugs (see #113).
+     */
+    name: string;
+    /**
+     * React Hook Form rule set. Forwarded to `bridge.register(name, rules)`
+     * when inside a `<DashFormProvider>`. Ignored outside a form.
+     * Untyped by design here — the rules shape belongs to whatever RHF
+     * version the consumer app pins, so we pass through as-is (mirrors
+     * Autocomplete's `rules?: unknown`).
+     */
+    rules?: unknown;
+    /**
+     * Text or node shown above (or to the left of, in `inline` layout)
+     * the trigger.
+     */
+    label?: ReactNode;
+    /**
+     * Descriptive line under the trigger. Replaced by the bridge's
+     * validation error when the field is invalid.
+     */
+    helperText?: ReactNode;
+    /**
+     * Force error state without consulting the bridge — useful for
+     * server-side / async validation the bridge doesn't own.
+     */
+    error?: boolean;
+    /**
+     * Renders the red `*` required marker and forwards to the native
+     * `required` attribute. Distinct from `rules.required` — this one
+     * is purely visual + native; the bridge validation runs independently.
+     */
+    required?: boolean;
+    /** Grays out the trigger + popover, blocks keyboard interaction. */
+    disabled?: boolean;
+    /** Stretches the root + trigger to `w-full`. */
+    fullWidth?: boolean;
+    /**
+     * Layout — `stacked` (label above trigger) or `inline` (label on the
+     * left, trigger on the right). Matches Autocomplete.
+     * @default 'stacked'
+     */
+    layout?: SelectVariants['layout'];
+    /**
+     * Density knob — matches Autocomplete + TextField / NumberField.
+     * @default 'md'
+     */
+    size?: SelectVariants['size'];
+    /** Reactive visibility predicate. Falsy → renders null. */
+    visibleWhen?: (engine: Engine) => boolean;
+    /** RBAC gate. See `useAccessState`. */
+    access?: AccessRequirement;
+    /**
+     * The static options list. `[]` renders the empty state in the
+     * popover. Consumers typically define this at module scope for
+     * stability, or `useMemo` it if the list depends on props / i18n.
+     */
+    options: readonly SelectOption<V>[];
+    /**
+     * Placeholder text shown in the trigger when no value is selected.
+     * @default 'Select…'
+     */
+    placeholder?: ReactNode;
+    /**
+     * Fallback rendered inside the popover when `options` is empty.
+     * @default 'No options'
+     */
+    emptyState?: ReactNode;
+    /**
+     * Controlled selection. For single-select, the primitive value of
+     * the currently chosen option (or `null` for nothing selected). For
+     * multi-select (`multiple: true`), the array of selected values.
+     *
+     * When omitted AND the field is not bridge-managed, the component
+     * runs uncontrolled and manages selection internally.
+     */
+    value?: V | V[] | null;
+    /**
+     * Uncontrolled initial value. Same shape rules as `value`.
+     */
+    defaultValue?: V | V[] | null;
+    /**
+     * Called on selection change.
+     *
+     * Two arguments — the primitive value that will be committed to the
+     * form, AND the full `SelectOption` object (for consumers who put
+     * custom fields on the option and want them at hand in the callback
+     * without an extra lookup).
+     *
+     * TypeScript picks the single- or multi-select signature based on
+     * the runtime `multiple` prop via the discriminated union at the
+     * type layer.
+     */
+    onChange?: SelectChangeHandler<V> | SelectMultiChangeHandler<V>;
+    /** Fired on trigger blur (after the popover closes). */
+    onBlur?: () => void;
+    /**
+     * When true, allows multiple selections. `value` / `defaultValue`
+     * become arrays; `onChange` receives the array signature; the trigger
+     * renders a chip list of selected items.
+     *
+     * Additive — single-select consumers ignore this and get the classic
+     * enum picker behaviour.
+     *
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * Utility-class shortcut for `slotProps.trigger.className` — mirrors
+     * the Dashforge idiom on other primitives (Button, Dialog, Link).
+     */
+    sx?: string;
+    /** Per-slot overrides. */
+    slotProps?: SelectSlotProps;
+    /** `data-testid` forwarded to the root wrapper. */
+    testId?: string;
+}
+//# sourceMappingURL=select.types.d.ts.map

package/dist/src/components/Select/select.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Select/select.types.ts"],"names":[],"mappings":"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"}