@chenzy-design/svelte 0.3.1 → 0.4.1

package/dist/dropdown/DropdownTitle.svelte

@@ -1,34 +1,52 @@
 <!--
-  Dropdown.Title — 不可点击的分组标题（对应 items 数据驱动模式中 type='group' 的 label）。
-  渲染为 role=none 的 li 中的纯展示 div，不接收键盘焦点。
+  Dropdown.Title — 下拉菜单分组标题（对齐 Semi dropdownTitle）。
+  渲染 div.cd-dropdown-title（不可点击、不接收焦点）；showTick 时左内边距让位对勾列。
 -->
 <script lang="ts">
+  import { getContext, type Snippet } from 'svelte';
+  import { DROPDOWN_CTX, type DropdownContext } from './context.js';
+
   interface Props {
-    children?: import('svelte').Snippet;
+    /** 样式类名（对齐 Semi className）。 */
+    class?: string;
+    /** 内联样式（对齐 Semi style）。 */
+    style?: string;
+    children?: Snippet;
   }
 
-  let { children }: Props = $props();
+  let { class: className, style, children }: Props = $props();
+
+  const ctx = getContext<DropdownContext | undefined>(DROPDOWN_CTX);
+  const showTick = $derived(ctx?.showTick ?? false);
+
+  const titleCls = $derived(
+    [
+      'cd-dropdown-title',
+      showTick && 'cd-dropdown-title-withTick',
+      className,
+    ]
+      .filter(Boolean)
+      .join(' '),
+  );
 </script>
 
-<li class="cd-dropdown__group" role="none">
-  <div class="cd-dropdown__group-title">
-    {@render children?.()}
-  </div>
-</li>
+<div class={titleCls} {style}>
+  {@render children?.()}
+</div>
 
 <style>
-  .cd-dropdown__group {
-    margin: 0;
-    padding: 0;
-    list-style: none;
-  }
-  .cd-dropdown__group-title {
-    display: flex;
-    align-items: center;
-    padding: var(--cd-dropdown-item-padding);
-    color: var(--cd-dropdown-item-color-disabled);
+  /* 对齐 Semi .semi-dropdown-title */
+  .cd-dropdown-title {
+    color: var(--cd-color-dropdown-title-text-default);
+    padding-top: var(--cd-spacing-dropdown-title-paddingtop);
+    padding-bottom: var(--cd-spacing-dropdown-title-paddingbottom);
+    padding-left: var(--cd-spacing-dropdown-title-paddingleft);
+    padding-right: var(--cd-spacing-dropdown-title-paddingright);
     font-size: var(--cd-font-size-small);
+    line-height: var(--cd-line-height-small);
     cursor: default;
-    user-select: none;
+  }
+  .cd-dropdown-title-withTick {
+    padding-left: var(--cd-spacing-dropdown-title-withtick-paddingleft);
   }
 </style>

package/dist/dropdown/DropdownTitle.svelte.d.ts

@@ -1,5 +1,10 @@
+import { type Snippet } from 'svelte';
 interface Props {
-    children?: import('svelte').Snippet;
+    /** 样式类名（对齐 Semi className）。 */
+    class?: string;
+    /** 内联样式（对齐 Semi style）。 */
+    style?: string;
+    children?: Snippet;
 }
 declare const DropdownTitle: import("svelte").Component<Props, {}, "">;
 type DropdownTitle = ReturnType<typeof DropdownTitle>;

package/dist/dropdown/DropdownTitle.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DropdownTitle.svelte.d.ts","sourceRoot":"","sources":["../../src/dropdown/DropdownTitle.svelte.ts"],"names":[],"mappings":"AAGE,UAAU,KAAK;IACb,QAAQ,CAAC,EAAE,OAAO,QAAQ,EAAE,OAAO,CAAC;CACrC;AAkBH,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"DropdownTitle.svelte.d.ts","sourceRoot":"","sources":["../../src/dropdown/DropdownTitle.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAIhD,UAAU,KAAK;IACb,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA+BH,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/dropdown/context.d.ts

@@ -1,13 +1,25 @@
 /**
- * Dropdown 子树共享上下文。
- * 透传 getPopupContainer，使递归的 DropdownItemNode 子菜单浮层挂到与顶层
- * 浮层相同的自定义容器；同时透传 showTick，在叶子项右侧渲染勾选标记。
+ * Dropdown 子树共享上下文（对齐 Semi dropdown/context）。
+ *  - showTick：是否在 active 的 Dropdown.Item 左侧显示对勾（IconTick）。
+ *  - level：嵌套层级，顶层 Dropdown 渲染 content 时 +1；子 Dropdown 据此判定
+ *    嵌套（level>1）——用于嵌套默认间距（NESTED_SPACING）与嵌套项事件语义。
+ *  - trigger：顶层触发方式，透传供子层参考。
+ *  - getContainer：浮层挂载容器解析器，子菜单浮层挂到与顶层相同的自定义容器。
  */
 export interface DropdownContext {
-    /** 浮层挂载容器解析器；缺省时（undefined）floating 默认挂 body。 */
-    getContainer?: (() => HTMLElement | null | undefined) | undefined;
-    /** 已选中的 Item 是否显示 ✓ 勾选标记（默认 false）。 */
+    /** active 的 Dropdown.Item 是否显示对勾（默认 false）。 */
     showTick?: boolean;
+    /** 嵌套层级（顶层 content 内为 1，其内的子 Dropdown content 为 2…）。 */
+    level: number;
+    /** 顶层触发方式。 */
+    trigger?: string;
+    /** 浮层挂载容器解析器；缺省（undefined）floating 默认挂 body。 */
+    getContainer?: (() => HTMLElement | null | undefined) | undefined;
+    /**
+     * Dropdown.Item 点击后请求关闭浮层（clickToHide）。由本层 Dropdown 提供，
+     * render 模式下用户手写的 Item 与 menu 生成的 Item 统一经此上抛，行为一致。
+     */
+    requestClose?: () => void;
 }
 export declare const DROPDOWN_CTX: unique symbol;
 //# sourceMappingURL=context.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/dropdown/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,YAAY,CAAC,EAAE,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAClE,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,YAAY,eAA4B,CAAC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/dropdown/context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,YAAY,CAAC,EAAE,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAClE;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,eAAO,MAAM,YAAY,eAA4B,CAAC"}

package/dist/dropdown/index.d.ts

@@ -1,18 +1,15 @@
 import Dropdown_ from './Dropdown.svelte';
 import DropdownItem from './DropdownItem.svelte';
 import DropdownMenu from './DropdownMenu.svelte';
-import DropdownSubMenu from './DropdownSubMenu.svelte';
 import DropdownTitle from './DropdownTitle.svelte';
 import DropdownDivider from './DropdownDivider.svelte';
 export declare const Dropdown: typeof Dropdown_ & {
-    Item: typeof DropdownItem;
     Menu: typeof DropdownMenu;
-    SubMenu: typeof DropdownSubMenu;
+    Item: typeof DropdownItem;
     Title: typeof DropdownTitle;
     Divider: typeof DropdownDivider;
 };
-export { DropdownItem, DropdownMenu, DropdownSubMenu, DropdownTitle, DropdownDivider };
+export { DropdownMenu, DropdownItem, DropdownTitle, DropdownDivider };
 export { meta as dropdownMeta } from './meta.js';
-export { isDropdownDivider, isDropdownGroup, hasDropdownChildren, } from './types.js';
-export type { DropdownItem as DropdownItemType, DropdownItemNode, DropdownDividerNode, DropdownGroupNode, DropdownKey, } from './types.js';
+export type { DropdownKey, DropdownItemType, DropdownMenuItem, DropdownMenuItemItem, DropdownMenuItemTitle, DropdownMenuItemDivider, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dropdown/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,YAAY,MAAM,uBAAuB,CAAC;AACjD,OAAO,YAAY,MAAM,uBAAuB,CAAC;AACjD,OAAO,eAAe,MAAM,0BAA0B,CAAC;AACvD,OAAO,aAAa,MAAM,wBAAwB,CAAC;AACnD,OAAO,eAAe,MAAM,0BAA0B,CAAC;AAGvD,eAAO,MAAM,QAAQ,EAAE,OAAO,SAAS,GAAG;IACxC,IAAI,EAAE,OAAO,YAAY,CAAC;IAC1B,IAAI,EAAE,OAAO,YAAY,CAAC;IAC1B,OAAO,EAAE,OAAO,eAAe,CAAC;IAChC,KAAK,EAAE,OAAO,aAAa,CAAC;IAC5B,OAAO,EAAE,OAAO,eAAe,CAAC;CAOhC,CAAC;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;AACvF,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,YAAY,IAAI,gBAAgB,EAChC,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,GACZ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dropdown/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,YAAY,MAAM,uBAAuB,CAAC;AACjD,OAAO,YAAY,MAAM,uBAAuB,CAAC;AACjD,OAAO,aAAa,MAAM,wBAAwB,CAAC;AACnD,OAAO,eAAe,MAAM,0BAA0B,CAAC;AAGvD,eAAO,MAAM,QAAQ,EAAE,OAAO,SAAS,GAAG;IACxC,IAAI,EAAE,OAAO,YAAY,CAAC;IAC1B,IAAI,EAAE,OAAO,YAAY,CAAC;IAC1B,KAAK,EAAE,OAAO,aAAa,CAAC;IAC5B,OAAO,EAAE,OAAO,eAAe,CAAC;CAMhC,CAAC;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;AACtE,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,YAAY,CAAC"}

package/dist/dropdown/index.js

@@ -1,17 +1,14 @@
 import Dropdown_ from './Dropdown.svelte';
 import DropdownItem from './DropdownItem.svelte';
 import DropdownMenu from './DropdownMenu.svelte';
-import DropdownSubMenu from './DropdownSubMenu.svelte';
 import DropdownTitle from './DropdownTitle.svelte';
 import DropdownDivider from './DropdownDivider.svelte';
-// Dropdown 挂载声明式子组件：Item / Menu / SubMenu / Title / Divider。
+// Dropdown 挂载声明式子组件：Menu / Item / Title / Divider（对齐 Semi 静态成员）。
 export const Dropdown = Object.assign(Dropdown_, {
-    Item: DropdownItem,
     Menu: DropdownMenu,
-    SubMenu: DropdownSubMenu,
+    Item: DropdownItem,
     Title: DropdownTitle,
     Divider: DropdownDivider,
 });
-export { DropdownItem, DropdownMenu, DropdownSubMenu, DropdownTitle, DropdownDivider };
+export { DropdownMenu, DropdownItem, DropdownTitle, DropdownDivider };
 export { meta as dropdownMeta } from './meta.js';
-export { isDropdownDivider, isDropdownGroup, hasDropdownChildren, } from './types.js';

package/dist/dropdown/meta.d.ts

@@ -1,129 +1,249 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
  * See specs/00-foundation/ai-friendly.spec.md.
+ * 全面对齐 Semi Design（semi-ui/dropdown）API 表面。
  */
 export declare const meta: {
     readonly name: "Dropdown";
     readonly category: "navigation";
-    readonly description: "下拉菜单，通过触发元素唤起一组可操作命令项。支持 hover/click/contextMenu 触发、嵌套子菜单、divider 分隔符、group 分组、useDismiss 关闭、键盘导航与危险项。";
+    readonly description: "向下弹出的菜单，通过触发元素唤起一组可操作命令项。对齐 Semi：children 为触发器，render/menu 定义浮层内容（Dropdown.Menu/Item/Title/Divider）；hover/focus/click/custom/contextMenu 触发；12 方位；嵌套子菜单（手动嵌套 Dropdown）；showTick 勾选、type 五色语义、icon、active、disabled；键盘导航与 Esc 关闭。";
     readonly props: readonly [{
-        readonly name: "items";
-        readonly type: "DropdownItem[]";
-        readonly default: "[]";
-        readonly desc: "菜单项数据；判别联合：普通项含 children 即可展开子菜单，type=divider 分隔符，type=group 分组标题";
+        readonly name: "render";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "弹出层内容，由 Dropdown.Menu / Item / Title / Divider 构成（对齐 Semi render）";
+    }, {
+        readonly name: "menu";
+        readonly type: "DropdownMenuItem[]";
+        readonly default: "undefined";
+        readonly desc: "通过 JSON Array 快速配置内容（node=item/title/divider）；render 存在时忽略（对齐 Semi menu）";
+    }, {
+        readonly name: "children";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "触发弹出层的 Trigger 元素（对齐 Semi children）";
     }, {
         readonly name: "trigger";
-        readonly type: "'hover'|'click'|'contextMenu'";
+        readonly type: "'hover'|'focus'|'click'|'custom'|'contextMenu'";
         readonly default: "hover";
-        readonly desc: "触发方式；contextMenu 为右键唤起并定位到光标";
+        readonly desc: "触发方式；custom 需配 visible 受控，contextMenu 右键定位光标";
     }, {
-        readonly name: "open";
+        readonly name: "visible";
         readonly type: "boolean";
         readonly default: "undefined";
-        readonly desc: "受控显隐";
+        readonly desc: "受控显隐，需配合 trigger=custom（对齐 Semi visible）";
     }, {
-        readonly name: "defaultOpen";
+        readonly name: "defaultVisible";
         readonly type: "boolean";
         readonly default: "false";
         readonly desc: "非受控初始显隐";
     }, {
         readonly name: "position";
-        readonly type: "'bottomStart'|'bottomEnd'|'topStart'";
-        readonly default: "bottomStart";
-        readonly desc: "浮层位置";
-    }, {
-        readonly name: "size";
-        readonly type: "'small'|'default'|'large'";
-        readonly default: "default";
-    }, {
-        readonly name: "disabled";
-        readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "禁用整个触发";
+        readonly type: "Placement";
+        readonly default: "bottom";
+        readonly desc: "弹出位置（12 方位，语义对齐 Semi position：bottomStart≈bottomLeft、rightStart≈rightTop）";
     }, {
-        readonly name: "closeOnSelect";
-        readonly type: "boolean";
-        readonly default: "true";
-        readonly desc: "点击项后自动关闭";
-    }, {
-        readonly name: "closeOnEsc";
+        readonly name: "autoAdjustOverflow";
         readonly type: "boolean";
         readonly default: "true";
-        readonly desc: "Esc 是否关闭";
+        readonly desc: "弹出层被遮挡时自动调整方向（对齐 Semi）";
     }, {
         readonly name: "mouseEnterDelay";
         readonly type: "number";
-        readonly default: "150";
-        readonly desc: "hover 进入延迟(ms)";
+        readonly default: "50";
+        readonly desc: "移入 Trigger 后延迟显示(ms)，仅 hover/focus 生效（对齐 Semi）";
     }, {
         readonly name: "mouseLeaveDelay";
         readonly type: "number";
-        readonly default: "150";
-        readonly desc: "hover 离开延迟(ms)";
+        readonly default: "100";
+        readonly desc: "移出弹出层后延迟消失(ms)，仅 hover/focus 生效（对齐 Semi）";
     }, {
         readonly name: "spacing";
         readonly type: "number | { x: number; y: number }";
-        readonly default: "4";
-        readonly desc: "浮层与触发元素间距(px)，映射到 floating 主轴 offset；{ x, y } 按 position 主轴方向取值（上下取 y、左右取 x）";
+        readonly default: "4（嵌套 2）";
+        readonly desc: "弹出层与 Trigger 距离(px)（对齐 Semi spacing）";
     }, {
-        readonly name: "clickToHide";
-        readonly type: "boolean";
-        readonly default: "true";
-        readonly desc: "hover 模式下点击菜单项是否关闭浮层；false 时点击项不关闭（仅移出/Esc/外部点击收起），仅影响 hover 触发";
+        readonly name: "margin";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "弹出层计算溢出的冗余值(px)（对齐 Semi margin）";
     }, {
         readonly name: "zIndex";
         readonly type: "number";
         readonly default: "1050";
-        readonly desc: "浮层层级（写入浮层内联 z-index）";
+        readonly desc: "弹出层 z-index（对齐 Semi zIndex）";
     }, {
-        readonly name: "autoAdjustOverflow";
+        readonly name: "motion";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "下拉动画开关（对齐 Semi motion）";
+    }, {
+        readonly name: "className";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "下拉弹层外层样式类名（作用于 div.cd-dropdown，对齐 Semi className）";
+    }, {
+        readonly name: "contentClassName";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "下拉菜单根元素类名（作用于 div.cd-dropdown-content，对齐 Semi contentClassName）";
+    }, {
+        readonly name: "style";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "弹出层内联样式（作用于 div.cd-dropdown-content，对齐 Semi style）";
+    }, {
+        readonly name: "showTick";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "自动在 active 的 Dropdown.Item 左侧展示对勾（对齐 Semi showTick）";
+    }, {
+        readonly name: "stopPropagation";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "阻止弹出层上的点击事件冒泡（对齐 Semi stopPropagation）";
+    }, {
+        readonly name: "closeOnEsc";
         readonly type: "boolean";
         readonly default: "true";
-        readonly desc: "空间不足时自动翻转/移位到可视区（透传 floating autoAdjust）；false 时严格按 position 定位不翻转";
+        readonly desc: "在 trigger 或弹出层按 Esc 是否关闭，受控时不生效（对齐 Semi closeOnEsc）";
     }, {
-        readonly name: "destroyOnClose";
+        readonly name: "rePosKey";
+        readonly type: "string | number";
+        readonly default: "undefined";
+        readonly desc: "更新该值手动触发弹出层重新定位（对齐 Semi rePosKey）";
+    }, {
+        readonly name: "disableFocusListener";
         readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "关闭即卸载浮层内容（{#if}）重开重建；默认 false 首开后保留 DOM 仅隐藏";
+        readonly desc: "hover 时不响应键盘聚焦弹出事件（对齐 Semi，issue#977）";
     }, {
-        readonly name: "lazyRender";
+        readonly name: "clickToHide";
         readonly type: "boolean";
         readonly default: "true";
-        readonly desc: "首次打开前不渲染浮层内容（惰性）；false 时即使从未打开也预渲染浮层 DOM（仅隐藏）";
+        readonly desc: "弹出层内点击时是否自动关闭弹出层（对齐 Semi clickToHide）";
     }, {
         readonly name: "keepDOM";
         readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "关闭后保留浮层 DOM（与 destroyOnClose 互斥；true 时强制保留，忽略 destroyOnClose）";
+        readonly desc: "关闭时是否保留内部组件 DOM 不销毁（对齐 Semi keepDOM）";
     }, {
         readonly name: "getPopupContainer";
         readonly type: "() => HTMLElement";
         readonly default: "() => document.body";
-        readonly desc: "浮层挂载容器；非 body 容器时改 absolute 相对该容器定位，嵌套子菜单与右键浮层同容器";
+        readonly desc: "指定父级 DOM 挂载弹层（对齐 Semi getPopupContainer）";
     }, {
-        readonly name: "onSelect";
-        readonly type: "(key: string|number) => void";
+        readonly name: "onVisibleChange";
+        readonly type: "(visible: boolean) => void";
         readonly default: "undefined";
+        readonly desc: "弹出层显示状态改变时的回调（对齐 Semi onVisibleChange）";
     }, {
-        readonly name: "onOpenChange";
-        readonly type: "(open: boolean) => void";
+        readonly name: "onEscKeyDown";
+        readonly type: "(e: KeyboardEvent) => void";
         readonly default: "undefined";
+        readonly desc: "在 trigger 或弹出层按 Esc 时调用，关闭逻辑之前（对齐 Semi onEscKeyDown）";
     }, {
-        readonly name: "triggerContent";
-        readonly type: "Snippet";
-        readonly default: "undefined";
-        readonly desc: "触发元素内容";
-    }, {
-        readonly name: "children";
-        readonly type: "Snippet";
+        readonly name: "onClickOutSide";
+        readonly type: "(e: PointerEvent) => void";
         readonly default: "undefined";
-        readonly desc: "自定义浮层内容（提供则忽略 items）";
+        readonly desc: "展示状态下点击外部区域回调，仅 custom/click 有效（对齐 Semi onClickOutSide）";
+    }];
+    readonly subComponents: readonly [{
+        readonly name: "Dropdown.Menu";
+        readonly usage: "<Dropdown.Menu> 包裹 Item / Title / Divider";
+        readonly desc: "下拉弹层菜单容器（对齐 Semi dropdownMenu）：ul[role=menu][aria-orientation=vertical]。";
+        readonly props: readonly [{
+            readonly name: "class";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "菜单 ul 样式类名";
+        }, {
+            readonly name: "style";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "菜单 ul 内联样式";
+        }, {
+            readonly name: "children";
+            readonly type: "Snippet";
+            readonly default: "undefined";
+            readonly desc: "Dropdown.Item / Title / Divider";
+        }];
+    }, {
+        readonly name: "Dropdown.Item";
+        readonly usage: "<Dropdown.Item key type icon active disabled onClick>文本</Dropdown.Item>";
+        readonly desc: "单个菜单项（对齐 Semi dropdownItem）：li[role=menuitem]。showTick 时 active 项左侧对勾。";
+        readonly props: readonly [{
+            readonly name: "key";
+            readonly type: "string | number";
+            readonly default: "undefined";
+            readonly desc: "项键，onClick 携带";
+        }, {
+            readonly name: "disabled";
+            readonly type: "boolean";
+            readonly default: "false";
+            readonly desc: "禁用菜单项（对齐 Semi disabled）";
+        }, {
+            readonly name: "active";
+            readonly type: "boolean";
+            readonly default: "false";
+            readonly desc: "激活态：showTick 时左侧对勾、字重加粗（对齐 Semi active）";
+        }, {
+            readonly name: "type";
+            readonly type: "'primary'|'secondary'|'tertiary'|'warning'|'danger'";
+            readonly default: "undefined";
+            readonly desc: "语义色（对齐 Semi type）";
+        }, {
+            readonly name: "icon";
+            readonly type: "Snippet";
+            readonly default: "undefined";
+            readonly desc: "前置图标（对齐 Semi icon）";
+        }, {
+            readonly name: "onClick";
+            readonly type: "(e: MouseEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "单击回调（对齐 Semi onClick）";
+        }, {
+            readonly name: "onMouseEnter";
+            readonly type: "(e: MouseEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "MouseEnter 回调（对齐 Semi）";
+        }, {
+            readonly name: "onMouseLeave";
+            readonly type: "(e: MouseEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "MouseLeave 回调（对齐 Semi）";
+        }, {
+            readonly name: "onContextMenu";
+            readonly type: "(e: MouseEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "右键回调（对齐 Semi）";
+        }, {
+            readonly name: "children";
+            readonly type: "Snippet";
+            readonly default: "undefined";
+            readonly desc: "菜单项内容";
+        }];
+    }, {
+        readonly name: "Dropdown.Title";
+        readonly usage: "<Dropdown.Title>分组名</Dropdown.Title>";
+        readonly desc: "分组标题（对齐 Semi dropdownTitle）：div.cd-dropdown-title，不可点击/聚焦。";
+        readonly props: readonly [{
+            readonly name: "children";
+            readonly type: "Snippet";
+            readonly default: "undefined";
+            readonly desc: "分组标题内容";
+        }];
+    }, {
+        readonly name: "Dropdown.Divider";
+        readonly usage: "<Dropdown.Divider />";
+        readonly desc: "分隔线（对齐 Semi dropdownDivider）：div.cd-dropdown-divider。";
+        readonly props: readonly [];
     }];
     readonly a11y: {
         readonly role: "menu";
-        readonly keyboard: readonly ["Enter", "Space", "ArrowDown", "ArrowUp", "ArrowRight", "ArrowLeft", "Escape"];
-        readonly notes: readonly ["触发器 aria-haspopup=menu + aria-expanded + aria-controls", "浮层 role=menu，项 role=menuitem，焦点式 roving（tabindex=-1 + 方向键移动焦点）", "子菜单父项 aria-haspopup=menu + aria-expanded；→ 进入子菜单首项，← / Esc 逐层返回", "divider role=separator；group 组标题不可聚焦，组内项始终展开（role=group）", "useDismiss 处理外部点击与 Escape 关闭"];
+        readonly keyboard: readonly ["Enter", "Space", "ArrowDown", "ArrowUp", "Escape"];
+        readonly notes: readonly ["触发器 role=button + aria-haspopup=menu + aria-expanded + aria-controls（嵌套触发器为 Dropdown.Item 自身承担 menuitem 语义）", "浮层 ul role=menu + aria-orientation=vertical，项 li role=menuitem（tabindex=-1，方向键移动焦点漫游）", "click 触发打开后焦点自动落首个非禁用项（对齐 Semi foundation）", "divider role=separator；title 组标题不可聚焦", "Esc 关闭并归还触发器焦点（受控时不生效）；外部点击关闭并回调 onClickOutSide"];
     };
-    readonly tokens: readonly ["--cd-dropdown-*", "--cd-focus-ring", "--cd-border-radius-small", "--cd-spacing-*", "--cd-color-danger"];
+    readonly tokens: readonly ["--cd-radius-dropdown", "--cd-radius-dropdown-item", "--cd-color-dropdown-bg-default", "--cd-color-dropdown-title-text-default", "--cd-color-dropdown-item-text-default", "--cd-color-dropdown-item-bg-hover", "--cd-color-dropdown-item-bg-active", "--cd-color-dropdown-item-danger-text-default", "--cd-color-dropdown-item-secondary-text-default", "--cd-color-dropdown-item-warning-text-default", "--cd-color-dropdown-item-tertiary-text-default", "--cd-color-dropdown-item-primary-text-default", "--cd-color-dropdown-item-disabled-text-default", "--cd-color-dropdown-item-disabled-bg-default", "--cd-color-dropdown-seperator-bg-default", "--cd-spacing-dropdown-menu-paddingy", "--cd-spacing-dropdown-menu-paddingx", "--cd-spacing-dropdown-title-paddingtop", "--cd-spacing-dropdown-title-paddingbottom", "--cd-spacing-dropdown-title-paddingleft", "--cd-spacing-dropdown-title-paddingright", "--cd-spacing-dropdown-title-withtick-paddingleft", "--cd-spacing-dropdown-item-withtick-paddingleft", "--cd-spacing-dropdown-item-paddingy", "--cd-spacing-dropdown-item-paddingx", "--cd-spacing-dropdown-icon-marginright", "--cd-spacing-dropdown-seperator-marginy", "--cd-spacing-dropdown-seperator-marginx", "--cd-width-dropdown", "--cd-size-dropdown-icon-width", "--cd-size-dropdown-icon-height", "--cd-height-dropdown-seperator", "--cd-font-dropdown-item-active-fontweight", "--cd-transition-dropdown-item-bg-duration", "--cd-transition-dropdown-item-bg-function", "--cd-transition-dropdown-item-bg-delay", "--cd-filter-dropdown-bg", "--cd-shadow-elevated", "--cd-z-dropdown", "--cd-font-size-regular", "--cd-line-height-regular", "--cd-font-size-small", "--cd-line-height-small", "--cd-spacing-tight", "--cd-motion-duration-fast", "--cd-motion-ease-standard"];
 };
 //# sourceMappingURL=meta.d.ts.map

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

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