@xihan-ui/vue 2.0.0 → 3.0.0

package/dist/components/listbox/listbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"listbox.js","names":[],"sources":["../../../src/components/listbox/listbox.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// 提供 listbox 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { ListboxApi, ListboxGroupProps, ListboxItemProps, ListboxNode, ListboxNodeMeta, ListboxSchema, ListboxSelectionMode } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, mergeProps, onBeforeUnmount, onUpdated, ref, watch } from 'vue'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideListbox,\n  provideListboxItem,\n  provideListboxItemGroup,\n  useListboxContext,\n  useListboxItemContext,\n  useListboxItemGroupContext,\n} from './context'\nimport { useListbox } from './use-listbox'\n\ntype ListboxProps = ListboxSchema['props']\n\n/** 默认插槽的载荷：选中集合、选择模式与焦点锚点，以及判定选中与整份赋值、单选、切换的命令。 */\nexport type ListboxRootSlotProps = Pick<\n  ListboxApi,\n  'value' | 'selectionMode' | 'focusedValue' | 'isSelected' | 'setValue' | 'select' | 'toggle'\n>\n\nexport const XhListboxRoot = defineComponent({\n  name: 'XhListboxRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<ListboxNode[]> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    value: { type: [String, Array] as PropType<string | string[]> },\n    defaultValue: { type: [String, Array] as PropType<string | string[]> },\n    selectionMode: { type: String as PropType<ListboxSelectionMode> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    loading: Boolean,\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    loop: { type: Boolean, default: undefined },\n    typeahead: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    orientation: { type: String as PropType<Orientation> },\n  },\n  // value-change 携带 { value }，update:value 携带裸集合；回传值恒为数组，单选时长度 ≤ 1\n  emits: {\n    'value-change': (_details: PayloadOf<ListboxProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<ListboxProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ListboxRootSlotProps) => VNode[]\n    label?: () => VNode[]\n    item?: (node: ListboxNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: ListboxProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useListbox(useFormControlProps(props) as ListboxProps, notify)\n    provideListbox(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, [\n      ...(slots.default\n        ? slots.default({\n          value: ctx.api.value.value,\n          selectionMode: ctx.api.value.selectionMode,\n          focusedValue: ctx.api.value.focusedValue,\n          isSelected: ctx.api.value.isSelected,\n          setValue: ctx.api.value.setValue,\n          select: ctx.api.value.select,\n          toggle: ctx.api.value.toggle,\n        }) ?? []\n        : props.collection\n          ? renderDefaultTree(\n              ctx.api.value.collection,\n              slots.label?.() ?? (props.label != null ? [props.label] : null),\n              slots.item,\n            )\n          : []),\n    ])\n  },\n})\n\nexport const XhListboxLabel = defineComponent({\n  name: 'XhListboxLabel',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxContent = defineComponent({\n  name: 'XhListboxContent',\n  // 根是片段（列表节点 + 贴层的条子），Vue 不会把直通属性合上去：作者写的 class、style 与 data-* 自己接住落到列表节点上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useListboxContext()\n    const contentRef = ref<HTMLElement | null>(null)\n    // 定高小列表走自绘条（§6.6）：条子是 content 的兄弟、挂在 root 这个定位盒上，贴在 content 自己的盒子上\n    // （root 里还有标题与占位，贴壳边会盖到它们）；两条轴都摆——皮肤给的是两轴 overflow: auto。\n    // 页内宿主走 6px 缺省档；横条的正负按排版方向算，把机器里那份 dir 交过去\n    const bars = useScrollbars({\n      scrollable: () => contentRef.value,\n      axes: ['vertical', 'horizontal'],\n      anchor: 'layer',\n      props: () => ({ dir: ctx.service.prop('dir') }),\n    })\n    // 条目增减、占位显隐都会挪动列表在壳内的位置与尺寸：每次更新后重量一次偏移盒\n    onUpdated(() => bars.measure())\n    return () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getContentProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { contentRef.value = el as HTMLElement | null },\n      }, slots.default?.()),\n      ...bars.render(),\n    ]\n  },\n})\n\nexport const XhListboxEmpty = defineComponent({\n  name: 'XhListboxEmpty',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    // 空态占位：写在 root 里、content 的兄弟，不进列表框的拥有关系。\n    // 给了 collection 时收放归连接层，条目手写时归作者\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxLoading = defineComponent({\n  name: 'XhListboxLoading',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    // 在途占位：与空态占位同一个位置，取数期间顶上来\n    return () => h('div', ctx.api.value.getLoadingProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxLoadMoreTrigger = defineComponent({\n  name: 'XhListboxLoadMoreTrigger',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    // 取下一页的入口：点了做什么归作者，这里只把在途与禁用两档焊成点不动\n    return () => h('button', ctx.api.value.getLoadMoreTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxGroup = defineComponent({\n  name: 'XhListboxGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useListboxContext()\n    const group = computed<ListboxGroupProps>(() => ({ value: props.value }))\n    provideListboxItemGroup({ group })\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxGroupLabel = defineComponent({\n  name: 'XhListboxGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { group } = useListboxItemGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxItem = defineComponent({\n  name: 'XhListboxItem',\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 = useListboxContext()\n    const item = computed<ListboxItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideListboxItem({ item })\n    // 本条目持有焦点时，value 变更重报焦点条目，卸载时上报列表失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'LIST.BLUR' })\n    })\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhListboxItemText = defineComponent({\n  name: 'XhListboxItemText',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxItemIndicator = defineComponent({\n  name: 'XhListboxItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构（分组、条目外的节点）时写默认插槽。\n */\nfunction renderDefaultTree(\n  collection: readonly ListboxNodeMeta[],\n  label: (VNode | string)[] | null,\n  itemSlot?: (node: ListboxNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    ...(label ? [h(XhListboxLabel, null, () => label)] : []),\n    h(XhListboxContent, null, () => collection.map(node =>\n      h(XhListboxItem, { key: node.value, value: node.value }, () => [\n        h(XhListboxItemText, null, () => itemSlot?.(node) ?? node.label),\n        h(XhListboxItemIndicator),\n      ]),\n    )),\n  ]\n}\n"],"mappings":"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"}
+{"version":3,"file":"listbox.js","names":[],"sources":["../../../src/components/listbox/listbox.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// 提供 listbox 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { CollectionVirtualizer, ListboxApi, ListboxGroupProps, ListboxItemProps, ListboxNode, ListboxNodeMeta, ListboxSchema, ListboxSelectionMode } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, mergeProps, onBeforeUnmount, onUpdated, ref, watch } from 'vue'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideListbox,\n  provideListboxItem,\n  provideListboxItemGroup,\n  useListboxContext,\n  useListboxItemContext,\n  useListboxItemGroupContext,\n} from './context'\nimport { useListbox } from './use-listbox'\n\ntype ListboxProps = ListboxSchema['props']\n\n/** 默认插槽的载荷：选中集合、选择模式与焦点锚点，以及判定选中与整份赋值、单选、切换的命令。 */\nexport type ListboxRootSlotProps = Pick<\n  ListboxApi,\n  'value' | 'selectionMode' | 'focusedValue' | 'isSelected' | 'setValue' | 'select' | 'toggle'\n>\n\nexport const XhListboxRoot = defineComponent({\n  name: 'XhListboxRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<ListboxNode[]> },\n    virtualizer: { type: Object as PropType<CollectionVirtualizer> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    value: { type: [String, Array] as PropType<string | string[]> },\n    defaultValue: { type: [String, Array] as PropType<string | string[]> },\n    selectionMode: { type: String as PropType<ListboxSelectionMode> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    loading: Boolean,\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    loop: { type: Boolean, default: undefined },\n    typeahead: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    orientation: { type: String as PropType<Orientation> },\n  },\n  // value-change 携带 { value }，update:value 携带裸集合；回传值恒为数组，单选时长度 ≤ 1\n  emits: {\n    'value-change': (_details: PayloadOf<ListboxProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<ListboxProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    'default'?: (props: ListboxRootSlotProps) => VNode[]\n    'label'?: () => VNode[]\n    /** 只填条目的文字槽，副文本与首尾两格照旧各归各的 */\n    'item'?: (node: ListboxNodeMeta) => VNode[]\n    /** 只接管行首那一格，其余槽照旧由数据铺 */\n    'item-prefix'?: (node: ListboxNodeMeta) => VNode[]\n    /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺 */\n    'item-suffix'?: (node: ListboxNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: ListboxProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useListbox(useFormControlProps(props) as ListboxProps, notify)\n    provideListbox(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, [\n      ...(slots.default\n        ? slots.default({\n          value: ctx.api.value.value,\n          selectionMode: ctx.api.value.selectionMode,\n          focusedValue: ctx.api.value.focusedValue,\n          isSelected: ctx.api.value.isSelected,\n          setValue: ctx.api.value.setValue,\n          select: ctx.api.value.select,\n          toggle: ctx.api.value.toggle,\n        }) ?? []\n        : props.collection\n          ? renderDefaultTree(\n              ctx.api.value.collection,\n              slots.label?.() ?? (props.label != null ? [props.label] : null),\n              slots.item,\n              slots['item-prefix'],\n              slots['item-suffix'],\n            )\n          : []),\n    ])\n  },\n})\n\nexport const XhListboxLabel = defineComponent({\n  name: 'XhListboxLabel',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxContent = defineComponent({\n  name: 'XhListboxContent',\n  // 根是片段（列表节点 + 贴层的条子），Vue 不会把直通属性合上去：作者写的 class、style 与 data-* 自己接住落到列表节点上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useListboxContext()\n    const contentRef = ref<HTMLElement | null>(null)\n    // 定高小列表走自绘条：条子是 content 的兄弟、挂在 root 这个定位盒上，贴在 content 自己的盒子上\n    // （root 里还有标题与占位，贴壳边会盖到它们）；两条轴都摆——皮肤给的是两轴 overflow: auto。\n    // 页内宿主走 6px 缺省档；横条的正负按排版方向算，把机器里那份 dir 交过去\n    const bars = useScrollbars({\n      scrollable: () => contentRef.value,\n      axes: ['vertical', 'horizontal'],\n      anchor: 'layer',\n      props: () => ({ dir: ctx.service.prop('dir') }),\n    })\n    // 条目增减、占位显隐都会挪动列表在壳内的位置与尺寸：每次更新后重量一次偏移盒\n    onUpdated(() => bars.measure())\n    return () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getContentProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { contentRef.value = el as HTMLElement | null },\n      }, slots.default?.()),\n      ...bars.render(),\n    ]\n  },\n})\n\nexport const XhListboxEmpty = defineComponent({\n  name: 'XhListboxEmpty',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    // 空态占位：写在 root 里、content 的兄弟，不进列表框的拥有关系。\n    // 给了 collection 时收放归连接层，条目手写时归作者\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxLoading = defineComponent({\n  name: 'XhListboxLoading',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    // 在途占位：与空态占位同一个位置，取数期间顶上来\n    return () => h('div', ctx.api.value.getLoadingProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxLoadMoreTrigger = defineComponent({\n  name: 'XhListboxLoadMoreTrigger',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    // 取下一页的入口：点了做什么归作者，这里只把在途与禁用两档焊成点不动\n    return () => h('button', ctx.api.value.getLoadMoreTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxGroup = defineComponent({\n  name: 'XhListboxGroup',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useListboxContext()\n    const group = computed<ListboxGroupProps>(() => ({ value: props.value }))\n    provideListboxItemGroup({ group })\n    return () => h('div', ctx.api.value.getGroupProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxGroupLabel = defineComponent({\n  name: 'XhListboxGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { group } = useListboxItemGroupContext()\n    return () => h('span', ctx.api.value.getGroupLabelProps(group.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxItem = defineComponent({\n  name: 'XhListboxItem',\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 = useListboxContext()\n    const item = computed<ListboxItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideListboxItem({ item })\n    // 本条目持有焦点时，value 变更重报焦点条目，卸载时上报列表失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      if (service.prop('virtualizer') && service.prop('collection')?.some(node => node.value === props.value))\n        return\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'LIST.BLUR' })\n    })\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhListboxItemText = defineComponent({\n  name: 'XhListboxItemText',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行首的作者内容（图标、色块、头像），对读屏隐藏 */\nexport const XhListboxItemPrefix = defineComponent({\n  name: 'XhListboxItemPrefix',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemPrefixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目行尾的作者内容（计数、徽标） */\nexport const XhListboxItemSuffix = defineComponent({\n  name: 'XhListboxItemSuffix',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemSuffixProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */\nexport const XhListboxItemDescription = defineComponent({\n  name: 'XhListboxItemDescription',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhListboxItemIndicator = defineComponent({\n  name: 'XhListboxItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useListboxContext()\n    const { item } = useListboxItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构（分组、条目外的节点）时写默认插槽。\n */\nfunction renderDefaultTree(\n  collection: readonly ListboxNodeMeta[],\n  label: (VNode | string)[] | null,\n  itemSlot?: (node: ListboxNodeMeta) => VNode[],\n  prefixSlot?: (node: ListboxNodeMeta) => VNode[],\n  suffixSlot?: (node: ListboxNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    ...(label ? [h(XhListboxLabel, null, () => label)] : []),\n    h(XhListboxContent, null, () => collection.map(node =>\n      h(XhListboxItem, { key: node.value, value: node.value }, () => [\n        ...(prefixSlot ? [h(XhListboxItemPrefix, null, () => prefixSlot(node))] : []),\n        h(XhListboxItemText, null, () => itemSlot?.(node) ?? node.label),\n        ...(node.description != null ? [h(XhListboxItemDescription, null, () => node.description)] : []),\n        ...(suffixSlot ? [h(XhListboxItemSuffix, null, () => suffixSlot(node))] : []),\n        h(XhListboxItemIndicator),\n      ]),\n    )),\n  ]\n}\n"],"mappings":"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"}

package/dist/components/loading-bar/use-loading-bar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-loading-bar.d.ts","names":[],"sources":["../../../src/components/loading-bar/use-loading-bar.ts"],"mappings":";;;UAciB;EACf,KAAK,YAAY;;iBAGH,cACd,OAAO,2BACP,gBAAgB,6CACf"}
+{"version":3,"file":"use-loading-bar.d.ts","names":[],"sources":["../../../src/components/loading-bar/use-loading-bar.ts"],"mappings":";;;UAgBiB;EACf,KAAK,YAAY;;iBAGH,cACd,OAAO,2BACP,gBAAgB,6CACf"}

package/dist/components/loading-bar/use-loading-bar.js

@@ -1,13 +1,15 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
+import { createVueIdGenerator } from "../../runtime/vue-id.js";
 import { computed } from "vue";
+import { createScope } from "@xihan-ui/core";
 import { connectLoadingBar, loadingBarMachine } from "@xihan-ui/headless";
 //#region src/components/loading-bar/use-loading-bar.ts
 function useLoadingBar(props, onValueChange) {
 	const service = useMachine(loadingBarMachine, () => ({
 		...props,
 		onValueChange
-	}));
+	}), createScope(null, createVueIdGenerator()));
 	return { api: computed(() => connectLoadingBar(service, vueNormalize)) };
 }
 //#endregion

package/dist/components/loading-bar/use-loading-bar.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-loading-bar.js","names":[],"sources":["../../../src/components/loading-bar/use-loading-bar.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 loading bar 相关实现。\n\nimport type { LoadingBarApi, LoadingBarSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectLoadingBar, loadingBarMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface LoadingBarContext {\n  api: ComputedRef<LoadingBarApi>\n}\n\nexport function useLoadingBar(\n  props: LoadingBarSchema['props'],\n  onValueChange?: LoadingBarSchema['props']['onValueChange'],\n): LoadingBarContext {\n  const service = useMachine(loadingBarMachine, () => ({ ...props, onValueChange }))\n  const api = computed(() => connectLoadingBar(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;AAkBA,SAAgB,cACd,OACA,eACmB;CACnB,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO;CAAc,EAAE;CAEjF,OAAO,EAAE,KADG,eAAe,kBAAkB,SAAS,YAAY,CACvD,EAAE;AACf"}
+{"version":3,"file":"use-loading-bar.js","names":[],"sources":["../../../src/components/loading-bar/use-loading-bar.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 loading bar 相关实现。\n\nimport type { LoadingBarApi, LoadingBarSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectLoadingBar, loadingBarMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface LoadingBarContext {\n  api: ComputedRef<LoadingBarApi>\n}\n\nexport function useLoadingBar(\n  props: LoadingBarSchema['props'],\n  onValueChange?: LoadingBarSchema['props']['onValueChange'],\n): LoadingBarContext {\n  // 根部件带 id（机器按它等淡出过渡）：用 Vue 的 useId 派生的 scope，服务端与水合两侧同号\n  const service = useMachine(loadingBarMachine, () => ({ ...props, onValueChange }), createScope(null, createVueIdGenerator()))\n  const api = computed(() => connectLoadingBar(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;;;AAoBA,SAAgB,cACd,OACA,eACmB;CAEnB,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO;CAAc,IAAI,YAAY,MAAM,qBAAqB,CAAC,CAAC;CAE5H,OAAO,EAAE,KADG,eAAe,kBAAkB,SAAS,YAAY,CACvD,EAAE;AACf"}

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { Size } from "@xihan-ui/core";
-import { LogApi, LogLevel, LogSchema, LogTranslations } from "@xihan-ui/headless";
+import { CollectionVirtualizer, LogAnsiSegment, LogApi, LogLevel, LogSchema, LogTranslations } from "@xihan-ui/headless";
 //#region src/components/log/log.d.ts
 /** 默认插槽的载荷：行数与载入态、粘底状态与按钮的显示情况，以及滚动到底部的句柄。 */
 type LogRootSlotProps = Pick<LogApi, 'rows' | 'loading' | 'atBottom' | 'sticking' | 'showScrollToEndTrigger' | 'scrollToBottom'>;
@@ -13,6 +13,14 @@ declare const XhLogRoot: import("vue").DefineComponent<import("vue").ExtractProp
   size: {
     type: PropType<Size>;
   };
+  /** 只显示这几个级别的行，缺省全部显示。 */
+  levels: {
+    type: PropType<readonly LogLevel[]>;
+  };
+  /** 与虚拟滚动接线：传入 XhVirtualizerRoot 插槽里的 collectionVirtualizer。 */
+  virtualizer: {
+    type: PropType<CollectionVirtualizer>;
+  };
   translations: {
     type: PropType<Partial<LogTranslations>>;
   };
@@ -28,6 +36,14 @@ declare const XhLogRoot: import("vue").DefineComponent<import("vue").ExtractProp
   size: {
     type: PropType<Size>;
   };
+  /** 只显示这几个级别的行，缺省全部显示。 */
+  levels: {
+    type: PropType<readonly LogLevel[]>;
+  };
+  /** 与虚拟滚动接线：传入 XhVirtualizerRoot 插槽里的 collectionVirtualizer。 */
+  virtualizer: {
+    type: PropType<CollectionVirtualizer>;
+  };
   translations: {
     type: PropType<Partial<LogTranslations>>;
   };
@@ -44,16 +60,39 @@ declare const XhLogViewport: import("vue").DefineComponent<{}, () => VNode<impor
 declare const XhLogContent: 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 XhLogSegment: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** parseAnsi 拆出的一段。 */
+  segment: {
+    type: PropType<LogAnsiSegment>;
+    required: true;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** parseAnsi 拆出的一段。 */
+  segment: {
+    type: PropType<LogAnsiSegment>;
+    required: true;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhLogLine: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   level: {
     type: PropType<LogLevel>;
   };
+  /** 带 ANSI 转义的一行原文：按 SGR 拆成着色的段；写了插槽时以插槽为准。 */
+  ansi: {
+    type: StringConstructor;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   level: {
     type: PropType<LogLevel>;
   };
+  /** 带 ANSI 转义的一行原文：按 SGR 拆成着色的段；写了插槽时以插槽为准。 */
+  ansi: {
+    type: StringConstructor;
+  };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhLogScrollToEndTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -62,5 +101,5 @@ declare const XhLogLiveRegion: import("vue").DefineComponent<{}, () => VNode<imp
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { LogRootSlotProps, XhLogContent, XhLogLine, XhLogLiveRegion, XhLogRoot, XhLogScrollToEndTrigger, XhLogViewport };
+export { LogRootSlotProps, XhLogContent, XhLogLine, XhLogLiveRegion, XhLogRoot, XhLogScrollToEndTrigger, XhLogSegment, XhLogViewport };
 //# sourceMappingURL=log.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"log.d.ts","names":[],"sources":["../../../src/components/log/log.ts"],"mappings":";;;;;;KAiBY,mBAAmB,KAC7B;cASW,yBAAS,8BAAA;;;;;;IAMM,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;;;;;;;IALb,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;EAOvC,WAAC,OAAO,qBAAqB;kCAezC;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAUxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAUvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yBAAS,8BAAA;;IAGO,MAAA,SAAS;;;;;;IAAT,MAAA,SAAS;;MAOpC,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAO1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"log.d.ts","names":[],"sources":["../../../src/components/log/log.ts"],"mappings":";;;;;;KAkBY,mBAAmB,KAC7B;cASW,yBAAS,8BAAA;;;;;;IAMM,MAAA,SAAS;;;;IAER,MAAA,kBAAkB;;;;IAEZ,MAAA,SAAS;;;IACR,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;;;;;;;IATb,MAAA,SAAS;;;;IAER,MAAA,kBAAkB;;;;IAEZ,MAAA,SAAS;;;IACR,MAAA,SAAS,QAAQ;;;;;;;EAOvC,WAAC,OAAO,qBAAqB;kCAezC;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAUxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAUvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,8BAAA;;;IAIM,MAAA,SAAS;;;;;;;;IAAT,MAAA,SAAS;;;MAMtC,oDAAA;cAEW,yBAAS,8BAAA;;IAGO,MAAA,SAAS;;;;;;;;;;IAAT,MAAA,SAAS;;;;;;MAapC,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAO1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/log/log.js

@@ -2,6 +2,7 @@ import { withXhConfig } from "../../config/config.js";
 import { provideLog, useLogContext } from "./context.js";
 import { useLog } from "./use-log.js";
 import { defineComponent, h } from "vue";
+import { parseAnsi } from "@xihan-ui/headless";
 //#region src/components/log/log.ts
 const XhLogRoot = defineComponent({
 	name: "XhLogRoot",
@@ -9,6 +10,10 @@ const XhLogRoot = defineComponent({
 		rows: { type: Number },
 		loading: Boolean,
 		size: { type: String },
+		/** 只显示这几个级别的行，缺省全部显示。 */
+		levels: { type: Array },
+		/** 与虚拟滚动接线：传入 XhVirtualizerRoot 插槽里的 collectionVirtualizer。 */
+		virtualizer: { type: Object },
 		translations: { type: Object }
 	},
 	emits: { "stick-change": (_details) => true },
@@ -47,12 +52,29 @@ const XhLogContent = defineComponent({
 		}, slots.default?.());
 	}
 });
+const XhLogSegment = defineComponent({
+	name: "XhLogSegment",
+	props: { 
+	/** parseAnsi 拆出的一段。 */
+segment: {
+		type: Object,
+		required: true
+	} },
+	setup(props, { slots }) {
+		const ctx = useLogContext();
+		return () => h("span", ctx.api.value.getSegmentProps(props.segment), slots.default?.() ?? props.segment.text);
+	}
+});
 const XhLogLine = defineComponent({
 	name: "XhLogLine",
-	props: { level: { type: String } },
+	props: {
+		level: { type: String },
+		/** 带 ANSI 转义的一行原文：按 SGR 拆成着色的段；写了插槽时以插槽为准。 */
+		ansi: { type: String }
+	},
 	setup(props, { slots }) {
 		const ctx = useLogContext();
-		return () => h("div", ctx.api.value.getLineProps({ level: props.level }), slots.default?.());
+		return () => h("div", ctx.api.value.getLineProps({ level: props.level }), slots.default?.() ?? (props.ansi === void 0 ? void 0 : parseAnsi(props.ansi).map((segment) => h(XhLogSegment, { segment }))));
 	}
 });
 const XhLogScrollToEndTrigger = defineComponent({
@@ -70,6 +92,6 @@ const XhLogLiveRegion = defineComponent({
 	}
 });
 //#endregion
-export { XhLogContent, XhLogLine, XhLogLiveRegion, XhLogRoot, XhLogScrollToEndTrigger, XhLogViewport };
+export { XhLogContent, XhLogLine, XhLogLiveRegion, XhLogRoot, XhLogScrollToEndTrigger, XhLogSegment, XhLogViewport };
 
 //# sourceMappingURL=log.js.map

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