@chenzy-design/svelte 0.1.0

package/dist/tree-select/TreeSelect.svelte.d.ts

@@ -0,0 +1,229 @@
+import type { Snippet } from 'svelte';
+import { type CheckedStrategy } from '@chenzy-design/core';
+import type { TreeNode, TreeKey } from './types.js';
+type Size = 'small' | 'default' | 'large';
+type Status = 'default' | 'warning' | 'error';
+/** 自定义节点字段名映射（适配任意后端数据结构）。默认 key/label/children。 */
+type FieldNames = {
+    key?: string;
+    label?: string;
+    children?: string;
+};
+interface Props {
+    value?: TreeKey | TreeKey[] | null;
+    defaultValue?: TreeKey | TreeKey[] | null;
+    /**
+     * 树数据源。默认节点字段为 key/label/children；
+     * 用 fieldNames 自定义字段名时可传任意后端结构（如 { id, name, sub }）。
+     */
+    treeData?: TreeNode[];
+    /** 自定义节点字段名映射，如 { key:'id', label:'name', children:'sub' }。默认全部为标准名。 */
+    fieldNames?: FieldNames;
+    open?: boolean;
+    defaultOpen?: boolean;
+    /** 多选：面板节点显示 checkbox + 父子联动，trigger 多 tag 回显 */
+    multiple?: boolean;
+    /** 多选时父子勾选互不影响（无半选） */
+    checkStrictly?: boolean;
+    /**
+     * 多选父子是否级联联动（对齐 Tree）。'related'（默认）父子联动；
+     * 'unRelated' 互不影响（等价 checkStrictly）。checkStrictly=true 强制 unRelated（向后兼容）。
+     */
+    checkRelation?: 'related' | 'unRelated';
+    /**
+     * 多选回填值 / Tag 的收敛策略：'all'（默认，全部勾选节点）、
+     * 'parent'（完全勾选父级折叠为父）、'child'（仅叶子）。仅 related 级联时生效。
+     */
+    showCheckedStrategy?: CheckedStrategy;
+    /** 多选回填 Tag 最大展示数，超出折叠为 +N（仅影响显示，不改 value）。 */
+    maxTagCount?: number;
+    placeholder?: string;
+    size?: Size;
+    status?: Status;
+    disabled?: boolean;
+    clearable?: boolean;
+    leafOnly?: boolean;
+    defaultExpandAll?: boolean;
+    /** 默认展开的节点 key（非受控初始展开集，与 defaultExpandAll 取并集）。 */
+    treeDefaultExpandedKeys?: TreeKey[];
+    /** 面板顶部搜索框过滤节点（命中 + 祖先链可见、高亮命中文本） */
+    filterable?: boolean;
+    /**
+     * 远程搜索：输入仅触发 onSearch（防抖后），不本地过滤（由外部更新 treeData）。
+     * 隐含 filterable 行为（显示搜索框）。默认 false。
+     */
+    remote?: boolean;
+    /** onSearch 防抖毫秒（remote 时生效，默认 300）。 */
+    searchDebounce?: number;
+    /** 远程搜索输入回调（防抖后）。 */
+    onSearch?: (query: string) => void;
+    /** 是否预留节点图标位（icon 提供时渲染在 label 前）。默认 true，与 Tree 对齐。 */
+    showIcon?: boolean;
+    /** 异步加载子节点：展开未加载的非叶子节点时调用，返回该节点的子节点数组。与 Tree 的 loadData 对齐。 */
+    loadData?: (node: TreeNode) => Promise<TreeNode[]>;
+    /** 虚拟滚动：仅渲染视口内的可见节点行，适合大数据树（1000+ 节点）。默认 false（行为不变）。 */
+    virtualized?: boolean;
+    /**
+     * 自动启用虚拟化的可见节点数阈值：可见扁平行数 ≥ 此值时自动开启虚拟化。
+     * 默认 100。virtualized 显式为 true 时强制开启（不看阈值）。
+     */
+    virtualizeThreshold?: number;
+    /** 浮层宽度对齐触发器（min-inline-size = 触发器宽）。默认 true。 */
+    dropdownMatchSelectWidth?: boolean;
+    /** 浮层挂载容器，缺省 ConfigProvider 全局值再回退 document.body。 */
+    getPopupContainer?: () => HTMLElement | null | undefined;
+    /** 关闭即从 DOM 卸载浮层（重开重建）。默认 false：首开后保留 DOM 仅隐藏。 */
+    destroyOnClose?: boolean;
+    /** 虚拟滚动视口高度（px）。virtualized 时生效，默认 224（与默认面板 max-height 一致）。 */
+    height?: number;
+    /** 虚拟滚动行高（px）。virtualized 时生效，默认取 token 行高 32。 */
+    itemHeight?: number;
+    onChange?: (value: TreeKey | TreeKey[] | null) => void;
+    onOpenChange?: (open: boolean) => void;
+    ariaLabel?: string;
+    /** 自定义节点图标（showIcon 为真时渲染在 label 前）；参数含节点与展开态，与 Tree 的 icon 对齐。 */
+    icon?: Snippet<[{
+        node: TreeNode;
+        expanded: boolean;
+        level: number;
+    }]>;
+    /** 无边框模式：trigger 边框透明。默认 false。 */
+    borderless?: boolean;
+    /** trigger 前缀（Snippet 或字符串）。 */
+    prefix?: Snippet | string;
+    /** trigger 后缀（Snippet 或字符串）。 */
+    suffix?: Snippet | string;
+    /** 自定义清除按钮图标 Snippet。 */
+    clearIcon?: Snippet;
+    /**
+     * 自定义展开图标 Snippet（参数 { node, expanded, level }）。
+     * 也可传普通 Snippet（无参数），此时统一渲染同一图标。
+     */
+    expandIcon?: Snippet<[{
+        node: TreeNode;
+        expanded: boolean;
+        level: number;
+    }]>;
+    /** 自定义右侧下拉箭头（expandIcon 的别名） */
+    arrowIcon?: Snippet;
+    /** 显示节点连接线（垂直导引线）。默认 false。 */
+    showLine?: boolean;
+    /** 节点 label 单行省略截断。默认 true（保持原有行为，可关闭以允许换行）。 */
+    labelEllipsis?: boolean;
+    /** 选择框样式 */
+    style?: string;
+    /** 浮层遮挡时自动调整方向（默认 true） */
+    autoAdjustOverflow?: boolean;
+    /** status 的别名 */
+    validateStatus?: 'default' | 'error' | 'warning';
+    /** 失焦回调 */
+    onBlur?: (e: FocusEvent) => void;
+    /** 聚焦回调 */
+    onFocus?: (e: FocusEvent) => void;
+    /** 聚焦时阻止滚动 */
+    preventScroll?: boolean;
+    /** 面板顶部外层 slot（在搜索框之上）。 */
+    outerTopSlot?: Snippet;
+    /** 面板底部外层 slot（在树之下）。 */
+    outerBottomSlot?: Snippet;
+    /** 面板打开时搜索框自动获焦。默认 false。 */
+    searchAutoFocus?: boolean;
+    /** 搜索框位置：'dropdown'（面板内，默认）或 'trigger'（trigger 内）。 */
+    searchPosition?: 'dropdown' | 'trigger';
+    /** 搜索框占位文字 */
+    searchPlaceholder?: string;
+    /** 搜索过滤属性（默认 'label'） */
+    treeNodeFilterProp?: string;
+    /** 搜索框右侧显示清除按钮（有内容时）。默认 true。 */
+    showSearchClear?: boolean;
+    /** 搜索激活时仅显示命中节点，不显示祖先链。默认 false。 */
+    showFilteredOnly?: boolean;
+    /** 受控展开的节点 keys */
+    expandedKeys?: TreeKey[];
+    /** 动态全部展开（与 defaultExpandAll 不同，此为受控/动态）。默认 false。 */
+    expandAll?: boolean;
+    /** 行点击展开方式：false（仅展开按钮触发）、'click'（单击行）、'doubleClick'（双击行）。默认 false。 */
+    expandAction?: false | 'click' | 'doubleClick';
+    /** 展开节点时自动展开其所有祖先链。默认 false。 */
+    autoExpandParent?: boolean;
+    /** 展开/折叠动画。默认 true。 */
+    motionExpand?: boolean;
+    /** 节点展开回调 */
+    onExpand?: (expandedKeys: TreeKey[], info: {
+        expanded: boolean;
+        node: unknown;
+    }) => void;
+    /**
+     * 自动合并值：父节点全选时 value 不再包含其后代（等价 showCheckedStrategy='parent'）。
+     * 默认 true。autoMergeValue=false 时 showCheckedStrategy 原始生效。
+     */
+    autoMergeValue?: boolean;
+    /** onChange 回调携带完整节点对象而非仅 key。默认 false。 */
+    onChangeWithObject?: boolean;
+    /** 超出 maxTagCount 折叠的 tag 以 popover 形式展示剩余项。默认 false。 */
+    showRestTagsPopover?: boolean;
+    /** 传给剩余 tags popover 的额外 props。 */
+    restTagsPopoverProps?: Record<string, unknown>;
+    /** trigger 多选 tags 换行显示（默认单行截断折叠）。默认 false。 */
+    triggerTagWrap?: boolean;
+    /** 自定义节点 label 渲染（仅替换文字部分，保留 checkbox/icon/expand 等）。 */
+    renderLabel?: Snippet<[{
+        label: string;
+        data: TreeNode;
+        searchWord: string;
+    }]>;
+    /** 完全自定义节点行渲染（替换整行内容）。 */
+    renderFullLabel?: Snippet<[{
+        node: TreeNode;
+        expanded: boolean;
+        level: number;
+        checked: boolean;
+        halfChecked: boolean;
+        selected: boolean;
+    }]>;
+    /** 自定义 trigger 已选 tag 渲染（多选时每个 tag 独立渲染）。 */
+    renderSelectedItem?: Snippet<[{
+        node: TreeNode;
+        onRemove: () => void;
+    }]>;
+    /** 节点数据中用作显示 label 的字段名（默认 'label'）。 */
+    treeNodeLabelProp?: string;
+    /** 自定义 key/label/value 字段映射（优先级高于 fieldNames 的 key/label 部分）。 */
+    keyMaps?: {
+        key?: string;
+        label?: string;
+        value?: string;
+    };
+    /** 选项列表容器的内联 style（字符串或对象形式）。 */
+    optionListStyle?: string | Record<string, string>;
+    /** 受控已加载的节点 keys */
+    loadedKeys?: Set<TreeKey>;
+    /** 单选选中后自动关闭面板。默认 true。 */
+    clickToHide?: boolean;
+    /** 面板开启时点击 trigger 关闭面板。默认 true。 */
+    clickTriggerToHide?: boolean;
+    /**
+     * 严格禁用：disabled 节点不因父节点联动而影响，禁用态独立（不传播给子节点）。
+     * 默认 false（父禁用 conduct 不检查子）。
+     */
+    disableStrictly?: boolean;
+    /** 浮层与 trigger 的额外间距（px），数字或四方向对象。 */
+    dropdownMargin?: number | {
+        marginTop?: number;
+        marginBottom?: number;
+        marginLeft?: number;
+        marginRight?: number;
+    };
+    /** 点击清除按钮回调。 */
+    onClear?: (e: MouseEvent) => void;
+    /** 节点选中回调 */
+    onSelect?: (selectedKey: TreeKey, selected: boolean, node: unknown) => void;
+    /** 异步加载完成回调（含已加载 key 集合与当前节点）。 */
+    onLoad?: (loadedKeys: TreeKey[], treeNode: TreeNode) => void;
+    /** 面板可见性变化回调（与 onOpenChange 语义相同，Semi 风格别名）。 */
+    onVisibleChange?: (isVisible: boolean) => void;
+}
+declare const TreeSelect: import("svelte").Component<Props, {}, "">;
+type TreeSelect = ReturnType<typeof TreeSelect>;
+export default TreeSelect;
+//# sourceMappingURL=TreeSelect.svelte.d.ts.map

package/dist/tree-select/TreeSelect.svelte.d.ts.map

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

package/dist/tree-select/TreeSelectKbdFixture.svelte

@@ -0,0 +1,20 @@
+<!--
+  仅供 TreeSelect.kbd.test.ts（browser project）使用的键盘 e2e 夹具。
+  TreeSelect 浮层 portal 到 document.body；高亮走 aria-activedescendant
+  （焦点留在 role=combobox 触发器上，方向键在可见树上 roving，treeitem tabindex=-1）。
+  用三个顶层叶子节点，使初始可见列表稳定（无展开态干扰）。
+-->
+<script lang="ts">
+  import { LocaleProvider } from '../locale-provider/index.js';
+  import TreeSelect from './TreeSelect.svelte';
+
+  const treeData = [
+    { key: 'a', label: 'Apple' },
+    { key: 'b', label: 'Banana' },
+    { key: 'c', label: 'Cherry' },
+  ];
+</script>
+
+<LocaleProvider locale="en_US">
+  <TreeSelect {treeData} ariaLabel="Fruit tree" placeholder="Pick a fruit" />
+</LocaleProvider>

package/dist/tree-select/TreeSelectKbdFixture.svelte.d.ts

@@ -0,0 +1,19 @@
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}
+declare const TreeSelectKbdFixture: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type TreeSelectKbdFixture = InstanceType<typeof TreeSelectKbdFixture>;
+export default TreeSelectKbdFixture;
+//# sourceMappingURL=TreeSelectKbdFixture.svelte.d.ts.map

package/dist/tree-select/TreeSelectKbdFixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSelectKbdFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/tree-select/TreeSelectKbdFixture.svelte.ts"],"names":[],"mappings":"AAwBA,UAAU,kCAAkC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,MAAM;IACpM,KAAK,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,KAAK,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;IACjK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAA;KAAC,GAAG,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IACtG,YAAY,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAKD,QAAA,MAAM,oBAAoB;;kBAA+E,CAAC;AACxF,KAAK,oBAAoB,GAAG,YAAY,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACxE,eAAe,oBAAoB,CAAC"}

package/dist/tree-select/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tree-select/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,IAAI,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/tree-select/index.js

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

package/dist/tree-select/meta.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export declare const meta: {
+    readonly name: "TreeSelect";
+    readonly category: "input";
+    readonly description: "树形选择器，单面板可展开/收起的树，单选叶子或任意节点。";
+    readonly props: readonly [{
+        readonly name: "value";
+        readonly type: "TreeKey|TreeKey[]|null";
+        readonly default: "undefined";
+    }, {
+        readonly name: "defaultValue";
+        readonly type: "TreeKey|TreeKey[]|null";
+        readonly default: "null";
+    }, {
+        readonly name: "treeData";
+        readonly type: "TreeNode[]";
+        readonly default: "[]";
+        readonly desc: "树数据源；字段名可经 fieldNames 自定义";
+    }, {
+        readonly name: "fieldNames";
+        readonly type: "{ key?: string; label?: string; children?: string }";
+        readonly default: "{ key:'key', label:'label', children:'children' }";
+        readonly desc: "自定义节点字段名映射，适配任意后端数据（如 { key:'id', label:'name', children:'sub' }）。派生只读映射；onChange 回传的 key 即原始字段值";
+    }, {
+        readonly name: "open";
+        readonly type: "boolean";
+        readonly default: "undefined";
+    }, {
+        readonly name: "defaultOpen";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "multiple";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "checkbox 多选 + 父子联动，多 tag 回显";
+    }, {
+        readonly name: "checkStrictly";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "多选时父子勾选互不影响（向后兼容，等价 checkRelation=unRelated）";
+    }, {
+        readonly name: "checkRelation";
+        readonly type: "'related'|'unRelated'";
+        readonly default: "'related'";
+        readonly desc: "多选父子是否级联联动；unRelated 互不影响。checkStrictly=true 强制 unRelated";
+    }, {
+        readonly name: "showCheckedStrategy";
+        readonly type: "'all'|'parent'|'child'";
+        readonly default: "'all'";
+        readonly desc: "回填值/Tag 收敛策略：all 全部勾选节点；parent 折叠为父；child 仅叶子。仅 related 生效";
+    }, {
+        readonly name: "maxTagCount";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "多选回填 Tag 最大展示数，超出折叠为 +N（仅影响显示）";
+    }, {
+        readonly name: "placeholder";
+        readonly type: "string";
+        readonly default: "'请选择'";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "default";
+    }, {
+        readonly name: "status";
+        readonly type: "'default'|'warning'|'error'";
+        readonly default: "default";
+    }, {
+        readonly name: "disabled";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "clearable";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "leafOnly";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "defaultExpandAll";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "treeDefaultExpandedKeys";
+        readonly type: "TreeKey[]";
+        readonly default: "[]";
+        readonly desc: "默认展开的节点 key（非受控初始展开集，与 defaultExpandAll 取并集）";
+    }, {
+        readonly name: "filterable";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "面板搜索框过滤节点 + 高亮命中";
+    }, {
+        readonly name: "remote";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "远程搜索：输入防抖后仅触发 onSearch，不本地过滤（外部更新 treeData）";
+    }, {
+        readonly name: "searchDebounce";
+        readonly type: "number";
+        readonly default: "300";
+        readonly desc: "onSearch 防抖毫秒（remote 时生效）";
+    }, {
+        readonly name: "onSearch";
+        readonly type: "(query: string) => void";
+        readonly default: "undefined";
+        readonly desc: "远程搜索输入回调（防抖后）";
+    }, {
+        readonly name: "showIcon";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否预留节点图标位（icon 提供时渲染在 label 前），与 Tree 对齐";
+    }, {
+        readonly name: "loadData";
+        readonly type: "(node: TreeNode) => Promise<TreeNode[]>";
+        readonly default: "undefined";
+        readonly desc: "异步加载子节点：展开未加载的非叶子节点时调用，返回该节点子节点数组（加载中显示 spinner，竞态去重，不写回 treeData）。与 Tree 的 loadData 对齐";
+    }, {
+        readonly name: "virtualized";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "虚拟滚动：仅渲染视口内可见行，适合大数据树。复用 Tree 范式（core fixedRange），保持 role=tree/treeitem 语义";
+    }, {
+        readonly name: "height";
+        readonly type: "number";
+        readonly default: "224";
+        readonly desc: "虚拟滚动视口高度（px），virtualized 时生效";
+    }, {
+        readonly name: "itemHeight";
+        readonly type: "number";
+        readonly default: "32";
+        readonly desc: "虚拟滚动行高（px），virtualized 时生效";
+    }, {
+        readonly name: "icon";
+        readonly type: "Snippet<[{ node: TreeNode; expanded: boolean; level: number }]>";
+        readonly default: "undefined";
+        readonly desc: "自定义节点图标，showIcon 为真时渲染在 label 前；参数含节点与展开态，与 Tree 的 icon API 对齐";
+    }, {
+        readonly name: "onChange";
+        readonly type: "(value: TreeKey|TreeKey[]|null) => void";
+        readonly default: "undefined";
+        readonly desc: "多选返回 checked 全集数组，单选返回单 key";
+    }, {
+        readonly name: "onOpenChange";
+        readonly type: "(open: boolean) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "ariaLabel";
+        readonly type: "string";
+        readonly default: "undefined";
+    }];
+    readonly a11y: {
+        readonly role: "combobox";
+        readonly notes: readonly ["combobox 触发器 + role=\"tree\" 面板 + role=\"treeitem\"", "有 children 节点 aria-expanded 标记展开态", "aria-selected 标记选中节点", "leafOnly 时非叶子节点仅切换展开，不可选"];
+    };
+    readonly tokens: readonly ["--cd-select-*", "--cd-tree-*", "--cd-focus-ring"];
+};
+//# sourceMappingURL=meta.d.ts.map

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

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

package/dist/tree-select/meta.js

@@ -0,0 +1,73 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export const meta = {
+    name: 'TreeSelect',
+    category: 'input',
+    description: '树形选择器，单面板可展开/收起的树，单选叶子或任意节点。',
+    props: [
+        { name: 'value', type: 'TreeKey|TreeKey[]|null', default: 'undefined' },
+        { name: 'defaultValue', type: 'TreeKey|TreeKey[]|null', default: 'null' },
+        { name: 'treeData', type: 'TreeNode[]', default: '[]', desc: '树数据源；字段名可经 fieldNames 自定义' },
+        {
+            name: 'fieldNames',
+            type: '{ key?: string; label?: string; children?: string }',
+            default: "{ key:'key', label:'label', children:'children' }",
+            desc: '自定义节点字段名映射，适配任意后端数据（如 { key:\'id\', label:\'name\', children:\'sub\' }）。派生只读映射；onChange 回传的 key 即原始字段值',
+        },
+        { name: 'open', type: 'boolean', default: 'undefined' },
+        { name: 'defaultOpen', type: 'boolean', default: 'false' },
+        { name: 'multiple', type: 'boolean', default: 'false', desc: 'checkbox 多选 + 父子联动，多 tag 回显' },
+        { name: 'checkStrictly', type: 'boolean', default: 'false', desc: '多选时父子勾选互不影响（向后兼容，等价 checkRelation=unRelated）' },
+        { name: 'checkRelation', type: "'related'|'unRelated'", default: "'related'", desc: '多选父子是否级联联动；unRelated 互不影响。checkStrictly=true 强制 unRelated' },
+        { name: 'showCheckedStrategy', type: "'all'|'parent'|'child'", default: "'all'", desc: '回填值/Tag 收敛策略：all 全部勾选节点；parent 折叠为父；child 仅叶子。仅 related 生效' },
+        { name: 'maxTagCount', type: 'number', default: 'undefined', desc: '多选回填 Tag 最大展示数，超出折叠为 +N（仅影响显示）' },
+        { name: 'placeholder', type: 'string', default: "'请选择'" },
+        { name: 'size', type: "'small'|'default'|'large'", default: 'default' },
+        { name: 'status', type: "'default'|'warning'|'error'", default: 'default' },
+        { name: 'disabled', type: 'boolean', default: 'false' },
+        { name: 'clearable', type: 'boolean', default: 'false' },
+        { name: 'leafOnly', type: 'boolean', default: 'false' },
+        { name: 'defaultExpandAll', type: 'boolean', default: 'false' },
+        { name: 'treeDefaultExpandedKeys', type: 'TreeKey[]', default: '[]', desc: '默认展开的节点 key（非受控初始展开集，与 defaultExpandAll 取并集）' },
+        { name: 'filterable', type: 'boolean', default: 'false', desc: '面板搜索框过滤节点 + 高亮命中' },
+        { name: 'remote', type: 'boolean', default: 'false', desc: '远程搜索：输入防抖后仅触发 onSearch，不本地过滤（外部更新 treeData）' },
+        { name: 'searchDebounce', type: 'number', default: '300', desc: 'onSearch 防抖毫秒（remote 时生效）' },
+        { name: 'onSearch', type: '(query: string) => void', default: 'undefined', desc: '远程搜索输入回调（防抖后）' },
+        { name: 'showIcon', type: 'boolean', default: 'true', desc: '是否预留节点图标位（icon 提供时渲染在 label 前），与 Tree 对齐' },
+        {
+            name: 'loadData',
+            type: '(node: TreeNode) => Promise<TreeNode[]>',
+            default: 'undefined',
+            desc: '异步加载子节点：展开未加载的非叶子节点时调用，返回该节点子节点数组（加载中显示 spinner，竞态去重，不写回 treeData）。与 Tree 的 loadData 对齐',
+        },
+        { name: 'virtualized', type: 'boolean', default: 'false', desc: '虚拟滚动：仅渲染视口内可见行，适合大数据树。复用 Tree 范式（core fixedRange），保持 role=tree/treeitem 语义' },
+        { name: 'height', type: 'number', default: '224', desc: '虚拟滚动视口高度（px），virtualized 时生效' },
+        { name: 'itemHeight', type: 'number', default: '32', desc: '虚拟滚动行高（px），virtualized 时生效' },
+        {
+            name: 'icon',
+            type: 'Snippet<[{ node: TreeNode; expanded: boolean; level: number }]>',
+            default: 'undefined',
+            desc: '自定义节点图标，showIcon 为真时渲染在 label 前；参数含节点与展开态，与 Tree 的 icon API 对齐',
+        },
+        {
+            name: 'onChange',
+            type: '(value: TreeKey|TreeKey[]|null) => void',
+            default: 'undefined',
+            desc: '多选返回 checked 全集数组，单选返回单 key',
+        },
+        { name: 'onOpenChange', type: '(open: boolean) => void', default: 'undefined' },
+        { name: 'ariaLabel', type: 'string', default: 'undefined' },
+    ],
+    a11y: {
+        role: 'combobox',
+        notes: [
+            'combobox 触发器 + role="tree" 面板 + role="treeitem"',
+            '有 children 节点 aria-expanded 标记展开态',
+            'aria-selected 标记选中节点',
+            'leafOnly 时非叶子节点仅切换展开，不可选',
+        ],
+    },
+    tokens: ['--cd-select-*', '--cd-tree-*', '--cd-focus-ring'],
+};

package/dist/tree-select/types.d.ts

@@ -0,0 +1,11 @@
+/** TreeSelect 节点键类型。 */
+export type TreeKey = string | number;
+/** TreeSelect 树形节点数据结构。 */
+export interface TreeNode {
+    key: TreeKey;
+    label: string;
+    disabled?: boolean;
+    isLeaf?: boolean;
+    children?: TreeNode[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tree-select/types.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtC,2BAA2B;AAC3B,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB"}

package/dist/tree-select/types.js

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

package/dist/tree-select/virtual.test.d.ts

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

package/dist/tree-select/virtual.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual.test.d.ts","sourceRoot":"","sources":["../../src/tree-select/virtual.test.ts"],"names":[],"mappings":""}