@xihan-ui/vue 2.1.0 → 3.0.0

package/dist/components/log/log.js.map

@@ -1 +1 @@
-{"version":3,"file":"log.js","names":[],"sources":["../../../src/components/log/log.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// 提供 log 相关实现。\n\nimport type { Size } from '@xihan-ui/core'\nimport type { LogApi, LogLevel, LogProps, LogSchema, LogTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideLog, useLogContext } from './context'\nimport { useLog } from './use-log'\n\n/** 默认插槽的载荷：行数与载入态、粘底状态与按钮的显示情况，以及滚动到底部的句柄。 */\nexport type LogRootSlotProps = Pick<\n  LogApi,\n  | 'rows'\n  | 'loading'\n  | 'atBottom'\n  | 'sticking'\n  | 'showScrollToEndTrigger'\n  | 'scrollToBottom'\n>\n\nexport const XhLogRoot = defineComponent({\n  name: 'XhLogRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    rows: { type: Number },\n    loading: Boolean,\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<LogTranslations>> },\n  },\n  // stick-change 携带 { atBottom, sticking }，无对应的 v-model\n  emits: {\n    'stick-change': (_details: PayloadOf<LogSchema['props'], 'onStickChange'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: LogRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: LogSchema['props']['onStickChange'] = details => emit('stick-change', details)\n    const ctx = useLog(withXhConfig('log', props) as LogProps, notify)\n    provideLog(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      rows: ctx.api.value.rows,\n      loading: ctx.api.value.loading,\n      atBottom: ctx.api.value.atBottom,\n      sticking: ctx.api.value.sticking,\n      showScrollToEndTrigger: ctx.api.value.showScrollToEndTrigger,\n      scrollToBottom: ctx.api.value.scrollToBottom,\n    }))\n  },\n})\n\nexport const XhLogViewport = defineComponent({\n  name: 'XhLogViewport',\n  setup(_, { slots }) {\n    const ctx = useLogContext()\n    // 把视口节点交给机器，由粘底句柄监听滚动\n    return () => h('div', {\n      ...ctx.api.value.getViewportProps() as Record<string, unknown>,\n      ref: ctx.viewportRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhLogContent = defineComponent({\n  name: 'XhLogContent',\n  setup(_, { slots }) {\n    const ctx = useLogContext()\n    // 把内容节点交给机器，由粘底句柄观察尺寸\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      ref: ctx.contentRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhLogLine = defineComponent({\n  name: 'XhLogLine',\n  props: {\n    level: { type: String as PropType<LogLevel> },\n  },\n  setup(props, { slots }) {\n    const ctx = useLogContext()\n    // 一行的文本与标注由作者写在插槽里，级别落成行上的 data-level\n    return () => h('div', ctx.api.value.getLineProps({ level: props.level }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhLogScrollToEndTrigger = defineComponent({\n  name: 'XhLogScrollToEndTrigger',\n  setup(_, { slots }) {\n    const ctx = useLogContext()\n    // 收起时走 hidden 属性，节点不卸载；插槽留空则由皮肤画兜底字形\n    return () => h('button', ctx.api.value.getScrollToEndTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhLogLiveRegion = defineComponent({\n  name: 'XhLogLiveRegion',\n  setup(_, { slots }) {\n    const ctx = useLogContext()\n    // 内容由宿主写入，念哪一句、什么时候念都归宿主定\n    return () => h('div', ctx.api.value.getLiveRegionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;AA2BA,MAAa,YAAY,gBAAgB;CACvC,MAAM;CAEN,OAAO;EACL,MAAM,EAAE,MAAM,OAAO;EACrB,SAAS;EACT,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAA6C;CACrE;CAEA,OAAO,EACL,iBAAiB,aAA6D,KAChF;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA8C,YAAW,KAAK,gBAAgB,OAAO;EAC3F,MAAM,MAAM,OAAO,aAAa,OAAO,KAAK,GAAe,MAAM;EACjE,WAAW,GAAG;EACd,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,MAAM,IAAI,IAAI,MAAM;GACpB,SAAS,IAAI,IAAI,MAAM;GACvB,UAAU,IAAI,IAAI,MAAM;GACxB,UAAU,IAAI,IAAI,MAAM;GACxB,wBAAwB,IAAI,IAAI,MAAM;GACtC,gBAAgB,IAAI,IAAI,MAAM;EAChC,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,cAAc;EAE1B,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,iBAAiB;GAClC,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,cAAc;EAE1B,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GACjC,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,YAAY,gBAAgB;CACvC,MAAM;CACN,OAAO,EACL,OAAO,EAAE,MAAM,OAA6B,EAC9C;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,cAAc;EAE1B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,EAAE,OAAO,MAAM,MAAM,CAAC,GAA8B,MAAM,UAAU,CAAC;CACxH;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,cAAc;EAE1B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,2BAA2B,GAA8B,MAAM,UAAU,CAAC;CACnH;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,cAAc;EAE1B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,mBAAmB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC"}
+{"version":3,"file":"log.js","names":[],"sources":["../../../src/components/log/log.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// 提供 log 相关实现。\n\nimport type { Size } from '@xihan-ui/core'\nimport type { CollectionVirtualizer, LogAnsiSegment, LogApi, LogLevel, LogProps, LogSchema, LogTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { parseAnsi } from '@xihan-ui/headless'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideLog, useLogContext } from './context'\nimport { useLog } from './use-log'\n\n/** 默认插槽的载荷：行数与载入态、粘底状态与按钮的显示情况，以及滚动到底部的句柄。 */\nexport type LogRootSlotProps = Pick<\n  LogApi,\n  | 'rows'\n  | 'loading'\n  | 'atBottom'\n  | 'sticking'\n  | 'showScrollToEndTrigger'\n  | 'scrollToBottom'\n>\n\nexport const XhLogRoot = defineComponent({\n  name: 'XhLogRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    rows: { type: Number },\n    loading: Boolean,\n    size: { type: String as PropType<Size> },\n    /** 只显示这几个级别的行，缺省全部显示。 */\n    levels: { type: Array as PropType<readonly LogLevel[]> },\n    /** 与虚拟滚动接线：传入 XhVirtualizerRoot 插槽里的 collectionVirtualizer。 */\n    virtualizer: { type: Object as PropType<CollectionVirtualizer> },\n    translations: { type: Object as PropType<Partial<LogTranslations>> },\n  },\n  // stick-change 携带 { atBottom, sticking }，无对应的 v-model\n  emits: {\n    'stick-change': (_details: PayloadOf<LogSchema['props'], 'onStickChange'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: LogRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: LogSchema['props']['onStickChange'] = details => emit('stick-change', details)\n    const ctx = useLog(withXhConfig('log', props) as LogProps, notify)\n    provideLog(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      rows: ctx.api.value.rows,\n      loading: ctx.api.value.loading,\n      atBottom: ctx.api.value.atBottom,\n      sticking: ctx.api.value.sticking,\n      showScrollToEndTrigger: ctx.api.value.showScrollToEndTrigger,\n      scrollToBottom: ctx.api.value.scrollToBottom,\n    }))\n  },\n})\n\nexport const XhLogViewport = defineComponent({\n  name: 'XhLogViewport',\n  setup(_, { slots }) {\n    const ctx = useLogContext()\n    // 把视口节点交给机器，由粘底句柄监听滚动\n    return () => h('div', {\n      ...ctx.api.value.getViewportProps() as Record<string, unknown>,\n      ref: ctx.viewportRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhLogContent = defineComponent({\n  name: 'XhLogContent',\n  setup(_, { slots }) {\n    const ctx = useLogContext()\n    // 把内容节点交给机器，由粘底句柄观察尺寸\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      ref: ctx.contentRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhLogSegment = defineComponent({\n  name: 'XhLogSegment',\n  props: {\n    /** parseAnsi 拆出的一段。 */\n    segment: { type: Object as PropType<LogAnsiSegment>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useLogContext()\n    return () => h('span', ctx.api.value.getSegmentProps(props.segment) as Record<string, unknown>, slots.default?.() ?? props.segment.text)\n  },\n})\n\nexport const XhLogLine = defineComponent({\n  name: 'XhLogLine',\n  props: {\n    level: { type: String as PropType<LogLevel> },\n    /** 带 ANSI 转义的一行原文：按 SGR 拆成着色的段；写了插槽时以插槽为准。 */\n    ansi: { type: String },\n  },\n  setup(props, { slots }) {\n    const ctx = useLogContext()\n    // 一行的文本与标注由作者写在插槽里，级别落成行上的 data-level\n    return () => h(\n      'div',\n      ctx.api.value.getLineProps({ level: props.level }) as Record<string, unknown>,\n      slots.default?.() ?? (props.ansi === undefined ? undefined : parseAnsi(props.ansi).map(segment => h(XhLogSegment, { segment }))),\n    )\n  },\n})\n\nexport const XhLogScrollToEndTrigger = defineComponent({\n  name: 'XhLogScrollToEndTrigger',\n  setup(_, { slots }) {\n    const ctx = useLogContext()\n    // 收起时走 hidden 属性，节点不卸载；插槽留空则由皮肤画兜底字形\n    return () => h('button', ctx.api.value.getScrollToEndTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhLogLiveRegion = defineComponent({\n  name: 'XhLogLiveRegion',\n  setup(_, { slots }) {\n    const ctx = useLogContext()\n    // 内容由宿主写入，念哪一句、什么时候念都归宿主定\n    return () => h('div', ctx.api.value.getLiveRegionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AA4BA,MAAa,YAAY,gBAAgB;CACvC,MAAM;CAEN,OAAO;EACL,MAAM,EAAE,MAAM,OAAO;EACrB,SAAS;EACT,MAAM,EAAE,MAAM,OAAyB;;EAEvC,QAAQ,EAAE,MAAM,MAAuC;;EAEvD,aAAa,EAAE,MAAM,OAA0C;EAC/D,cAAc,EAAE,MAAM,OAA6C;CACrE;CAEA,OAAO,EACL,iBAAiB,aAA6D,KAChF;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA8C,YAAW,KAAK,gBAAgB,OAAO;EAC3F,MAAM,MAAM,OAAO,aAAa,OAAO,KAAK,GAAe,MAAM;EACjE,WAAW,GAAG;EACd,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,MAAM,IAAI,IAAI,MAAM;GACpB,SAAS,IAAI,IAAI,MAAM;GACvB,UAAU,IAAI,IAAI,MAAM;GACxB,UAAU,IAAI,IAAI,MAAM;GACxB,wBAAwB,IAAI,IAAI,MAAM;GACtC,gBAAgB,IAAI,IAAI,MAAM;EAChC,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,cAAc;EAE1B,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,iBAAiB;GAClC,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,cAAc;EAE1B,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GACjC,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,OAAO;;AAEL,SAAS;EAAE,MAAM;EAAoC,UAAU;CAAK,EACtE;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,cAAc;EAC1B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,gBAAgB,MAAM,OAAO,GAA8B,MAAM,UAAU,KAAK,MAAM,QAAQ,IAAI;CACzI;AACF,CAAC;AAED,MAAa,YAAY,gBAAgB;CACvC,MAAM;CACN,OAAO;EACL,OAAO,EAAE,MAAM,OAA6B;;EAE5C,MAAM,EAAE,MAAM,OAAO;CACvB;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,cAAc;EAE1B,aAAa,EACX,OACA,IAAI,IAAI,MAAM,aAAa,EAAE,OAAO,MAAM,MAAM,CAAC,GACjD,MAAM,UAAU,MAAM,MAAM,SAAS,KAAA,IAAY,KAAA,IAAY,UAAU,MAAM,IAAI,CAAC,CAAC,KAAI,YAAW,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC,EAChI;CACF;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,cAAc;EAE1B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,2BAA2B,GAA8B,MAAM,UAAU,CAAC;CACnH;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,cAAc;EAE1B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,mBAAmB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC"}

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

@@ -9,7 +9,7 @@ interface LogContext {
   contentRef: Ref<HTMLElement | null>;
 }
 /** 状态机只接收 onStickChange，rows / loading / translations 是纯视图属性，直接进入 connect。 */
-declare function useLog(props: LogProps, onStickChange?: LogSchema['props']['onStickChange']): LogContext;
+declare function useLog(props: LogProps & Pick<LogSchema['props'], 'virtualizer'>, onStickChange?: LogSchema['props']['onStickChange']): LogContext;
 //#endregion
 export { LogContext, useLog };
 //# sourceMappingURL=use-log.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-log.d.ts","names":[],"sources":["../../../src/components/log/use-log.ts"],"mappings":";;;UAgBiB;EACf,KAAK,YAAY;;EAEjB,aAAa,IAAI;;EAEjB,YAAY,IAAI;;;iBAIF,OACd,OAAO,UACP,gBAAgB,sCACf"}
+{"version":3,"file":"use-log.d.ts","names":[],"sources":["../../../src/components/log/use-log.ts"],"mappings":";;;UAgBiB;EACf,KAAK,YAAY;;EAEjB,aAAa,IAAI;;EAEjB,YAAY,IAAI;;;iBAIF,OACd,OAAO,WAAW,KAAK,oCACvB,gBAAgB,sCACf"}

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

@@ -11,7 +11,10 @@ function useLog(props, onStickChange) {
 	const contentRef = ref(null);
 	const idGen = createVueIdGenerator();
 	const scope = createScope(null, idGen);
-	const service = useMachine(logMachine, () => ({ onStickChange }), scope);
+	const service = useMachine(logMachine, () => ({
+		onStickChange,
+		virtualizer: props.virtualizer
+	}), scope);
 	if (typeof document !== "undefined") service.refs.set("config", createRuntimeConfig({
 		scope,
 		idGenerator: idGen

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

@@ -1 +1 @@
-{"version":3,"file":"use-log.js","names":[],"sources":["../../../src/components/log/use-log.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 log 相关实现。\n\nimport type { LogApi, LogProps, LogSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectLog, logMachine } from '@xihan-ui/headless'\nimport { computed, ref, watch } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface LogContext {\n  api: ComputedRef<LogApi>\n  /** overflow:auto 的滚动容器节点。 */\n  viewportRef: Ref<HTMLElement | null>\n  /** 内容包裹层节点，尺寸变化的观察目标。 */\n  contentRef: Ref<HTMLElement | null>\n}\n\n/** 状态机只接收 onStickChange，rows / loading / translations 是纯视图属性，直接进入 connect。 */\nexport function useLog(\n  props: LogProps,\n  onStickChange?: LogSchema['props']['onStickChange'],\n): LogContext {\n  const viewportRef = 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(logMachine, () => ({ onStickChange }), scope)\n\n  // 无 DOM 环境不装 config，此时粘底效应整套不挂载\n  if (typeof document !== 'undefined')\n    service.refs.set('config', createRuntimeConfig({ scope, idGenerator: idGen }))\n\n  // 传 getter 而非节点本身，ref 在挂载后才有值\n  service.refs.set('getViewportEl', () => viewportRef.value)\n  service.refs.set('getContentEl', () => contentRef.value)\n\n  // 节点变化后让句柄重绑\n  watch([viewportRef, contentRef], () => {\n    service.refs.get('stick')?.retarget()\n  })\n\n  const api = computed(() => connectLog(service, props, vueNormalize))\n  return { api, viewportRef, contentRef }\n}\n"],"mappings":";;;;;;;;AAyBA,SAAgB,OACd,OACA,eACY;CACZ,MAAM,cAAc,IAAwB,IAAI;CAChD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,mBAAmB,EAAE,cAAc,IAAI,KAAK;CAGvE,IAAI,OAAO,aAAa,aACtB,QAAQ,KAAK,IAAI,UAAU,oBAAoB;EAAE;EAAO,aAAa;CAAM,CAAC,CAAC;CAG/E,QAAQ,KAAK,IAAI,uBAAuB,YAAY,KAAK;CACzD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CAGvD,MAAM,CAAC,aAAa,UAAU,SAAS;EACrC,QAAQ,KAAK,IAAI,OAAO,CAAC,EAAE,SAAS;CACtC,CAAC;CAGD,OAAO;EAAE,KADG,eAAe,WAAW,SAAS,OAAO,YAAY,CACvD;EAAG;EAAa;CAAW;AACxC"}
+{"version":3,"file":"use-log.js","names":[],"sources":["../../../src/components/log/use-log.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 log 相关实现。\n\nimport type { LogApi, LogProps, LogSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectLog, logMachine } from '@xihan-ui/headless'\nimport { computed, ref, watch } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface LogContext {\n  api: ComputedRef<LogApi>\n  /** overflow:auto 的滚动容器节点。 */\n  viewportRef: Ref<HTMLElement | null>\n  /** 内容包裹层节点，尺寸变化的观察目标。 */\n  contentRef: Ref<HTMLElement | null>\n}\n\n/** 状态机只接收 onStickChange，rows / loading / translations 是纯视图属性，直接进入 connect。 */\nexport function useLog(\n  props: LogProps & Pick<LogSchema['props'], 'virtualizer'>,\n  onStickChange?: LogSchema['props']['onStickChange'],\n): LogContext {\n  const viewportRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // 虚拟滚动接线决定粘底跟谁走，是机器的事；其余视图属性直接进 connect\n  const service = useMachine(logMachine, () => ({ onStickChange, virtualizer: props.virtualizer }), scope)\n\n  // 无 DOM 环境不装 config，此时粘底效应整套不挂载\n  if (typeof document !== 'undefined')\n    service.refs.set('config', createRuntimeConfig({ scope, idGenerator: idGen }))\n\n  // 传 getter 而非节点本身，ref 在挂载后才有值\n  service.refs.set('getViewportEl', () => viewportRef.value)\n  service.refs.set('getContentEl', () => contentRef.value)\n\n  // 节点变化后让句柄重绑\n  watch([viewportRef, contentRef], () => {\n    service.refs.get('stick')?.retarget()\n  })\n\n  const api = computed(() => connectLog(service, props, vueNormalize))\n  return { api, viewportRef, contentRef }\n}\n"],"mappings":";;;;;;;;AAyBA,SAAgB,OACd,OACA,eACY;CACZ,MAAM,cAAc,IAAwB,IAAI;CAChD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CAErC,MAAM,UAAU,WAAW,mBAAmB;EAAE;EAAe,aAAa,MAAM;CAAY,IAAI,KAAK;CAGvG,IAAI,OAAO,aAAa,aACtB,QAAQ,KAAK,IAAI,UAAU,oBAAoB;EAAE;EAAO,aAAa;CAAM,CAAC,CAAC;CAG/E,QAAQ,KAAK,IAAI,uBAAuB,YAAY,KAAK;CACzD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CAGvD,MAAM,CAAC,aAAa,UAAU,SAAS;EACrC,QAAQ,KAAK,IAAI,OAAO,CAAC,EAAE,SAAS;CACtC,CAAC;CAGD,OAAO;EAAE,KADG,eAAe,WAAW,SAAS,OAAO,YAAY,CACvD;EAAG;EAAa;CAAW;AACxC"}

package/dist/components/markdown-stream/markdown-stream.d.ts

@@ -10,6 +10,24 @@ interface MarkdownStreamBlockSlotProps {
   /** 0 基块下标。 */
   index: number;
 }
+/** 行内引用插槽的载荷：正文里 [@来源] 写成的一处引用，渲进 html 里的占位节点。 */
+interface MarkdownStreamCitationSlotProps {
+  /** 这一处引用的来源 id，按书写顺序排；一处多源时不止一个。 */
+  sourceIds: readonly string[];
+  block: MarkdownBlock;
+  /** 该挂点在块内的 0 基下标。 */
+  index: number;
+}
+/** 行内公式插槽的载荷：交给宿主的公式引擎渲染。 */
+interface MarkdownStreamMathSlotProps {
+  /** 未经转义的 TeX 原文。 */
+  source: string;
+  /** 行内写的 `$$…$$` 为真。 */
+  display: boolean;
+  block: MarkdownBlock;
+  /** 该挂点在块内的 0 基下标。 */
+  index: number;
+}
 declare const XhMarkdownStreamRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   blocks: {
     type: PropType<readonly MarkdownBlock[]>;
@@ -51,8 +69,8 @@ declare const XhMarkdownStreamRoot: import("vue").DefineComponent<import("vue").
     type: PropType<Partial<MarkdownStreamTranslations>>;
   };
 }>> & Readonly<{}>, {
-  blocks: readonly MarkdownBlock[];
   streaming: boolean;
+  blocks: readonly MarkdownBlock[];
   caret: boolean;
 }, SlotsType<{
   default?: (props: MarkdownStreamRootSlotProps) => VNode[];
@@ -61,10 +79,12 @@ declare const XhMarkdownStreamContent: import("vue").DefineComponent<{}, () => V
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, SlotsType<{
   block?: (props: MarkdownStreamBlockSlotProps) => VNode[];
+  citation?: (props: MarkdownStreamCitationSlotProps) => VNode[];
+  math?: (props: MarkdownStreamMathSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhMarkdownStreamLiveRegion: 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 { MarkdownStreamBlockSlotProps, MarkdownStreamRootSlotProps, XhMarkdownStreamContent, XhMarkdownStreamLiveRegion, XhMarkdownStreamRoot };
+export { MarkdownStreamBlockSlotProps, MarkdownStreamCitationSlotProps, MarkdownStreamMathSlotProps, MarkdownStreamRootSlotProps, XhMarkdownStreamContent, XhMarkdownStreamLiveRegion, XhMarkdownStreamRoot };
 //# sourceMappingURL=markdown-stream.d.ts.map

package/dist/components/markdown-stream/markdown-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-stream.d.ts","names":[],"sources":["../../../src/components/markdown-stream/markdown-stream.ts"],"mappings":";;;;;KAiBY,8BAA8B,KAAK;;UAG9B;EACf,OAAO;;EAEP;;cAGW,oCAAoB,8BAAA;;IAIJ,MAAA,kBAAkB;;;;;IAEf,MAAA;;;;;;;IAEJ,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;IALxB,MAAA,kBAAkB;;;;;IAEf,MAAA;;;;;;;IAEJ,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;EAGvC,WAAC,OAAO,gCAAgC;kCAiCpD;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;;EAGxB,SAAC,OAAO,iCAAiC;kCAoBnD;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAUrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"markdown-stream.d.ts","names":[],"sources":["../../../src/components/markdown-stream/markdown-stream.ts"],"mappings":";;;;;KAiBY,8BAA8B,KAAK;;UAG9B;EACf,OAAO;;EAEP;;;UAIe;;EAEf;EACA,OAAO;;EAEP;;;UAIe;;EAEf;;EAEA;EACA,OAAO;;EAEP;;cAGW,oCAAoB,8BAAA;;IAIJ,MAAA,kBAAkB;;;;;IAEf,MAAA;;;;;;;IAEJ,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;IALxB,MAAA,kBAAkB;;;;;IAEf,MAAA;;;;;;;IAEJ,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;EAGvC,WAAC,OAAO,gCAAgC;kCAiCpD;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;;EAGxB,SAAC,OAAO,iCAAiC;EACtC,YAAC,OAAO,oCAAoC;EAChD,QAAC,OAAO,gCAAgC;kCAuDjD;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAUrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

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

@@ -1,8 +1,8 @@
 import { withXhConfig } from "../../config/config.js";
 import { provideMarkdownStream, useMarkdownStreamContext } from "./context.js";
 import { useMarkdownStream } from "./use-markdown-stream.js";
-import { defineComponent, h } from "vue";
-import { markdownBlockHtml } from "@xihan-ui/headless";
+import { Teleport, defineComponent, h, onMounted, onUpdated, ref, shallowRef } from "vue";
+import { markdownBlockHtml, queryMarkdownInlines, sameMarkdownInlines } from "@xihan-ui/headless";
 //#region src/components/markdown-stream/markdown-stream.ts
 const XhMarkdownStreamRoot = defineComponent({
 	name: "XhMarkdownStreamRoot",
@@ -56,9 +56,27 @@ const XhMarkdownStreamContent = defineComponent({
 	slots: Object,
 	setup(_, { slots }) {
 		const ctx = useMarkdownStreamContext();
+		const host = ref(null);
+		const mounts = shallowRef([]);
+		const cleared = /* @__PURE__ */ new WeakSet();
+		const collect = () => {
+			const el = host.value;
+			if (!el || !slots.citation && !slots.math) {
+				if (mounts.value.length > 0) mounts.value = [];
+				return;
+			}
+			const next = queryMarkdownInlines(el, ctx.api.value.blocks).filter((mount) => (mount.inline.kind === "citation" ? slots.citation : slots.math) !== void 0);
+			for (const mount of next) if (!cleared.has(mount.element)) {
+				mount.element.textContent = "";
+				cleared.add(mount.element);
+			}
+			if (!sameMarkdownInlines(next, mounts.value)) mounts.value = next;
+		};
+		onMounted(collect);
+		onUpdated(collect);
 		return () => {
 			const api = ctx.api.value;
-			return h("div", api.getContentProps(), api.blocks.map((block, index) => {
+			const blocks = api.blocks.map((block, index) => {
 				const attrs = {
 					...api.getBlockProps({ block }),
 					key: block.key
@@ -73,7 +91,28 @@ const XhMarkdownStreamContent = defineComponent({
 					...attrs,
 					innerHTML: html
 				});
-			}));
+			});
+			const inlines = mounts.value.map((mount) => {
+				const { inline, block, index } = mount;
+				const content = inline.kind === "citation" ? slots.citation?.({
+					sourceIds: inline.sourceIds,
+					block,
+					index
+				}) : slots.math?.({
+					source: inline.source,
+					display: inline.display,
+					block,
+					index
+				});
+				return h(Teleport, {
+					key: mount.key,
+					to: mount.element
+				}, content ?? []);
+			});
+			return h("div", {
+				...api.getContentProps(),
+				ref: host
+			}, [...blocks, ...inlines]);
 		};
 	}
 });

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":";;;;;;AA8CA,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;CAKP,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,yBAAyB;EACrC,MAAM,OAAO,IAAwB,IAAI;EAEzC,MAAM,SAAS,WAA2C,CAAC,CAAC;EAC5D,MAAM,0BAAU,IAAI,QAAqB;EACzC,MAAM,gBAAsB;GAC1B,MAAM,KAAK,KAAK;GAChB,IAAI,CAAC,MAAO,CAAC,MAAM,YAAY,CAAC,MAAM,MAAO;IAC3C,IAAI,OAAO,MAAM,SAAS,GACxB,OAAO,QAAQ,CAAC;IAClB;GACF;GACA,MAAM,OAAO,qBAAqB,IAAI,IAAI,IAAI,MAAM,MAAM,CAAC,CACxD,QAAO,WAAU,MAAM,OAAO,SAAS,aAAa,MAAM,WAAW,MAAM,UAAU,KAAA,CAAS;GAEjG,KAAK,MAAM,SAAS,MAClB,IAAI,CAAC,QAAQ,IAAI,MAAM,OAAO,GAAG;IAC/B,MAAM,QAAQ,cAAc;IAC5B,QAAQ,IAAI,MAAM,OAAO;GAC3B;GAEF,IAAI,CAAC,oBAAoB,MAAM,OAAO,KAAK,GACzC,OAAO,QAAQ;EACnB;EACA,UAAU,OAAO;EACjB,UAAU,OAAO;EAGjB,aAAa;GACX,MAAM,MAAM,IAAI,IAAI;GACpB,MAAM,SAAS,IAAI,OAAO,KAAK,OAAO,UAAU;IAC9C,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;GAED,MAAM,UAAU,OAAO,MAAM,KAAK,UAAU;IAC1C,MAAM,EAAE,QAAQ,OAAO,UAAU;IACjC,MAAM,UAAU,OAAO,SAAS,aAC5B,MAAM,WAAW;KAAE,WAAW,OAAO;KAAW;KAAO;IAAM,CAAC,IAC9D,MAAM,OAAO;KAAE,QAAQ,OAAO;KAAQ,SAAS,OAAO;KAAS;KAAO;IAAM,CAAC;IACjF,OAAO,EAAE,UAAU;KAAE,KAAK,MAAM;KAAK,IAAI,MAAM;IAAQ,GAAG,WAAW,CAAC,CAAC;GACzE,CAAC;GACD,OAAO,EAAE,OAAO;IAAE,GAAG,IAAI,gBAAgB;IAA8B,KAAK;GAAK,GAAG,CAAC,GAAG,QAAQ,GAAG,OAAO,CAAC;EAC7G;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"}

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