@chenzy-design/svelte 0.3.1 → 0.4.1

package/dist/nav/NavSubPopup.svelte

@@ -0,0 +1,90 @@
+<!--
+  NavSubPopup — 浮层子导航（horizontal 顶部 / vertical 折叠态），对齐 Semi SubNav.tsx wrapDropdown()。
+  复用本库 Dropdown：sub-title 作触发器（children），浮层内容为 <Dropdown.Menu> 包裹的子项
+  （NavPopupNode 递归渲染，叶子=Dropdown.Item、子导航=嵌套 Dropdown）。
+  DOM：div.cd-dropdown > div.cd-dropdown-content > ul.cd-dropdown-menu[role=menu] > li.cd-dropdown-item[role=menuitem]。
+  方向：horizontal 顶层 bottomStart（Semi bottomLeft），其余 rightStart（Semi rightTop）。
+  延迟：mouseEnterDelay=subNavOpenDelay / mouseLeaveDelay=subNavCloseDelay（trigger='hover'）。
+  openKeys 受控时：trigger='custom' + visible=isOpen（对齐 Semi）。禁用时不包 Dropdown（无浮层）。
+-->
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+  import { getNavContext } from './context.js';
+  import { normalizeNavItems, type NavItemDef } from './types.js';
+  import { Dropdown } from '../dropdown/index.js';
+  import NavPopupNode from './NavPopupNode.svelte';
+
+  interface Props {
+    item: NavItemDef;
+    level: number;
+    /** 是否处于某个 SubNav 内部（决定浮层弹出方向）。 */
+    inSubNav?: boolean;
+    /** sub-title 内部内容（图标 + 文案 + toggle 箭头，由 NavItemRender 提供）。 */
+    titleContent: Snippet;
+  }
+
+  let { item, inSubNav = false, titleContent }: Props = $props();
+
+  const ctx = getNavContext()!;
+
+  const selected = $derived(ctx.isSelected(item.itemKey));
+  const itemDisabled = $derived(!!item.disabled);
+  const open = $derived(ctx.isOpen(item.itemKey));
+  const childItems = $derived(normalizeNavItems(item.items));
+
+  // horizontal 顶层向下（bottomStart≈Semi bottomLeft），其余向右（rightStart≈Semi rightTop）。
+  const position = $derived<'bottomStart' | 'rightStart'>(
+    ctx.mode === 'horizontal' && !inSubNav ? 'bottomStart' : 'rightStart',
+  );
+</script>
+
+<!-- sub-wrap 外层 li：承载 role=menuitem 的 sub-title（对齐 Semi Item.tsx li）。 -->
+{#snippet subTitle()}
+  <div
+    class="cd-nav__sub-title"
+    class:cd-nav__sub-title-selected={selected}
+    class:cd-nav__sub-title-disabled={itemDisabled}
+    role="menuitem"
+    tabindex={itemDisabled ? -1 : 0}
+    aria-expanded={open}
+    aria-disabled={itemDisabled || undefined}
+  >
+    <div class="cd-nav__item-inner">{@render titleContent()}</div>
+  </div>
+{/snippet}
+
+<!-- sub-wrap li 为 role=none（呈现性）：内部 div[role=menuitem] 由外层 role=menu 直接拥有。 -->
+<li class="cd-nav__item cd-nav__item-sub cd-nav__sub-wrap" role="none" class:cd-nav__item-disabled={itemDisabled}>
+  {#if itemDisabled}
+    {@render subTitle()}
+  {:else}
+    <Dropdown
+      className="cd-navigation-popover"
+      {position}
+      trigger={ctx.openKeysIsControlled ? 'custom' : 'hover'}
+      {...ctx.openKeysIsControlled ? { visible: open } : {}}
+      mouseEnterDelay={ctx.subNavOpenDelay}
+      mouseLeaveDelay={ctx.subNavCloseDelay}
+      {...ctx.getPopupContainer ? { getPopupContainer: ctx.getPopupContainer } : {}}
+      {...ctx.subDropdownProps ?? {}}
+      {...item.dropdownProps ?? {}}
+      {...item.dropdownStyle !== undefined ? { style: item.dropdownStyle } : {}}
+    >
+      {#snippet render()}
+        <Dropdown.Menu>
+          {#each childItems as child (child.itemKey)}
+            <NavPopupNode item={child} />
+          {/each}
+        </Dropdown.Menu>
+      {/snippet}
+      {@render subTitle()}
+    </Dropdown>
+  {/if}
+</li>
+
+<style>
+  /* 折叠态：sub-title 内容居中，图标居中于图标轨（与 NavItemRender 叶子一致）。 */
+  :global(.cd-nav--collapsed) .cd-nav__sub-title .cd-nav__item-inner {
+    justify-content: center;
+  }
+</style>

package/dist/nav/NavSubPopup.svelte.d.ts

@@ -0,0 +1,14 @@
+import type { Snippet } from 'svelte';
+import { type NavItemDef } from './types.js';
+interface Props {
+    item: NavItemDef;
+    level: number;
+    /** 是否处于某个 SubNav 内部（决定浮层弹出方向）。 */
+    inSubNav?: boolean;
+    /** sub-title 内部内容（图标 + 文案 + toggle 箭头，由 NavItemRender 提供）。 */
+    titleContent: Snippet;
+}
+declare const NavSubPopup: import("svelte").Component<Props, {}, "">;
+type NavSubPopup = ReturnType<typeof NavSubPopup>;
+export default NavSubPopup;
+//# sourceMappingURL=NavSubPopup.svelte.d.ts.map

package/dist/nav/NavSubPopup.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavSubPopup.svelte.d.ts","sourceRoot":"","sources":["../../src/nav/NavSubPopup.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAK9D,UAAU,KAAK;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,YAAY,EAAE,OAAO,CAAC;CACvB;AAsDH,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/nav/context.d.ts

@@ -1,14 +1,64 @@
-import type { NavItemDef } from './types.js';
+import type { Snippet } from 'svelte';
+import type { NavItemDef, NavKey, NavMode, NavDropdownProps } from './types.js';
+/** Nav 渲染上下文：递归子项据此判断选中/展开/折叠并触发行为。 */
 export interface NavContext {
-    /** 当前是否折叠（仅 vertical 有意义）。 */
-    readonly collapsed: boolean;
     /** 当前模式。 */
-    readonly mode: 'vertical' | 'horizontal';
-    /** 切换折叠态。 */
+    readonly mode: NavMode;
+    /** 是否折叠（仅 vertical 有意义）。 */
+    readonly collapsed: boolean;
+    /** 是否多选。 */
+    readonly multiple: boolean;
+    /** 仅一级缩进（true）/逐级缩进（false）。 */
+    readonly limitIndent: boolean;
+    /** toggle 箭头位置。 */
+    readonly toggleIconPosition: 'left' | 'right';
+    /** openKeys 是否受控（仅 vertical 且未折叠时为真，对齐 Semi openKeysIsControlled）。 */
+    readonly openKeysIsControlled: boolean;
+    /** Nav 级：透传给所有子导航浮层 Dropdown 的默认属性（对齐 Semi subDropdownProps）。 */
+    readonly subDropdownProps: NavDropdownProps | undefined;
+    /** 子导航展开动画开关。 */
+    readonly subNavMotion: boolean;
+    /** 浮层子导航展开延迟 ms。 */
+    readonly subNavOpenDelay: number;
+    /** 浮层子导航关闭延迟 ms。 */
+    readonly subNavCloseDelay: number;
+    /** 折叠态 tooltip 显示延迟 ms。 */
+    readonly tooltipShowDelay: number;
+    /** 折叠态 tooltip 隐藏延迟 ms。 */
+    readonly tooltipHideDelay: number;
+    /** 浮层挂载容器。 */
+    readonly getPopupContainer: (() => HTMLElement | null | undefined) | undefined;
+    /** 自定义展开箭头图标。 */
+    readonly expandIcon: Snippet | undefined;
+    /**
+     * 数据驱动的项图标渲染钩子：项自身未设 icon 时，用它按 item 渲染前置图标。
+     * 用于 items 大量、图标随 item 变化的场景（如站点侧边栏按组件名取图标）。
+     * 项自带 icon 优先于此钩子。
+     */
+    readonly renderIcon: Snippet<[NavItemDef]> | undefined;
+    /** 自定义导航项外层包裹（payload 对齐 Semi {itemElement,isSubNav,isInSubNav,props}）。 */
+    readonly renderWrapper: Snippet<[
+        {
+            item: NavItemDef;
+            isSubNav: boolean;
+            isInSubNav: boolean;
+            props: NavItemDef;
+            children: Snippet;
+        }
+    ]> | undefined;
+    /** 判断某 key 是否选中。 */
+    isSelected: (key: NavKey) => boolean;
+    /** 判断某 key 是否展开。 */
+    isOpen: (key: NavKey) => boolean;
+    /** 选中一个叶子项（内部处理受控/非受控 + 单/多选 + 回调）。 */
+    selectLeaf: (item: NavItemDef, domEvent?: Event) => void;
+    /** 展开/收起一个子导航（内部处理受控/非受控 + 回调）。 */
+    toggleOpen: (item: NavItemDef, willOpen: boolean, domEvent?: Event) => void;
+    /** 折叠切换（Footer 收起按钮用）。 */
     toggleCollapsed: () => void;
 }
 export declare const NAV_CONTEXT_KEY: unique symbol;
-/** Nav.Footer 内部读取 Nav 上下文（无则 undefined）。 */
+/** 读取 Nav 渲染上下文（无则 undefined）。 */
 export declare function getNavContext(): NavContext | undefined;
 /**
  * 声明式子项收集上下文（Nav.Item / Nav.Sub）。
@@ -17,8 +67,7 @@ export declare function getNavContext(): NavContext | undefined;
  * - 子项注册写入的 children 是【普通数组】（非 $state），子项 init 同步 push，不在 effect 里写 $state。
  * - 触发 Nav 重建 items 的反应量是单独一个 $state revision，子项在挂载后【异步】bump 一次，
  *   脱离挂载 effect 同步栈，避免读写自循环。
- * - Nav.Sub 向下提供一个新的 collector，其 children 指向自己 descriptor 的 children 数组，
- *   从而把嵌套结构按 DOM 顺序、按层级收进普通数组树。
+ * - Nav.Sub 向下提供一个新的 collector，其 children 指向自己 descriptor 的 children 数组。
  */
 export interface NavCollector {
     /** 把一个子项描述符按声明顺序 push 进当前层级的普通数组，返回该描述符（供 Sub 取其 children）。 */

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/nav/context.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,YAAY;IACZ,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;IACzC,aAAa;IACb,eAAe,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,eAAO,MAAM,eAAe,eAAmB,CAAC;AAEhD,6CAA6C;AAC7C,wBAAgB,aAAa,IAAI,UAAU,GAAG,SAAS,CAEtD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,GAAG,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,CAAC;IACtC,iCAAiC;IACjC,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,eAAO,MAAM,iBAAiB,eAA6B,CAAC;AAE5D,wBAAgB,eAAe,IAAI,YAAY,GAAG,SAAS,CAI1D"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/nav/context.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhF,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,YAAY;IACZ,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,YAAY;IACZ,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,mBAAmB;IACnB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9C,sEAAsE;IACtE,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,iEAAiE;IACjE,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACxD,iBAAiB;IACjB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,oBAAoB;IACpB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,oBAAoB;IACpB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,2BAA2B;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,2BAA2B;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,cAAc;IACd,QAAQ,CAAC,iBAAiB,EAAE,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC/E,iBAAiB;IACjB,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,SAAS,CAAC;IACvD,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,EAClB,OAAO,CACL;QACE;YACE,IAAI,EAAE,UAAU,CAAC;YACjB,QAAQ,EAAE,OAAO,CAAC;YAClB,UAAU,EAAE,OAAO,CAAC;YACpB,KAAK,EAAE,UAAU,CAAC;YAClB,QAAQ,EAAE,OAAO,CAAC;SACnB;KACF,CACF,GACD,SAAS,CAAC;IAEd,oBAAoB;IACpB,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACrC,oBAAoB;IACpB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACjC,uCAAuC;IACvC,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IACzD,mCAAmC;IACnC,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAC5E,0BAA0B;IAC1B,eAAe,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,eAAO,MAAM,eAAe,eAAmB,CAAC;AAEhD,kCAAkC;AAClC,wBAAgB,aAAa,IAAI,UAAU,GAAG,SAAS,CAEtD;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,GAAG,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,CAAC;IACtC,iCAAiC;IACjC,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,eAAO,MAAM,iBAAiB,eAA6B,CAAC;AAE5D,wBAAgB,eAAe,IAAI,YAAY,GAAG,SAAS,CAI1D"}

package/dist/nav/context.js

@@ -1,9 +1,13 @@
 /**
- * Nav 上下文：折叠联动（Footer）+ 声明式子项收集（Nav.Item/Nav.Sub）。
+ * Nav 上下文：Nav 独立渲染（不委托 Menu）。分两个 context：
+ *  1) NAV_CONTEXT_KEY — 渲染态与行为（选中/展开/折叠/模式/回调/浮层配置），
+ *     供递归的 NavItemRender / NavSubPopup / NavHeader / NavFooter 读取。
+ *  2) NAV_COLLECTOR_KEY — 声明式子项收集（Nav.Item / Nav.Sub），仅在用 children
+ *     声明式写法时使用，把子项收进普通数组树。
  */
 import { getContext, hasContext } from 'svelte';
 export const NAV_CONTEXT_KEY = Symbol('cd-nav');
-/** Nav.Footer 内部读取 Nav 上下文（无则 undefined）。 */
+/** 读取 Nav 渲染上下文（无则 undefined）。 */
 export function getNavContext() {
     return hasContext(NAV_CONTEXT_KEY) ? getContext(NAV_CONTEXT_KEY) : undefined;
 }

package/dist/nav/index.d.ts

@@ -16,5 +16,5 @@ export declare const Nav: typeof NavRoot & {
     Sub: typeof NavSub;
 };
 export { meta as navMeta } from './meta.js';
-export type { NavItemDef, NavKey, NavMode, NavHeaderConfig, NavFooterConfig } from './types.js';
+export type { NavItemDef, NavItemInput, NavKey, NavMode, NavHeaderConfig, NavFooterConfig, NavSelectData, NavClickData, NavOpenChangeData, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nav/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAC3C,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAC3C,OAAO,OAAO,MAAM,kBAAkB,CAAC;AACvC,OAAO,MAAM,MAAM,iBAAiB,CAAC;AAErC,4CAA4C;AAC5C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,GAAG,EAAE,OAAO,OAAO,GAAG;IACjC,MAAM,EAAE,OAAO,SAAS,CAAC;IACzB,MAAM,EAAE,OAAO,SAAS,CAAC;IACzB,IAAI,EAAE,OAAO,OAAO,CAAC;IACrB,GAAG,EAAE,OAAO,MAAM,CAAC;CAMnB,CAAC;AAEH,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nav/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAC3C,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAC3C,OAAO,OAAO,MAAM,kBAAkB,CAAC;AACvC,OAAO,MAAM,MAAM,iBAAiB,CAAC;AAErC,4CAA4C;AAC5C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,GAAG,EAAE,OAAO,OAAO,GAAG;IACjC,MAAM,EAAE,OAAO,SAAS,CAAC;IACzB,MAAM,EAAE,OAAO,SAAS,CAAC;IACzB,IAAI,EAAE,OAAO,OAAO,CAAC;IACrB,GAAG,EAAE,OAAO,MAAM,CAAC;CAMnB,CAAC;AAEH,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EACV,UAAU,EACV,YAAY,EACZ,MAAM,EACN,OAAO,EACP,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,EACZ,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/nav/meta.d.ts

@@ -5,12 +5,12 @@
 export declare const meta: {
     readonly name: "Nav";
     readonly category: "navigation";
-    readonly description: "站点导航菜单（对齐 Semi Navigation）。支持垂直/水平模式、子导航、logo 头部、折叠按钮。字段对齐 Semi（itemKey/text/icon/items），内部委托 Menu 渲染导航体。";
+    readonly description: "站点导航菜单（对齐 Semi Navigation）。支持垂直/水平模式、子导航（内联/浮层）、logo 头部、折叠按钮、多选。独立渲染，字段/回调对齐 Semi（itemKey/text/icon/items）。";
     readonly props: readonly [{
         readonly name: "items";
-        readonly type: "NavItemDef[]";
+        readonly type: "NavItemInput[]";
         readonly default: "[]";
-        readonly desc: "导航项列表，字段对齐 Semi：itemKey/text/icon/items（含 items 即子导航）";
+        readonly desc: "导航项列表，字段对齐 Semi：itemKey/text/icon/items（含 items 即子导航）。string 项取值作 text 与 itemKey";
     }, {
         readonly name: "mode";
         readonly type: "'vertical'|'horizontal'";
@@ -36,6 +36,11 @@ export declare const meta: {
         readonly type: "NavKey[]";
         readonly default: "undefined";
         readonly desc: "默认展开子导航 key";
+    }, {
+        readonly name: "multiple";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "多选模式（叠加选中，配合 onDeselect）";
     }, {
         readonly name: "isCollapsed";
         readonly type: "boolean";
@@ -56,21 +61,11 @@ export declare const meta: {
         readonly type: "{ collapseButton?: boolean }";
         readonly default: "undefined";
         readonly desc: "底部配置（收起按钮，仅 vertical）";
-    }, {
-        readonly name: "disabled";
-        readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "整体禁用";
-    }, {
-        readonly name: "inlineIndent";
-        readonly type: "number";
-        readonly default: "24";
-        readonly desc: "子级缩进像素（透传 Menu）";
     }, {
         readonly name: "limitIndent";
         readonly type: "boolean";
         readonly default: "true";
-        readonly desc: "仅一级缩进；false 时逐级缩进";
+        readonly desc: "仅一级缩进；false 时逐级缩进（依赖 level+indent）";
     }, {
         readonly name: "toggleIconPosition";
         readonly type: "'left'|'right'";
@@ -89,13 +84,28 @@ export declare const meta: {
     }, {
         readonly name: "subNavOpenDelay";
         readonly type: "number";
-        readonly default: "undefined";
-        readonly desc: "浮层子导航展开延迟 ms";
+        readonly default: "0";
+        readonly desc: "浮层子导航展开延迟 ms（透传 Dropdown mouseEnterDelay）";
     }, {
         readonly name: "subNavCloseDelay";
         readonly type: "number";
+        readonly default: "100";
+        readonly desc: "浮层子导航关闭延迟 ms（透传 Dropdown mouseLeaveDelay）";
+    }, {
+        readonly name: "subDropdownProps";
+        readonly type: "NavDropdownProps";
         readonly default: "undefined";
-        readonly desc: "浮层子导航关闭延迟 ms";
+        readonly desc: "Nav 级：透传给所有子导航浮层 Dropdown 的默认属性";
+    }, {
+        readonly name: "tooltipShowDelay";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "折叠态 tooltip 显示延迟 ms";
+    }, {
+        readonly name: "tooltipHideDelay";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "折叠态 tooltip 隐藏延迟 ms";
     }, {
         readonly name: "getPopupContainer";
         readonly type: "() => HTMLElement";
@@ -106,6 +116,11 @@ export declare const meta: {
         readonly type: "Snippet";
         readonly default: "undefined";
         readonly desc: "自定义导航项外层包裹";
+    }, {
+        readonly name: "renderIcon";
+        readonly type: "Snippet<[NavItemDef]>";
+        readonly default: "undefined";
+        readonly desc: "数据驱动的项图标渲染钩子（本库扩展，Semi 无）：项未自带 icon 时按 item 渲染前置图标，用于 items 大量、图标随 item 变化的场景（如站点侧边栏按组件名取图标）。项自带 icon 优先";
     }, {
         readonly name: "class";
         readonly type: "string";
@@ -121,24 +136,23 @@ export declare const meta: {
         readonly type: "string";
         readonly default: "undefined";
         readonly desc: "导航项列表容器样式（对齐 Semi bodyStyle）";
-    }, {
-        readonly name: "ariaLabel";
-        readonly type: "string";
-        readonly default: "undefined";
-        readonly desc: "可访问性标签";
     }];
     readonly events: readonly [{
         readonly name: "onSelect";
-        readonly payload: "NavKey";
-        readonly desc: "选中导航项时触发";
+        readonly payload: "NavSelectData";
+        readonly desc: "选中导航项时触发（{itemKey,selectedKeys,selectedItems,domEvent,isOpen}）";
+    }, {
+        readonly name: "onDeselect";
+        readonly payload: "NavSelectData";
+        readonly desc: "多选下取消选中时触发";
     }, {
         readonly name: "onClick";
-        readonly payload: "NavKey";
-        readonly desc: "点击任意导航项时触发";
+        readonly payload: "NavClickData";
+        readonly desc: "点击任意导航项时触发（{itemKey,domEvent,isOpen}）";
     }, {
         readonly name: "onOpenChange";
-        readonly payload: "NavKey[]";
-        readonly desc: "展开/收起子导航时触发";
+        readonly payload: "NavOpenChangeData";
+        readonly desc: "展开/收起子导航时触发（{itemKey,openKeys,domEvent,isOpen}）";
     }, {
         readonly name: "onCollapseChange";
         readonly payload: "boolean";
@@ -164,9 +178,19 @@ export declare const meta: {
             readonly desc: "Logo 节点";
         }, {
             readonly name: "text";
-            readonly type: "string";
+            readonly type: "string | Snippet";
             readonly default: "undefined";
             readonly desc: "Logo 文案";
+        }, {
+            readonly name: "link";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "链接地址（整体包裹 <a>）";
+        }, {
+            readonly name: "linkOptions";
+            readonly type: "Record<string,string>";
+            readonly default: "undefined";
+            readonly desc: "透传给 <a> 的属性";
         }, {
             readonly name: "class";
             readonly type: "string";
@@ -183,9 +207,19 @@ export declare const meta: {
         readonly element: "div";
         readonly props: readonly [{
             readonly name: "collapseButton";
-            readonly type: "boolean";
+            readonly type: "boolean | Snippet";
             readonly default: "false";
-            readonly desc: "收起按钮（仅 vertical 生效）";
+            readonly desc: "收起按钮（或自定义节点，仅 vertical 生效）";
+        }, {
+            readonly name: "collapseText";
+            readonly type: "(collapsed: boolean) => string";
+            readonly default: "undefined";
+            readonly desc: "收起按钮文案（默认用 locale）";
+        }, {
+            readonly name: "onClick";
+            readonly type: "(e: MouseEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "点击事件回调";
         }, {
             readonly name: "class";
             readonly type: "string";
@@ -199,7 +233,7 @@ export declare const meta: {
         }];
     }, {
         readonly name: "Nav.Item";
-        readonly element: "—";
+        readonly element: "li[role=menuitem]";
         readonly props: readonly [{
             readonly name: "itemKey";
             readonly type: "NavKey";
@@ -207,7 +241,7 @@ export declare const meta: {
             readonly desc: "导航项唯一标识（必填）";
         }, {
             readonly name: "text";
-            readonly type: "string";
+            readonly type: "string | Snippet";
             readonly default: "—";
             readonly desc: "导航项文案";
         }, {
@@ -218,28 +252,33 @@ export declare const meta: {
         }, {
             readonly name: "disabled";
             readonly type: "boolean";
-            readonly default: "undefined";
+            readonly default: "false";
             readonly desc: "是否禁用";
         }, {
-            readonly name: "link";
-            readonly type: "string";
+            readonly name: "indent";
+            readonly type: "boolean";
             readonly default: "undefined";
-            readonly desc: "链接地址（渲染原生 <a>）";
+            readonly desc: "保留左侧图标占位（对齐 Semi indent）";
         }, {
-            readonly name: "target";
-            readonly type: "string";
+            readonly name: "level";
+            readonly type: "number";
             readonly default: "undefined";
-            readonly desc: "链接 target";
+            readonly desc: "嵌套层级（limitIndent=false 时自定义缩进，对齐 Semi level）";
         }, {
-            readonly name: "rel";
+            readonly name: "link";
             readonly type: "string";
             readonly default: "undefined";
-            readonly desc: "链接 rel";
+            readonly desc: "链接地址（渲染原生 <a>）";
+        }, {
+            readonly name: "linkOptions";
+            readonly type: "Record<string,string>";
+            readonly default: "undefined";
+            readonly desc: "透传给 <a> 的属性（target/rel/download）";
         }, {
             readonly name: "onClick";
-            readonly type: "(e: MouseEvent) => void";
+            readonly type: "(data: NavClickData) => void";
             readonly default: "undefined";
-            readonly desc: "项级点击回调";
+            readonly desc: "项级点击回调（富载荷 {itemKey,domEvent,isOpen}）";
         }, {
             readonly name: "onMouseEnter";
             readonly type: "(e: MouseEvent) => void";
@@ -253,7 +292,7 @@ export declare const meta: {
         }];
     }, {
         readonly name: "Nav.Sub";
-        readonly element: "—";
+        readonly element: "li[role=menuitem]（浮层态用 Dropdown）";
         readonly props: readonly [{
             readonly name: "itemKey";
             readonly type: "NavKey";
@@ -261,7 +300,7 @@ export declare const meta: {
             readonly desc: "子导航唯一标识（必填）";
         }, {
             readonly name: "text";
-            readonly type: "string";
+            readonly type: "string | Snippet";
             readonly default: "—";
             readonly desc: "子导航标题文案";
         }, {
@@ -272,8 +311,48 @@ export declare const meta: {
         }, {
             readonly name: "disabled";
             readonly type: "boolean";
-            readonly default: "undefined";
+            readonly default: "false";
             readonly desc: "是否禁用";
+        }, {
+            readonly name: "indent";
+            readonly type: "boolean";
+            readonly default: "undefined";
+            readonly desc: "保留左侧图标占位（对齐 Semi indent）";
+        }, {
+            readonly name: "level";
+            readonly type: "number";
+            readonly default: "0";
+            readonly desc: "嵌套层级（limitIndent=false 时自定义缩进，对齐 Semi level）";
+        }, {
+            readonly name: "maxHeight";
+            readonly type: "number";
+            readonly default: "999";
+            readonly desc: "子导航最大高度（内联展开动画）";
+        }, {
+            readonly name: "isOpen";
+            readonly type: "boolean";
+            readonly default: "undefined";
+            readonly desc: "子导航是否展开（对齐 Semi isOpen）";
+        }, {
+            readonly name: "dropdownProps";
+            readonly type: "NavDropdownProps";
+            readonly default: "undefined";
+            readonly desc: "透传给该子导航浮层 Dropdown 的属性";
+        }, {
+            readonly name: "dropdownStyle";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "透传给该子导航浮层 Dropdown 的内联样式";
+        }, {
+            readonly name: "onMouseEnter";
+            readonly type: "(e: MouseEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "标题鼠标移入";
+        }, {
+            readonly name: "onMouseLeave";
+            readonly type: "(e: MouseEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "标题鼠标移出";
         }, {
             readonly name: "children";
             readonly type: "Snippet";
@@ -282,12 +361,12 @@ export declare const meta: {
         }];
     }];
     readonly a11y: {
-        readonly role: "navigation";
-        readonly keyboard: readonly ["Tab", "Shift+Tab", "Enter"];
-        readonly notes: readonly ["委托 Menu purpose=navigation：渲染 <nav> landmark + 含 link 的叶子为原生 <a>", "选中项 aria-current=page；折叠按钮原生 button + aria-expanded + aria-label"];
+        readonly role: "menu";
+        readonly keyboard: readonly ["Tab", "Shift+Tab", "Enter", "Space", "ArrowLeft", "ArrowRight"];
+        readonly notes: readonly ["对齐 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 提示）"];
     };
-    readonly tokens: readonly ["--cd-nav-*"];
-    readonly aiHints: readonly ["侧边导航用 mode=vertical + footer={{collapseButton:true}}；顶部导航用 mode=horizontal。", "items 字段对齐 Semi：itemKey/text/icon/items（非 Menu 的 key/label）。", "配合 Layout：<Layout.Sider><Nav mode=vertical/></Layout.Sider> 或 <Layout.Header><Nav mode=horizontal/></Layout.Header>。"];
+    readonly tokens: readonly ["--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"];
+    readonly aiHints: readonly ["侧边导航用 mode=vertical + footer={{collapseButton:true}}；顶部导航用 mode=horizontal。", "items 字段对齐 Semi：itemKey/text/icon/items。", "配合 Layout：<Layout.Sider><Nav mode=vertical/></Layout.Sider> 或 <Layout.Header><Nav mode=horizontal/></Layout.Header>。"];
     readonly examples: readonly [{
         readonly title: "侧边导航";
         readonly code: "<Nav mode=\"vertical\" items={items} header={{logo, text:\"后台\"}} footer={{collapseButton:true}} />";

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

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