@xihan-ui/vue 1.1.0 → 2.0.0

package/dist/components/menu/menu.js

@@ -1,61 +1,49 @@
+import { withXhConfig } from "../../config/config.js";
+import { XhPortal } from "../../runtime/portal.js";
 import { useScrollbars } from "../../runtime/use-scrollbars.js";
+import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
-import { provideMenu, provideMenuChain, provideMenuGroup, provideMenuSub, useMenuChain, useMenuContext, useMenuGroupContext, useMenuSubContext } from "./context.js";
-import { useMenu } from "./use-menu.js";
-import { Teleport, computed, defineComponent, h, mergeProps, onBeforeUnmount, ref, watch } from "vue";
-import { mergeProps as mergeProps$1 } from "@xihan-ui/kernel";
+import { provideMenu, provideMenuGroup, provideMenuItem, provideMenuSub, useMenuContext, useMenuGroupContext, useMenuItemContext, useMenuSubContext } from "./context.js";
+import { useMenu, useMenuWithParent } from "./use-menu.js";
+import { computed, defineComponent, h, mergeProps, onBeforeUnmount, ref, watch } from "vue";
+import { mergeProps as mergeProps$1 } from "@xihan-ui/core";
 //#region src/components/menu/menu.ts
-const XhMenuRoot = defineComponent({
+const XhMenuRoot = /* @__PURE__ */ defineComponent({
 	name: "XhMenuRoot",
 	props: {
-		collection: {
-			type: Array,
-			default: void 0
-		},
+		collection: { type: Array },
 		open: {
 			type: Boolean,
 			default: void 0
 		},
 		defaultOpen: Boolean,
-		placement: {
-			type: String,
-			default: void 0
-		},
-		offset: {
-			type: Number,
-			default: void 0
-		},
+		placement: { type: String },
+		offset: { type: Number },
 		loop: {
 			type: Boolean,
 			default: void 0
 		},
-		dir: {
-			type: String,
-			default: void 0
-		},
-		tone: {
-			type: String,
+		dir: { type: String },
+		tone: { type: String },
+		size: { type: String },
+		typeahead: {
+			type: Boolean,
 			default: void 0
 		},
-		size: {
-			type: String,
+		disabled: {
+			type: Boolean,
 			default: void 0
 		},
+		translations: { type: Object },
 		openOnHover: {
 			type: Boolean,
 			default: void 0
 		},
-		hoverOpenDelay: {
-			type: Number,
-			default: void 0
-		},
-		hoverCloseDelay: {
-			type: Number,
-			default: void 0
-		},
+		hoverOpenDelay: { type: Number },
+		hoverCloseDelay: { type: Number },
 		/**
-		* 只交 collection 时，触发器插槽给的那个节点直接当触发器用，不再外包一颗 <button>。
-		* 摆部件的写法有 XhMenuTrigger 自己的 asChild，这个 prop 是给代铺那条路的同一个能力。
+		* 只提供 collection 时，触发器插槽给出的节点直接作为触发器使用，不再外包一个 <button>。
+		* 放置部件的写法有 XhMenuTrigger 自己的 asChild，该 prop 是自动铺设路径的同一能力。
 		*/
 		triggerAsChild: Boolean
 	},
@@ -71,48 +59,54 @@ const XhMenuRoot = defineComponent({
 			emit("update:open", details.open);
 		};
 		const notifySelect = (details) => emit("select", details);
-		const ctx = useMenu(props, notifyOpen, notifySelect);
+		const ctx = useMenu(withXhConfig("menu", props), notifyOpen, notifySelect);
 		provideMenu(ctx);
-		provideMenuChain({ notifySelect: (details) => {
-			emit("select", details);
-			ctx.api.value.setOpen(false);
-		} });
 		return () => slots.default ? slots.default({
 			open: ctx.api.value.open,
 			setOpen: ctx.api.value.setOpen
 		}) : props.collection ? renderDefaultTree(ctx.api.value.collection, slots.trigger?.() ?? null, slots.item, props.triggerAsChild) : [];
 	}
 });
-const XhMenuTrigger = defineComponent({
+const XhMenuTrigger = /* @__PURE__ */ defineComponent({
 	name: "XhMenuTrigger",
+	inheritAttrs: false,
 	props: { 
-	/** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+	/** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
 asChild: Boolean },
-	setup(props, { slots }) {
+	setup(props, { slots, attrs }) {
 		const ctx = useMenuContext();
 		return () => {
-			const attrs = {
+			const part = mergePartProps({
 				...ctx.api.value.getTriggerProps(),
 				ref: (el) => {
 					ctx.triggerRef.value = el;
 				}
-			};
+			}, attrs);
 			const children = slots.default?.();
 			if (props.asChild) {
-				const merged = mergeIntoChild(children, attrs, "menu");
+				const merged = mergeIntoChild(children, part, "menu");
 				if (merged) return merged;
 			}
-			return h("button", attrs, children);
+			return h("button", part, children);
 		};
 	}
 });
-const XhMenuPositioner = defineComponent({
+const XhMenuPositioner = /* @__PURE__ */ defineComponent({
 	name: "XhMenuPositioner",
+	props: { 
+	/** 本实例的 Portal 容器；优先于应用级配置。 */
+container: { type: Object } },
 	inheritAttrs: false,
-	setup(_, { slots, attrs }) {
+	setup(props, { slots, attrs }) {
 		const ctx = useMenuContext();
-		const bars = useScrollbars({ scrollable: () => ctx.contentRef.value });
-		return () => h(Teleport, { to: ctx.portalTarget.value }, [h("div", {
+		const bars = useScrollbars({
+			scrollable: () => ctx.contentRef.value,
+			props: { size: "sm" }
+		});
+		return () => h(XhPortal, {
+			to: props.container ?? ctx.portalTarget.value,
+			source: ctx.triggerRef
+		}, () => [h("div", {
 			...mergeProps(ctx.api.value.getPositionerProps(), attrs),
 			ref: (el) => {
 				ctx.positionerRef.value = el;
@@ -120,7 +114,7 @@ const XhMenuPositioner = defineComponent({
 		}, [...slots.default?.() ?? [], ...bars.render()])]);
 	}
 });
-const XhMenuContent = defineComponent({
+const XhMenuContent = /* @__PURE__ */ defineComponent({
 	name: "XhMenuContent",
 	setup(_, { slots }) {
 		const ctx = useMenuContext();
@@ -133,7 +127,7 @@ const XhMenuContent = defineComponent({
 		}, slots.default?.());
 	}
 });
-const XhMenuItem = defineComponent({
+const XhMenuItem = /* @__PURE__ */ defineComponent({
 	name: "XhMenuItem",
 	props: {
 		value: {
@@ -147,6 +141,10 @@ const XhMenuItem = defineComponent({
 	},
 	setup(props, { slots }) {
 		const ctx = useMenuContext();
+		provideMenuItem({ item: computed(() => ({
+			value: props.value,
+			disabled: props.disabled
+		})) });
 		const itemEl = ref(null);
 		watch(() => props.value, (next, prev) => {
 			if (next === prev) return;
@@ -172,13 +170,13 @@ const XhMenuItem = defineComponent({
 	}
 });
 /**
-* 子菜单：内部再跑一台 menu 机器（submenu 模式），触发条目由 XhMenuSubTrigger
-* 渲染成「父菜单条目 + 本子菜单触发器」的双重身份。本身不渲染节点。
+* 子菜单：内部再运行一台 menu 状态机（submenu 模式），触发条目由 XhMenuSubTrigger
+* 渲染为父菜单条目与本子菜单触发器的双重身份。本身不渲染节点。
 */
-const XhMenuSub = defineComponent({
+const XhMenuSub = /* @__PURE__ */ defineComponent({
 	name: "XhMenuSub",
 	props: {
-		/** 它在父菜单里的条目身份。 */
+		/** 它在父菜单中的条目身份。 */
 		value: {
 			type: String,
 			required: true
@@ -187,18 +185,9 @@ const XhMenuSub = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
-		collection: {
-			type: Array,
-			default: void 0
-		},
-		placement: {
-			type: String,
-			default: void 0
-		},
-		offset: {
-			type: Number,
-			default: void 0
-		},
+		collection: { type: Array },
+		placement: { type: String },
+		offset: { type: Number },
 		loop: {
 			type: Boolean,
 			default: void 0
@@ -207,41 +196,25 @@ const XhMenuSub = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
-		hoverOpenDelay: {
-			type: Number,
-			default: void 0
-		},
-		/** 文字方向；缺省继承父层。子层被搬到浮层落点，继承不到父层的方向。 */
-		dir: {
-			type: String,
-			default: void 0
-		},
-		/** 语气；缺省继承父层。子层是浮层落点下的同级节点，CSS 私有槽继承不到。 */
-		tone: {
-			type: String,
-			default: void 0
-		},
-		/** 尺寸；缺省继承父层，理由同 tone。 */
-		size: {
-			type: String,
-			default: void 0
-		},
-		hoverCloseDelay: {
-			type: Number,
-			default: void 0
-		}
+		hoverOpenDelay: { type: Number },
+		/** 文字方向；默认继承父层。子层被迁移到浮层落点，无法继承父层的方向。 */
+		dir: { type: String },
+		/** 语气；默认继承父层。子层是浮层落点下的同级节点，CSS 私有槽无法继承。 */
+		tone: { type: String },
+		/** 尺寸；默认继承父层，理由同 tone。 */
+		size: { type: String },
+		hoverCloseDelay: { type: Number }
 	},
 	slots: Object,
 	setup(props, { slots }) {
 		const parent = useMenuContext();
-		const chain = useMenuChain();
-		const ctx = useMenu({
+		const ctx = useMenuWithParent({
 			...props,
 			submenu: true,
 			dir: props.dir ?? parent.service.prop("dir"),
 			tone: props.tone ?? parent.service.prop("tone"),
 			size: props.size ?? parent.service.prop("size")
-		}, void 0, (details) => chain.notifySelect(details));
+		}, void 0, parent.tree);
 		provideMenu(ctx);
 		provideMenuSub({
 			parent,
@@ -257,7 +230,7 @@ const XhMenuSub = defineComponent({
 		});
 	}
 });
-const XhMenuSubTrigger = defineComponent({
+const XhMenuSubTrigger = /* @__PURE__ */ defineComponent({
 	name: "XhMenuSubTrigger",
 	setup(_, { slots }) {
 		const sub = useMenuSubContext();
@@ -276,7 +249,34 @@ const XhMenuSubTrigger = defineComponent({
 		}, slots.default?.());
 	}
 });
-const XhMenuGroup = defineComponent({
+/** 条目中的文字载体：连打检索取它，图标与副文本的文字因此不进入检索串 */
+const XhMenuItemText = /* @__PURE__ */ defineComponent({
+	name: "XhMenuItemText",
+	setup(_, { slots }) {
+		const ctx = useMenuContext();
+		const { item } = useMenuItemContext();
+		return () => h("span", ctx.api.value.getItemTextProps(item.value), slots.default?.());
+	}
+});
+/** 条目中的标记位（勾选、图标），纯装饰 */
+const XhMenuItemIndicator = /* @__PURE__ */ defineComponent({
+	name: "XhMenuItemIndicator",
+	setup(_, { slots }) {
+		const ctx = useMenuContext();
+		const { item } = useMenuItemContext();
+		return () => h("span", ctx.api.value.getItemIndicatorProps(item.value), slots.default?.());
+	}
+});
+/** 条目中的副文本，排在文字下一行 */
+const XhMenuItemDescription = /* @__PURE__ */ defineComponent({
+	name: "XhMenuItemDescription",
+	setup(_, { slots }) {
+		const ctx = useMenuContext();
+		const { item } = useMenuItemContext();
+		return () => h("span", ctx.api.value.getItemDescriptionProps(item.value), slots.default?.());
+	}
+});
+const XhMenuGroup = /* @__PURE__ */ defineComponent({
 	name: "XhMenuGroup",
 	props: { value: {
 		type: String,
@@ -289,7 +289,7 @@ const XhMenuGroup = defineComponent({
 		return () => h("div", ctx.api.value.getGroupProps(group.value), slots.default?.());
 	}
 });
-const XhMenuGroupLabel = defineComponent({
+const XhMenuGroupLabel = /* @__PURE__ */ defineComponent({
 	name: "XhMenuGroupLabel",
 	setup(_, { slots }) {
 		const ctx = useMenuContext();
@@ -297,14 +297,14 @@ const XhMenuGroupLabel = defineComponent({
 		return () => h("span", ctx.api.value.getGroupLabelProps(group.value), slots.default?.());
 	}
 });
-const XhMenuSeparator = defineComponent({
+const XhMenuSeparator = /* @__PURE__ */ defineComponent({
 	name: "XhMenuSeparator",
 	setup() {
 		const ctx = useMenuContext();
 		return () => h("div", ctx.api.value.getSeparatorProps());
 	}
 });
-const XhMenuArrow = defineComponent({
+const XhMenuArrow = /* @__PURE__ */ defineComponent({
 	name: "XhMenuArrow",
 	setup() {
 		const ctx = useMenuContext();
@@ -312,9 +312,9 @@ const XhMenuArrow = defineComponent({
 	}
 });
 /**
-* 没写默认插槽时按 collection 铺开的整套结构，作者只交数据。
-* 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。
-* 触发器内容归作者，由 trigger 插槽承载；条目内容缺省是 label，可由 item 插槽接管。
+* 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
+* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
+* 触发器内容归作者，由 trigger 插槽承载；条目内容默认是 label，可由 item 插槽接管。
 */
 function renderDefaultTree(collection, trigger, itemSlot, triggerAsChild) {
 	return [h(XhMenuTrigger, { asChild: triggerAsChild }, () => trigger ?? []), h(XhMenuPositioner, null, () => [h(XhMenuContent, null, () => collection.flatMap((node, index) => [...index > 0 && node.separatorBefore ? [h(XhMenuSeparator, { key: `separator:${node.value}` })] : [], h(XhMenuItem, {
@@ -323,6 +323,6 @@ function renderDefaultTree(collection, trigger, itemSlot, triggerAsChild) {
 	}, () => itemSlot?.(node) ?? node.label)]))])];
 }
 //#endregion
-export { XhMenuArrow, XhMenuContent, XhMenuGroup, XhMenuGroupLabel, XhMenuItem, XhMenuPositioner, XhMenuRoot, XhMenuSeparator, XhMenuSub, XhMenuSubTrigger, XhMenuTrigger };
+export { XhMenuArrow, XhMenuContent, XhMenuGroup, XhMenuGroupLabel, XhMenuItem, XhMenuItemDescription, XhMenuItemIndicator, XhMenuItemText, XhMenuPositioner, XhMenuRoot, XhMenuSeparator, XhMenuSub, XhMenuSubTrigger, XhMenuTrigger };
 
 //# sourceMappingURL=menu.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"menu.js","names":["mergeVueProps","mergeProps"],"sources":["../../../src/components/menu/menu.ts"],"sourcesContent":["import type { MenuApi, MenuGroupProps, MenuNode, MenuNodeMeta, MenuSchema } from '@xihan-ui/headless'\nimport type { Direction, Placement, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { mergeProps } from '@xihan-ui/kernel'\nimport { computed, defineComponent, h, mergeProps as mergeVueProps, onBeforeUnmount, ref, Teleport, watch } from 'vue'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { provideMenu, provideMenuChain, provideMenuGroup, provideMenuSub, useMenuChain, useMenuContext, useMenuGroupContext, useMenuSubContext } from './context'\nimport { useMenu } from './use-menu'\n\ntype MenuProps = MenuSchema['props']\n\n/** 默认插槽的载荷：展开态与改展开的动作。 */\nexport type MenuRootSlotProps = Pick<MenuApi, 'open' | 'setOpen'>\n\nexport const XhMenuRoot = defineComponent({\n  name: 'XhMenuRoot',\n  // 缺省值由 connect 给出，这里一律 default: undefined\n  props: {\n    collection: { type: Array as PropType<MenuNode[]>, default: undefined },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement>, default: undefined },\n    offset: { type: Number, default: undefined },\n    loop: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n    openOnHover: { type: Boolean, default: undefined },\n    hoverOpenDelay: { type: Number, default: undefined },\n    hoverCloseDelay: { type: Number, default: undefined },\n    /**\n     * 只交 collection 时，触发器插槽给的那个节点直接当触发器用，不再外包一颗 <button>。\n     * 摆部件的写法有 XhMenuTrigger 自己的 asChild，这个 prop 是给代铺那条路的同一个能力。\n     */\n    triggerAsChild: Boolean,\n  },\n  // open-change 携带 { open }、select 携带 { value }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<MenuProps, 'onOpenChange'>) => true,\n    'select': (_details: PayloadOf<MenuProps, 'onSelect'>) => true,\n    'update:open': (_open: PayloadOf<MenuProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: MenuRootSlotProps) => VNode[]\n    trigger?: () => VNode[]\n    item?: (node: MenuNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyOpen: MenuProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const notifySelect: MenuProps['onSelect'] = details => emit('select', details)\n    const ctx = useMenu(props as MenuProps, notifyOpen, notifySelect)\n    provideMenu(ctx)\n    // 任意层级子菜单的选中都汇到根：先发根的 select 再关根，各级随父关闭级联收起\n    provideMenuChain({\n      notifySelect: (details) => {\n        emit('select', details)\n        ctx.api.value.setOpen(false)\n      },\n    })\n    return () => (slots.default\n      ? slots.default({ open: ctx.api.value.open, setOpen: ctx.api.value.setOpen })\n      : props.collection\n        ? renderDefaultTree(ctx.api.value.collection, slots.trigger?.() ?? null, slots.item, props.triggerAsChild)\n        : [])\n  },\n})\n\nexport const XhMenuTrigger = defineComponent({\n  name: 'XhMenuTrigger',\n  props: {\n    /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = useMenuContext()\n    return () => {\n      const attrs = {\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, attrs, 'menu')\n        if (merged)\n          return merged\n      }\n      return h('button', attrs, children)\n    }\n  },\n})\n\nexport const XhMenuPositioner = defineComponent({\n  name: 'XhMenuPositioner',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useMenuContext()\n    // 条目列表的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value })\n    // 定位层搬到 portal 落点，逃开祖先的层叠上下文\n    return () => h(Teleport, { to: ctx.portalTarget.value }, [\n      h('div', {\n        ...mergeVueProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhMenuContent = defineComponent({\n  name: 'XhMenuContent',\n  setup(_, { slots }) {\n    const ctx = useMenuContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场\n      // 就一帧都播不出来），所以真正的收起落成内联 display——节点始终留在原地\n      style: ctx.visible.value ? undefined : { display: 'none' },\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhMenuItem = defineComponent({\n  name: 'XhMenuItem',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useMenuContext()\n    // 本条目持有焦点时，value 变更按新值重报焦点条目，卸载时上报焦点丢失\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const svc = ctx.service\n      if (svc.getStatus() !== 'Started')\n        return\n      if (itemEl.value && svc.scope.getActiveElement() === itemEl.value)\n        svc.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      // 根已停机时不再送事件\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'ITEM.LOST' })\n    })\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\n/** 默认插槽的载荷：本层子菜单的展开态与改展开的动作。 */\nexport type MenuSubSlotProps = Pick<MenuApi, 'open' | 'setOpen'>\n\n/**\n * 子菜单：内部再跑一台 menu 机器（submenu 模式），触发条目由 XhMenuSubTrigger\n * 渲染成「父菜单条目 + 本子菜单触发器」的双重身份。本身不渲染节点。\n */\nexport const XhMenuSub = defineComponent({\n  name: 'XhMenuSub',\n  props: {\n    /** 它在父菜单里的条目身份。 */\n    value: { type: String, required: true },\n    disabled: { type: Boolean, default: undefined },\n    collection: { type: Array as PropType<MenuNode[]>, default: undefined },\n    placement: { type: String as PropType<Placement>, default: undefined },\n    offset: { type: Number, default: undefined },\n    loop: { type: Boolean, default: undefined },\n    openOnHover: { type: Boolean, default: undefined },\n    hoverOpenDelay: { type: Number, default: undefined },\n    /** 文字方向；缺省继承父层。子层被搬到浮层落点，继承不到父层的方向。 */\n    dir: { type: String as PropType<Direction>, default: undefined },\n    /** 语气；缺省继承父层。子层是浮层落点下的同级节点，CSS 私有槽继承不到。 */\n    tone: { type: String as PropType<Tone>, default: undefined },\n    /** 尺寸；缺省继承父层，理由同 tone。 */\n    size: { type: String as PropType<Size>, default: undefined },\n    hoverCloseDelay: { type: Number, default: undefined },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: MenuSubSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const parent = useMenuContext()\n    const chain = useMenuChain()\n    const ctx = useMenu(\n      {\n        ...props,\n        submenu: true,\n        dir: props.dir ?? parent.service.prop('dir'),\n        tone: props.tone ?? parent.service.prop('tone'),\n        size: props.size ?? parent.service.prop('size'),\n      } as MenuProps,\n      undefined,\n      // 子层的选中汇到根：根发 select 并关根，各级随父关闭级联收起\n      details => chain.notifySelect(details),\n    )\n    // 覆盖菜单上下文：本子树内的部件都归子机器\n    provideMenu(ctx)\n    provideMenuSub({ parent, value: props.value, disabled: props.disabled })\n    // 父层收起（Escape、外点、选中）时本层跟着收，层层传导\n    watch(() => parent.api.value.open, (open) => {\n      if (!open)\n        ctx.api.value.setOpen(false)\n    })\n    return () => slots.default?.({ open: ctx.api.value.open, setOpen: ctx.api.value.setOpen })\n  },\n})\n\nexport const XhMenuSubTrigger = defineComponent({\n  name: 'XhMenuSubTrigger',\n  setup(_, { slots }) {\n    const sub = useMenuSubContext()\n    const ctx = useMenuContext()\n    return () => h('div', {\n      ...mergeProps(\n        sub.parent.api.value.getItemProps({ value: sub.value, disabled: sub.disabled }) as Record<string, unknown>,\n        ctx.api.value.getSubmenuTriggerProps({ value: sub.value, disabled: sub.disabled }) as Record<string, unknown>,\n      ),\n      // 子菜单的定位锚点就是这一条\n      ref: (el: unknown) => {\n        ctx.triggerRef.value = el as HTMLElement\n      },\n    }, slots.default?.())\n  },\n})\n\nexport const XhMenuGroup = defineComponent({\n  name: 'XhMenuGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useMenuContext()\n    const group = computed<MenuGroupProps>(() => ({ value: props.value }))\n    provideMenuGroup({ group })\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhMenuGroupLabel = defineComponent({\n  name: 'XhMenuGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useMenuContext()\n    const { group } = useMenuGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhMenuSeparator = defineComponent({\n  name: 'XhMenuSeparator',\n  setup() {\n    const ctx = useMenuContext()\n    return () => h('div', ctx.api.value.getSeparatorProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhMenuArrow = defineComponent({\n  name: 'XhMenuArrow',\n  setup() {\n    const ctx = useMenuContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n\n/**\n * 没写默认插槽时按 collection 铺开的整套结构，作者只交数据。\n * 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。\n * 触发器内容归作者，由 trigger 插槽承载；条目内容缺省是 label，可由 item 插槽接管。\n */\nfunction renderDefaultTree(\n  collection: readonly MenuNodeMeta[],\n  trigger: (VNode | string)[] | null,\n  itemSlot?: (node: MenuNodeMeta) => VNode[],\n  triggerAsChild?: boolean,\n): VNode[] {\n  return [\n    h(XhMenuTrigger, { asChild: triggerAsChild }, () => trigger ?? []),\n    h(XhMenuPositioner, null, () => [\n      h(XhMenuContent, null, () => collection.flatMap((node, index) => [\n        // 首条上的标记不产出分隔线：菜单开头不留一道空隔\n        ...(index > 0 && node.separatorBefore ? [h(XhMenuSeparator, { key: `separator:${node.value}` })] : []),\n        h(XhMenuItem, { key: node.value, value: node.value }, () => itemSlot?.(node) ?? node.label),\n      ])),\n    ]),\n  ]\n}\n"],"mappings":"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"}
+{"version":3,"file":"menu.js","names":["mergeVueProps","mergeProps"],"sources":["../../../src/components/menu/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// 提供 menu 相关实现。\n\nimport type { Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type { MenuApi, MenuGroupProps, MenuItemProps, MenuNode, MenuNodeMeta, MenuSchema, MenuTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { mergeProps } from '@xihan-ui/core'\nimport { computed, defineComponent, h, mergeProps as mergeVueProps, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { provideMenu, provideMenuGroup, provideMenuItem, provideMenuSub, useMenuContext, useMenuGroupContext, useMenuItemContext, useMenuSubContext } from './context'\nimport { useMenu, useMenuWithParent } from './use-menu'\n\ntype MenuProps = MenuSchema['props']\n\n/** 默认插槽的载荷：展开态与修改展开的动作。 */\nexport type MenuRootSlotProps = Pick<MenuApi, 'open' | 'setOpen'>\n\nexport const XhMenuRoot = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuRoot',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<MenuNode[]> },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    loop: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    typeahead: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<MenuTranslations>> },\n    openOnHover: { type: Boolean, default: undefined },\n    hoverOpenDelay: { type: Number },\n    hoverCloseDelay: { type: Number },\n    /**\n     * 只提供 collection 时，触发器插槽给出的节点直接作为触发器使用，不再外包一个 <button>。\n     * 放置部件的写法有 XhMenuTrigger 自己的 asChild，该 prop 是自动铺设路径的同一能力。\n     */\n    triggerAsChild: Boolean,\n  },\n  // open-change 携带 { open }、select 携带 { value }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<MenuProps, 'onOpenChange'>) => true,\n    'select': (_details: PayloadOf<MenuProps, 'onSelect'>) => true,\n    'update:open': (_open: PayloadOf<MenuProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: MenuRootSlotProps) => VNode[]\n    trigger?: () => VNode[]\n    item?: (node: MenuNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyOpen: MenuProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const notifySelect: MenuProps['onSelect'] = details => emit('select', details)\n    const ctx = useMenu(withXhConfig('menu', props) as MenuProps, notifyOpen, notifySelect)\n    provideMenu(ctx)\n    return () => (slots.default\n      ? slots.default({ open: ctx.api.value.open, setOpen: ctx.api.value.setOpen })\n      : props.collection\n        ? renderDefaultTree(ctx.api.value.collection, slots.trigger?.() ?? null, slots.item, props.triggerAsChild)\n        : [])\n  },\n})\n\nexport const XhMenuTrigger = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useMenuContext()\n    return () => {\n      const part = mergePartProps({\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'menu')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhMenuPositioner = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useMenuContext()\n    // 条目列表的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner；浮层里的条子走 4px 档\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 定位层搬到 portal 落点，逃开祖先的层叠上下文\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef }, () => [\n      h('div', {\n        ...mergeVueProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhMenuContent = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuContent',\n  setup(_, { slots }) {\n    const ctx = useMenuContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场\n      // 就一帧都播不出来），所以真正的收起落成内联 display——节点始终留在原地\n      style: ctx.visible.value ? undefined : { display: 'none' },\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhMenuItem = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuItem',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useMenuContext()\n    const item = computed<MenuItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideMenuItem({ item })\n    // 本条目持有焦点时，value 变更按新值重报焦点条目，卸载时上报焦点丢失\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const svc = ctx.service\n      if (svc.getStatus() !== 'Started')\n        return\n      if (itemEl.value && svc.scope.getActiveElement() === itemEl.value)\n        svc.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      // 根已停机时不再送事件\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'ITEM.LOST' })\n    })\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\n/** 默认插槽的载荷：本层子菜单的展开态与修改展开的动作。 */\nexport type MenuSubSlotProps = Pick<MenuApi, 'open' | 'setOpen'>\n\n/**\n * 子菜单：内部再运行一台 menu 状态机（submenu 模式），触发条目由 XhMenuSubTrigger\n * 渲染为父菜单条目与本子菜单触发器的双重身份。本身不渲染节点。\n */\nexport const XhMenuSub = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuSub',\n  props: {\n    /** 它在父菜单中的条目身份。 */\n    value: { type: String, required: true },\n    disabled: { type: Boolean, default: undefined },\n    collection: { type: Array as PropType<MenuNode[]> },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    loop: { type: Boolean, default: undefined },\n    openOnHover: { type: Boolean, default: undefined },\n    hoverOpenDelay: { type: Number },\n    /** 文字方向；默认继承父层。子层被迁移到浮层落点，无法继承父层的方向。 */\n    dir: { type: String as PropType<Direction> },\n    /** 语气；默认继承父层。子层是浮层落点下的同级节点，CSS 私有槽无法继承。 */\n    tone: { type: String as PropType<Tone> },\n    /** 尺寸；默认继承父层，理由同 tone。 */\n    size: { type: String as PropType<Size> },\n    hoverCloseDelay: { type: Number },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: MenuSubSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const parent = useMenuContext()\n    const ctx = useMenuWithParent(\n      {\n        ...props,\n        submenu: true,\n        dir: props.dir ?? parent.service.prop('dir'),\n        tone: props.tone ?? parent.service.prop('tone'),\n        size: props.size ?? parent.service.prop('size'),\n      } as MenuProps,\n      undefined,\n      parent.tree,\n    )\n    // 覆盖菜单上下文：本子树内的部件都归子机器\n    provideMenu(ctx)\n    provideMenuSub({ parent, value: props.value, disabled: props.disabled })\n    // 父层收起（Escape、外点、选中）时本层跟着收，层层传导\n    watch(() => parent.api.value.open, (open) => {\n      if (!open)\n        ctx.api.value.setOpen(false)\n    })\n    return () => slots.default?.({ open: ctx.api.value.open, setOpen: ctx.api.value.setOpen })\n  },\n})\n\nexport const XhMenuSubTrigger = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuSubTrigger',\n  setup(_, { slots }) {\n    const sub = useMenuSubContext()\n    const ctx = useMenuContext()\n    return () => h('div', {\n      ...mergeProps(\n        sub.parent.api.value.getItemProps({ value: sub.value, disabled: sub.disabled }) as Record<string, unknown>,\n        ctx.api.value.getSubmenuTriggerProps({ value: sub.value, disabled: sub.disabled }) as Record<string, unknown>,\n      ),\n      // 子菜单的定位锚点就是这一条\n      ref: (el: unknown) => {\n        ctx.triggerRef.value = el as HTMLElement\n      },\n    }, slots.default?.())\n  },\n})\n\n/** 条目中的文字载体：连打检索取它，图标与副文本的文字因此不进入检索串 */\nexport const XhMenuItemText = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuItemText',\n  setup(_, { slots }) {\n    const ctx = useMenuContext()\n    const { item } = useMenuItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目中的标记位（勾选、图标），纯装饰 */\nexport const XhMenuItemIndicator = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useMenuContext()\n    const { item } = useMenuItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目中的副文本，排在文字下一行 */\nexport const XhMenuItemDescription = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuItemDescription',\n  setup(_, { slots }) {\n    const ctx = useMenuContext()\n    const { item } = useMenuItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhMenuGroup = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useMenuContext()\n    const group = computed<MenuGroupProps>(() => ({ value: props.value }))\n    provideMenuGroup({ group })\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhMenuGroupLabel = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useMenuContext()\n    const { group } = useMenuGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhMenuSeparator = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuSeparator',\n  setup() {\n    const ctx = useMenuContext()\n    return () => h('div', ctx.api.value.getSeparatorProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhMenuArrow = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuArrow',\n  setup() {\n    const ctx = useMenuContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * 触发器内容归作者，由 trigger 插槽承载；条目内容默认是 label，可由 item 插槽接管。\n */\nfunction renderDefaultTree(\n  collection: readonly MenuNodeMeta[],\n  trigger: (VNode | string)[] | null,\n  itemSlot?: (node: MenuNodeMeta) => VNode[],\n  triggerAsChild?: boolean,\n): VNode[] {\n  return [\n    h(XhMenuTrigger, { asChild: triggerAsChild }, () => trigger ?? []),\n    h(XhMenuPositioner, null, () => [\n      h(XhMenuContent, null, () => collection.flatMap((node, index) => [\n        // 首条上的标记不产出分隔线：菜单开头不留一道空隔\n        ...(index > 0 && node.separatorBefore ? [h(XhMenuSeparator, { key: `separator:${node.value}` })] : []),\n        h(XhMenuItem, { key: node.value, value: node.value }, () => itemSlot?.(node) ?? node.label),\n      ])),\n    ]),\n  ]\n}\n"],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 import { ComputedRef, Ref } from "vue";
-import { MenuApi, MenuSchema } from "@xihan-ui/headless";
-import { Service } from "@xihan-ui/machine";
+import { Service } from "@xihan-ui/core";
+import { MenuApi, MenuSchema, MenuTreeNode } from "@xihan-ui/headless";
 //#region src/components/menu/use-menu.d.ts
 interface MenuContext {
   service: Service<MenuSchema>;
@@ -8,11 +8,14 @@ interface MenuContext {
   triggerRef: Ref<HTMLElement | null>;
   positionerRef: Ref<HTMLElement | null>;
   contentRef: Ref<HTMLElement | null>;
-  /** 此刻该不该渲染：退场动画播完之前仍为真。 */
+  /** Portal 之外的逻辑父子、悬停区域与选择收链由 headless 节点统一维护。 */
+  tree: MenuTreeNode;
+  /** 当前是否应当渲染：退场动画播完之前仍为真。 */
   visible: Ref<boolean>;
-  /** 浮层搬到哪儿：全局配置的容器 > 运行时的浮层落点 > body。 */
+  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */
   portalTarget: ComputedRef<string | Element>;
 }
+/** 公开 composable：建立一棵独立菜单树。 */
 declare function useMenu(props: MenuSchema['props'], onOpenChange?: MenuSchema['props']['onOpenChange'], onSelect?: MenuSchema['props']['onSelect']): MenuContext;
 //#endregion
 export { MenuContext, useMenu };

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

@@ -1 +1 @@
-{"version":3,"file":"use-menu.d.ts","names":[],"sources":["../../../src/components/menu/use-menu.ts"],"mappings":";;;;UAciB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,QACd,OAAO,qBACP,eAAe,qCACf,WAAW,kCACV"}
+{"version":3,"file":"use-menu.d.ts","names":[],"sources":["../../../src/components/menu/use-menu.ts"],"mappings":";;;;UAoBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,MAAM;;EAEN,SAAS;;EAET,cAAc,qBAAqB;;;iBA0ErB,QACd,OAAO,qBACP,eAAe,qCACf,WAAW,kCACV"}

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"}