@xihan-ui/vue 1.0.0 → 2.0.0

package/dist/components/menu/context.d.ts

@@ -4,21 +4,13 @@ import { MenuGroupProps } from "@xihan-ui/headless";
 //#region src/components/menu/context.d.ts
 declare function provideMenu(ctx: MenuContext): void;
 declare function useMenuContext(): MenuContext;
-/** 分组自报的身份，供分组标题取到同一个值（标题的 id 由它派生）。 */
+/** 分组声明的身份，供分组标题取到同一个值（标题的 id 由它派生）。 */
 interface MenuGroupContext {
   group: ComputedRef<MenuGroupProps>;
 }
 declare function provideMenuGroup(ctx: MenuGroupContext): void;
 declare function useMenuGroupContext(): MenuGroupContext;
-/** 选中链：任意层级的选中都汇到根——先发根的 select，再关根，各级子层随父关闭级联收起。 */
-interface MenuChain {
-  notifySelect: (details: {
-    value: string;
-  }) => void;
-}
-declare function provideMenuChain(chain: MenuChain): void;
-declare function useMenuChain(): MenuChain;
-/** 子菜单触发条目要同时够到父菜单与本子菜单，这里存父层句柄与它在父层里的身份。 */
+/** 子菜单触发条目要同时访问父菜单与本子菜单，这里保存父层句柄与它在父层中的身份。 */
 interface MenuSubHandle {
   parent: MenuContext;
   value: string;
@@ -27,5 +19,5 @@ interface MenuSubHandle {
 declare function provideMenuSub(handle: MenuSubHandle): void;
 declare function useMenuSubContext(): MenuSubHandle;
 //#endregion
-export { MenuChain, MenuGroupContext, MenuSubHandle, provideMenu, provideMenuChain, provideMenuGroup, provideMenuSub, useMenuChain, useMenuContext, useMenuGroupContext, useMenuSubContext };
+export { MenuGroupContext, MenuSubHandle, provideMenu, provideMenuGroup, provideMenuSub, useMenuContext, useMenuGroupContext, useMenuSubContext };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/menu/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/menu/context.ts"],"mappings":";;;;iBAOgB,YAAY,KAAK;iBAIjB,kBAAkB;;UAQjB;EACf,OAAO,YAAY;;iBAKL,iBAAiB,KAAK;iBAItB,uBAAuB;;UAQtB;EACf,eAAe;IAAW;;;iBAKZ,iBAAiB,OAAO;iBAIxB,gBAAgB;;UAQf;EACf,QAAQ;EACR;EACA;;iBAKc,eAAe,QAAQ;iBAIvB,qBAAqB"}
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/menu/context.ts"],"mappings":";;;;iBAoBgB,YAAY,KAAK;iBAIjB,kBAAkB;;UAmBjB;EACf,OAAO,YAAY;;iBAKL,iBAAiB,KAAK;iBAItB,uBAAuB;;UAQtB;EACf,QAAQ;EACR;EACA;;iBAKc,eAAe,QAAQ;iBAIvB,qBAAqB"}

package/dist/components/menu/context.js

@@ -1,6 +1,7 @@
 import { inject, provide } from "vue";
 //#region src/components/menu/context.ts
 const KEY = Symbol.for("xh-menu");
+const ITEM_KEY = Symbol.for("xh-menu-item");
 function provideMenu(ctx) {
 	provide(KEY, ctx);
 }
@@ -9,6 +10,14 @@ function useMenuContext() {
 	if (!ctx) throw new Error("[xh] Menu 部件必须用在 XhMenuRoot 内");
 	return ctx;
 }
+function provideMenuItem(ctx) {
+	provide(ITEM_KEY, ctx);
+}
+function useMenuItemContext() {
+	const ctx = inject(ITEM_KEY, null);
+	if (!ctx) throw new Error("[xh] Menu 条目子部件必须用在 XhMenuItem 内");
+	return ctx;
+}
 const GROUP_KEY = Symbol.for("xh-menu-group");
 function provideMenuGroup(ctx) {
 	provide(GROUP_KEY, ctx);
@@ -18,15 +27,6 @@ function useMenuGroupContext() {
 	if (!ctx) throw new Error("[xh] Menu 分组标题必须用在 XhMenuGroup 内");
 	return ctx;
 }
-const CHAIN_KEY = Symbol.for("xh-menu-chain");
-function provideMenuChain(chain) {
-	provide(CHAIN_KEY, chain);
-}
-function useMenuChain() {
-	const chain = inject(CHAIN_KEY, null);
-	if (!chain) throw new Error("[xh] MenuSub 必须用在 XhMenuRoot 内");
-	return chain;
-}
 const SUB_KEY = Symbol.for("xh-menu-sub");
 function provideMenuSub(handle) {
 	provide(SUB_KEY, handle);
@@ -37,6 +37,6 @@ function useMenuSubContext() {
 	return handle;
 }
 //#endregion
-export { provideMenu, provideMenuChain, provideMenuGroup, provideMenuSub, useMenuChain, useMenuContext, useMenuGroupContext, useMenuSubContext };
+export { provideMenu, provideMenuGroup, provideMenuItem, provideMenuSub, useMenuContext, useMenuGroupContext, useMenuItemContext, useMenuSubContext };
 
 //# sourceMappingURL=context.js.map

package/dist/components/menu/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/menu/context.ts"],"sourcesContent":["import type { MenuGroupProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { MenuContext } from './use-menu'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<MenuContext> = Symbol.for('xh-menu')\n\nexport function provideMenu(ctx: MenuContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useMenuContext(): MenuContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menu 部件必须用在 XhMenuRoot 内')\n  return ctx\n}\n\n/** 分组自报的身份，供分组标题取到同一个值（标题的 id 由它派生）。 */\nexport interface MenuGroupContext {\n  group: ComputedRef<MenuGroupProps>\n}\n\nconst GROUP_KEY: InjectionKey<MenuGroupContext> = Symbol.for('xh-menu-group')\n\nexport function provideMenuGroup(ctx: MenuGroupContext): void {\n  provide(GROUP_KEY, ctx)\n}\n\nexport function useMenuGroupContext(): MenuGroupContext {\n  const ctx = inject(GROUP_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menu 分组标题必须用在 XhMenuGroup 内')\n  return ctx\n}\n\n/** 选中链：任意层级的选中都汇到根——先发根的 select，再关根，各级子层随父关闭级联收起。 */\nexport interface MenuChain {\n  notifySelect: (details: { value: string }) => void\n}\n\nconst CHAIN_KEY: InjectionKey<MenuChain> = Symbol.for('xh-menu-chain')\n\nexport function provideMenuChain(chain: MenuChain): void {\n  provide(CHAIN_KEY, chain)\n}\n\nexport function useMenuChain(): MenuChain {\n  const chain = inject(CHAIN_KEY, null)\n  if (!chain)\n    throw new Error('[xh] MenuSub 必须用在 XhMenuRoot 内')\n  return chain\n}\n\n/** 子菜单触发条目要同时够到父菜单与本子菜单，这里存父层句柄与它在父层里的身份。 */\nexport interface MenuSubHandle {\n  parent: MenuContext\n  value: string\n  disabled?: boolean\n}\n\nconst SUB_KEY: InjectionKey<MenuSubHandle> = Symbol.for('xh-menu-sub')\n\nexport function provideMenuSub(handle: MenuSubHandle): void {\n  provide(SUB_KEY, handle)\n}\n\nexport function useMenuSubContext(): MenuSubHandle {\n  const handle = inject(SUB_KEY, null)\n  if (!handle)\n    throw new Error('[xh] MenuSubTrigger 必须用在 XhMenuSub 内')\n  return handle\n}\n"],"mappings":";;AAKA,MAAM,MAAiC,OAAO,IAAI,SAAS;AAE3D,SAAgB,YAAY,KAAwB;CAClD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,iBAA8B;CAC5C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT;AAOA,MAAM,YAA4C,OAAO,IAAI,eAAe;AAE5E,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,kCAAkC;CACpD,OAAO;AACT;AAOA,MAAM,YAAqC,OAAO,IAAI,eAAe;AAErE,SAAgB,iBAAiB,OAAwB;CACvD,QAAQ,WAAW,KAAK;AAC1B;AAEA,SAAgB,eAA0B;CACxC,MAAM,QAAQ,OAAO,WAAW,IAAI;CACpC,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,gCAAgC;CAClD,OAAO;AACT;AASA,MAAM,UAAuC,OAAO,IAAI,aAAa;AAErE,SAAgB,eAAe,QAA6B;CAC1D,QAAQ,SAAS,MAAM;AACzB;AAEA,SAAgB,oBAAmC;CACjD,MAAM,SAAS,OAAO,SAAS,IAAI;CACnC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,sCAAsC;CACxD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/menu/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { MenuGroupProps, MenuItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { MenuContext } from './use-menu'\nimport { inject, provide } from 'vue'\n\n/** 条目声明的值与禁用，供 item-text / item-indicator / item-description 等子部件复用同一份声明。 */\nexport interface MenuItemContext {\n  item: ComputedRef<MenuItemProps>\n}\n\nconst KEY: InjectionKey<MenuContext> = Symbol.for('xh-menu')\nconst ITEM_KEY: InjectionKey<MenuItemContext> = Symbol.for('xh-menu-item')\n\nexport function provideMenu(ctx: MenuContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useMenuContext(): MenuContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menu 部件必须用在 XhMenuRoot 内')\n  return ctx\n}\n\nexport function provideMenuItem(ctx: MenuItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useMenuItemContext(): MenuItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menu 条目子部件必须用在 XhMenuItem 内')\n  return ctx\n}\n\n/** 分组声明的身份，供分组标题取到同一个值（标题的 id 由它派生）。 */\nexport interface MenuGroupContext {\n  group: ComputedRef<MenuGroupProps>\n}\n\nconst GROUP_KEY: InjectionKey<MenuGroupContext> = Symbol.for('xh-menu-group')\n\nexport function provideMenuGroup(ctx: MenuGroupContext): void {\n  provide(GROUP_KEY, ctx)\n}\n\nexport function useMenuGroupContext(): MenuGroupContext {\n  const ctx = inject(GROUP_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menu 分组标题必须用在 XhMenuGroup 内')\n  return ctx\n}\n\n/** 子菜单触发条目要同时访问父菜单与本子菜单，这里保存父层句柄与它在父层中的身份。 */\nexport interface MenuSubHandle {\n  parent: MenuContext\n  value: string\n  disabled?: boolean\n}\n\nconst SUB_KEY: InjectionKey<MenuSubHandle> = Symbol.for('xh-menu-sub')\n\nexport function provideMenuSub(handle: MenuSubHandle): void {\n  provide(SUB_KEY, handle)\n}\n\nexport function useMenuSubContext(): MenuSubHandle {\n  const handle = inject(SUB_KEY, null)\n  if (!handle)\n    throw new Error('[xh] MenuSubTrigger 必须用在 XhMenuSub 内')\n  return handle\n}\n"],"mappings":";;AAiBA,MAAM,MAAiC,OAAO,IAAI,SAAS;AAC3D,MAAM,WAA0C,OAAO,IAAI,cAAc;AAEzE,SAAgB,YAAY,KAAwB;CAClD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,iBAA8B;CAC5C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT;AAEA,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,kCAAkC;CACpD,OAAO;AACT;AAOA,MAAM,YAA4C,OAAO,IAAI,eAAe;AAE5E,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,kCAAkC;CACpD,OAAO;AACT;AASA,MAAM,UAAuC,OAAO,IAAI,aAAa;AAErE,SAAgB,eAAe,QAA6B;CAC1D,QAAQ,SAAS,MAAM;AACzB;AAEA,SAAgB,oBAAmC;CACjD,MAAM,SAAS,OAAO,SAAS,IAAI;CACnC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,sCAAsC;CACxD,OAAO;AACT"}

package/dist/components/menu/menu.d.ts

@@ -1,15 +1,14 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
-import { MenuApi, MenuNode, MenuNodeMeta, MenuSchema } from "@xihan-ui/headless";
-import { Direction, Placement, Size, Tone } from "@xihan-ui/kernel";
+import { Direction, Placement, Size, Tone } from "@xihan-ui/core";
+import { MenuApi, MenuNode, MenuNodeMeta, MenuSchema, MenuTranslations } from "@xihan-ui/headless";
 //#region src/components/menu/menu.d.ts
 type MenuProps = MenuSchema['props'];
-/** 默认插槽的载荷：展开态与改展开的动作。 */
+/** 默认插槽的载荷：展开态与修改展开的动作。 */
 type MenuRootSlotProps = Pick<MenuApi, 'open' | 'setOpen'>;
 declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<MenuNode[]>;
-    default: undefined;
   };
   open: {
     type: BooleanConstructor;
@@ -18,11 +17,9 @@ declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPro
   defaultOpen: BooleanConstructor;
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -30,31 +27,37 @@ declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPro
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
+  };
+  typeahead: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  disabled: {
+    type: BooleanConstructor;
     default: undefined;
   };
+  translations: {
+    type: PropType<Partial<MenuTranslations>>;
+  };
   openOnHover: {
     type: BooleanConstructor;
     default: undefined;
   };
   hoverOpenDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   hoverCloseDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   /**
-   * 只交 collection 时，触发器插槽给的那个节点直接当触发器用，不再外包一颗 <button>。
-   * 摆部件的写法有 XhMenuTrigger 自己的 asChild，这个 prop 是给代铺那条路的同一个能力。
+   * 只提供 collection 时，触发器插槽给出的节点直接作为触发器使用，不再外包一个 <button>。
+   * 放置部件的写法有 XhMenuTrigger 自己的 asChild，该 prop 是自动铺设路径的同一能力。
    */
   triggerAsChild: BooleanConstructor;
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
@@ -66,7 +69,6 @@ declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPro
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<MenuNode[]>;
-    default: undefined;
   };
   open: {
     type: BooleanConstructor;
@@ -75,11 +77,9 @@ declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPro
   defaultOpen: BooleanConstructor;
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -87,31 +87,37 @@ declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPro
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
+  };
+  typeahead: {
+    type: BooleanConstructor;
     default: undefined;
   };
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  translations: {
+    type: PropType<Partial<MenuTranslations>>;
+  };
   openOnHover: {
     type: BooleanConstructor;
     default: undefined;
   };
   hoverOpenDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   hoverCloseDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   /**
-   * 只交 collection 时，触发器插槽给的那个节点直接当触发器用，不再外包一颗 <button>。
-   * 摆部件的写法有 XhMenuTrigger 自己的 asChild，这个 prop 是给代铺那条路的同一个能力。
+   * 只提供 collection 时，触发器插槽给出的节点直接作为触发器使用，不再外包一个 <button>。
+   * 放置部件的写法有 XhMenuTrigger 自己的 asChild，该 prop 是自动铺设路径的同一能力。
    */
   triggerAsChild: BooleanConstructor;
 }>> & Readonly<{
@@ -119,18 +125,12 @@ declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPro
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").MenuOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
 }>, {
-  collection: MenuNode[];
-  dir: Direction;
-  tone: Tone;
-  size: Size;
-  offset: number;
+  loop: boolean;
+  disabled: boolean;
   open: boolean;
   defaultOpen: boolean;
-  loop: boolean;
-  placement: Placement;
+  typeahead: boolean;
   openOnHover: boolean;
-  hoverOpenDelay: number;
-  hoverCloseDelay: number;
   triggerAsChild: boolean;
 }, SlotsType<{
   default?: (props: MenuRootSlotProps) => VNode[];
@@ -138,19 +138,29 @@ declare const XhMenuRoot: import("vue").DefineComponent<import("vue").ExtractPro
   item?: (node: MenuNodeMeta) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhMenuTrigger: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
   asChild: BooleanConstructor;
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
   asChild: BooleanConstructor;
 }>> & Readonly<{}>, {
   asChild: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhMenuPositioner: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhMenuPositioner: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 本实例的 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
-}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 本实例的 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhMenuContent: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -177,14 +187,14 @@ declare const XhMenuItem: import("vue").DefineComponent<import("vue").ExtractPro
 }>> & Readonly<{}>, {
   disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/** 默认插槽的载荷：本层子菜单的展开态与改展开的动作。 */
+/** 默认插槽的载荷：本层子菜单的展开态与修改展开的动作。 */
 type MenuSubSlotProps = Pick<MenuApi, 'open' | 'setOpen'>;
 /**
- * 子菜单：内部再跑一台 menu 机器（submenu 模式），触发条目由 XhMenuSubTrigger
- * 渲染成「父菜单条目 + 本子菜单触发器」的双重身份。本身不渲染节点。
+ * 子菜单：内部再运行一台 menu 状态机（submenu 模式），触发条目由 XhMenuSubTrigger
+ * 渲染为父菜单条目与本子菜单触发器的双重身份。本身不渲染节点。
  */
 declare const XhMenuSub: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-  /** 它在父菜单里的条目身份。 */
+  /** 它在父菜单中的条目身份。 */
   value: {
     type: StringConstructor;
     required: true;
@@ -195,15 +205,12 @@ declare const XhMenuSub: import("vue").DefineComponent<import("vue").ExtractProp
   };
   collection: {
     type: PropType<MenuNode[]>;
-    default: undefined;
   };
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -215,31 +222,26 @@ declare const XhMenuSub: import("vue").DefineComponent<import("vue").ExtractProp
   };
   hoverOpenDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
-  /** 文字方向；缺省继承父层。子层被搬到浮层落点，继承不到父层的方向。 */
+  /** 文字方向；默认继承父层。子层被迁移到浮层落点，无法继承父层的方向。 */
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
-  /** 语气；缺省继承父层。子层是浮层落点下的同级节点，CSS 私有槽继承不到。 */
+  /** 语气；默认继承父层。子层是浮层落点下的同级节点，CSS 私有槽无法继承。 */
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
-  /** 尺寸；缺省继承父层，理由同 tone。 */
+  /** 尺寸；默认继承父层，理由同 tone。 */
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
   hoverCloseDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>[] | undefined, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-  /** 它在父菜单里的条目身份。 */
+  /** 它在父菜单中的条目身份。 */
   value: {
     type: StringConstructor;
     required: true;
@@ -250,15 +252,12 @@ declare const XhMenuSub: import("vue").DefineComponent<import("vue").ExtractProp
   };
   collection: {
     type: PropType<MenuNode[]>;
-    default: undefined;
   };
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -270,45 +269,44 @@ declare const XhMenuSub: import("vue").DefineComponent<import("vue").ExtractProp
   };
   hoverOpenDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
-  /** 文字方向；缺省继承父层。子层被搬到浮层落点，继承不到父层的方向。 */
+  /** 文字方向；默认继承父层。子层被迁移到浮层落点，无法继承父层的方向。 */
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
-  /** 语气；缺省继承父层。子层是浮层落点下的同级节点，CSS 私有槽继承不到。 */
+  /** 语气；默认继承父层。子层是浮层落点下的同级节点，CSS 私有槽无法继承。 */
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
-  /** 尺寸；缺省继承父层，理由同 tone。 */
+  /** 尺寸；默认继承父层，理由同 tone。 */
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
   hoverCloseDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
 }>> & Readonly<{}>, {
-  collection: MenuNode[];
-  dir: Direction;
-  tone: Tone;
-  size: Size;
-  disabled: boolean;
-  offset: number;
   loop: boolean;
-  placement: Placement;
+  disabled: boolean;
   openOnHover: boolean;
-  hoverOpenDelay: number;
-  hoverCloseDelay: number;
 }, SlotsType<{
   default?: (props: MenuSubSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhMenuSubTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 条目中的文字载体：连打检索取它，图标与副文本的文字因此不进入检索串 */
+declare const XhMenuItemText: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 条目中的标记位（勾选、图标），纯装饰 */
+declare const XhMenuItemIndicator: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 条目中的副文本，排在文字下一行 */
+declare const XhMenuItemDescription: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhMenuGroup: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: StringConstructor;
@@ -332,5 +330,5 @@ declare const XhMenuArrow: import("vue").DefineComponent<{}, () => VNode<import(
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { MenuRootSlotProps, MenuSubSlotProps, XhMenuArrow, XhMenuContent, XhMenuGroup, XhMenuGroupLabel, XhMenuItem, XhMenuPositioner, XhMenuRoot, XhMenuSeparator, XhMenuSub, XhMenuSubTrigger, XhMenuTrigger };
+export { MenuRootSlotProps, MenuSubSlotProps, XhMenuArrow, XhMenuContent, XhMenuGroup, XhMenuGroupLabel, XhMenuItem, XhMenuItemDescription, XhMenuItemIndicator, XhMenuItemText, XhMenuPositioner, XhMenuRoot, XhMenuSeparator, XhMenuSub, XhMenuSubTrigger, XhMenuTrigger };
 //# sourceMappingURL=menu.d.ts.map

package/dist/components/menu/menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu.d.ts","names":[],"sources":["../../../src/components/menu/menu.ts"],"mappings":";;;;;KAWK,YAAY;;KAGL,oBAAoB,KAAK;cAExB,0BAAU,8BAAA;;IAIU,MAAA,SAAS;;;;;;;;;IAGT,MAAA,SAAS;;;;;;;;;;;;IAGf,MAAA,SAAS;;;;IACR,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;EAYP,gBAAA,UAAA,UAAU;EACf,SAAA,UAAA,UAAU;EACR,gBAAA,OAAA,UAAU;;;IAtBJ,MAAA,SAAS;;;;;;;;;IAGT,MAAA,SAAS;;;;;;;;;;;;IAGf,MAAA,SAAS;;;;IACR,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBvB,WAAC,OAAO,sBAAsB;EAC9B,gBAAM;EACT,QAAC,MAAM,iBAAiB;kCAuBjC;cAEW,6BAAa,8BAAA;;;;;;;;;;qCAuBxB;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAgB3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAYxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0BAAU,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAmCrB;;KAGU,mBAAmB,KAAK;;;;;cAMvB,yBAAS,8BAAA;;;;;;;;;;;IAMW,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;IAMf,MAAA,SAAS;;;;;IAER,MAAA,SAAS;;;;;IAET,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAXJ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;IAMf,MAAA,SAAS;;;;;IAER,MAAA,SAAS;;;;;IAET,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;EAIvB,WAAC,OAAO,qBAAqB;kCA2BzC;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAgB3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,8BAAA;;;;;;;;;;;;MAWtB,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAMtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"menu.d.ts","names":[],"sources":["../../../src/components/menu/menu.ts"],"mappings":";;;;;KAqBK,YAAY;;KAGL,oBAAoB,KAAK;cAExB,0BAAU,8BAAA;;IAIU,MAAA,SAAS;;;;;;;;IAGT,MAAA,SAAS;;;;;;;;;;IAGf,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;IAGD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;;EAYvB,gBAAA,UAAA,UAAU;EACf,SAAA,UAAA,UAAU;EACR,gBAAA,OAAA,UAAU;;;IAzBJ,MAAA,SAAS;;;;;;;;IAGT,MAAA,SAAS;;;;;;;;;;IAGf,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;IAGD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBvC,WAAC,OAAO,sBAAsB;EAC9B,gBAAM;EACT,QAAC,MAAM,iBAAiB;kCAgBjC;cAEW,6BAAa,8BAAA;;;;;;;;;;qCAyBxB;cAEW,gCAAgB,8BAAA;;;IAII,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAYxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0BAAU,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAqCrB;;KAGU,mBAAmB,KAAK;;;;;cAMvB,yBAAS,8BAAA;;;;;;;;;;;IAMW,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;IAMf,MAAA,SAAS;;;;IAER,MAAA,SAAS;;;;IAET,MAAA,SAAS;;;;;;;;;;;;;;;;;;IAXJ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;IAMf,MAAA,SAAS;;;;IAER,MAAA,SAAS;;;;IAET,MAAA,SAAS;;;;;;;;;;EAIvB,WAAC,OAAO,qBAAqB;kCAyBzC;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAgB3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAOzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,8BAAA;;;;;;;;;;;;MAWtB,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAMtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}