@q1travel/design-system 0.30.1 → 0.30.2

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

@@ -580,13 +580,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 +600,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 +1580,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 +1614,8 @@ export declare type MultiComboboxProps = {
     loadError?: ReactNode;
     onRetry?: () => void;
     emptyText?: ReactNode;
+    footer?: ReactNode;
+    required?: boolean;
     disabled?: boolean;
     readOnly?: boolean;
     invalid?: boolean;