@xihan-ui/vue 2.1.0 → 3.1.0

package/dist/components/markdown-stream/markdown-stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-stream.js","names":[],"sources":["../../../src/components/markdown-stream/markdown-stream.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// 提供 markdown stream 相关实现。\n\nimport type { Size } from '@xihan-ui/core'\nimport type { MarkdownBlock, MarkdownStreamApi, MarkdownStreamProps, MarkdownStreamTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport { markdownBlockHtml } from '@xihan-ui/headless'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideMarkdownStream, useMarkdownStreamContext } from './context'\nimport { useMarkdownStream } from './use-markdown-stream'\n\n/** 默认插槽的载荷：块列表与流式状态，以及完成后要播报的文案。 */\nexport type MarkdownStreamRootSlotProps = Pick<MarkdownStreamApi, 'blocks' | 'streaming' | 'announcement'>\n\n/** 逐块插槽的载荷。作者据此接管代码块与公式块。 */\nexport interface MarkdownStreamBlockSlotProps {\n  block: MarkdownBlock\n  /** 0 基块下标。 */\n  index: number\n}\n\nexport const XhMarkdownStreamRoot = defineComponent({\n  name: 'XhMarkdownStreamRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    blocks: { type: Array as PropType<readonly MarkdownBlock[]>, default: () => [] },\n    streaming: Boolean,\n    announce: { type: String as PropType<'off' | 'polite' | 'assertive'> },\n    caret: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<MarkdownStreamTranslations>> },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: MarkdownStreamRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const configured = withXhConfig('markdown-stream', props)\n    // getter 透传保住响应性：块列表每帧换一份新数组，连接层要跟着重算\n    const forward: MarkdownStreamProps = {\n      get blocks() {\n        return props.blocks\n      },\n      get streaming() {\n        return props.streaming\n      },\n      get announce() {\n        return props.announce\n      },\n      get caret() {\n        return props.caret\n      },\n      get size() {\n        return configured.size\n      },\n      get translations() {\n        return configured.translations\n      },\n    }\n    const ctx = useMarkdownStream(forward)\n    provideMarkdownStream(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      blocks: ctx.api.value.blocks,\n      streaming: ctx.api.value.streaming,\n      announcement: ctx.api.value.announcement,\n    }))\n  },\n})\n\nexport const XhMarkdownStreamContent = defineComponent({\n  name: 'XhMarkdownStreamContent',\n  slots: Object as SlotsType<{\n    block?: (props: MarkdownStreamBlockSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useMarkdownStreamContext()\n    // 块是数据铺出来的，作者写不出 N 个节点，由组件铺；每块的内容可用 block 插槽接管\n    return () => {\n      const api = ctx.api.value\n      return h('div', api.getContentProps() as Record<string, unknown>, api.blocks.map((block, index) => {\n        const attrs = { ...api.getBlockProps({ block }) as Record<string, unknown>, key: block.key }\n        const authored = slots.block?.({ block, index })\n        if (authored)\n          return h('div', attrs, authored)\n        const html = markdownBlockHtml(block)\n        // markdown 块直接铺已消毒的 html；代码与公式块没人接管就把原文当正文显示\n        return html === undefined\n          ? h('div', attrs, block.source ?? '')\n          : h('div', { ...attrs, innerHTML: html })\n      }))\n    }\n  },\n})\n\nexport const XhMarkdownStreamLiveRegion = defineComponent({\n  name: 'XhMarkdownStreamLiveRegion',\n  setup(_, { slots }) {\n    const ctx = useMarkdownStreamContext()\n    return () => h(\n      'div',\n      ctx.api.value.getLiveRegionProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.announcement,\n    )\n  },\n})\n"],"mappings":";;;;;;AA0BA,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CAEN,OAAO;EACL,QAAQ;GAAE,MAAM;GAA6C,eAAe,CAAC;EAAE;EAC/E,WAAW;EACX,UAAU,EAAE,MAAM,OAAmD;EACrE,OAAO;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC3C,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAAwD;CAChF;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,aAAa,aAAa,mBAAmB,KAAK;EAsBxD,MAAM,MAAM,kBAAkB;GAnB5B,IAAI,SAAS;IACX,OAAO,MAAM;GACf;GACA,IAAI,YAAY;IACd,OAAO,MAAM;GACf;GACA,IAAI,WAAW;IACb,OAAO,MAAM;GACf;GACA,IAAI,QAAQ;IACV,OAAO,MAAM;GACf;GACA,IAAI,OAAO;IACT,OAAO,WAAW;GACpB;GACA,IAAI,eAAe;IACjB,OAAO,WAAW;GACpB;EAEkC,CAAC;EACrC,sBAAsB,GAAG;EACzB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,QAAQ,IAAI,IAAI,MAAM;GACtB,WAAW,IAAI,IAAI,MAAM;GACzB,cAAc,IAAI,IAAI,MAAM;EAC9B,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,OAAO;CAGP,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,yBAAyB;EAErC,aAAa;GACX,MAAM,MAAM,IAAI,IAAI;GACpB,OAAO,EAAE,OAAO,IAAI,gBAAgB,GAA8B,IAAI,OAAO,KAAK,OAAO,UAAU;IACjG,MAAM,QAAQ;KAAE,GAAG,IAAI,cAAc,EAAE,MAAM,CAAC;KAA8B,KAAK,MAAM;IAAI;IAC3F,MAAM,WAAW,MAAM,QAAQ;KAAE;KAAO;IAAM,CAAC;IAC/C,IAAI,UACF,OAAO,EAAE,OAAO,OAAO,QAAQ;IACjC,MAAM,OAAO,kBAAkB,KAAK;IAEpC,OAAO,SAAS,KAAA,IACZ,EAAE,OAAO,OAAO,MAAM,UAAU,EAAE,IAClC,EAAE,OAAO;KAAE,GAAG;KAAO,WAAW;IAAK,CAAC;GAC5C,CAAC,CAAC;EACJ;CACF;AACF,CAAC;AAED,MAAa,6BAA6B,gBAAgB;CACxD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,yBAAyB;EACrC,aAAa,EACX,OACA,IAAI,IAAI,MAAM,mBAAmB,GACjC,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,YACrC;CACF;AACF,CAAC"}
+{"version":3,"file":"markdown-stream.js","names":[],"sources":["../../../src/components/markdown-stream/markdown-stream.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// 提供 markdown stream 相关实现。\n\nimport type { Size } from '@xihan-ui/core'\nimport type { MarkdownBlock, MarkdownInlineMount, MarkdownStreamApi, MarkdownStreamProps, MarkdownStreamTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport { markdownBlockHtml, queryMarkdownInlines, sameMarkdownInlines } from '@xihan-ui/headless'\nimport { defineComponent, h, onMounted, onUpdated, ref, shallowRef, Teleport } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideMarkdownStream, useMarkdownStreamContext } from './context'\nimport { useMarkdownStream } from './use-markdown-stream'\n\n/** 默认插槽的载荷：块列表与流式状态，以及完成后要播报的文案。 */\nexport type MarkdownStreamRootSlotProps = Pick<MarkdownStreamApi, 'blocks' | 'streaming' | 'announcement'>\n\n/** 逐块插槽的载荷。作者据此接管代码块与公式块。 */\nexport interface MarkdownStreamBlockSlotProps {\n  block: MarkdownBlock\n  /** 0 基块下标。 */\n  index: number\n}\n\n/** 行内引用插槽的载荷：正文里 [@来源] 写成的一处引用，渲进 html 里的占位节点。 */\nexport interface MarkdownStreamCitationSlotProps {\n  /** 这一处引用的来源 id，按书写顺序排；一处多源时不止一个。 */\n  sourceIds: readonly string[]\n  block: MarkdownBlock\n  /** 该挂点在块内的 0 基下标。 */\n  index: number\n}\n\n/** 行内公式插槽的载荷：交给宿主的公式引擎渲染。 */\nexport interface MarkdownStreamMathSlotProps {\n  /** 未经转义的 TeX 原文。 */\n  source: string\n  /** 行内写的 `$$…$$` 为真。 */\n  display: boolean\n  block: MarkdownBlock\n  /** 该挂点在块内的 0 基下标。 */\n  index: number\n}\n\nexport const XhMarkdownStreamRoot = defineComponent({\n  name: 'XhMarkdownStreamRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    blocks: { type: Array as PropType<readonly MarkdownBlock[]>, default: () => [] },\n    streaming: Boolean,\n    announce: { type: String as PropType<'off' | 'polite' | 'assertive'> },\n    caret: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<MarkdownStreamTranslations>> },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: MarkdownStreamRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const configured = withXhConfig('markdown-stream', props)\n    // getter 透传保住响应性：块列表每帧换一份新数组，连接层要跟着重算\n    const forward: MarkdownStreamProps = {\n      get blocks() {\n        return props.blocks\n      },\n      get streaming() {\n        return props.streaming\n      },\n      get announce() {\n        return props.announce\n      },\n      get caret() {\n        return props.caret\n      },\n      get size() {\n        return configured.size\n      },\n      get translations() {\n        return configured.translations\n      },\n    }\n    const ctx = useMarkdownStream(forward)\n    provideMarkdownStream(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      blocks: ctx.api.value.blocks,\n      streaming: ctx.api.value.streaming,\n      announcement: ctx.api.value.announcement,\n    }))\n  },\n})\n\nexport const XhMarkdownStreamContent = defineComponent({\n  name: 'XhMarkdownStreamContent',\n  slots: Object as SlotsType<{\n    block?: (props: MarkdownStreamBlockSlotProps) => VNode[]\n    citation?: (props: MarkdownStreamCitationSlotProps) => VNode[]\n    math?: (props: MarkdownStreamMathSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useMarkdownStreamContext()\n    const host = ref<HTMLElement | null>(null)\n    // 占位节点是 html 铺进去之后才有的：每次提交后重新找一遍，指向的节点变了才重渲\n    const mounts = shallowRef<readonly MarkdownInlineMount[]>([])\n    const cleared = new WeakSet<HTMLElement>()\n    const collect = (): void => {\n      const el = host.value\n      if (!el || (!slots.citation && !slots.math)) {\n        if (mounts.value.length > 0)\n          mounts.value = []\n        return\n      }\n      const next = queryMarkdownInlines(el, ctx.api.value.blocks)\n        .filter(mount => (mount.inline.kind === 'citation' ? slots.citation : slots.math) !== undefined)\n      // 由作者接管的占位节点先清掉降级内容，传送进来的节点是它唯一的内容\n      for (const mount of next) {\n        if (!cleared.has(mount.element)) {\n          mount.element.textContent = ''\n          cleared.add(mount.element)\n        }\n      }\n      if (!sameMarkdownInlines(next, mounts.value))\n        mounts.value = next\n    }\n    onMounted(collect)\n    onUpdated(collect)\n\n    // 块是数据铺出来的，作者写不出 N 个节点，由组件铺；每块的内容可用 block 插槽接管\n    return () => {\n      const api = ctx.api.value\n      const blocks = api.blocks.map((block, index) => {\n        const attrs = { ...api.getBlockProps({ block }) as Record<string, unknown>, key: block.key }\n        const authored = slots.block?.({ block, index })\n        if (authored)\n          return h('div', attrs, authored)\n        const html = markdownBlockHtml(block)\n        // markdown 块直接铺已消毒的 html；代码与公式块没人接管就把原文当正文显示\n        return html === undefined\n          ? h('div', attrs, block.source ?? '')\n          : h('div', { ...attrs, innerHTML: html })\n      })\n      // 行内挂点：作者的引用角标、公式节点传送进 html 里的占位节点\n      const inlines = mounts.value.map((mount) => {\n        const { inline, block, index } = mount\n        const content = inline.kind === 'citation'\n          ? slots.citation?.({ sourceIds: inline.sourceIds, block, index })\n          : slots.math?.({ source: inline.source, display: inline.display, block, index })\n        return h(Teleport, { key: mount.key, to: mount.element }, content ?? [])\n      })\n      return h('div', { ...api.getContentProps() as Record<string, unknown>, ref: host }, [...blocks, ...inlines])\n    }\n  },\n})\n\nexport const XhMarkdownStreamLiveRegion = defineComponent({\n  name: 'XhMarkdownStreamLiveRegion',\n  setup(_, { slots }) {\n    const ctx = useMarkdownStreamContext()\n    return () => h(\n      'div',\n      ctx.api.value.getLiveRegionProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.announcement,\n    )\n  },\n})\n"],"mappings":"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"}

package/dist/components/marquee/marquee.d.ts

@@ -1,6 +1,8 @@
-import { PropType, VNode } from "vue";
-import { MarqueeDirection } from "@xihan-ui/headless";
+import { PayloadOf } from "../../runtime/payload.js";
+import { PropType, SlotsType, VNode } from "vue";
+import { MarqueeDirection, MarqueeSchema, MarqueeTranslations } from "@xihan-ui/headless";
 //#region src/components/marquee/marquee.d.ts
+type MarqueeProps = MarqueeSchema['props'];
 declare const XhMarqueeRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   direction: {
     type: PropType<MarqueeDirection>;
@@ -8,26 +10,76 @@ declare const XhMarqueeRoot: import("vue").DefineComponent<import("vue").Extract
   speed: {
     type: NumberConstructor;
   };
-  pauseOnHover: BooleanConstructor;
-  paused: BooleanConstructor;
-  autoFill: BooleanConstructor;
+  pauseOnHover: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  paused: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  defaultPaused: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  autoFill: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  fade: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  translations: {
+    type: PropType<Partial<MarqueeTranslations>>;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
-}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  'paused-change': (_details: PayloadOf<MarqueeProps, "onPausedChange">) => true;
+  'update:paused': (_paused: PayloadOf<MarqueeProps, "onPausedChange">["paused"]) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   direction: {
     type: PropType<MarqueeDirection>;
   };
   speed: {
     type: NumberConstructor;
   };
-  pauseOnHover: BooleanConstructor;
-  paused: BooleanConstructor;
-  autoFill: BooleanConstructor;
-}>> & Readonly<{}>, {
+  pauseOnHover: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  paused: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  defaultPaused: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  autoFill: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  fade: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  translations: {
+    type: PropType<Partial<MarqueeTranslations>>;
+  };
+}>> & Readonly<{
+  "onPaused-change"?: ((_details: import("@xihan-ui/headless").MarqueePausedChangeDetails) => any) | undefined;
+  "onUpdate:paused"?: ((_paused: boolean) => any) | undefined;
+}>, {
+  fade: boolean;
   paused: boolean;
   pauseOnHover: boolean;
+  defaultPaused: boolean;
   autoFill: boolean;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+  default?: () => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /**
  * 轨道：滚动的是这一层。默认插槽中的内容按 api.copies 铺设若干份，每份包一层壳。
  *
@@ -39,6 +91,10 @@ declare const XhMarqueeRoot: import("vue").DefineComponent<import("vue").Extract
 declare const XhMarqueeContent: 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>;
+/** 暂停开关：原生 button，Enter / Space 的激活与 Tab 停靠由平台提供；不给内容时皮肤画暂停 / 播放图标。 */
+declare const XhMarqueeAutoplayTrigger: 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 { XhMarqueeContent, XhMarqueeRoot };
+export { XhMarqueeAutoplayTrigger, XhMarqueeContent, XhMarqueeRoot };
 //# sourceMappingURL=marquee.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"marquee.d.ts","names":[],"sources":["../../../src/components/marquee/marquee.ts"],"mappings":";;;cAea,6BAAa,8BAAA;;IAIO,MAAA,SAAS;;;;;;;;;;;;IAAT,MAAA,SAAS;;;;;;;;;;;;qCAWxC;;;;;;;;;cAUW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAuB3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"marquee.d.ts","names":[],"sources":["../../../src/components/marquee/marquee.ts"],"mappings":";;;;KAoBK,eAAe;cAEP,6BAAa,8BAAA;;IAIO,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;IAQN,MAAA,SAAS,QAAQ;;;;;EAIrB,kBAAA,UAAA,UAAU;EACX,kBAAA,SAAA,UAAU;;;IAbR,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;IAQN,MAAA,SAAS,QAAQ;;;;;;;;;;;;EAQvC,gBAAM;kCAelB;;;;;;;;;cAUW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAuB3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/marquee/marquee.js

@@ -1,20 +1,57 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
+import { withXhConfig } from "../../config/config.js";
+import { useMachine } from "../../runtime/use-machine.js";
+import { createVueIdGenerator } from "../../runtime/vue-id.js";
 import { slotPaints } from "../../runtime/slot-content.js";
 import { provideMarquee, useMarqueeContext } from "./context.js";
 import { computed, defineComponent, h } from "vue";
-import { connectMarquee } from "@xihan-ui/headless";
+import { createScope } from "@xihan-ui/core";
+import { connectMarquee, marqueeMachine } from "@xihan-ui/headless";
 //#region src/components/marquee/marquee.ts
 const XhMarqueeRoot = defineComponent({
 	name: "XhMarqueeRoot",
 	props: {
 		direction: { type: String },
 		speed: { type: Number },
-		pauseOnHover: Boolean,
-		paused: Boolean,
-		autoFill: Boolean
+		pauseOnHover: {
+			type: Boolean,
+			default: void 0
+		},
+		paused: {
+			type: Boolean,
+			default: void 0
+		},
+		defaultPaused: {
+			type: Boolean,
+			default: void 0
+		},
+		autoFill: {
+			type: Boolean,
+			default: void 0
+		},
+		fade: {
+			type: Boolean,
+			default: void 0
+		},
+		translations: { type: Object }
 	},
-	setup(props, { slots }) {
-		const api = computed(() => connectMarquee(props, vueNormalize));
+	emits: {
+		"paused-change": (_details) => true,
+		"update:paused": (_paused) => true
+	},
+	slots: Object,
+	setup(props, { slots, emit }) {
+		const onPausedChange = (details) => {
+			emit("paused-change", details);
+			emit("update:paused", details.paused);
+		};
+		const scope = createScope(null, createVueIdGenerator());
+		const config = withXhConfig("marquee", props);
+		const service = useMachine(marqueeMachine, () => ({
+			...config,
+			onPausedChange
+		}), scope);
+		const api = computed(() => connectMarquee(service, vueNormalize));
 		provideMarquee({ api });
 		return () => h("div", api.value.getRootProps(), slots.default?.());
 	}
@@ -45,7 +82,15 @@ const XhMarqueeContent = defineComponent({
 		};
 	}
 });
+/** 暂停开关：原生 button，Enter / Space 的激活与 Tab 停靠由平台提供；不给内容时皮肤画暂停 / 播放图标。 */
+const XhMarqueeAutoplayTrigger = defineComponent({
+	name: "XhMarqueeAutoplayTrigger",
+	setup(_, { slots }) {
+		const ctx = useMarqueeContext();
+		return () => h("button", ctx.api.value.getAutoplayTriggerProps(), slots.default?.());
+	}
+});
 //#endregion
-export { XhMarqueeContent, XhMarqueeRoot };
+export { XhMarqueeAutoplayTrigger, XhMarqueeContent, XhMarqueeRoot };
 
 //# sourceMappingURL=marquee.js.map

package/dist/components/marquee/marquee.js.map

@@ -1 +1 @@
-{"version":3,"file":"marquee.js","names":[],"sources":["../../../src/components/marquee/marquee.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// 提供 marquee 相关实现。\n\nimport type { MarqueeDirection, MarqueeProps } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport { connectMarquee } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { provideMarquee, useMarqueeContext } from './context'\n\nexport const XhMarqueeRoot = defineComponent({\n  name: 'XhMarqueeRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    direction: { type: String as PropType<MarqueeDirection> },\n    speed: { type: Number },\n    pauseOnHover: Boolean,\n    paused: Boolean,\n    autoFill: Boolean,\n  },\n  setup(props, { slots }) {\n    const api = computed(() => connectMarquee(props as MarqueeProps, vueNormalize))\n    provideMarquee({ api })\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 轨道：滚动的是这一层。默认插槽中的内容按 api.copies 铺设若干份，每份包一层壳。\n *\n * 包壳是为了让每份等长：接缝能否对齐，取决于滚动完成的距离恰好等于一份的长度。\n * 第一份之后的都是副本，同时标 aria-hidden 与 inert：读屏不朗读第二遍，Tab 也不会停在副本上：\n * 只标 aria-hidden 而保留可聚焦的副本，焦点会落进一个读屏看不见的位置。\n * 插槽中只剩注释或空白时一份都不铺设：铺设只会让轨道多出一段空白滚动。\n */\nexport const XhMarqueeContent = defineComponent({\n  name: 'XhMarqueeContent',\n  setup(_, { slots }) {\n    const ctx = useMarqueeContext()\n    return () => {\n      const copies: VNode[] = []\n      if (slotPaints(slots.default?.())) {\n        for (let i = 0; i < ctx.api.value.copies; i++) {\n          const copy = i > 0\n          copies.push(h(\n            'div',\n            {\n              'data-xh-copy': String(i),\n              'aria-hidden': copy ? 'true' : undefined,\n              'inert': copy ? true : undefined,\n            },\n            slots.default?.(),\n          ))\n        }\n      }\n      return h('div', ctx.api.value.getContentProps() as Record<string, unknown>, copies)\n    }\n  },\n})\n"],"mappings":";;;;;;AAeA,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CAEN,OAAO;EACL,WAAW,EAAE,MAAM,OAAqC;EACxD,OAAO,EAAE,MAAM,OAAO;EACtB,cAAc;EACd,QAAQ;EACR,UAAU;CACZ;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe,eAAe,OAAuB,YAAY,CAAC;EAC9E,eAAe,EAAE,IAAI,CAAC;EACtB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC9F;AACF,CAAC;;;;;;;;;AAUD,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa;GACX,MAAM,SAAkB,CAAC;GACzB,IAAI,WAAW,MAAM,UAAU,CAAC,GAC9B,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,MAAM,QAAQ,KAAK;IAC7C,MAAM,OAAO,IAAI;IACjB,OAAO,KAAK,EACV,OACA;KACE,gBAAgB,OAAO,CAAC;KACxB,eAAe,OAAO,SAAS,KAAA;KAC/B,SAAS,OAAO,OAAO,KAAA;IACzB,GACA,MAAM,UAAU,CAClB,CAAC;GACH;GAEF,OAAO,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM;EACpF;CACF;AACF,CAAC"}
+{"version":3,"file":"marquee.js","names":[],"sources":["../../../src/components/marquee/marquee.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// 提供 marquee 相关实现。\n\nimport type { MarqueeDirection, MarqueeSchema, MarqueeTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { createScope } from '@xihan-ui/core'\nimport { connectMarquee, marqueeMachine } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\nimport { provideMarquee, useMarqueeContext } from './context'\n\ntype MarqueeProps = MarqueeSchema['props']\n\nexport const XhMarqueeRoot = defineComponent({\n  name: 'XhMarqueeRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    direction: { type: String as PropType<MarqueeDirection> },\n    speed: { type: Number },\n    pauseOnHover: { type: Boolean, default: undefined },\n    // 缺席值 undefined 表示非受控\n    paused: { type: Boolean, default: undefined },\n    defaultPaused: { type: Boolean, default: undefined },\n    autoFill: { type: Boolean, default: undefined },\n    fade: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<MarqueeTranslations>> },\n  },\n  // paused-change 携带 { paused }，update:paused 携带裸布尔\n  emits: {\n    'paused-change': (_details: PayloadOf<MarqueeProps, 'onPausedChange'>) => true,\n    'update:paused': (_paused: PayloadOf<MarqueeProps, 'onPausedChange'>['paused']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onPausedChange: MarqueeProps['onPausedChange'] = (details) => {\n      emit('paused-change', details)\n      emit('update:paused', details.paused)\n    }\n    // scope id 走 Vue 的 useId：服务端与水合两侧同号，暂停开关的 aria-controls 才对得上\n    const scope = createScope(null, createVueIdGenerator())\n    const config = withXhConfig('marquee', props) as MarqueeProps\n    const service = useMachine(marqueeMachine, () => ({ ...config, onPausedChange }), scope)\n    const api = computed(() => connectMarquee(service, vueNormalize))\n    provideMarquee({ api })\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 轨道：滚动的是这一层。默认插槽中的内容按 api.copies 铺设若干份，每份包一层壳。\n *\n * 包壳是为了让每份等长：接缝能否对齐，取决于滚动完成的距离恰好等于一份的长度。\n * 第一份之后的都是副本，同时标 aria-hidden 与 inert：读屏不朗读第二遍，Tab 也不会停在副本上：\n * 只标 aria-hidden 而保留可聚焦的副本，焦点会落进一个读屏看不见的位置。\n * 插槽中只剩注释或空白时一份都不铺设：铺设只会让轨道多出一段空白滚动。\n */\nexport const XhMarqueeContent = defineComponent({\n  name: 'XhMarqueeContent',\n  setup(_, { slots }) {\n    const ctx = useMarqueeContext()\n    return () => {\n      const copies: VNode[] = []\n      if (slotPaints(slots.default?.())) {\n        for (let i = 0; i < ctx.api.value.copies; i++) {\n          const copy = i > 0\n          copies.push(h(\n            'div',\n            {\n              'data-xh-copy': String(i),\n              'aria-hidden': copy ? 'true' : undefined,\n              'inert': copy ? true : undefined,\n            },\n            slots.default?.(),\n          ))\n        }\n      }\n      return h('div', ctx.api.value.getContentProps() as Record<string, unknown>, copies)\n    }\n  },\n})\n\n/** 暂停开关：原生 button，Enter / Space 的激活与 Tab 停靠由平台提供；不给内容时皮肤画暂停 / 播放图标。 */\nexport const XhMarqueeAutoplayTrigger = defineComponent({\n  name: 'XhMarqueeAutoplayTrigger',\n  setup(_, { slots }) {\n    const ctx = useMarqueeContext()\n    return () => h('button', ctx.api.value.getAutoplayTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;;;;;AAsBA,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CAEN,OAAO;EACL,WAAW,EAAE,MAAM,OAAqC;EACxD,OAAO,EAAE,MAAM,OAAO;EACtB,cAAc;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAElD,QAAQ;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC5C,eAAe;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EACnD,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,cAAc,EAAE,MAAM,OAAiD;CACzE;CAEA,OAAO;EACL,kBAAkB,aAAwD;EAC1E,kBAAkB,YAAiE;CACrF;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,kBAAkD,YAAY;GAClE,KAAK,iBAAiB,OAAO;GAC7B,KAAK,iBAAiB,QAAQ,MAAM;EACtC;EAEA,MAAM,QAAQ,YAAY,MAAM,qBAAqB,CAAC;EACtD,MAAM,SAAS,aAAa,WAAW,KAAK;EAC5C,MAAM,UAAU,WAAW,uBAAuB;GAAE,GAAG;GAAQ;EAAe,IAAI,KAAK;EACvF,MAAM,MAAM,eAAe,eAAe,SAAS,YAAY,CAAC;EAChE,eAAe,EAAE,IAAI,CAAC;EACtB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC9F;AACF,CAAC;;;;;;;;;AAUD,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa;GACX,MAAM,SAAkB,CAAC;GACzB,IAAI,WAAW,MAAM,UAAU,CAAC,GAC9B,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,MAAM,QAAQ,KAAK;IAC7C,MAAM,OAAO,IAAI;IACjB,OAAO,KAAK,EACV,OACA;KACE,gBAAgB,OAAO,CAAC;KACxB,eAAe,OAAO,SAAS,KAAA;KAC/B,SAAS,OAAO,OAAO,KAAA;IACzB,GACA,MAAM,UAAU,CAClB,CAAC;GACH;GAEF,OAAO,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM;EACpF;CACF;AACF,CAAC;;AAGD,MAAa,2BAA2B,gBAAgB;CACtD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,wBAAwB,GAA8B,MAAM,UAAU,CAAC;CAChH;AACF,CAAC"}

package/dist/components/mention/mention.d.ts

@@ -1,11 +1,11 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Direction, Placement, Size, Tone } from "@xihan-ui/core";
-import { MentionApi, MentionNode, MentionNodeMeta, MentionSchema, MentionTranslations } from "@xihan-ui/headless";
+import { MentionApi, MentionInputHost, MentionNode, MentionNodeMeta, MentionSchema, MentionTranslations } from "@xihan-ui/headless";
 //#region src/components/mention/mention.d.ts
 type MentionProps = MentionSchema['props'];
-/** 默认插槽的载荷：浮层开合、正文与查询串、高亮候选，以及改写正文与收起浮层的句柄。 */
-type MentionRootSlotProps = Pick<MentionApi, 'open' | 'value' | 'query' | 'activePrefix' | 'highlightedValue' | 'setValue' | 'close'>;
+/** 默认插槽的载荷：浮层开合、正文与查询串、高亮候选、正文里仍然完整的提及，以及改写正文与收起浮层的句柄。 */
+type MentionRootSlotProps = Pick<MentionApi, 'open' | 'value' | 'query' | 'activePrefix' | 'highlightedValue' | 'mentions' | 'setValue' | 'close'>;
 declare const XhMentionRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   triggerPrefix: {
     type: PropType<string | string[]>;
@@ -157,10 +157,30 @@ declare const XhMentionRoot: import("vue").DefineComponent<import("vue").Extract
 declare const XhMentionLabel: 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 XhMentionInput: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+/** 输入框；正文写在它上面，候选浮层贴着它落位。缺省单行，写 as="textarea" 即多行。 */
+declare const XhMentionInput: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /**
+   * 输入框渲染为哪个标签，默认 input。
+   * 写 textarea 即多行宿主：正文可以换行，connect 随之撤销 type、role 与 aria-expanded。
+   */
+  as: {
+    type: PropType<MentionInputHost>;
+    default: string;
+  };
+}>, () => 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<{
+  /**
+   * 输入框渲染为哪个标签，默认 input。
+   * 写 textarea 即多行宿主：正文可以换行，connect 随之撤销 type、role 与 aria-expanded。
+   */
+  as: {
+    type: PropType<MentionInputHost>;
+    default: string;
+  };
+}>> & Readonly<{}>, {
+  as: MentionInputHost;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhMentionPositioner: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   /** 本实例的 Portal 容器；优先于应用级配置。 */
   container: {

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

@@ -1 +1 @@
-{"version":3,"file":"mention.d.ts","names":[],"sources":["../../../src/components/mention/mention.ts"],"mappings":";;;;;KAoBK,eAAe;;KAGR,uBAAuB,KACjC;cAUW,6BAAa,8BAAA;;IAIoB,MAAA;;;IACb,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUT,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;IACA,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIN,iBAAA,UAAA,UAAU;EACV,iBAAA,UAAA,UAAU;EAChB,SAAA,UAAA,UAAU;EACL,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;;;IA1BO,MAAA;;;IACb,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUT,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;IACA,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;EAWrB,WAAC,OAAO,yBAAyB;;EAEpC,QAAC,OAAO,oBAAoB;;EAErB,iBAAC,OAAO,oBAAoB;;EAE5B,iBAAC,OAAO,oBAAoB;;EAElC,cAAM;kCAyClB;;cAGW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAczB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAkBxB;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"mention.d.ts","names":[],"sources":["../../../src/components/mention/mention.ts"],"mappings":";;;;;KAoBK,eAAe;;KAGR,uBAAuB,KACjC;cAWW,6BAAa,8BAAA;;IAIoB,MAAA;;;IACb,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUT,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;IACA,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIN,iBAAA,UAAA,UAAU;EACV,iBAAA,UAAA,UAAU;EAChB,SAAA,UAAA,UAAU;EACL,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;;;IA1BO,MAAA;;;IACb,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUT,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;IACA,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;EAWrB,WAAC,OAAO,yBAAyB;;EAEpC,QAAC,OAAO,oBAAoB;;EAErB,iBAAC,OAAO,oBAAoB;;EAE5B,iBAAC,OAAO,oBAAoB;;EAElC,cAAM;kCA0ClB;;cAGW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,8BAAA;;;;;;IAOD,MAAA,SAAS;;;;;;;;;;;IAAT,MAAA,SAAS;;;;;qCAcjC;cAEW,mCAAmB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAkBxB;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/mention/mention.js

@@ -73,6 +73,7 @@ const XhMentionRoot = defineComponent({
 			query: ctx.api.value.query,
 			activePrefix: ctx.api.value.activePrefix,
 			highlightedValue: ctx.api.value.highlightedValue,
+			mentions: ctx.api.value.mentions,
 			setValue: ctx.api.value.setValue,
 			close: ctx.api.value.close
 		}) : props.collection ? renderDefaultTree(ctx.api.value.collection, slots.item, slots["item-prefix"], slots["item-suffix"], slots.empty) : []);
@@ -86,16 +87,25 @@ const XhMentionLabel = defineComponent({
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
-/** 单行输入框；正文写在它上面，候选浮层贴着它落位。 */
+/** 输入框；正文写在它上面，候选浮层贴着它落位。缺省单行，写 as="textarea" 即多行。 */
 const XhMentionInput = defineComponent({
 	name: "XhMentionInput",
-	setup() {
+	props: { 
+	/**
+	* 输入框渲染为哪个标签，默认 input。
+	* 写 textarea 即多行宿主：正文可以换行，connect 随之撤销 type、role 与 aria-expanded。
+	*/
+as: {
+		type: String,
+		default: "input"
+	} },
+	setup(props) {
 		const fieldWiring = useFieldStateWiring();
 		const fieldLabel = useFieldLabelWiring();
 		const ctx = useMentionContext();
-		return () => h("input", fieldLabel.value({
+		return () => h(props.as, fieldLabel.value({
 			...fieldWiring.value,
-			...ctx.api.value.getInputProps(),
+			...ctx.api.value.getInputProps({ as: props.as }),
 			ref: (el) => {
 				ctx.inputRef.value = el;
 			}

package/dist/components/mention/mention.js.map

@@ -1 +1 @@
-{"version":3,"file":"mention.js","names":[],"sources":["../../../src/components/mention/mention.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// 提供 mention 相关实现。\n\nimport type { ControlVariant, Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type { MentionApi, MentionInputEl, MentionItemProps, MentionNode, MentionNodeMeta, MentionSchema, MentionTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, mergeProps, onMounted, onUnmounted, onUpdated, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { XhPortal } from '../../runtime/portal'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideMention, provideMentionItem, useMentionContext, useMentionItemContext } from './context'\nimport { useMention } from './use-mention'\n\ntype MentionProps = MentionSchema['props']\n\n/** 默认插槽的载荷：浮层开合、正文与查询串、高亮候选，以及改写正文与收起浮层的句柄。 */\nexport type MentionRootSlotProps = Pick<\n  MentionApi,\n  | 'open'\n  | 'value'\n  | 'query'\n  | 'activePrefix'\n  | 'highlightedValue'\n  | 'setValue'\n  | 'close'\n>\n\nexport const XhMentionRoot = defineComponent({\n  name: 'XhMentionRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    triggerPrefix: { type: [String, Array] as PropType<string | string[]> },\n    collection: { type: Array as PropType<MentionNode[]> },\n    value: { type: String },\n    defaultValue: { type: String },\n    disabled: { type: Boolean, default: undefined },\n    loading: Boolean,\n    name: { type: String },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    placeholder: { type: String },\n    loop: { type: Boolean, default: undefined },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\n    translations: { type: Object as PropType<MentionTranslations> },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // *-change 携带 details 对象，update:* 携带裸值\n  emits: {\n    'value-change': (_details: PayloadOf<MentionProps, 'onValueChange'>) => true,\n    'query-change': (_details: PayloadOf<MentionProps, 'onQueryChange'>) => true,\n    'select': (_details: PayloadOf<MentionProps, 'onSelect'>) => true,\n    'open-change': (_details: PayloadOf<MentionProps, 'onOpenChange'>) => true,\n    'update:value': (_value: PayloadOf<MentionProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    'default'?: (props: MentionRootSlotProps) => VNode[]\n    /** 铺开 collection 时每条候选的文本插槽。 */\n    'item'?: (props: MentionNodeMeta) => VNode[]\n    /** 只接管行首那一格，其余槽照旧由数据铺 */\n    'item-prefix'?: (props: MentionNodeMeta) => VNode[]\n    /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺 */\n    'item-suffix'?: (props: MentionNodeMeta) => VNode[]\n    /** 铺开 collection 时空态中的文案；未写时使用内建英文。 */\n    'empty'?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: MentionProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyQuery: MentionProps['onQueryChange'] = details => emit('query-change', details)\n    const notifySelect: MentionProps['onSelect'] = details => emit('select', details)\n    const notifyOpen: MentionProps['onOpenChange'] = details => emit('open-change', details)\n\n    const ctx = useMention(withXhConfig('mention', useFormControlProps(props)) as MentionProps, {\n      onValueChange: notifyValue,\n      onQueryChange: notifyQuery,\n      onSelect: notifySelect,\n      onOpenChange: notifyOpen,\n    })\n    provideMention(ctx)\n\n    // 首帧结算一次候选条数，之后的增删由条目自己上报\n    onMounted(ctx.syncItems)\n    onUpdated(ctx.syncItems)\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            value: ctx.api.value.value,\n            query: ctx.api.value.query,\n            activePrefix: ctx.api.value.activePrefix,\n            highlightedValue: ctx.api.value.highlightedValue,\n            setValue: ctx.api.value.setValue,\n            close: ctx.api.value.close,\n          })\n        : props.collection\n          ? renderDefaultTree(ctx.api.value.collection, slots.item, slots['item-prefix'], slots['item-suffix'], slots.empty)\n          : [],\n    )\n  },\n})\n\n/** 标题；必须是原生 label，getLabelProps 的 for 恒指向输入框。 */\nexport const XhMentionLabel = defineComponent({\n  name: 'XhMentionLabel',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 单行输入框；正文写在它上面，候选浮层贴着它落位。 */\nexport const XhMentionInput = defineComponent({\n  name: 'XhMentionInput',\n  setup() {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useMentionContext()\n    return () => h('input', fieldLabel.value({\n      ...fieldWiring.value,\n      ...ctx.api.value.getInputProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.inputRef.value = el as MentionInputEl },\n    }))\n  },\n})\n\nexport const XhMentionPositioner = defineComponent({\n  name: 'XhMentionPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useMentionContext()\n    // 候选列表的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner，条子走浮层 4px 档\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 定位层搬到 portal 落点，逃开祖先的层叠上下文\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.inputRef }, () => [\n      h('div', {\n        ...mergeProps(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 XhMentionContent = defineComponent({\n  name: 'XhMentionContent',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\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\n/** 没有任何候选时显示的空态；与候选面板同级。 */\nexport const XhMentionEmpty = defineComponent({\n  name: 'XhMentionEmpty',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 候选仍在获取时显示的在途占位；与候选面板同级。 */\nexport const XhMentionLoading = defineComponent({\n  name: 'XhMentionLoading',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    return () => h('div', ctx.api.value.getLoadingProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhMentionItem = defineComponent({\n  name: 'XhMentionItem',\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 = useMentionContext()\n    const item = computed<MentionItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideMentionItem({ item })\n    // 候选的进出与改名由条目自己上报，机器据此结算条数并摘掉悬空高亮\n    onMounted(ctx.syncItems)\n    onUnmounted(ctx.syncItems)\n    // 节点就地复用时数量不变但身份换了，需按 value 另行上报\n    watch(() => props.value, ctx.syncItems)\n    return () => h('div', ctx.api.value.getItemProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhMentionItemText = defineComponent({\n  name: 'XhMentionItemText',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行首的作者内容（图标、色块、头像），对读屏隐藏 */\nexport const XhMentionItemPrefix = defineComponent({\n  name: 'XhMentionItemPrefix',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemPrefixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhMentionItemSuffix = defineComponent({\n  name: 'XhMentionItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhMentionItemDescription = defineComponent({\n  name: 'XhMentionItemDescription',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * 过滤仍归调用方：collection 就是当前应显示的候选。\n */\nfunction renderDefaultTree(\n  collection: readonly MentionNodeMeta[],\n  itemSlot?: (node: MentionNodeMeta) => VNode[],\n  prefixSlot?: (node: MentionNodeMeta) => VNode[],\n  suffixSlot?: (node: MentionNodeMeta) => VNode[],\n  emptySlot?: () => VNode[],\n): VNode[] {\n  const emptyText = emptySlot?.() ?? 'No results'\n  return [\n    h(XhMentionInput),\n    h(XhMentionPositioner, null, () => [\n      h(XhMentionContent, null, () => collection.map(node =>\n        h(XhMentionItem, { key: node.value, value: node.value }, () => [\n          ...(prefixSlot ? [h(XhMentionItemPrefix, null, () => prefixSlot(node))] : []),\n          h(XhMentionItemText, null, () => itemSlot?.(node) ?? node.label),\n          ...(node.description != null ? [h(XhMentionItemDescription, null, () => node.description)] : []),\n          ...(suffixSlot ? [h(XhMentionItemSuffix, null, () => suffixSlot(node))] : []),\n        ]),\n      )),\n      h(XhMentionEmpty, null, () => emptyText),\n    ]),\n  ]\n}\n"],"mappings":"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"}
+{"version":3,"file":"mention.js","names":[],"sources":["../../../src/components/mention/mention.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// 提供 mention 相关实现。\n\nimport type { ControlVariant, Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type { MentionApi, MentionInputEl, MentionInputHost, MentionItemProps, MentionNode, MentionNodeMeta, MentionSchema, MentionTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, mergeProps, onMounted, onUnmounted, onUpdated, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { XhPortal } from '../../runtime/portal'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideMention, provideMentionItem, useMentionContext, useMentionItemContext } from './context'\nimport { useMention } from './use-mention'\n\ntype MentionProps = MentionSchema['props']\n\n/** 默认插槽的载荷：浮层开合、正文与查询串、高亮候选、正文里仍然完整的提及，以及改写正文与收起浮层的句柄。 */\nexport type MentionRootSlotProps = Pick<\n  MentionApi,\n  | 'open'\n  | 'value'\n  | 'query'\n  | 'activePrefix'\n  | 'highlightedValue'\n  | 'mentions'\n  | 'setValue'\n  | 'close'\n>\n\nexport const XhMentionRoot = defineComponent({\n  name: 'XhMentionRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    triggerPrefix: { type: [String, Array] as PropType<string | string[]> },\n    collection: { type: Array as PropType<MentionNode[]> },\n    value: { type: String },\n    defaultValue: { type: String },\n    disabled: { type: Boolean, default: undefined },\n    loading: Boolean,\n    name: { type: String },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    placeholder: { type: String },\n    loop: { type: Boolean, default: undefined },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    /** 文字方向；浮层迁移到落点后无法继承作者子树上的方向，需要 RTL 时显式提供。 */\n    dir: { type: String as PropType<Direction> },\n    translations: { type: Object as PropType<MentionTranslations> },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // *-change 携带 details 对象，update:* 携带裸值\n  emits: {\n    'value-change': (_details: PayloadOf<MentionProps, 'onValueChange'>) => true,\n    'query-change': (_details: PayloadOf<MentionProps, 'onQueryChange'>) => true,\n    'select': (_details: PayloadOf<MentionProps, 'onSelect'>) => true,\n    'open-change': (_details: PayloadOf<MentionProps, 'onOpenChange'>) => true,\n    'update:value': (_value: PayloadOf<MentionProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    'default'?: (props: MentionRootSlotProps) => VNode[]\n    /** 铺开 collection 时每条候选的文本插槽。 */\n    'item'?: (props: MentionNodeMeta) => VNode[]\n    /** 只接管行首那一格，其余槽照旧由数据铺 */\n    'item-prefix'?: (props: MentionNodeMeta) => VNode[]\n    /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺 */\n    'item-suffix'?: (props: MentionNodeMeta) => VNode[]\n    /** 铺开 collection 时空态中的文案；未写时使用内建英文。 */\n    'empty'?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: MentionProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyQuery: MentionProps['onQueryChange'] = details => emit('query-change', details)\n    const notifySelect: MentionProps['onSelect'] = details => emit('select', details)\n    const notifyOpen: MentionProps['onOpenChange'] = details => emit('open-change', details)\n\n    const ctx = useMention(withXhConfig('mention', useFormControlProps(props)) as MentionProps, {\n      onValueChange: notifyValue,\n      onQueryChange: notifyQuery,\n      onSelect: notifySelect,\n      onOpenChange: notifyOpen,\n    })\n    provideMention(ctx)\n\n    // 首帧结算一次候选条数，之后的增删由条目自己上报\n    onMounted(ctx.syncItems)\n    onUpdated(ctx.syncItems)\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            value: ctx.api.value.value,\n            query: ctx.api.value.query,\n            activePrefix: ctx.api.value.activePrefix,\n            highlightedValue: ctx.api.value.highlightedValue,\n            mentions: ctx.api.value.mentions,\n            setValue: ctx.api.value.setValue,\n            close: ctx.api.value.close,\n          })\n        : props.collection\n          ? renderDefaultTree(ctx.api.value.collection, slots.item, slots['item-prefix'], slots['item-suffix'], slots.empty)\n          : [],\n    )\n  },\n})\n\n/** 标题；必须是原生 label，getLabelProps 的 for 恒指向输入框。 */\nexport const XhMentionLabel = defineComponent({\n  name: 'XhMentionLabel',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 输入框；正文写在它上面，候选浮层贴着它落位。缺省单行，写 as=\"textarea\" 即多行。 */\nexport const XhMentionInput = defineComponent({\n  name: 'XhMentionInput',\n  props: {\n    /**\n     * 输入框渲染为哪个标签，默认 input。\n     * 写 textarea 即多行宿主：正文可以换行，connect 随之撤销 type、role 与 aria-expanded。\n     */\n    as: { type: String as PropType<MentionInputHost>, default: 'input' },\n  },\n  setup(props) {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useMentionContext()\n    return () => h(props.as, fieldLabel.value({\n      ...fieldWiring.value,\n      ...ctx.api.value.getInputProps({ as: props.as }) as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.inputRef.value = el as MentionInputEl },\n    }))\n  },\n})\n\nexport const XhMentionPositioner = defineComponent({\n  name: 'XhMentionPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useMentionContext()\n    // 候选列表的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner，条子走浮层 4px 档\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 定位层搬到 portal 落点，逃开祖先的层叠上下文\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.inputRef }, () => [\n      h('div', {\n        ...mergeProps(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 XhMentionContent = defineComponent({\n  name: 'XhMentionContent',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\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\n/** 没有任何候选时显示的空态；与候选面板同级。 */\nexport const XhMentionEmpty = defineComponent({\n  name: 'XhMentionEmpty',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 候选仍在获取时显示的在途占位；与候选面板同级。 */\nexport const XhMentionLoading = defineComponent({\n  name: 'XhMentionLoading',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    return () => h('div', ctx.api.value.getLoadingProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhMentionItem = defineComponent({\n  name: 'XhMentionItem',\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 = useMentionContext()\n    const item = computed<MentionItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideMentionItem({ item })\n    // 候选的进出与改名由条目自己上报，机器据此结算条数并摘掉悬空高亮\n    onMounted(ctx.syncItems)\n    onUnmounted(ctx.syncItems)\n    // 节点就地复用时数量不变但身份换了，需按 value 另行上报\n    watch(() => props.value, ctx.syncItems)\n    return () => h('div', ctx.api.value.getItemProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhMentionItemText = defineComponent({\n  name: 'XhMentionItemText',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行首的作者内容（图标、色块、头像），对读屏隐藏 */\nexport const XhMentionItemPrefix = defineComponent({\n  name: 'XhMentionItemPrefix',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemPrefixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhMentionItemSuffix = defineComponent({\n  name: 'XhMentionItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhMentionItemDescription = defineComponent({\n  name: 'XhMentionItemDescription',\n  setup(_, { slots }) {\n    const ctx = useMentionContext()\n    const { item } = useMentionItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * 过滤仍归调用方：collection 就是当前应显示的候选。\n */\nfunction renderDefaultTree(\n  collection: readonly MentionNodeMeta[],\n  itemSlot?: (node: MentionNodeMeta) => VNode[],\n  prefixSlot?: (node: MentionNodeMeta) => VNode[],\n  suffixSlot?: (node: MentionNodeMeta) => VNode[],\n  emptySlot?: () => VNode[],\n): VNode[] {\n  const emptyText = emptySlot?.() ?? 'No results'\n  return [\n    h(XhMentionInput),\n    h(XhMentionPositioner, null, () => [\n      h(XhMentionContent, null, () => collection.map(node =>\n        h(XhMentionItem, { key: node.value, value: node.value }, () => [\n          ...(prefixSlot ? [h(XhMentionItemPrefix, null, () => prefixSlot(node))] : []),\n          h(XhMentionItemText, null, () => itemSlot?.(node) ?? node.label),\n          ...(node.description != null ? [h(XhMentionItemDescription, null, () => node.description)] : []),\n          ...(suffixSlot ? [h(XhMentionItemSuffix, null, () => suffixSlot(node))] : []),\n        ]),\n      )),\n      h(XhMentionEmpty, null, () => emptyText),\n    ]),\n  ]\n}\n"],"mappings":"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"}

package/dist/components/menu/context.js

@@ -15,7 +15,7 @@ function provideMenuItem(ctx) {
 }
 function useMenuItemContext() {
 	const ctx = inject(ITEM_KEY, null);
-	if (!ctx) throw new Error("[xh] Menu 条目子部件必须用在 XhMenuItem 内");
+	if (!ctx) throw new Error("[xh] Menu 条目子部件必须用在 XhMenuItem / XhMenuCheckboxItem / XhMenuRadioItem 内");
 	return ctx;
 }
 const GROUP_KEY = Symbol.for("xh-menu-group");

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/menu/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { MenuGroupProps, MenuItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { MenuContext } from './use-menu'\nimport { inject, provide } from 'vue'\n\n/** 条目声明的值与禁用，供 item-text / item-indicator / item-description 等子部件复用同一份声明。 */\nexport interface MenuItemContext {\n  item: ComputedRef<MenuItemProps>\n}\n\nconst KEY: InjectionKey<MenuContext> = Symbol.for('xh-menu')\nconst ITEM_KEY: InjectionKey<MenuItemContext> = Symbol.for('xh-menu-item')\n\nexport function provideMenu(ctx: MenuContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useMenuContext(): MenuContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menu 部件必须用在 XhMenuRoot 内')\n  return ctx\n}\n\nexport function provideMenuItem(ctx: MenuItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useMenuItemContext(): MenuItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menu 条目子部件必须用在 XhMenuItem 内')\n  return ctx\n}\n\n/** 分组声明的身份，供分组标题取到同一个值（标题的 id 由它派生）。 */\nexport interface MenuGroupContext {\n  group: ComputedRef<MenuGroupProps>\n}\n\nconst GROUP_KEY: InjectionKey<MenuGroupContext> = Symbol.for('xh-menu-group')\n\nexport function provideMenuGroup(ctx: MenuGroupContext): void {\n  provide(GROUP_KEY, ctx)\n}\n\nexport function useMenuGroupContext(): MenuGroupContext {\n  const ctx = inject(GROUP_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menu 分组标题必须用在 XhMenuGroup 内')\n  return ctx\n}\n\n/** 子菜单触发条目要同时访问父菜单与本子菜单，这里保存父层句柄与它在父层中的身份。 */\nexport interface MenuSubHandle {\n  parent: MenuContext\n  value: string\n  disabled?: boolean\n}\n\nconst SUB_KEY: InjectionKey<MenuSubHandle> = Symbol.for('xh-menu-sub')\n\nexport function provideMenuSub(handle: MenuSubHandle): void {\n  provide(SUB_KEY, handle)\n}\n\nexport function useMenuSubContext(): MenuSubHandle {\n  const handle = inject(SUB_KEY, null)\n  if (!handle)\n    throw new Error('[xh] MenuSubTrigger 必须用在 XhMenuSub 内')\n  return handle\n}\n"],"mappings":";;AAiBA,MAAM,MAAiC,OAAO,IAAI,SAAS;AAC3D,MAAM,WAA0C,OAAO,IAAI,cAAc;AAEzE,SAAgB,YAAY,KAAwB;CAClD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,iBAA8B;CAC5C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT;AAEA,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,kCAAkC;CACpD,OAAO;AACT;AAOA,MAAM,YAA4C,OAAO,IAAI,eAAe;AAE5E,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,kCAAkC;CACpD,OAAO;AACT;AASA,MAAM,UAAuC,OAAO,IAAI,aAAa;AAErE,SAAgB,eAAe,QAA6B;CAC1D,QAAQ,SAAS,MAAM;AACzB;AAEA,SAAgB,oBAAmC;CACjD,MAAM,SAAS,OAAO,SAAS,IAAI;CACnC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,sCAAsC;CACxD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/menu/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { MenuAnyItemProps, MenuGroupProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { MenuContext } from './use-menu'\nimport { inject, provide } from 'vue'\n\n/** 条目声明的值与禁用，供 item-text / item-indicator / item-description 等子部件复用同一份声明。 */\nexport interface MenuItemContext {\n  item: ComputedRef<MenuAnyItemProps>\n}\n\nconst KEY: InjectionKey<MenuContext> = Symbol.for('xh-menu')\nconst ITEM_KEY: InjectionKey<MenuItemContext> = Symbol.for('xh-menu-item')\n\nexport function provideMenu(ctx: MenuContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useMenuContext(): MenuContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menu 部件必须用在 XhMenuRoot 内')\n  return ctx\n}\n\nexport function provideMenuItem(ctx: MenuItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useMenuItemContext(): MenuItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menu 条目子部件必须用在 XhMenuItem / XhMenuCheckboxItem / XhMenuRadioItem 内')\n  return ctx\n}\n\n/** 分组声明的身份，供分组标题取到同一个值（标题的 id 由它派生）。 */\nexport interface MenuGroupContext {\n  group: ComputedRef<MenuGroupProps>\n}\n\nconst GROUP_KEY: InjectionKey<MenuGroupContext> = Symbol.for('xh-menu-group')\n\nexport function provideMenuGroup(ctx: MenuGroupContext): void {\n  provide(GROUP_KEY, ctx)\n}\n\nexport function useMenuGroupContext(): MenuGroupContext {\n  const ctx = inject(GROUP_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Menu 分组标题必须用在 XhMenuGroup 内')\n  return ctx\n}\n\n/** 子菜单触发条目要同时访问父菜单与本子菜单，这里保存父层句柄与它在父层中的身份。 */\nexport interface MenuSubHandle {\n  parent: MenuContext\n  value: string\n  disabled?: boolean\n}\n\nconst SUB_KEY: InjectionKey<MenuSubHandle> = Symbol.for('xh-menu-sub')\n\nexport function provideMenuSub(handle: MenuSubHandle): void {\n  provide(SUB_KEY, handle)\n}\n\nexport function useMenuSubContext(): MenuSubHandle {\n  const handle = inject(SUB_KEY, null)\n  if (!handle)\n    throw new Error('[xh] MenuSubTrigger 必须用在 XhMenuSub 内')\n  return handle\n}\n"],"mappings":";;AAiBA,MAAM,MAAiC,OAAO,IAAI,SAAS;AAC3D,MAAM,WAA0C,OAAO,IAAI,cAAc;AAEzE,SAAgB,YAAY,KAAwB;CAClD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,iBAA8B;CAC5C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT;AAEA,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,yEAAyE;CAC3F,OAAO;AACT;AAOA,MAAM,YAA4C,OAAO,IAAI,eAAe;AAE5E,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,kCAAkC;CACpD,OAAO;AACT;AASA,MAAM,UAAuC,OAAO,IAAI,aAAa;AAErE,SAAgB,eAAe,QAA6B;CAC1D,QAAQ,SAAS,MAAM;AACzB;AAEA,SAAgB,oBAAmC;CACjD,MAAM,SAAS,OAAO,SAAS,IAAI;CACnC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,sCAAsC;CACxD,OAAO;AACT"}