@xihan-ui/vue 1.1.0 → 2.0.0

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

@@ -0,0 +1,88 @@
+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, onBeforeUnmount, ref, watch } from "vue";
+import { attachCssExit, createPresence } from "@xihan-ui/core/presence";
+import { createRuntimeConfig, createScope } from "@xihan-ui/core";
+import { commandMachine, connectCommand } from "@xihan-ui/headless";
+//#region src/components/command/use-command.ts
+function useCommand(props, handlers = {}) {
+	const contentRef = ref(null);
+	const backdropRef = ref(null);
+	const listRef = ref(null);
+	const inputRef = ref(null);
+	const idGen = createVueIdGenerator();
+	const scope = createScope(null, idGen);
+	const service = useMachine(commandMachine, () => ({
+		...props,
+		...handlers
+	}), scope);
+	const rendered = ref(service.state.get() === "open");
+	const xhConfig = useXhConfig();
+	let config = null;
+	if (typeof document !== "undefined") {
+		config = createRuntimeConfig({
+			scope,
+			idGenerator: idGen,
+			scrollRoot: () => xhConfig.value.scrollRoot?.() ?? null
+		});
+		const registerLayer = () => config.layerRegistry.register({
+			kind: "modal",
+			node: () => contentRef.value,
+			branches: () => [],
+			isModal: () => props.modal ?? true,
+			surfaces: () => [backdropRef.value].filter(Boolean)
+		});
+		const presence = createPresence({
+			config,
+			open: service.state.get() === "open",
+			onRenderedChange: (r) => {
+				rendered.value = r;
+			}
+		});
+		rendered.value = presence.rendered;
+		service.refs.set("config", config);
+		service.refs.set("registerLayer", registerLayer);
+		service.refs.set("presence", presence);
+		service.refs.set("getContentEl", () => contentRef.value);
+		service.refs.set("getListEl", () => listRef.value);
+		service.refs.set("getInputEl", () => inputRef.value);
+		watch(listRef, (list) => {
+			service.refs.set("getListEl", () => list);
+			service.refs.get("syncListVisibility")?.();
+		}, { flush: "post" });
+		watch(() => service.state.get() === "open", (open) => presence.update(open), { flush: "post" });
+		const exits = /* @__PURE__ */ new Map();
+		watch([contentRef, backdropRef], (nodes) => {
+			const next = new Set(nodes.filter((node) => node !== null));
+			for (const node of next) if (!exits.has(node)) exits.set(node, attachCssExit(node, presence));
+			for (const [node, detach] of exits) if (!next.has(node)) {
+				exits.delete(node);
+				detach();
+			}
+		}, {
+			flush: "post",
+			immediate: true
+		});
+		onBeforeUnmount(() => {
+			for (const detach of exits.values()) detach();
+			exits.clear();
+			presence.dispose();
+		});
+	}
+	return {
+		service,
+		api: computed(() => connectCommand(service, vueNormalize)),
+		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body"),
+		rendered,
+		contentRef,
+		backdropRef,
+		listRef,
+		inputRef
+	};
+}
+//#endregion
+export { useCommand };
+
+//# sourceMappingURL=use-command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-command.js","names":[],"sources":["../../../src/components/command/use-command.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use command 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { PresenceHandle } from '@xihan-ui/core/presence'\nimport type { CommandApi, CommandSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { attachCssExit, createPresence } from '@xihan-ui/core/presence'\nimport { commandMachine, connectCommand } from '@xihan-ui/headless'\nimport { computed, onBeforeUnmount, ref, watch } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface CommandContext {\n  service: Service<CommandSchema>\n  api: ComputedRef<CommandApi>\n  /** 浮层迁移到的位置：全局配置 > 单一落点。 */\n  portalTarget: ComputedRef<string | Element>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  rendered: Ref<boolean>\n  contentRef: Ref<HTMLElement | null>\n  backdropRef: Ref<HTMLElement | null>\n  listRef: Ref<HTMLElement | null>\n  inputRef: Ref<HTMLInputElement | null>\n}\n\nexport function useCommand(\n  props: CommandSchema['props'],\n  handlers: Pick<CommandSchema['props'], 'onOpenChange' | 'onInputValueChange' | 'onSelect'> = {},\n): CommandContext {\n  const contentRef = ref<HTMLElement | null>(null)\n  const backdropRef = ref<HTMLElement | null>(null)\n  const listRef = ref<HTMLElement | null>(null)\n  const inputRef = ref<HTMLInputElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(commandMachine, () => ({ ...props, ...handlers }), scope)\n\n  // 初值取状态而不是 false：presence 只在有 DOM 时才建，服务端拿不到它。\n  // 服务端算不出 rendered 就只发一个空占位，客户端水合时补出整棵子树 = mismatch\n  const rendered = ref(service.state.get() === 'open')\n\n  const xhConfig = useXhConfig()\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({\n      scope,\n      idGenerator: idGen,\n      // 宿主把滚动搬进内容容器时 body 本身不滚，加锁会是空操作；这条把真正在滚的那层交给滚动锁\n      scrollRoot: () => xhConfig.value.scrollRoot?.() ?? null,\n    })\n    // 只提供注册函数，入栈出栈由机器的 trackOverlay 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'modal',\n      node: () => contentRef.value,\n      branches: () => [],\n      isModal: () => props.modal ?? true,\n      surfaces: () => [backdropRef.value].filter(Boolean) as Element[],\n    })\n    const presence: PresenceHandle = createPresence({\n      config,\n      open: service.state.get() === 'open',\n      onRenderedChange: (r) => {\n        rendered.value = r\n      },\n    })\n    rendered.value = presence.rendered\n\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('presence', presence)\n    service.refs.set('getContentEl', () => contentRef.value)\n    service.refs.set('getListEl', () => listRef.value)\n    service.refs.set('getInputEl', () => inputRef.value)\n\n    // List 在展开期间换代时重新发布引用，让依赖该端口的效应撤旧重绑。\n    watch(listRef, (list) => {\n      service.refs.set('getListEl', () => list)\n      service.refs.get('syncListVisibility')?.()\n    }, { flush: 'post' })\n\n    // data-state 提交到 DOM 之后再驱动 presence，让退场探测读到正确的 animationName\n    watch(() => service.state.get() === 'open', open => presence.update(open), { flush: 'post' })\n\n    // content 与 modal backdrop 的有限退场共同决定资源归还；动态切 modal 时精确撤旧接新。\n    const exits = new Map<HTMLElement, () => void>()\n    watch([contentRef, backdropRef], (nodes) => {\n      const next = new Set(nodes.filter((node): node is HTMLElement => node !== null))\n      for (const node of next) {\n        if (!exits.has(node))\n          exits.set(node, attachCssExit(node, presence))\n      }\n      for (const [node, detach] of exits) {\n        if (!next.has(node)) {\n          exits.delete(node)\n          detach()\n        }\n      }\n    }, { flush: 'post', immediate: true })\n\n    onBeforeUnmount(() => {\n      for (const detach of exits.values()) detach()\n      exits.clear()\n      presence.dispose()\n    })\n  }\n\n  const api = computed(() => connectCommand(service, vueNormalize))\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { service, api, portalTarget, rendered, contentRef, backdropRef, listRef, inputRef }\n}\n"],"mappings":";;;;;;;;;AAiCA,SAAgB,WACd,OACA,WAA6F,CAAC,GAC9E;CAChB,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,cAAc,IAAwB,IAAI;CAChD,MAAM,UAAU,IAAwB,IAAI;CAC5C,MAAM,WAAW,IAA6B,IAAI;CAElD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO,GAAG;CAAS,IAAI,KAAK;CAInF,MAAM,WAAW,IAAI,QAAQ,MAAM,IAAI,MAAM,MAAM;CAEnD,MAAM,WAAW,YAAY;CAC7B,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAC3B;GACA,aAAa;GAEb,kBAAkB,SAAS,MAAM,aAAa,KAAK;EACrD,CAAC;EAED,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GACvB,gBAAgB,CAAC;GACjB,eAAe,MAAM,SAAS;GAC9B,gBAAgB,CAAC,YAAY,KAAK,CAAC,CAAC,OAAO,OAAO;EACpD,CAAC;EACD,MAAM,WAA2B,eAAe;GAC9C;GACA,MAAM,QAAQ,MAAM,IAAI,MAAM;GAC9B,mBAAmB,MAAM;IACvB,SAAS,QAAQ;GACnB;EACF,CAAC;EACD,SAAS,QAAQ,SAAS;EAE1B,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,QAAQ;EACrC,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;EACjD,QAAQ,KAAK,IAAI,oBAAoB,SAAS,KAAK;EAGnD,MAAM,UAAU,SAAS;GACvB,QAAQ,KAAK,IAAI,mBAAmB,IAAI;GACxC,QAAQ,KAAK,IAAI,oBAAoB,CAAC,GAAG;EAC3C,GAAG,EAAE,OAAO,OAAO,CAAC;EAGpB,YAAY,QAAQ,MAAM,IAAI,MAAM,SAAQ,SAAQ,SAAS,OAAO,IAAI,GAAG,EAAE,OAAO,OAAO,CAAC;EAG5F,MAAM,wBAAQ,IAAI,IAA6B;EAC/C,MAAM,CAAC,YAAY,WAAW,IAAI,UAAU;GAC1C,MAAM,OAAO,IAAI,IAAI,MAAM,QAAQ,SAA8B,SAAS,IAAI,CAAC;GAC/E,KAAK,MAAM,QAAQ,MACjB,IAAI,CAAC,MAAM,IAAI,IAAI,GACjB,MAAM,IAAI,MAAM,cAAc,MAAM,QAAQ,CAAC;GAEjD,KAAK,MAAM,CAAC,MAAM,WAAW,OAC3B,IAAI,CAAC,KAAK,IAAI,IAAI,GAAG;IACnB,MAAM,OAAO,IAAI;IACjB,OAAO;GACT;EAEJ,GAAG;GAAE,OAAO;GAAQ,WAAW;EAAK,CAAC;EAErC,sBAAsB;GACpB,KAAK,MAAM,UAAU,MAAM,OAAO,GAAG,OAAO;GAC5C,MAAM,MAAM;GACZ,SAAS,QAAQ;EACnB,CAAC;CACH;CAKA,OAAO;EAAE;EAAS,KAHN,eAAe,eAAe,SAAS,YAAY,CAG3C;EAAG,cAFF,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEvF;EAAG;EAAU;EAAY;EAAa;EAAS;CAAS;AAC5F"}

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

@@ -1,17 +1,16 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
+import { Direction, Placement, Size, Tone } from "@xihan-ui/core";
 import { ContextMenuApi, ContextMenuNode, ContextMenuNodeMeta, ContextMenuSchema, MenuApi } from "@xihan-ui/headless";
-import { Direction, Placement, Size, Tone } from "@xihan-ui/kernel";
 //#region src/components/context-menu/context-menu.d.ts
 type ContextMenuProps = ContextMenuSchema['props'];
 /** 默认插槽的载荷：右键菜单的展开态与锚点坐标，以及开合、按坐标展开的命令。 */
 type ContextMenuRootSlotProps = Pick<ContextMenuApi, 'open' | 'point' | 'setOpen' | 'openAt'>;
-/** 子菜单默认插槽的载荷：这一层子菜单自己的展开态与开合命令。 */
+/** 子菜单默认插槽的载荷：该层子菜单自己的展开态与开合命令。 */
 type ContextMenuSubSlotProps = Pick<MenuApi, 'open' | 'setOpen'>;
 declare const XhContextMenuRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<ContextMenuNode[]>;
-    default: undefined;
   };
   open: {
     type: BooleanConstructor;
@@ -20,11 +19,9 @@ declare const XhContextMenuRoot: import("vue").DefineComponent<import("vue").Ext
   defaultOpen: BooleanConstructor;
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -36,23 +33,18 @@ declare const XhContextMenuRoot: import("vue").DefineComponent<import("vue").Ext
   };
   translations: {
     type: PropType<ContextMenuProps["translations"]>;
-    default: undefined;
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   longPressDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -63,7 +55,6 @@ declare const XhContextMenuRoot: import("vue").DefineComponent<import("vue").Ext
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<ContextMenuNode[]>;
-    default: undefined;
   };
   open: {
     type: BooleanConstructor;
@@ -72,11 +63,9 @@ declare const XhContextMenuRoot: import("vue").DefineComponent<import("vue").Ext
   defaultOpen: BooleanConstructor;
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -88,60 +77,57 @@ declare const XhContextMenuRoot: import("vue").DefineComponent<import("vue").Ext
   };
   translations: {
     type: PropType<ContextMenuProps["translations"]>;
-    default: undefined;
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   longPressDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
 }>> & Readonly<{
   onSelect?: ((_details: import("@xihan-ui/headless").ContextMenuSelectDetails) => any) | undefined;
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").ContextMenuOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
 }>, {
-  collection: ContextMenuNode[];
-  dir: Direction;
-  tone: Tone;
-  size: Size;
+  loop: boolean;
   open: boolean;
   defaultOpen: boolean;
-  translations: Partial<import("@xihan-ui/headless").ContextMenuTranslations> | undefined;
-  offset: number;
-  loop: boolean;
-  placement: Placement;
   typeahead: boolean;
-  longPressDelay: number;
 }, SlotsType<{
   default?: (props: ContextMenuRootSlotProps) => VNode[];
   trigger?: () => VNode[];
   item?: (node: ContextMenuNodeMeta) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhContextMenuTrigger: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
   asChild: BooleanConstructor;
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
   asChild: BooleanConstructor;
 }>> & Readonly<{}>, {
   asChild: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhContextMenuPositioner: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhContextMenuPositioner: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 本实例的 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
-}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 本实例的 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhContextMenuContent: 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>;
@@ -185,12 +171,12 @@ declare const XhContextMenuItem: import("vue").DefineComponent<import("vue").Ext
   disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /**
- * 右键菜单里的子菜单：子层跑一台 submenu 模式的 menu 机器，触发条目由
- * XhContextMenuSubTrigger 渲染成「父层条目 + 子层触发器」的双重身份。
- * 子层内部用 XhMenu 系部件（再往深嵌套即 menu 套 menu）。本身不渲染节点。
+ * 右键菜单中的子菜单：子层运行一台 submenu 模式的 menu 状态机，触发条目由
+ * XhContextMenuSubTrigger 渲染为父层条目与子层触发器的双重身份。
+ * 子层内部使用 XhMenu 系部件（再往深嵌套即 menu 嵌套 menu）。本身不渲染节点。
  */
 declare const XhContextMenuSub: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-  /** 它在父右键菜单里的条目身份。 */
+  /** 它在父右键菜单中的条目身份。 */
   value: {
     type: StringConstructor;
     required: true;
@@ -201,11 +187,9 @@ declare const XhContextMenuSub: import("vue").DefineComponent<import("vue").Extr
   };
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -217,31 +201,26 @@ declare const XhContextMenuSub: import("vue").DefineComponent<import("vue").Extr
   };
   hoverOpenDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
-  /** 文字方向；缺省继承父层。子层被搬到浮层落点，继承不到父层的方向。 */
+  /** 文字方向；默认继承父层。子层被迁移到浮层落点，无法继承父层的方向。 */
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
-  /** 语气；缺省继承父层。子层是浮层落点下的同级节点，CSS 私有槽继承不到。 */
+  /** 语气；默认继承父层。子层是浮层落点下的同级节点，CSS 私有槽无法继承。 */
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
-  /** 尺寸；缺省继承父层，理由同 tone。 */
+  /** 尺寸；默认继承父层，理由同 tone。 */
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
   hoverCloseDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>[] | undefined, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-  /** 它在父右键菜单里的条目身份。 */
+  /** 它在父右键菜单中的条目身份。 */
   value: {
     type: StringConstructor;
     required: true;
@@ -252,11 +231,9 @@ declare const XhContextMenuSub: import("vue").DefineComponent<import("vue").Extr
   };
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -268,38 +245,26 @@ declare const XhContextMenuSub: import("vue").DefineComponent<import("vue").Extr
   };
   hoverOpenDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
-  /** 文字方向；缺省继承父层。子层被搬到浮层落点，继承不到父层的方向。 */
+  /** 文字方向；默认继承父层。子层被迁移到浮层落点，无法继承父层的方向。 */
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
-  /** 语气；缺省继承父层。子层是浮层落点下的同级节点，CSS 私有槽继承不到。 */
+  /** 语气；默认继承父层。子层是浮层落点下的同级节点，CSS 私有槽无法继承。 */
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
-  /** 尺寸；缺省继承父层，理由同 tone。 */
+  /** 尺寸；默认继承父层，理由同 tone。 */
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
   hoverCloseDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
 }>> & Readonly<{}>, {
-  dir: Direction;
-  tone: Tone;
-  size: Size;
-  disabled: boolean;
-  offset: number;
   loop: boolean;
-  placement: Placement;
+  disabled: boolean;
   openOnHover: boolean;
-  hoverOpenDelay: number;
-  hoverCloseDelay: number;
 }, SlotsType<{
   default?: (props: ContextMenuSubSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -312,6 +277,10 @@ declare const XhContextMenuItemText: import("vue").DefineComponent<{}, () => VNo
 declare const XhContextMenuItemIndicator: 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 XhContextMenuItemDescription: 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 XhContextMenuSeparator: 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>;
@@ -319,5 +288,5 @@ declare const XhContextMenuArrow: import("vue").DefineComponent<{}, () => VNode<
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { ContextMenuRootSlotProps, ContextMenuSubSlotProps, XhContextMenuArrow, XhContextMenuContent, XhContextMenuGroup, XhContextMenuGroupLabel, XhContextMenuItem, XhContextMenuItemIndicator, XhContextMenuItemText, XhContextMenuPositioner, XhContextMenuRoot, XhContextMenuSeparator, XhContextMenuSub, XhContextMenuSubTrigger, XhContextMenuTrigger };
+export { ContextMenuRootSlotProps, ContextMenuSubSlotProps, XhContextMenuArrow, XhContextMenuContent, XhContextMenuGroup, XhContextMenuGroupLabel, XhContextMenuItem, XhContextMenuItemDescription, XhContextMenuItemIndicator, XhContextMenuItemText, XhContextMenuPositioner, XhContextMenuRoot, XhContextMenuSeparator, XhContextMenuSub, XhContextMenuSubTrigger, XhContextMenuTrigger };
 //# sourceMappingURL=context-menu.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"context-menu.d.ts","names":[],"sources":["../../../src/components/context-menu/context-menu.ts"],"mappings":";;;;;KAyBK,mBAAmB;;KAGZ,2BAA2B,KAAK;;KAGhC,0BAA0B,KAAK;cAE9B,iCAAiB,8BAAA;;IAIG,MAAA,SAAS;;;;;;;;;IAGT,MAAA,SAAS;;;;;;;;;;;;;;;;IAIN,MAAA,SAAS;;;;IAClB,MAAA,SAAS;;;;;;;;IAER,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAIP,gBAAA,UAAA,UAAU;EACf,SAAA,UAAA,UAAU;EACR,gBAAA,OAAA,UAAU;;;IAjBJ,MAAA,SAAS;;;;;;;;;IAGT,MAAA,SAAS;;;;;;;;;;;;;;;;IAIN,MAAA,SAAS;;;;IAClB,MAAA,SAAS;;;;;;;;IAER,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;EASvB,WAAC,OAAO,6BAA6B;EACrC,gBAAM;EACT,QAAC,MAAM,wBAAwB;kCA4CxC;cAEW,oCAAoB,8BAAA;;;;;;;;;;qCAwB/B;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAgBlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAY/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;;;;;;;;;;;MAW7B,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAqC5B;;;;;;cAOW,gCAAgB,8BAAA;;;;;;;;;;;IAMI,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;IAMf,MAAA,SAAS;;;;;IAER,MAAA,SAAS;;;;;IAET,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAVJ,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;IAMf,MAAA,SAAS;;;;;IAER,MAAA,SAAS;;;;;IAET,MAAA,SAAS;;;;;;;;;;;;;;;;;;;EAIvB,WAAC,OAAO,4BAA4B;kCA6BhD;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAiBlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAOrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"context-menu.d.ts","names":[],"sources":["../../../src/components/context-menu/context-menu.ts"],"mappings":";;;;;KAgCK,mBAAmB;;KAGZ,2BAA2B,KAAK;;KAGhC,0BAA0B,KAAK;cAE9B,iCAAiB,8BAAA;;IAIG,MAAA,SAAS;;;;;;;;IAGT,MAAA,SAAS;;;;;;;;;;;;;;IAIN,MAAA,SAAS;;;IAClB,MAAA,SAAS;;;;;;IAER,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIP,gBAAA,UAAA,UAAU;EACf,SAAA,UAAA,UAAU;EACR,gBAAA,OAAA,UAAU;;;IAjBJ,MAAA,SAAS;;;;;;;;IAGT,MAAA,SAAS;;;;;;;;;;;;;;IAIN,MAAA,SAAS;;;IAClB,MAAA,SAAS;;;;;;IAER,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;EASvB,WAAC,OAAO,6BAA6B;EACrC,gBAAM;EACT,QAAC,MAAM,wBAAwB;kCAqCxC;cAEW,oCAAoB,8BAAA;;;;;;;;;;qCA0B/B;cAEW,uCAAuB,8BAAA;;;IAIH,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAiBxC,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAY/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;;;;;;;;;;;MAW7B,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAqC5B;;;;;;cAOW,gCAAgB,8BAAA;;;;;;;;;;;IAMI,MAAA,SAAS;;;;;;;;;;;;;;;;;;IAMf,MAAA,SAAS;;;;IAER,MAAA,SAAS;;;;IAET,MAAA,SAAS;;;;;;;;;;;;;;;;;;IAVJ,MAAA,SAAS;;;;;;;;;;;;;;;;;;IAMf,MAAA,SAAS;;;;IAER,MAAA,SAAS;;;;IAET,MAAA,SAAS;;;;;;;;;;EAIvB,WAAC,OAAO,4BAA4B;kCAyBhD;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAiBlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAOrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,4CAA4B,0BAAA,oBAAA,4BAAA;;8BAOvC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}