@xihan-ui/vue 1.0.0-alpha.2 → 1.0.0

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

@@ -1,9 +1,12 @@
+import { withXhConfig } from "../../config/config.js";
+import { useScrollbars } from "../../runtime/use-scrollbars.js";
+import { mergeIntoChild } from "../../runtime/as-child.js";
 import { provideContextMenu, provideContextMenuChain, provideContextMenuGroup, provideContextMenuItem, provideContextMenuSub, useContextMenuChain, useContextMenuContext, useContextMenuGroupContext, useContextMenuItemContext, useContextMenuSubContext } from "./context.js";
-import { provideMenu, useMenuContext } from "../menu/context.js";
+import { provideMenu, provideMenuChain, useMenuContext } from "../menu/context.js";
 import { useMenu } from "../menu/use-menu.js";
 import { useContextMenu } from "./use-context-menu.js";
-import { computed, defineComponent, h, onBeforeUnmount, ref, watch } from "vue";
-import { mergeProps } from "@xihan-ui/kernel";
+import { Teleport, computed, defineComponent, h, mergeProps, onBeforeUnmount, ref, watch } from "vue";
+import { mergeProps as mergeProps$1 } from "@xihan-ui/kernel";
 //#region src/components/context-menu/context-menu.ts
 const XhContextMenuRoot = defineComponent({
 	name: "XhContextMenuRoot",
@@ -60,14 +63,24 @@ const XhContextMenuRoot = defineComponent({
 		"update:open": (_open) => true
 	},
 	slots: Object,
-	setup(props, { slots, emit }) {
+	setup(props, { slots, emit, expose }) {
 		const notifyOpen = (details) => {
 			emit("open-change", details);
 			emit("update:open", details.open);
 		};
 		const notifySelect = (details) => emit("select", details);
-		const ctx = useContextMenu(props, notifyOpen, notifySelect);
+		const ctx = useContextMenu(withXhConfig("context-menu", props), notifyOpen, notifySelect);
 		provideContextMenu(ctx);
+		expose({
+			openAt: (x, y) => ctx.api.value.openAt(x, y),
+			setOpen: (open) => ctx.api.value.setOpen(open),
+			get open() {
+				return ctx.api.value.open;
+			},
+			get point() {
+				return ctx.api.value.point;
+			}
+		});
 		provideContextMenuChain({ notifySelect: (details) => {
 			emit("select", details);
 			ctx.api.value.setOpen(false);
@@ -82,26 +95,39 @@ const XhContextMenuRoot = defineComponent({
 });
 const XhContextMenuTrigger = defineComponent({
 	name: "XhContextMenuTrigger",
-	setup(_, { slots }) {
+	props: { 
+	/** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+asChild: Boolean },
+	setup(props, { slots }) {
 		const ctx = useContextMenuContext();
-		return () => h("div", {
-			...ctx.api.value.getTriggerProps(),
-			ref: (el) => {
-				ctx.triggerRef.value = el;
+		return () => {
+			const attrs = {
+				...ctx.api.value.getTriggerProps(),
+				ref: (el) => {
+					ctx.triggerRef.value = el;
+				}
+			};
+			const children = slots.default?.();
+			if (props.asChild) {
+				const merged = mergeIntoChild(children, attrs, "context-menu");
+				if (merged) return merged;
 			}
-		}, slots.default?.());
+			return h("div", attrs, children);
+		};
 	}
 });
 const XhContextMenuPositioner = defineComponent({
 	name: "XhContextMenuPositioner",
-	setup(_, { slots }) {
+	inheritAttrs: false,
+	setup(_, { slots, attrs }) {
 		const ctx = useContextMenuContext();
-		return () => h("div", {
-			...ctx.api.value.getPositionerProps(),
+		const bars = useScrollbars({ scrollable: () => ctx.contentRef.value });
+		return () => h(Teleport, { to: ctx.portalTarget.value }, [h("div", {
+			...mergeProps(ctx.api.value.getPositionerProps(), attrs),
 			ref: (el) => {
 				ctx.positionerRef.value = el;
 			}
-		}, slots.default?.());
+		}, [...slots.default?.() ?? [], ...bars.render()])]);
 	}
 });
 const XhContextMenuContent = defineComponent({
@@ -110,6 +136,7 @@ const XhContextMenuContent = defineComponent({
 		const ctx = useContextMenuContext();
 		return () => h("div", {
 			...ctx.api.value.getContentProps(),
+			style: ctx.visible.value ? void 0 : { display: "none" },
 			ref: (el) => {
 				ctx.contentRef.value = el;
 			}
@@ -214,6 +241,21 @@ const XhContextMenuSub = defineComponent({
 			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
@@ -225,9 +267,13 @@ const XhContextMenuSub = defineComponent({
 		const chain = useContextMenuChain();
 		const sub = useMenu({
 			...props,
-			submenu: true
+			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));
 		provideMenu(sub);
+		provideMenuChain({ notifySelect: (details) => chain.notifySelect(details) });
 		provideContextMenuSub({
 			parent,
 			value: props.value,
@@ -248,7 +294,7 @@ const XhContextMenuSubTrigger = defineComponent({
 		const handle = useContextMenuSubContext();
 		const sub = useMenuContext();
 		return () => h("div", {
-			...mergeProps(sub.api.value.getSubmenuTriggerProps({
+			...mergeProps$1(sub.api.value.getSubmenuTriggerProps({
 				value: handle.value,
 				disabled: handle.disabled
 			}), handle.parent.api.value.getItemProps({

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

@@ -1 +1 @@
-{"version":3,"file":"context-menu.js","names":[],"sources":["../../../src/components/context-menu/context-menu.ts"],"sourcesContent":["import type { ContextMenuApi, ContextMenuGroupProps, ContextMenuItemProps, ContextMenuNode, ContextMenuNodeMeta, ContextMenuSchema, MenuApi } 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, onBeforeUnmount, ref, watch } from 'vue'\nimport { provideMenu, useMenuContext } from '../menu/context'\nimport { useMenu } from '../menu/use-menu'\nimport {\n  provideContextMenu,\n  provideContextMenuChain,\n  provideContextMenuGroup,\n  provideContextMenuItem,\n  provideContextMenuSub,\n  useContextMenuChain,\n  useContextMenuContext,\n  useContextMenuGroupContext,\n  useContextMenuItemContext,\n  useContextMenuSubContext,\n} from './context'\nimport { useContextMenu } from './use-context-menu'\n\ntype ContextMenuProps = ContextMenuSchema['props']\n\n/** 默认插槽的载荷：右键菜单的展开态与锚点坐标，以及开合、按坐标展开的命令。 */\nexport type ContextMenuRootSlotProps = Pick<ContextMenuApi, 'open' | 'point' | 'setOpen' | 'openAt'>\n\n/** 子菜单默认插槽的载荷：这一层子菜单自己的展开态与开合命令。 */\nexport type ContextMenuSubSlotProps = Pick<MenuApi, 'open' | 'setOpen'>\n\nexport const XhContextMenuRoot = defineComponent({\n  name: 'XhContextMenuRoot',\n  // 缺省值由 connect 与机器给出，这里一律 default: undefined\n  props: {\n    collection: { type: Array as PropType<ContextMenuNode[]>, 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    typeahead: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<ContextMenuProps['translations']>, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    longPressDelay: { type: Number, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  // open-change 携带 { open }、select 携带 { value }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<ContextMenuProps, 'onOpenChange'>) => true,\n    'select': (_details: PayloadOf<ContextMenuProps, 'onSelect'>) => true,\n    'update:open': (_open: PayloadOf<ContextMenuProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ContextMenuRootSlotProps) => VNode[]\n    trigger?: () => VNode[]\n    item?: (node: ContextMenuNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyOpen: ContextMenuProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const notifySelect: ContextMenuProps['onSelect'] = details => emit('select', details)\n    const ctx = useContextMenu(props as ContextMenuProps, notifyOpen, notifySelect)\n    provideContextMenu(ctx)\n    // 子菜单任意层级的选中都汇到根：先发根的 select 再关根，各级随父关闭级联收起\n    provideContextMenuChain({\n      notifySelect: (details) => {\n        emit('select', details)\n        ctx.api.value.setOpen(false)\n      },\n    })\n    return () => h(\n      'div',\n      ctx.api.value.getRootProps() as Record<string, unknown>,\n      slots.default\n        ? slots.default({\n            open: ctx.api.value.open,\n            point: ctx.api.value.point,\n            setOpen: ctx.api.value.setOpen,\n            openAt: ctx.api.value.openAt,\n          })\n        : props.collection\n          ? renderDefaultTree(ctx.api.value.collection, slots.trigger?.() ?? null, slots.item)\n          : [],\n    )\n  },\n})\n\nexport const XhContextMenuTrigger = defineComponent({\n  name: 'XhContextMenuTrigger',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    // 触发区渲染为 div，语义由 connect 打上的 ARIA 属性给出\n    return () => h('div', {\n      ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhContextMenuPositioner = defineComponent({\n  name: 'XhContextMenuPositioner',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    return () => h('div', {\n      ...ctx.api.value.getPositionerProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhContextMenuContent = defineComponent({\n  name: 'XhContextMenuContent',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhContextMenuGroup = defineComponent({\n  name: 'XhContextMenuGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useContextMenuContext()\n    const group = computed<ContextMenuGroupProps>(() => ({ value: props.value }))\n    provideContextMenuGroup({ group })\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuGroupLabel = defineComponent({\n  name: 'XhContextMenuGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { group } = useContextMenuGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuItem = defineComponent({\n  name: 'XhContextMenuItem',\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 = useContextMenuContext()\n    const item = computed<ContextMenuItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideContextMenuItem({ item })\n    // 本条目持有焦点时，value 变更按新值重报焦点条目，卸载时上报焦点丢失\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.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(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\n/**\n * 右键菜单里的子菜单：子层跑一台 submenu 模式的 menu 机器，触发条目由\n * XhContextMenuSubTrigger 渲染成「父层条目 + 子层触发器」的双重身份。\n * 子层内部用 XhMenu 系部件（再往深嵌套即 menu 套 menu）。本身不渲染节点。\n */\nexport const XhContextMenuSub = defineComponent({\n  name: 'XhContextMenuSub',\n  props: {\n    /** 它在父右键菜单里的条目身份。 */\n    value: { type: String, required: true },\n    disabled: { type: Boolean, 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    hoverCloseDelay: { type: Number, default: undefined },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ContextMenuSubSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const parent = useContextMenuContext()\n    const chain = useContextMenuChain()\n    const sub = useMenu(\n      { ...props, submenu: true },\n      undefined,\n      details => chain.notifySelect(details),\n    )\n    // 子树内的 XhMenu 系部件都归子机器\n    provideMenu(sub)\n    provideContextMenuSub({ parent, value: props.value, disabled: props.disabled })\n    // 父层收起（Escape、外点、选中）时本层跟着收，层层传导\n    watch(() => parent.api.value.open, (open) => {\n      if (!open)\n        sub.api.value.setOpen(false)\n    })\n    return () => slots.default?.({ open: sub.api.value.open, setOpen: sub.api.value.setOpen })\n  },\n})\n\nexport const XhContextMenuSubTrigger = defineComponent({\n  name: 'XhContextMenuSubTrigger',\n  setup(_, { slots }) {\n    const handle = useContextMenuSubContext()\n    const sub = useMenuContext()\n    return () => h('div', {\n      // 合并序=子先父后：父层的 data-scope/data-part 胜出，父层的方向键与选中照常认它\n      ...mergeProps(\n        sub.api.value.getSubmenuTriggerProps({ value: handle.value, disabled: handle.disabled }) as Record<string, unknown>,\n        handle.parent.api.value.getItemProps({ value: handle.value, disabled: handle.disabled }) as Record<string, unknown>,\n      ),\n      // 子菜单的定位锚点就是这一条\n      ref: (el: unknown) => {\n        sub.triggerRef.value = el as HTMLElement\n      },\n    }, slots.default?.())\n  },\n})\n\nexport const XhContextMenuItemText = defineComponent({\n  name: 'XhContextMenuItemText',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuItemIndicator = defineComponent({\n  name: 'XhContextMenuItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuSeparator = defineComponent({\n  name: 'XhContextMenuSeparator',\n  setup() {\n    const ctx = useContextMenuContext()\n    return () => h('div', ctx.api.value.getSeparatorProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhContextMenuArrow = defineComponent({\n  name: 'XhContextMenuArrow',\n  setup() {\n    const ctx = useContextMenuContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n\n/** 一段连续的同组条目；不分组的条目各自单独成段。 */\ntype NodeRun = [ContextMenuNodeMeta, ...ContextMenuNodeMeta[]]\n\n/**\n * 没写默认插槽时按 collection 铺开的整套结构，作者只交数据。\n * 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。\n * 触发区里放什么是作者的事，由 trigger 插槽给出。\n */\nfunction renderDefaultTree(\n  collection: readonly ContextMenuNodeMeta[],\n  trigger: (VNode | string)[] | null,\n  itemSlot?: (node: ContextMenuNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    h(XhContextMenuTrigger, null, () => trigger ?? []),\n    h(XhContextMenuPositioner, null, () => [\n      h(XhContextMenuContent, null, () => renderNodes(collection, itemSlot)),\n    ]),\n  ]\n}\n\n/** 相邻同 group 的条目并成一段，没写 group 的各自成段。 */\nfunction groupRuns(collection: readonly ContextMenuNodeMeta[]): NodeRun[] {\n  const runs: NodeRun[] = []\n  for (const meta of collection) {\n    const last = runs.at(-1)\n    if (last && meta.group != null && last[0].group === meta.group)\n      last.push(meta)\n    else\n      runs.push([meta])\n  }\n  return runs\n}\n\n/** content 的内容：分组段铺成 group，段首的分隔线落在 group 外面。 */\nfunction renderNodes(\n  collection: readonly ContextMenuNodeMeta[],\n  itemSlot?: (node: ContextMenuNodeMeta) => VNode[],\n): VNode[] {\n  return groupRuns(collection).flatMap((run, runIndex) => {\n    const head = run[0]\n    // 首条上的标记不产出分隔线：菜单开头不留一道空隔\n    const lead = runIndex > 0 && head.separatorBefore\n      ? [h(XhContextMenuSeparator, { key: `separator:${head.value}` })]\n      : []\n    if (head.group == null)\n      return [...lead, renderItem(head, itemSlot)]\n    const groupLabel = run.find(node => node.groupLabel != null)?.groupLabel ?? null\n    return [\n      ...lead,\n      h(XhContextMenuGroup, { key: `group:${head.group}`, value: head.group }, () => [\n        ...(groupLabel != null ? [h(XhContextMenuGroupLabel, null, () => groupLabel)] : []),\n        ...run.flatMap((node, index) => [\n          ...(index > 0 && node.separatorBefore ? [h(XhContextMenuSeparator, { key: `separator:${node.value}` })] : []),\n          renderItem(node, itemSlot),\n        ]),\n      ]),\n    ]\n  })\n}\n\n/** 单个条目：标记位排在文字前面，没给标记位就不铺那个部件。 */\nfunction renderItem(\n  meta: ContextMenuNodeMeta,\n  itemSlot?: (node: ContextMenuNodeMeta) => VNode[],\n): VNode {\n  return h(XhContextMenuItem, { key: meta.value, value: meta.value }, () => [\n    ...(meta.indicator != null ? [h(XhContextMenuItemIndicator, null, () => meta.indicator)] : []),\n    h(XhContextMenuItemText, null, () => itemSlot?.(meta) ?? meta.label),\n  ])\n}\n"],"mappings":"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"}
+{"version":3,"file":"context-menu.js","names":["mergeVueProps","mergeProps"],"sources":["../../../src/components/context-menu/context-menu.ts"],"sourcesContent":["import type { ContextMenuApi, ContextMenuGroupProps, ContextMenuItemProps, ContextMenuNode, ContextMenuNodeMeta, ContextMenuSchema, MenuApi } 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 { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { provideMenu, provideMenuChain, useMenuContext } from '../menu/context'\nimport { useMenu } from '../menu/use-menu'\nimport {\n  provideContextMenu,\n  provideContextMenuChain,\n  provideContextMenuGroup,\n  provideContextMenuItem,\n  provideContextMenuSub,\n  useContextMenuChain,\n  useContextMenuContext,\n  useContextMenuGroupContext,\n  useContextMenuItemContext,\n  useContextMenuSubContext,\n} from './context'\nimport { useContextMenu } from './use-context-menu'\n\ntype ContextMenuProps = ContextMenuSchema['props']\n\n/** 默认插槽的载荷：右键菜单的展开态与锚点坐标，以及开合、按坐标展开的命令。 */\nexport type ContextMenuRootSlotProps = Pick<ContextMenuApi, 'open' | 'point' | 'setOpen' | 'openAt'>\n\n/** 子菜单默认插槽的载荷：这一层子菜单自己的展开态与开合命令。 */\nexport type ContextMenuSubSlotProps = Pick<MenuApi, 'open' | 'setOpen'>\n\nexport const XhContextMenuRoot = defineComponent({\n  name: 'XhContextMenuRoot',\n  // 缺省值由 connect 与机器给出，这里一律 default: undefined\n  props: {\n    collection: { type: Array as PropType<ContextMenuNode[]>, 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    typeahead: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<ContextMenuProps['translations']>, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    longPressDelay: { type: Number, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  // open-change 携带 { open }、select 携带 { value }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<ContextMenuProps, 'onOpenChange'>) => true,\n    'select': (_details: PayloadOf<ContextMenuProps, 'onSelect'>) => true,\n    'update:open': (_open: PayloadOf<ContextMenuProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ContextMenuRootSlotProps) => VNode[]\n    trigger?: () => VNode[]\n    item?: (node: ContextMenuNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit, expose }) {\n    const notifyOpen: ContextMenuProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const notifySelect: ContextMenuProps['onSelect'] = details => emit('select', details)\n    const ctx = useContextMenu(withXhConfig('context-menu', props) as ContextMenuProps, notifyOpen, notifySelect)\n    provideContextMenu(ctx)\n    // 菜单钉在坐标上，坐标只能由 openAt 交进来。默认插槽那条路从载荷里拿，\n    // 只交 collection 的那条路没有载荷，所以同一组命令也从实例上暴露一份。\n    expose({\n      openAt: (x: number, y: number) => ctx.api.value.openAt(x, y),\n      setOpen: (open: boolean) => ctx.api.value.setOpen(open),\n      get open() {\n        return ctx.api.value.open\n      },\n      get point() {\n        return ctx.api.value.point\n      },\n    })\n    // 子菜单任意层级的选中都汇到根：先发根的 select 再关根，各级随父关闭级联收起\n    provideContextMenuChain({\n      notifySelect: (details) => {\n        emit('select', details)\n        ctx.api.value.setOpen(false)\n      },\n    })\n    return () => h(\n      'div',\n      ctx.api.value.getRootProps() as Record<string, unknown>,\n      slots.default\n        ? slots.default({\n            open: ctx.api.value.open,\n            point: ctx.api.value.point,\n            setOpen: ctx.api.value.setOpen,\n            openAt: ctx.api.value.openAt,\n          })\n        : props.collection\n          ? renderDefaultTree(ctx.api.value.collection, slots.trigger?.() ?? null, slots.item)\n          : [],\n    )\n  },\n})\n\nexport const XhContextMenuTrigger = defineComponent({\n  name: 'XhContextMenuTrigger',\n  props: {\n    /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = useContextMenuContext()\n    // 触发区渲染为 div，语义由 connect 打上的 ARIA 属性给出\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, 'context-menu')\n        if (merged)\n          return merged\n      }\n      return h('div', attrs, children)\n    }\n  },\n})\n\nexport const XhContextMenuPositioner = defineComponent({\n  name: 'XhContextMenuPositioner',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useContextMenuContext()\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 XhContextMenuContent = defineComponent({\n  name: 'XhContextMenuContent',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\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 XhContextMenuGroup = defineComponent({\n  name: 'XhContextMenuGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useContextMenuContext()\n    const group = computed<ContextMenuGroupProps>(() => ({ value: props.value }))\n    provideContextMenuGroup({ group })\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuGroupLabel = defineComponent({\n  name: 'XhContextMenuGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { group } = useContextMenuGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuItem = defineComponent({\n  name: 'XhContextMenuItem',\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 = useContextMenuContext()\n    const item = computed<ContextMenuItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideContextMenuItem({ item })\n    // 本条目持有焦点时，value 变更按新值重报焦点条目，卸载时上报焦点丢失\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.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(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\n/**\n * 右键菜单里的子菜单：子层跑一台 submenu 模式的 menu 机器，触发条目由\n * XhContextMenuSubTrigger 渲染成「父层条目 + 子层触发器」的双重身份。\n * 子层内部用 XhMenu 系部件（再往深嵌套即 menu 套 menu）。本身不渲染节点。\n */\nexport const XhContextMenuSub = defineComponent({\n  name: 'XhContextMenuSub',\n  props: {\n    /** 它在父右键菜单里的条目身份。 */\n    value: { type: String, required: true },\n    disabled: { type: Boolean, 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: ContextMenuSubSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const parent = useContextMenuContext()\n    const chain = useContextMenuChain()\n    const sub = 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      },\n      undefined,\n      details => chain.notifySelect(details),\n    )\n    // 子树内的 XhMenu 系部件都归子机器\n    provideMenu(sub)\n    // 子层里还能再嵌一层 XhMenuSub：那一层要往上找选中汇总的链，\n    // 而链只在 XhMenuRoot 里 provide 过，右键菜单这一支得自己接上\n    provideMenuChain({ notifySelect: details => chain.notifySelect(details) })\n    provideContextMenuSub({ parent, value: props.value, disabled: props.disabled })\n    // 父层收起（Escape、外点、选中）时本层跟着收，层层传导\n    watch(() => parent.api.value.open, (open) => {\n      if (!open)\n        sub.api.value.setOpen(false)\n    })\n    return () => slots.default?.({ open: sub.api.value.open, setOpen: sub.api.value.setOpen })\n  },\n})\n\nexport const XhContextMenuSubTrigger = defineComponent({\n  name: 'XhContextMenuSubTrigger',\n  setup(_, { slots }) {\n    const handle = useContextMenuSubContext()\n    const sub = useMenuContext()\n    return () => h('div', {\n      // 合并序=子先父后：父层的 data-scope/data-part 胜出，父层的方向键与选中照常认它\n      ...mergeProps(\n        sub.api.value.getSubmenuTriggerProps({ value: handle.value, disabled: handle.disabled }) as Record<string, unknown>,\n        handle.parent.api.value.getItemProps({ value: handle.value, disabled: handle.disabled }) as Record<string, unknown>,\n      ),\n      // 子菜单的定位锚点就是这一条\n      ref: (el: unknown) => {\n        sub.triggerRef.value = el as HTMLElement\n      },\n    }, slots.default?.())\n  },\n})\n\nexport const XhContextMenuItemText = defineComponent({\n  name: 'XhContextMenuItemText',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuItemIndicator = defineComponent({\n  name: 'XhContextMenuItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useContextMenuContext()\n    const { item } = useContextMenuItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhContextMenuSeparator = defineComponent({\n  name: 'XhContextMenuSeparator',\n  setup() {\n    const ctx = useContextMenuContext()\n    return () => h('div', ctx.api.value.getSeparatorProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhContextMenuArrow = defineComponent({\n  name: 'XhContextMenuArrow',\n  setup() {\n    const ctx = useContextMenuContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n\n/** 一段连续的同组条目；不分组的条目各自单独成段。 */\ntype NodeRun = [ContextMenuNodeMeta, ...ContextMenuNodeMeta[]]\n\n/**\n * 没写默认插槽时按 collection 铺开的整套结构，作者只交数据。\n * 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。\n * 触发区里放什么是作者的事，由 trigger 插槽给出。\n */\nfunction renderDefaultTree(\n  collection: readonly ContextMenuNodeMeta[],\n  trigger: (VNode | string)[] | null,\n  itemSlot?: (node: ContextMenuNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    h(XhContextMenuTrigger, null, () => trigger ?? []),\n    h(XhContextMenuPositioner, null, () => [\n      h(XhContextMenuContent, null, () => renderNodes(collection, itemSlot)),\n    ]),\n  ]\n}\n\n/** 相邻同 group 的条目并成一段，没写 group 的各自成段。 */\nfunction groupRuns(collection: readonly ContextMenuNodeMeta[]): NodeRun[] {\n  const runs: NodeRun[] = []\n  for (const meta of collection) {\n    const last = runs.at(-1)\n    if (last && meta.group != null && last[0].group === meta.group)\n      last.push(meta)\n    else\n      runs.push([meta])\n  }\n  return runs\n}\n\n/** content 的内容：分组段铺成 group，段首的分隔线落在 group 外面。 */\nfunction renderNodes(\n  collection: readonly ContextMenuNodeMeta[],\n  itemSlot?: (node: ContextMenuNodeMeta) => VNode[],\n): VNode[] {\n  return groupRuns(collection).flatMap((run, runIndex) => {\n    const head = run[0]\n    // 首条上的标记不产出分隔线：菜单开头不留一道空隔\n    const lead = runIndex > 0 && head.separatorBefore\n      ? [h(XhContextMenuSeparator, { key: `separator:${head.value}` })]\n      : []\n    if (head.group == null)\n      return [...lead, renderItem(head, itemSlot)]\n    const groupLabel = run.find(node => node.groupLabel != null)?.groupLabel ?? null\n    return [\n      ...lead,\n      h(XhContextMenuGroup, { key: `group:${head.group}`, value: head.group }, () => [\n        ...(groupLabel != null ? [h(XhContextMenuGroupLabel, null, () => groupLabel)] : []),\n        ...run.flatMap((node, index) => [\n          ...(index > 0 && node.separatorBefore ? [h(XhContextMenuSeparator, { key: `separator:${node.value}` })] : []),\n          renderItem(node, itemSlot),\n        ]),\n      ]),\n    ]\n  })\n}\n\n/** 单个条目：标记位排在文字前面，没给标记位就不铺那个部件。 */\nfunction renderItem(\n  meta: ContextMenuNodeMeta,\n  itemSlot?: (node: ContextMenuNodeMeta) => VNode[],\n): VNode {\n  return h(XhContextMenuItem, { key: meta.value, value: meta.value }, () => [\n    ...(meta.indicator != null ? [h(XhContextMenuItemIndicator, null, () => meta.indicator)] : []),\n    h(XhContextMenuItemText, null, () => itemSlot?.(meta) ?? meta.label),\n  ])\n}\n"],"mappings":"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"}

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

@@ -1,8 +1,8 @@
 import { inject, provide } from "vue";
 //#region src/components/context-menu/context.ts
-const KEY = Symbol("xh-context-menu");
-const ITEM_KEY = Symbol("xh-context-menu-item");
-const GROUP_KEY = Symbol("xh-context-menu-group");
+const KEY = Symbol.for("xh-context-menu");
+const ITEM_KEY = Symbol.for("xh-context-menu-item");
+const GROUP_KEY = Symbol.for("xh-context-menu-group");
 function provideContextMenu(ctx) {
 	provide(KEY, ctx);
 }
@@ -27,7 +27,7 @@ function useContextMenuGroupContext() {
 	if (!ctx) throw new Error("[xh] ContextMenu 分组标题必须用在 XhContextMenuGroup 内");
 	return ctx;
 }
-const CHAIN_KEY = Symbol("xh-context-menu-chain");
+const CHAIN_KEY = Symbol.for("xh-context-menu-chain");
 function provideContextMenuChain(chain) {
 	provide(CHAIN_KEY, chain);
 }
@@ -36,7 +36,7 @@ function useContextMenuChain() {
 	if (!chain) throw new Error("[xh] ContextMenuSub 必须用在 XhContextMenuRoot 内");
 	return chain;
 }
-const SUB_KEY = Symbol("xh-context-menu-sub");
+const SUB_KEY = Symbol.for("xh-context-menu-sub");
 function provideContextMenuSub(handle) {
 	provide(SUB_KEY, handle);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/context-menu/context.ts"],"sourcesContent":["import type { ContextMenuGroupProps, ContextMenuItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { ContextMenuContext } from './use-context-menu'\nimport { inject, provide } from 'vue'\n\n/** 条目自报的值与禁用，供 item-text / item-indicator 这类子部件复用同一份声明。 */\nexport interface ContextMenuItemContext {\n  item: ComputedRef<ContextMenuItemProps>\n}\n\n/** 分组自报的身份，供分组标题取到同一个值（标题的 id 由它派生）。 */\nexport interface ContextMenuGroupContext {\n  group: ComputedRef<ContextMenuGroupProps>\n}\n\nconst KEY: InjectionKey<ContextMenuContext> = Symbol('xh-context-menu')\nconst ITEM_KEY: InjectionKey<ContextMenuItemContext> = Symbol('xh-context-menu-item')\nconst GROUP_KEY: InjectionKey<ContextMenuGroupContext> = Symbol('xh-context-menu-group')\n\nexport function provideContextMenu(ctx: ContextMenuContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useContextMenuContext(): ContextMenuContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] ContextMenu 部件必须用在 XhContextMenuRoot 内')\n  return ctx\n}\n\nexport function provideContextMenuItem(ctx: ContextMenuItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useContextMenuItemContext(): ContextMenuItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] ContextMenu 条目子部件必须用在 XhContextMenuItem 内')\n  return ctx\n}\n\nexport function provideContextMenuGroup(ctx: ContextMenuGroupContext): void {\n  provide(GROUP_KEY, ctx)\n}\n\nexport function useContextMenuGroupContext(): ContextMenuGroupContext {\n  const ctx = inject(GROUP_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] ContextMenu 分组标题必须用在 XhContextMenuGroup 内')\n  return ctx\n}\n\n/** 选中链：子菜单任意层级的选中都汇到根——先发根的 select，再关根，各级随父关闭级联收起。 */\nexport interface ContextMenuChain {\n  notifySelect: (details: { value: string }) => void\n}\n\nconst CHAIN_KEY: InjectionKey<ContextMenuChain> = Symbol('xh-context-menu-chain')\n\nexport function provideContextMenuChain(chain: ContextMenuChain): void {\n  provide(CHAIN_KEY, chain)\n}\n\nexport function useContextMenuChain(): ContextMenuChain {\n  const chain = inject(CHAIN_KEY, null)\n  if (!chain)\n    throw new Error('[xh] ContextMenuSub 必须用在 XhContextMenuRoot 内')\n  return chain\n}\n\n/** 子菜单触发条目要同时够到父右键菜单与本子菜单，这里存父层句柄与它在父层里的身份。 */\nexport interface ContextMenuSubHandle {\n  parent: ContextMenuContext\n  value: string\n  disabled?: boolean\n}\n\nconst SUB_KEY: InjectionKey<ContextMenuSubHandle> = Symbol('xh-context-menu-sub')\n\nexport function provideContextMenuSub(handle: ContextMenuSubHandle): void {\n  provide(SUB_KEY, handle)\n}\n\nexport function useContextMenuSubContext(): ContextMenuSubHandle {\n  const handle = inject(SUB_KEY, null)\n  if (!handle)\n    throw new Error('[xh] ContextMenuSubTrigger 必须用在 XhContextMenuSub 内')\n  return handle\n}\n"],"mappings":";;AAeA,MAAM,MAAwC,OAAO,iBAAiB;AACtE,MAAM,WAAiD,OAAO,sBAAsB;AACpF,MAAM,YAAmD,OAAO,uBAAuB;AAEvF,SAAgB,mBAAmB,KAA+B;CAChE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,wBAA4C;CAC1D,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,6CAA6C;CAC/D,OAAO;AACT;AAEA,SAAgB,uBAAuB,KAAmC;CACxE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,4BAAoD;CAClE,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,gDAAgD;CAClE,OAAO;AACT;AAEA,SAAgB,wBAAwB,KAAoC;CAC1E,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,6BAAsD;CACpE,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,gDAAgD;CAClE,OAAO;AACT;AAOA,MAAM,YAA4C,OAAO,uBAAuB;AAEhF,SAAgB,wBAAwB,OAA+B;CACrE,QAAQ,WAAW,KAAK;AAC1B;AAEA,SAAgB,sBAAwC;CACtD,MAAM,QAAQ,OAAO,WAAW,IAAI;CACpC,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,8CAA8C;CAChE,OAAO;AACT;AASA,MAAM,UAA8C,OAAO,qBAAqB;AAEhF,SAAgB,sBAAsB,QAAoC;CACxE,QAAQ,SAAS,MAAM;AACzB;AAEA,SAAgB,2BAAiD;CAC/D,MAAM,SAAS,OAAO,SAAS,IAAI;CACnC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,oDAAoD;CACtE,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/context-menu/context.ts"],"sourcesContent":["import type { ContextMenuGroupProps, ContextMenuItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { ContextMenuContext } from './use-context-menu'\nimport { inject, provide } from 'vue'\n\n/** 条目自报的值与禁用，供 item-text / item-indicator 这类子部件复用同一份声明。 */\nexport interface ContextMenuItemContext {\n  item: ComputedRef<ContextMenuItemProps>\n}\n\n/** 分组自报的身份，供分组标题取到同一个值（标题的 id 由它派生）。 */\nexport interface ContextMenuGroupContext {\n  group: ComputedRef<ContextMenuGroupProps>\n}\n\nconst KEY: InjectionKey<ContextMenuContext> = Symbol.for('xh-context-menu')\nconst ITEM_KEY: InjectionKey<ContextMenuItemContext> = Symbol.for('xh-context-menu-item')\nconst GROUP_KEY: InjectionKey<ContextMenuGroupContext> = Symbol.for('xh-context-menu-group')\n\nexport function provideContextMenu(ctx: ContextMenuContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useContextMenuContext(): ContextMenuContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] ContextMenu 部件必须用在 XhContextMenuRoot 内')\n  return ctx\n}\n\nexport function provideContextMenuItem(ctx: ContextMenuItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useContextMenuItemContext(): ContextMenuItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] ContextMenu 条目子部件必须用在 XhContextMenuItem 内')\n  return ctx\n}\n\nexport function provideContextMenuGroup(ctx: ContextMenuGroupContext): void {\n  provide(GROUP_KEY, ctx)\n}\n\nexport function useContextMenuGroupContext(): ContextMenuGroupContext {\n  const ctx = inject(GROUP_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] ContextMenu 分组标题必须用在 XhContextMenuGroup 内')\n  return ctx\n}\n\n/** 选中链：子菜单任意层级的选中都汇到根——先发根的 select，再关根，各级随父关闭级联收起。 */\nexport interface ContextMenuChain {\n  notifySelect: (details: { value: string }) => void\n}\n\nconst CHAIN_KEY: InjectionKey<ContextMenuChain> = Symbol.for('xh-context-menu-chain')\n\nexport function provideContextMenuChain(chain: ContextMenuChain): void {\n  provide(CHAIN_KEY, chain)\n}\n\nexport function useContextMenuChain(): ContextMenuChain {\n  const chain = inject(CHAIN_KEY, null)\n  if (!chain)\n    throw new Error('[xh] ContextMenuSub 必须用在 XhContextMenuRoot 内')\n  return chain\n}\n\n/** 子菜单触发条目要同时够到父右键菜单与本子菜单，这里存父层句柄与它在父层里的身份。 */\nexport interface ContextMenuSubHandle {\n  parent: ContextMenuContext\n  value: string\n  disabled?: boolean\n}\n\nconst SUB_KEY: InjectionKey<ContextMenuSubHandle> = Symbol.for('xh-context-menu-sub')\n\nexport function provideContextMenuSub(handle: ContextMenuSubHandle): void {\n  provide(SUB_KEY, handle)\n}\n\nexport function useContextMenuSubContext(): ContextMenuSubHandle {\n  const handle = inject(SUB_KEY, null)\n  if (!handle)\n    throw new Error('[xh] ContextMenuSubTrigger 必须用在 XhContextMenuSub 内')\n  return handle\n}\n"],"mappings":";;AAeA,MAAM,MAAwC,OAAO,IAAI,iBAAiB;AAC1E,MAAM,WAAiD,OAAO,IAAI,sBAAsB;AACxF,MAAM,YAAmD,OAAO,IAAI,uBAAuB;AAE3F,SAAgB,mBAAmB,KAA+B;CAChE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,wBAA4C;CAC1D,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,6CAA6C;CAC/D,OAAO;AACT;AAEA,SAAgB,uBAAuB,KAAmC;CACxE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,4BAAoD;CAClE,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,gDAAgD;CAClE,OAAO;AACT;AAEA,SAAgB,wBAAwB,KAAoC;CAC1E,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,6BAAsD;CACpE,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,gDAAgD;CAClE,OAAO;AACT;AAOA,MAAM,YAA4C,OAAO,IAAI,uBAAuB;AAEpF,SAAgB,wBAAwB,OAA+B;CACrE,QAAQ,WAAW,KAAK;AAC1B;AAEA,SAAgB,sBAAwC;CACtD,MAAM,QAAQ,OAAO,WAAW,IAAI;CACpC,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,8CAA8C;CAChE,OAAO;AACT;AASA,MAAM,UAA8C,OAAO,IAAI,qBAAqB;AAEpF,SAAgB,sBAAsB,QAAoC;CACxE,QAAQ,SAAS,MAAM;AACzB;AAEA,SAAgB,2BAAiD;CAC/D,MAAM,SAAS,OAAO,SAAS,IAAI;CACnC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,oDAAoD;CACtE,OAAO;AACT"}

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

@@ -8,6 +8,10 @@ interface ContextMenuContext {
   triggerRef: Ref<HTMLElement | null>;
   positionerRef: Ref<HTMLElement | null>;
   contentRef: Ref<HTMLElement | null>;
+  /** 此刻该不该渲染：退场动画播完之前仍为真。 */
+  visible: Ref<boolean>;
+  /** 浮层搬到哪儿：全局配置的 portalContainer > body。 */
+  portalTarget: ComputedRef<string | Element>;
 }
 declare function useContextMenu(props: ContextMenuSchema['props'], onOpenChange?: ContextMenuSchema['props']['onOpenChange'], onSelect?: ContextMenuSchema['props']['onSelect']): ContextMenuContext;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-context-menu.d.ts","names":[],"sources":["../../../src/components/context-menu/use-context-menu.ts"],"mappings":";;;;UAYiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;iBAGF,eACd,OAAO,4BACP,eAAe,4CACf,WAAW,yCACV"}
+{"version":3,"file":"use-context-menu.d.ts","names":[],"sources":["../../../src/components/context-menu/use-context-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,eACd,OAAO,4BACP,eAAe,4CACf,WAAW,yCACV"}

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

@@ -1,4 +1,6 @@
+import { useOverlayExit } from "../../runtime/use-overlay-exit.js";
 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";
@@ -7,6 +9,7 @@ import { createRuntimeConfig, createScope } from "@xihan-ui/kernel";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/context-menu/use-context-menu.ts
 function useContextMenu(props, onOpenChange, onSelect) {
+	const xhConfig = useXhConfig();
 	const triggerRef = ref(null);
 	const positionerRef = ref(null);
 	const contentRef = ref(null);
@@ -17,15 +20,16 @@ function useContextMenu(props, onOpenChange, onSelect) {
 		onOpenChange,
 		onSelect
 	}), scope);
+	let config = null;
 	if (typeof document !== "undefined") {
-		const config = createRuntimeConfig({
+		config = createRuntimeConfig({
 			scope,
 			idGenerator: idGen
 		});
 		const registerLayer = () => config.layerRegistry.register({
 			kind: "popover",
 			node: () => contentRef.value,
-			branches: () => [triggerRef.value].filter(Boolean),
+			branches: () => [triggerRef.value, positionerRef.value].filter(Boolean),
 			isModal: () => false,
 			setModal: () => {},
 			surfaces: () => []
@@ -37,12 +41,19 @@ function useContextMenu(props, onOpenChange, onSelect) {
 		service.refs.set("getTriggerEl", () => triggerRef.value);
 		service.refs.set("getContentEl", () => contentRef.value);
 	}
+	const api = computed(() => connectContextMenu(service, vueNormalize));
 	return {
+		visible: useOverlayExit({
+			config,
+			isOpen: () => api.value.open,
+			contentRef
+		}),
 		service,
-		api: computed(() => connectContextMenu(service, vueNormalize)),
+		api,
 		triggerRef,
 		positionerRef,
-		contentRef
+		contentRef,
+		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body")
 	};
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-context-menu.js","names":[],"sources":["../../../src/components/context-menu/use-context-menu.ts"],"sourcesContent":["import type { ContextMenuApi, ContextMenuSchema } 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 { connectContextMenu, contextMenuMachine } from '@xihan-ui/headless'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/kernel'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface ContextMenuContext {\n  service: Service<ContextMenuSchema>\n  api: ComputedRef<ContextMenuApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n}\n\nexport function useContextMenu(\n  props: ContextMenuSchema['props'],\n  onOpenChange?: ContextMenuSchema['props']['onOpenChange'],\n  onSelect?: ContextMenuSchema['props']['onSelect'],\n): ContextMenuContext {\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(contextMenuMachine, () => ({ ...props, onOpenChange, onSelect }), scope)\n\n  if (typeof document !== 'undefined') {\n    const config: RuntimeConfig = 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      // 触发区记为本层分支，展开着再右键可就地换坐标；左键关闭由 connect 在 pointerdown 上收口\n      branches: () => [triggerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      setModal: () => {},\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点是光标坐标，故无 getAnchorEl\n    service.refs.set('config', config)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    // 触发区不当定位锚点，但收起时焦点要归还它\n    service.refs.set('getTriggerEl', () => triggerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectContextMenu(service, vueNormalize))\n  return { service, api, triggerRef, positionerRef, contentRef }\n}\n"],"mappings":";;;;;;;;AAoBA,SAAgB,eACd,OACA,cACA,UACoB;CACpB,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,2BAA2B;EAAE,GAAG;EAAO;EAAc;CAAS,IAAI,KAAK;CAElG,IAAI,OAAO,aAAa,aAAa;EACnC,MAAM,SAAwB,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG/E,MAAM,sBAA0D,OAAO,cAAc,SAAS;GAC5F,MAAM;GACN,YAAY,WAAW;GAEvB,gBAAgB,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,OAAO;GACjD,eAAe;GACf,gBAAgB,CAAC;GACjB,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAM;EACjC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAE3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAGA,OAAO;EAAE;EAAS,KADN,eAAe,mBAAmB,SAAS,YAAY,CAC/C;EAAG;EAAY;EAAe;CAAW;AAC/D"}
+{"version":3,"file":"use-context-menu.js","names":[],"sources":["../../../src/components/context-menu/use-context-menu.ts"],"sourcesContent":["import type { ContextMenuApi, ContextMenuSchema } 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 { connectContextMenu, contextMenuMachine } 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 ContextMenuContext {\n  service: Service<ContextMenuSchema>\n  api: ComputedRef<ContextMenuApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 此刻该不该渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层搬到哪儿：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useContextMenu(\n  props: ContextMenuSchema['props'],\n  onOpenChange?: ContextMenuSchema['props']['onOpenChange'],\n  onSelect?: ContextMenuSchema['props']['onSelect'],\n): ContextMenuContext {\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(contextMenuMachine, () => ({ ...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      // 触发区记为本层分支，展开着再右键可就地换坐标；左键关闭由 connect 在 pointerdown 上收口。\n      // 浮层壳一并记上：条目列表之外还浮着自绘滚动条，按住它拖动不该把菜单消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      setModal: () => {},\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点是光标坐标，故无 getAnchorEl\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    // 触发区兼作两用：收起时焦点归还它，没有光标坐标时它的起始角就是锚点\n    service.refs.set('getTriggerEl', () => triggerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectContextMenu(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({ config, isOpen: () => api.value.open, contentRef })\n  // 先问全局配置的落点，没有才落 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,eACd,OACA,cACA,UACoB;CACpB,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,2BAA2B;EAAE,GAAG;EAAO;EAAc;CAAS,IAAI,KAAK;CAGlG,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,uBAAuB,cAAc,KAAK;EAE3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAEA,MAAM,MAAM,eAAe,mBAAmB,SAAS,YAAY,CAAC;CAMpE,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"}

package/dist/components/date-field/context.js

@@ -1,6 +1,6 @@
 import { inject, provide } from "vue";
 //#region src/components/date-field/context.ts
-const KEY = Symbol("xh-date-field");
+const KEY = Symbol.for("xh-date-field");
 function provideDateField(ctx) {
 	provide(KEY, ctx);
 }

package/dist/components/date-field/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/date-field/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { DateFieldContext } from './use-date-field'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<DateFieldContext> = Symbol('xh-date-field')\n\nexport function provideDateField(ctx: DateFieldContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useDateFieldContext(): DateFieldContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] DateField 部件必须用在 XhDateFieldRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAsC,OAAO,eAAe;AAElE,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,yCAAyC;CAC3D,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/date-field/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { DateFieldContext } from './use-date-field'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<DateFieldContext> = Symbol.for('xh-date-field')\n\nexport function provideDateField(ctx: DateFieldContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useDateFieldContext(): DateFieldContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] DateField 部件必须用在 XhDateFieldRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAsC,OAAO,IAAI,eAAe;AAEtE,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,yCAAyC;CAC3D,OAAO;AACT"}

package/dist/components/date-field/date-field.d.ts

@@ -1,12 +1,12 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
-import { DateFieldApi, DateFieldSchema, DateFieldSegmentState, DateGranularity, DateSegmentType } from "@xihan-ui/headless";
+import { DateFieldApi, DateFieldSchema, DateFieldSegmentState, DateFieldTranslations, DateGranularity, DateSegmentSet, DateSegmentType } from "@xihan-ui/headless";
 import { ControlVariant, Size, Tone } from "@xihan-ui/kernel";
 //#region src/components/date-field/date-field.d.ts
 type DateFieldProps = DateFieldSchema['props'];
 type SegmentTexts = { readonly [K in DateSegmentType]?: string; };
 /** 默认插槽的载荷：整份值、逐段投影、填写状态，以及改写与清空的句柄。 */
-type DateFieldRootSlotProps = Pick<DateFieldApi, 'value' | 'valueAsDate' | 'segments' | 'complete' | 'empty' | 'outOfRange' | 'focusedSegment' | 'setValue' | 'clear'>;
+type DateFieldRootSlotProps = Pick<DateFieldApi, 'value' | 'valueAsDate' | 'segments' | 'complete' | 'empty' | 'outOfRange' | 'focusedSegment' | 'setValue' | 'clear' | 'canClear'>;
 /** 段位默认插槽的载荷：本段的投影；下标越界时缺席。 */
 interface DateFieldSegmentSlotProps {
   segment: DateFieldSegmentState | undefined;
@@ -40,6 +40,10 @@ declare const XhDateFieldRoot: import("vue").DefineComponent<import("vue").Extra
     type: PropType<DateGranularity>;
     default: undefined;
   };
+  segments: {
+    type: PropType<DateSegmentSet>;
+    default: undefined;
+  };
   disabled: BooleanConstructor;
   readOnly: BooleanConstructor;
   invalid: BooleanConstructor;
@@ -53,7 +57,7 @@ declare const XhDateFieldRoot: import("vue").DefineComponent<import("vue").Extra
     default: undefined;
   };
   translations: {
-    type: PropType<SegmentTexts>;
+    type: PropType<DateFieldTranslations>;
     default: undefined;
   };
   variant: {
@@ -102,6 +106,10 @@ declare const XhDateFieldRoot: import("vue").DefineComponent<import("vue").Extra
     type: PropType<DateGranularity>;
     default: undefined;
   };
+  segments: {
+    type: PropType<DateSegmentSet>;
+    default: undefined;
+  };
   disabled: BooleanConstructor;
   readOnly: BooleanConstructor;
   invalid: BooleanConstructor;
@@ -115,7 +123,7 @@ declare const XhDateFieldRoot: import("vue").DefineComponent<import("vue").Extra
     default: undefined;
   };
   translations: {
-    type: PropType<SegmentTexts>;
+    type: PropType<DateFieldTranslations>;
     default: undefined;
   };
   variant: {
@@ -142,14 +150,15 @@ declare const XhDateFieldRoot: import("vue").DefineComponent<import("vue").Extra
   tone: Tone;
   size: Size;
   disabled: boolean;
-  translations: SegmentTexts;
-  max: string;
+  translations: DateFieldTranslations;
   variant: ControlVariant;
+  max: string;
   readOnly: boolean;
   min: string;
   locale: string;
   timeZone: string;
   placeholder: SegmentTexts;
+  segments: DateSegmentSet;
   granularity: DateGranularity;
 }, SlotsType<{
   default?: (props: DateFieldRootSlotProps) => VNode[];
@@ -160,24 +169,43 @@ declare const XhDateFieldLabel: import("vue").DefineComponent<{}, () => VNode<im
 declare const XhDateFieldControl: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhDateFieldSegmentGroup: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhDateFieldSegment: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   index: {
     type: PropType<number | string>;
-    required: true;
+    default: undefined;
+  };
+  /** 按段名声明这一格。段集里没有这一块时它收起；与 index 二选一，两个都写按段名算。 */
+  segment: {
+    type: PropType<DateSegmentType>;
+    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   index: {
     type: PropType<number | string>;
-    required: true;
+    default: undefined;
   };
-}>> & Readonly<{}>, {}, SlotsType<{
+  /** 按段名声明这一格。段集里没有这一块时它收起；与 index 二选一，两个都写按段名算。 */
+  segment: {
+    type: PropType<DateSegmentType>;
+    default: undefined;
+  };
+}>> & Readonly<{}>, {
+  index: string | number;
+  segment: DateSegmentType;
+}, SlotsType<{
   default?: (props: DateFieldSegmentSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhDateFieldClearTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhDateFieldHiddenInput: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { DateFieldRootSlotProps, DateFieldSegmentSlotProps, XhDateFieldControl, XhDateFieldHiddenInput, XhDateFieldLabel, XhDateFieldRoot, XhDateFieldSegment };
+export { DateFieldRootSlotProps, DateFieldSegmentSlotProps, XhDateFieldClearTrigger, XhDateFieldControl, XhDateFieldHiddenInput, XhDateFieldLabel, XhDateFieldRoot, XhDateFieldSegment, XhDateFieldSegmentGroup };
 //# sourceMappingURL=date-field.d.ts.map

package/dist/components/date-field/date-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date-field.d.ts","names":[],"sources":["../../../src/components/date-field/date-field.ts"],"mappings":";;;;;KASK,iBAAiB;KACjB,2BAA2B,KAAK;;KAGzB,yBAAyB,KACnC;;UAae;EACf,SAAS;;cAGE,+BAAe,8BAAA;;IAIC,MAAA;;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;;;;;;;;;;IAMT,MAAA,SAAS;;;;IACR,MAAA,SAAS;;;;IACd,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAIN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IArBV,MAAA;;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;;;;;;;;;;IAMT,MAAA,SAAS;;;;IACR,MAAA,SAAS;;;;IACd,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;EAQvB,WAAC,OAAO,2BAA2B;kCAqB/C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;IAIQ,MAAA;;;;;;;IAAA,MAAA;;;;EAGzB,WAAC,OAAO,8BAA8B;kCAgBlD;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"date-field.d.ts","names":[],"sources":["../../../src/components/date-field/date-field.ts"],"mappings":";;;;;KASK,iBAAiB;KACjB,2BAA2B,KAAK;;KAGzB,yBAAyB,KACnC;;UAce;EACf,SAAS;;cAGE,+BAAe,8BAAA;;IAIC,MAAA;;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;;IAEb,MAAA,SAAS;;;;;;;;;;;;IAML,MAAA,SAAS;;;;IACR,MAAA,SAAS;;;;IACd,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAIN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IAvBV,MAAA;;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;;IAEb,MAAA,SAAS;;;;;;;;;;;;IAML,MAAA,SAAS;;;;IACR,MAAA,SAAS;;;;IACd,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;EAQvB,WAAC,OAAO,2BAA2B;kCAsB/C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;IAIQ,MAAA;;;;;IAER,MAAA,SAAS;;;;;;;IAFD,MAAA;;;;;IAER,MAAA,SAAS;;;;;;;EAG1B,WAAC,OAAO,8BAA8B;kCAmBlD;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/date-field/date-field.js

@@ -34,6 +34,10 @@ const XhDateFieldRoot = defineComponent({
 			type: String,
 			default: void 0
 		},
+		segments: {
+			type: Array,
+			default: void 0
+		},
 		disabled: Boolean,
 		readOnly: Boolean,
 		invalid: Boolean,
@@ -84,7 +88,8 @@ const XhDateFieldRoot = defineComponent({
 			outOfRange: ctx.api.value.outOfRange,
 			focusedSegment: ctx.api.value.focusedSegment,
 			setValue: ctx.api.value.setValue,
-			clear: ctx.api.value.clear
+			clear: ctx.api.value.clear,
+			canClear: ctx.api.value.canClear
 		}));
 	}
 });
@@ -102,23 +107,44 @@ const XhDateFieldControl = defineComponent({
 		return () => h("div", ctx.api.value.getControlProps(), slots.default?.());
 	}
 });
+const XhDateFieldSegmentGroup = defineComponent({
+	name: "XhDateFieldSegmentGroup",
+	setup(_, { slots }) {
+		const ctx = useDateFieldContext();
+		return () => h("div", ctx.api.value.getSegmentGroupProps(), slots.default?.());
+	}
+});
 const XhDateFieldSegment = defineComponent({
 	name: "XhDateFieldSegment",
-	props: { index: {
-		type: [Number, String],
-		required: true
-	} },
+	props: {
+		index: {
+			type: [Number, String],
+			default: void 0
+		},
+		/** 按段名声明这一格。段集里没有这一块时它收起；与 index 二选一，两个都写按段名算。 */
+		segment: {
+			type: String,
+			default: void 0
+		}
+	},
 	slots: Object,
 	setup(props, { slots }) {
 		const ctx = useDateFieldContext();
 		return () => {
-			const index = Math.trunc(Number(props.index));
 			const api = ctx.api.value;
-			const state = api.segments[index];
-			return h("div", api.getSegmentProps({ index }), slots.default ? slots.default({ segment: state }) : state?.text);
+			const declared = props.segment != null ? { segment: props.segment } : { index: Math.trunc(Number(props.index)) };
+			const state = api.segmentOf(declared);
+			return h("div", api.getSegmentProps(declared), slots.default ? slots.default({ segment: state }) : state?.text);
 		};
 	}
 });
+const XhDateFieldClearTrigger = defineComponent({
+	name: "XhDateFieldClearTrigger",
+	setup(_, { slots }) {
+		const ctx = useDateFieldContext();
+		return () => h("button", ctx.api.value.getClearTriggerProps(), slots.default?.());
+	}
+});
 const XhDateFieldHiddenInput = defineComponent({
 	name: "XhDateFieldHiddenInput",
 	setup() {
@@ -127,6 +153,6 @@ const XhDateFieldHiddenInput = defineComponent({
 	}
 });
 //#endregion
-export { XhDateFieldControl, XhDateFieldHiddenInput, XhDateFieldLabel, XhDateFieldRoot, XhDateFieldSegment };
+export { XhDateFieldClearTrigger, XhDateFieldControl, XhDateFieldHiddenInput, XhDateFieldLabel, XhDateFieldRoot, XhDateFieldSegment, XhDateFieldSegmentGroup };
 
 //# sourceMappingURL=date-field.js.map