@xihan-ui/vue 1.1.0 → 2.1.0

package/dist/components/menu/use-menu.js

@@ -3,23 +3,33 @@ import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useXhConfig } from "../../config/config.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
-import { computed, ref } from "vue";
-import { connectMenu, menuMachine } from "@xihan-ui/headless";
-import { createRuntimeConfig, createScope } from "@xihan-ui/kernel";
+import { computed, onBeforeUnmount, ref } from "vue";
+import { createRuntimeConfig, createScope } from "@xihan-ui/core";
+import { connectMenu, createMenuTreeNode, menuMachine } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/menu/use-menu.ts
-function useMenu(props, onOpenChange, onSelect) {
+function useMenuImpl(props, onOpenChange, onSelect, treeParent) {
 	const xhConfig = useXhConfig();
 	const triggerRef = ref(null);
 	const positionerRef = ref(null);
 	const contentRef = ref(null);
 	const idGen = createVueIdGenerator();
 	const scope = createScope(null, idGen);
-	const service = useMachine(menuMachine, () => ({
+	let service = null;
+	const tree = createMenuTreeNode({
+		getPositioner: () => positionerRef.value,
+		isOpen: () => service?.state.get() === "open",
+		close: () => service?.send({ type: "CLOSE" }),
+		isRoot: () => !(service?.prop("submenu") ?? props.submenu),
+		onRootSelect: (details) => onSelect?.(details)
+	});
+	service = useMachine(menuMachine, () => ({
 		...props,
 		onOpenChange,
-		onSelect
+		onSelect: treeParent ? tree.select : onSelect
 	}), scope);
+	const releaseParent = treeParent?.registerChild(tree);
+	onBeforeUnmount(() => releaseParent?.());
 	let config = null;
 	if (typeof document !== "undefined") {
 		config = createRuntimeConfig({
@@ -31,7 +41,6 @@ function useMenu(props, onOpenChange, onSelect) {
 			node: () => contentRef.value,
 			branches: () => [triggerRef.value, positionerRef.value].filter(Boolean),
 			isModal: () => false,
-			setModal: () => {},
 			surfaces: () => []
 		});
 		service.refs.set("config", config);
@@ -40,23 +49,36 @@ function useMenu(props, onOpenChange, onSelect) {
 		service.refs.set("getAnchorEl", () => triggerRef.value);
 		service.refs.set("getFloatingEl", () => positionerRef.value);
 		service.refs.set("getContentEl", () => contentRef.value);
+		service.refs.set("getHoverBranches", tree.getHoverBranches);
 	}
 	const api = computed(() => connectMenu(service, vueNormalize));
+	const visible = useOverlayExit({
+		config,
+		isOpen: () => api.value.open,
+		contentRef,
+		onPresence: (presence) => service.refs.set("presence", presence)
+	});
+	const portalTarget = computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body");
 	return {
-		visible: useOverlayExit({
-			config,
-			isOpen: () => api.value.open,
-			contentRef
-		}),
+		visible,
 		service,
 		api,
 		triggerRef,
 		positionerRef,
 		contentRef,
-		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body")
+		tree,
+		portalTarget
 	};
 }
+/** 公开 composable：建立一棵独立菜单树。 */
+function useMenu(props, onOpenChange, onSelect) {
+	return useMenuImpl(props, onOpenChange, onSelect);
+}
+/** 组合部件内部入口：把子菜单连接到 headless 逻辑树。 */
+function useMenuWithParent(props, onOpenChange, treeParent) {
+	return useMenuImpl(props, onOpenChange, void 0, treeParent);
+}
 //#endregion
-export { useMenu };
+export { useMenu, useMenuWithParent };
 
 //# sourceMappingURL=use-menu.js.map

package/dist/components/menu/use-menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-menu.js","names":[],"sources":["../../../src/components/menu/use-menu.ts"],"sourcesContent":["import type { MenuApi, MenuSchema } from '@xihan-ui/headless'\nimport type { Cleanup, Layer, RuntimeConfig } from '@xihan-ui/kernel'\nimport type { Service } from '@xihan-ui/machine'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectMenu, menuMachine } from '@xihan-ui/headless'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/kernel'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface MenuContext {\n  service: Service<MenuSchema>\n  api: ComputedRef<MenuApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 此刻该不该渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层搬到哪儿：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useMenu(\n  props: MenuSchema['props'],\n  onOpenChange?: MenuSchema['props']['onOpenChange'],\n  onSelect?: MenuSchema['props']['onSelect'],\n): MenuContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(menuMachine, () => ({ ...props, onOpenChange, onSelect }), scope)\n\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // trigger 记为本层分支，点它算层内交互；\n      // 浮层壳一并记上：条目列表之外还浮着自绘滚动条，按住它拖动不该把菜单消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      setModal: () => {},\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getAnchorEl', () => triggerRef.value)\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectMenu(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({ config, isOpen: () => api.value.open, contentRef })\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, triggerRef, positionerRef, contentRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AA0BA,SAAgB,QACd,OACA,cACA,UACa;CACb,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,oBAAoB;EAAE,GAAG;EAAO;EAAc;CAAS,IAAI,KAAK;CAG3F,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACtE,eAAe;GACf,gBAAgB,CAAC;GACjB,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;EACtD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAEA,MAAM,MAAM,eAAe,YAAY,SAAS,YAAY,CAAC;CAM7D,OAAO;EAAE,SAJO,eAAe;GAAE;GAAQ,cAAc,IAAI,MAAM;GAAM;EAAW,CAInE;EAAG;EAAS;EAAK;EAAY;EAAe;EAAY,cAFlD,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEvC;CAAE;AACtF"}
+{"version":3,"file":"use-menu.js","names":[],"sources":["../../../src/components/menu/use-menu.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// 提供 use menu 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { MenuApi, MenuSchema, MenuTreeNode } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectMenu, createMenuTreeNode, menuMachine } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, onBeforeUnmount, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface MenuContext {\n  service: Service<MenuSchema>\n  api: ComputedRef<MenuApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** Portal 之外的逻辑父子、悬停区域与选择收链由 headless 节点统一维护。 */\n  tree: MenuTreeNode\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nfunction useMenuImpl(\n  props: MenuSchema['props'],\n  onOpenChange?: MenuSchema['props']['onOpenChange'],\n  onSelect?: MenuSchema['props']['onSelect'],\n  treeParent?: MenuTreeNode,\n): MenuContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  let service: Service<MenuSchema> | null = null\n  const tree = createMenuTreeNode({\n    getPositioner: () => positionerRef.value,\n    isOpen: () => service?.state.get() === 'open',\n    close: () => service?.send({ type: 'CLOSE' }),\n    isRoot: () => !(service?.prop('submenu') ?? props.submenu),\n    onRootSelect: details => onSelect?.(details),\n  })\n  service = useMachine(menuMachine, () => ({\n    ...props,\n    onOpenChange,\n    onSelect: treeParent ? tree.select : onSelect,\n  }), scope)\n  const releaseParent = treeParent?.registerChild(tree)\n  onBeforeUnmount(() => releaseParent?.())\n\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // trigger 记为本层分支，点它算层内交互；\n      // 浮层壳一并记上：条目列表之外还浮着自绘滚动条，按住它拖动不该把菜单消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getAnchorEl', () => triggerRef.value)\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n    service.refs.set('getHoverBranches', tree.getHoverBranches)\n  }\n\n  const api = computed(() => connectMenu(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, triggerRef, positionerRef, contentRef, tree, portalTarget }\n}\n\n/** 公开 composable：建立一棵独立菜单树。 */\nexport function useMenu(\n  props: MenuSchema['props'],\n  onOpenChange?: MenuSchema['props']['onOpenChange'],\n  onSelect?: MenuSchema['props']['onSelect'],\n): MenuContext {\n  return useMenuImpl(props, onOpenChange, onSelect)\n}\n\n/** 组合部件内部入口：把子菜单连接到 headless 逻辑树。 */\nexport function useMenuWithParent(\n  props: MenuSchema['props'],\n  onOpenChange: MenuSchema['props']['onOpenChange'] | undefined,\n  treeParent: MenuTreeNode,\n): MenuContext {\n  return useMenuImpl(props, onOpenChange, undefined, treeParent)\n}\n"],"mappings":";;;;;;;;;;AAkCA,SAAS,YACP,OACA,cACA,UACA,YACa;CACb,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,IAAI,UAAsC;CAC1C,MAAM,OAAO,mBAAmB;EAC9B,qBAAqB,cAAc;EACnC,cAAc,SAAS,MAAM,IAAI,MAAM;EACvC,aAAa,SAAS,KAAK,EAAE,MAAM,QAAQ,CAAC;EAC5C,cAAc,EAAE,SAAS,KAAK,SAAS,KAAK,MAAM;EAClD,eAAc,YAAW,WAAW,OAAO;CAC7C,CAAC;CACD,UAAU,WAAW,oBAAoB;EACvC,GAAG;EACH;EACA,UAAU,aAAa,KAAK,SAAS;CACvC,IAAI,KAAK;CACT,MAAM,gBAAgB,YAAY,cAAc,IAAI;CACpD,sBAAsB,gBAAgB,CAAC;CAGvC,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACtE,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;EACtD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,oBAAoB,KAAK,gBAAgB;CAC5D;CAEA,MAAM,MAAM,eAAe,YAAY,SAAS,YAAY,CAAC;CAE7D,MAAM,UAAU,eAAe;EAC7B;EACA,cAAc,IAAI,MAAM;EACxB;EACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;CAC/D,CAAC;CAED,MAAM,eAAe,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAAM;CAE/H,OAAO;EAAE;EAAS;EAAS;EAAK;EAAY;EAAe;EAAY;EAAM;CAAa;AAC5F;;AAGA,SAAgB,QACd,OACA,cACA,UACa;CACb,OAAO,YAAY,OAAO,cAAc,QAAQ;AAClD;;AAGA,SAAgB,kBACd,OACA,cACA,YACa;CACb,OAAO,YAAY,OAAO,cAAc,KAAA,GAAW,UAAU;AAC/D"}

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

@@ -1,14 +1,8 @@
 import { MenubarContext } from "./use-menubar.js";
-import { ComputedRef } from "vue";
-import { MenubarSelectDetails } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
+import "@xihan-ui/headless";
 //#region src/components/menubar/context.d.ts
-/** 选中链：子菜单任意层级的选中都汇到根——先发根的 select，再关根，各级随父关闭级联收起。 */
-interface MenubarChain {
-  notifySelect: (details: MenubarSelectDetails) => void;
-}
-declare function provideMenubarChain(chain: MenubarChain): void;
-declare function useMenubarChain(): MenubarChain;
-/** 子菜单触发条目要同时够到父菜单栏与本子菜单，这里存父层句柄与它在父层里的身份。 */
+/** 子菜单触发条目要同时访问父菜单栏与本子菜单，这里保存父层句柄与它在父层中的身份。 */
 interface MenubarSubHandle {
   parent: MenubarContext;
   value: string;
@@ -17,5 +11,5 @@ interface MenubarSubHandle {
 declare function provideMenubarSub(handle: MenubarSubHandle): void;
 declare function useMenubarSubContext(): MenubarSubHandle;
 //#endregion
-export { MenubarChain, MenubarSubHandle, provideMenubarChain, provideMenubarSub, useMenubarChain, useMenubarSubContext };
+export { MenubarSubHandle, provideMenubarSub, useMenubarSubContext };
 //# sourceMappingURL=context.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/menubar/context.ts"],"mappings":";;;;;UAoEiB;EACf,eAAe,SAAS;;iBAKV,oBAAoB,OAAO;iBAI3B,mBAAmB;;UAQlB;EACf,QAAQ;EACR;EACA;;iBAKc,kBAAkB,QAAQ;iBAI1B,wBAAwB"}
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/menubar/context.ts"],"mappings":";;;;;UA6EiB;EACf,QAAQ;EACR;EACA;;iBAKc,kBAAkB,QAAQ;iBAI1B,wBAAwB"}

package/dist/components/menubar/context.js

@@ -15,7 +15,7 @@ function useMenubarContext() {
 function provideMenubarMenu(ctx) {
 	provide(MENU_KEY, ctx);
 }
-/** 取所属那一项的身份，不在 positioner 内时返回 null（此时 content 须自带 value）。 */
+/** 取所属菜单项的身份，不在 positioner 内时返回 null（此时 content 须自带 value）。 */
 function useMenubarMenuContext() {
 	return inject(MENU_KEY, null);
 }
@@ -35,15 +35,6 @@ function useMenubarGroupContext() {
 	if (!ctx) throw new Error("[xh] Menubar 分组标题必须用在 XhMenubarGroup 内");
 	return ctx;
 }
-const CHAIN_KEY = Symbol.for("xh-menubar-chain");
-function provideMenubarChain(chain) {
-	provide(CHAIN_KEY, chain);
-}
-function useMenubarChain() {
-	const chain = inject(CHAIN_KEY, null);
-	if (!chain) throw new Error("[xh] MenubarSub 必须用在 XhMenubarRoot 内");
-	return chain;
-}
 const SUB_KEY = Symbol.for("xh-menubar-sub");
 function provideMenubarSub(handle) {
 	provide(SUB_KEY, handle);
@@ -54,6 +45,6 @@ function useMenubarSubContext() {
 	return handle;
 }
 //#endregion
-export { provideMenubar, provideMenubarChain, provideMenubarGroup, provideMenubarItem, provideMenubarMenu, provideMenubarSub, useMenubarChain, useMenubarContext, useMenubarGroupContext, useMenubarItemContext, useMenubarMenuContext, useMenubarSubContext };
+export { provideMenubar, provideMenubarGroup, provideMenubarItem, provideMenubarMenu, provideMenubarSub, useMenubarContext, useMenubarGroupContext, useMenubarItemContext, useMenubarMenuContext, useMenubarSubContext };
 
 //# sourceMappingURL=context.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/menubar/context.ts"],"sourcesContent":["import type { MenubarContentProps, MenubarGroupProps, MenubarItemProps, MenubarSelectDetails } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { MenubarContext } from './use-menubar'\nimport { inject, provide } from 'vue'\n\n/** 某一项菜单自报的身份，供它的 positioner / content 取到同一个值（两者与 trigger 靠它互相认领）。 */\nexport interface MenubarMenuContext {\n  menu: ComputedRef<MenubarContentProps>\n}\n\n/** 条目自报的值与禁用，供 item-text / item-indicator 这类子部件复用同一份声明。 */\nexport interface MenubarItemContext {\n  item: ComputedRef<MenubarItemProps>\n}\n\n/** 分组自报的身份，供分组标题取到同一个值（标题的 id 由它派生）。 */\nexport interface MenubarGroupContext {\n  group: ComputedRef<MenubarGroupProps>\n}\n\nconst KEY: InjectionKey<MenubarContext> = Symbol.for('xh-menubar')\nconst MENU_KEY: InjectionKey<MenubarMenuContext> = Symbol.for('xh-menubar-menu')\nconst ITEM_KEY: InjectionKey<MenubarItemContext> = Symbol.for('xh-menubar-item')\nconst GROUP_KEY: InjectionKey<MenubarGroupContext> = Symbol.for('xh-menubar-group')\n\nexport function provideMenubar(ctx: MenubarContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useMenubarContext(): MenubarContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menubar 部件必须用在 XhMenubarRoot 内')\n  return ctx\n}\n\nexport function provideMenubarMenu(ctx: MenubarMenuContext): void {\n  provide(MENU_KEY, ctx)\n}\n\n/** 取所属那一项的身份，不在 positioner 内时返回 null（此时 content 须自带 value）。 */\nexport function useMenubarMenuContext(): MenubarMenuContext | null {\n  return inject(MENU_KEY, null)\n}\n\nexport function provideMenubarItem(ctx: MenubarItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useMenubarItemContext(): MenubarItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menubar 条目子部件必须用在 XhMenubarItem 内')\n  return ctx\n}\n\nexport function provideMenubarGroup(ctx: MenubarGroupContext): void {\n  provide(GROUP_KEY, ctx)\n}\n\nexport function useMenubarGroupContext(): MenubarGroupContext {\n  const ctx = inject(GROUP_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menubar 分组标题必须用在 XhMenubarGroup 内')\n  return ctx\n}\n\n/** 选中链：子菜单任意层级的选中都汇到根——先发根的 select，再关根，各级随父关闭级联收起。 */\nexport interface MenubarChain {\n  notifySelect: (details: MenubarSelectDetails) => void\n}\n\nconst CHAIN_KEY: InjectionKey<MenubarChain> = Symbol.for('xh-menubar-chain')\n\nexport function provideMenubarChain(chain: MenubarChain): void {\n  provide(CHAIN_KEY, chain)\n}\n\nexport function useMenubarChain(): MenubarChain {\n  const chain = inject(CHAIN_KEY, null)\n  if (!chain)\n    throw new Error('[xh] MenubarSub 必须用在 XhMenubarRoot 内')\n  return chain\n}\n\n/** 子菜单触发条目要同时够到父菜单栏与本子菜单，这里存父层句柄与它在父层里的身份。 */\nexport interface MenubarSubHandle {\n  parent: MenubarContext\n  value: string\n  disabled?: boolean\n}\n\nconst SUB_KEY: InjectionKey<MenubarSubHandle> = Symbol.for('xh-menubar-sub')\n\nexport function provideMenubarSub(handle: MenubarSubHandle): void {\n  provide(SUB_KEY, handle)\n}\n\nexport function useMenubarSubContext(): MenubarSubHandle {\n  const handle = inject(SUB_KEY, null)\n  if (!handle)\n    throw new Error('[xh] MenubarSubTrigger 必须用在 XhMenubarSub 内')\n  return handle\n}\n"],"mappings":";;AAoBA,MAAM,MAAoC,OAAO,IAAI,YAAY;AACjE,MAAM,WAA6C,OAAO,IAAI,iBAAiB;AAC/E,MAAM,WAA6C,OAAO,IAAI,iBAAiB;AAC/E,MAAM,YAA+C,OAAO,IAAI,kBAAkB;AAElF,SAAgB,eAAe,KAA2B;CACxD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,oBAAoC;CAClD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,qCAAqC;CACvD,OAAO;AACT;AAEA,SAAgB,mBAAmB,KAA+B;CAChE,QAAQ,UAAU,GAAG;AACvB;;AAGA,SAAgB,wBAAmD;CACjE,OAAO,OAAO,UAAU,IAAI;AAC9B;AAEA,SAAgB,mBAAmB,KAA+B;CAChE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,wBAA4C;CAC1D,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,wCAAwC;CAC1D,OAAO;AACT;AAEA,SAAgB,oBAAoB,KAAgC;CAClE,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,yBAA8C;CAC5D,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,wCAAwC;CAC1D,OAAO;AACT;AAOA,MAAM,YAAwC,OAAO,IAAI,kBAAkB;AAE3E,SAAgB,oBAAoB,OAA2B;CAC7D,QAAQ,WAAW,KAAK;AAC1B;AAEA,SAAgB,kBAAgC;CAC9C,MAAM,QAAQ,OAAO,WAAW,IAAI;CACpC,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,sCAAsC;CACxD,OAAO;AACT;AASA,MAAM,UAA0C,OAAO,IAAI,gBAAgB;AAE3E,SAAgB,kBAAkB,QAAgC;CAChE,QAAQ,SAAS,MAAM;AACzB;AAEA,SAAgB,uBAAyC;CACvD,MAAM,SAAS,OAAO,SAAS,IAAI;CACnC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,4CAA4C;CAC9D,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/menubar/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 { MenubarContentProps, MenubarGroupProps, MenubarItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey, Ref } from 'vue'\nimport type { MenubarContext } from './use-menubar'\nimport { inject, provide } from 'vue'\n\n/** 某一项菜单声明的身份，供它的 positioner / content 取到同一个值（两者与 trigger 依靠它互相认领）。 */\nexport interface MenubarMenuContext {\n  menu: ComputedRef<MenubarContentProps>\n  /** 这张菜单的内容节点：positioner 给它配自绘条，content 挂载后写回。 */\n  contentRef: Ref<HTMLElement | null>\n}\n\n/** 条目声明的值与禁用，供 item-text / item-indicator 等子部件复用同一份声明。 */\nexport interface MenubarItemContext {\n  item: ComputedRef<MenubarItemProps>\n}\n\n/** 分组声明的身份，供分组标题取到同一个值（标题的 id 由它派生）。 */\nexport interface MenubarGroupContext {\n  group: ComputedRef<MenubarGroupProps>\n}\n\nconst KEY: InjectionKey<MenubarContext> = Symbol.for('xh-menubar')\nconst MENU_KEY: InjectionKey<MenubarMenuContext> = Symbol.for('xh-menubar-menu')\nconst ITEM_KEY: InjectionKey<MenubarItemContext> = Symbol.for('xh-menubar-item')\nconst GROUP_KEY: InjectionKey<MenubarGroupContext> = Symbol.for('xh-menubar-group')\n\nexport function provideMenubar(ctx: MenubarContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useMenubarContext(): MenubarContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menubar 部件必须用在 XhMenubarRoot 内')\n  return ctx\n}\n\nexport function provideMenubarMenu(ctx: MenubarMenuContext): void {\n  provide(MENU_KEY, ctx)\n}\n\n/** 取所属菜单项的身份，不在 positioner 内时返回 null（此时 content 须自带 value）。 */\nexport function useMenubarMenuContext(): MenubarMenuContext | null {\n  return inject(MENU_KEY, null)\n}\n\nexport function provideMenubarItem(ctx: MenubarItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useMenubarItemContext(): MenubarItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menubar 条目子部件必须用在 XhMenubarItem 内')\n  return ctx\n}\n\nexport function provideMenubarGroup(ctx: MenubarGroupContext): void {\n  provide(GROUP_KEY, ctx)\n}\n\nexport function useMenubarGroupContext(): MenubarGroupContext {\n  const ctx = inject(GROUP_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menubar 分组标题必须用在 XhMenubarGroup 内')\n  return ctx\n}\n\n/** 子菜单触发条目要同时访问父菜单栏与本子菜单，这里保存父层句柄与它在父层中的身份。 */\nexport interface MenubarSubHandle {\n  parent: MenubarContext\n  value: string\n  disabled?: boolean\n}\n\nconst SUB_KEY: InjectionKey<MenubarSubHandle> = Symbol.for('xh-menubar-sub')\n\nexport function provideMenubarSub(handle: MenubarSubHandle): void {\n  provide(SUB_KEY, handle)\n}\n\nexport function useMenubarSubContext(): MenubarSubHandle {\n  const handle = inject(SUB_KEY, null)\n  if (!handle)\n    throw new Error('[xh] MenubarSubTrigger 必须用在 XhMenubarSub 内')\n  return handle\n}\n"],"mappings":";;AA6BA,MAAM,MAAoC,OAAO,IAAI,YAAY;AACjE,MAAM,WAA6C,OAAO,IAAI,iBAAiB;AAC/E,MAAM,WAA6C,OAAO,IAAI,iBAAiB;AAC/E,MAAM,YAA+C,OAAO,IAAI,kBAAkB;AAElF,SAAgB,eAAe,KAA2B;CACxD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,oBAAoC;CAClD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,qCAAqC;CACvD,OAAO;AACT;AAEA,SAAgB,mBAAmB,KAA+B;CAChE,QAAQ,UAAU,GAAG;AACvB;;AAGA,SAAgB,wBAAmD;CACjE,OAAO,OAAO,UAAU,IAAI;AAC9B;AAEA,SAAgB,mBAAmB,KAA+B;CAChE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,wBAA4C;CAC1D,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,wCAAwC;CAC1D,OAAO;AACT;AAEA,SAAgB,oBAAoB,KAAgC;CAClE,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,yBAA8C;CAC5D,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,wCAAwC;CAC1D,OAAO;AACT;AASA,MAAM,UAA0C,OAAO,IAAI,gBAAgB;AAE3E,SAAgB,kBAAkB,QAAgC;CAChE,QAAQ,SAAS,MAAM;AACzB;AAEA,SAAgB,uBAAyC;CACvD,MAAM,SAAS,OAAO,SAAS,IAAI;CACnC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,4CAA4C;CAC9D,OAAO;AACT"}

package/dist/components/menubar/menubar.d.ts

@@ -1,28 +1,23 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
+import { Direction, Orientation, Placement, Size, Tone } from "@xihan-ui/core";
 import { MenubarApi, MenubarNode, MenubarNodeMeta, MenubarSchema } from "@xihan-ui/headless";
-import { Direction, Orientation, Placement, Size, Tone } from "@xihan-ui/kernel";
 //#region src/components/menubar/menubar.d.ts
 type MenubarProps = MenubarSchema['props'];
-/** 默认插槽的载荷：当前展开的那一项、有没有菜单展开着，与切换展开项的命令。 */
+/** 默认插槽的载荷：当前展开的菜单项、是否有菜单展开，以及切换展开项的命令。 */
 type MenubarRootSlotProps = Pick<MenubarApi, 'value' | 'open' | 'setValue'>;
-/** role=menubar 根节点：trigger 的 roving tabindex 作用域，各菜单浮层也挂在其内 */
 declare const XhMenubarRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<MenubarNode[]>;
-    default: undefined;
   };
   value: {
     type: PropType<string | null>;
-    default: undefined;
   };
   defaultValue: {
     type: PropType<string | null>;
-    default: undefined;
   };
   orientation: {
     type: PropType<Orientation>;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -30,7 +25,6 @@ declare const XhMenubarRoot: import("vue").DefineComponent<import("vue").Extract
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   disabled: {
     type: BooleanConstructor;
@@ -42,19 +36,18 @@ declare const XhMenubarRoot: import("vue").DefineComponent<import("vue").Extract
   };
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
+  };
+  translations: {
+    type: PropType<MenubarProps["translations"]>;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -65,19 +58,15 @@ declare const XhMenubarRoot: import("vue").DefineComponent<import("vue").Extract
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<MenubarNode[]>;
-    default: undefined;
   };
   value: {
     type: PropType<string | null>;
-    default: undefined;
   };
   defaultValue: {
     type: PropType<string | null>;
-    default: undefined;
   };
   orientation: {
     type: PropType<Orientation>;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -85,7 +74,6 @@ declare const XhMenubarRoot: import("vue").DefineComponent<import("vue").Extract
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   disabled: {
     type: BooleanConstructor;
@@ -97,40 +85,35 @@ declare const XhMenubarRoot: import("vue").DefineComponent<import("vue").Extract
   };
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
+  };
+  translations: {
+    type: PropType<MenubarProps["translations"]>;
   };
 }>> & Readonly<{
   onSelect?: ((_details: import("@xihan-ui/headless").MenubarSelectDetails) => any) | undefined;
   "onValue-change"?: ((_details: import("@xihan-ui/headless").MenubarValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: string | null) => any) | undefined;
 }>, {
-  value: string | null;
-  collection: MenubarNode[];
-  defaultValue: string | null;
-  orientation: Orientation;
-  dir: Direction;
-  tone: Tone;
-  size: Size;
-  disabled: boolean;
-  offset: number;
   loop: boolean;
-  placement: Placement;
+  disabled: boolean;
   typeahead: boolean;
 }, SlotsType<{
   default?: (props: MenubarRootSlotProps) => VNode[];
+  /** 只填条目的文字槽，标记位、副文本与快捷键照旧由数据铺 */
   item?: (node: MenubarNodeMeta) => VNode[];
+  /** 只接管行首那一格，其余槽照旧由数据铺 */
+  'item-prefix'?: (node: MenubarNodeMeta) => VNode[];
+  /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺 */
+  'item-suffix'?: (node: MenubarNodeMeta) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhMenubarTrigger: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
@@ -141,7 +124,7 @@ declare const XhMenubarTrigger: import("vue").DefineComponent<import("vue").Extr
     type: BooleanConstructor;
     default: undefined;
   };
-  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
   asChild: BooleanConstructor;
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -154,7 +137,7 @@ declare const XhMenubarTrigger: import("vue").DefineComponent<import("vue").Extr
     type: BooleanConstructor;
     default: undefined;
   };
-  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
   asChild: BooleanConstructor;
 }>> & Readonly<{}>, {
   disabled: boolean;
@@ -165,6 +148,10 @@ declare const XhMenubarPositioner: import("vue").DefineComponent<import("vue").E
     type: StringConstructor;
     required: true;
   };
+  /** 本实例的 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<import("vue").ExtractPropTypes<{
@@ -172,22 +159,22 @@ declare const XhMenubarPositioner: import("vue").DefineComponent<import("vue").E
     type: StringConstructor;
     required: true;
   };
+  /** 本实例的 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhMenubarContent: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: StringConstructor;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   value: {
     type: StringConstructor;
-    default: undefined;
   };
-}>> & Readonly<{}>, {
-  value: string;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhMenubarGroup: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: StringConstructor;
@@ -233,16 +220,32 @@ declare const XhMenubarItemText: import("vue").DefineComponent<{}, () => VNode<i
 declare const XhMenubarItemIndicator: 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 XhMenubarItemDescription: 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 XhMenubarItemShortcut: 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 XhMenubarItemSuffix: 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>;
+/** 指向本菜单锚点的箭头，纯装饰；须写在同一菜单的 positioner 中 */
+declare const XhMenubarArrow: 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 XhMenubarSeparator: 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>;
-/** XhMenubarSub 默认插槽拿到的东西。 */
+/** XhMenubarSub 默认插槽得到的载荷。 */
 interface MenubarSubSlotProps {
   open: boolean;
   setOpen: (next: boolean) => void;
 }
 declare const XhMenubarSub: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-  /** 它在所属那张菜单里的条目身份。 */
+  /** 它在所属菜单中的条目身份。 */
   value: {
     type: StringConstructor;
     required: true;
@@ -253,11 +256,9 @@ declare const XhMenubarSub: import("vue").DefineComponent<import("vue").ExtractP
   };
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -269,31 +270,26 @@ declare const XhMenubarSub: import("vue").DefineComponent<import("vue").ExtractP
   };
   hoverOpenDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   hoverCloseDelay: {
     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;
   };
 }>, () => 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;
@@ -304,11 +300,9 @@ declare const XhMenubarSub: import("vue").DefineComponent<import("vue").ExtractP
   };
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -320,38 +314,26 @@ declare const XhMenubarSub: import("vue").DefineComponent<import("vue").ExtractP
   };
   hoverOpenDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   hoverCloseDelay: {
     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;
   };
 }>> & Readonly<{}>, {
-  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: MenubarSubSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -359,5 +341,5 @@ declare const XhMenubarSubTrigger: import("vue").DefineComponent<{}, () => VNode
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { MenubarRootSlotProps, MenubarSubSlotProps, XhMenubarContent, XhMenubarGroup, XhMenubarGroupLabel, XhMenubarItem, XhMenubarItemIndicator, XhMenubarItemText, XhMenubarPositioner, XhMenubarRoot, XhMenubarSeparator, XhMenubarSub, XhMenubarSubTrigger, XhMenubarTrigger };
+export { MenubarRootSlotProps, MenubarSubSlotProps, XhMenubarArrow, XhMenubarContent, XhMenubarGroup, XhMenubarGroupLabel, XhMenubarItem, XhMenubarItemDescription, XhMenubarItemIndicator, XhMenubarItemShortcut, XhMenubarItemSuffix, XhMenubarItemText, XhMenubarPositioner, XhMenubarRoot, XhMenubarSeparator, XhMenubarSub, XhMenubarSubTrigger, XhMenubarTrigger };
 //# sourceMappingURL=menubar.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"menubar.d.ts","names":[],"sources":["../../../src/components/menubar/menubar.ts"],"mappings":";;;;;KA2BK,eAAe;;KAmBR,uBAAuB,KAAK;;cAG3B,6BAAa,8BAAA;;IAIO,MAAA,SAAS;;;;IACb,MAAA;;;;IACO,MAAA;;;;IACD,MAAA,SAAS;;;;;;;;IAEjB,MAAA,SAAS;;;;;;;;;;;;IAGH,MAAA,SAAS;;;;;;;;IAEd,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAIN,iBAAA,UAAA,UAAU;EAChB,SAAA,UAAA,UAAU;EACN,iBAAA,QAAA,UAAU;;;IAjBN,MAAA,SAAS;;;;IACb,MAAA;;;;IACO,MAAA;;;;IACD,MAAA,SAAS;;;;;;;;IAEjB,MAAA,SAAS;;;;;;;;;;;;IAGH,MAAA,SAAS;;;;;;;;IAEd,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;EASvB,WAAC,OAAO,yBAAyB;EACpC,QAAC,MAAM,oBAAoB;kCA+BpC;cAEW,gCAAgB,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;qCA4B3B;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;MAqB9B,oDAAA;cAEW,gCAAgB,8BAAA;;;;;;;;;;;;;;qCAgC3B;cAEW,8BAAc,8BAAA;;;;;;;;;;;;MAWzB,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAqCxB;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;UA4Be;EACf;EACA,UAAU;;cAGC,4BAAY,8BAAA;;;;;;;;;;;IAMQ,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;IAOf,MAAA,SAAS;;;;;IAER,MAAA,SAAS;;;;;IAET,MAAA,SAAS;;;;;;;;;;;;;;;;IAXJ,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;IAOf,MAAA,SAAS;;;;;IAER,MAAA,SAAS;;;;;IAET,MAAA,SAAS;;;;;;;;;;;;;;;EAGvB,WAAC,OAAO,wBAAwB;kCAmC5C;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAkB9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"menubar.d.ts","names":[],"sources":["../../../src/components/menubar/menubar.ts"],"mappings":";;;;;KAqCK,eAAe;;KAmBR,uBAAuB,KAAK;cAa3B,6BAAa,8BAAA;;IAIO,MAAA,SAAS;;;IACb,MAAA;;;IACO,MAAA;;;IACD,MAAA,SAAS;;;;;;;IAEjB,MAAA,SAAS;;;;;;;;;;;IAGH,MAAA,SAAS;;;;;;IAEd,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;EAId,iBAAA,UAAA,UAAU;EAChB,SAAA,UAAA,UAAU;EACN,iBAAA,QAAA,UAAU;;;IAlBN,MAAA,SAAS;;;IACb,MAAA;;;IACO,MAAA;;;IACD,MAAA,SAAS;;;;;;;IAEjB,MAAA,SAAS;;;;;;;;;;;IAGH,MAAA,SAAS;;;;;;IAEd,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;;;;;EAS7B,WAAC,OAAO,yBAAyB;;EAEpC,QAAC,MAAM,oBAAoB;;EAEpB,iBAAC,MAAM,oBAAoB;;EAE3B,iBAAC,MAAM,oBAAoB;kCAuB7C;cAEW,gCAAgB,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAqD3B;cAEW,mCAAmB,8BAAA;;;;;;;IAKC,MAAA,SAAS;;;;;;;;;;;IAAT,MAAA,SAAS;;MAsBxC,oDAAA;cAEW,gCAAgB,8BAAA;;;;;;;;;;MAyD3B,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;MAWzB,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAqCxB;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,0BAAA,oBAAA,4BAAA;;8BASzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;UAsEe;EACf;EACA,UAAU;;cAGC,4BAAY,8BAAA;;;;;;;;;;;IAMQ,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;IAOf,MAAA,SAAS;;;;IAER,MAAA,SAAS;;;;IAET,MAAA,SAAS;;;;;;;;;;;;;;;IAXJ,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;IAOf,MAAA,SAAS;;;;IAER,MAAA,SAAS;;;;IAET,MAAA,SAAS;;;;;;;EAGvB,WAAC,OAAO,wBAAwB;kCA6B5C;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAkB9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}