@chenzy-design/svelte 0.1.0

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

@@ -0,0 +1,128 @@
+import type { Snippet } from 'svelte';
+import { type Placement } from '@chenzy-design/core';
+type OptionValue = string | number;
+type OptionData = {
+    label: string;
+    value: OptionValue;
+    disabled?: boolean;
+    [key: string]: unknown;
+};
+/** 选项分组：含 options 即为分组项 */
+type OptionGroup = {
+    label: string;
+    options: OptionData[];
+};
+type OptionOrGroup = OptionData | OptionGroup;
+type Size = 'small' | 'default' | 'large';
+type Status = 'default' | 'warning' | 'error';
+interface Props {
+    value?: OptionValue | OptionValue[];
+    defaultValue?: OptionValue | OptionValue[];
+    /** 选项；可含分组项 { label, options: [] } */
+    options?: OptionOrGroup[];
+    multiple?: boolean;
+    filter?: boolean;
+    open?: boolean;
+    defaultOpen?: boolean;
+    size?: Size;
+    status?: Status;
+    /** 下拉浮层 placement（默认 bottomStart，自动避让仍生效） */
+    placement?: Placement;
+    placeholder?: string;
+    /** combobox 触发器可访问名；缺省回退到 placeholder 或 locale 默认 */
+    ariaLabel?: string;
+    /** 关联外部 label 的 id（优先于 ariaLabel） */
+    ariaLabelledby?: string;
+    /** 绑定到触发器的 id 属性，用于关联外部 <label for="..."> */
+    id?: string;
+    disabled?: boolean;
+    clearable?: boolean;
+    /** 多选 tag 最大显示数，超出折叠为 +N（0=不折叠） */
+    maxTagCount?: number;
+    /** 多选单个 Tag 文本最大长度，超出截断为「前缀…」，完整文本经 title 查看（不截则不传） */
+    maxTagTextLength?: number;
+    /** filter 无匹配时允许创建新选项（值=输入文本） */
+    allowCreate?: boolean;
+    /** 远程搜索：输入防抖后回调（由外部更新 options，不再本地过滤） */
+    onSearch?: (query: string) => void;
+    /** 远程加载中（显示 spinner） */
+    loading?: boolean;
+    /** onSearch 防抖毫秒（默认 300） */
+    searchDebounce?: number;
+    /** 选项虚拟化：大数据下拉只渲染视口内 option（仅非分组生效，默认 false） */
+    virtualized?: boolean;
+    /** 虚拟化选项行高（px，默认 32）；需与样式实际行高一致 */
+    optionHeight?: number;
+    /** 下拉最大高度（px，默认 256）；虚拟化时同时作为视口高度 */
+    maxHeight?: number;
+    /** 浮层宽度是否跟随触发器（默认 true）；false 时浮层自适应内容宽度 */
+    dropdownMatchSelectWidth?: boolean;
+    /** 关闭时销毁浮层 DOM（默认 false，复用节点避免重建开销） */
+    destroyOnClose?: boolean;
+    /** 浮层挂载目标容器（默认 body） */
+    getPopupContainer?: () => HTMLElement;
+    /** 无边框模式：移除触发器边框 */
+    borderless?: boolean;
+    /** 挂载后自动聚焦触发器 */
+    autoFocus?: boolean;
+    /** 多选选中后自动清空搜索词（默认 true） */
+    autoClearSearchValue?: boolean;
+    /** 超出 maxTagCount 时，将 +N 悬停展示剩余 tags（title tooltip） */
+    showRestTagsPopover?: boolean;
+    /** 透传给 +N 悬停 popover 的参数（预留，当前通过 title 实现） */
+    restTagsPopoverProps?: Record<string, unknown>;
+    /** 用作回显的字段名（默认 'label'）；当选项含自定义字段时取对应值作显示文本 */
+    optionLabelProp?: string;
+    onChange?: (v: OptionValue | OptionValue[]) => void;
+    onOpenChange?: (open: boolean) => void;
+    /** 选中某项时触发（多选：每次单个 toggle 选中时；单选：选中时） */
+    onSelect?: (value: OptionValue, option: OptionData) => void;
+    /** 多选取消某项时触发 */
+    onDeselect?: (value: OptionValue, option: OptionData) => void;
+    /** 点击清除按钮时触发 */
+    onClear?: () => void;
+    /** allowCreate 创建新项时触发 */
+    onCreate?: (value: string) => void;
+    /** 触发器获焦时触发 */
+    onFocus?: () => void;
+    /** 触发器失焦时触发 */
+    onBlur?: () => void;
+    /** 浮层列表滚动触底时触发 */
+    onScrollToBottom?: () => void;
+    /** 多选超出 maxTagCount 时触发（携带被隐藏的 option） */
+    onExceed?: (option: OptionData) => void;
+    /** 携带完整 option 对象的 change 回调（单选 OptionData；多选 OptionData[]） */
+    onChangeWithObject?: (option: OptionData | OptionData[]) => void;
+    /** 触发器左侧前缀 */
+    prefix?: Snippet;
+    /** 触发器右侧后缀（覆盖默认箭头区域） */
+    suffix?: Snippet;
+    /** 自定义清除按钮图标 */
+    clearIcon?: Snippet;
+    /** 自定义下拉箭头图标 */
+    arrowIcon?: Snippet;
+    /** 自定义空态内容（字符串或 Snippet 均可，为字符串时直接渲染文本） */
+    emptyContent?: string | Snippet;
+    /** 自定义空态 snippet（与 emptyContent 等价，优先级同） */
+    empty?: Snippet;
+    /** 浮层顶部固定区 */
+    dropdownHeader?: Snippet;
+    /** 浮层底部固定区 */
+    dropdownFooter?: Snippet;
+    /** 自定义单项渲染 */
+    option?: Snippet<[{
+        option: OptionData;
+        selected: boolean;
+        active: boolean;
+    }]>;
+    /** 自定义选中值/Tag 渲染 */
+    label?: Snippet<[{
+        option: OptionData;
+    }]>;
+    /** 自定义"创建xxx"项渲染 */
+    renderCreateItem?: Snippet<[string]>;
+}
+declare const Select: import("svelte").Component<Props, {}, "open" | "value">;
+type Select = ReturnType<typeof Select>;
+export default Select;
+//# sourceMappingURL=Select.svelte.d.ts.map

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

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

package/dist/select/SelectKbdFixture.svelte

@@ -0,0 +1,29 @@
+<!--
+  仅供 Select.kbd.test.ts（browser project）使用的键盘 e2e 夹具。
+  Select 浮层 portal 到 document.body；高亮走 aria-activedescendant（焦点留在
+  role=combobox 触发器上不动，由 aria-activedescendant 指向高亮 option）。
+  夹具暴露 onChange 写入 lastValue，供测试断言 Enter 选中。
+-->
+<script lang="ts">
+  import { LocaleProvider } from '../locale-provider/index.js';
+  import Select from './Select.svelte';
+
+  const options = [
+    { label: 'Apple', value: 'apple' },
+    { label: 'Banana', value: 'banana' },
+    { label: 'Cherry', value: 'cherry' },
+  ];
+
+  let lastValue = $state<unknown>(undefined);
+</script>
+
+<LocaleProvider locale="en_US">
+  <Select
+    {options}
+    ariaLabel="Fruit"
+    onChange={(v) => {
+      lastValue = v;
+    }}
+  />
+  <output data-testid="value">{JSON.stringify(lastValue ?? null)}</output>
+</LocaleProvider>

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

@@ -0,0 +1,4 @@
+declare const SelectKbdFixture: import("svelte").Component<Record<string, never>, {}, "">;
+type SelectKbdFixture = ReturnType<typeof SelectKbdFixture>;
+export default SelectKbdFixture;
+//# sourceMappingURL=SelectKbdFixture.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SelectKbdFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/select/SelectKbdFixture.svelte.ts"],"names":[],"mappings":"AA6BA,QAAA,MAAM,gBAAgB,2DAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}

package/dist/select/index.d.ts

@@ -0,0 +1,4 @@
+export { default as Select } from './Select.svelte';
+export { meta as selectMeta } from './meta.js';
+export type { OptionData } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/select/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/select/index.js

@@ -0,0 +1,2 @@
+export { default as Select } from './Select.svelte';
+export { meta as selectMeta } from './meta.js';

package/dist/select/meta.d.ts

@@ -0,0 +1,261 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export declare const meta: {
+    readonly name: "Select";
+    readonly category: "input";
+    readonly description: "下拉选择器，支持单选 / 多选 / 本地过滤 / 键盘导航 / 浮层。";
+    readonly props: readonly [{
+        readonly name: "value";
+        readonly type: "string|number|(string|number)[]";
+        readonly default: "undefined";
+    }, {
+        readonly name: "defaultValue";
+        readonly type: "string|number|(string|number)[]";
+        readonly default: "undefined";
+    }, {
+        readonly name: "options";
+        readonly type: "OptionData[] | OptionGroup[]";
+        readonly default: "[]";
+        readonly desc: "选项；含 { label, options:[] } 即分组";
+    }, {
+        readonly name: "multiple";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "filter";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "open";
+        readonly type: "boolean";
+        readonly default: "undefined";
+    }, {
+        readonly name: "defaultOpen";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "default";
+    }, {
+        readonly name: "status";
+        readonly type: "'default'|'warning'|'error'";
+        readonly default: "default";
+    }, {
+        readonly name: "placeholder";
+        readonly type: "string";
+        readonly default: "'请选择'";
+    }, {
+        readonly name: "ariaLabel";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "combobox 触发器可访问名";
+    }, {
+        readonly name: "ariaLabelledby";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "关联外部 label 的 id（优先于 ariaLabel）";
+    }, {
+        readonly name: "id";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "触发器 id，用于关联外部 <label for=\"...\">";
+    }, {
+        readonly name: "disabled";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "clearable";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "borderless";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "无边框模式";
+    }, {
+        readonly name: "autoFocus";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "挂载后自动聚焦触发器";
+    }, {
+        readonly name: "maxTagCount";
+        readonly type: "number";
+        readonly default: "0";
+        readonly desc: "多选 tag 超出折叠为 +N（0=不折叠）";
+    }, {
+        readonly name: "maxTagTextLength";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "单个 Tag 文本最大长度，超出截断为「前缀…」，完整文本经 title 查看";
+    }, {
+        readonly name: "showRestTagsPopover";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "超出 maxTagCount 时，将 +N 悬停展示剩余 tags（title）";
+    }, {
+        readonly name: "restTagsPopoverProps";
+        readonly type: "object";
+        readonly default: "undefined";
+        readonly desc: "透传给 +N 悬停 popover 的参数（预留）";
+    }, {
+        readonly name: "allowCreate";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "filter 无匹配时可创建新选项";
+    }, {
+        readonly name: "autoClearSearchValue";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "多选选中后自动清空搜索词";
+    }, {
+        readonly name: "optionLabelProp";
+        readonly type: "string";
+        readonly default: "'label'";
+        readonly desc: "用作回显的字段名";
+    }, {
+        readonly name: "onSearch";
+        readonly type: "(query: string) => void";
+        readonly default: "undefined";
+        readonly desc: "远程搜索（防抖回调，外部更新 options）";
+    }, {
+        readonly name: "loading";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "远程加载中（显示 spinner）";
+    }, {
+        readonly name: "searchDebounce";
+        readonly type: "number";
+        readonly default: "300";
+        readonly desc: "onSearch 防抖毫秒";
+    }, {
+        readonly name: "virtualized";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "选项虚拟化：大数据下拉只渲染视口内 option（仅非分组生效，分组时回退全量）";
+    }, {
+        readonly name: "optionHeight";
+        readonly type: "number";
+        readonly default: "32";
+        readonly desc: "虚拟化选项行高（px），需与样式实际行高一致";
+    }, {
+        readonly name: "maxHeight";
+        readonly type: "number";
+        readonly default: "256";
+        readonly desc: "下拉最大高度（px）；虚拟化时同时作为视口高度";
+    }, {
+        readonly name: "dropdownMatchSelectWidth";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "浮层宽度是否跟随触发器；false 时浮层自适应内容宽度";
+    }, {
+        readonly name: "destroyOnClose";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "关闭时销毁浮层 DOM";
+    }, {
+        readonly name: "getPopupContainer";
+        readonly type: "() => HTMLElement";
+        readonly default: "undefined";
+        readonly desc: "浮层挂载目标容器";
+    }, {
+        readonly name: "onChange";
+        readonly type: "(v: string|number|(string|number)[]) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onOpenChange";
+        readonly type: "(open: boolean) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onSelect";
+        readonly type: "(value, option) => void";
+        readonly default: "undefined";
+        readonly desc: "选中某项时触发";
+    }, {
+        readonly name: "onDeselect";
+        readonly type: "(value, option) => void";
+        readonly default: "undefined";
+        readonly desc: "多选取消某项时触发";
+    }, {
+        readonly name: "onClear";
+        readonly type: "() => void";
+        readonly default: "undefined";
+        readonly desc: "点击清除按钮时触发";
+    }, {
+        readonly name: "onCreate";
+        readonly type: "(value: string) => void";
+        readonly default: "undefined";
+        readonly desc: "allowCreate 创建新项时触发";
+    }, {
+        readonly name: "onFocus";
+        readonly type: "() => void";
+        readonly default: "undefined";
+        readonly desc: "触发器获焦时触发";
+    }, {
+        readonly name: "onBlur";
+        readonly type: "() => void";
+        readonly default: "undefined";
+        readonly desc: "触发器失焦时触发";
+    }, {
+        readonly name: "onScrollToBottom";
+        readonly type: "() => void";
+        readonly default: "undefined";
+        readonly desc: "浮层列表滚动触底时触发";
+    }, {
+        readonly name: "onExceed";
+        readonly type: "(option) => void";
+        readonly default: "undefined";
+        readonly desc: "多选超出 maxTagCount 时触发（携带被隐藏的 option）";
+    }, {
+        readonly name: "onChangeWithObject";
+        readonly type: "(option | option[]) => void";
+        readonly default: "undefined";
+        readonly desc: "携带完整 option 对象的 change 回调";
+    }];
+    readonly snippets: readonly [{
+        readonly name: "prefix";
+        readonly desc: "触发器左侧前缀";
+    }, {
+        readonly name: "suffix";
+        readonly desc: "触发器右侧后缀（覆盖默认箭头区域）";
+    }, {
+        readonly name: "clearIcon";
+        readonly desc: "自定义清除按钮图标";
+    }, {
+        readonly name: "arrowIcon";
+        readonly desc: "自定义下拉箭头图标";
+    }, {
+        readonly name: "emptyContent";
+        readonly type: "string | Snippet";
+        readonly desc: "自定义空态内容";
+    }, {
+        readonly name: "empty";
+        readonly desc: "自定义空态 Snippet（与 emptyContent 等价）";
+    }, {
+        readonly name: "dropdownHeader";
+        readonly desc: "浮层顶部固定区";
+    }, {
+        readonly name: "dropdownFooter";
+        readonly desc: "浮层底部固定区";
+    }, {
+        readonly name: "option";
+        readonly params: "[{ option, selected, active }]";
+        readonly desc: "自定义单项渲染";
+    }, {
+        readonly name: "label";
+        readonly params: "[{ option }]";
+        readonly desc: "自定义选中值/Tag 渲染";
+    }, {
+        readonly name: "renderCreateItem";
+        readonly params: "[queryString]";
+        readonly desc: "自定义\"创建xxx\"项渲染";
+    }];
+    readonly a11y: {
+        readonly role: "combobox";
+        readonly notes: readonly ["combobox + listbox + option ARIA 模式", "aria-activedescendant 指向高亮项", "选中项 aria-selected；多选 aria-multiselectable", "键盘：↑↓ 移动、Enter 选中、Esc 关闭"];
+    };
+    readonly tokens: readonly ["--cd-select-*", "--cd-focus-ring", "--cd-motion-*"];
+};
+//# sourceMappingURL=meta.d.ts.map

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

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

package/dist/select/meta.js

@@ -0,0 +1,78 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export const meta = {
+    name: 'Select',
+    category: 'input',
+    description: '下拉选择器，支持单选 / 多选 / 本地过滤 / 键盘导航 / 浮层。',
+    props: [
+        { name: 'value', type: 'string|number|(string|number)[]', default: 'undefined' },
+        { name: 'defaultValue', type: 'string|number|(string|number)[]', default: 'undefined' },
+        { name: 'options', type: 'OptionData[] | OptionGroup[]', default: '[]', desc: '选项；含 { label, options:[] } 即分组' },
+        { name: 'multiple', type: 'boolean', default: 'false' },
+        { name: 'filter', type: 'boolean', default: 'false' },
+        { name: 'open', type: 'boolean', default: 'undefined' },
+        { name: 'defaultOpen', type: 'boolean', default: 'false' },
+        { name: 'size', type: "'small'|'default'|'large'", default: 'default' },
+        { name: 'status', type: "'default'|'warning'|'error'", default: 'default' },
+        { name: 'placeholder', type: 'string', default: "'请选择'" },
+        { name: 'ariaLabel', type: 'string', default: 'undefined', desc: 'combobox 触发器可访问名' },
+        { name: 'ariaLabelledby', type: 'string', default: 'undefined', desc: '关联外部 label 的 id（优先于 ariaLabel）' },
+        { name: 'id', type: 'string', default: 'undefined', desc: '触发器 id，用于关联外部 <label for="...">' },
+        { name: 'disabled', type: 'boolean', default: 'false' },
+        { name: 'clearable', type: 'boolean', default: 'false' },
+        { name: 'borderless', type: 'boolean', default: 'false', desc: '无边框模式' },
+        { name: 'autoFocus', type: 'boolean', default: 'false', desc: '挂载后自动聚焦触发器' },
+        { name: 'maxTagCount', type: 'number', default: '0', desc: '多选 tag 超出折叠为 +N（0=不折叠）' },
+        { name: 'maxTagTextLength', type: 'number', default: 'undefined', desc: '单个 Tag 文本最大长度，超出截断为「前缀…」，完整文本经 title 查看' },
+        { name: 'showRestTagsPopover', type: 'boolean', default: 'false', desc: '超出 maxTagCount 时，将 +N 悬停展示剩余 tags（title）' },
+        { name: 'restTagsPopoverProps', type: 'object', default: 'undefined', desc: '透传给 +N 悬停 popover 的参数（预留）' },
+        { name: 'allowCreate', type: 'boolean', default: 'false', desc: 'filter 无匹配时可创建新选项' },
+        { name: 'autoClearSearchValue', type: 'boolean', default: 'true', desc: '多选选中后自动清空搜索词' },
+        { name: 'optionLabelProp', type: 'string', default: "'label'", desc: '用作回显的字段名' },
+        { name: 'onSearch', type: '(query: string) => void', default: 'undefined', desc: '远程搜索（防抖回调，外部更新 options）' },
+        { name: 'loading', type: 'boolean', default: 'false', desc: '远程加载中（显示 spinner）' },
+        { name: 'searchDebounce', type: 'number', default: '300', desc: 'onSearch 防抖毫秒' },
+        { name: 'virtualized', type: 'boolean', default: 'false', desc: '选项虚拟化：大数据下拉只渲染视口内 option（仅非分组生效，分组时回退全量）' },
+        { name: 'optionHeight', type: 'number', default: '32', desc: '虚拟化选项行高（px），需与样式实际行高一致' },
+        { name: 'maxHeight', type: 'number', default: '256', desc: '下拉最大高度（px）；虚拟化时同时作为视口高度' },
+        { name: 'dropdownMatchSelectWidth', type: 'boolean', default: 'true', desc: '浮层宽度是否跟随触发器；false 时浮层自适应内容宽度' },
+        { name: 'destroyOnClose', type: 'boolean', default: 'false', desc: '关闭时销毁浮层 DOM' },
+        { name: 'getPopupContainer', type: '() => HTMLElement', default: 'undefined', desc: '浮层挂载目标容器' },
+        { name: 'onChange', type: '(v: string|number|(string|number)[]) => void', default: 'undefined' },
+        { name: 'onOpenChange', type: '(open: boolean) => void', default: 'undefined' },
+        { name: 'onSelect', type: '(value, option) => void', default: 'undefined', desc: '选中某项时触发' },
+        { name: 'onDeselect', type: '(value, option) => void', default: 'undefined', desc: '多选取消某项时触发' },
+        { name: 'onClear', type: '() => void', default: 'undefined', desc: '点击清除按钮时触发' },
+        { name: 'onCreate', type: '(value: string) => void', default: 'undefined', desc: 'allowCreate 创建新项时触发' },
+        { name: 'onFocus', type: '() => void', default: 'undefined', desc: '触发器获焦时触发' },
+        { name: 'onBlur', type: '() => void', default: 'undefined', desc: '触发器失焦时触发' },
+        { name: 'onScrollToBottom', type: '() => void', default: 'undefined', desc: '浮层列表滚动触底时触发' },
+        { name: 'onExceed', type: '(option) => void', default: 'undefined', desc: '多选超出 maxTagCount 时触发（携带被隐藏的 option）' },
+        { name: 'onChangeWithObject', type: '(option | option[]) => void', default: 'undefined', desc: '携带完整 option 对象的 change 回调' },
+    ],
+    snippets: [
+        { name: 'prefix', desc: '触发器左侧前缀' },
+        { name: 'suffix', desc: '触发器右侧后缀（覆盖默认箭头区域）' },
+        { name: 'clearIcon', desc: '自定义清除按钮图标' },
+        { name: 'arrowIcon', desc: '自定义下拉箭头图标' },
+        { name: 'emptyContent', type: 'string | Snippet', desc: '自定义空态内容' },
+        { name: 'empty', desc: '自定义空态 Snippet（与 emptyContent 等价）' },
+        { name: 'dropdownHeader', desc: '浮层顶部固定区' },
+        { name: 'dropdownFooter', desc: '浮层底部固定区' },
+        { name: 'option', params: '[{ option, selected, active }]', desc: '自定义单项渲染' },
+        { name: 'label', params: '[{ option }]', desc: '自定义选中值/Tag 渲染' },
+        { name: 'renderCreateItem', params: '[queryString]', desc: '自定义"创建xxx"项渲染' },
+    ],
+    a11y: {
+        role: 'combobox',
+        notes: [
+            'combobox + listbox + option ARIA 模式',
+            'aria-activedescendant 指向高亮项',
+            '选中项 aria-selected；多选 aria-multiselectable',
+            '键盘：↑↓ 移动、Enter 选中、Esc 关闭',
+        ],
+    },
+    tokens: ['--cd-select-*', '--cd-focus-ring', '--cd-motion-*'],
+};

package/dist/select/types.d.ts

@@ -0,0 +1,7 @@
+/** Select 选项数据结构。 */
+export type OptionData = {
+    label: string;
+    value: string | number;
+    disabled?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/select/types.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC"}

package/dist/select/types.js

@@ -0,0 +1 @@
+export {};

package/dist/side-sheet/SideSheet.a11y.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SideSheet.a11y.test.d.ts.map

package/dist/side-sheet/SideSheet.a11y.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SideSheet.a11y.test.d.ts","sourceRoot":"","sources":["../../src/side-sheet/SideSheet.a11y.test.ts"],"names":[],"mappings":""}

package/dist/side-sheet/SideSheet.a11y.test.js

@@ -0,0 +1,46 @@
+// SideSheet a11y：侧边滑出浮层（APG dialog/modal，与 Modal 同构）。
+// role=dialog；mask=true 加 aria-modal=true；有 title 用 aria-labelledby，无则 aria-label。
+// portal 到 body，故扫描 document.body（参照 Modal）。
+// 不测真实 focus-trap/scroll-lock（jsdom 焦点模型不完整），只断言静态 ARIA + axe。
+import { describe, it, expect } from 'vitest';
+import { renderWithLocale, expectNoAxeViolations } from '../test-utils/a11y.js';
+import SideSheet from './SideSheet.svelte';
+describe('SideSheet a11y', () => {
+    it('open + title：role=dialog / aria-modal / aria-labelledby，无 axe violations', async () => {
+        renderWithLocale(SideSheet, {
+            props: { open: true, title: 'Edit user' },
+        });
+        // portal 到 body —— 在 document 全局查询而非 container。
+        const dialog = document.querySelector('[role="dialog"]');
+        expect(dialog).not.toBeNull();
+        // mask 默认 true → 模态。
+        expect(dialog?.getAttribute('aria-modal')).toBe('true');
+        // 有 title 时用 aria-labelledby 指向标题 h2，且该 id 存在。
+        const labelledby = dialog?.getAttribute('aria-labelledby');
+        expect(labelledby).toBeTruthy();
+        const titleEl = labelledby ? document.getElementById(labelledby) : null;
+        expect(titleEl?.textContent).toContain('Edit user');
+        // 关闭按钮 aria-label 来自 en_US locale（验证 LocaleProvider 管线）。
+        const closeBtn = document.querySelector('.cd-sidesheet__close');
+        expect(closeBtn?.getAttribute('aria-label')).toBeTruthy();
+        await expectNoAxeViolations(document.body);
+    });
+    it('无 title + ariaLabel：role=dialog 用 aria-label 提供可访问名', async () => {
+        renderWithLocale(SideSheet, {
+            props: { open: true, ariaLabel: 'Notification center', closable: false },
+        });
+        const dialog = document.querySelector('[role="dialog"]');
+        expect(dialog?.getAttribute('aria-label')).toBe('Notification center');
+        expect(dialog?.getAttribute('aria-labelledby')).toBeNull();
+        await expectNoAxeViolations(document.body);
+    });
+    it('mask=false 非模态：不设 aria-modal（避免误导锁定语义）', async () => {
+        renderWithLocale(SideSheet, {
+            props: { open: true, title: 'Filters', mask: false },
+        });
+        const dialog = document.querySelector('[role="dialog"]');
+        expect(dialog).not.toBeNull();
+        expect(dialog?.getAttribute('aria-modal')).toBeNull();
+        await expectNoAxeViolations(document.body);
+    });
+});

package/dist/side-sheet/SideSheet.kbd.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SideSheet.kbd.test.d.ts.map

package/dist/side-sheet/SideSheet.kbd.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SideSheet.kbd.test.d.ts","sourceRoot":"","sources":["../../src/side-sheet/SideSheet.kbd.test.ts"],"names":[],"mappings":""}