@chenzy-design/svelte 0.3.0 → 0.4.1

package/dist/autocomplete/AutoComplete.svelte.d.ts

@@ -5,97 +5,102 @@ type Item = ItemValue | {
     label?: string;
     disabled?: boolean;
 };
-/** 分组项：含 options 即为分组 */
-type ItemGroup = {
-    label: string;
-    options: Item[];
-};
-type ItemOrGroup = Item | ItemGroup;
 type NormalizedItem = {
     value: ItemValue;
     label: string;
     disabled: boolean;
 };
-type Size = 'small' | 'default' | 'large';
-type Status = 'default' | 'warning' | 'error';
+type Size = 'small' | 'large' | 'default';
+type ValidateStatus = 'default' | 'warning' | 'error';
 type Position = 'bottomLeft' | 'bottomRight' | 'topLeft' | 'topRight';
 interface Props {
-    value?: string;
-    defaultValue?: string;
-    /** 候选数据；可含分组项 { label, options: [] } */
-    data?: ItemOrGroup[];
-    open?: boolean;
+    /** 受控输入值（string | number）。 */
+    value?: ItemValue;
+    /** 非受控初始值。 */
+    defaultValue?: ItemValue;
+    /** 候选数据（对齐 Semi data，由用户按 query 准备，组件不做本地过滤）。 */
+    data?: Item[];
+    /** 非受控初始展开。 */
     defaultOpen?: boolean;
     placeholder?: string;
-    /** combobox 输入框可访问名；缺省回退到 placeholder 或 locale 默认 */
+    /** combobox 输入框可访问名；缺省回退到 placeholder 或 locale 默认。 */
     ariaLabel?: string;
-    /** 关联外部 label 的 id（优先于 ariaLabel） */
+    /** 关联外部 label 的 id（优先于 ariaLabel）。 */
     ariaLabelledby?: string;
-    /** 输入框内嵌前缀标签 */
+    /** 输入框内嵌前缀标签。 */
     insetLabel?: string | Snippet;
-    /** 聚焦即展开建议列表（默认 false，仅输入时展开） */
-    openOnFocus?: boolean;
+    /** 内嵌标签 id（关联到 combobox 可访问名，对齐 Semi insetLabelId）。 */
+    insetLabelId?: string;
     size?: Size;
-    status?: Status;
+    /** 校验状态（对齐 Semi validateStatus）。 */
+    validateStatus?: ValidateStatus;
     disabled?: boolean;
-    filter?: boolean;
+    /** 打开浮层时默认高亮首个可用选项（对齐 Semi 默认 false）。 */
     defaultActiveFirstOption?: boolean;
-    clearable?: boolean;
-    /** 远程搜索：输入防抖后回调（由外部更新 data，本地不再过滤） */
+    /** 远程搜索：输入回调（由外部更新 data）。提供即视为远程模式。 */
     onSearch?: (query: string) => void;
-    /** 远程加载中（显示 spinner） */
+    /** 远程加载中（显示 Spin）。 */
     loading?: boolean;
-    /** onSearch 防抖毫秒（默认 300） */
-    searchDebounce?: number;
-    /** 建议项最多渲染条数（0=不限制） */
-    maxCount?: number;
-    onChange?: (v: string) => void;
-    onSelect?: (value: ItemValue) => void;
-    onOpenChange?: (open: boolean) => void;
-    /** 浮层宽度与触发器同宽（默认 true） */
+    /** 值变化回调（对齐 Semi (value: string|number)）。 */
+    onChange?: (value: ItemValue) => void;
+    /** 选中候选项回调；onSelectWithObject=true 时入参为完整对象，否则为 value。 */
+    onSelect?: (value: ItemValue | NormalizedItem) => void;
+    /** 为 true 时 onSelect 回调入参从 value 变为完整候选对象 { value, label, disabled }（对齐 Semi）。 */
+    onSelectWithObject?: boolean;
+    /** 浮层显隐切换回调（对齐 Semi onDropdownVisibleChange）。 */
+    onDropdownVisibleChange?: (visible: boolean) => void;
+    /** 浮层宽度与触发器同宽（默认 true）。 */
     dropdownMatchSelectWidth?: boolean;
-    /** 浮层挂载容器 */
+    /** 浮层挂载容器。 */
     getPopupContainer?: () => HTMLElement;
-    /** 浮层 className */
+    /** 浮层 className。 */
     dropdownClassName?: string;
-    /** 浮层样式 */
+    /** 浮层样式。 */
     dropdownStyle?: string | Record<string, string>;
-    /** 完全自定义触发器 */
+    /** 完全自定义触发器。 */
     triggerRender?: Snippet<[{
         value: string;
         placeholder: string;
         disabled: boolean;
     }]>;
-    /** 自定义候选项渲染 */
+    /** 自定义候选项渲染。 */
     renderItem?: Snippet<[{
         item: NormalizedItem;
         isSelected: boolean;
     }]>;
-    /** 自定义已选项显示 */
+    /** 自定义已选项显示（仅 string，对齐 Semi renderSelectedItem）。 */
     renderSelectedItem?: Snippet<[{
         item: NormalizedItem;
     }]>;
-    /** 无候选时展示内容 */
+    /** 无候选时展示内容。 */
     emptyContent?: Snippet | string;
-    /** 输入框前缀 */
+    /** 输入框前缀。 */
     prefix?: Snippet | string;
-    /** 输入框后缀 */
+    /** 输入框后缀。 */
     suffix?: Snippet | string;
-    /** 显示清除按钮（clearable 的别名，showClear 优先） */
+    /** 显示清除按钮（对齐 Semi showClear）。 */
     showClear?: boolean;
-    /** 自定义清除图标 */
+    /** 自定义清除图标。 */
     clearIcon?: Snippet;
     onBlur?: (e: FocusEvent) => void;
     onFocus?: (e: FocusEvent) => void;
     onClear?: () => void;
-    /** 显式远程模式（关闭本地过滤），不依赖 onSearch 是否存在 */
-    remote?: boolean;
-    /** 挂载自动聚焦 */
+    /** 挂载自动聚焦。 */
     autoFocus?: boolean;
-    /** 浮层位置 */
+    /** 浮层位置。 */
     position?: Position;
+    /** 透传键盘原始事件（在内部键盘逻辑之前调用）。 */
+    onKeyDown?: (e: KeyboardEvent) => void;
+    /** 根节点自定义 class。 */
+    class?: string;
+    /** 根节点自定义 style。 */
+    style?: string;
+    /** 浮层最大高度（number→px，string 原样），默认 300（对齐 Semi）。 */
+    maxHeight?: number | string;
+    /** 浮层 z-index，覆盖默认 token。 */
+    zIndex?: number;
 }
-declare const AutoComplete: import("svelte").Component<Props, {}, "open" | "value">;
+declare const AutoComplete: import("svelte").Component<Props, {}, "">;
 type AutoComplete = ReturnType<typeof AutoComplete>;
 export default AutoComplete;
 //# sourceMappingURL=AutoComplete.svelte.d.ts.map

package/dist/autocomplete/AutoComplete.svelte.d.ts.map

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

package/dist/autocomplete/meta.d.ts

@@ -1,100 +1,216 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
  * See specs/00-foundation/ai-friendly.spec.md.
+ * 严格对齐 Semi Design autoComplete props（已删超集 remote/searchDebounce/maxCount/filter/
+ * openOnFocus/status/clearable/open/onOpenChange；status→validateStatus；onOpenChange→onDropdownVisibleChange）。
  */
 export declare const meta: {
     readonly name: "AutoComplete";
     readonly category: "input";
-    readonly description: "输入联想框，支持本地过滤候选、远程异步搜索、选项分组、内嵌标签与键盘选择。";
+    readonly description: "输入联想框，data 由用户按 query 准备（远程或本地），支持键盘选择、内嵌标签与关键词高亮。";
     readonly props: readonly [{
         readonly name: "value";
-        readonly type: "string";
+        readonly type: "string|number";
         readonly default: "undefined";
+        readonly desc: "受控输入值";
     }, {
         readonly name: "defaultValue";
-        readonly type: "string";
+        readonly type: "string|number";
         readonly default: "''";
+        readonly desc: "非受控初始值";
     }, {
         readonly name: "data";
-        readonly type: "ItemOrGroup[]";
+        readonly type: "Item[]";
         readonly default: "[]";
-    }, {
-        readonly name: "open";
-        readonly type: "boolean";
-        readonly default: "undefined";
+        readonly desc: "候选数据（由用户按 query 准备，组件不做本地过滤）";
     }, {
         readonly name: "defaultOpen";
         readonly type: "boolean";
         readonly default: "false";
+        readonly desc: "非受控初始展开";
     }, {
         readonly name: "placeholder";
         readonly type: "string";
         readonly default: "''";
+    }, {
+        readonly name: "ariaLabel";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "combobox 可访问名；缺省回退 placeholder 或 locale 默认";
+    }, {
+        readonly name: "ariaLabelledby";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "关联外部 label 的 id（优先于 ariaLabel）";
     }, {
         readonly name: "insetLabel";
         readonly type: "string|Snippet";
         readonly default: "undefined";
+        readonly desc: "输入框内嵌前缀标签";
     }, {
-        readonly name: "openOnFocus";
-        readonly type: "boolean";
-        readonly default: "false";
+        readonly name: "insetLabelId";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "内嵌标签 id（关联 combobox 可访问名，对齐 Semi）";
     }, {
         readonly name: "size";
-        readonly type: "'small'|'default'|'large'";
+        readonly type: "'small'|'large'|'default'";
         readonly default: "default";
     }, {
-        readonly name: "status";
+        readonly name: "validateStatus";
         readonly type: "'default'|'warning'|'error'";
         readonly default: "default";
+        readonly desc: "校验状态（对齐 Semi validateStatus）";
     }, {
         readonly name: "disabled";
         readonly type: "boolean";
         readonly default: "false";
-    }, {
-        readonly name: "filter";
-        readonly type: "boolean";
-        readonly default: "true";
     }, {
         readonly name: "defaultActiveFirstOption";
         readonly type: "boolean";
-        readonly default: "true";
-    }, {
-        readonly name: "clearable";
-        readonly type: "boolean";
         readonly default: "false";
+        readonly desc: "打开时默认高亮首项（对齐 Semi 默认 false）";
     }, {
         readonly name: "onSearch";
         readonly type: "(query: string) => void";
         readonly default: "undefined";
+        readonly desc: "远程搜索回调（提供即远程模式，由外部更新 data）";
     }, {
         readonly name: "loading";
         readonly type: "boolean";
         readonly default: "false";
-    }, {
-        readonly name: "searchDebounce";
-        readonly type: "number";
-        readonly default: "300";
-    }, {
-        readonly name: "maxCount";
-        readonly type: "number";
-        readonly default: "0";
+        readonly desc: "远程加载中（显示 Spin）";
     }, {
         readonly name: "onChange";
-        readonly type: "(v: string) => void";
+        readonly type: "(value: string|number) => void";
         readonly default: "undefined";
     }, {
         readonly name: "onSelect";
-        readonly type: "(value: string|number) => void";
+        readonly type: "(value: string|number|NormalizedItem) => void";
+        readonly default: "undefined";
+        readonly desc: "onSelectWithObject=true 时回传完整候选对象";
+    }, {
+        readonly name: "onSelectWithObject";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "true 时 onSelect 入参从 value 变为 { value, label, disabled } 对象（对齐 Semi）";
+    }, {
+        readonly name: "onDropdownVisibleChange";
+        readonly type: "(visible: boolean) => void";
+        readonly default: "undefined";
+        readonly desc: "浮层显隐切换回调（对齐 Semi）";
+    }, {
+        readonly name: "onKeyDown";
+        readonly type: "(e: KeyboardEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "透传输入框原始 keydown 事件（对齐 Semi）";
+    }, {
+        readonly name: "dropdownMatchSelectWidth";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "浮层宽度与触发器同宽";
+    }, {
+        readonly name: "getPopupContainer";
+        readonly type: "() => HTMLElement";
         readonly default: "undefined";
+        readonly desc: "浮层挂载容器";
     }, {
-        readonly name: "onOpenChange";
-        readonly type: "(open: boolean) => void";
+        readonly name: "dropdownClassName";
+        readonly type: "string";
         readonly default: "undefined";
+        readonly desc: "浮层 className";
+    }, {
+        readonly name: "dropdownStyle";
+        readonly type: "string | Record<string, string>";
+        readonly default: "undefined";
+        readonly desc: "浮层样式";
+    }, {
+        readonly name: "triggerRender";
+        readonly type: "Snippet<[{ value: string; placeholder: string; disabled: boolean }]>";
+        readonly default: "undefined";
+        readonly desc: "完全自定义触发器";
+    }, {
+        readonly name: "renderItem";
+        readonly type: "Snippet<[{ item: NormalizedItem; isSelected: boolean }]>";
+        readonly default: "undefined";
+        readonly desc: "自定义候选项渲染";
+    }, {
+        readonly name: "renderSelectedItem";
+        readonly type: "Snippet<[{ item: NormalizedItem }]>";
+        readonly default: "undefined";
+        readonly desc: "自定义已选项显示（仅 string）";
+    }, {
+        readonly name: "emptyContent";
+        readonly type: "Snippet | string";
+        readonly default: "undefined";
+        readonly desc: "无候选时展示内容";
+    }, {
+        readonly name: "prefix";
+        readonly type: "Snippet | string";
+        readonly default: "undefined";
+        readonly desc: "输入框前缀";
+    }, {
+        readonly name: "suffix";
+        readonly type: "Snippet | string";
+        readonly default: "undefined";
+        readonly desc: "输入框后缀";
+    }, {
+        readonly name: "showClear";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "显示清除按钮（对齐 Semi showClear）";
+    }, {
+        readonly name: "clearIcon";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "自定义清除图标";
+    }, {
+        readonly name: "onBlur";
+        readonly type: "(e: FocusEvent) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onFocus";
+        readonly type: "(e: FocusEvent) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onClear";
+        readonly type: "() => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "autoFocus";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "挂载自动聚焦";
+    }, {
+        readonly name: "position";
+        readonly type: "'bottomLeft'|'bottomRight'|'topLeft'|'topRight'";
+        readonly default: "'bottomLeft'";
+        readonly desc: "浮层位置";
+    }, {
+        readonly name: "maxHeight";
+        readonly type: "number|string";
+        readonly default: "300";
+        readonly desc: "下拉浮层最大高度，number→px（对齐 Semi 默认 300）";
+    }, {
+        readonly name: "zIndex";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "下拉浮层 z-index（对齐 Semi）";
+    }, {
+        readonly name: "class";
+        readonly type: "string";
+        readonly default: "''";
+        readonly desc: "根节点 className";
+    }, {
+        readonly name: "style";
+        readonly type: "string";
+        readonly default: "''";
+        readonly desc: "根节点内联样式";
     }];
     readonly a11y: {
         readonly role: "combobox";
         readonly notes: readonly ["combobox + aria-autocomplete=\"list\" + listbox", "aria-activedescendant 指向高亮候选", "键盘：↑↓ 移动、Enter 选中、Esc 关闭"];
     };
-    readonly tokens: readonly ["--cd-input-*", "--cd-select-dropdown-*", "--cd-focus-ring", "--cd-motion-*"];
+    readonly tokens: readonly ["--cd-autocomplete-*", "--cd-focus-ring", "--cd-motion-*"];
 };
 //# sourceMappingURL=meta.d.ts.map

package/dist/autocomplete/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/autocomplete/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCP,CAAC"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/autocomplete/meta.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDP,CAAC"}

package/dist/autocomplete/meta.js

@@ -1,33 +1,55 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
  * See specs/00-foundation/ai-friendly.spec.md.
+ * 严格对齐 Semi Design autoComplete props（已删超集 remote/searchDebounce/maxCount/filter/
+ * openOnFocus/status/clearable/open/onOpenChange；status→validateStatus；onOpenChange→onDropdownVisibleChange）。
  */
 export const meta = {
     name: 'AutoComplete',
     category: 'input',
-    description: '输入联想框，支持本地过滤候选、远程异步搜索、选项分组、内嵌标签与键盘选择。',
+    description: '输入联想框，data 由用户按 query 准备（远程或本地），支持键盘选择、内嵌标签与关键词高亮。',
     props: [
-        { name: 'value', type: 'string', default: 'undefined' },
-        { name: 'defaultValue', type: 'string', default: "''" },
-        { name: 'data', type: 'ItemOrGroup[]', default: '[]' },
-        { name: 'open', type: 'boolean', default: 'undefined' },
-        { name: 'defaultOpen', type: 'boolean', default: 'false' },
+        { name: 'value', type: 'string|number', default: 'undefined', desc: '受控输入值' },
+        { name: 'defaultValue', type: 'string|number', default: "''", desc: '非受控初始值' },
+        { name: 'data', type: 'Item[]', default: '[]', desc: '候选数据（由用户按 query 准备，组件不做本地过滤）' },
+        { name: 'defaultOpen', type: 'boolean', default: 'false', desc: '非受控初始展开' },
         { name: 'placeholder', type: 'string', default: "''" },
-        { name: 'insetLabel', type: 'string|Snippet', default: 'undefined' },
-        { name: 'openOnFocus', type: 'boolean', default: 'false' },
-        { name: 'size', type: "'small'|'default'|'large'", default: 'default' },
-        { name: 'status', type: "'default'|'warning'|'error'", default: 'default' },
+        { name: 'ariaLabel', type: 'string', default: 'undefined', desc: 'combobox 可访问名；缺省回退 placeholder 或 locale 默认' },
+        { name: 'ariaLabelledby', type: 'string', default: 'undefined', desc: '关联外部 label 的 id（优先于 ariaLabel）' },
+        { name: 'insetLabel', type: 'string|Snippet', default: 'undefined', desc: '输入框内嵌前缀标签' },
+        { name: 'insetLabelId', type: 'string', default: 'undefined', desc: '内嵌标签 id（关联 combobox 可访问名，对齐 Semi）' },
+        { name: 'size', type: "'small'|'large'|'default'", default: 'default' },
+        { name: 'validateStatus', type: "'default'|'warning'|'error'", default: 'default', desc: '校验状态（对齐 Semi validateStatus）' },
         { name: 'disabled', type: 'boolean', default: 'false' },
-        { name: 'filter', type: 'boolean', default: 'true' },
-        { name: 'defaultActiveFirstOption', type: 'boolean', default: 'true' },
-        { name: 'clearable', type: 'boolean', default: 'false' },
-        { name: 'onSearch', type: '(query: string) => void', default: 'undefined' },
-        { name: 'loading', type: 'boolean', default: 'false' },
-        { name: 'searchDebounce', type: 'number', default: '300' },
-        { name: 'maxCount', type: 'number', default: '0' },
-        { name: 'onChange', type: '(v: string) => void', default: 'undefined' },
-        { name: 'onSelect', type: '(value: string|number) => void', default: 'undefined' },
-        { name: 'onOpenChange', type: '(open: boolean) => void', default: 'undefined' },
+        { name: 'defaultActiveFirstOption', type: 'boolean', default: 'false', desc: '打开时默认高亮首项（对齐 Semi 默认 false）' },
+        { name: 'onSearch', type: '(query: string) => void', default: 'undefined', desc: '远程搜索回调（提供即远程模式，由外部更新 data）' },
+        { name: 'loading', type: 'boolean', default: 'false', desc: '远程加载中（显示 Spin）' },
+        { name: 'onChange', type: '(value: string|number) => void', default: 'undefined' },
+        { name: 'onSelect', type: '(value: string|number|NormalizedItem) => void', default: 'undefined', desc: 'onSelectWithObject=true 时回传完整候选对象' },
+        { name: 'onSelectWithObject', type: 'boolean', default: 'false', desc: 'true 时 onSelect 入参从 value 变为 { value, label, disabled } 对象（对齐 Semi）' },
+        { name: 'onDropdownVisibleChange', type: '(visible: boolean) => void', default: 'undefined', desc: '浮层显隐切换回调（对齐 Semi）' },
+        { name: 'onKeyDown', type: '(e: KeyboardEvent) => void', default: 'undefined', desc: '透传输入框原始 keydown 事件（对齐 Semi）' },
+        { name: 'dropdownMatchSelectWidth', type: 'boolean', default: 'true', desc: '浮层宽度与触发器同宽' },
+        { name: 'getPopupContainer', type: '() => HTMLElement', default: 'undefined', desc: '浮层挂载容器' },
+        { name: 'dropdownClassName', type: 'string', default: 'undefined', desc: '浮层 className' },
+        { name: 'dropdownStyle', type: 'string | Record<string, string>', default: 'undefined', desc: '浮层样式' },
+        { name: 'triggerRender', type: 'Snippet<[{ value: string; placeholder: string; disabled: boolean }]>', default: 'undefined', desc: '完全自定义触发器' },
+        { name: 'renderItem', type: 'Snippet<[{ item: NormalizedItem; isSelected: boolean }]>', default: 'undefined', desc: '自定义候选项渲染' },
+        { name: 'renderSelectedItem', type: 'Snippet<[{ item: NormalizedItem }]>', default: 'undefined', desc: '自定义已选项显示（仅 string）' },
+        { name: 'emptyContent', type: 'Snippet | string', default: 'undefined', desc: '无候选时展示内容' },
+        { name: 'prefix', type: 'Snippet | string', default: 'undefined', desc: '输入框前缀' },
+        { name: 'suffix', type: 'Snippet | string', default: 'undefined', desc: '输入框后缀' },
+        { name: 'showClear', type: 'boolean', default: 'false', desc: '显示清除按钮（对齐 Semi showClear）' },
+        { name: 'clearIcon', type: 'Snippet', default: 'undefined', desc: '自定义清除图标' },
+        { name: 'onBlur', type: '(e: FocusEvent) => void', default: 'undefined' },
+        { name: 'onFocus', type: '(e: FocusEvent) => void', default: 'undefined' },
+        { name: 'onClear', type: '() => void', default: 'undefined' },
+        { name: 'autoFocus', type: 'boolean', default: 'false', desc: '挂载自动聚焦' },
+        { name: 'position', type: "'bottomLeft'|'bottomRight'|'topLeft'|'topRight'", default: "'bottomLeft'", desc: '浮层位置' },
+        { name: 'maxHeight', type: 'number|string', default: '300', desc: '下拉浮层最大高度，number→px（对齐 Semi 默认 300）' },
+        { name: 'zIndex', type: 'number', default: 'undefined', desc: '下拉浮层 z-index（对齐 Semi）' },
+        { name: 'class', type: 'string', default: "''", desc: '根节点 className' },
+        { name: 'style', type: 'string', default: "''", desc: '根节点内联样式' },
     ],
     a11y: {
         role: 'combobox',
@@ -37,5 +59,5 @@ export const meta = {
             '键盘：↑↓ 移动、Enter 选中、Esc 关闭',
         ],
     },
-    tokens: ['--cd-input-*', '--cd-select-dropdown-*', '--cd-focus-ring', '--cd-motion-*'],
+    tokens: ['--cd-autocomplete-*', '--cd-focus-ring', '--cd-motion-*'],
 };