@q1travel/design-system 0.30.1 → 0.30.3

package/dist-pkg/design-system.d.ts

@@ -12,6 +12,7 @@ import { ForwardRefExoticComponent } from 'react';
 import { HTMLAttributes } from 'react';
 import { InputHTMLAttributes } from 'react';
 import { JSX } from 'react';
+import { KeyboardEvent as KeyboardEvent_2 } from 'react';
 import { KeyboardEventHandler } from 'react';
 import { MouseEvent as MouseEvent_2 } from 'react';
 import { MouseEventHandler } from 'react';
@@ -580,13 +581,14 @@ export declare function CollapsibleBreadcrumb({ items, label }: {
     label: string;
 }): JSX.Element;
 
-export declare function Combobox({ options, value, onChange, onSearch, isLoading, placeholder, size, disabled, readOnly, invalid, errorId, error, emptyText, clearable, id, className, name, inputMode, spellCheck, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, ref, ...rest }: ComboboxProps): JSX.Element;
+export declare function Combobox({ options, searchPlacement, searchPlaceholder, footer, value, onChange, onSearch, isLoading, placeholder, size, disabled, readOnly, invalid, errorId, error, emptyText, clearable, id, className, name, inputMode, spellCheck, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, ref, ...rest }: ComboboxProps): JSX.Element;
 
 export declare type ComboboxOption = {
     /** 禁止空字符串（与「未选」的受控空值歧义，adapter 层保证）。 */
     value: string;
     /** 显示与过滤的唯一来源。 */
     label: string;
+    description?: string;
     disabled?: boolean;
     /** 组件透而不读，仅随 onChange 第二参原样带回。 */
     meta?: unknown;
@@ -599,6 +601,12 @@ export declare type ComboboxOption = {
 export declare type ComboboxProps = {
     /** 唯一 shape，后端字段在 adapter 层转换。 */
     options: ComboboxOption[];
+    /** 默认在触发器输入；panel 使用按钮触发并将搜索放在弹层。 */
+    searchPlacement?: 'input' | 'panel';
+    /** 面板搜索的独立占位文案。 */
+    searchPlaceholder?: string;
+    /** 列表之外的操作区，进入正常 Tab 顺序。 */
+    footer?: ReactNode;
     /** 受控选中值；'' = 未选。 */
     value: string;
     /** 选中传 (option.value, option)；clearable 清除传 ('', undefined)。 */
@@ -1573,7 +1581,7 @@ declare type ModalLegacyDismissalProps = {
 export declare type ModalProps = ModalBaseProps & (ModalLegacyDismissalProps | ModalEscapeActionProps);
 
 /** 标签触发器与弹层搜索组合；选项变更保持展开，选中值完全受控。 */
-export declare function MultiCombobox({ options, value, onChange, onOpenChange, selectedOptions, placeholder, searchPlaceholder, onSearch, searchValue, isLoading, loadError, onRetry, emptyText, disabled, readOnly, invalid, errorId, error, clearable, id, name, className, ref, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, 'aria-describedby': ariaDescribedby }: MultiComboboxProps): JSX.Element;
+export declare function MultiCombobox({ options, value, onChange, onOpenChange, selectedOptions, placeholder, searchPlaceholder, onSearch, searchValue, isLoading, loadError, onRetry, emptyText, footer, required, disabled, readOnly, invalid, errorId, error, clearable, id, name, className, ref, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, 'aria-describedby': ariaDescribedby }: MultiComboboxProps): JSX.Element;
 
 export declare type MultiComboboxChangeDetails = {
     action: 'select' | 'remove' | 'clear';
@@ -1607,6 +1615,8 @@ export declare type MultiComboboxProps = {
     loadError?: ReactNode;
     onRetry?: () => void;
     emptyText?: ReactNode;
+    footer?: ReactNode;
+    required?: boolean;
     disabled?: boolean;
     readOnly?: boolean;
     invalid?: boolean;
@@ -2087,7 +2097,7 @@ export declare function ScrollerWithButtons({ axis, contentName, label, children
     children: ReactNode;
 }): JSX.Element;
 
-export declare function SearchDialog({ open, onOpenChange, query, onQueryChange, sections, onSelect, renderTrigger, label, placeholder, emptyTitle, clearQueryLabel, footer, }: SearchDialogProps): JSX.Element;
+export declare function SearchDialog({ open, onOpenChange, query, onQueryChange, sections, onSelect, renderTrigger, label, placeholder, emptyTitle, clearQueryLabel, footer, onEscapeKeyDown, onInputKeyDown, }: SearchDialogProps): JSX.Element;
 
 export declare type SearchDialogItem = {
     id: string;
@@ -2120,6 +2130,13 @@ export declare type SearchDialogProps = {
     emptyTitle?: string;
     clearQueryLabel?: string;
     footer?: ReactNode;
+    /** Esc 关闭前调用；preventDefault 可接管返回等操作。 */
+    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    /** 输入框键盘导航前调用；preventDefault 跳过内部处理，IME 期间不调用。 */
+    onInputKeyDown?: (event: KeyboardEvent_2<HTMLInputElement>, context: {
+        readonly activeItem?: SearchDialogItem;
+        readonly activeSectionId?: string;
+    }) => void;
 };
 
 export declare type SearchDialogSection = {