@dinofront/design_system 1.3.0 → 1.4.0

package/dist/components/SelectV2/SelectV2.d.ts

@@ -0,0 +1,6 @@
+import { ForwardRefExoticComponent, RefAttributes } from 'react';
+import { GroupBase, SelectInstance } from 'react-select';
+import { SelectV2Option, SelectV2Props } from './SelectV2.types';
+type Instance = SelectInstance<SelectV2Option, boolean, GroupBase<SelectV2Option>>;
+export declare const SelectV2: ForwardRefExoticComponent<SelectV2Props & RefAttributes<Instance>>;
+export {};

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

@@ -0,0 +1,73 @@
+import { ReactNode } from 'react';
+import { BaseProps, OptionValue } from '../../types';
+export type SelectV2Size = 'sm' | 'md' | 'lg';
+export interface SelectV2Option {
+    value: OptionValue;
+    label: ReactNode;
+    /** Optional second line under the label in the dropdown. */
+    description?: string;
+    /** Text used for search matching and `aria`/typeahead purposes when `label` isn't a plain string. */
+    searchText?: string;
+    disabled?: boolean;
+    /** Group heading this option belongs under. */
+    group?: string;
+}
+export interface SelectV2BaseProps extends BaseProps {
+    /** Static option list, matching `Select`'s required `options` prop. Pass
+     *  `[]` when `loadOptions` drives the list instead. */
+    options: SelectV2Option[];
+    /** Fetch options as the user types. Providing this switches SelectV2 into
+     *  react-select's async variant (debounced internally by react-select). */
+    loadOptions?: (inputValue: string) => Promise<SelectV2Option[]>;
+    /** Options shown before the user types anything, when `loadOptions` is set.
+     *  `true` triggers an initial `loadOptions('')` call on mount. */
+    defaultOptions?: SelectV2Option[] | true;
+    /** Lets the user type a value that isn't in the list and add it as a new
+     *  option. Requires `onCreateOption`. */
+    creatable?: boolean;
+    /** Called with the raw typed text when the user commits a new option via
+     *  `creatable`. SelectV2 adds the new option and selects it itself — this
+     *  callback is for side effects (e.g. persisting the new option upstream). */
+    onCreateOption?: (inputValue: string) => void;
+    /** Label for the "create" row, e.g. `(v) => `Add "${v}"``. Defaults to
+     *  react-select's own `Create "..."` wording. */
+    formatCreateLabel?: (inputValue: string) => ReactNode;
+    placeholder?: string;
+    label?: ReactNode;
+    /** Content rendered on the label row, right of the label text — e.g. an info tooltip trigger. */
+    labelAddons?: ReactNode;
+    helperText?: ReactNode;
+    errorText?: ReactNode;
+    error?: boolean;
+    size?: SelectV2Size;
+    disabled?: boolean;
+    /** Renders a red asterisk next to the label. */
+    required?: boolean;
+    /** Shows a spinner in the indicator and blocks interaction. Independent of
+     *  the automatic per-fetch loading state `loadOptions` already drives. */
+    loading?: boolean;
+    /** Shows a clear ("x") indicator once a value is selected. Default `false`. */
+    clearable?: boolean;
+    /** Type-to-filter the option list. Default `true` (react-select is a combobox by nature). */
+    searchable?: boolean;
+    /** Virtualizes the menu list with `@tanstack/react-virtual`, for option
+     *  lists in the thousands. Assumes uniform, single-line option rows — off
+     *  by default, and not recommended together with `group`ed options. */
+    virtualized?: boolean;
+    /** Shown when the list is empty (no matches, or nothing loaded yet). Defaults to `'No results'`. */
+    emptyText?: string;
+    id?: string;
+    className?: string;
+    wrapperClassName?: string;
+}
+export type SelectV2Props = (SelectV2BaseProps & {
+    isMulti?: false;
+    value?: OptionValue;
+    defaultValue?: OptionValue;
+    onChange?: (value: OptionValue | undefined) => void;
+}) | (SelectV2BaseProps & {
+    isMulti: true;
+    value?: OptionValue[];
+    defaultValue?: OptionValue[];
+    onChange?: (values: OptionValue[]) => void;
+});

package/dist/components/SelectV2/index.d.ts

@@ -0,0 +1,2 @@
+export { SelectV2 } from './SelectV2';
+export type { SelectV2Props, SelectV2Option, SelectV2Size } from './SelectV2.types';

package/dist/index.d.ts

@@ -33,6 +33,7 @@ export * from './components/Progress';
 export * from './components/Radio';
 export * from './components/ReadMore';
 export * from './components/Select';
+export * from './components/SelectV2';
 export * from './components/Sidebar';
 export * from './components/Skeleton';
 export * from './components/Snackbar';