@equinor/stratus-ui 1.1.0 → 1.3.1

package/dist/types/components/Radio/RadioGroup.d.ts

@@ -0,0 +1,35 @@
+import { type ChangeEvent, type HTMLAttributes, type ReactNode } from "react";
+import { type CSSProps } from "../../utils/cssProps";
+import { type RadioStyle } from "./Radio";
+export type RadioGroupProps = Omit<HTMLAttributes<HTMLDivElement>, "onChange" | "style"> & {
+    children?: ReactNode;
+    className?: string;
+    style?: RadioStyle;
+    name?: string;
+    value?: number | string;
+    defaultValue?: number | string;
+    direction?: "horizontal" | "vertical";
+    disabled?: boolean;
+    onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
+} & Omit<CSSProps, "direction">;
+/**
+ * @example
+ * ```tsx
+ * <RadioGroup name="color" defaultValue="red" onChange={(e) => console.log(e.target.value)}>
+ *   <Radio value="red" label="Red" />
+ *   <Radio value="blue" label="Blue" />
+ * </RadioGroup>
+ * ```
+ */
+export declare const RadioGroup: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "style" | "onChange"> & {
+    children?: ReactNode;
+    className?: string;
+    style?: RadioStyle;
+    name?: string;
+    value?: number | string;
+    defaultValue?: number | string;
+    direction?: "horizontal" | "vertical";
+    disabled?: boolean;
+    onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
+} & Omit<CSSProps, "direction"> & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=RadioGroup.d.ts.map

package/dist/types/components/Radio/RadioGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RadioGroup.d.ts","sourceRoot":"","sources":["../../../../src/components/Radio/RadioGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIH,KAAK,WAAW,EAChB,KAAK,cAAc,EAEnB,KAAK,SAAS,EACjB,MAAM,OAAO,CAAC;AAEf,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAIlE,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,cAAc,CAAC,cAAc,CAAC,EAC9B,UAAU,GAAG,OAAO,CACrB,GAAG;IACF,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;CAC3D,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAIhC;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU;eAtBV,SAAS;gBACR,MAAM;YACV,UAAU;WACX,MAAM;YACL,MAAM,GAAG,MAAM;mBACR,MAAM,GAAG,MAAM;gBAClB,YAAY,GAAG,UAAU;eAC1B,OAAO;eACP,CAAC,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI;gFAqE1D,CAAC"}

package/dist/types/components/Ripple/Ripple.d.ts

@@ -0,0 +1,31 @@
+import * as React from "react";
+import "./Ripple.css";
+type RippleProps = {
+    /** Add a global hook class for consumers. Default: `stratus-button__ripples` */
+    className?: string;
+    /** Disable ripple entirely */
+    disabled?: boolean;
+};
+export type RippleHandle = {
+    /** Programmatically trigger a ripple at viewport coordinates */
+    triggerAt(clientX: number, clientY: number): void;
+    triggerCenter(): void;
+};
+/**
+ * Reusable ripple overlay.
+ *
+ * - Uses CSS variables for color/opacity (token-driven)
+ * - Creates a span per interaction and removes it after animation
+ *
+ * Rendering: place inside a `position: relative; overflow: hidden` host.
+ *
+ * @example
+ * ```tsx
+ * <div style={{ position: "relative", overflow: "hidden" }}>
+ *   <Ripple />
+ * </div>
+ * ```
+ */
+export declare const Ripple: React.ForwardRefExoticComponent<RippleProps & React.RefAttributes<RippleHandle>>;
+export {};
+//# sourceMappingURL=Ripple.d.ts.map

package/dist/types/components/Ripple/Ripple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ripple.d.ts","sourceRoot":"","sources":["../../../../src/components/Ripple/Ripple.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,cAAc,CAAC;AAEtB,KAAK,WAAW,GAAG;IACjB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,gEAAgE;IAChE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,aAAa,IAAI,IAAI,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,MAAM,kFA6DlB,CAAC"}

package/dist/types/components/ScreenLoader/ScreenLoader.d.ts

@@ -0,0 +1,36 @@
+import { type ElementType, type ReactNode } from "react";
+import { type CSSProps } from "../../utils/cssProps";
+import type { CSSVars } from "../../utils/cssVars";
+import type { PolymorphicProps } from "../../utils/polymorphic";
+import "./ScreenLoader.css";
+type ScreenLoaderVars = "--stratus-screen-loader-backdrop" | "--stratus-screen-loader-color" | "--stratus-screen-loader-size" | "--stratus-screen-loader-star-color" | "--stratus-screen-loader-z";
+type ScreenLoaderStyle = CSSVars<ScreenLoaderVars>;
+type ScreenLoaderOwnProps = {
+    /** Extra CSS class name applied to the backdrop root. */
+    className?: string;
+    /** Inline style + CSS variable overrides applied to the backdrop root. */
+    style?: ScreenLoaderStyle;
+    /** Custom loader. Defaults to the built-in star progress loader. */
+    loader?: ReactNode;
+    /** Size in pixels for the built-in star progress loader. */
+    sizeLoader?: number;
+    /** Text shown below the loader. */
+    title?: ReactNode;
+    /** Make the backdrop transparent while keeping the loader visible. */
+    backdropInvisible?: boolean;
+    /** Portal container. Defaults to document.body. */
+    container?: HTMLElement;
+    /** Render inline instead of using a portal. */
+    disablePortal?: boolean;
+    /** z-index override for the backdrop. */
+    zIndex?: number | string;
+    /** Additional content below the loader and title. */
+    children?: ReactNode;
+} & CSSProps;
+export type ScreenLoaderProps<T extends ElementType = "div"> = PolymorphicProps<T, ScreenLoaderOwnProps>;
+/**
+ * Renders a full-screen loading backdrop with an optional title and custom loader.
+ */
+export declare const ScreenLoader: import("../../utils/polymorphic").PolymorphicComponent<ScreenLoaderOwnProps, "div">;
+export {};
+//# sourceMappingURL=ScreenLoader.d.ts.map

package/dist/types/components/ScreenLoader/ScreenLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenLoader.d.ts","sourceRoot":"","sources":["../../../../src/components/ScreenLoader/ScreenLoader.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIzD,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,yBAAyB,CAAC;AAIhF,OAAO,oBAAoB,CAAC;AAE5B,KAAK,gBAAgB,GACjB,kCAAkC,GAClC,+BAA+B,GAC/B,8BAA8B,GAC9B,oCAAoC,GACpC,2BAA2B,CAAC;AAEhC,KAAK,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEnD,KAAK,oBAAoB,GAAG;IAC1B,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,oEAAoE;IACpE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mDAAmD;IACnD,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GAAG,QAAQ,CAAC;AAEb,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,WAAW,GAAG,KAAK,IAAI,gBAAgB,CAC7E,CAAC,EACD,oBAAoB,CACrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,qFAsExB,CAAC"}

package/dist/types/components/ScreenLoader/StarProgress.d.ts

@@ -0,0 +1,10 @@
+interface StarProgressProps {
+    /** Size in pixels for the star progress loader. */
+    size?: number;
+}
+/**
+ * Renders the built-in animated star progress indicator for ScreenLoader.
+ */
+export declare function StarProgress({ size }: StarProgressProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=StarProgress.d.ts.map

package/dist/types/components/ScreenLoader/StarProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StarProgress.d.ts","sourceRoot":"","sources":["../../../../src/components/ScreenLoader/StarProgress.tsx"],"names":[],"mappings":"AAEA,UAAU,iBAAiB;IACzB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,IAAS,EAAE,EAAE,iBAAiB,+BA+B5D"}

package/dist/types/components/Search/Search.d.ts

@@ -0,0 +1,20 @@
+import { type SelectProps } from "../Select/Select";
+import "./Search.css";
+export interface SearchProps extends Omit<SelectProps, "type"> {
+    /**
+     * If `true`, the input text is cleared when the user starts typing.
+     * @default false
+     */
+    emptyOnStartTyping?: boolean;
+}
+/**
+ * @example
+ * ```tsx
+ * <Search placeholder="Search..." onSelect={(val) => console.log(val)}>
+ *   <Search.Option value="one">Option 1</Search.Option>
+ *   <Search.Option value="two">Option 2</Search.Option>
+ * </Search>
+ * ```
+ */
+export declare const Search: import("react").ForwardRefExoticComponent<SearchProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=Search.d.ts.map

package/dist/types/components/Search/Search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Search.d.ts","sourceRoot":"","sources":["../../../../src/components/Search/Search.tsx"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,cAAc,CAAC;AAMtB,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;IAC5D;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAcD;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,wGAyElB,CAAC"}

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

@@ -0,0 +1,417 @@
+import { type ReactElement, type ReactNode, type RefObject, type SyntheticEvent } from "react";
+import { type CSSProps } from "../../utils/cssProps";
+import type { CSSVars } from "../../utils/cssVars";
+import "./Select.css";
+type SelectVars = "--stratus-divider" | "--stratus-error" | "--stratus-hover" | "--stratus-input-bg" | "--stratus-input-border" | "--stratus-primary" | "--stratus-primary-light" | "--stratus-selected" | "--stratus-success" | "--stratus-surface" | "--stratus-text-disabled" | "--stratus-text-primary" | "--stratus-text-secondary" | "--stratus-warning";
+type SelectStyle = CSSVars<SelectVars>;
+export type SelectValueType = string | number | string[] | number[];
+export interface SelectNodeProps {
+    label: string;
+    value?: string | number;
+    disabled?: boolean;
+}
+export interface SelectOptionProps extends SelectNodeProps {
+    type?: "option" | "optgroup";
+    options?: SelectOptionProps[];
+}
+export interface SelectedOptionsEvent {
+    selectedValue?: SelectValueType;
+    deselectedValue?: SelectValueType;
+    options: SelectOptionProps[];
+}
+export interface SelectHTMLElement {
+    /** Open the select dropdown. */
+    open: () => void;
+    /** Close the select dropdown. */
+    close: () => void;
+}
+export type InputVariant = "default" | "success" | "warning" | "error" | "naked";
+export type SelectProps = {
+    /** Render options as children (alternative to `options` prop). */
+    children?: ReactNode;
+    /** Extra CSS class name. */
+    className?: string;
+    /** Inline style overrides. */
+    style?: SelectStyle;
+    /**
+     * Imperative ref with `open()` / `close()` methods.
+     * @default undefined
+     */
+    selectRef?: RefObject<SelectHTMLElement | null>;
+    /**
+     * Ref forwarded to the native `<input>` inside the trigger.
+     * @default undefined
+     */
+    inputRef?: RefObject<HTMLInputElement | null>;
+    /**
+     * Array of select options (alternative to `children`).
+     * @default undefined
+     */
+    options?: SelectOptionProps[];
+    /**
+     * Controlled value (single or multi).
+     * @default undefined
+     */
+    value?: SelectValueType;
+    /**
+     * Default (uncontrolled) value (single or multi).
+     * @default undefined
+     */
+    defaultValue?: SelectValueType;
+    /**
+     * Controlled text in the search/input field.
+     * @default undefined
+     */
+    inputValue?: string;
+    /**
+     * Visual variant.
+     * @default "default"
+     */
+    variant?: InputVariant;
+    /**
+     * Label placed above the select (top-left).
+     * @default undefined
+     */
+    label?: ReactNode;
+    /**
+     * Meta text above the select (top-right).
+     * @default undefined
+     */
+    meta?: ReactNode;
+    /**
+     * Placeholder text.
+     * @default undefined
+     */
+    placeholder?: string;
+    /**
+     * Helper text placed below the select.
+     * @default undefined
+     */
+    helperText?: ReactNode;
+    /**
+     * Icon placed before the helper text.
+     * @default undefined
+     */
+    helperIcon?: ReactNode;
+    /**
+     * Content at the start of the input wrapper (e.g. icon).
+     * @default undefined
+     */
+    startAdornment?: ReactElement;
+    /**
+     * Content at the end of the input wrapper (before chevron).
+     * @default undefined
+     */
+    endAdornment?: ReactElement;
+    /**
+     * Show a clear button when a value is selected.
+     * @default true
+     */
+    allowClear?: boolean;
+    /**
+     * Enable multi-option selection.
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * Enable collapsible opt-groups.
+     * @default false
+     */
+    expandable?: boolean;
+    /**
+     * Show selected options inside or below the select (only with `multiple`).
+     * @default true
+     */
+    infield?: boolean;
+    /**
+     * Show selected options as tags/chips (only with `multiple`).
+     * @default false
+     */
+    tags?: boolean;
+    /**
+     * Max tags to show before showing a count placeholder.
+     * @default undefined
+     */
+    tagMaxCount?: number;
+    /**
+     * Text shown when selected options exceed `tagMaxCount`.
+     * @default undefined
+     */
+    tagMaxCountPlaceholder?: string | ((numberOfSelectedOptions: number) => string);
+    /**
+     * Label used when `multiple` is enabled and `tags` is false.
+     * @default "Selected"
+     */
+    selectedLabel?: ReactNode | ((numberOfSelectedOptions: number, total: number) => string);
+    /**
+     * Enable input-based filtering of options.
+     * Can be a boolean or custom filter function.
+     * @default false
+     */
+    filterOption?: boolean | ((node: SelectNodeProps, inputValue: string, menuSelectedIds: string[]) => boolean);
+    /**
+     * Text shown when no options match.
+     * @default "No Data"
+     */
+    noOptionsText?: ReactNode;
+    /**
+     * Hide the dropdown entirely when there are no visible options,
+     * instead of showing the `noOptionsText` message.
+     * @default false
+     */
+    hideDropdownWhenEmpty?: boolean;
+    /**
+     * Keep showing the typed input text when the dropdown is closed,
+     * instead of falling back to the selected option's label.
+     * Useful for search-like inputs.
+     * @default false
+     */
+    persistInputText?: boolean;
+    /**
+     * Compact size (24 px).
+     * @default false
+     */
+    compact?: boolean;
+    /**
+     * Full width.
+     * @default false
+     */
+    fullWidth?: boolean;
+    /**
+     * Disable the select.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Callback when an option is selected.
+     * @default undefined
+     */
+    onSelect?: (selectedOptions: SelectedOptionsEvent, event?: SyntheticEvent) => void;
+    /**
+     * Callback when an option is deselected.
+     * @default undefined
+     */
+    onDeselect?: (selectedOptions: SelectedOptionsEvent, event?: SyntheticEvent) => void;
+    /**
+     * Callback when the clear button is clicked.
+     * @default undefined
+     */
+    onClear?: (event: SyntheticEvent) => void;
+    /**
+     * Callback when input text changes (for custom filtering).
+     * @default undefined
+     */
+    onChange?: (value: string) => void;
+    /**
+     * Custom renderer for option‐group headers.
+     * @default undefined
+     */
+    itemGroupRenderer?: (node: SelectNodeProps, items: ReactNode[], inputValue: string) => ReactNode;
+    /**
+     * Custom renderer for option items.
+     * @default undefined
+     */
+    itemRenderer?: (node: SelectNodeProps, inputValue: string, menuSelectedIds: string[]) => ReactNode;
+} & CSSProps;
+/**
+ * @example
+ * ```tsx
+ * <Select
+ *   options={[
+ *     { label: "Apple", value: "apple" },
+ *     { label: "Banana", value: "banana" },
+ *   ]}
+ *   placeholder="Pick a fruit"
+ *   onChange={(value) => console.log(value)}
+ * />
+ * ```
+ */
+export declare const Select: import("react").ForwardRefExoticComponent<{
+    /** Render options as children (alternative to `options` prop). */
+    children?: ReactNode;
+    /** Extra CSS class name. */
+    className?: string;
+    /** Inline style overrides. */
+    style?: SelectStyle;
+    /**
+     * Imperative ref with `open()` / `close()` methods.
+     * @default undefined
+     */
+    selectRef?: RefObject<SelectHTMLElement | null>;
+    /**
+     * Ref forwarded to the native `<input>` inside the trigger.
+     * @default undefined
+     */
+    inputRef?: RefObject<HTMLInputElement | null>;
+    /**
+     * Array of select options (alternative to `children`).
+     * @default undefined
+     */
+    options?: SelectOptionProps[];
+    /**
+     * Controlled value (single or multi).
+     * @default undefined
+     */
+    value?: SelectValueType;
+    /**
+     * Default (uncontrolled) value (single or multi).
+     * @default undefined
+     */
+    defaultValue?: SelectValueType;
+    /**
+     * Controlled text in the search/input field.
+     * @default undefined
+     */
+    inputValue?: string;
+    /**
+     * Visual variant.
+     * @default "default"
+     */
+    variant?: InputVariant;
+    /**
+     * Label placed above the select (top-left).
+     * @default undefined
+     */
+    label?: ReactNode;
+    /**
+     * Meta text above the select (top-right).
+     * @default undefined
+     */
+    meta?: ReactNode;
+    /**
+     * Placeholder text.
+     * @default undefined
+     */
+    placeholder?: string;
+    /**
+     * Helper text placed below the select.
+     * @default undefined
+     */
+    helperText?: ReactNode;
+    /**
+     * Icon placed before the helper text.
+     * @default undefined
+     */
+    helperIcon?: ReactNode;
+    /**
+     * Content at the start of the input wrapper (e.g. icon).
+     * @default undefined
+     */
+    startAdornment?: ReactElement;
+    /**
+     * Content at the end of the input wrapper (before chevron).
+     * @default undefined
+     */
+    endAdornment?: ReactElement;
+    /**
+     * Show a clear button when a value is selected.
+     * @default true
+     */
+    allowClear?: boolean;
+    /**
+     * Enable multi-option selection.
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * Enable collapsible opt-groups.
+     * @default false
+     */
+    expandable?: boolean;
+    /**
+     * Show selected options inside or below the select (only with `multiple`).
+     * @default true
+     */
+    infield?: boolean;
+    /**
+     * Show selected options as tags/chips (only with `multiple`).
+     * @default false
+     */
+    tags?: boolean;
+    /**
+     * Max tags to show before showing a count placeholder.
+     * @default undefined
+     */
+    tagMaxCount?: number;
+    /**
+     * Text shown when selected options exceed `tagMaxCount`.
+     * @default undefined
+     */
+    tagMaxCountPlaceholder?: string | ((numberOfSelectedOptions: number) => string);
+    /**
+     * Label used when `multiple` is enabled and `tags` is false.
+     * @default "Selected"
+     */
+    selectedLabel?: ReactNode | ((numberOfSelectedOptions: number, total: number) => string);
+    /**
+     * Enable input-based filtering of options.
+     * Can be a boolean or custom filter function.
+     * @default false
+     */
+    filterOption?: boolean | ((node: SelectNodeProps, inputValue: string, menuSelectedIds: string[]) => boolean);
+    /**
+     * Text shown when no options match.
+     * @default "No Data"
+     */
+    noOptionsText?: ReactNode;
+    /**
+     * Hide the dropdown entirely when there are no visible options,
+     * instead of showing the `noOptionsText` message.
+     * @default false
+     */
+    hideDropdownWhenEmpty?: boolean;
+    /**
+     * Keep showing the typed input text when the dropdown is closed,
+     * instead of falling back to the selected option's label.
+     * Useful for search-like inputs.
+     * @default false
+     */
+    persistInputText?: boolean;
+    /**
+     * Compact size (24 px).
+     * @default false
+     */
+    compact?: boolean;
+    /**
+     * Full width.
+     * @default false
+     */
+    fullWidth?: boolean;
+    /**
+     * Disable the select.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Callback when an option is selected.
+     * @default undefined
+     */
+    onSelect?: (selectedOptions: SelectedOptionsEvent, event?: SyntheticEvent) => void;
+    /**
+     * Callback when an option is deselected.
+     * @default undefined
+     */
+    onDeselect?: (selectedOptions: SelectedOptionsEvent, event?: SyntheticEvent) => void;
+    /**
+     * Callback when the clear button is clicked.
+     * @default undefined
+     */
+    onClear?: (event: SyntheticEvent) => void;
+    /**
+     * Callback when input text changes (for custom filtering).
+     * @default undefined
+     */
+    onChange?: (value: string) => void;
+    /**
+     * Custom renderer for option‐group headers.
+     * @default undefined
+     */
+    itemGroupRenderer?: (node: SelectNodeProps, items: ReactNode[], inputValue: string) => ReactNode;
+    /**
+     * Custom renderer for option items.
+     * @default undefined
+     */
+    itemRenderer?: (node: SelectNodeProps, inputValue: string, menuSelectedIds: string[]) => ReactNode;
+} & Partial<import("react").CSSProperties> & import("../../utils/cssProps").CSSShorthandProps & import("react").RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=Select.d.ts.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * Trigger chevron for `Select`. Includes the
+ * `<span class="stratus-select__chevron">` wrapper used at the right
+ * edge of the trigger. For optgroup-expand chevrons (which need their
+ * own wrapper with a collapsed modifier) the bare svg is inlined
+ * directly in `Select.tsx`.
+ */
+export declare function SelectChevron(): import("react").JSX.Element;
+//# sourceMappingURL=SelectChevron.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SelectChevron.d.ts","sourceRoot":"","sources":["../../../../src/components/Select/SelectChevron.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,aAAa,gCAc5B"}

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

@@ -0,0 +1,12 @@
+import type { SyntheticEvent } from "react";
+interface SelectClearButtonProps {
+    onClear: (event: SyntheticEvent) => void;
+}
+/**
+ * Renders the clear (✕) button that resets the `Select` value. Visibility
+ * is decided by the parent — this component renders unconditionally and
+ * stops click propagation via the supplied `onClear` handler.
+ */
+export declare function SelectClearButton({ onClear }: SelectClearButtonProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=SelectClearButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SelectClearButton.d.ts","sourceRoot":"","sources":["../../../../src/components/Select/SelectClearButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,UAAU,sBAAsB;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,sBAAsB,+BAWpE"}

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

@@ -0,0 +1,13 @@
+import type { ReactNode } from "react";
+interface SelectHelperProps {
+    helperText?: ReactNode;
+    helperIcon?: ReactNode;
+}
+/**
+ * Renders the helper-text row below the `Select`. Returns `null` when
+ * `helperText` is empty so the row collapses entirely. The optional
+ * `helperIcon` is shown before the text.
+ */
+export declare function SelectHelper({ helperText, helperIcon }: SelectHelperProps): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=SelectHelper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SelectHelper.d.ts","sourceRoot":"","sources":["../../../../src/components/Select/SelectHelper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,UAAU,iBAAiB;IACzB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,iBAAiB,sCAUzE"}

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

@@ -0,0 +1,14 @@
+import type { ReactNode } from "react";
+interface SelectLabelRowProps {
+    label?: ReactNode;
+    meta?: ReactNode;
+    htmlFor: string;
+}
+/**
+ * Renders the optional label/meta row above the `Select` trigger.
+ * Returns `null` when neither `label` nor `meta` is provided so the
+ * row collapses entirely.
+ */
+export declare function SelectLabelRow({ label, meta, htmlFor }: SelectLabelRowProps): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=SelectLabelRow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SelectLabelRow.d.ts","sourceRoot":"","sources":["../../../../src/components/Select/SelectLabelRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,UAAU,mBAAmB;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,mBAAmB,sCAY3E"}