@chenzy-design/svelte 0.3.0 → 0.4.1

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

@@ -5,7 +5,7 @@
 export declare const meta: {
     readonly name: "TreeSelect";
     readonly category: "input";
-    readonly description: "树形选择器，单面板可展开/收起的树，单选叶子或任意节点。";
+    readonly description: "树形选择器，单面板可展开/收起的树，单选叶子或任意节点；支持 multiple 多选（checkbox + 父子联动 + 多 tag 回显）、可搜索过滤（本地/远程 + 命中高亮）、异步加载子节点、虚拟滚动大数据树、keyMaps 自定义字段映射与节点/tag/触发器渲染。严格对齐 Semi。";
     readonly props: readonly [{
         readonly name: "value";
         readonly type: "TreeKey|TreeKey[]|null";
@@ -18,16 +18,7 @@ export declare const meta: {
         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 desc: "树数据源；字段名可经 keyMaps 自定义";
     }, {
         readonly name: "defaultOpen";
         readonly type: "boolean";
@@ -37,21 +28,11 @@ export declare const meta: {
         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 desc: "多选父子是否级联联动；unRelated 互不影响（对齐 Semi）";
     }, {
         readonly name: "maxTagCount";
         readonly type: "number";
@@ -74,9 +55,10 @@ export declare const meta: {
         readonly type: "boolean";
         readonly default: "false";
     }, {
-        readonly name: "clearable";
+        readonly name: "showClear";
         readonly type: "boolean";
         readonly default: "false";
+        readonly desc: "值不为空时 trigger 展示清除按钮（对齐 Semi）";
     }, {
         readonly name: "leafOnly";
         readonly type: "boolean";
@@ -86,78 +68,383 @@ export declare const meta: {
         readonly type: "boolean";
         readonly default: "false";
     }, {
-        readonly name: "treeDefaultExpandedKeys";
+        readonly name: "defaultExpandedKeys";
         readonly type: "TreeKey[]";
         readonly default: "[]";
-        readonly desc: "默认展开的节点 key（非受控初始展开集，与 defaultExpandAll 取并集）";
+        readonly desc: "默认展开的节点 key（非受控初始展开集，与 defaultExpandAll 取并集；对齐 Semi）";
     }, {
         readonly name: "filterable";
         readonly type: "boolean";
         readonly default: "false";
         readonly desc: "面板搜索框过滤节点 + 高亮命中";
+    }, {
+        readonly name: "filterTreeNode";
+        readonly type: "boolean | ((inputValue: string, treeNodeString: string, data?: TreeNode) => boolean)";
+        readonly default: "undefined";
+        readonly desc: "按输入筛选节点（对齐 Semi）：true 开启搜索并默认按 treeNodeFilterProp 包含匹配；函数则自定义匹配谓词。与 filterable 其一为真即显示搜索框";
     }, {
         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 desc: "远程搜索：输入仅触发 onSearch，不本地过滤（外部更新 treeData）";
     }, {
         readonly name: "onSearch";
-        readonly type: "(query: string) => void";
+        readonly type: "(input: string, filteredExpandedKeys: TreeKey[], filteredNodes: TreeNode[]) => void";
         readonly default: "undefined";
-        readonly desc: "远程搜索输入回调（防抖后）";
-    }, {
-        readonly name: "showIcon";
-        readonly type: "boolean";
-        readonly default: "true";
-        readonly desc: "是否预留节点图标位（icon 提供时渲染在 label 前），与 Tree 对齐";
+        readonly desc: "搜索输入回调（对齐 Semi 三入参）：入参为当前输入、过滤后应展开的节点 keys、命中节点数组";
     }, {
         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: "virtualize";
+        readonly type: "{ height?: number; width?: number | string; itemSize?: number }";
+        readonly default: "undefined";
+        readonly desc: "列表虚拟化（对齐 Semi）：传入对象即开启，仅渲染视口内可见行；height 视口高（默认 224）、itemSize 行高（默认 32）。复用 Tree 范式（core fixedRange），保持 role=tree/treeitem 语义";
     }, {
-        readonly name: "height";
-        readonly type: "number";
-        readonly default: "224";
-        readonly desc: "虚拟滚动视口高度（px），virtualized 时生效";
+        readonly name: "triggerRender";
+        readonly type: "Snippet<[{ value: TreeKey|TreeKey[]|null|undefined; placeholder: string; isOpen: boolean; disabled: boolean }]>";
+        readonly default: "undefined";
+        readonly desc: "完全自定义触发器渲染（替换默认选择框）；参数含当前 value/placeholder/isOpen/disabled，与 Cascader.triggerRender 对齐";
     }, {
-        readonly name: "itemHeight";
-        readonly type: "number";
-        readonly default: "32";
-        readonly desc: "虚拟滚动行高（px），virtualized 时生效";
+        readonly name: "insetLabel";
+        readonly type: "Snippet | string";
+        readonly default: "undefined";
+        readonly desc: "触发器内嵌标签，渲染在回填值/占位符之前（对齐 Semi insetLabel），消费 --cd-color/font-tree-select-label token";
     }, {
-        readonly name: "icon";
-        readonly type: "Snippet<[{ node: TreeNode; expanded: boolean; level: number }]>";
+        readonly name: "insetLabelId";
+        readonly type: "string";
         readonly default: "undefined";
-        readonly desc: "自定义节点图标，showIcon 为真时渲染在 label 前；参数含节点与展开态，与 Tree 的 icon API 对齐";
+        readonly desc: "内嵌标签的 id（a11y 关联用），对齐 Semi insetLabelId";
+    }, {
+        readonly name: "motion";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "下拉浮层开合动画（淡入）；与 Cascader/Dropdown 的 motion 对齐。reduced-motion 退化";
     }, {
         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 name: "ariaLabel";
+        readonly type: "string";
         readonly default: "undefined";
     }, {
-        readonly name: "ariaLabel";
+        readonly name: "ariaLabelledby";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "aria-labelledby：关联外部 label 元素（Form.Field 透传 labelId，对齐 Semi）";
+    }, {
+        readonly name: "ariaDescribedby";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "aria-describedby：关联 helpText / extraText（Form.Field 透传）";
+    }, {
+        readonly name: "ariaErrormessage";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "aria-errormessage：error 态关联错误信息容器（Form.Field 透传）";
+    }, {
+        readonly name: "ariaRequired";
+        readonly type: "boolean";
+        readonly default: "undefined";
+        readonly desc: "aria-required：必填语义（Form.Field required 透传）";
+    }, {
+        readonly name: "position";
+        readonly type: "string";
+        readonly default: "'bottomLeft'";
+        readonly desc: "浮层弹出位置（对齐 Semi，参考 Tooltip position）；映射到 use:floating placement";
+    }, {
+        readonly name: "dropdownMatchSelectWidth";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "浮层宽度对齐触发器（min-inline-size = 触发器宽）";
+    }, {
+        readonly name: "getPopupContainer";
+        readonly type: "() => HTMLElement | null | undefined";
+        readonly default: "undefined";
+        readonly desc: "浮层挂载容器，缺省 ConfigProvider 全局值再回退 document.body";
+    }, {
+        readonly name: "stopPropagation";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "触发器点击是否阻止事件冒泡（对齐 Semi）";
+    }, {
+        readonly name: "borderless";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "无边框模式：trigger 边框透明";
+    }, {
+        readonly name: "prefix";
+        readonly type: "Snippet | string";
+        readonly default: "undefined";
+        readonly desc: "trigger 前缀";
+    }, {
+        readonly name: "suffix";
+        readonly type: "Snippet | string";
+        readonly default: "undefined";
+        readonly desc: "trigger 后缀";
+    }, {
+        readonly name: "clearIcon";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "自定义清除按钮图标";
+    }, {
+        readonly name: "expandIcon";
+        readonly type: "Snippet<[{ node: TreeNode; expanded: boolean; level: number }]>";
+        readonly default: "undefined";
+        readonly desc: "自定义展开图标；也可传无参 Snippet 统一渲染";
+    }, {
+        readonly name: "arrowIcon";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "自定义右侧下拉箭头（expandIcon 的别名）";
+    }, {
+        readonly name: "showLine";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "显示节点连接线（垂直导引线）";
+    }, {
+        readonly name: "labelEllipsis";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "节点 label 单行省略截断，可关闭以允许换行";
+    }, {
+        readonly name: "style";
         readonly type: "string";
         readonly default: "undefined";
+        readonly desc: "选择框样式";
+    }, {
+        readonly name: "autoAdjustOverflow";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "浮层遮挡时自动调整方向";
+    }, {
+        readonly name: "validateStatus";
+        readonly type: "'default'|'error'|'warning'";
+        readonly default: "undefined";
+        readonly desc: "status 的别名（优先于 status）";
+    }, {
+        readonly name: "onBlur";
+        readonly type: "(e: FocusEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "失焦回调";
+    }, {
+        readonly name: "onFocus";
+        readonly type: "(e: FocusEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "聚焦回调";
+    }, {
+        readonly name: "preventScroll";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "聚焦时阻止滚动";
+    }, {
+        readonly name: "outerTopSlot";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "面板顶部外层 slot（在搜索框之上）";
+    }, {
+        readonly name: "outerBottomSlot";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "面板底部外层 slot（在树之下）";
+    }, {
+        readonly name: "searchAutoFocus";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "面板打开时搜索框自动获焦";
+    }, {
+        readonly name: "searchPosition";
+        readonly type: "'dropdown'|'trigger'";
+        readonly default: "'dropdown'";
+        readonly desc: "搜索框位置：'dropdown' 面板内；'trigger' trigger 内";
+    }, {
+        readonly name: "searchPlaceholder";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "搜索框占位文字";
+    }, {
+        readonly name: "treeNodeFilterProp";
+        readonly type: "string";
+        readonly default: "'label'";
+        readonly desc: "搜索过滤属性";
+    }, {
+        readonly name: "showSearchClear";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "搜索框右侧显示清除按钮（有内容时）";
+    }, {
+        readonly name: "showFilteredOnly";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "搜索激活时仅显示命中节点，不显示祖先链";
+    }, {
+        readonly name: "emptyContent";
+        readonly type: "string | Snippet";
+        readonly default: "undefined";
+        readonly desc: "无匹配/无数据占位内容（对齐 Semi emptyContent）；未传回退 i18n TreeSelect.emptyText";
+    }, {
+        readonly name: "searchRender";
+        readonly type: "boolean | Snippet<[{ value: string; onInput: (v: string) => void; onKeydown: (e: KeyboardEvent) => void; placeholder: string }]>";
+        readonly default: "undefined";
+        readonly desc: "自定义搜索框渲染：false 隐藏内置搜索框；Snippet 完全接管渲染（回调回填输入）";
+    }, {
+        readonly name: "expandedKeys";
+        readonly type: "TreeKey[]";
+        readonly default: "undefined";
+        readonly desc: "受控展开的节点 keys";
+    }, {
+        readonly name: "expandAll";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "动态全部展开（受控/动态，区别于 defaultExpandAll）";
+    }, {
+        readonly name: "expandAction";
+        readonly type: "false | 'click' | 'doubleClick'";
+        readonly default: "false";
+        readonly desc: "行点击展开方式：false 仅展开按钮；'click' 单击行；'doubleClick' 双击行";
+    }, {
+        readonly name: "autoExpandParent";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "展开节点时自动展开其所有祖先链";
+    }, {
+        readonly name: "motionExpand";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "展开/折叠动画";
+    }, {
+        readonly name: "onExpand";
+        readonly type: "(expandedKeys: TreeKey[], info: { expanded: boolean; node: unknown }) => void";
+        readonly default: "undefined";
+        readonly desc: "节点展开回调";
+    }, {
+        readonly name: "autoMergeValue";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "自动合并值：父节点全选时 value 折叠为父不含后代（对齐 Semi）；leafOnly 时改为仅叶子";
+    }, {
+        readonly name: "onChangeWithObject";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "onChange 回调携带完整节点对象而非仅 key";
+    }, {
+        readonly name: "showRestTagsPopover";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "多选 maxTagCount 折叠出 +N 时，hover +N 用 Popover 浮层展示折叠掉的剩余全部 Tag";
+    }, {
+        readonly name: "restTagsPopoverProps";
+        readonly type: "Record<string, unknown>";
+        readonly default: "undefined";
+        readonly desc: "透传给剩余 Tag Popover 浮层的额外 props（在默认 trigger=hover/position=top 之后展开，可覆盖）";
+    }, {
+        readonly name: "triggerTagWrap";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "trigger 多选 tags 换行显示（默认单行截断折叠）";
+    }, {
+        readonly name: "renderLabel";
+        readonly type: "Snippet<[{ label: string; data: TreeNode; searchWord: string }]>";
+        readonly default: "undefined";
+        readonly desc: "自定义节点 label 渲染（仅替换文字部分）";
+    }, {
+        readonly name: "renderFullLabel";
+        readonly type: "Snippet<[{ node: TreeNode; expanded: boolean; level: number; checked: boolean; halfChecked: boolean; selected: boolean }]>";
+        readonly default: "undefined";
+        readonly desc: "完全自定义节点行渲染（替换整行内容）";
+    }, {
+        readonly name: "renderSelectedItem";
+        readonly type: "Snippet<[{ node: TreeNode; onRemove: () => void }]>";
+        readonly default: "undefined";
+        readonly desc: "自定义 trigger 已选 tag 渲染（多选时每个 tag 独立渲染）";
+    }, {
+        readonly name: "treeNodeLabelProp";
+        readonly type: "string";
+        readonly default: "'label'";
+        readonly desc: "节点数据中用作显示 label 的字段名";
+    }, {
+        readonly name: "keyMaps";
+        readonly type: "{ key?: string; label?: string; value?: string; children?: string }";
+        readonly default: "undefined";
+        readonly desc: "自定义节点字段名映射（对齐 Semi keyMaps）：适配任意后端数据结构，如 { key:'id', label:'name', children:'sub' }";
+    }, {
+        readonly name: "optionListStyle";
+        readonly type: "string | Record<string, string>";
+        readonly default: "undefined";
+        readonly desc: "选项列表容器的内联 style";
+    }, {
+        readonly name: "loadedKeys";
+        readonly type: "Set<TreeKey>";
+        readonly default: "undefined";
+        readonly desc: "受控已加载的节点 keys";
+    }, {
+        readonly name: "clickToHide";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "单选选中后自动关闭面板";
+    }, {
+        readonly name: "clickTriggerToHide";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "面板开启时点击 trigger 关闭面板";
+    }, {
+        readonly name: "disableStrictly";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "严格禁用：disabled 节点不因父节点联动而影响，禁用态独立";
+    }, {
+        readonly name: "dropdownMargin";
+        readonly type: "number | { marginTop?: number; marginBottom?: number; marginLeft?: number; marginRight?: number }";
+        readonly default: "undefined";
+        readonly desc: "浮层与 trigger 的额外间距（px）；数字映射到浮层 offset，对象取 marginTop";
+    }, {
+        readonly name: "dropdownClassName";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "追加到浮层根节点的自定义类名（与内置类名并存）";
+    }, {
+        readonly name: "dropdownStyle";
+        readonly type: "string | Record<string, string>";
+        readonly default: "undefined";
+        readonly desc: "合并进浮层根节点的内联样式（不覆盖内置定位样式）";
+    }, {
+        readonly name: "zIndex";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "浮层层级（z-index），未传由 CSS 控制";
+    }, {
+        readonly name: "onClear";
+        readonly type: "(e: MouseEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "点击清除按钮回调";
+    }, {
+        readonly name: "onSelect";
+        readonly type: "(selectedKey: TreeKey, selected: boolean, node: unknown) => void";
+        readonly default: "undefined";
+        readonly desc: "节点选中回调";
+    }, {
+        readonly name: "onLoad";
+        readonly type: "(loadedKeys: TreeKey[], treeNode: TreeNode) => void";
+        readonly default: "undefined";
+        readonly desc: "异步加载完成回调（含已加载 key 集合与当前节点）";
+    }, {
+        readonly name: "onVisibleChange";
+        readonly type: "(isVisible: boolean) => void";
+        readonly default: "undefined";
+        readonly desc: "面板可见性变化回调（对齐 Semi onVisibleChange）";
+    }];
+    readonly methods: readonly [{
+        readonly name: "search(sugInput)";
+        readonly desc: "命令式搜索：把值置给内部搜索态并触发过滤（对齐 Semi，用于外部自定义搜索框）";
     }];
     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"];
+    readonly tokens: readonly ["--cd-tree-select-*", "--cd-color-tree-select-label", "--cd-font-tree-select-label", "--cd-dropdown-motion-*", "--cd-select-*", "--cd-tree-*", "--cd-focus-ring"];
 };
 //# sourceMappingURL=meta.d.ts.map

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

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