@chenzy-design/svelte 0.1.0 → 0.2.0

package/src/menu/MenuKbdFixture.svelte

@@ -1,22 +0,0 @@
-<!--
-  仅供 Menu.kbd.test.ts（browser project）使用的键盘 e2e 夹具。
-  外层 LocaleProvider 提供 context；菜单前放一个「before」按钮，
-  用于验证 Tab 从 before 进入菜单时只停靠在单一 menuitem（roving 单停靠点），
-  而非逐个 menuitem 都进 Tab 序。
--->
-<script lang="ts">
-  import { LocaleProvider } from '../locale-provider/index.js';
-  import Menu from './Menu.svelte';
-
-  const items = [
-    { key: 'home', label: 'Home' },
-    { key: 'profile', label: 'Profile' },
-    { key: 'settings', label: 'Settings' },
-  ];
-</script>
-
-<LocaleProvider locale="en_US">
-  <button type="button" data-testid="before">before</button>
-  <Menu {items} ariaLabel="Main menu" mode="vertical" />
-  <button type="button" data-testid="after">after</button>
-</LocaleProvider>

package/src/menu/MenuPopupNode.svelte

@@ -1,525 +0,0 @@
-<!--
-  MenuPopupNode — vertical 模式下的单个菜单项（递归）。
-  叶子: 普通 menuitem; SubMenu: title + hover 弹出浮层 (use:floating, rightStart)。
-  浮层内继续递归 MenuPopupNode，形成多级 hover 子菜单。
-  hover 意图: 进入 title 延迟开、离开 title 与浮层组延迟关 (closeDelay)，
-  指针移入浮层时取消关闭计时，避免 title→浮层 缝隙抖动。
-  定时器/floating 均命令式管理 + cleanup (红线 #3)。
--->
-<script lang="ts">
-  import type { Snippet } from 'svelte';
-  import { floating } from '../_floating/use-floating.js';
-  import type { Placement } from '@chenzy-design/core';
-  import { isDivider, isGroup } from './types.js';
-  import type { MenuItemDef, MenuItemNode, MenuKey } from './types.js';
-  import Self from './MenuPopupNode.svelte';
-  import { Tooltip } from '../tooltip/index.js';
-
-  interface TooltipProps {
-    content?: string;
-    position?: string;
-    theme?: 'dark' | 'light';
-    mouseEnterDelay?: number;
-    mouseLeaveDelay?: number;
-  }
-
-  interface Props {
-    item: MenuItemDef;
-    /** 顶层节点用 bottomStart 弹出向下，嵌套层用 rightStart 向右 */
-    placement: Placement;
-    isSelected: (key: MenuKey) => boolean;
-    onSelectLeaf: (item: MenuItemNode) => void;
-    /** 选中叶子后自顶向下逐级关闭浮层 */
-    onCloseAll: () => void;
-    openDelay?: number;
-    closeDelay?: number;
-    /** 折叠图标轨：仅本节点（顶层）隐藏文字 label、只显图标，浮层内子项不受影响 */
-    collapsed?: boolean;
-    /** 多选模式：选中叶子显勾选标记并用 aria-checked/menuitemcheckbox 语义 */
-    multiple?: boolean;
-    /** navigation 用途：含 href 叶子渲染原生 <a href>，结构去除 menu/menuitem role（原生链接语义） */
-    navigation?: boolean;
-    /** 浮层子菜单触发方式：'hover'（默认）随悬停开合 / 'click' 点击 title 切换 */
-    trigger?: 'hover' | 'click';
-    /** 浮层子菜单挂载容器（透传 floating action getContainer） */
-    getPopupContainer?: (() => HTMLElement | null | undefined) | undefined;
-    /** 整体禁用（来自父 Menu disabled）：叠加单项 disabled */
-    parentDisabled?: boolean;
-    /** 浮层隐藏时是否卸载内容 DOM（默认 false：保留 DOM 仅隐藏，重显不重建） */
-    destroyOnHide?: boolean;
-    /**
-     * 折叠模式下顶层项的 Tooltip 配置。content 默认为项 label；
-     * position→placement、theme、mouseEnterDelay、mouseLeaveDelay 透传给 Tooltip。
-     */
-    tooltipProps?: TooltipProps;
-    /**
-     * 自定义每个叶子项内容的包裹 Snippet，接收 { item, children }。
-     * children 为默认的 <a> 或 <button> 内容 snippet。
-     */
-    renderWrapper?: Snippet<[{ item: MenuItemNode; children: Snippet }]>;
-  }
-
-  let {
-    item,
-    placement,
-    isSelected,
-    onSelectLeaf,
-    onCloseAll,
-    openDelay = 100,
-    closeDelay = 200,
-    collapsed = false,
-    multiple = false,
-    navigation = false,
-    trigger = 'hover',
-    getPopupContainer,
-    parentDisabled = false,
-    destroyOnHide = false,
-    tooltipProps,
-    renderWrapper,
-  }: Props = $props();
-
-  // 分隔符/分组在模板顶层单独处理；此处统一窄化为普通项节点供后续派生使用。
-  const node = $derived(item as MenuItemNode);
-  // 折叠态无图标时取 label 首字符兜底显示，保证轨上仍有可视标识。
-  const firstChar = $derived([...(node.label ?? '')][0] ?? '');
-
-  const hasChildren = $derived(!!node.children && node.children.length > 0);
-  // 整体 disabled（parentDisabled）叠加单项 disabled。
-  const itemDisabled = $derived(parentDisabled || !!node.disabled);
-
-  let titleEl = $state<HTMLButtonElement | null>(null);
-  let open = $state(false);
-
-  // destroyOnHide=false（默认）时浮层首开后保留 DOM 仅隐藏；true 时随 open 卸载/重建。
-  let hasOpened = $state(false);
-  $effect(() => {
-    if (open) hasOpened = true;
-  });
-  // 浮层是否渲染：destroyOnHide=true 仅 open 时渲染；false 时首开后持续渲染（隐藏由 class 控制）。
-  const shouldRenderSub = $derived(
-    !!titleEl && (destroyOnHide ? open : open || hasOpened),
-  );
-
-  let openTimer: ReturnType<typeof setTimeout> | undefined;
-  let closeTimer: ReturnType<typeof setTimeout> | undefined;
-
-  function clearTimers() {
-    if (openTimer !== undefined) {
-      clearTimeout(openTimer);
-      openTimer = undefined;
-    }
-    if (closeTimer !== undefined) {
-      clearTimeout(closeTimer);
-      closeTimer = undefined;
-    }
-  }
-
-  function scheduleOpen() {
-    if (trigger !== 'hover' || itemDisabled || !hasChildren) return;
-    if (closeTimer !== undefined) {
-      clearTimeout(closeTimer);
-      closeTimer = undefined;
-    }
-    if (open) return;
-    openTimer = setTimeout(() => {
-      open = true;
-      openTimer = undefined;
-    }, openDelay);
-  }
-
-  function scheduleClose() {
-    if (trigger !== 'hover') return;
-    if (openTimer !== undefined) {
-      clearTimeout(openTimer);
-      openTimer = undefined;
-    }
-    if (!open) return;
-    closeTimer = setTimeout(() => {
-      open = false;
-      closeTimer = undefined;
-    }, closeDelay);
-  }
-
-  // 指针移入浮层 → 取消关闭计时，保持打开。
-  function keepOpen() {
-    if (closeTimer !== undefined) {
-      clearTimeout(closeTimer);
-      closeTimer = undefined;
-    }
-  }
-
-  function closeNow() {
-    clearTimers();
-    open = false;
-  }
-
-  function onLeafClick() {
-    if (itemDisabled) return;
-    onSelectLeaf(node);
-    onCloseAll();
-  }
-
-  // click 触发模式：点击 title 切换浮层开合（hover 模式下点击不接管）。
-  function onTitleClick() {
-    if (trigger !== 'click' || itemDisabled || !hasChildren) return;
-    open = !open;
-  }
-
-  // 卸载兜底清理定时器。
-  $effect(() => clearTimers);
-</script>
-
-{#if isDivider(item)}
-  <li class="cd-menu__divider" role={navigation ? undefined : 'separator'}></li>
-{:else if isGroup(item)}
-  <li class="cd-menu__item cd-menu__item--group" role={navigation ? undefined : 'none'}>
-    {#if !collapsed}
-      <div class="cd-menu__group-title">{item.label}</div>
-    {/if}
-    <ul class="cd-menu__group-list" role={navigation ? undefined : 'group'} aria-label={item.label}>
-      {#each item.children as child, i (child.key ?? `__cd-menu-grp-${i}`)}
-        <Self
-          item={child}
-          {placement}
-          {collapsed}
-          {isSelected}
-          {multiple}
-          {navigation}
-          {trigger}
-          {getPopupContainer}
-          {parentDisabled}
-          {destroyOnHide}
-          {tooltipProps}
-          {renderWrapper}
-          {onSelectLeaf}
-          {onCloseAll}
-          {openDelay}
-          {closeDelay}
-        />
-      {/each}
-    </ul>
-  </li>
-{:else if hasChildren}
-  <li
-    class="cd-menu__item cd-menu__item--submenu"
-    role={navigation ? undefined : 'none'}
-    onpointerenter={scheduleOpen}
-    onpointerleave={scheduleClose}
-  >
-    {#snippet titleButton()}
-      <button
-        type="button"
-        class="cd-menu__title"
-        class:cd-menu__title--collapsed={collapsed}
-        role={navigation ? undefined : 'menuitem'}
-        aria-haspopup="true"
-        aria-expanded={open}
-        aria-disabled={itemDisabled || undefined}
-        aria-label={collapsed ? node.label : undefined}
-        disabled={itemDisabled || undefined}
-        bind:this={titleEl}
-        onclick={onTitleClick}
-        onkeydown={(e) => {
-          if (e.key === 'ArrowRight' || e.key === 'Enter' || e.key === ' ') {
-            e.preventDefault();
-            if (hasChildren && !itemDisabled) open = true;
-          } else if (e.key === 'ArrowLeft' || e.key === 'Escape') {
-            closeNow();
-          }
-        }}
-      >
-        {#if node.icon}<span class="cd-menu__icon" aria-hidden="true">{@render node.icon()}</span>{:else if collapsed}<span class="cd-menu__icon cd-menu__icon--char" aria-hidden="true">{firstChar}</span>{/if}
-        {#if !collapsed}<span class="cd-menu__label">{node.label}</span>
-        <span class="cd-menu__arrow cd-menu__arrow--popup" aria-hidden="true">
-          <svg viewBox="0 0 16 16" width="10" height="10" focusable="false">
-            <path fill="currentColor" d="M6 4l4 4-4 4V4Z" />
-          </svg>
-        </span>{/if}
-      </button>
-    {/snippet}
-    {#if collapsed}
-      <Tooltip
-        content={tooltipProps?.content ?? node.label}
-        placement={tooltipProps?.position ?? 'right'}
-        theme={tooltipProps?.theme}
-        mouseEnterDelay={tooltipProps?.mouseEnterDelay}
-        mouseLeaveDelay={tooltipProps?.mouseLeaveDelay}
-      >
-        {@render titleButton()}
-      </Tooltip>
-    {:else}
-      {@render titleButton()}
-    {/if}
-
-    {#if shouldRenderSub}
-      <ul
-        class="cd-menu__sub cd-menu__sub--popup"
-        class:cd-menu__sub--hidden={!open}
-        role={navigation ? undefined : 'menu'}
-        aria-hidden={!open || undefined}
-        use:floating={{ trigger: titleEl, placement, offset: 2, autoAdjust: true, getContainer: getPopupContainer, open }}
-        onpointerenter={keepOpen}
-        onpointerleave={scheduleClose}
-      >
-        {#each node.children ?? [] as child, i (child.key ?? `__cd-menu-sub-${i}`)}
-          <Self
-            item={child}
-            placement="rightStart"
-            {isSelected}
-            {multiple}
-            {navigation}
-            {trigger}
-            {getPopupContainer}
-            {destroyOnHide}
-            parentDisabled={parentDisabled}
-            {onSelectLeaf}
-            {renderWrapper}
-            onCloseAll={() => {
-              closeNow();
-              onCloseAll();
-            }}
-            {openDelay}
-            {closeDelay}
-          />
-        {/each}
-      </ul>
-    {/if}
-  </li>
-{:else}
-  {@const selected = isSelected(node.key)}
-  <li class="cd-menu__item" role={navigation ? undefined : 'none'}>
-    {#if navigation && node.href !== undefined}
-      <!-- navigation 用途：含 href 叶子渲染原生 <a>，原生链接 + Tab 键序 -->
-      {#snippet leafLink()}
-        <a
-          class="cd-menu__link"
-          class:cd-menu__link--selected={selected}
-          class:cd-menu__link--collapsed={collapsed}
-          href={itemDisabled ? undefined : node.href}
-          target={node.target}
-          rel={node.rel}
-          aria-current={selected ? 'page' : undefined}
-          aria-disabled={itemDisabled || undefined}
-          aria-label={collapsed ? node.label : undefined}
-          onclick={onLeafClick}
-        >
-          {#if node.icon}<span class="cd-menu__icon" aria-hidden="true">{@render node.icon()}</span>{:else if collapsed}<span class="cd-menu__icon cd-menu__icon--char" aria-hidden="true">{firstChar}</span>{/if}
-          {#if !collapsed}<span class="cd-menu__label">{node.label}</span>{/if}
-        </a>
-      {/snippet}
-      {#if collapsed}
-        <Tooltip
-          content={tooltipProps?.content ?? node.label}
-          placement={tooltipProps?.position ?? 'right'}
-          theme={tooltipProps?.theme}
-          mouseEnterDelay={tooltipProps?.mouseEnterDelay}
-          mouseLeaveDelay={tooltipProps?.mouseLeaveDelay}
-        >
-          {#if renderWrapper}
-            {@render renderWrapper({ item: node, children: leafLink })}
-          {:else}
-            {@render leafLink()}
-          {/if}
-        </Tooltip>
-      {:else if renderWrapper}
-        {@render renderWrapper({ item: node, children: leafLink })}
-      {:else}
-        {@render leafLink()}
-      {/if}
-    {:else}
-      {#snippet leafButton()}
-        <button
-          type="button"
-          class="cd-menu__link"
-          class:cd-menu__link--selected={selected}
-          class:cd-menu__link--collapsed={collapsed}
-          role={navigation ? undefined : multiple ? 'menuitemcheckbox' : 'menuitem'}
-          aria-current={!navigation && !multiple && selected ? 'true' : undefined}
-          aria-checked={!navigation && multiple ? selected : undefined}
-          aria-disabled={itemDisabled || undefined}
-          aria-label={collapsed ? node.label : undefined}
-          disabled={itemDisabled || undefined}
-          onclick={onLeafClick}
-        >
-          {#if node.icon}<span class="cd-menu__icon" aria-hidden="true">{@render node.icon()}</span>{:else if collapsed}<span class="cd-menu__icon cd-menu__icon--char" aria-hidden="true">{firstChar}</span>{/if}
-          {#if !collapsed}<span class="cd-menu__label">{node.label}</span>{/if}
-          {#if multiple && !collapsed && !navigation}
-            <span class="cd-menu__check" class:cd-menu__check--on={selected} aria-hidden="true">
-              <svg viewBox="0 0 16 16" width="12" height="12" focusable="false">
-                <path fill="none" stroke="currentColor" stroke-width="2" d="M3 8.5l3.5 3.5L13 5" />
-              </svg>
-            </span>
-          {/if}
-        </button>
-      {/snippet}
-      {#if collapsed}
-        <Tooltip
-          content={tooltipProps?.content ?? node.label}
-          placement={tooltipProps?.position ?? 'right'}
-          theme={tooltipProps?.theme}
-          mouseEnterDelay={tooltipProps?.mouseEnterDelay}
-          mouseLeaveDelay={tooltipProps?.mouseLeaveDelay}
-        >
-          {#if renderWrapper}
-            {@render renderWrapper({ item: node, children: leafButton })}
-          {:else}
-            {@render leafButton()}
-          {/if}
-        </Tooltip>
-      {:else if renderWrapper}
-        {@render renderWrapper({ item: node, children: leafButton })}
-      {:else}
-        {@render leafButton()}
-      {/if}
-    {/if}
-  </li>
-{/if}
-
-<style>
-  .cd-menu__item {
-    margin: 0;
-    padding: 0;
-    list-style: none;
-  }
-  /* 分隔符：水平细线，不可交互 */
-  .cd-menu__divider {
-    block-size: 1px;
-    margin-block: var(--cd-spacing-1);
-    background: var(--cd-menu-border-color, var(--cd-color-border));
-  }
-  /* 分组：始终展开的分区标题 + 组内项 */
-  .cd-menu__group-list {
-    margin: 0;
-    padding: 0;
-    list-style: none;
-  }
-  .cd-menu__group-title {
-    display: flex;
-    align-items: center;
-    block-size: var(--cd-menu-item-height);
-    padding-inline: var(--cd-menu-item-padding);
-    color: var(--cd-menu-item-color-disabled);
-    font-size: var(--cd-font-size-1);
-    cursor: default;
-    user-select: none;
-  }
-  .cd-menu__link,
-  .cd-menu__title {
-    display: flex;
-    align-items: center;
-    gap: var(--cd-spacing-2);
-    inline-size: 100%;
-    block-size: var(--cd-menu-item-height);
-    padding-inline: var(--cd-menu-item-padding);
-    border: none;
-    background: transparent;
-    color: var(--cd-menu-item-color);
-    font: inherit;
-    text-align: start;
-    cursor: pointer;
-    transition: background var(--cd-motion-duration-fast) var(--cd-motion-ease-standard);
-  }
-  /* navigation 叶子用 <a> 渲染：抹平默认下划线/颜色，复用 link 视觉 */
-  a.cd-menu__link {
-    text-decoration: none;
-  }
-  a.cd-menu__link[aria-disabled='true'] {
-    color: var(--cd-menu-item-color-disabled);
-    cursor: not-allowed;
-    pointer-events: none;
-  }
-  .cd-menu__link:hover,
-  .cd-menu__title:hover {
-    background: var(--cd-menu-item-bg-hover);
-  }
-  .cd-menu__link:focus-visible,
-  .cd-menu__title:focus-visible {
-    outline: none;
-    box-shadow: var(--cd-focus-ring);
-  }
-  .cd-menu__link--selected {
-    position: relative;
-    color: var(--cd-menu-item-color-selected);
-    background: var(--cd-menu-item-bg-selected);
-  }
-  .cd-menu__link--selected::before {
-    content: '';
-    position: absolute;
-    inset-block: 0;
-    inset-inline-start: 0;
-    inline-size: 3px;
-    background: var(--cd-menu-item-indicator);
-  }
-  .cd-menu__link[aria-disabled='true'],
-  .cd-menu__title[aria-disabled='true'] {
-    color: var(--cd-menu-item-color-disabled);
-    cursor: not-allowed;
-  }
-  .cd-menu__label {
-    flex: 1 1 auto;
-    overflow: hidden;
-    white-space: nowrap;
-    text-overflow: ellipsis;
-  }
-  .cd-menu__icon {
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    flex: 0 0 auto;
-    inline-size: 1rem;
-    block-size: 1rem;
-    color: var(--cd-menu-item-color);
-  }
-  .cd-menu__icon--char {
-    font-weight: 600;
-  }
-  /* 折叠图标轨：顶层项只显图标、居中、无文字与箭头 */
-  .cd-menu__title--collapsed,
-  .cd-menu__link--collapsed {
-    justify-content: center;
-    gap: 0;
-    padding-inline: 0;
-  }
-  .cd-menu__check {
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    flex: 0 0 auto;
-    inline-size: 1rem;
-    block-size: 1rem;
-    color: var(--cd-menu-item-color-selected);
-    opacity: 0;
-  }
-  .cd-menu__check--on {
-    opacity: 1;
-  }
-  .cd-menu__arrow {
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    flex: 0 0 auto;
-    color: var(--cd-menu-submenu-arrow-color);
-  }
-  /* hover 浮层子菜单：脱离内联缩进，独立卡片 */
-  .cd-menu__sub--popup {
-    margin: 0;
-    padding: 0;
-    list-style: none;
-    min-inline-size: 8rem;
-    padding-block: var(--cd-spacing-1);
-    background: var(--cd-menu-bg);
-    border-radius: var(--cd-select-dropdown-radius, 6px);
-    box-shadow: var(--cd-select-dropdown-shadow, 0 4px 12px rgba(0, 0, 0, 0.12));
-    z-index: var(--cd-select-dropdown-z, 1050);
-  }
-  /* destroyOnHide=false 隐藏浮层时保留 DOM 但不可见、不可交互、不占位 */
-  .cd-menu__sub--hidden {
-    display: none;
-  }
-  @media (prefers-reduced-motion: reduce) {
-    .cd-menu__link,
-    .cd-menu__title {
-      transition: none;
-    }
-  }
-</style>

package/src/menu/index.ts

@@ -1,4 +0,0 @@
-export { default as Menu } from './Menu.svelte';
-export { meta as menuMeta } from './meta.js';
-export type { MenuItemDef, MenuPurpose } from './types.js';
-export { deriveMenuSemantics } from './types.js';

package/src/menu/meta.ts

@@ -1,137 +0,0 @@
-/**
- * Machine-readable component metadata for AI/docs consumption.
- * See specs/00-foundation/ai-friendly.spec.md.
- */
-export const meta = {
-  name: 'Menu',
-  category: 'navigation',
-  description:
-    '导航菜单，数据驱动。支持 vertical/inline/horizontal 模式、SubMenu 展开/收起、单选/多选高亮，受控/非受控。items 支持 type=divider 分隔符与 type=group 分组标题。purpose 区分命令式菜单（menu/menuitem 语义）与站点导航（nav landmark + 原生 <a> 链接语义）。',
-  props: [
-    {
-      name: 'items',
-      type: 'MenuItemDef[]',
-      default: '[]',
-      desc: '菜单数据。普通项可省略 type（含 children 即可展开的 SubMenu，item.icon 为项前图标 Snippet）；{ type:"divider" } 渲染水平分隔线；{ type:"group", label, children } 渲染始终展开的分组标题 + 组内项。navigation 用途下叶子可带 href/target/rel，渲染为原生 <a>',
-    },
-    {
-      name: 'mode',
-      type: "'vertical'|'inline'|'horizontal'",
-      default: 'vertical',
-      desc: 'vertical=SubMenu hover 浮层；inline=内联展开；horizontal=顶部菜单栏 + ←→ roving',
-    },
-    {
-      name: 'selectedKeys',
-      type: '(string|number)[]',
-      default: 'undefined',
-      desc: '受控选中项（单选取首项）',
-    },
-    { name: 'defaultSelectedKeys', type: '(string|number)[]', default: '[]' },
-    {
-      name: 'openKeys',
-      type: '(string|number)[]',
-      default: 'undefined',
-      desc: '受控展开的 SubMenu',
-    },
-    { name: 'defaultOpenKeys', type: '(string|number)[]', default: '[]' },
-    { name: 'size', type: "'small'|'default'|'large'", default: 'default' },
-    { name: 'inlineIndent', type: 'number', default: '24', desc: '子级缩进像素' },
-    {
-      name: 'inlineCollapsed',
-      type: 'boolean',
-      default: 'false',
-      desc: 'inline 模式折叠为图标轨：仅显图标、容器变窄，有子菜单的项 hover 向右弹浮层（无图标项取 label 首字符；保留 aria-label/title 可访问名）',
-    },
-    {
-      name: 'multiple',
-      type: 'boolean',
-      default: 'false',
-      desc: '多选模式：点击叶子项 toggle 选中态，selectedKeys 可含多项同时高亮并显勾选标记。受控下父组件依据 onSelect(key) 自行 toggle selectedKeys；非受控由组件内部维护多选 Set',
-    },
-    {
-      name: 'triggerSubMenuAction',
-      type: "'hover'|'click'",
-      default: 'hover',
-      desc: '浮层子菜单触发方式（vertical/horizontal/collapsed 浮层模式生效）：hover 悬停带 open/close 延迟开合；click 点击 title 切换。缺省按 mode 推导（默认 hover）',
-    },
-    { name: 'subMenuOpenDelay', type: 'number', default: '100', desc: 'hover 触发子菜单浮层展开延迟(ms)' },
-    { name: 'subMenuCloseDelay', type: 'number', default: '100', desc: 'hover 触发子菜单浮层收起延迟(ms)' },
-    {
-      name: 'status',
-      type: "'default'|'warning'|'error'",
-      default: 'default',
-      desc: '校验态（表单内菜单选择，少见）：非 default 时加 cd-menu--{status} 类，以 token 着色选中指示条/文字，error 时根节点 aria-invalid=true',
-    },
-    {
-      name: 'destroyOnHide',
-      type: 'boolean',
-      default: 'false',
-      desc: '浮层子菜单隐藏时是否卸载内容 DOM；默认 false 首开后保留 DOM 仅隐藏，true 时随 open 卸载/重建。仅作用于 vertical/horizontal/collapsed 浮层子菜单',
-    },
-    {
-      name: 'getPopupContainer',
-      type: '() => HTMLElement',
-      default: '() => document.body',
-      desc: '浮层子菜单挂载容器（透传 floating action getContainer）；非 body 时改 absolute 相对该容器定位',
-    },
-    { name: 'disabled', type: 'boolean', default: 'false', desc: '整体禁用：所有项不可交互（叠加单项 disabled）' },
-    {
-      name: 'purpose',
-      type: "'menu'|'navigation'",
-      default: 'menu',
-      desc: "语义用途。'menu'（默认，向后兼容）=命令式菜单：role=menu/menuitem + roving tabindex，叶子 button+onClick。'navigation'=站点导航：<nav> landmark 包裹原生 list，含 href 的叶子渲染原生 <a href>（aria-current=page），沿用浏览器链接 + Tab 键序，不用 menuitem role。role 由 deriveMenuSemantics 纯函数据 purpose+mode+multiple 派生",
-    },
-    {
-      name: 'onSelect',
-      type: '(key: string|number) => void',
-      default: 'undefined',
-      desc: '点击叶子项回调，回传被点击的 key（多选语义不变，由父组件据此 toggle）',
-    },
-    {
-      name: 'onOpenChange',
-      type: '(keys: (string|number)[]) => void',
-      default: 'undefined',
-    },
-    { name: 'ariaLabel', type: 'string', default: 'undefined' },
-    {
-      name: 'tooltipProps',
-      type: '{ content?: string; position?: string; theme?: "dark"|"light"; mouseEnterDelay?: number; mouseLeaveDelay?: number }',
-      default: 'undefined',
-      desc: '折叠模式（inlineCollapsed=true）下顶层项的 Tooltip 配置。content 默认为项 label；position→placement 透传给 Tooltip。未提供时用原生 title 属性降级。',
-    },
-    {
-      name: 'renderWrapper',
-      type: 'Snippet<[{ item: MenuItemNode; children: Snippet }]>',
-      default: 'undefined',
-      desc: '自定义叶子项内容包裹 Snippet，接收 { item, children }。children 为默认的 <a> 或 <button>，可在外层加徽标/标签等装饰。inline/vertical/horizontal/collapsed 模式下均生效。',
-    },
-  ],
-  a11y: {
-    role: 'menu',
-    keyboard: ['Tab', 'Enter', 'Space'],
-    notes: [
-      'ul[role=menu] > li[role=none] > button[role=menuitem] 结构',
-      'SubMenu 标题 aria-haspopup=true + aria-expanded 反映展开态',
-      '选中叶子项 aria-current=true（单选）；multiple 下叶子项 role=menuitemcheckbox + aria-checked',
-      '禁用项 aria-disabled=true 且原生 disabled',
-      'divider 渲染 li[role=separator]，不可聚焦不可选；键盘导航天然跳过（非 menuitem）',
-      'group 渲染组标题（不可点击）+ ul[role=group][aria-label=分组名]，组内项正常 menuitem 可选；组标题不可聚焦故键盘跳过',
-      "purpose='navigation'：<nav aria-label> landmark 包裹原生 ul>li>a（去除 menu/menuitem/separator/group 等 role），含 href 叶子为 <a href>，当前项 aria-current=page；用浏览器原生链接 + Tab 键序导航，不接管 ←→ roving",
-      "purpose='menu'（默认）：role=menu/menubar + menuitem，叶子 button + onClick，行为完全向后兼容；role 集合由 deriveMenuSemantics(purpose, mode, multiple) 纯函数派生（红线 #2）",
-    ],
-  },
-  tokens: [
-    '--cd-menu-bg',
-    '--cd-menu-item-height',
-    '--cd-menu-item-padding',
-    '--cd-menu-item-color',
-    '--cd-menu-item-color-selected',
-    '--cd-menu-item-color-disabled',
-    '--cd-menu-item-bg-hover',
-    '--cd-menu-item-bg-selected',
-    '--cd-menu-item-indicator',
-    '--cd-menu-submenu-arrow-color',
-    '--cd-focus-ring',
-    '--cd-motion-*',
-  ],
-} as const;