@chenzy-design/svelte 0.3.0 → 0.4.1

package/dist/nav/meta.js

@@ -5,42 +5,45 @@
 export const meta = {
     name: 'Nav',
     category: 'navigation',
-    description: '站点导航菜单（对齐 Semi Navigation）。支持垂直/水平模式、子导航、logo 头部、折叠按钮。字段对齐 Semi（itemKey/text/icon/items），内部委托 Menu 渲染导航体。',
+    description: '站点导航菜单（对齐 Semi Navigation）。支持垂直/水平模式、子导航（内联/浮层）、logo 头部、折叠按钮、多选。独立渲染，字段/回调对齐 Semi（itemKey/text/icon/items）。',
     props: [
         {
             name: 'items',
-            type: 'NavItemDef[]',
+            type: 'NavItemInput[]',
             default: '[]',
-            desc: '导航项列表，字段对齐 Semi：itemKey/text/icon/items（含 items 即子导航）',
+            desc: '导航项列表，字段对齐 Semi：itemKey/text/icon/items（含 items 即子导航）。string 项取值作 text 与 itemKey',
         },
         { name: 'mode', type: "'vertical'|'horizontal'", default: "'vertical'", desc: '导航方向：侧边/顶部' },
         { name: 'selectedKeys', type: 'NavKey[]', default: 'undefined', desc: '受控选中项 key 数组' },
         { name: 'defaultSelectedKeys', type: 'NavKey[]', default: 'undefined', desc: '默认选中项 key 数组' },
         { name: 'openKeys', type: 'NavKey[]', default: 'undefined', desc: '受控展开子导航 key（vertical 且未折叠有效）' },
         { name: 'defaultOpenKeys', type: 'NavKey[]', default: 'undefined', desc: '默认展开子导航 key' },
+        { name: 'multiple', type: 'boolean', default: 'false', desc: '多选模式（叠加选中，配合 onDeselect）' },
         { name: 'isCollapsed', type: 'boolean', default: 'undefined', desc: '受控折叠态（仅 vertical 有效）' },
         { name: 'defaultIsCollapsed', type: 'boolean', default: 'false', desc: '默认折叠态（仅 vertical 有效）' },
         { name: 'header', type: '{ logo?: Snippet; text?: string }', default: 'undefined', desc: '头部配置（logo + 文案）' },
         { name: 'footer', type: '{ collapseButton?: boolean }', default: 'undefined', desc: '底部配置（收起按钮，仅 vertical）' },
-        { name: 'disabled', type: 'boolean', default: 'false', desc: '整体禁用' },
-        { name: 'inlineIndent', type: 'number', default: '24', desc: '子级缩进像素（透传 Menu）' },
-        { name: 'limitIndent', type: 'boolean', default: 'true', desc: '仅一级缩进；false 时逐级缩进' },
+        { name: 'limitIndent', type: 'boolean', default: 'true', desc: '仅一级缩进；false 时逐级缩进（依赖 level+indent）' },
         { name: 'toggleIconPosition', type: "'left'|'right'", default: "'right'", desc: '子导航展开箭头位置' },
         { name: 'expandIcon', type: 'Snippet', default: 'undefined', desc: '自定义展开箭头图标' },
         { name: 'subNavMotion', type: 'boolean', default: 'true', desc: '子导航展开动画开关' },
-        { name: 'subNavOpenDelay', type: 'number', default: 'undefined', desc: '浮层子导航展开延迟 ms' },
-        { name: 'subNavCloseDelay', type: 'number', default: 'undefined', desc: '浮层子导航关闭延迟 ms' },
+        { name: 'subNavOpenDelay', type: 'number', default: '0', desc: '浮层子导航展开延迟 ms（透传 Dropdown mouseEnterDelay）' },
+        { name: 'subNavCloseDelay', type: 'number', default: '100', desc: '浮层子导航关闭延迟 ms（透传 Dropdown mouseLeaveDelay）' },
+        { name: 'subDropdownProps', type: 'NavDropdownProps', default: 'undefined', desc: 'Nav 级：透传给所有子导航浮层 Dropdown 的默认属性' },
+        { name: 'tooltipShowDelay', type: 'number', default: 'undefined', desc: '折叠态 tooltip 显示延迟 ms' },
+        { name: 'tooltipHideDelay', type: 'number', default: 'undefined', desc: '折叠态 tooltip 隐藏延迟 ms' },
         { name: 'getPopupContainer', type: '() => HTMLElement', default: 'undefined', desc: '浮层挂载容器' },
         { name: 'renderWrapper', type: 'Snippet', default: 'undefined', desc: '自定义导航项外层包裹' },
+        { name: 'renderIcon', type: 'Snippet<[NavItemDef]>', default: 'undefined', desc: '数据驱动的项图标渲染钩子（本库扩展，Semi 无）：项未自带 icon 时按 item 渲染前置图标，用于 items 大量、图标随 item 变化的场景（如站点侧边栏按组件名取图标）。项自带 icon 优先' },
         { name: 'class', type: 'string', default: 'undefined', desc: '根元素自定义类名' },
         { name: 'style', type: 'string', default: 'undefined', desc: '根元素自定义内联样式' },
         { name: 'bodyStyle', type: 'string', default: 'undefined', desc: '导航项列表容器样式（对齐 Semi bodyStyle）' },
-        { name: 'ariaLabel', type: 'string', default: 'undefined', desc: '可访问性标签' },
     ],
     events: [
-        { name: 'onSelect', payload: 'NavKey', desc: '选中导航项时触发' },
-        { name: 'onClick', payload: 'NavKey', desc: '点击任意导航项时触发' },
-        { name: 'onOpenChange', payload: 'NavKey[]', desc: '展开/收起子导航时触发' },
+        { name: 'onSelect', payload: 'NavSelectData', desc: '选中导航项时触发（{itemKey,selectedKeys,selectedItems,domEvent,isOpen}）' },
+        { name: 'onDeselect', payload: 'NavSelectData', desc: '多选下取消选中时触发' },
+        { name: 'onClick', payload: 'NavClickData', desc: '点击任意导航项时触发（{itemKey,domEvent,isOpen}）' },
+        { name: 'onOpenChange', payload: 'NavOpenChangeData', desc: '展开/收起子导航时触发（{itemKey,openKeys,domEvent,isOpen}）' },
         { name: 'onCollapseChange', payload: 'boolean', desc: '折叠态变化时触发' },
     ],
     slots: [
@@ -54,7 +57,9 @@ export const meta = {
             element: 'div',
             props: [
                 { name: 'logo', type: 'Snippet', default: 'undefined', desc: 'Logo 节点' },
-                { name: 'text', type: 'string', default: 'undefined', desc: 'Logo 文案' },
+                { name: 'text', type: 'string | Snippet', default: 'undefined', desc: 'Logo 文案' },
+                { name: 'link', type: 'string', default: 'undefined', desc: '链接地址（整体包裹 <a>）' },
+                { name: 'linkOptions', type: 'Record<string,string>', default: 'undefined', desc: '透传给 <a> 的属性' },
                 { name: 'class', type: 'string', default: 'undefined', desc: '自定义类名' },
                 { name: 'style', type: 'string', default: 'undefined', desc: '自定义内联样式' },
             ],
@@ -63,51 +68,87 @@ export const meta = {
             name: 'Nav.Footer',
             element: 'div',
             props: [
-                { name: 'collapseButton', type: 'boolean', default: 'false', desc: '收起按钮（仅 vertical 生效）' },
+                { name: 'collapseButton', type: 'boolean | Snippet', default: 'false', desc: '收起按钮（或自定义节点，仅 vertical 生效）' },
+                { name: 'collapseText', type: '(collapsed: boolean) => string', default: 'undefined', desc: '收起按钮文案（默认用 locale）' },
+                { name: 'onClick', type: '(e: MouseEvent) => void', default: 'undefined', desc: '点击事件回调' },
                 { name: 'class', type: 'string', default: 'undefined', desc: '自定义类名' },
                 { name: 'style', type: 'string', default: 'undefined', desc: '自定义内联样式' },
             ],
         },
         {
             name: 'Nav.Item',
-            element: '—',
+            element: 'li[role=menuitem]',
             props: [
                 { name: 'itemKey', type: 'NavKey', default: '—', desc: '导航项唯一标识（必填）' },
-                { name: 'text', type: 'string', default: '—', desc: '导航项文案' },
+                { name: 'text', type: 'string | Snippet', default: '—', desc: '导航项文案' },
                 { name: 'icon', type: 'Snippet', default: 'undefined', desc: '项前置图标' },
-                { name: 'disabled', type: 'boolean', default: 'undefined', desc: '是否禁用' },
+                { name: 'disabled', type: 'boolean', default: 'false', desc: '是否禁用' },
+                { name: 'indent', type: 'boolean', default: 'undefined', desc: '保留左侧图标占位（对齐 Semi indent）' },
+                { name: 'level', type: 'number', default: 'undefined', desc: '嵌套层级（limitIndent=false 时自定义缩进，对齐 Semi level）' },
                 { name: 'link', type: 'string', default: 'undefined', desc: '链接地址（渲染原生 <a>）' },
-                { name: 'target', type: 'string', default: 'undefined', desc: '链接 target' },
-                { name: 'rel', type: 'string', default: 'undefined', desc: '链接 rel' },
-                { name: 'onClick', type: '(e: MouseEvent) => void', default: 'undefined', desc: '项级点击回调' },
+                { name: 'linkOptions', type: 'Record<string,string>', default: 'undefined', desc: '透传给 <a> 的属性（target/rel/download）' },
+                { name: 'onClick', type: '(data: NavClickData) => void', default: 'undefined', desc: '项级点击回调（富载荷 {itemKey,domEvent,isOpen}）' },
                 { name: 'onMouseEnter', type: '(e: MouseEvent) => void', default: 'undefined', desc: '鼠标移入' },
                 { name: 'onMouseLeave', type: '(e: MouseEvent) => void', default: 'undefined', desc: '鼠标移出' },
             ],
         },
         {
             name: 'Nav.Sub',
-            element: '—',
+            element: 'li[role=menuitem]（浮层态用 Dropdown）',
             props: [
                 { name: 'itemKey', type: 'NavKey', default: '—', desc: '子导航唯一标识（必填）' },
-                { name: 'text', type: 'string', default: '—', desc: '子导航标题文案' },
+                { name: 'text', type: 'string | Snippet', default: '—', desc: '子导航标题文案' },
                 { name: 'icon', type: 'Snippet', default: 'undefined', desc: '标题前置图标' },
-                { name: 'disabled', type: 'boolean', default: 'undefined', desc: '是否禁用' },
+                { name: 'disabled', type: 'boolean', default: 'false', desc: '是否禁用' },
+                { name: 'indent', type: 'boolean', default: 'undefined', desc: '保留左侧图标占位（对齐 Semi indent）' },
+                { name: 'level', type: 'number', default: '0', desc: '嵌套层级（limitIndent=false 时自定义缩进，对齐 Semi level）' },
+                { name: 'maxHeight', type: 'number', default: '999', desc: '子导航最大高度（内联展开动画）' },
+                { name: 'isOpen', type: 'boolean', default: 'undefined', desc: '子导航是否展开（对齐 Semi isOpen）' },
+                { name: 'dropdownProps', type: 'NavDropdownProps', default: 'undefined', desc: '透传给该子导航浮层 Dropdown 的属性' },
+                { name: 'dropdownStyle', type: 'string', default: 'undefined', desc: '透传给该子导航浮层 Dropdown 的内联样式' },
+                { name: 'onMouseEnter', type: '(e: MouseEvent) => void', default: 'undefined', desc: '标题鼠标移入' },
+                { name: 'onMouseLeave', type: '(e: MouseEvent) => void', default: 'undefined', desc: '标题鼠标移出' },
                 { name: 'children', type: 'Snippet', default: 'undefined', desc: '内嵌 Nav.Item / Nav.Sub' },
             ],
         },
     ],
     a11y: {
-        role: 'navigation',
-        keyboard: ['Tab', 'Shift+Tab', 'Enter'],
+        role: 'menu',
+        keyboard: ['Tab', 'Shift+Tab', 'Enter', 'Space', 'ArrowLeft', 'ArrowRight'],
         notes: [
-            '委托 Menu purpose=navigation：渲染 <nav> landmark + 含 link 的叶子为原生 <a>',
-            '选中项 aria-current=page；折叠按钮原生 button + aria-expanded + aria-label',
+            '对齐 Semi：根为纯 <div>（无 nav landmark），列表 ul[role=menu][aria-orientation=mode]',
+            '叶子/子导航标题均为 role=menuitem；选中靠 -selected class（无 aria-current）',
+            '含 link 的叶子内含原生 <a>；子导航标题 aria-expanded 反映展开态',
+            '折叠态浮层子导航复用 Dropdown（role=menu + menuitem）；折叠收起按钮为 icon-only Button + aria-label（Tooltip 提示）',
         ],
     },
-    tokens: ['--cd-nav-*'],
+    // Nav 直接消费 navigation.ts 主 token（命名镜像 Semi navigation/variables.scss）；
+    // 已移除 Semi 没有的 --cd-nav-* 中间层。
+    tokens: [
+        '--cd-height-navigation-horizontal-header',
+        '--cd-height-navigation-item-base',
+        '--cd-width-navigation-item-borderradius',
+        '--cd-font-size-navigation-header-text',
+        '--cd-spacing-navigation-horizontal-paddingleft',
+        '--cd-spacing-navigation-header-logo-marginright',
+        '--cd-spacing-navigation-footer-paddingx',
+        '--cd-spacing-navigation-footer-paddingy',
+        '--cd-spacing-navigation-vertical-footer-collapse-text-marginleft',
+        '--cd-color-navigation-header-text-default',
+        '--cd-color-navigation-footer-icon-default',
+        '--cd-color-navigation-border-default',
+        '--cd-color-navigation-iteml1-bg-active',
+        '--cd-color-navigation-iteml1-selected-disabled-bg-default',
+        '--cd-color-navigation-iteml1-selected-disabled-text-default',
+        '--cd-color-navigation-iteml1-selected-disabled-icon-default',
+        '--cd-font-navigation-header-item-fontweight',
+        '--cd-font-navigation-popover-nav-item-selected-fontweight',
+        '--cd-width-navigation-icon-left',
+        '--cd-spacing-navigation-vertical-footer-paddingx',
+    ],
     aiHints: [
         '侧边导航用 mode=vertical + footer={{collapseButton:true}}；顶部导航用 mode=horizontal。',
-        'items 字段对齐 Semi：itemKey/text/icon/items（非 Menu 的 key/label）。',
+        'items 字段对齐 Semi：itemKey/text/icon/items。',
         '配合 Layout：<Layout.Sider><Nav mode=vertical/></Layout.Sider> 或 <Layout.Header><Nav mode=horizontal/></Layout.Header>。',
     ],
     examples: [

package/dist/nav/types.d.ts

@@ -1,52 +1,119 @@
 import type { Snippet } from 'svelte';
-import type { MenuItemDef } from '../menu/types.js';
 /** Nav 项键类型（对齐 Semi itemKey）。 */
 export type NavKey = string | number;
 /** Nav 模式：垂直（侧边）或水平（顶部）。对齐 Semi mode。 */
 export type NavMode = 'vertical' | 'horizontal';
+/** 透传给内部 Dropdown 的属性集（对齐 Semi dropdownProps / subDropdownProps，DropdownProps 子集）。 */
+export type NavDropdownProps = Record<string, unknown>;
 /**
  * Nav 导航项（字段对齐 Semi：itemKey / text / icon / items）。
- * 含 items 即为可展开子导航。Nav 内部映射为 Menu 的 MenuItemDef 渲染。
+ * 含 items 即为可展开子导航。Nav 由 NavItemRender 递归渲染。
  */
 export interface NavItemDef {
     /** 导航项唯一标识（对齐 Semi itemKey）。 */
     itemKey: NavKey;
-    /** 导航项文案（对齐 Semi text）。 */
-    text: string;
+    /** 导航项文案（对齐 Semi text，可为字符串或 Snippet）。 */
+    text: string | Snippet;
     /** 项前置图标。 */
     icon?: Snippet;
-    /** 是否禁用。 */
+    /** 是否禁用（对齐 Semi，默认 false）。 */
     disabled?: boolean;
     /** 链接地址；传入时叶子项渲染为原生 `<a href>`（站点导航语义）。 */
     link?: string;
-    /** 链接 target（如 '_blank'）。 */
-    target?: string;
-    /** 链接 rel（如 'noopener noreferrer'）。 */
-    rel?: string;
-    /** 项级点击回调（叶子项）。 */
-    onClick?: (e: MouseEvent) => void;
+    /** 透传给 `<a>` 的属性（对齐 Semi linkOptions，如 target/rel/download）。 */
+    linkOptions?: Record<string, string>;
+    /** 嵌套层级（0=一级，对齐 Semi level）；由渲染层递归下传，声明式一般无需手写。 */
+    level?: number;
+    /** 是否保留左侧 Icon 占位（对齐 Semi indent）。 */
+    indent?: boolean;
+    /** 项级点击回调（叶子项，富载荷对齐 Semi）。 */
+    onClick?: (data: NavClickData) => void;
     /** 项级鼠标移入回调。 */
     onMouseEnter?: (e: MouseEvent) => void;
     /** 项级鼠标移出回调。 */
     onMouseLeave?: (e: MouseEvent) => void;
-    /** 子导航项；含 items 即为可展开子导航。 */
-    items?: NavItemDef[];
+    /** 子导航项；含 items 即为可展开子导航。string 项取值作 text 与 itemKey（对齐 Semi）。 */
+    items?: NavItemInput[];
+    /** 子导航最大高度（用于内联展开动画，对齐 Semi maxHeight，默认 999）。 */
+    maxHeight?: number;
+    /** 子导航是否展开（对齐 Semi Sub.isOpen，非受控展开配合）。 */
+    isOpen?: boolean;
+    /** 透传给该子导航浮层 Dropdown 的属性（对齐 Semi Sub dropdownProps）。 */
+    dropdownProps?: NavDropdownProps;
+    /** 透传给该子导航浮层 Dropdown 的内联样式（对齐 Semi Sub dropdownStyle）。 */
+    dropdownStyle?: string;
+}
+/**
+ * items 入参项：对象或字符串（对齐 Semi `items` 支持 string[]，取每项作 text 与 itemKey）。
+ * 传入 Nav 后经 normalizeNavItems 归一为 NavItemDef。
+ */
+export type NavItemInput = string | NavItemDef;
+/** onSelect 富载荷（对齐 Semi Navigation onSelect）。 */
+export interface NavSelectData {
+    /** 触发选中的项 key。 */
+    itemKey: NavKey;
+    /** 选中后的全部选中 key。 */
+    selectedKeys: NavKey[];
+    /** 选中后的全部选中项（Nav 形）。 */
+    selectedItems: NavItemDef[];
+    /** 原生事件。 */
+    domEvent?: Event;
+    /** 叶子恒 false。 */
+    isOpen: boolean;
+}
+/** onClick 富载荷（对齐 Semi Navigation onClick）。 */
+export interface NavClickData {
+    itemKey: NavKey;
+    domEvent?: Event;
+    isOpen: boolean;
 }
-/** Nav.Header 配置对象（对齐 Semi header={{logo,text}}）。 */
+/** onOpenChange 富载荷（对齐 Semi Navigation onOpenChange）。 */
+export interface NavOpenChangeData {
+    itemKey: NavKey;
+    openKeys: NavKey[];
+    domEvent?: Event;
+    isOpen: boolean;
+}
+/** Nav.Header 配置对象（对齐 Semi header={{logo,text,link,...}}）。 */
 export interface NavHeaderConfig {
     /** Logo 节点（Snippet）。 */
     logo?: Snippet;
-    /** Logo 文案。 */
-    text?: string;
+    /** Logo 文案（字符串或 Snippet）。 */
+    text?: string | Snippet;
+    /** 链接地址：传入时头部整体包裹 `<a>`。 */
+    link?: string;
+    /** 透传给 `<a>` 的属性（对齐 Semi linkOptions）。 */
+    linkOptions?: Record<string, string>;
+    /** 自定义类名。 */
+    class?: string;
+    /** 自定义内联样式。 */
+    style?: string;
 }
-/** Nav.Footer 配置对象（对齐 Semi footer={{collapseButton}}）。 */
+/** Nav.Footer 配置对象（对齐 Semi footer={{collapseButton,collapseText,onClick}}）。 */
 export interface NavFooterConfig {
-    /** 是否展示底部「收起侧边栏」按钮，仅 mode='vertical' 生效。 */
-    collapseButton?: boolean;
+    /** 是否展示底部「收起侧边栏」按钮（或自定义节点 Snippet），仅 mode='vertical' 生效。 */
+    collapseButton?: boolean | Snippet;
+    /** 收起按钮文案（对齐 Semi collapseText，(collapsed)=>string）。 */
+    collapseText?: (collapsed: boolean) => string;
+    /** 自定义类名。 */
+    class?: string;
+    /** 自定义内联样式。 */
+    style?: string;
+    /** 点击事件回调。 */
+    onClick?: (e: MouseEvent) => void;
 }
 /**
- * 把 Nav 项（Semi 字段）递归映射为 Menu 的 MenuItemDef。
- * itemKey→key、text→label、items→children、link→href，icon/target/rel/disabled 直传。
+ * 归一 items 入参（对齐 Semi）：string 项 → { itemKey, text } 同值；对象项递归归一其 items。
+ * Nav 在消费前调用一次，之后内部只处理 NavItemDef 树。
+ */
+export declare function normalizeNavItems(input: readonly NavItemInput[] | undefined): NavItemDef[];
+/** 是否为可展开子导航（含非空 items）。 */
+export declare function hasSubNav(item: NavItemDef): boolean;
+/** 递归按 key 集合从 Nav 项树收集节点（供回调 selectedItems）。 */
+export declare function collectNavItemsByKeys(items: NavItemDef[], keys: readonly NavKey[]): NavItemDef[];
+/**
+ * 收集给定 key 集合中每个 key 的所有祖先 SubNav key（对齐 Semi：选中子项时父级 SubNav 高亮）。
+ * 返回去重后的祖先 key 数组（不含自身）。
  */
-export declare function navItemsToMenuItems(items?: NavItemDef[]): MenuItemDef[];
+export declare function collectAncestorKeys(items: NavItemDef[], keys: readonly NavKey[]): NavKey[];
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/nav/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,iCAAiC;AACjC,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAErC,yCAAyC;AACzC,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,YAAY,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IAClC,gBAAgB;IAChB,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IACvC,gBAAgB;IAChB,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IACvC,6BAA6B;IAC7B,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,GAAE,UAAU,EAAO,GAAG,WAAW,EAAE,CAiB3E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/nav/types.ts"],"names":[],"mappings":"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"}

package/dist/nav/types.js

@@ -1,31 +1,52 @@
 /**
- * 把 Nav 项（Semi 字段）递归映射为 Menu 的 MenuItemDef。
- * itemKey→key、text→label、items→children、link→href，icon/target/rel/disabled 直传。
+ * 归一 items 入参（对齐 Semi）：string 项 → { itemKey, text } 同值；对象项递归归一其 items。
+ * Nav 在消费前调用一次，之后内部只处理 NavItemDef 树。
  */
-export function navItemsToMenuItems(items = []) {
-    return items.map((it) => {
-        const node = {
-            key: it.itemKey,
-            label: it.text,
-        };
-        if (it.icon)
-            node.icon = it.icon;
-        if (it.disabled)
-            node.disabled = it.disabled;
-        if (it.link)
-            node.href = it.link;
-        if (it.target)
-            node.target = it.target;
-        if (it.rel)
-            node.rel = it.rel;
-        if (it.onClick)
-            node.onClick = it.onClick;
-        if (it.onMouseEnter)
-            node.onMouseEnter = it.onMouseEnter;
-        if (it.onMouseLeave)
-            node.onMouseLeave = it.onMouseLeave;
+export function normalizeNavItems(input) {
+    if (!input)
+        return [];
+    return input.map((it) => {
+        if (typeof it === 'string')
+            return { itemKey: it, text: it };
         if (it.items && it.items.length)
-            node.children = navItemsToMenuItems(it.items);
-        return node;
+            return { ...it, items: normalizeNavItems(it.items) };
+        return it;
     });
 }
+/** 是否为可展开子导航（含非空 items）。 */
+export function hasSubNav(item) {
+    return !!item.items && item.items.length > 0;
+}
+/** 递归按 key 集合从 Nav 项树收集节点（供回调 selectedItems）。 */
+export function collectNavItemsByKeys(items, keys) {
+    const set = new Set(keys);
+    const acc = [];
+    const walk = (list) => {
+        for (const it of list) {
+            if (set.has(it.itemKey))
+                acc.push(it);
+            if (it.items?.length)
+                walk(normalizeNavItems(it.items));
+        }
+    };
+    walk(items);
+    return acc;
+}
+/**
+ * 收集给定 key 集合中每个 key 的所有祖先 SubNav key（对齐 Semi：选中子项时父级 SubNav 高亮）。
+ * 返回去重后的祖先 key 数组（不含自身）。
+ */
+export function collectAncestorKeys(items, keys) {
+    const target = new Set(keys);
+    const acc = new Set();
+    const walk = (list, ancestors) => {
+        for (const it of list) {
+            if (target.has(it.itemKey))
+                ancestors.forEach((a) => acc.add(a));
+            if (it.items?.length)
+                walk(normalizeNavItems(it.items), [...ancestors, it.itemKey]);
+        }
+    };
+    walk(items, []);
+    return [...acc];
+}