@chenzy-design/svelte 0.1.0

package/dist/tree/Tree.svelte.d.ts

@@ -0,0 +1,164 @@
+import type { Snippet } from 'svelte';
+import { type TreeKey, type TreeNodeData, type DropPosition } from '@chenzy-design/core';
+type Size = 'small' | 'default' | 'large';
+type Status = 'default' | 'warning' | 'error';
+type ChangeInfo = {
+    value: TreeKey | TreeKey[];
+    node: TreeNodeData;
+    selected: boolean;
+};
+type CheckInfo = {
+    checked: TreeKey[];
+    node: TreeNodeData;
+    halfChecked: TreeKey[];
+};
+type ExpandInfo = {
+    expanded: TreeKey[];
+    node: TreeNodeData;
+    expand: boolean;
+};
+type DropInfo = {
+    dragNode: TreeNodeData;
+    dropNode: TreeNodeData;
+    dropPosition: DropPosition;
+};
+/** 自定义节点字段名映射（适配任意后端数据结构）。默认 key/label/children。 */
+type FieldNames = {
+    key?: string;
+    label?: string;
+    children?: string;
+};
+interface Props {
+    /**
+     * 树数据源。默认节点字段为 key/label/children；
+     * 用 fieldNames 自定义字段名时可传任意后端结构（如 { id, name, sub }）。
+     */
+    treeData?: TreeNodeData[];
+    /** 自定义节点字段名映射，如 { key:'id', label:'name', children:'sub' }。默认全部为标准名。 */
+    fieldNames?: FieldNames;
+    value?: TreeKey | TreeKey[] | null;
+    defaultValue?: TreeKey | TreeKey[] | null;
+    multiple?: boolean;
+    checkable?: boolean;
+    checkedKeys?: TreeKey[];
+    defaultCheckedKeys?: TreeKey[];
+    /**
+     * 父子勾选是否联动。'related'（默认）：勾选父全选子、子全选则父选中、部分选中半选；
+     * 'unRelated'：父子勾选互不影响，每个节点独立勾选、无半选态。
+     * 与 checkStrictly 的关系：两者都旁路 conduct 联动算法，效果上 unRelated ≡ checkStrictly 的
+     * 「父子状态独立」。checkRelation 是枚举（对齐 Semi 语义），checkStrictly 是 boolean；
+     * 任一开启（unRelated 或 checkStrictly=true）即关闭父子联动。默认 related + checkStrictly=false 保持联动。
+     */
+    checkRelation?: 'related' | 'unRelated';
+    checkStrictly?: boolean;
+    expandedKeys?: TreeKey[];
+    defaultExpandedKeys?: TreeKey[];
+    defaultExpandAll?: boolean;
+    /**
+     * 默认展开到第 N 层（仅初始化非受控展开集时生效，1 表示展开根层使其子节点可见）。
+     * 优先级低于 defaultExpandAll；与 defaultExpandedKeys 取并集。受控 expandedKeys 时忽略（红线 #1）。
+     */
+    expandedDepth?: number;
+    /**
+     * 受控展开时自动展开父节点：expandedKeys 更新时若 autoExpandParent=true，
+     * 自动把所有展开节点的祖先链也加入展开集（派生，不写回受控 expandedKeys，红线 #1）。
+     * 默认 true，与 Semi Design 行为一致。
+     */
+    autoExpandParent?: boolean;
+    /**
+     * 手风琴模式：同一层级最多展开一个节点。展开某节点时自动收起其同父级（siblings）
+     * 的其它已展开节点；不同层级互不影响。受控 expandedKeys 同样生效（通过 onExpandedChange
+     * 回传收起 siblings 后的新展开集，不自行回写——红线 #1）。默认 false（展开行为不变）。
+     */
+    accordion?: boolean;
+    selectable?: boolean;
+    showIcon?: boolean;
+    /** 显示层级连接线（父子引导线） */
+    showLine?: boolean;
+    /** 虚拟滚动：仅渲染视口内的可见节点行，适合大数据树（1000+ 节点）。默认 false（行为不变） */
+    virtualized?: boolean;
+    /** 虚拟滚动视口高度（px）。virtualized 时生效，默认 320 */
+    height?: number;
+    /** 虚拟滚动行高（px）。virtualized 时生效，默认取 token 行高 32 */
+    itemHeight?: number;
+    filterable?: boolean;
+    /**
+     * 自定义搜索过滤谓词。`(input, node) => boolean` 返回该节点是否命中关键词；
+     * 命中节点的祖先链自动展开（沿用内置过滤行为）。传函数即开启搜索（无需再传 filterable）；
+     * 不传时回退到内置「label 包含关键词（不区分大小写）」。boolean 形态等价于 filterable 开关。
+     */
+    filterTreeNode?: boolean | ((input: string, node: TreeNodeData) => boolean);
+    /**
+     * 受控搜索关键词。传入时走受控模式：搜索框 value 绑定到此 prop，
+     * 输入变化仅触发 onSearch 回调，不更新内部 state。不传则保留内部非受控 state。
+     */
+    searchValue?: string;
+    /**
+     * 搜索关键词变化回调。参数 (value, filteredKeys)：
+     *  - value：当前搜索词；
+     *  - filteredKeys：所有命中节点（matched）的 key 列表，供受控外层决定渲染。
+     */
+    onSearch?: (value: string, filteredKeys: string[]) => void;
+    blockNode?: boolean;
+    disabled?: boolean;
+    size?: Size;
+    status?: Status;
+    emptyContent?: string;
+    ariaLabel?: string;
+    /** 异步加载子节点：展开未加载的非叶子节点时调用，返回该节点的子节点数组 */
+    loadData?: (node: TreeNodeData) => Promise<TreeNodeData[]>;
+    /** 异步加载完成回调 */
+    onLoad?: (loadedKeys: string[], info: {
+        event: 'load';
+        node: TreeNodeData;
+    }) => void;
+    /** 启用 HTML5 拖拽排序：节点可拖动改变层级/顺序。默认 false（行为不变） */
+    draggable?: boolean;
+    /** 放下时回调（受控数据，组件不内部改 treeData，由父组件按 info 重排）。 */
+    onDrop?: (info: DropInfo) => void;
+    /** 节点右键菜单回调 */
+    onRightClick?: (e: MouseEvent, node: TreeNodeData) => void;
+    /** 开始拖拽节点 */
+    onDragStart?: (node: TreeNodeData) => void;
+    /** 拖拽进入候选目标节点 */
+    onDragEnter?: (info: {
+        dragNode: TreeNodeData;
+        dropNode: TreeNodeData;
+    }) => void;
+    onChange?: (info: ChangeInfo) => void;
+    onCheck?: (info: CheckInfo) => void;
+    onExpandedChange?: (info: ExpandInfo) => void;
+    label?: Snippet<[
+        {
+            node: TreeNodeData;
+            level: number;
+            searchValue: string;
+            selected: boolean;
+            checked: boolean;
+        }
+    ]>;
+    /** 自定义节点图标（showIcon 为真时渲染在 label 前）；参数含节点、展开态与是否叶子 */
+    icon?: Snippet<[{
+        node: TreeNodeData;
+        expanded: boolean;
+        isLeaf: boolean;
+    }]>;
+    /** 自定义展开/收起箭头；参数含节点、展开态与加载态 */
+    switcher?: Snippet<[{
+        node: TreeNodeData;
+        expanded: boolean;
+        loading: boolean;
+    }]>;
+    /** 节点尾部操作区（渲染在 label 右侧） */
+    suffix?: Snippet<[{
+        node: TreeNodeData;
+    }]>;
+    /** 自定义拖拽幽灵节点 */
+    dragGhost?: Snippet<[{
+        node: TreeNodeData;
+    }]>;
+}
+declare const Tree: import("svelte").Component<Props, {}, "">;
+type Tree = ReturnType<typeof Tree>;
+export default Tree;
+//# sourceMappingURL=Tree.svelte.d.ts.map

package/dist/tree/Tree.svelte.d.ts.map

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

package/dist/tree/TreeKbdFixture.svelte

@@ -0,0 +1,30 @@
+<!--
+  仅供 Tree.kbd.test.ts（browser project）使用的键盘 e2e 夹具。
+  Tree 高亮走 aria-activedescendant：焦点留在 role=tree 容器（tabindex=0），
+  treeitem tabindex=-1 从不真实聚焦；高亮由容器 aria-activedescendant 指向的
+  treeitem id 表达。顶层为叶子 + 一个可展开父节点，用于 ↑↓/Home/End/typeahead/`*`。
+-->
+<script lang="ts">
+  import { LocaleProvider } from '../locale-provider/index.js';
+  import Tree from './Tree.svelte';
+
+  // 顶层：Apple / Banana / Cherry（叶子）+ Date（可展开，含子）。
+  // typeahead：输入 c 跳到 Cherry、b 跳到 Banana。
+  const treeData = [
+    { key: 'a', label: 'Apple' },
+    { key: 'b', label: 'Banana' },
+    { key: 'c', label: 'Cherry' },
+    {
+      key: 'd',
+      label: 'Date',
+      children: [
+        { key: 'd1', label: 'Deglet' },
+        { key: 'd2', label: 'Medjool' },
+      ],
+    },
+  ];
+</script>
+
+<LocaleProvider locale="en_US">
+  <Tree {treeData} ariaLabel="Fruit tree" />
+</LocaleProvider>

package/dist/tree/TreeKbdFixture.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 TreeKbdFixture: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type TreeKbdFixture = InstanceType<typeof TreeKbdFixture>;
+export default TreeKbdFixture;
+//# sourceMappingURL=TreeKbdFixture.svelte.d.ts.map

package/dist/tree/TreeKbdFixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeKbdFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/tree/TreeKbdFixture.svelte.ts"],"names":[],"mappings":"AAkCA,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,cAAc;;kBAA+E,CAAC;AAClF,KAAK,cAAc,GAAG,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,eAAe,cAAc,CAAC"}

package/dist/tree/index.d.ts

@@ -0,0 +1,4 @@
+export { default as Tree } from './Tree.svelte';
+export { meta as treeMeta } from './meta.js';
+export type { TreeNodeData, TreeKey } from '@chenzy-design/core';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/tree/index.js

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

package/dist/tree/meta.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * Tree — see specs/components/show/Tree.spec.md
+ */
+export declare const meta: {
+    readonly name: "Tree";
+    readonly category: "show";
+    readonly description: "树形控件：层级展示节点，支持展开/收起、单选/多选、可勾选父子联动（含半选 mixed）、内置搜索高亮。受控 value/checkedKeys/expandedKeys 均不回写，仅通过 onChange/onCheck/onExpandedChange 通知。键盘导航遵循 WAI-ARIA APG Tree View（单一 tab stop + aria-activedescendant）。";
+    readonly exports: readonly ["Tree"];
+    readonly props: readonly [{
+        readonly name: "treeData";
+        readonly type: "TreeNodeData[]";
+        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' }）。派生只读映射，回调回传原始节点";
+    }, {
+        readonly name: "value";
+        readonly type: "TreeKey | TreeKey[] | null";
+        readonly default: "undefined";
+        readonly desc: "受控选中；multiple 时为数组。受控时不回写";
+    }, {
+        readonly name: "defaultValue";
+        readonly type: "TreeKey | TreeKey[] | null";
+        readonly default: "null";
+        readonly desc: "非受控初始选中";
+    }, {
+        readonly name: "multiple";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "多选模式";
+    }, {
+        readonly name: "checkable";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "显示勾选框";
+    }, {
+        readonly name: "checkedKeys";
+        readonly type: "TreeKey[]";
+        readonly default: "undefined";
+        readonly desc: "受控勾选；内部用 conduct 归一。受控时不回写";
+    }, {
+        readonly name: "defaultCheckedKeys";
+        readonly type: "TreeKey[]";
+        readonly default: "[]";
+        readonly desc: "非受控初始勾选";
+    }, {
+        readonly name: "checkStrictly";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "true 时父子解耦，仅切换单节点";
+    }, {
+        readonly name: "expandedKeys";
+        readonly type: "TreeKey[]";
+        readonly default: "undefined";
+        readonly desc: "受控展开。受控时不回写";
+    }, {
+        readonly name: "defaultExpandedKeys";
+        readonly type: "TreeKey[]";
+        readonly default: "[]";
+        readonly desc: "非受控初始展开";
+    }, {
+        readonly name: "defaultExpandAll";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "初始展开全部";
+    }, {
+        readonly name: "accordion";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "手风琴模式：同层级最多展开一个，展开节点时自动收起同父级其它节点（不同层级互不影响）。受控 expandedKeys 同样生效，仅经 onExpandedChange 回传新集不回写";
+    }, {
+        readonly name: "selectable";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "节点是否可选中";
+    }, {
+        readonly name: "showIcon";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否预留节点图标位";
+    }, {
+        readonly name: "showLine";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "显示层级连接线（├/└/竖线）";
+    }, {
+        readonly name: "virtualized";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "虚拟滚动：仅渲染视口内可见节点行，适合大数据树（1000+ 节点）";
+    }, {
+        readonly name: "height";
+        readonly type: "number";
+        readonly default: "320";
+        readonly desc: "虚拟滚动视口高度（px），virtualized 时生效";
+    }, {
+        readonly name: "itemHeight";
+        readonly type: "number";
+        readonly default: "32";
+        readonly desc: "虚拟滚动行高（px），virtualized 时生效";
+    }, {
+        readonly name: "filterable";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "渲染内置搜索框";
+    }, {
+        readonly name: "blockNode";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "整行点击选中";
+    }, {
+        readonly name: "disabled";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "整树禁用";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "'default'";
+    }, {
+        readonly name: "status";
+        readonly type: "'default'|'warning'|'error'";
+        readonly default: "'default'";
+    }, {
+        readonly name: "emptyContent";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "空态文案";
+    }, {
+        readonly name: "ariaLabel";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "无障碍标签";
+    }, {
+        readonly name: "loadData";
+        readonly type: "(node) => Promise<TreeNodeData[]>";
+        readonly default: "undefined";
+        readonly desc: "异步加载子节点：展开未加载的非叶子节点时调用";
+    }, {
+        readonly name: "draggable";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "启用 HTML5 拖拽排序：节点可拖动改变层级/顺序（before/inside/after）";
+    }, {
+        readonly name: "onDrop";
+        readonly type: "(info: { dragNode, dropNode, dropPosition }) => void";
+        readonly default: "undefined";
+        readonly desc: "放下时回调；受控数据由父组件按 info 重排 treeData，组件不内部改";
+    }, {
+        readonly name: "onChange";
+        readonly type: "(info) => void";
+        readonly default: "undefined";
+        readonly desc: "选中变更";
+    }, {
+        readonly name: "onCheck";
+        readonly type: "(info) => void";
+        readonly default: "undefined";
+        readonly desc: "勾选变更";
+    }, {
+        readonly name: "onExpandedChange";
+        readonly type: "(info) => void";
+        readonly default: "undefined";
+        readonly desc: "展开变更";
+    }, {
+        readonly name: "label";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "自定义节点内容";
+    }, {
+        readonly name: "icon";
+        readonly type: "Snippet<[{ node, expanded, level }]>";
+        readonly default: "undefined";
+        readonly desc: "自定义节点图标（showIcon 时渲染在 label 前）";
+    }];
+    readonly events: readonly [{
+        readonly name: "onChange";
+        readonly desc: "选中节点变更：{ value, node, selected }";
+    }, {
+        readonly name: "onCheck";
+        readonly desc: "勾选变更：{ checked, node, halfChecked }";
+    }, {
+        readonly name: "onExpandedChange";
+        readonly desc: "展开/收起：{ expanded, node, expand }";
+    }, {
+        readonly name: "onDrop";
+        readonly desc: "拖拽放下：{ dragNode, dropNode, dropPosition: before|inside|after }";
+    }];
+    readonly slots: readonly [{
+        readonly name: "label";
+        readonly desc: "自定义节点渲染：{ node, level, searchValue, selected, checked }";
+    }];
+    readonly a11y: {
+        readonly hasRole: true;
+        readonly focusable: true;
+        readonly note: "role=tree（aria-multiselectable）容器为单一 tab stop，焦点通过 aria-activedescendant 指向当前高亮 treeitem；每行 role=treeitem 含 aria-level/setsize/posinset/expanded/selected/disabled，可勾选时 aria-checked 支持 true/false/\"mixed\"（半选）。方向键导航：↑↓ 移动、→ 展开/进入子、← 折叠/回父、Home/End 首末、Enter 选中、Space 勾选或选中。";
+    };
+    readonly tokens: readonly ["--cd-tree-node-height", "--cd-tree-node-height-small", "--cd-tree-node-height-large", "--cd-tree-indent", "--cd-tree-node-color", "--cd-tree-node-color-disabled", "--cd-tree-node-bg-hover", "--cd-tree-node-bg-selected", "--cd-tree-node-color-selected", "--cd-tree-expand-icon-color", "--cd-tree-search-highlight-bg", "--cd-tree-search-highlight-color", "--cd-tree-focus-ring", "--cd-tree-border-color", "--cd-tree-border-color-warning", "--cd-tree-border-color-error"];
+    readonly responsive: false;
+    readonly examples: readonly [{
+        readonly title: "基础";
+        readonly code: "<Tree treeData={data} defaultExpandAll onChange={(i) => (v = i.value)} />";
+    }, {
+        readonly title: "可勾选联动";
+        readonly code: "<Tree treeData={data} checkable onCheck={(i) => (keys = i.checked)} />";
+    }, {
+        readonly title: "可搜索";
+        readonly code: "<Tree treeData={data} filterable />";
+    }];
+};
+//# sourceMappingURL=meta.d.ts.map

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

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

package/dist/tree/meta.js

@@ -0,0 +1,151 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * Tree — see specs/components/show/Tree.spec.md
+ */
+export const meta = {
+    name: 'Tree',
+    category: 'show',
+    description: '树形控件：层级展示节点，支持展开/收起、单选/多选、可勾选父子联动（含半选 mixed）、内置搜索高亮。受控 value/checkedKeys/expandedKeys 均不回写，仅通过 onChange/onCheck/onExpandedChange 通知。键盘导航遵循 WAI-ARIA APG Tree View（单一 tab stop + aria-activedescendant）。',
+    exports: ['Tree'],
+    props: [
+        { name: 'treeData', type: 'TreeNodeData[]', 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\' }）。派生只读映射，回调回传原始节点',
+        },
+        {
+            name: 'value',
+            type: 'TreeKey | TreeKey[] | null',
+            default: 'undefined',
+            desc: '受控选中；multiple 时为数组。受控时不回写',
+        },
+        {
+            name: 'defaultValue',
+            type: 'TreeKey | TreeKey[] | null',
+            default: 'null',
+            desc: '非受控初始选中',
+        },
+        { name: 'multiple', type: 'boolean', default: 'false', desc: '多选模式' },
+        { name: 'checkable', type: 'boolean', default: 'false', desc: '显示勾选框' },
+        {
+            name: 'checkedKeys',
+            type: 'TreeKey[]',
+            default: 'undefined',
+            desc: '受控勾选；内部用 conduct 归一。受控时不回写',
+        },
+        { name: 'defaultCheckedKeys', type: 'TreeKey[]', default: '[]', desc: '非受控初始勾选' },
+        {
+            name: 'checkStrictly',
+            type: 'boolean',
+            default: 'false',
+            desc: 'true 时父子解耦，仅切换单节点',
+        },
+        {
+            name: 'expandedKeys',
+            type: 'TreeKey[]',
+            default: 'undefined',
+            desc: '受控展开。受控时不回写',
+        },
+        { name: 'defaultExpandedKeys', type: 'TreeKey[]', default: '[]', desc: '非受控初始展开' },
+        { name: 'defaultExpandAll', type: 'boolean', default: 'false', desc: '初始展开全部' },
+        {
+            name: 'accordion',
+            type: 'boolean',
+            default: 'false',
+            desc: '手风琴模式：同层级最多展开一个，展开节点时自动收起同父级其它节点（不同层级互不影响）。受控 expandedKeys 同样生效，仅经 onExpandedChange 回传新集不回写',
+        },
+        { name: 'selectable', type: 'boolean', default: 'true', desc: '节点是否可选中' },
+        { name: 'showIcon', type: 'boolean', default: 'true', desc: '是否预留节点图标位' },
+        { name: 'showLine', type: 'boolean', default: 'false', desc: '显示层级连接线（├/└/竖线）' },
+        {
+            name: 'virtualized',
+            type: 'boolean',
+            default: 'false',
+            desc: '虚拟滚动：仅渲染视口内可见节点行，适合大数据树（1000+ 节点）',
+        },
+        { name: 'height', type: 'number', default: '320', desc: '虚拟滚动视口高度（px），virtualized 时生效' },
+        { name: 'itemHeight', type: 'number', default: '32', desc: '虚拟滚动行高（px），virtualized 时生效' },
+        { name: 'filterable', type: 'boolean', default: 'false', desc: '渲染内置搜索框' },
+        { name: 'blockNode', type: 'boolean', default: 'false', desc: '整行点击选中' },
+        { name: 'disabled', type: 'boolean', default: 'false', desc: '整树禁用' },
+        { name: 'size', type: "'small'|'default'|'large'", default: "'default'" },
+        { name: 'status', type: "'default'|'warning'|'error'", default: "'default'" },
+        { name: 'emptyContent', type: 'string', default: 'undefined', desc: '空态文案' },
+        { name: 'ariaLabel', type: 'string', default: 'undefined', desc: '无障碍标签' },
+        {
+            name: 'loadData',
+            type: '(node) => Promise<TreeNodeData[]>',
+            default: 'undefined',
+            desc: '异步加载子节点：展开未加载的非叶子节点时调用',
+        },
+        {
+            name: 'draggable',
+            type: 'boolean',
+            default: 'false',
+            desc: '启用 HTML5 拖拽排序：节点可拖动改变层级/顺序（before/inside/after）',
+        },
+        {
+            name: 'onDrop',
+            type: '(info: { dragNode, dropNode, dropPosition }) => void',
+            default: 'undefined',
+            desc: '放下时回调；受控数据由父组件按 info 重排 treeData，组件不内部改',
+        },
+        { name: 'onChange', type: '(info) => void', default: 'undefined', desc: '选中变更' },
+        { name: 'onCheck', type: '(info) => void', default: 'undefined', desc: '勾选变更' },
+        {
+            name: 'onExpandedChange',
+            type: '(info) => void',
+            default: 'undefined',
+            desc: '展开变更',
+        },
+        { name: 'label', type: 'Snippet', default: 'undefined', desc: '自定义节点内容' },
+        { name: 'icon', type: 'Snippet<[{ node, expanded, level }]>', default: 'undefined', desc: '自定义节点图标（showIcon 时渲染在 label 前）' },
+    ],
+    events: [
+        { name: 'onChange', desc: '选中节点变更：{ value, node, selected }' },
+        { name: 'onCheck', desc: '勾选变更：{ checked, node, halfChecked }' },
+        { name: 'onExpandedChange', desc: '展开/收起：{ expanded, node, expand }' },
+        { name: 'onDrop', desc: '拖拽放下：{ dragNode, dropNode, dropPosition: before|inside|after }' },
+    ],
+    slots: [{ name: 'label', desc: '自定义节点渲染：{ node, level, searchValue, selected, checked }' }],
+    a11y: {
+        hasRole: true,
+        focusable: true,
+        note: 'role=tree（aria-multiselectable）容器为单一 tab stop，焦点通过 aria-activedescendant 指向当前高亮 treeitem；每行 role=treeitem 含 aria-level/setsize/posinset/expanded/selected/disabled，可勾选时 aria-checked 支持 true/false/"mixed"（半选）。方向键导航：↑↓ 移动、→ 展开/进入子、← 折叠/回父、Home/End 首末、Enter 选中、Space 勾选或选中。',
+    },
+    tokens: [
+        '--cd-tree-node-height',
+        '--cd-tree-node-height-small',
+        '--cd-tree-node-height-large',
+        '--cd-tree-indent',
+        '--cd-tree-node-color',
+        '--cd-tree-node-color-disabled',
+        '--cd-tree-node-bg-hover',
+        '--cd-tree-node-bg-selected',
+        '--cd-tree-node-color-selected',
+        '--cd-tree-expand-icon-color',
+        '--cd-tree-search-highlight-bg',
+        '--cd-tree-search-highlight-color',
+        '--cd-tree-focus-ring',
+        '--cd-tree-border-color',
+        '--cd-tree-border-color-warning',
+        '--cd-tree-border-color-error',
+    ],
+    responsive: false,
+    examples: [
+        {
+            title: '基础',
+            code: '<Tree treeData={data} defaultExpandAll onChange={(i) => (v = i.value)} />',
+        },
+        {
+            title: '可勾选联动',
+            code: '<Tree treeData={data} checkable onCheck={(i) => (keys = i.checked)} />',
+        },
+        {
+            title: '可搜索',
+            code: '<Tree treeData={data} filterable />',
+        },
+    ],
+};

package/dist/tree-select/TreeSelect.a11y.test.d.ts

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

package/dist/tree-select/TreeSelect.a11y.test.d.ts.map

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