@xihan-ui/vue 1.1.0 → 2.1.0

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

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

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 { groupAdjacentRuns, 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,58 @@ 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) : [];
+		}) : props.collection ? renderDefaultTree(ctx.api.value.collection, slots.trigger?.() ?? null, {
+			"item": slots.item,
+			"item-prefix": slots["item-prefix"],
+			"item-suffix": slots["item-suffix"]
+		}, 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 +118,7 @@ const XhMenuPositioner = defineComponent({
 		}, [...slots.default?.() ?? [], ...bars.render()])]);
 	}
 });
-const XhMenuContent = defineComponent({
+const XhMenuContent = /* @__PURE__ */ defineComponent({
 	name: "XhMenuContent",
 	setup(_, { slots }) {
 		const ctx = useMenuContext();
@@ -133,7 +131,7 @@ const XhMenuContent = defineComponent({
 		}, slots.default?.());
 	}
 });
-const XhMenuItem = defineComponent({
+const XhMenuItem = /* @__PURE__ */ defineComponent({
 	name: "XhMenuItem",
 	props: {
 		value: {
@@ -147,6 +145,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 +174,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 +189,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 +200,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 +234,7 @@ const XhMenuSub = defineComponent({
 		});
 	}
 });
-const XhMenuSubTrigger = defineComponent({
+const XhMenuSubTrigger = /* @__PURE__ */ defineComponent({
 	name: "XhMenuSubTrigger",
 	setup(_, { slots }) {
 		const sub = useMenuSubContext();
@@ -276,7 +253,52 @@ 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 XhMenuItemShortcut = /* @__PURE__ */ defineComponent({
+	name: "XhMenuItemShortcut",
+	setup(_, { slots }) {
+		const ctx = useMenuContext();
+		const { item } = useMenuItemContext();
+		return () => h("span", ctx.api.value.getItemShortcutProps(item.value), slots.default?.());
+	}
+});
+/** 条目行尾的作者内容（计数、徽标、次级图标）；家族只管落位，不规定字号与颜色 */
+const XhMenuItemSuffix = /* @__PURE__ */ defineComponent({
+	name: "XhMenuItemSuffix",
+	setup(_, { slots }) {
+		const ctx = useMenuContext();
+		const { item } = useMenuItemContext();
+		return () => h("span", ctx.api.value.getItemSuffixProps(item.value), slots.default?.());
+	}
+});
+const XhMenuGroup = /* @__PURE__ */ defineComponent({
 	name: "XhMenuGroup",
 	props: { value: {
 		type: String,
@@ -289,7 +311,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 +319,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,17 +334,50 @@ const XhMenuArrow = defineComponent({
 	}
 });
 /**
-* 没写默认插槽时按 collection 铺开的整套结构，作者只交数据。
-* 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。
-* 触发器内容归作者，由 trigger 插槽承载；条目内容缺省是 label，可由 item 插槽接管。
+* 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
+* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
+* 触发器内容归作者，由 trigger 插槽承载；条目内容默认是 label，可由 item 插槽接管。
+*/
+function renderDefaultTree(collection, trigger, itemSlots, triggerAsChild) {
+	return [h(XhMenuTrigger, { asChild: triggerAsChild }, () => trigger ?? []), h(XhMenuPositioner, null, () => [h(XhMenuContent, null, () => renderNodes(collection, itemSlots))])];
+}
+/** content 的内容：分组段铺为 group，段首的分隔线落在 group 外面。 */
+function renderNodes(collection, itemSlots) {
+	return groupAdjacentRuns(collection, (node) => node.group).flatMap((run, runIndex) => {
+		const head = run[0];
+		const lead = runIndex > 0 && head.separatorBefore ? [h(XhMenuSeparator, { key: `separator:${head.value}` })] : [];
+		if (head.group == null) return [...lead, renderItem(head, itemSlots)];
+		const groupLabel = run.find((node) => node.groupLabel != null)?.groupLabel ?? null;
+		return [...lead, h(XhMenuGroup, {
+			key: `group:${head.group}`,
+			value: head.group
+		}, () => [...groupLabel != null ? [h(XhMenuGroupLabel, null, () => groupLabel)] : [], ...run.flatMap((node, index) => [...index > 0 && node.separatorBefore ? [h(XhMenuSeparator, { key: `separator:${node.value}` })] : [], renderItem(node, itemSlots)])])];
+	});
+}
+/**
+* 单个条目：按数据铺标记位、文字、说明与快捷键，未提供的那几个不铺对应部件。
+*
+* 三个插槽各管一段，不必为了改一处把整条重搭：
+* - `item-prefix` / `item-suffix` 只接管行首与行尾那一格，其余槽照旧由数据铺。
+*   行首那一格与数据里的 `indicator` 同一个部件，插槽在场时以它为准。
+* - `item` 是整条的接管口：写了它，上面几格一概不铺，作者自己放置 XhMenuItemText 等部件
+*   （与 ContextMenu 的 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, {
-		key: node.value,
-		value: node.value
-	}, () => itemSlot?.(node) ?? node.label)]))])];
+function renderItem(meta, itemSlots) {
+	const prefix = itemSlots["item-prefix"];
+	const suffix = itemSlots["item-suffix"];
+	return h(XhMenuItem, {
+		key: meta.value,
+		value: meta.value
+	}, () => itemSlots.item?.(meta) ?? [
+		...prefix ? [h(XhMenuItemIndicator, null, () => prefix(meta))] : meta.indicator != null ? [h(XhMenuItemIndicator, null, () => meta.indicator)] : [],
+		h(XhMenuItemText, null, () => meta.label),
+		...meta.description != null ? [h(XhMenuItemDescription, null, () => meta.description)] : [],
+		...meta.shortcut != null ? [h(XhMenuItemShortcut, null, () => meta.shortcut)] : [],
+		...suffix ? [h(XhMenuItemSuffix, null, () => suffix(meta))] : []
+	]);
 }
 //#endregion
-export { XhMenuArrow, XhMenuContent, XhMenuGroup, XhMenuGroupLabel, XhMenuItem, XhMenuPositioner, XhMenuRoot, XhMenuSeparator, XhMenuSub, XhMenuSubTrigger, XhMenuTrigger };
+export { XhMenuArrow, XhMenuContent, XhMenuGroup, XhMenuGroupLabel, XhMenuItem, XhMenuItemDescription, XhMenuItemIndicator, XhMenuItemShortcut, XhMenuItemSuffix, 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 { groupAdjacentRuns, 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\n/** 代铺条目时可逐槽接管的三个插槽；三个都不写即完全按数据铺。 */\nexport interface MenuItemSlots {\n  /** 整条的接管口：写了它，代铺的标记位、文字、说明与快捷键一概不铺。 */\n  'item'?: (node: MenuNodeMeta) => VNode[]\n  /** 只接管行首那一格（与数据里的 indicator 同一个部件），其余槽照旧由数据铺。 */\n  'item-prefix'?: (node: MenuNodeMeta) => VNode[]\n  /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺。 */\n  'item-suffix'?: (node: MenuNodeMeta) => VNode[]\n}\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    /** 整条的接管口：写了它，代铺的各格一概不铺，作者自己放置部件 */\n    'item'?: (node: MenuNodeMeta) => VNode[]\n    /** 只接管行首那一格，其余槽照旧由数据铺 */\n    'item-prefix'?: (node: MenuNodeMeta) => VNode[]\n    /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺 */\n    'item-suffix'?: (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, { 'item': slots.item, 'item-prefix': slots['item-prefix'], 'item-suffix': slots['item-suffix'] }, 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\n/** 条目中的快捷键提示，贴行尾；纯装饰，读屏从条目文字取意 */\nexport const XhMenuItemShortcut = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuItemShortcut',\n  setup(_, { slots }) {\n    const ctx = useMenuContext()\n    const { item } = useMenuItemContext()\n    return () => h('span', ctx.api.value.getItemShortcutProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标、次级图标）；家族只管落位，不规定字号与颜色 */\nexport const XhMenuItemSuffix = /* @__PURE__ */ defineComponent({\n  name: 'XhMenuItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useMenuContext()\n    const { item } = useMenuItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(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  itemSlots: MenuItemSlots,\n  triggerAsChild?: boolean,\n): VNode[] {\n  return [\n    h(XhMenuTrigger, { asChild: triggerAsChild }, () => trigger ?? []),\n    h(XhMenuPositioner, null, () => [\n      h(XhMenuContent, null, () => renderNodes(collection, itemSlots)),\n    ]),\n  ]\n}\n\n/** content 的内容：分组段铺为 group，段首的分隔线落在 group 外面。 */\nfunction renderNodes(\n  collection: readonly MenuNodeMeta[],\n  itemSlots: MenuItemSlots,\n): VNode[] {\n  return groupAdjacentRuns(collection, node => node.group).flatMap((run, runIndex) => {\n    const head = run[0]!\n    // 首条上的标记不产出分隔线：菜单开头不留一道空隔\n    const lead = runIndex > 0 && head.separatorBefore\n      ? [h(XhMenuSeparator, { key: `separator:${head.value}` })]\n      : []\n    if (head.group == null)\n      return [...lead, renderItem(head, itemSlots)]\n    const groupLabel = run.find(node => node.groupLabel != null)?.groupLabel ?? null\n    return [\n      ...lead,\n      h(XhMenuGroup, { key: `group:${head.group}`, value: head.group }, () => [\n        ...(groupLabel != null ? [h(XhMenuGroupLabel, null, () => groupLabel)] : []),\n        ...run.flatMap((node, index) => [\n          ...(index > 0 && node.separatorBefore ? [h(XhMenuSeparator, { key: `separator:${node.value}` })] : []),\n          renderItem(node, itemSlots),\n        ]),\n      ]),\n    ]\n  })\n}\n\n/**\n * 单个条目：按数据铺标记位、文字、说明与快捷键，未提供的那几个不铺对应部件。\n *\n * 三个插槽各管一段，不必为了改一处把整条重搭：\n * - `item-prefix` / `item-suffix` 只接管行首与行尾那一格，其余槽照旧由数据铺。\n *   行首那一格与数据里的 `indicator` 同一个部件，插槽在场时以它为准。\n * - `item` 是整条的接管口：写了它，上面几格一概不铺，作者自己放置 XhMenuItemText 等部件\n *   （与 ContextMenu 的 item 插槽语义不同，那边填的是文字槽）。\n */\nfunction renderItem(\n  meta: MenuNodeMeta,\n  itemSlots: MenuItemSlots,\n): VNode {\n  const prefix = itemSlots['item-prefix']\n  const suffix = itemSlots['item-suffix']\n  return h(XhMenuItem, { key: meta.value, value: meta.value }, () => itemSlots.item?.(meta) ?? [\n    ...(prefix\n      ? [h(XhMenuItemIndicator, null, () => prefix(meta))]\n      : meta.indicator != null ? [h(XhMenuItemIndicator, null, () => meta.indicator)] : []),\n    h(XhMenuItemText, null, () => meta.label),\n    ...(meta.description != null ? [h(XhMenuItemDescription, null, () => meta.description)] : []),\n    ...(meta.shortcut != null ? [h(XhMenuItemShortcut, null, () => meta.shortcut)] : []),\n    ...(suffix ? [h(XhMenuItemSuffix, null, () => suffix(meta))] : []),\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"}