@12-apps/ui 6.20.0 → 6.21.0

package/dist/types/components/form/Input/Input.styles.d.ts

@@ -1,45 +1,11 @@
 import type { CSSObject, Theme } from '@mui/material/styles/index.js';
 import type { InputProps } from './Input.types';
 type InputVariant = NonNullable<InputProps['variant']>;
-/** Our four variants map onto MUI's three; `glass` and `gradient` restyle an outline. */
-export declare const muiVariantFor: (variant: InputVariant) => "outlined" | "filled" | "standard";
-export declare const SIZE_MAP: {
-    xs: {
-        size: "small";
-        sx: {
-            '& .MuiInputBase-input': {
-                padding: string;
-            };
-        };
-    };
-    sm: {
-        size: "small";
-    };
-    md: {
-        size: "medium";
-    };
-    lg: {
-        size: "medium";
-        sx: {
-            '& .MuiInputBase-input': {
-                padding: string;
-            };
-        };
-    };
-    xl: {
-        size: "medium";
-        sx: {
-            '& .MuiInputBase-input': {
-                padding: string;
-            };
-        };
-    };
-};
+export { muiVariantFor, SIZE_MAP } from './Input.metrics';
 export declare const glowStyles: (theme: Theme) => CSSObject;
 export declare const pulseStyles: (theme: Theme) => CSSObject;
 export declare const floatingLabelStyles: (theme: Theme) => CSSObject;
 export declare const inputBaseStyles: (theme: Theme, variant?: InputVariant) => CSSObject;
 export declare const outlinedStyles: (theme: Theme) => CSSObject;
 export declare const filledStyles: (theme: Theme) => CSSObject;
-export {};
 //# sourceMappingURL=Input.styles.d.ts.map

package/dist/types/components/form/Input/Input.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Input.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Input/Input.styles.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,KAAK,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;AAkBvD,yFAAyF;AACzF,eAAO,MAAM,aAAa,GAAI,SAAS,YAAY,KAAG,UAAU,GAAG,QAAQ,GAAG,UAU7E,CAAC;AAIF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMpB,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,KAAK,KAAG,SAOxC,CAAC;AAIH,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,KAAG,SAgBzC,CAAC;AAEH,eAAO,MAAM,mBAAmB,GAAI,OAAO,KAAK,KAAG,SASjD,CAAC;AAEH,eAAO,MAAM,eAAe,GAAI,OAAO,KAAK,EAAE,UAAU,YAAY,KAAG,SAkCtE,CAAC;AAmCF,eAAO,MAAM,cAAc,GAAI,OAAO,KAAK,KAAG,SAc5C,CAAC;AAEH,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,KAAG,SAQ1C,CAAC"}
+{"version":3,"file":"Input.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Input/Input.styles.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAWtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,KAAK,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;AAIvD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAkB1D,eAAO,MAAM,UAAU,GAAI,OAAO,KAAK,KAAG,SAOxC,CAAC;AAIH,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,KAAG,SAgBzC,CAAC;AAEH,eAAO,MAAM,mBAAmB,GAAI,OAAO,KAAK,KAAG,SASjD,CAAC;AAEH,eAAO,MAAM,eAAe,GAAI,OAAO,KAAK,EAAE,UAAU,YAAY,KAAG,SAkCtE,CAAC;AAuCF,eAAO,MAAM,cAAc,GAAI,OAAO,KAAK,KAAG,SAc5C,CAAC;AAEH,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,KAAG,SAQ1C,CAAC"}

package/dist/types/components/form/Input/Input.types.d.ts

@@ -1,22 +1,17 @@
-import type { SizeValue } from '../../../tokens/scales';
 import type { InputLabelProps as MuiInputLabelProps } from '@mui/material/InputLabel/index.js';
-import type { InputHTMLAttributes, ReactNode } from 'react';
+import type { InputHTMLAttributes } from 'react';
 import type React from 'react';
-export type InputVariant = 'outlined' | 'filled' | 'glass' | 'underline' | 'gradient';
-export type InputSize = SizeValue;
-export interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'color'> {
-    variant?: InputVariant;
-    size?: InputSize;
-    label?: string;
-    error?: boolean;
-    helperText?: string;
-    startAdornment?: ReactNode;
-    endAdornment?: ReactNode;
-    fullWidth?: boolean;
-    floating?: boolean;
-    glow?: boolean;
-    pulse?: boolean;
-    loading?: boolean;
+import type { InputBaseProps } from './Input.base';
+export type { InputBaseProps, InputSize, InputVariant } from './Input.base';
+/**
+ * The web `Input`: the shared contract, plus everything an `<input>` accepts
+ * that the contract does not already name.
+ *
+ * `value`, `defaultValue` and `onChange` keep the DOM's own types — they are
+ * not in the base, because a web `value` is `string | number | readonly
+ * string[]` and a React Native one is a `string`.
+ */
+export interface InputProps extends InputBaseProps, Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'color' | keyof InputBaseProps> {
     onClick?: React.MouseEventHandler<HTMLInputElement>;
     onFocus?: React.FocusEventHandler<HTMLInputElement>;
     onBlur?: React.FocusEventHandler<HTMLInputElement>;

package/dist/types/components/form/Input/Input.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Input.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Input/Input.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,IAAI,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC/F,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;AACtF,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC;AAElC,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/F,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACpD,MAAM,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC/C"}
+{"version":3,"file":"Input.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Input/Input.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,IAAI,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC/F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,WAAW,UACf,SAAQ,cAAc,EACpB,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,cAAc,CAAC;IACtF,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACpD,MAAM,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC/C"}

package/dist/types/components/form/Input/index.d.ts

@@ -1,3 +1,3 @@
 export { Input } from './Input';
-export type { InputProps, InputSize, InputVariant } from './Input.types';
+export type { InputBaseProps, InputProps, InputSize, InputVariant } from './Input.types';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/components/form/Input/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Input/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAC,YAAY,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Input/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/types/components/form/Select/Select.base.d.ts

@@ -0,0 +1,75 @@
+import type { SizeValue } from '../../../tokens/vocabulary';
+/**
+ * THE CONTRACT BOTH RENDERERS HONOUR — and nothing else.
+ *
+ * No MUI and no react-native here: this file is in BOTH declaration outputs,
+ * and a native consumer has no `@mui/material` to resolve a type import
+ * against. See `Button.base.ts`.
+ */
+export type SelectVariant = 'default' | 'glass' | 'gradient';
+/** What a value can be. The DOM stringifies either, so the two are compared as strings. */
+export type SelectValue = string | number;
+export interface SelectOption {
+    value: SelectValue;
+    label: string;
+    disabled?: boolean;
+}
+/**
+ * The contract both renderers honour.
+ *
+ * `value`, `defaultValue` and `onChange` are NOT here: MUI types the value as
+ * `unknown` and the change as its own `SelectChangeEvent`, while the native
+ * side takes a `SelectValue` and synthesises the `{ target: { value } }` shape
+ * the web handlers already read.
+ */
+export interface SelectBaseProps {
+    /**
+     * Visual variant of the select component
+     * @default 'default'
+     */
+    variant?: SelectVariant;
+    /**
+     * Array of options to display in the select
+     */
+    options: SelectOption[];
+    /**
+     * Label for the select field
+     */
+    label?: string;
+    /**
+     * Helper text to display below the select
+     */
+    helperText?: string;
+    /**
+     * Whether the select should take full width
+     * @default true
+     */
+    fullWidth?: boolean;
+    /**
+     * Size of the select component
+     * @default 'medium'
+     */
+    size?: SizeValue;
+    /**
+     * Placeholder text when no option is selected
+     */
+    placeholder?: string;
+    /**
+     * Paints the field, the label and the helper text in the danger hue
+     */
+    error?: boolean;
+    /**
+     * Whether to show a glow effect
+     * @default false
+     */
+    glow?: boolean;
+    /**
+     * Whether to show a pulse animation
+     * @default false
+     */
+    pulse?: boolean;
+    disabled?: boolean;
+    testID?: string;
+    dataTestId?: string;
+}
+//# sourceMappingURL=Select.base.d.ts.map

package/dist/types/components/form/Select/Select.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Select.base.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Select/Select.base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAE7D,2FAA2F;AAC3F,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;OAEG;IACH,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/components/form/Select/Select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Select/Select.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA8KlD,eAAO,MAAM,MAAM,iGAiFlB,CAAC"}
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Select/Select.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,OAAO,CAAC;AAU1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAkLlD,eAAO,MAAM,MAAM,iGAiFlB,CAAC"}

package/dist/types/components/form/Select/Select.helpers.d.ts

@@ -0,0 +1,36 @@
+import type { SelectBaseProps, SelectOption, SelectValue } from './Select.base';
+type SelectDefaultedKeys = 'variant' | 'size' | 'fullWidth' | 'error' | 'glow' | 'pulse' | 'disabled';
+export type ResolvedSelectProps<P extends SelectBaseProps> = P & Required<Pick<SelectBaseProps, SelectDefaultedKeys>>;
+export declare const resolveSelectProps: <P extends SelectBaseProps>(props: P) => ResolvedSelectProps<P>;
+/** One row of the list: an option, or the disabled placeholder above them. */
+export interface SelectItem {
+    value: SelectValue;
+    label: string;
+    disabled: boolean;
+    /** The placeholder is not an option: it carries no test id and cannot be chosen. */
+    placeholder: boolean;
+    option?: SelectOption;
+}
+/**
+ * The list MUI renders: the placeholder first when there is one, then the
+ * options, in the order `renderMenuItems` builds them.
+ */
+export declare function selectItems(options: SelectOption[], placeholder?: string): SelectItem[];
+/**
+ * What the display slot shows.
+ *
+ * The LAST match wins, which is MUI's own answer: `SelectInput` walks its
+ * children and overwrites the display for every child whose value matches, so
+ * a list carrying both an empty placeholder and a real empty-valued option
+ * shows the option. Values are compared as strings because the DOM stringifies
+ * them anyway (MUI's `areEqualValues`).
+ */
+export declare function displayLabel(items: SelectItem[], value: SelectValue): string;
+/** The three ids the web puts on the control, spelled exactly as it spells them. */
+export declare function selectTestIds(id: string | undefined): {
+    root: string | undefined;
+    trigger: string;
+    option: (value: SelectValue) => string;
+};
+export {};
+//# sourceMappingURL=Select.helpers.d.ts.map

package/dist/types/components/form/Select/Select.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Select.helpers.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Select/Select.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGhF,KAAK,mBAAmB,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAEtG,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,GAC5D,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAkBvD,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,eAAe,EAAE,OAAO,CAAC,KAAG,mBAAmB,CAAC,CAAC,CAChB,CAAC;AAE/E,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,oFAAoF;IACpF,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAUvF;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAM5E;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG;IACrD,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,MAAM,CAAC;CACxC,CAMA"}

package/dist/types/components/form/Select/Select.metrics.d.ts

@@ -0,0 +1,72 @@
+import type { SelectVariant } from './Select.base';
+import type { InputVariant } from '../Input/Input.base';
+import type { UiTheme } from '../../../tokens/theme';
+import type { SizeValue } from '../../../tokens/vocabulary';
+/**
+ * THE NUMBERS BOTH `Select` RENDERERS DRAW WITH.
+ *
+ * A `Select` on the web IS an `OutlinedInput` with a display slot and an arrow
+ * where the value would be typed, so the box's own numbers — the padding, the
+ * border, the radius, the field edge — are `Input.metrics.ts`'s, read through
+ * {@link inputVariantFor} rather than restated. What is here is what a select
+ * has and a text field does not: the arrow, the option list, and the two
+ * heights MUI's `FormControl` offers.
+ */
+/** Our three variants onto the `Input` variant that draws the same box. */
+export declare const inputVariantFor: (variant: SelectVariant) => InputVariant;
+/**
+ * The house scale as a `FormControl` size.
+ *
+ * Not `muiSize`: that collapses five onto MUI's three, and a FormControl takes
+ * only two — `sm` draws small and EVERY other step, `xs` included, draws
+ * medium. Restated from `Select.tsx`'s `formControlSize` so the native side
+ * reads the same lossy map rather than inventing a kinder one.
+ */
+export declare const selectInputSize: (size: SizeValue | undefined) => "sm" | "md";
+/**
+ * The arrow: MUI's `ArrowDropDown` at `SvgIcon`'s medium size, 7px from the
+ * right edge, turned over while the list is open. The display slot reserves
+ * 32px for it, so the flow-laid glyph takes the difference as a margin.
+ */
+export declare const SELECT_ICON: {
+    readonly size: number;
+    readonly right: 7;
+    readonly displayPaddingRight: 32;
+    readonly openRotateDeg: 180;
+};
+/** What the glyph leaves between itself and the value: 32 - 24 - 7. */
+export declare const SELECT_ICON_GAP: number;
+/** `.MuiSelect-select`'s floor, MUI's `1.4375em` at the 16px body size. */
+export declare const SELECT_DISPLAY_MIN_HEIGHT = 23;
+/**
+ * The option list: MUI's `Menu` over a `MenuList` of `MenuItem`s.
+ *
+ * `selectedAlpha` is `palette.action.selectedOpacity`, which MUI doubles in
+ * dark mode; `disabledOpacity` is `palette.action.disabledOpacity`. Neither is
+ * on `UiTheme`, whose `action` carries colours rather than opacities.
+ */
+export declare const SELECT_MENU: {
+    readonly itemMinHeight: 48;
+    readonly itemPaddingVertical: 6;
+    readonly itemPaddingHorizontal: 16;
+    readonly listPaddingVertical: 8;
+    readonly selectedAlpha: {
+        readonly light: 0.08;
+        readonly dark: 0.16;
+    };
+    readonly disabledOpacity: 0.38;
+    /** MUI's `Menu` paper is `calc(100% - 96px)` tall at most. */
+    readonly maxHeightInset: 96;
+};
+/** MUI's `theme.shadows[8]`, the elevation a `Menu` paper rests at. */
+export declare const MUI_MENU_SHADOW = "0px 5px 5px -3px rgba(0,0,0,0.2),0px 8px 10px 1px rgba(0,0,0,0.14),0px 3px 14px 2px rgba(0,0,0,0.12)";
+/** The wash behind the option the value currently names. */
+export declare const selectedWashAlpha: (theme: UiTheme) => number;
+/**
+ * The box a select draws IS the input's box, so these are the input's tables
+ * under this component's names — the border widths, the glass and gradient
+ * alphas, the halo and the pulse. Restating them here is how the two controls
+ * would come to disagree about what an outlined field looks like.
+ */
+export { INPUT_BORDER as SELECT_BORDER, INPUT_GLASS as SELECT_GLASS, INPUT_GLOW as SELECT_GLOW, INPUT_GRADIENT as SELECT_GRADIENT, INPUT_PULSE as SELECT_PULSE, } from '../Input/Input.metrics';
+//# sourceMappingURL=Select.metrics.d.ts.map

package/dist/types/components/form/Select/Select.metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Select.metrics.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Select/Select.metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;;;;;;;GASG;AAEH,2EAA2E;AAC3E,eAAO,MAAM,eAAe,GAAI,SAAS,aAAa,KAAG,YACX,CAAC;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,SAAS,GAAG,SAAS,KAAG,IAAI,GAAG,IACxC,CAAC;AAE9B;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX,uEAAuE;AACvE,eAAO,MAAM,eAAe,QAC4C,CAAC;AAEzE,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;IAOtB,8DAA8D;;CAEtD,CAAC;AAEX,uEAAuE;AACvE,eAAO,MAAM,eAAe,yGAC4E,CAAC;AAEzG,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,MACuC,CAAC;AAE3F;;;;;GAKG;AACH,OAAO,EACL,YAAY,IAAI,aAAa,EAC7B,WAAW,IAAI,YAAY,EAC3B,UAAU,IAAI,WAAW,EACzB,cAAc,IAAI,eAAe,EACjC,WAAW,IAAI,YAAY,GAC5B,MAAM,wBAAwB,CAAC"}

package/dist/types/components/form/Select/Select.types.d.ts

@@ -1,53 +1,16 @@
-import type { SizeValue } from '../../../tokens/scales';
 import type { SelectProps as MuiSelectProps } from '@mui/material/Select/index.js';
-export type SelectVariant = 'default' | 'glass' | 'gradient';
-export interface SelectOption {
-    value: string | number;
-    label: string;
-    disabled?: boolean;
-}
-export interface SelectProps extends Omit<MuiSelectProps, 'variant' | 'size'> {
-    /**
-     * Visual variant of the select component
-     * @default 'default'
-     */
-    variant?: SelectVariant;
-    /**
-     * Array of options to display in the select
-     */
-    options: SelectOption[];
-    /**
-     * Label for the select field
-     */
-    label?: string;
-    /**
-     * Helper text to display below the select
-     */
-    helperText?: string;
-    /**
-     * Whether the select should take full width
-     * @default true
-     */
-    fullWidth?: boolean;
-    /**
-     * Size of the select component
-     * @default 'medium'
-     */
-    size?: SizeValue;
-    /**
-     * Placeholder text when no option is selected
-     */
-    placeholder?: string;
-    /**
-     * Whether to show a glow effect
-     * @default false
-     */
-    glow?: boolean;
-    /**
-     * Whether to show a pulse animation
-     * @default false
-     */
-    pulse?: boolean;
+import type { SelectBaseProps } from './Select.base';
+export type { SelectBaseProps, SelectOption, SelectValue, SelectVariant } from './Select.base';
+/**
+ * The web `Select`: the shared contract, plus everything MUI's `Select`
+ * accepts that the contract does not already name — `value`, `onChange`,
+ * `MenuProps`, `renderValue`.
+ *
+ * `variant` and `size` are omitted from MUI's half alongside the rest of the
+ * contract: MUI declares both in its own words (`small | medium`), and this
+ * component speaks the house scale.
+ */
+export interface SelectProps extends SelectBaseProps, Omit<MuiSelectProps, 'variant' | 'size' | keyof SelectBaseProps> {
     /**
      * Test ID for testing purposes
      */

package/dist/types/components/form/Select/Select.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Select.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Select/Select.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,IAAI,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEnF,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAID,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3E;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;OAEG;IACH,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"Select.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Select/Select.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,IAAI,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE/F;;;;;;;;GAQG;AACH,MAAM,WAAW,WACf,SAAQ,eAAe,EACrB,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,eAAe,CAAC;IAClE;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/types/components/form/Select/index.d.ts

@@ -1,3 +1,3 @@
 export { Select } from './Select';
-export type { SelectOption, SelectProps, SelectVariant } from './Select.types';
+export type { SelectBaseProps, SelectOption, SelectProps, SelectValue, SelectVariant, } from './Select.types';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/components/form/Select/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Select/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Select/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,gBAAgB,CAAC"}

package/dist/types/components/form/Switch/Switch.base.d.ts

@@ -0,0 +1,111 @@
+import type { ReactNode } from 'react';
+import type { ColorValue, SizeValue } from '../../../tokens/vocabulary';
+/**
+ * THE CONTRACT BOTH RENDERERS HONOUR — and nothing else.
+ *
+ * No MUI and no react-native here: this file is in BOTH declaration outputs,
+ * and a native consumer has no `@mui/material` to resolve a type import
+ * against. See `Button.base.ts`.
+ */
+export type SwitchVariant = 'default' | 'ios' | 'android' | 'label' | 'material';
+export type SwitchLabelPosition = 'start' | 'end' | 'top' | 'bottom';
+/**
+ * The contract both renderers honour.
+ *
+ * `checked`, `defaultChecked` and `onChange` are NOT here: MUI types the
+ * change as a DOM `ChangeEvent` and the native side synthesises the
+ * `{ target: { checked } }` shape those handlers already read.
+ */
+export interface SwitchBaseProps {
+    /**
+     * The variant of the switch
+     */
+    variant?: SwitchVariant;
+    /**
+     * The color theme of the switch
+     */
+    color?: ColorValue;
+    /**
+     * The size of the switch
+     */
+    size?: SizeValue;
+    /**
+     * Label text for the switch
+     */
+    label?: string;
+    /**
+     * Description text below the label
+     */
+    description?: string;
+    /**
+     * Whether the switch should have a glow effect
+     */
+    glow?: boolean;
+    /**
+     * Whether the switch should have glass morphism effect
+     */
+    glass?: boolean;
+    /**
+     * Whether the switch should have gradient effects
+     */
+    gradient?: boolean;
+    /**
+     * Position of the label relative to the switch
+     */
+    labelPosition?: SwitchLabelPosition;
+    /**
+     * Icon to show when switch is on
+     */
+    onIcon?: ReactNode;
+    /**
+     * Icon to show when switch is off
+     */
+    offIcon?: ReactNode;
+    /**
+     * Text to show when switch is on
+     */
+    onText?: string;
+    /**
+     * Text to show when switch is off
+     */
+    offText?: string;
+    /**
+     * Whether the switch has an error state
+     */
+    error?: boolean;
+    /**
+     * Help text to display
+     */
+    helperText?: string;
+    /**
+     * Custom width for the switch track
+     */
+    trackWidth?: number;
+    /**
+     * Custom height for the switch track
+     */
+    trackHeight?: number;
+    /**
+     * Whether to enable animations
+     */
+    animated?: boolean;
+    /**
+     * Whether the switch is in loading state
+     */
+    loading?: boolean;
+    /**
+     * Whether to show ripple effect
+     */
+    ripple?: boolean;
+    /**
+     * Whether the switch should have pulse animation
+     */
+    pulse?: boolean;
+    disabled?: boolean;
+    testID?: string;
+    /**
+     * Custom test ID for testing
+     */
+    dataTestId?: string;
+}
+//# sourceMappingURL=Switch.base.d.ts.map

package/dist/types/components/form/Switch/Switch.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Switch.base.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AACjF,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/components/form/Switch/Switch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Switch.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.tsx"],"names":[],"mappings":"AACA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAU1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAmBlD,eAAO,MAAM,MAAM,oGAkEjB,CAAC"}
+{"version":3,"file":"Switch.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.tsx"],"names":[],"mappings":"AACA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAW1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAmBlD,eAAO,MAAM,MAAM,oGAmEjB,CAAC"}

package/dist/types/components/form/Switch/Switch.helpers.d.ts

@@ -0,0 +1,17 @@
+import type { SwitchBaseProps } from './Switch.base';
+type SwitchDefaultedKeys = 'variant' | 'color' | 'size' | 'glow' | 'glass' | 'gradient' | 'labelPosition' | 'error' | 'animated' | 'loading' | 'ripple' | 'pulse' | 'disabled';
+export type ResolvedSwitchProps<P extends SwitchBaseProps = SwitchBaseProps> = P & Required<Pick<SwitchBaseProps, SwitchDefaultedKeys>>;
+export declare const resolveSwitchProps: <P extends SwitchBaseProps>(props: P) => ResolvedSwitchProps<P>;
+/**
+ * Every prop the switch consumes itself.
+ *
+ * Listed so what is left over — `aria-label`, `aria-describedby`, an `id` — can
+ * be spread onto the control without the component's own props riding along.
+ * react-native-web would drop them and React Native ignore them, but a prop
+ * that reaches an element it means nothing to is a prop nobody can explain.
+ */
+export declare const SWITCH_BASE_KEYS: readonly ["variant", "color", "size", "label", "description", "glow", "glass", "gradient", "labelPosition", "onIcon", "offIcon", "onText", "offText", "error", "helperText", "trackWidth", "trackHeight", "animated", "loading", "ripple", "pulse", "disabled", "testID", "dataTestId", "data-testid"];
+/** `props` without any of them, for spreading onto the control. */
+export declare function withoutSwitchProps(props: object): Record<string, unknown>;
+export {};
+//# sourceMappingURL=Switch.helpers.d.ts.map

package/dist/types/components/form/Switch/Switch.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Switch.helpers.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Switch/Switch.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,KAAK,mBAAmB,GACpB,SAAS,GACT,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,GACP,UAAU,GACV,eAAe,GACf,OAAO,GACP,UAAU,GACV,SAAS,GACT,QAAQ,GACR,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI,CAAC,GAC9E,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAmBvD,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,eAAe,EAAE,OAAO,CAAC,KAAG,mBAAmB,CAAC,CAAC,CAChB,CAAC;AAE/E;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,wSAK4C,CAAC;AAE1E,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzE"}