@chenzy-design/svelte 0.3.0 → 0.4.1

package/dist/select/Select.svelte.d.ts

@@ -18,63 +18,159 @@ type Status = 'default' | 'warning' | 'error';
 interface Props {
     value?: OptionValue | OptionValue[];
     defaultValue?: OptionValue | OptionValue[];
-    /** 选项；可含分组项 { label, options: [] } */
-    options?: OptionOrGroup[];
+    /** 选项；可含分组项 { label, options: [] }（对齐 Semi optionList） */
+    optionList?: OptionOrGroup[];
     multiple?: boolean;
-    filter?: boolean;
+    /**
+     * 是否开启输入过滤（对齐 Semi filter: boolean | function）。
+     * boolean：true 时按选项 label 本地包含匹配；
+     * function：自定义过滤逻辑 (input, option) => boolean，返回 true 保留该项。
+     */
+    filter?: boolean | ((input: string, option: OptionData) => boolean);
     open?: boolean;
     defaultOpen?: boolean;
     size?: Size;
-    status?: Status;
-    /** 下拉浮层 placement（默认 bottomStart，自动避让仍生效） */
-    placement?: Placement;
+    /** 校验态样式（对齐 Semi validateStatus） */
+    validateStatus?: Status;
+    /** 下拉浮层弹出位置（对齐 Semi position，默认 bottomStart，自动避让仍生效） */
+    position?: Placement;
     placeholder?: string;
     /** combobox 触发器可访问名；缺省回退到 placeholder 或 locale 默认 */
     ariaLabel?: string;
     /** 关联外部 label 的 id（优先于 ariaLabel） */
     ariaLabelledby?: string;
+    /** 关联外部辅助说明的 id（对齐 Semi withField aria-describedby 注入） */
+    ariaDescribedby?: string;
+    /** 关联外部错误提示的 id（对齐 Semi withField aria-errormessage 注入） */
+    ariaErrormessage?: string;
+    /** 标记为必填（对齐 Semi withField aria-required 注入） */
+    ariaRequired?: boolean;
     /** 绑定到触发器的 id 属性，用于关联外部 <label for="..."> */
     id?: string;
     disabled?: boolean;
-    clearable?: boolean;
+    /** 多选/单选是否显示清除按钮（对齐 Semi showClear，默认 false） */
+    showClear?: boolean;
+    /** 多选最多可选项数（对齐 Semi max）；达到上限后新增项被忽略并触发 onExceed */
+    max?: number;
     /** 多选 tag 最大显示数，超出折叠为 +N（0=不折叠） */
     maxTagCount?: number;
     /** 多选单个 Tag 文本最大长度，超出截断为「前缀…」，完整文本经 title 查看（不截则不传） */
     maxTagTextLength?: number;
     /** filter 无匹配时允许创建新选项（值=输入文本） */
     allowCreate?: boolean;
-    /** 远程搜索：输入防抖后回调（由外部更新 options，不再本地过滤） */
-    onSearch?: (query: string) => void;
+    /**
+     * 远程搜索（对齐 Semi remote，默认 false）：为 true 时不本地过滤，
+     * 输入防抖后回调 onSearch，由外部按 query 更新 optionList。
+     */
+    remote?: boolean;
+    /** 搜索输入回调（对齐 Semi onSearch(value, event)）；remote=true 时防抖触发 */
+    onSearch?: (value: string, event?: Event) => void;
     /** 远程加载中（显示 spinner） */
     loading?: boolean;
-    /** onSearch 防抖毫秒（默认 300） */
-    searchDebounce?: number;
-    /** 选项虚拟化：大数据下拉只渲染视口内 option（仅非分组生效，默认 false） */
-    virtualized?: boolean;
-    /** 虚拟化选项行高（px，默认 32）；需与样式实际行高一致 */
-    optionHeight?: number;
-    /** 下拉最大高度（px，默认 256）；虚拟化时同时作为视口高度 */
+    /**
+     * 选项虚拟化（对齐 Semi virtualize 对象）：非分组大数据下拉只渲染视口内 option。
+     * itemSize：选项行高（px，默认 32，需与样式实际行高一致）；
+     * height：虚拟视口高度（px，默认取 maxHeight）；width：预留（当前跟随触发器宽度，忽略）。
+     * 传入该对象即开启虚拟化（仅非分组生效）。
+     */
+    virtualize?: {
+        itemSize?: number;
+        height?: number;
+        width?: string | number;
+    };
+    /** 下拉最大高度（px，默认 270，对齐 Semi maxHeight） */
     maxHeight?: number;
     /** 浮层宽度是否跟随触发器（默认 true）；false 时浮层自适应内容宽度 */
     dropdownMatchSelectWidth?: boolean;
+    /** 浮层根 div 追加的自定义 className（与内置 cd-select__dropdown 并存） */
+    dropdownClassName?: string;
+    /** 浮层根 div 合并的自定义内联样式（拼在内置 style 之后；勿含 position/transform，会与定位冲突） */
+    dropdownStyle?: string;
+    /** 浮层层级（z-index）；不传时由 CSS 层级 token 控制 */
+    zIndex?: number;
+    /**
+     * 浮层与触发器的间距(px)，映射到 floating 主轴 offset；不传保持默认 4。
+     * 兼容 Semi object 形态 { top?, bottom?, left?, right? }：按 placement 主轴方向取值
+     * （bottom/top 系取 bottom/top，left/right 系取 left/right），缺项回退默认。
+     */
+    dropdownMargin?: number | {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+    };
+    /** 浮层点击是否 stopPropagation（对齐 Semi stopPropagation，默认 true），避免冒泡到外层触发无关点击 */
+    stopPropagation?: boolean;
+    /** 触发器鼠标进入回调（对齐 Semi onMouseEnter） */
+    onMouseEnter?: (e: MouseEvent) => void;
+    /** 触发器鼠标离开回调（对齐 Semi onMouseLeave） */
+    onMouseLeave?: (e: MouseEvent) => void;
     /** 关闭时销毁浮层 DOM（默认 false，复用节点避免重建开销） */
     destroyOnClose?: boolean;
     /** 浮层挂载目标容器（默认 body） */
     getPopupContainer?: () => HTMLElement;
+    /** 浮层溢出视口时自动翻转到反向 placement（默认 true，对齐 Semi autoAdjustOverflow） */
+    autoAdjustOverflow?: boolean;
     /** 无边框模式：移除触发器边框 */
     borderless?: boolean;
     /** 挂载后自动聚焦触发器 */
     autoFocus?: boolean;
     /** 多选选中后自动清空搜索词（默认 true） */
     autoClearSearchValue?: boolean;
-    /** 超出 maxTagCount 时，将 +N 悬停展示剩余 tags（title tooltip） */
+    /** 超出 maxTagCount 折叠出 +N 时，hover +N 用 Popover 浮层展示剩余全部 Tag（对齐 Semi restTagsPopover） */
     showRestTagsPopover?: boolean;
-    /** 透传给 +N 悬停 popover 的参数（预留，当前通过 title 实现） */
+    /** 透传给 +N 悬停 Popover 浮层的配置（spread 到 Popover，可覆盖 position/trigger/spacing 等） */
     restTagsPopoverProps?: Record<string, unknown>;
-    /** 用作回显的字段名（默认 'label'）；当选项含自定义字段时取对应值作显示文本 */
-    optionLabelProp?: string;
+    /**
+     * 打开浮层时是否默认高亮第一个可用选项（键盘 Enter 可直接选中，对齐 Semi v2.17+ 默认 true）。
+     * 接入 activeIndex 初始化：打开时把 activeIndex 定位到首个非禁用选项（filter 输入变化后同样重定位）。
+     */
+    defaultActiveFirstOption?: boolean;
+    /**
+     * 透传给搜索 input 的额外属性（filter 搜索框；searchPosition='trigger' 内联 input 与 'dropdown' 浮层 input 均生效）。
+     * 对齐 Semi：勿传 value/onChange/onFocus 等会覆盖组件内部搜索回调的键（内部绑定优先，展开在前）。
+     */
+    inputProps?: Record<string, unknown>;
+    /** 是否显示触发器右侧下拉箭头（默认 true）；false 时隐藏箭头区（suffix 存在时以 suffix 为准） */
+    showArrow?: boolean;
+    /** 浮层已展开时，点击触发器是否收起浮层（默认 false；对齐 Semi clickToHide） */
+    clickToHide?: boolean;
+    /** 浮层选项列表滚动时的回调（对齐 Semi onListScroll，携带原生 scroll 事件） */
+    onListScroll?: (e: Event) => void;
+    /** autoFocus/命令式聚焦触发器时是否传入 focus({ preventScroll })，避免页面跳动（对齐 Semi preventScroll） */
+    preventScroll?: boolean;
+    /**
+     * 多选且 maxTagCount 折叠出 +N 时，浮层打开状态下是否就地展开剩余全部 Tag（对齐 Semi expandRestTagsOnClick）。
+     * 对齐 Semi renderMultipleSelection：为 true 且浮层打开时全量展开（NotOneLine 分支），关闭时复位折叠；
+     * 展开为纯展示态，不影响选中值。点击触发器即打开浮层→展开，无需单独点击 +N。
+     */
+    expandRestTagsOnClick?: boolean;
+    /**
+     * 多选且存在 maxTagCount 时，对溢出部分的可见 Tag 做省略处理（最后一个可见 Tag 文本超出触发器宽度时截断为「前缀…」）。
+     * 对齐 Semi ellipsisTrigger：纯 CSS 单行省略，完整文本经 title 查看；不影响选中值。
+     */
+    ellipsisTrigger?: boolean;
+    /**
+     * 搜索框位置（对齐 Semi searchPosition，默认 'trigger'）：'trigger'（搜索输入内联在触发器上）
+     * | 'dropdown'（浮层内独立搜索框）。仅在 filter 开启时生效。'trigger' 时输入框长驻触发器
+     * （单选选中值作 placeholder，多选与 tags 并排），键入即就地过滤。
+     */
+    searchPosition?: 'dropdown' | 'trigger';
+    /** 搜索框占位文本（对齐 Semi searchPlaceholder）；缺省走 locale Select.searchPlaceholder */
+    searchPlaceholder?: string;
+    /**
+     * 内嵌标签：浮入触发器左侧的常驻标签（string 或 Snippet），用于「标签+值」一体式触发器。
+     * 渲染在前缀之后、内容之前，不影响选中值/过滤逻辑（纯展示，对齐 DatePicker insetInput 的展示层定位）。
+     */
+    insetLabel?: string | Snippet;
+    /**
+     * insetLabel 的 id，挂到内嵌标签元素上并经 aria-labelledby 关联触发器 combobox，
+     * 使屏幕阅读器把内嵌标签朗读为触发器可访问名的一部分。仅 insetLabel 存在时生效。
+     */
+    insetLabelId?: string;
     onChange?: (v: OptionValue | OptionValue[]) => void;
-    onOpenChange?: (open: boolean) => void;
+    /** 浮层显隐变化回调（对齐 Semi onDropdownVisibleChange） */
+    onDropdownVisibleChange?: (open: boolean) => void;
     /** 选中某项时触发（多选：每次单个 toggle 选中时；单选：选中时） */
     onSelect?: (value: OptionValue, option: OptionData) => void;
     /** 多选取消某项时触发 */
@@ -97,32 +193,69 @@ interface Props {
     prefix?: Snippet;
     /** 触发器右侧后缀（覆盖默认箭头区域） */
     suffix?: Snippet;
+    /** 根容器内联样式（对齐 Semi style，可设 width 等） */
+    style?: string;
+    /** 根容器自定义类名（与内置 cd-select 并存，对齐 Semi className） */
+    class?: string;
     /** 自定义清除按钮图标 */
     clearIcon?: Snippet;
     /** 自定义下拉箭头图标 */
     arrowIcon?: Snippet;
-    /** 自定义空态内容（字符串或 Snippet 均可，为字符串时直接渲染文本） */
+    /** 自定义空态内容（字符串或 Snippet 均可，为字符串时直接渲染文本，对齐 Semi emptyContent） */
     emptyContent?: string | Snippet;
-    /** 自定义空态 snippet（与 emptyContent 等价，优先级同） */
-    empty?: Snippet;
-    /** 浮层顶部固定区 */
-    dropdownHeader?: Snippet;
-    /** 浮层底部固定区 */
-    dropdownFooter?: Snippet;
-    /** 自定义单项渲染 */
-    option?: Snippet<[{
-        option: OptionData;
-        selected: boolean;
-        active: boolean;
-    }]>;
-    /** 自定义选中值/Tag 渲染 */
-    label?: Snippet<[{
+    /** 浮层顶部固定区（inner：渲染在滚动列表内部顶端，随 optionList 滚动，对齐 Semi innerTopSlot） */
+    innerTopSlot?: Snippet;
+    /** 浮层底部固定区（inner：渲染在滚动列表内部底端，随 optionList 滚动，对齐 Semi innerBottomSlot） */
+    innerBottomSlot?: Snippet;
+    /** 浮层最外层顶部 slot（outer：与滚动列表平级、位于滚动区之外，始终固定展现，对齐 Semi outerTopSlot） */
+    outerTopSlot?: Snippet;
+    /** 浮层最外层底部 slot（outer：与滚动列表平级、位于滚动区之外，始终固定展现，对齐 Semi outerBottomSlot） */
+    outerBottomSlot?: Snippet;
+    /** 完全自定义候选项渲染（对齐 Semi renderOptionItem，入参含 selected/focused/onMouseEnter/onClick） */
+    renderOptionItem?: Snippet<[
+        {
+            option: OptionData;
+            selected: boolean;
+            focused: boolean;
+            onMouseEnter: () => void;
+            onClick: () => void;
+        }
+    ]>;
+    /** 自定义已选项标签/回显渲染（对齐 Semi renderSelectedItem，单选返回节点，多选逐个 Tag 内容） */
+    renderSelectedItem?: Snippet<[{
         option: OptionData;
     }]>;
     /** 自定义"创建xxx"项渲染 */
     renderCreateItem?: Snippet<[string]>;
+    /**
+     * 完全自定义触发器渲染，替换默认 combobox 触发框。
+     * 入参含当前 value/选中项/placeholder/open 态，供调用方自绘触发器。
+     * a11y 注意：默认触发框携带的 role=combobox / aria-expanded / 键盘（↑↓/Enter/Esc）随之移除；
+     * 自定义触发器需自行把必要 aria（role/aria-expanded/aria-controls）与聚焦/键盘事件挂到自绘元素上，
+     * 或复用 params 里透传的 open/toggle/onTriggerKeydown 保持键盘可达。
+     */
+    triggerRender?: Snippet<[
+        {
+            value: OptionValue | OptionValue[] | undefined;
+            selectedOptions: OptionData[];
+            placeholder: string;
+            open: boolean;
+            disabled: boolean;
+            toggle: () => void;
+            onTriggerKeydown: (e: KeyboardEvent) => void;
+        }
+    ]>;
 }
-declare const Select: import("svelte").Component<Props, {}, "open" | "value">;
+declare const Select: import("svelte").Component<Props, {
+    open: () => void;
+    close: () => void;
+    focus: () => void;
+    clearInput: () => void;
+    deselectAll: () => void;
+    selectAll: () => void;
+    search: (value: string) => void;
+    rePosition: () => void;
+}, "value" | "open">;
 type Select = ReturnType<typeof Select>;
 export default Select;
 //# sourceMappingURL=Select.svelte.d.ts.map

package/dist/select/Select.svelte.d.ts.map

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

package/dist/select/meta.d.ts

@@ -15,18 +15,29 @@ export declare const meta: {
         readonly type: "string|number|(string|number)[]";
         readonly default: "undefined";
     }, {
-        readonly name: "options";
+        readonly name: "optionList";
         readonly type: "OptionData[] | OptionGroup[]";
         readonly default: "[]";
-        readonly desc: "选项；含 { label, options:[] } 即分组";
+        readonly desc: "选项；含 { label, options:[] } 即分组（对齐 Semi optionList）";
     }, {
         readonly name: "multiple";
         readonly type: "boolean";
         readonly default: "false";
     }, {
         readonly name: "filter";
+        readonly type: "boolean | ((input, option) => boolean)";
+        readonly default: "false";
+        readonly desc: "true 按 label 本地过滤；函数则自定义过滤逻辑（对齐 Semi）";
+    }, {
+        readonly name: "remote";
         readonly type: "boolean";
         readonly default: "false";
+        readonly desc: "远程搜索：不本地过滤，输入回调 onSearch，由外部更新 optionList（对齐 Semi）";
+    }, {
+        readonly name: "max";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "多选最多可选项数；达上限忽略新增并触发 onExceed（对齐 Semi）";
     }, {
         readonly name: "open";
         readonly type: "boolean";
@@ -40,9 +51,15 @@ export declare const meta: {
         readonly type: "'small'|'default'|'large'";
         readonly default: "default";
     }, {
-        readonly name: "status";
+        readonly name: "validateStatus";
         readonly type: "'default'|'warning'|'error'";
         readonly default: "default";
+        readonly desc: "校验态样式（对齐 Semi validateStatus）";
+    }, {
+        readonly name: "position";
+        readonly type: "Placement";
+        readonly default: "'bottomStart'";
+        readonly desc: "下拉浮层弹出位置（对齐 Semi position）";
     }, {
         readonly name: "placeholder";
         readonly type: "string";
@@ -62,14 +79,25 @@ export declare const meta: {
         readonly type: "string";
         readonly default: "undefined";
         readonly desc: "触发器 id，用于关联外部 <label for=\"...\">";
+    }, {
+        readonly name: "style";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "根容器内联样式，可设 width 等（对齐 Semi style）";
+    }, {
+        readonly name: "class";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "根容器自定义类名（与内置 cd-select 并存，对齐 Semi className）";
     }, {
         readonly name: "disabled";
         readonly type: "boolean";
         readonly default: "false";
     }, {
-        readonly name: "clearable";
+        readonly name: "showClear";
         readonly type: "boolean";
         readonly default: "false";
+        readonly desc: "是否显示清除按钮（对齐 Semi showClear）";
     }, {
         readonly name: "borderless";
         readonly type: "boolean";
@@ -80,6 +108,11 @@ export declare const meta: {
         readonly type: "boolean";
         readonly default: "false";
         readonly desc: "挂载后自动聚焦触发器";
+    }, {
+        readonly name: "autoAdjustOverflow";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "浮层被遮挡时自动翻转方向（映射 use:floating autoAdjust，对齐 Semi）";
     }, {
         readonly name: "maxTagCount";
         readonly type: "number";
@@ -94,12 +127,42 @@ export declare const meta: {
         readonly name: "showRestTagsPopover";
         readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "超出 maxTagCount 时，将 +N 悬停展示剩余 tags（title）";
+        readonly desc: "多选 maxTagCount 折叠出 +N 时，hover +N 用 Popover 浮层展示剩余全部 Tag（对齐 Semi restTagsPopover）";
     }, {
         readonly name: "restTagsPopoverProps";
         readonly type: "object";
         readonly default: "undefined";
-        readonly desc: "透传给 +N 悬停 popover 的参数（预留）";
+        readonly desc: "透传给 +N 悬停 Popover 浮层的配置（spread 到 Popover，可覆盖 position/trigger/spacing 等）";
+    }, {
+        readonly name: "expandRestTagsOnClick";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "多选 maxTagCount 折叠时，浮层打开态下点击 +N 就地展开剩余全部 Tag（纯展示，不改值）";
+    }, {
+        readonly name: "ellipsisTrigger";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "多选且有 maxTagCount 时，对溢出可见 Tag 文本做单行省略（完整文本经 title 查看）";
+    }, {
+        readonly name: "showArrow";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否显示触发器右侧下拉箭头；false 隐藏（suffix 存在时以 suffix 为准）";
+    }, {
+        readonly name: "clickToHide";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "浮层已展开时，点击触发器是否收起浮层";
+    }, {
+        readonly name: "stopPropagation";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "浮层点击是否 stopPropagation（对齐 Semi）";
+    }, {
+        readonly name: "defaultActiveFirstOption";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "打开浮层时默认高亮首个可用选项（键盘 Enter 可直接选中）";
     }, {
         readonly name: "allowCreate";
         readonly type: "boolean";
@@ -111,45 +174,80 @@ export declare const meta: {
         readonly default: "true";
         readonly desc: "多选选中后自动清空搜索词";
     }, {
-        readonly name: "optionLabelProp";
+        readonly name: "searchPosition";
+        readonly type: "'dropdown' | 'trigger'";
+        readonly default: "'trigger'";
+        readonly desc: "搜索框位置（filter 开启时生效）：trigger=输入内联在触发器上就地过滤；dropdown=浮层顶部搜索框（对齐 Semi）";
+    }, {
+        readonly name: "searchPlaceholder";
         readonly type: "string";
-        readonly default: "'label'";
-        readonly desc: "用作回显的字段名";
+        readonly default: "undefined";
+        readonly desc: "搜索框占位文本（对齐 Semi）；缺省走 locale";
     }, {
-        readonly name: "onSearch";
-        readonly type: "(query: string) => void";
+        readonly name: "inputProps";
+        readonly type: "object";
         readonly default: "undefined";
-        readonly desc: "远程搜索（防抖回调，外部更新 options）";
+        readonly desc: "透传给搜索 input 的额外属性（勿传 value/onChange/onFocus 等覆盖内部搜索回调的键）";
     }, {
-        readonly name: "loading";
+        readonly name: "preventScroll";
         readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "远程加载中（显示 spinner）";
+        readonly desc: "autoFocus/命令式聚焦触发器时传入 focus({ preventScroll })，避免页面跳动";
     }, {
-        readonly name: "searchDebounce";
-        readonly type: "number";
-        readonly default: "300";
-        readonly desc: "onSearch 防抖毫秒";
+        readonly name: "insetLabel";
+        readonly type: "string | Snippet";
+        readonly default: "undefined";
+        readonly desc: "内嵌标签：浮入触发器左侧的常驻标签（纯展示，不影响值/过滤）";
+    }, {
+        readonly name: "insetLabelId";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "insetLabel 的 id，经 aria-labelledby 关联触发器 combobox（仅 insetLabel 存在时生效）";
     }, {
-        readonly name: "virtualized";
+        readonly name: "onSearch";
+        readonly type: "(value: string, event?: Event) => void";
+        readonly default: "undefined";
+        readonly desc: "搜索输入回调（对齐 Semi onSearch(value, event)）";
+    }, {
+        readonly name: "loading";
         readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "选项虚拟化：大数据下拉只渲染视口内 option（仅非分组生效，分组时回退全量）";
+        readonly desc: "远程加载中（显示 spinner）";
     }, {
-        readonly name: "optionHeight";
-        readonly type: "number";
-        readonly default: "32";
-        readonly desc: "虚拟化选项行高（px），需与样式实际行高一致";
+        readonly name: "virtualize";
+        readonly type: "{ itemSize?, height?, width? }";
+        readonly default: "undefined";
+        readonly desc: "虚拟化对象（对齐 Semi）：传入即开启（仅非分组），itemSize 行高、height 视口高";
     }, {
         readonly name: "maxHeight";
         readonly type: "number";
-        readonly default: "256";
-        readonly desc: "下拉最大高度（px）；虚拟化时同时作为视口高度";
+        readonly default: "270";
+        readonly desc: "下拉最大高度（px，对齐 Semi）";
     }, {
         readonly name: "dropdownMatchSelectWidth";
         readonly type: "boolean";
         readonly default: "true";
         readonly desc: "浮层宽度是否跟随触发器；false 时浮层自适应内容宽度";
+    }, {
+        readonly name: "dropdownClassName";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "浮层根 div 追加的自定义 className（与内置 cd-select__dropdown 并存）";
+    }, {
+        readonly name: "dropdownStyle";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "浮层根 div 合并的自定义内联样式（勿含 position/transform）";
+    }, {
+        readonly name: "zIndex";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "浮层层级（z-index）；不传由 CSS 层级 token 控制";
+    }, {
+        readonly name: "dropdownMargin";
+        readonly type: "number | { top?, bottom?, left?, right? }";
+        readonly default: "undefined";
+        readonly desc: "浮层与触发器间距(px)，映射到 floating offset；object 按 position 主轴取值";
     }, {
         readonly name: "destroyOnClose";
         readonly type: "boolean";
@@ -165,9 +263,10 @@ export declare const meta: {
         readonly type: "(v: string|number|(string|number)[]) => void";
         readonly default: "undefined";
     }, {
-        readonly name: "onOpenChange";
+        readonly name: "onDropdownVisibleChange";
         readonly type: "(open: boolean) => void";
         readonly default: "undefined";
+        readonly desc: "浮层显隐变化回调（对齐 Semi）";
     }, {
         readonly name: "onSelect";
         readonly type: "(value, option) => void";
@@ -198,16 +297,31 @@ export declare const meta: {
         readonly type: "() => void";
         readonly default: "undefined";
         readonly desc: "触发器失焦时触发";
+    }, {
+        readonly name: "onMouseEnter";
+        readonly type: "(e: MouseEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "触发器鼠标进入回调（对齐 Semi）";
+    }, {
+        readonly name: "onMouseLeave";
+        readonly type: "(e: MouseEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "触发器鼠标离开回调（对齐 Semi）";
     }, {
         readonly name: "onScrollToBottom";
         readonly type: "() => void";
         readonly default: "undefined";
         readonly desc: "浮层列表滚动触底时触发";
+    }, {
+        readonly name: "onListScroll";
+        readonly type: "(e: Event) => void";
+        readonly default: "undefined";
+        readonly desc: "浮层选项列表滚动时触发（携带原生 scroll 事件）";
     }, {
         readonly name: "onExceed";
         readonly type: "(option) => void";
         readonly default: "undefined";
-        readonly desc: "多选超出 maxTagCount 时触发（携带被隐藏的 option）";
+        readonly desc: "多选超出 max/maxTagCount 时触发（携带被隐藏的 option）";
     }, {
         readonly name: "onChangeWithObject";
         readonly type: "(option | option[]) => void";
@@ -229,28 +343,60 @@ export declare const meta: {
     }, {
         readonly name: "emptyContent";
         readonly type: "string | Snippet";
-        readonly desc: "自定义空态内容";
+        readonly desc: "自定义空态内容（对齐 Semi emptyContent）";
+    }, {
+        readonly name: "innerTopSlot";
+        readonly desc: "浮层顶部固定区（inner：滚动列表内部顶端，随 optionList 滚动，对齐 Semi）";
     }, {
-        readonly name: "empty";
-        readonly desc: "自定义空态 Snippet（与 emptyContent 等价）";
+        readonly name: "innerBottomSlot";
+        readonly desc: "浮层底部固定区（inner：滚动列表内部底端，随 optionList 滚动，对齐 Semi）";
     }, {
-        readonly name: "dropdownHeader";
-        readonly desc: "浮层顶部固定区";
+        readonly name: "outerTopSlot";
+        readonly desc: "浮层最外层顶部 slot（outer：与滚动列表平级、滚动区之外，始终固定展现，对齐 Semi）";
     }, {
-        readonly name: "dropdownFooter";
-        readonly desc: "浮层底部固定区";
+        readonly name: "outerBottomSlot";
+        readonly desc: "浮层最外层底部 slot（outer：与滚动列表平级、滚动区之外，始终固定展现，对齐 Semi）";
     }, {
-        readonly name: "option";
-        readonly params: "[{ option, selected, active }]";
-        readonly desc: "自定义单项渲染";
+        readonly name: "renderOptionItem";
+        readonly params: "[{ option, selected, focused, onMouseEnter, onClick }]";
+        readonly desc: "完全自定义候选项渲染（对齐 Semi renderOptionItem）";
     }, {
-        readonly name: "label";
+        readonly name: "renderSelectedItem";
         readonly params: "[{ option }]";
-        readonly desc: "自定义选中值/Tag 渲染";
+        readonly desc: "自定义选中值/Tag 渲染（对齐 Semi renderSelectedItem）";
     }, {
         readonly name: "renderCreateItem";
         readonly params: "[queryString]";
         readonly desc: "自定义\"创建xxx\"项渲染";
+    }, {
+        readonly name: "triggerRender";
+        readonly params: "[{ value, selectedOptions, placeholder, open, disabled, toggle, onTriggerKeydown }]";
+        readonly desc: "完全自定义触发器渲染（替换默认 combobox 触发框）；需自挂 aria/键盘保持可达";
+    }];
+    readonly methods: readonly [{
+        readonly name: "open()";
+        readonly desc: "命令式展开下拉列表（对齐 Semi）";
+    }, {
+        readonly name: "close()";
+        readonly desc: "命令式收起下拉列表（对齐 Semi）";
+    }, {
+        readonly name: "focus()";
+        readonly desc: "命令式聚焦触发器（尊重 preventScroll，对齐 Semi）";
+    }, {
+        readonly name: "clearInput()";
+        readonly desc: "命令式清空搜索框（对齐 Semi）";
+    }, {
+        readonly name: "deselectAll()";
+        readonly desc: "命令式清空所有已选项（对齐 Semi）";
+    }, {
+        readonly name: "selectAll()";
+        readonly desc: "命令式选中所有可选 Option（仅多选，对齐 Semi）";
+    }, {
+        readonly name: "search(value, event?)";
+        readonly desc: "命令式设置搜索值并触发搜索（对齐 Semi）";
+    }, {
+        readonly name: "rePosition()";
+        readonly desc: "命令式触发浮层重新定位（对齐 Semi）";
     }];
     readonly a11y: {
         readonly role: "combobox";

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

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