@rovula/ui 0.1.41 → 0.1.43

package/dist/cjs/types/components/AutoComplete/AutoComplete.d.ts

@@ -0,0 +1,76 @@
+import React, { ReactNode } from "react";
+import { type InputProps } from "../TextInput/TextInput";
+export type AutoCompleteOption = {
+    value: string;
+    label: string;
+};
+/**
+ * InputProps that AutoComplete manages internally.
+ * These are excluded from the public API so callers cannot accidentally
+ * override internal event wiring or ARIA attributes.
+ */
+type OmittedInputProps = "value" | "onChange" | "onKeyDown" | "onSelect" | "role" | "aria-expanded" | "aria-haspopup" | "aria-autocomplete" | "aria-activedescendant" | "aria-controls" | "autoComplete" | "hasClearIcon";
+export type AutoCompleteProps<T extends AutoCompleteOption = AutoCompleteOption> = {
+    /** Options provided by caller (already filtered/fetched externally) */
+    options: T[];
+    /** Controlled value — the current input text */
+    value?: string;
+    /**
+     * Called on every change: typing or clearing.
+     * Parent should update `value` from this.
+     */
+    onChange?: (value: string) => void;
+    /**
+     * Called only when user explicitly selects an option from the list.
+     * Receives the full option object (including any domain-specific fields).
+     */
+    onSelect?: (option: T) => void;
+    onBlur?: () => void;
+    /** Called with the current query when the user types */
+    onSearch?: (query: string) => void;
+    /** Show a loading spinner inside the dropdown */
+    loading?: boolean;
+    /** Text shown when options is empty and not loading */
+    noOptionsText?: string;
+    /**
+     * When true, show the noOptionsText message when options is empty.
+     * Defaults to false (popover stays closed when no options).
+     */
+    showNoOptions?: boolean;
+    /**
+     * Custom render for each option item.
+     * Receives the option and whether it is currently selected.
+     * The wrapper button (styles + click handler) is provided by AutoComplete.
+     */
+    renderOption?: (option: T, isSelected: boolean) => ReactNode;
+    /**
+     * Override client-side filtering.
+     * Pass `(x) => x` to disable filtering entirely (when results come from an API).
+     * Defaults to identity (no filtering).
+     */
+    filterOptions?: (options: T[]) => T[];
+    /**
+     * Render the options list via a React portal so it escapes containers
+     * with `overflow: hidden/auto`.
+     * Set to false when inside a Dialog — portal content is blocked by
+     * Radix Dialog's focus trap and aria-modal, making items unclickable.
+     * Defaults to true.
+     */
+    portal?: boolean;
+    /** Extra className applied to the options list container */
+    listboxClassName?: string;
+    /** Extra inline styles applied to the options list container */
+    listboxStyle?: React.CSSProperties;
+    /** Extra inline styles applied to the Popover content wrapper (portal mode only) */
+    popoverStyle?: React.CSSProperties;
+    /** Extra className applied to each option item */
+    optionClassName?: string;
+    /** Extra inline styles applied to each option item */
+    optionStyle?: React.CSSProperties;
+    "data-testid"?: string;
+} & Omit<InputProps, OmittedInputProps>;
+declare function AutoCompleteInner<T extends AutoCompleteOption = AutoCompleteOption>({ options, value, onChange, onSelect, onBlur, onSearch, loading, noOptionsText, showNoOptions, renderOption, filterOptions, portal, listboxClassName, listboxStyle, popoverStyle, optionClassName, optionStyle, "data-testid": testId, id, label, fullwidth, size, rounded, variant, disabled, ...rest }: AutoCompleteProps<T>, ref: React.ForwardedRef<HTMLInputElement>): import("react/jsx-runtime").JSX.Element;
+declare const AutoComplete: <T extends AutoCompleteOption = AutoCompleteOption>(props: AutoCompleteProps<T> & {
+    ref?: React.ForwardedRef<HTMLInputElement>;
+}) => ReturnType<typeof AutoCompleteInner>;
+export default AutoComplete;

package/dist/cjs/types/components/AutoComplete/AutoComplete.stories.d.ts

@@ -0,0 +1,362 @@
+import React from "react";
+import type { StoryObj } from "@storybook/react";
+import AutoComplete, { type AutoCompleteOption } from "./AutoComplete";
+declare const meta: {
+    title: string;
+    component: <T extends AutoCompleteOption = AutoCompleteOption>(props: import("./AutoComplete").AutoCompleteProps<T> & {
+        ref?: React.ForwardedRef<HTMLInputElement>;
+    }) => ReturnType<(<T_1 extends AutoCompleteOption = AutoCompleteOption>({ options, value, onChange, onSelect, onBlur, onSearch, loading, noOptionsText, showNoOptions, renderOption, filterOptions, portal, listboxClassName, listboxStyle, popoverStyle, optionClassName, optionStyle, "data-testid": testId, id, label, fullwidth, size, rounded, variant, disabled, ...rest }: import("./AutoComplete").AutoCompleteProps<T_1>, ref: React.ForwardedRef<HTMLInputElement>) => import("react/jsx-runtime").JSX.Element)>;
+    tags: string[];
+    parameters: {
+        layout: string;
+    };
+    decorators: ((Story: import("@storybook/csf").PartialStoryFn<import("@storybook/react").ReactRenderer, {
+        options: AutoCompleteOption[];
+        value?: string | undefined;
+        onChange?: ((value: string) => void) | undefined;
+        onSelect?: ((option: AutoCompleteOption) => void) | undefined;
+        onBlur?: ((() => void) & React.FocusEventHandler<HTMLInputElement>) | undefined;
+        onSearch?: ((query: string) => void) | undefined;
+        loading?: boolean | undefined;
+        noOptionsText?: string | undefined;
+        showNoOptions?: boolean | undefined;
+        renderOption?: ((option: AutoCompleteOption, isSelected: boolean) => React.ReactNode) | undefined;
+        filterOptions?: ((options: AutoCompleteOption[]) => AutoCompleteOption[]) | undefined;
+        portal?: boolean | undefined;
+        listboxClassName?: string | undefined;
+        listboxStyle?: React.CSSProperties | undefined;
+        popoverStyle?: React.CSSProperties | undefined;
+        optionClassName?: string | undefined;
+        optionStyle?: React.CSSProperties | undefined;
+        "data-testid"?: string | undefined;
+        variant?: "flat" | "outline" | "underline" | undefined;
+        suppressHydrationWarning?: boolean | undefined | undefined;
+        className?: string | undefined;
+        color?: string | undefined | undefined;
+        height?: number | string | undefined | undefined;
+        id?: string | undefined;
+        lang?: string | undefined | undefined;
+        max?: number | string | undefined | undefined;
+        min?: number | string | undefined | undefined;
+        name?: string | undefined | undefined;
+        style?: React.CSSProperties | undefined;
+        type?: React.HTMLInputTypeAttribute | undefined;
+        width?: number | string | undefined | undefined;
+        tabIndex?: number | undefined | undefined;
+        format?: ((value: string) => string) | undefined;
+        "aria-atomic"?: (boolean | "true" | "false") | undefined;
+        "aria-braillelabel"?: string | undefined | undefined;
+        "aria-brailleroledescription"?: string | undefined | undefined;
+        "aria-busy"?: (boolean | "true" | "false") | undefined;
+        "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+        "aria-colcount"?: number | undefined | undefined;
+        "aria-colindex"?: number | undefined | undefined;
+        "aria-colindextext"?: string | undefined | undefined;
+        "aria-colspan"?: number | undefined | undefined;
+        "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
+        "aria-describedby"?: string | undefined | undefined;
+        "aria-description"?: string | undefined | undefined;
+        "aria-details"?: string | undefined | undefined;
+        "aria-disabled"?: (boolean | "true" | "false") | undefined;
+        "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined | undefined;
+        "aria-errormessage"?: string | undefined | undefined;
+        "aria-flowto"?: string | undefined | undefined;
+        "aria-grabbed"?: (boolean | "true" | "false") | undefined;
+        "aria-hidden"?: (boolean | "true" | "false") | undefined;
+        "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined | undefined;
+        "aria-keyshortcuts"?: string | undefined | undefined;
+        "aria-label"?: string | undefined | undefined;
+        "aria-labelledby"?: string | undefined | undefined;
+        "aria-level"?: number | undefined | undefined;
+        "aria-live"?: "off" | "assertive" | "polite" | undefined | undefined;
+        "aria-modal"?: (boolean | "true" | "false") | undefined;
+        "aria-multiline"?: (boolean | "true" | "false") | undefined;
+        "aria-multiselectable"?: (boolean | "true" | "false") | undefined;
+        "aria-orientation"?: "horizontal" | "vertical" | undefined | undefined;
+        "aria-owns"?: string | undefined | undefined;
+        "aria-placeholder"?: string | undefined | undefined;
+        "aria-posinset"?: number | undefined | undefined;
+        "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+        "aria-readonly"?: (boolean | "true" | "false") | undefined;
+        "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined | undefined;
+        "aria-required"?: (boolean | "true" | "false") | undefined;
+        "aria-roledescription"?: string | undefined | undefined;
+        "aria-rowcount"?: number | undefined | undefined;
+        "aria-rowindex"?: number | undefined | undefined;
+        "aria-rowindextext"?: string | undefined | undefined;
+        "aria-rowspan"?: number | undefined | undefined;
+        "aria-selected"?: (boolean | "true" | "false") | undefined;
+        "aria-setsize"?: number | undefined | undefined;
+        "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined | undefined;
+        "aria-valuemax"?: number | undefined | undefined;
+        "aria-valuemin"?: number | undefined | undefined;
+        "aria-valuenow"?: number | undefined | undefined;
+        "aria-valuetext"?: string | undefined | undefined;
+        children?: React.ReactNode;
+        dangerouslySetInnerHTML?: {
+            __html: string | TrustedHTML;
+        } | undefined | undefined;
+        onCopy?: React.ClipboardEventHandler<HTMLInputElement> | undefined;
+        onCopyCapture?: React.ClipboardEventHandler<HTMLInputElement> | undefined;
+        onCut?: React.ClipboardEventHandler<HTMLInputElement> | undefined;
+        onCutCapture?: React.ClipboardEventHandler<HTMLInputElement> | undefined;
+        onPaste?: React.ClipboardEventHandler<HTMLInputElement> | undefined;
+        onPasteCapture?: React.ClipboardEventHandler<HTMLInputElement> | undefined;
+        onCompositionEnd?: React.CompositionEventHandler<HTMLInputElement> | undefined;
+        onCompositionEndCapture?: React.CompositionEventHandler<HTMLInputElement> | undefined;
+        onCompositionStart?: React.CompositionEventHandler<HTMLInputElement> | undefined;
+        onCompositionStartCapture?: React.CompositionEventHandler<HTMLInputElement> | undefined;
+        onCompositionUpdate?: React.CompositionEventHandler<HTMLInputElement> | undefined;
+        onCompositionUpdateCapture?: React.CompositionEventHandler<HTMLInputElement> | undefined;
+        onFocus?: React.FocusEventHandler<HTMLInputElement> | undefined;
+        onFocusCapture?: React.FocusEventHandler<HTMLInputElement> | undefined;
+        onBlurCapture?: React.FocusEventHandler<HTMLInputElement> | undefined;
+        onChangeCapture?: React.FormEventHandler<HTMLInputElement> | undefined;
+        onBeforeInput?: React.FormEventHandler<HTMLInputElement> | undefined;
+        onBeforeInputCapture?: React.FormEventHandler<HTMLInputElement> | undefined;
+        onInput?: React.FormEventHandler<HTMLInputElement> | undefined;
+        onInputCapture?: React.FormEventHandler<HTMLInputElement> | undefined;
+        onReset?: React.FormEventHandler<HTMLInputElement> | undefined;
+        onResetCapture?: React.FormEventHandler<HTMLInputElement> | undefined;
+        onSubmit?: React.FormEventHandler<HTMLInputElement> | undefined;
+        onSubmitCapture?: React.FormEventHandler<HTMLInputElement> | undefined;
+        onInvalid?: React.FormEventHandler<HTMLInputElement> | undefined;
+        onInvalidCapture?: React.FormEventHandler<HTMLInputElement> | undefined;
+        onLoad?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onLoadCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onError?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onErrorCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onKeyDownCapture?: React.KeyboardEventHandler<HTMLInputElement> | undefined;
+        onKeyPress?: React.KeyboardEventHandler<HTMLInputElement> | undefined;
+        onKeyPressCapture?: React.KeyboardEventHandler<HTMLInputElement> | undefined;
+        onKeyUp?: React.KeyboardEventHandler<HTMLInputElement> | undefined;
+        onKeyUpCapture?: React.KeyboardEventHandler<HTMLInputElement> | undefined;
+        onAbort?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onAbortCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onCanPlay?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onCanPlayCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onCanPlayThrough?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onCanPlayThroughCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onDurationChange?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onDurationChangeCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onEmptied?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onEmptiedCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onEncrypted?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onEncryptedCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onEnded?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onEndedCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onLoadedData?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onLoadedDataCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onLoadedMetadata?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onLoadedMetadataCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onLoadStart?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onLoadStartCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onPause?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onPauseCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onPlay?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onPlayCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onPlaying?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onPlayingCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onProgress?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onProgressCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onRateChange?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onRateChangeCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onResize?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onResizeCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onSeeked?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onSeekedCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onSeeking?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onSeekingCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onStalled?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onStalledCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onSuspend?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onSuspendCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onTimeUpdate?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onTimeUpdateCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onVolumeChange?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onVolumeChangeCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onWaiting?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onWaitingCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onAuxClick?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onAuxClickCapture?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onClick?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onClickCapture?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onContextMenu?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onContextMenuCapture?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onDoubleClick?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onDoubleClickCapture?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onDrag?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDragCapture?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDragEnd?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDragEndCapture?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDragEnter?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDragEnterCapture?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDragExit?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDragExitCapture?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDragLeave?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDragLeaveCapture?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDragOver?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDragOverCapture?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDragStart?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDragStartCapture?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDrop?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onDropCapture?: React.DragEventHandler<HTMLInputElement> | undefined;
+        onMouseDown?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onMouseDownCapture?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onMouseEnter?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onMouseLeave?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onMouseMove?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onMouseMoveCapture?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onMouseOut?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onMouseOutCapture?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onMouseOver?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onMouseOverCapture?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onMouseUp?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onMouseUpCapture?: React.MouseEventHandler<HTMLInputElement> | undefined;
+        onSelectCapture?: React.ReactEventHandler<HTMLInputElement> | undefined;
+        onTouchCancel?: React.TouchEventHandler<HTMLInputElement> | undefined;
+        onTouchCancelCapture?: React.TouchEventHandler<HTMLInputElement> | undefined;
+        onTouchEnd?: React.TouchEventHandler<HTMLInputElement> | undefined;
+        onTouchEndCapture?: React.TouchEventHandler<HTMLInputElement> | undefined;
+        onTouchMove?: React.TouchEventHandler<HTMLInputElement> | undefined;
+        onTouchMoveCapture?: React.TouchEventHandler<HTMLInputElement> | undefined;
+        onTouchStart?: React.TouchEventHandler<HTMLInputElement> | undefined;
+        onTouchStartCapture?: React.TouchEventHandler<HTMLInputElement> | undefined;
+        onPointerDown?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onPointerDownCapture?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onPointerMove?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onPointerMoveCapture?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onPointerUp?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onPointerUpCapture?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onPointerCancel?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onPointerCancelCapture?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onPointerEnter?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onPointerLeave?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onPointerOver?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onPointerOverCapture?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onPointerOut?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onPointerOutCapture?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onGotPointerCapture?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onGotPointerCaptureCapture?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onLostPointerCapture?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onLostPointerCaptureCapture?: React.PointerEventHandler<HTMLInputElement> | undefined;
+        onScroll?: React.UIEventHandler<HTMLInputElement> | undefined;
+        onScrollCapture?: React.UIEventHandler<HTMLInputElement> | undefined;
+        onWheel?: React.WheelEventHandler<HTMLInputElement> | undefined;
+        onWheelCapture?: React.WheelEventHandler<HTMLInputElement> | undefined;
+        onAnimationStart?: React.AnimationEventHandler<HTMLInputElement> | undefined;
+        onAnimationStartCapture?: React.AnimationEventHandler<HTMLInputElement> | undefined;
+        onAnimationEnd?: React.AnimationEventHandler<HTMLInputElement> | undefined;
+        onAnimationEndCapture?: React.AnimationEventHandler<HTMLInputElement> | undefined;
+        onAnimationIteration?: React.AnimationEventHandler<HTMLInputElement> | undefined;
+        onAnimationIterationCapture?: React.AnimationEventHandler<HTMLInputElement> | undefined;
+        onTransitionEnd?: React.TransitionEventHandler<HTMLInputElement> | undefined;
+        onTransitionEndCapture?: React.TransitionEventHandler<HTMLInputElement> | undefined;
+        form?: string | undefined | undefined;
+        list?: string | undefined | undefined;
+        status?: "default" | "warning" | "error" | undefined;
+        step?: number | string | undefined | undefined;
+        normalize?: ((value: string) => string) | undefined;
+        warning?: boolean | undefined;
+        error?: boolean | undefined;
+        size?: "sm" | "md" | "lg" | undefined;
+        disabled?: boolean | undefined;
+        fullwidth?: boolean | undefined;
+        title?: string | undefined | undefined;
+        startIcon?: React.ReactNode;
+        endIcon?: React.ReactNode;
+        formAction?: string | undefined;
+        formEncType?: string | undefined | undefined;
+        formMethod?: string | undefined | undefined;
+        formNoValidate?: boolean | undefined | undefined;
+        formTarget?: string | undefined | undefined;
+        defaultChecked?: boolean | undefined | undefined;
+        defaultValue?: string | number | readonly string[] | undefined;
+        suppressContentEditableWarning?: boolean | undefined | undefined;
+        accessKey?: string | undefined | undefined;
+        autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {}) | undefined;
+        autoFocus?: boolean | undefined | undefined;
+        contentEditable?: "inherit" | (boolean | "true" | "false") | "plaintext-only" | undefined;
+        contextMenu?: string | undefined | undefined;
+        dir?: string | undefined | undefined;
+        draggable?: (boolean | "true" | "false") | undefined;
+        enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined | undefined;
+        hidden?: boolean | undefined | undefined;
+        nonce?: string | undefined | undefined;
+        slot?: string | undefined | undefined;
+        spellCheck?: (boolean | "true" | "false") | undefined;
+        translate?: "yes" | "no" | undefined | undefined;
+        radioGroup?: string | undefined | undefined;
+        about?: string | undefined | undefined;
+        content?: string | undefined | undefined;
+        datatype?: string | undefined | undefined;
+        inlist?: any;
+        prefix?: string | undefined | undefined;
+        property?: string | undefined | undefined;
+        rel?: string | undefined | undefined;
+        resource?: string | undefined | undefined;
+        rev?: string | undefined | undefined;
+        typeof?: string | undefined | undefined;
+        vocab?: string | undefined | undefined;
+        autoCorrect?: string | undefined | undefined;
+        autoSave?: string | undefined | undefined;
+        itemProp?: string | undefined | undefined;
+        itemScope?: boolean | undefined | undefined;
+        itemType?: string | undefined | undefined;
+        itemID?: string | undefined | undefined;
+        itemRef?: string | undefined | undefined;
+        results?: number | undefined | undefined;
+        security?: string | undefined | undefined;
+        unselectable?: "on" | "off" | undefined | undefined;
+        inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined | undefined;
+        is?: string | undefined | undefined;
+        rounded?: "none" | "normal" | "full" | undefined;
+        hasSearchIcon?: boolean | undefined;
+        isFloatingLabel?: boolean | undefined;
+        accept?: string | undefined | undefined;
+        alt?: string | undefined | undefined;
+        capture?: boolean | "user" | "environment" | undefined | undefined;
+        checked?: boolean | undefined | undefined;
+        maxLength?: number | undefined | undefined;
+        minLength?: number | undefined | undefined;
+        multiple?: boolean | undefined | undefined;
+        pattern?: string | undefined | undefined;
+        placeholder?: string | undefined | undefined;
+        readOnly?: boolean | undefined | undefined;
+        required?: boolean | undefined;
+        src?: string | undefined | undefined;
+        label?: string | undefined;
+        iconMode?: "flat" | "solid" | undefined;
+        helperText?: string | undefined;
+        errorMessage?: string | undefined;
+        warningMessage?: string | undefined;
+        keepCloseIconOnValue?: boolean | undefined;
+        keepFooterSpace?: boolean | undefined;
+        labelClassName?: string | undefined;
+        classes?: {
+            iconWrapper?: string;
+            iconSearchWrapper?: string;
+            icon?: string;
+            startIconWrapper?: string;
+            endIconWrapper?: string;
+        } | undefined;
+        onClickStartIcon?: (() => void) | undefined;
+        onClickEndIcon?: (() => void) | undefined;
+        renderStartIcon?: (() => React.ReactNode) | undefined;
+        renderEndIcon?: (() => React.ReactNode) | undefined;
+        trimOnCommit?: boolean | undefined;
+        normalizeOnCommit?: ((value: string) => string) | undefined;
+        ref?: React.ForwardedRef<HTMLInputElement> | undefined;
+    }>) => import("react/jsx-runtime").JSX.Element)[];
+};
+export default meta;
+export declare const Default: StoryObj<typeof AutoComplete>;
+export declare const ShowNoOptionsMessage: StoryObj;
+export declare const FreeSolo: StoryObj;
+export declare const Async: StoryObj;
+export declare const WithFormValidation: StoryObj;
+export declare const InsideDialog: StoryObj;
+export declare const Sizes: StoryObj;
+export declare const States: StoryObj;
+export declare const LoadingState: StoryObj;
+export declare const KeyboardNavigation: StoryObj;

package/dist/cjs/types/components/AutoComplete/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from "./AutoComplete";
+export type { AutoCompleteProps, AutoCompleteOption } from "./AutoComplete";

package/dist/cjs/types/index.d.ts

@@ -9,6 +9,9 @@ export { default as TextArea } from "./components/TextArea/TextArea";
 export { default as Text } from "./components/Text/Text";
 export { default as Tabs } from "./components/Tabs/Tabs";
 export { default as Dropdown } from "./components/Dropdown/Dropdown";
+export { menuItemBaseStyles } from "./components/Dropdown/Dropdown";
+export { default as AutoComplete } from "./components/AutoComplete/AutoComplete";
+export type { AutoCompleteProps, AutoCompleteOption } from "./components/AutoComplete/AutoComplete";
 export { Checkbox } from "./components/Checkbox/Checkbox";
 export { Label } from "./components/Label/Label";
 export { Input } from "./components/Input/Input";

package/dist/components/AutoComplete/AutoComplete.js

@@ -0,0 +1,103 @@
+"use client";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef, useCallback, useRef, useState, } from "react";
+import * as PopoverPrimitive from "@radix-ui/react-popover";
+import TextInput from "../TextInput/TextInput";
+import Loading from "../Loading/Loading";
+import Text from "../Text/Text";
+import Icon from "../Icon/Icon";
+import { cn } from "@/utils/cn";
+import { menuItemBaseStyles } from "../Dropdown/Dropdown";
+// ---------------------------------------------------------------------------
+// AutoComplete
+// ---------------------------------------------------------------------------
+function AutoCompleteInner(_a, ref) {
+    var _b;
+    var { 
+    // AutoComplete-specific props
+    options, value = "", onChange, onSelect, onBlur, onSearch, loading = false, noOptionsText = "No results", showNoOptions = false, renderOption, filterOptions = (x) => x, portal = true, listboxClassName, listboxStyle, popoverStyle, optionClassName, optionStyle, "data-testid": testId, 
+    // InputProps with explicit defaults (rest passes everything else through)
+    id, label, fullwidth = true, size = "md", rounded = "normal", variant = "outline", disabled } = _a, rest = __rest(_a, ["options", "value", "onChange", "onSelect", "onBlur", "onSearch", "loading", "noOptionsText", "showNoOptions", "renderOption", "filterOptions", "portal", "listboxClassName", "listboxStyle", "popoverStyle", "optionClassName", "optionStyle", "data-testid", "id", "label", "fullwidth", "size", "rounded", "variant", "disabled"]);
+    const [open, setOpen] = useState(false);
+    const [activeIndex, setActiveIndex] = useState(-1);
+    const inputRef = useRef(null);
+    const filteredOptions = filterOptions(options);
+    const showPopover = open && (loading || filteredOptions.length > 0 || showNoOptions);
+    const commitSelection = useCallback((option) => {
+        onChange === null || onChange === void 0 ? void 0 : onChange(option.value);
+        onSelect === null || onSelect === void 0 ? void 0 : onSelect(option);
+        setOpen(false);
+        setActiveIndex(-1);
+    }, [onChange, onSelect]);
+    const handleInputChange = useCallback((e) => {
+        const query = e.target.value;
+        onChange === null || onChange === void 0 ? void 0 : onChange(query);
+        onSearch === null || onSearch === void 0 ? void 0 : onSearch(query);
+        setOpen(true);
+        setActiveIndex(-1);
+    }, [onChange, onSearch]);
+    const handleFocus = useCallback((e) => {
+        var _a;
+        setOpen(true);
+        (_a = rest === null || rest === void 0 ? void 0 : rest.onFocus) === null || _a === void 0 ? void 0 : _a.call(rest, e);
+    }, [rest === null || rest === void 0 ? void 0 : rest.onFocus]);
+    const handleBlur = useCallback(() => {
+        // Delay so option button onClick fires before popover closes
+        setTimeout(() => {
+            setOpen(false);
+            setActiveIndex(-1);
+            onBlur === null || onBlur === void 0 ? void 0 : onBlur();
+        }, 150);
+    }, [onBlur]);
+    const handleKeyDown = useCallback((e) => {
+        if (!open) {
+            if (e.key === "ArrowDown" || e.key === "ArrowUp")
+                setOpen(true);
+            return;
+        }
+        if (e.key === "ArrowDown") {
+            e.preventDefault();
+            setActiveIndex((i) => Math.min(i + 1, filteredOptions.length - 1));
+        }
+        else if (e.key === "ArrowUp") {
+            e.preventDefault();
+            setActiveIndex((i) => Math.max(i - 1, 0));
+        }
+        else if (e.key === "Enter") {
+            e.preventDefault();
+            if (activeIndex >= 0 && filteredOptions[activeIndex]) {
+                commitSelection(filteredOptions[activeIndex]);
+            }
+        }
+        else if (e.key === "Escape") {
+            setOpen(false);
+            setActiveIndex(-1);
+        }
+    }, [open, activeIndex, filteredOptions, commitSelection]);
+    const listContent = (_jsx("div", { role: "listbox", style: Object.assign({ boxShadow: "var(--dropdown-menu-shadow)" }, listboxStyle), className: cn("max-h-60 overflow-y-auto", "rounded-md border border-bg-stroke3", "bg-modal-dropdown-surface text-text-g-contrast-high", !portal && "absolute top-full left-0 w-full -mt-3 z-[51]", portal && "z-[51]", listboxClassName), "data-testid": testId ? `${testId}-listbox` : undefined, children: loading ? (_jsx("div", { className: "flex items-center justify-center py-6", children: _jsx(Loading, { size: 20 }) })) : filteredOptions.length === 0 ? (_jsx("div", { className: "px-4 py-6 text-center", children: _jsx(Text, { variant: "small1", className: "text-[var(--dropdown-menu-default-text)]", children: noOptionsText }) })) : (filteredOptions.map((option, index) => {
+            const isSelected = option.value === value;
+            const isActive = index === activeIndex;
+            return (_jsxs("button", { id: `autocomplete-option-${option.value}`, type: "button", role: "option", "aria-selected": isSelected, style: optionStyle, className: cn(menuItemBaseStyles, "w-full", isSelected &&
+                    "bg-[var(--dropdown-menu-selected-bg)] text-[var(--dropdown-menu-selected-text)]", isActive &&
+                    !isSelected &&
+                    "bg-[var(--dropdown-menu-hover-bg)] text-[var(--dropdown-menu-hover-text)]", optionClassName), onMouseDown: (e) => e.preventDefault(), onClick: () => commitSelection(option), "data-testid": `autocomplete-option-${option.value}`, children: [_jsx("span", { className: "shrink-0 size-4 flex items-center justify-center", children: isSelected && (_jsx(Icon, { type: "heroicons", name: "check", className: "size-4 text-[var(--dropdown-menu-selected-text)]" })) }), renderOption ? renderOption(option, isSelected) : option.label] }, option.value));
+        })) }));
+    return (_jsxs(PopoverPrimitive.Root, { open: showPopover, children: [_jsx(PopoverPrimitive.Anchor, { asChild: true, children: _jsxs("div", { className: cn("relative", fullwidth && "w-full"), children: [_jsx(TextInput, Object.assign({}, rest, { ref: ref !== null && ref !== void 0 ? ref : inputRef, id: id, label: label, value: value, size: size, rounded: rounded, variant: variant, disabled: disabled, fullwidth: fullwidth, autoComplete: "off", role: "combobox", "aria-expanded": showPopover, "aria-autocomplete": "list", "aria-activedescendant": activeIndex >= 0
+                                ? `autocomplete-option-${(_b = filteredOptions[activeIndex]) === null || _b === void 0 ? void 0 : _b.value}`
+                                : undefined, hasClearIcon: true, onChange: handleInputChange, onFocus: handleFocus, onBlur: handleBlur, onKeyDown: handleKeyDown, "data-testid": testId })), showPopover && !portal && listContent] }) }), portal && (_jsx(PopoverPrimitive.Portal, { children: _jsx(PopoverPrimitive.Content, { onOpenAutoFocus: (e) => e.preventDefault(), onInteractOutside: (e) => e.preventDefault(), onFocusOutside: (e) => e.preventDefault(), side: "bottom", align: "start", sideOffset: -12, style: Object.assign({ width: "var(--radix-popover-trigger-width)", zIndex: 51 }, popoverStyle), children: listContent }) }))] }));
+}
+// forwardRef with generics requires a manual cast
+const AutoComplete = forwardRef(AutoCompleteInner);
+AutoComplete.displayName = "AutoComplete";
+export default AutoComplete;