@xihan-ui/vue 1.0.0 → 2.0.0

package/dist/components/heatmap/heatmap.js.map

@@ -1 +1 @@
-{"version":3,"file":"heatmap.js","names":[],"sources":["../../../src/components/heatmap/heatmap.ts"],"sourcesContent":["import type {\n  HeatmapApi,\n  HeatmapAxisInput,\n  HeatmapCellDetails,\n  HeatmapCellMeta,\n  HeatmapLegendBound,\n  HeatmapMatrixCellMeta,\n  HeatmapMatrixGrid,\n  HeatmapMonthGrid,\n  HeatmapPalette,\n  HeatmapRowProps,\n  HeatmapSchema,\n  HeatmapTranslations,\n  HeatmapValue,\n  HeatmapVariant,\n} from '@xihan-ui/headless'\nimport type { Direction, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { heatmapMatrixKey } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport {\n  provideHeatmap,\n  provideHeatmapMonth,\n  provideHeatmapRow,\n  useHeatmapContext,\n  useHeatmapMonth,\n  useHeatmapRow,\n} from './context'\nimport { useHeatmap } from './use-heatmap'\n\ntype HeatmapProps = HeatmapSchema['props']\n\n/**\n * 默认插槽的载荷：三张网格模型与锚点、当前详情，外加挪锚点的动作。\n * 三形态通用的那一组（`focusedCell` / `anchorCell` / `setFocusedCell`）也在里面：\n * 矩阵形态下带 Date 的那一组恒为 null，自己铺矩阵时只有这一组读得出、挪得动锚点。\n */\nexport type HeatmapRootSlotProps = Pick<\n  HeatmapApi,\n  | 'variant'\n  | 'grid'\n  | 'monthGrid'\n  | 'matrixGrid'\n  | 'focusedCell'\n  | 'focusedDate'\n  | 'anchorCell'\n  | 'anchorDate'\n  | 'activeCell'\n  | 'detailOpen'\n  | 'cellAt'\n  | 'setFocusedCell'\n  | 'setFocusedDate'\n>\n\n/**\n * `cell` 插槽的载荷：日期形态给日历那一格，矩阵形态给矩阵那一格。\n * 两者的坐标不同，用 `'date' in cell` 分辨。\n */\nexport type HeatmapCellSlotProps = HeatmapCellMeta | HeatmapMatrixCellMeta\n\nexport const XhHeatmapRoot = defineComponent({\n  name: 'XhHeatmapRoot',\n  // 全部 default: undefined，缺省值由机器与 connect 决定\n  props: {\n    variant: { type: String as PropType<HeatmapVariant>, default: undefined },\n    value: { type: Array as PropType<HeatmapValue[]>, default: undefined },\n    rows: { type: Array as PropType<HeatmapAxisInput[]>, default: undefined },\n    columns: { type: Array as PropType<HeatmapAxisInput[]>, default: undefined },\n    startDate: { type: String, default: undefined },\n    endDate: { type: String, default: undefined },\n    levels: { type: Number, default: undefined },\n    thresholds: { type: Array as PropType<number[]>, default: undefined },\n    firstDayOfWeek: { type: Number, default: undefined },\n    locale: { type: String, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    palette: { type: String as PropType<HeatmapPalette>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n    translations: { type: Object as PropType<Partial<HeatmapTranslations>>, default: undefined },\n  },\n  // 只读事件，没有双向绑定：热力图不产生值，只报焦点与详情落在哪一格\n  emits: {\n    'cell-focus': (_details: PayloadOf<HeatmapProps, 'onCellFocus'>) => true,\n    'cell-active': (_details: PayloadOf<HeatmapProps, 'onCellActive'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: HeatmapRootSlotProps) => VNode[]\n    /** 铺开网格时每一格的内容插槽，缺省是空格子；三种形态都铺。 */\n    cell?: (props: HeatmapCellSlotProps) => VNode[]\n    /** 详情条的内容插槽；写了它才会铺出 tooltip 部件。 */\n    tooltip?: (props: HeatmapCellDetails | null) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyFocus: HeatmapProps['onCellFocus'] = details => emit('cell-focus', details)\n    const notifyActive: HeatmapProps['onCellActive'] = details => emit('cell-active', details)\n    const ctx = useHeatmap(withXhConfig('heatmap', props) as HeatmapProps, notifyFocus, notifyActive)\n    provideHeatmap(ctx)\n    return () => {\n      const api = ctx.api.value\n      return h(\n        'div',\n        api.getRootProps() as Record<string, unknown>,\n        slots.default\n          ? slots.default({\n              variant: api.variant,\n              grid: api.grid,\n              monthGrid: api.monthGrid,\n              matrixGrid: api.matrixGrid,\n              focusedCell: api.focusedCell,\n              focusedDate: api.focusedDate,\n              anchorCell: api.anchorCell,\n              anchorDate: api.anchorDate,\n              activeCell: api.activeCell,\n              detailOpen: api.detailOpen,\n              cellAt: api.cellAt,\n              setFocusedCell: api.setFocusedCell,\n              setFocusedDate: api.setFocusedDate,\n            })\n          : renderDefaultTree(api, slots.cell, slots.tooltip),\n      )\n    }\n  },\n})\n\n/** role=grid 的容器：键盘在这里收口，可及名字也长在它身上。 */\nexport const XhHeatmapGrid = defineComponent({\n  name: 'XhHeatmapGrid',\n  setup(_, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('div', ctx.api.value.getGridProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 月历形态里的一个自然月块，块内的行从这里取月份身份。 */\nexport const XhHeatmapMonthBlock = defineComponent({\n  name: 'XhHeatmapMonthBlock',\n  props: {\n    /** 月份身份 YYYY-MM。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    provideHeatmapMonth(computed(() => props.value))\n    return () => h('div', ctx.api.value.getMonthBlockProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 一行。身份写在 value 上，怎么解释由形态决定：\n * 日历形态是行序 0-6，月历形态是月内第几周，矩阵形态是行身份；不写即坐标轴那一行。\n */\nexport const XhHeatmapRow = defineComponent({\n  name: 'XhHeatmapRow',\n  props: {\n    value: { type: [Number, String] as PropType<number | string>, default: undefined },\n    /** 月历形态：所属月份 YYYY-MM；写在月块里就不必再写一遍。 */\n    month: { type: String, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const blockMonth = useHeatmapMonth()\n    const row = computed<HeatmapRowProps>(() => {\n      const variant = ctx.api.value.variant\n      if (variant === 'matrix')\n        return { row: stringOf(props.value) }\n      if (variant === 'month')\n        return { month: props.month ?? blockMonth?.value, week: numberOf(props.value) }\n      return { weekDay: numberOf(props.value) }\n    })\n    provideHeatmapRow(computed(() => row.value.row))\n    return () => h('div', ctx.api.value.getRowProps(row.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 行首的星期名。不给行序即坐标轴那一行行首的占位，它只负责让月份与格子对齐。 */\nexport const XhHeatmapWeekDayLabel = defineComponent({\n  name: 'XhHeatmapWeekDayLabel',\n  props: {\n    value: { type: [Number, String] as PropType<number | string>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const weekDay = computed(() => numberOf(props.value))\n    return () => h('span', ctx.api.value.getWeekDayLabelProps({ weekDay: weekDay.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 月份名。日历形态里横跨这个月占的那几列，月历形态里是一块的标题。 */\nexport const XhHeatmapMonthLabel = defineComponent({\n  name: 'XhHeatmapMonthLabel',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getMonthLabelProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 矩阵的行名。不写 value 即表头行行首那个角落占位。 */\nexport const XhHeatmapRowLabel = defineComponent({\n  name: 'XhHeatmapRowLabel',\n  props: {\n    value: { type: String, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getRowLabelProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 矩阵的列名。 */\nexport const XhHeatmapColumnLabel = defineComponent({\n  name: 'XhHeatmapColumnLabel',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getColumnLabelProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 一格。日期形态里 value 是 ISO 日期，矩阵形态里 value 是列身份、\n * 行身份从所在的行取（也可以写在 row 上）。数值与档位由 connect 回网格里查。\n */\nexport const XhHeatmapCell = defineComponent({\n  name: 'XhHeatmapCell',\n  props: {\n    value: { type: String, required: true },\n    /** 矩阵形态：行身份；写在行里就不必再写一遍。 */\n    row: { type: String, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const parentRow = useHeatmapRow()\n    const cell = computed(() => ctx.api.value.variant === 'matrix'\n      ? { row: props.row ?? parentRow?.value, column: props.value }\n      : { date: props.value })\n    return () => h('div', ctx.api.value.getCellProps(cell.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 详情条：悬停或聚焦到某一格时显示，位置由连接层量好写成内联样式。 */\nexport const XhHeatmapTooltip = defineComponent({\n  name: 'XhHeatmapTooltip',\n  setup(_, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('div', ctx.api.value.getTooltipProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 色阶对照条。 */\nexport const XhHeatmapLegend = defineComponent({\n  name: 'XhHeatmapLegend',\n  setup(_, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('div', ctx.api.value.getLegendProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 对照条一端的那个字：value 写 low 或 high，文字从 api.legendText 取。 */\nexport const XhHeatmapLegendLabel = defineComponent({\n  name: 'XhHeatmapLegendLabel',\n  props: {\n    /** 挂在哪一端：low 是色阶起点，high 是终点。 */\n    value: { type: String as PropType<HeatmapLegendBound>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getLegendLabelProps({ bound: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 对照条里的一格，与网格里同档的格子同色。 */\nexport const XhHeatmapLegendItem = defineComponent({\n  name: 'XhHeatmapLegendItem',\n  props: {\n    /** 档位，兼收字符串。 */\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const level = computed(() => Number(props.value) || 0)\n    return () => h('span', ctx.api.value.getLegendItemProps({ level: level.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 没写默认插槽时按网格模型铺开的整套结构，作者只交数据。\n * 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。\n * 详情条只有写了 tooltip 插槽才铺，不写时整棵树与从前逐字一致。\n */\nfunction renderDefaultTree(\n  api: HeatmapApi,\n  cellSlot?: (node: HeatmapCellSlotProps) => VNode[],\n  tooltipSlot?: (details: HeatmapCellDetails | null) => VNode[],\n): VNode[] {\n  // 两端各一个字：一排色块自己说不出哪头是多\n  const legend = h(\n    XhHeatmapLegend,\n    null,\n    () => [\n      h(XhHeatmapLegendLabel, { value: 'low' }, () => api.legendText.low),\n      ...Array.from(\n        { length: api.monthGrid?.levels ?? api.matrixGrid?.levels ?? api.grid.levels },\n        (_, level) => h(XhHeatmapLegendItem, { key: level, value: level }),\n      ),\n      h(XhHeatmapLegendLabel, { value: 'high' }, () => api.legendText.high),\n    ],\n  )\n  const tooltip = tooltipSlot\n    ? [h(XhHeatmapTooltip, null, () => tooltipSlot(api.activeCell))]\n    : []\n\n  if (api.matrixGrid)\n    return [...renderMatrixTree(api.matrixGrid, cellSlot), ...tooltip, legend]\n  if (api.monthGrid)\n    return [...renderMonthTree(api.monthGrid, cellSlot), ...tooltip, legend]\n\n  // 月份行排在网格之外：它只是一条对齐用的坐标轴，进了网格就得冒充表格行\n  const monthRow = h(XhHeatmapRow, null, () => [\n    // 行首占位：与下面各行的星期名同宽，月份才对得上列\n    h(XhHeatmapWeekDayLabel),\n    ...api.grid.months.map(month => h(XhHeatmapMonthLabel, { key: month.value, value: month.value }, () => month.label)),\n  ])\n  const weekRows = api.grid.rows.map(row => h(XhHeatmapRow, { key: row.weekDay, value: row.weekDay }, () => [\n    h(XhHeatmapWeekDayLabel, { value: row.weekDay }, () => api.grid.weekDays[row.weekDay]?.label ?? ''),\n    ...row.cells.map(cell => h(XhHeatmapCell, { key: cell.date, value: cell.date }, () => cellSlot?.(cell) ?? [])),\n  ]))\n  return [monthRow, h(XhHeatmapGrid, null, () => weekRows), ...tooltip, legend]\n}\n\n/** 月历形态：网格里一个自然月一块，块内先一条星期名坐标轴，再逐周一行。 */\nfunction renderMonthTree(grid: HeatmapMonthGrid, cellSlot?: (node: HeatmapCellSlotProps) => VNode[]): VNode[] {\n  const blocks = grid.blocks.map(block => h(XhHeatmapMonthBlock, { key: block.value, value: block.value }, () => [\n    h(XhHeatmapMonthLabel, { value: block.value }, () => block.label),\n    h(XhHeatmapRow, null, () => grid.weekDays.map(day =>\n      h(XhHeatmapWeekDayLabel, { key: day.weekDay, value: day.weekDay }, () => day.label))),\n    ...block.weeks.map(row => h(XhHeatmapRow, { key: row.week, value: row.week }, () =>\n      row.cells.map(cell => h(XhHeatmapCell, { key: cell.date, value: cell.date }, () => cellSlot?.(cell) ?? [])))),\n  ]))\n  return [h(XhHeatmapGrid, null, () => blocks)]\n}\n\n/** 矩阵形态：头一行是列名，其余每行行首一个行名、其后逐列一格。 */\nfunction renderMatrixTree(grid: HeatmapMatrixGrid, cellSlot?: (node: HeatmapCellSlotProps) => VNode[]): VNode[] {\n  const header = h(XhHeatmapRow, null, () => [\n    // 角落占位：与下面各行的行名同宽，列名才对得上列\n    h(XhHeatmapRowLabel),\n    ...grid.columns.map(column => h(XhHeatmapColumnLabel, { key: column.value, value: column.value }, () => column.label)),\n  ])\n  const rows = grid.rows.map(row => h(XhHeatmapRow, { key: row.value, value: row.value }, () => [\n    h(XhHeatmapRowLabel, { value: row.value }, () => row.label),\n    ...grid.columns.map((column) => {\n      const meta = grid.cells.get(heatmapMatrixKey(row.value, column.value))\n      return h(\n        XhHeatmapCell,\n        { key: column.value, value: column.value },\n        () => (meta == null ? [] : cellSlot?.(meta) ?? []),\n      )\n    }),\n  ]))\n  return [h(XhHeatmapGrid, null, () => [header, ...rows])]\n}\n\n/** 作者写的数字身份，兼收字符串；没写即 undefined。 */\nfunction numberOf(value: number | string | undefined): number | undefined {\n  if (value == null || value === '')\n    return undefined\n  const parsed = Number(value)\n  return Number.isFinite(parsed) ? parsed : undefined\n}\n\n/** 作者写的串身份；没写即 undefined。 */\nfunction stringOf(value: number | string | undefined): string | undefined {\n  if (value == null || value === '')\n    return undefined\n  return String(value)\n}\n"],"mappings":"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"}
+{"version":3,"file":"heatmap.js","names":[],"sources":["../../../src/components/heatmap/heatmap.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// 提供 heatmap 相关实现。\n\nimport type { Direction, Size, Tone } from '@xihan-ui/core'\nimport type {\n  HeatmapApi,\n  HeatmapAxisInput,\n  HeatmapCellDetails,\n  HeatmapCellMeta,\n  HeatmapLegendBound,\n  HeatmapMatrixCellMeta,\n  HeatmapMatrixGrid,\n  HeatmapMonthGrid,\n  HeatmapPalette,\n  HeatmapRowProps,\n  HeatmapSchema,\n  HeatmapTranslations,\n  HeatmapValue,\n  HeatmapVariant,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { heatmapMatrixKey, normalizeHeatmapNumber, normalizeHeatmapString } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport {\n  provideHeatmap,\n  provideHeatmapMonth,\n  provideHeatmapRow,\n  useHeatmapContext,\n  useHeatmapMonth,\n  useHeatmapRow,\n} from './context'\nimport { useHeatmap } from './use-heatmap'\n\ntype HeatmapProps = HeatmapSchema['props']\n\n/**\n * 默认插槽的载荷：三张网格模型与锚点、当前详情，以及移动锚点的动作。\n * 三形态通用的一组（`focusedCell` / `anchorCell` / `setFocusedCell`）也包含在内：\n * 矩阵形态下带 Date 的一组恒为 null，自行铺设矩阵时只有这一组能读取、移动锚点。\n */\nexport type HeatmapRootSlotProps = Pick<\n  HeatmapApi,\n  | 'variant'\n  | 'grid'\n  | 'monthGrid'\n  | 'matrixGrid'\n  | 'focusedCell'\n  | 'focusedDate'\n  | 'anchorCell'\n  | 'anchorDate'\n  | 'activeCell'\n  | 'detailOpen'\n  | 'cellAt'\n  | 'setFocusedCell'\n  | 'setFocusedDate'\n>\n\n/**\n * `cell` 插槽的载荷：日期形态给日历的格子，矩阵形态给矩阵的格子。\n * 两者的坐标不同，用 `'date' in cell` 区分。\n */\nexport type HeatmapCellSlotProps = HeatmapCellMeta | HeatmapMatrixCellMeta\n\nexport const XhHeatmapRoot = defineComponent({\n  name: 'XhHeatmapRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    variant: { type: String as PropType<HeatmapVariant> },\n    value: { type: Array as PropType<HeatmapValue[]> },\n    rows: { type: Array as PropType<HeatmapAxisInput[]> },\n    columns: { type: Array as PropType<HeatmapAxisInput[]> },\n    startDate: { type: String },\n    endDate: { type: String },\n    levels: { type: Number },\n    thresholds: { type: Array as PropType<number[]> },\n    firstDayOfWeek: { type: Number },\n    locale: { type: String },\n    dir: { type: String as PropType<Direction> },\n    tone: { type: String as PropType<Tone> },\n    palette: { type: String as PropType<HeatmapPalette> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<HeatmapTranslations>> },\n  },\n  // 只读事件，没有双向绑定：热力图不产生值，只报焦点与详情落在哪一格\n  emits: {\n    'cell-focus': (_details: PayloadOf<HeatmapProps, 'onCellFocus'>) => true,\n    'cell-active': (_details: PayloadOf<HeatmapProps, 'onCellActive'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: HeatmapRootSlotProps) => VNode[]\n    /** 铺开网格时每一格的内容插槽，默认是空格子；三种形态都铺设。 */\n    cell?: (props: HeatmapCellSlotProps) => VNode[]\n    /** 详情条的内容插槽；写了它才会铺设 tooltip 部件。 */\n    tooltip?: (props: HeatmapCellDetails | null) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyFocus: HeatmapProps['onCellFocus'] = details => emit('cell-focus', details)\n    const notifyActive: HeatmapProps['onCellActive'] = details => emit('cell-active', details)\n    const ctx = useHeatmap(withXhConfig('heatmap', props) as HeatmapProps, notifyFocus, notifyActive)\n    provideHeatmap(ctx)\n    return () => {\n      const api = ctx.api.value\n      return h(\n        'div',\n        api.getRootProps() as Record<string, unknown>,\n        slots.default\n          ? slots.default({\n              variant: api.variant,\n              grid: api.grid,\n              monthGrid: api.monthGrid,\n              matrixGrid: api.matrixGrid,\n              focusedCell: api.focusedCell,\n              focusedDate: api.focusedDate,\n              anchorCell: api.anchorCell,\n              anchorDate: api.anchorDate,\n              activeCell: api.activeCell,\n              detailOpen: api.detailOpen,\n              cellAt: api.cellAt,\n              setFocusedCell: api.setFocusedCell,\n              setFocusedDate: api.setFocusedDate,\n            })\n          : renderDefaultTree(api, slots.cell, slots.tooltip),\n      )\n    }\n  },\n})\n\n/** role=grid 的容器：键盘在这里收口，可及名字也挂在它上面。 */\nexport const XhHeatmapGrid = defineComponent({\n  name: 'XhHeatmapGrid',\n  setup(_, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('div', ctx.api.value.getGridProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 月历形态中的一个自然月块，块内的行从这里取月份身份。 */\nexport const XhHeatmapMonthBlock = defineComponent({\n  name: 'XhHeatmapMonthBlock',\n  props: {\n    /** 月份身份 YYYY-MM。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    provideHeatmapMonth(computed(() => props.value))\n    return () => h('div', ctx.api.value.getMonthBlockProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 一行。身份写在 value 上，解释方式由形态决定：\n * 日历形态是行序 0-6，月历形态是月内第几周，矩阵形态是行身份；未写即坐标轴行。\n */\nexport const XhHeatmapRow = defineComponent({\n  name: 'XhHeatmapRow',\n  props: {\n    value: { type: [Number, String] as PropType<number | string> },\n    /** 月历形态：所属月份 YYYY-MM；写在月块中时不必再写一遍。 */\n    month: { type: String },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const blockMonth = useHeatmapMonth()\n    const row = computed<HeatmapRowProps>(() => {\n      const variant = ctx.api.value.variant\n      if (variant === 'matrix')\n        return { row: normalizeHeatmapString(props.value) }\n      if (variant === 'month')\n        return { month: props.month ?? blockMonth?.value, week: normalizeHeatmapNumber(props.value) }\n      return { weekDay: normalizeHeatmapNumber(props.value) }\n    })\n    provideHeatmapRow(computed(() => row.value.row))\n    return () => h('div', ctx.api.value.getRowProps(row.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 行首的星期名。未提供行序即坐标轴行行首的占位，它只负责让月份与格子对齐。 */\nexport const XhHeatmapWeekDay = defineComponent({\n  name: 'XhHeatmapWeekDay',\n  props: {\n    value: { type: [Number, String] as PropType<number | string> },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const weekDay = computed(() => normalizeHeatmapNumber(props.value))\n    return () => h('span', ctx.api.value.getWeekDayProps({ weekDay: weekDay.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 月份名。日历形态中横跨该月所占的列，月历形态中是一块的标题。 */\nexport const XhHeatmapMonthLabel = defineComponent({\n  name: 'XhHeatmapMonthLabel',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getMonthLabelProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 矩阵的行名。未写 value 即表头行行首的角落占位。 */\nexport const XhHeatmapRowLabel = defineComponent({\n  name: 'XhHeatmapRowLabel',\n  props: {\n    value: { type: String },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getRowLabelProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 矩阵的列名。 */\nexport const XhHeatmapColumnLabel = defineComponent({\n  name: 'XhHeatmapColumnLabel',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getColumnLabelProps({ value: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 一格。日期形态中 value 是 ISO 日期，矩阵形态中 value 是列身份、\n * 行身份从所在的行取（也可以写在 row 上）。数值与档位由 connect 查询网格。\n */\nexport const XhHeatmapCell = defineComponent({\n  name: 'XhHeatmapCell',\n  props: {\n    value: { type: String, required: true },\n    /** 矩阵形态：行身份；写在行中时不必再写一遍。 */\n    row: { type: String },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const parentRow = useHeatmapRow()\n    const cell = computed(() => ctx.api.value.variant === 'matrix'\n      ? { row: props.row ?? parentRow?.value, column: props.value }\n      : { date: props.value })\n    return () => h('div', ctx.api.value.getCellProps(cell.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 详情条：悬停或聚焦到某一格时显示，位置由连接层测量后写为内联样式。 */\nexport const XhHeatmapTooltip = defineComponent({\n  name: 'XhHeatmapTooltip',\n  setup(_, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('div', ctx.api.value.getTooltipProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 色阶对照条。 */\nexport const XhHeatmapLegend = defineComponent({\n  name: 'XhHeatmapLegend',\n  setup(_, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('div', ctx.api.value.getLegendProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 对照条一端的文字：value 写 low 或 high，文字从 api.legendText 取。 */\nexport const XhHeatmapLegendLabel = defineComponent({\n  name: 'XhHeatmapLegendLabel',\n  props: {\n    /** 挂在哪一端：low 是色阶起点，high 是终点。 */\n    value: { type: String as PropType<HeatmapLegendBound>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    return () => h('span', ctx.api.value.getLegendLabelProps({ bound: props.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 对照条中的一格，与网格中同档的格子同色。 */\nexport const XhHeatmapLegendItem = defineComponent({\n  name: 'XhHeatmapLegendItem',\n  props: {\n    /** 档位，兼收字符串。 */\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useHeatmapContext()\n    const level = computed(() => Number(props.value) || 0)\n    return () => h('span', ctx.api.value.getLegendItemProps({ level: level.value }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按网格模型铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * 详情条只有写了 tooltip 插槽才铺设，未写时整棵树与从前逐字一致。\n */\nfunction renderDefaultTree(\n  api: HeatmapApi,\n  cellSlot?: (node: HeatmapCellSlotProps) => VNode[],\n  tooltipSlot?: (details: HeatmapCellDetails | null) => VNode[],\n): VNode[] {\n  // 两端各一个字：一排色块自己说不出哪头是多\n  const legend = h(\n    XhHeatmapLegend,\n    null,\n    () => [\n      h(XhHeatmapLegendLabel, { value: 'low' }, () => api.legendText.low),\n      ...Array.from(\n        { length: api.monthGrid?.levels ?? api.matrixGrid?.levels ?? api.grid.levels },\n        (_, level) => h(XhHeatmapLegendItem, { key: level, value: level }),\n      ),\n      h(XhHeatmapLegendLabel, { value: 'high' }, () => api.legendText.high),\n    ],\n  )\n  const tooltip = tooltipSlot\n    ? [h(XhHeatmapTooltip, null, () => tooltipSlot(api.activeCell))]\n    : []\n\n  if (api.matrixGrid)\n    return [...renderMatrixTree(api.matrixGrid, cellSlot), ...tooltip, legend]\n  if (api.monthGrid)\n    return [...renderMonthTree(api.monthGrid, cellSlot), ...tooltip, legend]\n\n  // 月份行排在网格之外：它只是一条对齐用的坐标轴，进了网格就得冒充表格行\n  const monthRow = h(XhHeatmapRow, null, () => [\n    // 行首占位：与下面各行的星期名同宽，月份才对得上列\n    h(XhHeatmapWeekDay),\n    ...api.grid.months.map(month => h(XhHeatmapMonthLabel, { key: month.value, value: month.value }, () => month.label)),\n  ])\n  const weekRows = api.grid.rows.map(row => h(XhHeatmapRow, { key: row.weekDay, value: row.weekDay }, () => [\n    h(XhHeatmapWeekDay, { value: row.weekDay }, () => api.grid.weekDays[row.weekDay]?.label ?? ''),\n    ...row.cells.map(cell => h(XhHeatmapCell, { key: cell.date, value: cell.date }, () => cellSlot?.(cell) ?? [])),\n  ]))\n  return [monthRow, h(XhHeatmapGrid, null, () => weekRows), ...tooltip, legend]\n}\n\n/** 月历形态：网格中一个自然月一块，块内先一条星期名坐标轴，再逐周一行。 */\nfunction renderMonthTree(grid: HeatmapMonthGrid, cellSlot?: (node: HeatmapCellSlotProps) => VNode[]): VNode[] {\n  const blocks = grid.blocks.map(block => h(XhHeatmapMonthBlock, { key: block.value, value: block.value }, () => [\n    h(XhHeatmapMonthLabel, { value: block.value }, () => block.label),\n    h(XhHeatmapRow, null, () => grid.weekDays.map(day =>\n      h(XhHeatmapWeekDay, { key: day.weekDay, value: day.weekDay }, () => day.label))),\n    ...block.weeks.map(row => h(XhHeatmapRow, { key: row.week, value: row.week }, () =>\n      row.cells.map(cell => h(XhHeatmapCell, { key: cell.date, value: cell.date }, () => cellSlot?.(cell) ?? [])))),\n  ]))\n  return [h(XhHeatmapGrid, null, () => blocks)]\n}\n\n/** 矩阵形态：首行是列名，其余每行行首一个行名、其后逐列一格。 */\nfunction renderMatrixTree(grid: HeatmapMatrixGrid, cellSlot?: (node: HeatmapCellSlotProps) => VNode[]): VNode[] {\n  const header = h(XhHeatmapRow, null, () => [\n    // 角落占位：与下面各行的行名同宽，列名才对得上列\n    h(XhHeatmapRowLabel),\n    ...grid.columns.map(column => h(XhHeatmapColumnLabel, { key: column.value, value: column.value }, () => column.label)),\n  ])\n  const rows = grid.rows.map(row => h(XhHeatmapRow, { key: row.value, value: row.value }, () => [\n    h(XhHeatmapRowLabel, { value: row.value }, () => row.label),\n    ...grid.columns.map((column) => {\n      const meta = grid.cells.get(heatmapMatrixKey(row.value, column.value))\n      return h(\n        XhHeatmapCell,\n        { key: column.value, value: column.value },\n        () => (meta == null ? [] : cellSlot?.(meta) ?? []),\n      )\n    }),\n  ]))\n  return [h(XhHeatmapGrid, null, () => [header, ...rows])]\n}\n"],"mappings":"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"}

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

@@ -1,10 +1,10 @@
 import { ComputedRef } from "vue";
+import { Service } from "@xihan-ui/core";
 import { HeatmapApi, HeatmapSchema } from "@xihan-ui/headless";
-import { Service } from "@xihan-ui/machine";
 //#region src/components/heatmap/use-heatmap.d.ts
 interface HeatmapContext {
   api: ComputedRef<HeatmapApi>;
-  /** 机器实例，供部件上报 DOM 侧的事实。 */
+  /** 状态机实例，供部件上报 DOM 侧的事实。 */
   service: Service<HeatmapSchema>;
 }
 declare function useHeatmap(props: HeatmapSchema['props'], onCellFocus?: HeatmapSchema['props']['onCellFocus'], onCellActive?: HeatmapSchema['props']['onCellActive']): HeatmapContext;

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

@@ -1 +1 @@
-{"version":3,"file":"use-heatmap.d.ts","names":[],"sources":["../../../src/components/heatmap/use-heatmap.ts"],"mappings":";;;;UAQiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAIH,WACd,OAAO,wBACP,cAAc,uCACd,eAAe,yCACd"}
+{"version":3,"file":"use-heatmap.d.ts","names":[],"sources":["../../../src/components/heatmap/use-heatmap.ts"],"mappings":";;;;UAeiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAIH,WACd,OAAO,wBACP,cAAc,uCACd,eAAe,yCACd"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-heatmap.js","names":[],"sources":["../../../src/components/heatmap/use-heatmap.ts"],"sourcesContent":["import type { HeatmapApi, HeatmapSchema } from '@xihan-ui/headless'\nimport type { Service } from '@xihan-ui/machine'\nimport type { ComputedRef } from 'vue'\nimport { connectHeatmap, heatmapMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface HeatmapContext {\n  api: ComputedRef<HeatmapApi>\n  /** 机器实例，供部件上报 DOM 侧的事实。 */\n  service: Service<HeatmapSchema>\n}\n\n// 不建 scope：connect 不派生任何 id\nexport function useHeatmap(\n  props: HeatmapSchema['props'],\n  onCellFocus?: HeatmapSchema['props']['onCellFocus'],\n  onCellActive?: HeatmapSchema['props']['onCellActive'],\n): HeatmapContext {\n  const service = useMachine(heatmapMachine, () => ({ ...props, onCellFocus, onCellActive }))\n  const api = computed(() => connectHeatmap(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;AAeA,SAAgB,WACd,OACA,aACA,cACgB;CAChB,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO;EAAa;CAAa,EAAE;CAE1F,OAAO;EAAE,KADG,eAAe,eAAe,SAAS,YAAY,CACpD;EAAG;CAAQ;AACxB"}
+{"version":3,"file":"use-heatmap.js","names":[],"sources":["../../../src/components/heatmap/use-heatmap.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 heatmap 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { HeatmapApi, HeatmapSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectHeatmap, heatmapMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface HeatmapContext {\n  api: ComputedRef<HeatmapApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实。 */\n  service: Service<HeatmapSchema>\n}\n\n// 不建 scope：connect 不派生任何 id\nexport function useHeatmap(\n  props: HeatmapSchema['props'],\n  onCellFocus?: HeatmapSchema['props']['onCellFocus'],\n  onCellActive?: HeatmapSchema['props']['onCellActive'],\n): HeatmapContext {\n  const service = useMachine(heatmapMachine, () => ({ ...props, onCellFocus, onCellActive }))\n  const api = computed(() => connectHeatmap(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;AAsBA,SAAgB,WACd,OACA,aACA,cACgB;CAChB,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO;EAAa;CAAa,EAAE;CAE1F,OAAO;EAAE,KADG,eAAe,eAAe,SAAS,YAAY,CACpD;EAAG;CAAQ;AACxB"}

package/dist/components/highlight/highlight.d.ts

@@ -1,37 +1,38 @@
 import { PropType } from "vue";
+import { Tone } from "@xihan-ui/core";
 //#region src/components/highlight/highlight.d.ts
 /**
- * 把 text 按 keyword 切段铺进一个 `<span>`：命中的片段渲染成 `<mark>`，其余是纯文本节点。
+ * 把 text 按 keyword 切段铺进一个 `<span>`：命中的片段渲染为 `<mark>`，其余是纯文本节点。
  *
- * 整段内容由 text 与 keyword 算出，组件不收默认插槽——命中位置是按 text 这个串
- * 逐字符算的，内容另有来源就对不上了。
+ * 整段内容由 text 与 keyword 计算得出，组件不接收默认插槽：命中位置是按 text 这个串
+ * 逐字符计算的，内容另有来源时无法对应。
  */
 declare const XhHighlight: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   text: {
     type: StringConstructor;
-    default: undefined;
   };
   keyword: {
     type: PropType<string | readonly string[]>;
-    default: undefined;
   };
   caseSensitive: BooleanConstructor;
+  tone: {
+    type: PropType<Tone>;
+  };
 }>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   text: {
     type: StringConstructor;
-    default: undefined;
   };
   keyword: {
     type: PropType<string | readonly string[]>;
-    default: undefined;
   };
   caseSensitive: BooleanConstructor;
+  tone: {
+    type: PropType<Tone>;
+  };
 }>> & Readonly<{}>, {
-  text: string;
   caseSensitive: boolean;
-  keyword: string | readonly string[];
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
 export { XhHighlight };

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

@@ -1 +1 @@
-{"version":3,"file":"highlight.d.ts","names":[],"sources":["../../../src/components/highlight/highlight.ts"],"mappings":";;;;;;;;cAYa,2BAAW,8BAAA;;;;;;IAKgB,MAAA;;;;;;;;;;;;IAAA,MAAA;;;;;;;;qCAmBtC"}
+{"version":3,"file":"highlight.d.ts","names":[],"sources":["../../../src/components/highlight/highlight.ts"],"mappings":";;;;;;;;;cAoBa,2BAAW,8BAAA;;;;;IAKgB,MAAA;;;;IAEZ,MAAA,SAAS;;;;;;;;;IAFG,MAAA;;;;IAEZ,MAAA,SAAS;;;;qCAmBnC"}

package/dist/components/highlight/highlight.js

@@ -3,29 +3,25 @@ import { computed, defineComponent, h } from "vue";
 import { connectHighlight } from "@xihan-ui/headless";
 //#region src/components/highlight/highlight.ts
 /**
-* 把 text 按 keyword 切段铺进一个 `<span>`：命中的片段渲染成 `<mark>`，其余是纯文本节点。
+* 把 text 按 keyword 切段铺进一个 `<span>`：命中的片段渲染为 `<mark>`，其余是纯文本节点。
 *
-* 整段内容由 text 与 keyword 算出，组件不收默认插槽——命中位置是按 text 这个串
-* 逐字符算的，内容另有来源就对不上了。
+* 整段内容由 text 与 keyword 计算得出，组件不接收默认插槽：命中位置是按 text 这个串
+* 逐字符计算的，内容另有来源时无法对应。
 */
 const XhHighlight = defineComponent({
 	name: "XhHighlight",
 	props: {
-		text: {
-			type: String,
-			default: void 0
-		},
-		keyword: {
-			type: [String, Array],
-			default: void 0
-		},
-		caseSensitive: Boolean
+		text: { type: String },
+		keyword: { type: [String, Array] },
+		caseSensitive: Boolean,
+		tone: { type: String }
 	},
 	setup(props) {
 		const api = computed(() => connectHighlight({
 			text: props.text,
 			keyword: props.keyword,
-			caseSensitive: props.caseSensitive
+			caseSensitive: props.caseSensitive,
+			tone: props.tone
 		}, vueNormalize));
 		return () => {
 			const current = api.value;

package/dist/components/highlight/highlight.js.map

@@ -1 +1 @@
-{"version":3,"file":"highlight.js","names":[],"sources":["../../../src/components/highlight/highlight.ts"],"sourcesContent":["import type { HighlightProps } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectHighlight } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\n\n/**\n * 把 text 按 keyword 切段铺进一个 `<span>`：命中的片段渲染成 `<mark>`，其余是纯文本节点。\n *\n * 整段内容由 text 与 keyword 算出，组件不收默认插槽——命中位置是按 text 这个串\n * 逐字符算的，内容另有来源就对不上了。\n */\nexport const XhHighlight = defineComponent({\n  name: 'XhHighlight',\n  // 缺省值由 connect 给出，这里一律 default: undefined\n  props: {\n    text: { type: String, default: undefined },\n    keyword: { type: [String, Array] as PropType<string | readonly string[]>, default: undefined },\n    caseSensitive: Boolean,\n  },\n  setup(props) {\n    const api = computed(() => connectHighlight({\n      text: props.text,\n      keyword: props.keyword,\n      caseSensitive: props.caseSensitive,\n    } satisfies HighlightProps, vueNormalize))\n\n    return () => {\n      const current = api.value\n      const markProps = current.getMarkProps() as Record<string, unknown>\n      // 片段每次整份重算，按位置替换即可，不给 key：一半是元素、一半是纯文本，\n      // 给了 key 反而要求两种节点在同一条列表里对上号\n      return h('span', current.getRootProps() as Record<string, unknown>, current.segments.map(segment =>\n        segment.matched ? h('mark', markProps, segment.text) : segment.text))\n    }\n  },\n})\n"],"mappings":";;;;;;;;;;AAYA,MAAa,cAAc,gBAAgB;CACzC,MAAM;CAEN,OAAO;EACL,MAAM;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACzC,SAAS;GAAE,MAAM,CAAC,QAAQ,KAAK;GAA2C,SAAS,KAAA;EAAU;EAC7F,eAAe;CACjB;CACA,MAAM,OAAO;EACX,MAAM,MAAM,eAAe,iBAAiB;GAC1C,MAAM,MAAM;GACZ,SAAS,MAAM;GACf,eAAe,MAAM;EACvB,GAA4B,YAAY,CAAC;EAEzC,aAAa;GACX,MAAM,UAAU,IAAI;GACpB,MAAM,YAAY,QAAQ,aAAa;GAGvC,OAAO,EAAE,QAAQ,QAAQ,aAAa,GAA8B,QAAQ,SAAS,KAAI,YACvF,QAAQ,UAAU,EAAE,QAAQ,WAAW,QAAQ,IAAI,IAAI,QAAQ,IAAI,CAAC;EACxE;CACF;AACF,CAAC"}
+{"version":3,"file":"highlight.js","names":[],"sources":["../../../src/components/highlight/highlight.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// 提供 highlight 相关实现。\n\nimport type { Tone } from '@xihan-ui/core'\nimport type { HighlightProps } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectHighlight } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\n\n/**\n * 把 text 按 keyword 切段铺进一个 `<span>`：命中的片段渲染为 `<mark>`，其余是纯文本节点。\n *\n * 整段内容由 text 与 keyword 计算得出，组件不接收默认插槽：命中位置是按 text 这个串\n * 逐字符计算的，内容另有来源时无法对应。\n */\nexport const XhHighlight = defineComponent({\n  name: 'XhHighlight',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    text: { type: String },\n    keyword: { type: [String, Array] as PropType<string | readonly string[]> },\n    caseSensitive: Boolean,\n    tone: { type: String as PropType<Tone> },\n  },\n  setup(props) {\n    const api = computed(() => connectHighlight({\n      text: props.text,\n      keyword: props.keyword,\n      caseSensitive: props.caseSensitive,\n      tone: props.tone,\n    } satisfies HighlightProps, vueNormalize))\n\n    return () => {\n      const current = api.value\n      const markProps = current.getMarkProps() as Record<string, unknown>\n      // 片段每次整份重算，按位置替换即可，不给 key：一半是元素、一半是纯文本，\n      // 给了 key 反而要求两种节点在同一条列表里对上号\n      return h('span', current.getRootProps() as Record<string, unknown>, current.segments.map(segment =>\n        segment.matched ? h('mark', markProps, segment.text) : segment.text))\n    }\n  },\n})\n"],"mappings":";;;;;;;;;;AAoBA,MAAa,cAAc,gBAAgB;CACzC,MAAM;CAEN,OAAO;EACL,MAAM,EAAE,MAAM,OAAO;EACrB,SAAS,EAAE,MAAM,CAAC,QAAQ,KAAK,EAA0C;EACzE,eAAe;EACf,MAAM,EAAE,MAAM,OAAyB;CACzC;CACA,MAAM,OAAO;EACX,MAAM,MAAM,eAAe,iBAAiB;GAC1C,MAAM,MAAM;GACZ,SAAS,MAAM;GACf,eAAe,MAAM;GACrB,MAAM,MAAM;EACd,GAA4B,YAAY,CAAC;EAEzC,aAAa;GACX,MAAM,UAAU,IAAI;GACpB,MAAM,YAAY,QAAQ,aAAa;GAGvC,OAAO,EAAE,QAAQ,QAAQ,aAAa,GAA8B,QAAQ,SAAS,KAAI,YACvF,QAAQ,UAAU,EAAE,QAAQ,WAAW,QAAQ,IAAI,IAAI,QAAQ,IAAI,CAAC;EACxE;CACF;AACF,CAAC"}

package/dist/components/hover-card/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/hover-card/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { HoverCardContext } from './use-hover-card'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<HoverCardContext> = Symbol.for('xh-hover-card')\n\nexport function provideHoverCard(ctx: HoverCardContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useHoverCardContext(): HoverCardContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] HoverCard 部件必须用在 XhHoverCardRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAsC,OAAO,IAAI,eAAe;AAEtE,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,yCAAyC;CAC3D,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/hover-card/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { InjectionKey } from 'vue'\nimport type { HoverCardContext } from './use-hover-card'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<HoverCardContext> = Symbol.for('xh-hover-card')\n\nexport function provideHoverCard(ctx: HoverCardContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useHoverCardContext(): HoverCardContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] HoverCard 部件必须用在 XhHoverCardRoot 内')\n  return ctx\n}\n"],"mappings":";;AAWA,MAAM,MAAsC,OAAO,IAAI,eAAe;AAEtE,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,yCAAyC;CAC3D,OAAO;AACT"}

package/dist/components/hover-card/hover-card.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
+import { Direction, Placement, Size } from "@xihan-ui/core";
 import { HoverCardApi, HoverCardSchema } from "@xihan-ui/headless";
-import { Direction, Placement, Size } from "@xihan-ui/kernel";
 //#region src/components/hover-card/hover-card.d.ts
 type HoverCardProps = HoverCardSchema['props'];
 /** 默认插槽的载荷：浮层的开合状态与程序化开合的方法。 */
@@ -14,28 +14,22 @@ declare const XhHoverCardRoot: import("vue").DefineComponent<import("vue").Extra
   defaultOpen: BooleanConstructor;
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   openDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   closeDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   disabled: BooleanConstructor;
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -50,65 +44,69 @@ declare const XhHoverCardRoot: import("vue").DefineComponent<import("vue").Extra
   defaultOpen: BooleanConstructor;
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   openDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   closeDelay: {
     type: NumberConstructor;
-    default: undefined;
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   disabled: BooleanConstructor;
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
 }>> & Readonly<{
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").HoverCardOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
 }>, {
-  dir: Direction;
-  size: Size;
   disabled: boolean;
-  offset: number;
   open: boolean;
   defaultOpen: boolean;
-  placement: Placement;
-  openDelay: number;
-  closeDelay: number;
 }, SlotsType<{
   default?: (props: HoverCardRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhHoverCardTrigger: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
   asChild: BooleanConstructor;
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
   asChild: BooleanConstructor;
 }>> & Readonly<{}>, {
   asChild: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhHoverCardPositioner: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhHoverCardPositioner: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 本实例的 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
-}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 本实例的 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhHoverCardContent: 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 XhHoverCardTitle: 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 XhHoverCardDescription: 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 XhHoverCardArrow: 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 { HoverCardRootSlotProps, XhHoverCardArrow, XhHoverCardContent, XhHoverCardPositioner, XhHoverCardRoot, XhHoverCardTrigger };
+export { HoverCardRootSlotProps, XhHoverCardArrow, XhHoverCardContent, XhHoverCardDescription, XhHoverCardPositioner, XhHoverCardRoot, XhHoverCardTitle, XhHoverCardTrigger };
 //# sourceMappingURL=hover-card.d.ts.map

package/dist/components/hover-card/hover-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hover-card.d.ts","names":[],"sources":["../../../src/components/hover-card/hover-card.ts"],"mappings":";;;;;KAUK,iBAAiB;;KAGV,yBAAyB,KAAK;cAE7B,+BAAe,8BAAA;;;;;;;IAMK,MAAA,SAAS;;;;;;;;;;;;;;;;IAIf,MAAA,SAAS;;;;;IAER,MAAA,SAAS;;;;;;EAIP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;IAXJ,MAAA,SAAS;;;;;;;;;;;;;;;;IAIf,MAAA,SAAS;;;;;IAER,MAAA,SAAS;;;;;;;;;;;;;;;;;EAQvB,WAAC,OAAO,2BAA2B;kCAc/C;cAEW,kCAAkB,8BAAA;;;;;;;;;;qCAuB7B;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAgBhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAY7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"hover-card.d.ts","names":[],"sources":["../../../src/components/hover-card/hover-card.ts"],"mappings":";;;;;KAmBK,iBAAiB;;KAGV,yBAAyB,KAAK;cAE7B,+BAAe,8BAAA;;;;;;;IAMK,MAAA,SAAS;;;;;;;;;;;;IAIf,MAAA,SAAS;;;;IAER,MAAA,SAAS;;;;;EAIP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;IAXJ,MAAA,SAAS;;;;;;;;;;;;IAIf,MAAA,SAAS;;;;IAER,MAAA,SAAS;;;;;;;;;;EAQvB,WAAC,OAAO,2BAA2B;kCAc/C;cAEW,kCAAkB,8BAAA;;;;;;;;;;qCAyB7B;cAEW,qCAAqB,8BAAA;;;IAID,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAY7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAS3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BASjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/hover-card/hover-card.js

@@ -1,8 +1,10 @@
+import { XhPortal } from "../../runtime/portal.js";
 import { useScrollbars } from "../../runtime/use-scrollbars.js";
+import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
 import { provideHoverCard, useHoverCardContext } from "./context.js";
 import { useHoverCard } from "./use-hover-card.js";
-import { Teleport, defineComponent, h, mergeProps } from "vue";
+import { defineComponent, h, mergeProps } from "vue";
 //#region src/components/hover-card/hover-card.ts
 const XhHoverCardRoot = defineComponent({
 	name: "XhHoverCardRoot",
@@ -12,31 +14,13 @@ const XhHoverCardRoot = defineComponent({
 			default: void 0
 		},
 		defaultOpen: Boolean,
-		placement: {
-			type: String,
-			default: void 0
-		},
-		offset: {
-			type: Number,
-			default: void 0
-		},
-		openDelay: {
-			type: Number,
-			default: void 0
-		},
-		closeDelay: {
-			type: Number,
-			default: void 0
-		},
-		dir: {
-			type: String,
-			default: void 0
-		},
+		placement: { type: String },
+		offset: { type: Number },
+		openDelay: { type: Number },
+		closeDelay: { type: Number },
+		dir: { type: String },
 		disabled: Boolean,
-		size: {
-			type: String,
-			default: void 0
-		}
+		size: { type: String }
 	},
 	emits: {
 		"open-change": (_details) => true,
@@ -58,34 +42,44 @@ const XhHoverCardRoot = defineComponent({
 });
 const XhHoverCardTrigger = defineComponent({
 	name: "XhHoverCardTrigger",
+	inheritAttrs: false,
 	props: { 
-	/** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+	/** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
 asChild: Boolean },
-	setup(props, { slots }) {
+	setup(props, { slots, attrs }) {
 		const ctx = useHoverCardContext();
 		return () => {
-			const attrs = {
+			const part = mergePartProps({
 				...ctx.api.value.getTriggerProps(),
 				ref: (el) => {
 					ctx.triggerRef.value = el;
 				}
-			};
+			}, attrs);
 			const children = slots.default?.();
 			if (props.asChild) {
-				const merged = mergeIntoChild(children, attrs, "hover-card");
+				const merged = mergeIntoChild(children, part, "hover-card");
 				if (merged) return merged;
 			}
-			return h("button", attrs, children);
+			return h("button", part, children);
 		};
 	}
 });
 const XhHoverCardPositioner = defineComponent({
 	name: "XhHoverCardPositioner",
+	props: { 
+	/** 本实例的 Portal 容器；优先于应用级配置。 */
+container: { type: Object } },
 	inheritAttrs: false,
-	setup(_, { slots, attrs }) {
+	setup(props, { slots, attrs }) {
 		const ctx = useHoverCardContext();
-		const bars = useScrollbars({ scrollable: () => ctx.contentRef.value });
-		return () => h(Teleport, { to: ctx.portalTarget.value }, [h("div", {
+		const bars = useScrollbars({
+			scrollable: () => ctx.contentRef.value,
+			props: { size: "sm" }
+		});
+		return () => h(XhPortal, {
+			to: props.container ?? ctx.portalTarget.value,
+			source: ctx.triggerRef
+		}, () => [h("div", {
 			...mergeProps(ctx.api.value.getPositionerProps(), attrs),
 			ref: (el) => {
 				ctx.positionerRef.value = el;
@@ -106,6 +100,30 @@ const XhHoverCardContent = defineComponent({
 		}, slots.default?.());
 	}
 });
+const XhHoverCardTitle = defineComponent({
+	name: "XhHoverCardTitle",
+	setup(_, { slots }) {
+		const ctx = useHoverCardContext();
+		return () => h("h2", {
+			...ctx.api.value.getTitleProps(),
+			ref: (el) => {
+				ctx.titleRef.value = el;
+			}
+		}, slots.default?.());
+	}
+});
+const XhHoverCardDescription = defineComponent({
+	name: "XhHoverCardDescription",
+	setup(_, { slots }) {
+		const ctx = useHoverCardContext();
+		return () => h("p", {
+			...ctx.api.value.getDescriptionProps(),
+			ref: (el) => {
+				ctx.descriptionRef.value = el;
+			}
+		}, slots.default?.());
+	}
+});
 const XhHoverCardArrow = defineComponent({
 	name: "XhHoverCardArrow",
 	setup() {
@@ -114,6 +132,6 @@ const XhHoverCardArrow = defineComponent({
 	}
 });
 //#endregion
-export { XhHoverCardArrow, XhHoverCardContent, XhHoverCardPositioner, XhHoverCardRoot, XhHoverCardTrigger };
+export { XhHoverCardArrow, XhHoverCardContent, XhHoverCardDescription, XhHoverCardPositioner, XhHoverCardRoot, XhHoverCardTitle, XhHoverCardTrigger };
 
 //# sourceMappingURL=hover-card.js.map

package/dist/components/hover-card/hover-card.js.map

@@ -1 +1 @@
-{"version":3,"file":"hover-card.js","names":[],"sources":["../../../src/components/hover-card/hover-card.ts"],"sourcesContent":["import type { HoverCardApi, HoverCardSchema } from '@xihan-ui/headless'\nimport type { Direction, Placement, Size } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps, Teleport } from 'vue'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { provideHoverCard, useHoverCardContext } from './context'\nimport { useHoverCard } from './use-hover-card'\n\ntype HoverCardProps = HoverCardSchema['props']\n\n/** 默认插槽的载荷：浮层的开合状态与程序化开合的方法。 */\nexport type HoverCardRootSlotProps = Pick<HoverCardApi, 'open' | 'setOpen'>\n\nexport const XhHoverCardRoot = defineComponent({\n  name: 'XhHoverCardRoot',\n  // 缺省值由机器与 connect 给出，这里一律 default: undefined\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement>, default: undefined },\n    offset: { type: Number, default: undefined },\n    openDelay: { type: Number, default: undefined },\n    closeDelay: { type: Number, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    disabled: Boolean,\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<HoverCardProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<HoverCardProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: HoverCardRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: HoverCardProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useHoverCard(props as HoverCardProps, notify)\n    provideHoverCard(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      setOpen: ctx.api.value.setOpen,\n    }))\n  },\n})\n\nexport const XhHoverCardTrigger = defineComponent({\n  name: 'XhHoverCardTrigger',\n  props: {\n    /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = useHoverCardContext()\n    return () => {\n      const attrs = {\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, attrs, 'hover-card')\n        if (merged)\n          return merged\n      }\n      return h('button', attrs, children)\n    }\n  },\n})\n\nexport const XhHoverCardPositioner = defineComponent({\n  name: 'XhHoverCardPositioner',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useHoverCardContext()\n    // 卡片内容的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value })\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(Teleport, { to: ctx.portalTarget.value }, [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhHoverCardContent = defineComponent({\n  name: 'XhHoverCardContent',\n  setup(_, { slots }) {\n    const ctx = useHoverCardContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场\n      // 就一帧都播不出来），所以真正的收起落成内联 display——节点始终留在原地\n      style: ctx.visible.value ? undefined : { display: 'none' },\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhHoverCardArrow = defineComponent({\n  name: 'XhHoverCardArrow',\n  setup() {\n    const ctx = useHoverCardContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":";;;;;;AAeA,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CAEN,OAAO;EACL,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;EACb,WAAW;GAAE,MAAM;GAA+B,SAAS,KAAA;EAAU;EACrE,QAAQ;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC3C,WAAW;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC9C,YAAY;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC/C,KAAK;GAAE,MAAM;GAA+B,SAAS,KAAA;EAAU;EAC/D,UAAU;EACV,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;CAC7D;CAEA,OAAO;EACL,gBAAgB,aAAwD;EACxE,gBAAgB,UAA6D;CAC/E;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA0C,YAAY;GAC1D,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EACA,MAAM,MAAM,aAAa,OAAyB,MAAM;EACxD,iBAAiB,GAAG;EACpB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,MAAM,IAAI,IAAI,MAAM;GACpB,SAAS,IAAI,IAAI,MAAM;EACzB,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,OAAO;;AAEL,SAAS,QACX;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,oBAAoB;EAChC,aAAa;GACX,MAAM,QAAQ;IACZ,GAAG,IAAI,IAAI,MAAM,gBAAgB;IACjC,MAAM,OAAgB;KAAE,IAAI,WAAW,QAAQ;IAAkB;GACnE;GACA,MAAM,WAAW,MAAM,UAAU;GAEjC,IAAI,MAAM,SAAS;IACjB,MAAM,SAAS,eAAe,UAAU,OAAO,YAAY;IAC3D,IAAI,QACF,OAAO;GACX;GACA,OAAO,EAAE,UAAU,OAAO,QAAQ;EACpC;CACF;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CAEN,cAAc;CACd,MAAM,GAAG,EAAE,OAAO,SAAS;EACzB,MAAM,MAAM,oBAAoB;EAEhC,MAAM,OAAO,cAAc,EAAE,kBAAkB,IAAI,WAAW,MAAM,CAAC;EAErE,aAAa,EAAE,UAAU,EAAE,IAAI,IAAI,aAAa,MAAM,GAAG,CACvD,EAAE,OAAO;GACP,GAAG,WAAW,IAAI,IAAI,MAAM,mBAAmB,GAA8B,KAAK;GAClF,MAAM,OAAgB;IAAE,IAAI,cAAc,QAAQ;GAAkB;EACtE,GAAG,CAAC,GAAI,MAAM,UAAU,KAAK,CAAC,GAAI,GAAG,KAAK,OAAO,CAAC,CAAC,CACrD,CAAC;CACH;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAChC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GAGjC,OAAO,IAAI,QAAQ,QAAQ,KAAA,IAAY,EAAE,SAAS,OAAO;GACzD,MAAM,OAAgB;IAAE,IAAI,WAAW,QAAQ;GAAkB;EACnE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,oBAAoB;EAChC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,CAA4B;CAChF;AACF,CAAC"}
+{"version":3,"file":"hover-card.js","names":[],"sources":["../../../src/components/hover-card/hover-card.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// 提供 hover card 相关实现。\n\nimport type { Direction, Placement, Size } from '@xihan-ui/core'\nimport type { HoverCardApi, HoverCardSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps } from 'vue'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { provideHoverCard, useHoverCardContext } from './context'\nimport { useHoverCard } from './use-hover-card'\n\ntype HoverCardProps = HoverCardSchema['props']\n\n/** 默认插槽的载荷：浮层的开合状态与程序化开合的方法。 */\nexport type HoverCardRootSlotProps = Pick<HoverCardApi, 'open' | 'setOpen'>\n\nexport const XhHoverCardRoot = defineComponent({\n  name: 'XhHoverCardRoot',\n  // 缺省值由机器与 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    openDelay: { type: Number },\n    closeDelay: { type: Number },\n    dir: { type: String as PropType<Direction> },\n    disabled: Boolean,\n    size: { type: String as PropType<Size> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<HoverCardProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<HoverCardProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: HoverCardRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: HoverCardProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useHoverCard(props as HoverCardProps, notify)\n    provideHoverCard(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      setOpen: ctx.api.value.setOpen,\n    }))\n  },\n})\n\nexport const XhHoverCardTrigger = defineComponent({\n  name: 'XhHoverCardTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useHoverCardContext()\n    return () => {\n      const part = mergePartProps({\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'hover-card')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhHoverCardPositioner = defineComponent({\n  name: 'XhHoverCardPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useHoverCardContext()\n    // 卡片内容的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner；浮层里走 4px 档\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhHoverCardContent = defineComponent({\n  name: 'XhHoverCardContent',\n  setup(_, { slots }) {\n    const ctx = useHoverCardContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场\n      // 就一帧都播不出来），所以真正的收起落成内联 display——节点始终留在原地\n      style: ctx.visible.value ? undefined : { display: 'none' },\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhHoverCardTitle = defineComponent({\n  name: 'XhHoverCardTitle',\n  setup(_, { slots }) {\n    const ctx = useHoverCardContext()\n    return () => h('h2', {\n      ...ctx.api.value.getTitleProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.titleRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhHoverCardDescription = defineComponent({\n  name: 'XhHoverCardDescription',\n  setup(_, { slots }) {\n    const ctx = useHoverCardContext()\n    return () => h('p', {\n      ...ctx.api.value.getDescriptionProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.descriptionRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhHoverCardArrow = defineComponent({\n  name: 'XhHoverCardArrow',\n  setup() {\n    const ctx = useHoverCardContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":";;;;;;;;AAwBA,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CAEN,OAAO;EACL,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;EACb,WAAW,EAAE,MAAM,OAA8B;EACjD,QAAQ,EAAE,MAAM,OAAO;EACvB,WAAW,EAAE,MAAM,OAAO;EAC1B,YAAY,EAAE,MAAM,OAAO;EAC3B,KAAK,EAAE,MAAM,OAA8B;EAC3C,UAAU;EACV,MAAM,EAAE,MAAM,OAAyB;CACzC;CAEA,OAAO;EACL,gBAAgB,aAAwD;EACxE,gBAAgB,UAA6D;CAC/E;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA0C,YAAY;GAC1D,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EACA,MAAM,MAAM,aAAa,OAAyB,MAAM;EACxD,iBAAiB,GAAG;EACpB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,MAAM,IAAI,IAAI,MAAM;GACpB,SAAS,IAAI,IAAI,MAAM;EACzB,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CAEN,cAAc;CACd,OAAO;;AAEL,SAAS,QACX;CACA,MAAM,OAAO,EAAE,OAAO,SAAS;EAC7B,MAAM,MAAM,oBAAoB;EAChC,aAAa;GACX,MAAM,OAAO,eAAe;IAC1B,GAAG,IAAI,IAAI,MAAM,gBAAgB;IACjC,MAAM,OAAgB;KAAE,IAAI,WAAW,QAAQ;IAAkB;GACnE,GAAG,KAAK;GACR,MAAM,WAAW,MAAM,UAAU;GAEjC,IAAI,MAAM,SAAS;IACjB,MAAM,SAAS,eAAe,UAAU,MAAM,YAAY;IAC1D,IAAI,QACF,OAAO;GACX;GACA,OAAO,EAAE,UAAU,MAAM,QAAQ;EACnC;CACF;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,OAAO;;AAEL,WAAW,EAAE,MAAM,OAA4B,EACjD;CAEA,cAAc;CACd,MAAM,OAAO,EAAE,OAAO,SAAS;EAC7B,MAAM,MAAM,oBAAoB;EAEhC,MAAM,OAAO,cAAc;GAAE,kBAAkB,IAAI,WAAW;GAAO,OAAO,EAAE,MAAM,KAAK;EAAE,CAAC;EAE5F,aAAa,EAAE,UAAU;GAAE,IAAI,MAAM,aAAa,IAAI,aAAa;GAAO,QAAQ,IAAI;EAAW,SAAS,CACxG,EAAE,OAAO;GACP,GAAG,WAAW,IAAI,IAAI,MAAM,mBAAmB,GAA8B,KAAK;GAClF,MAAM,OAAgB;IAAE,IAAI,cAAc,QAAQ;GAAkB;EACtE,GAAG,CAAC,GAAI,MAAM,UAAU,KAAK,CAAC,GAAI,GAAG,KAAK,OAAO,CAAC,CAAC,CACrD,CAAC;CACH;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAChC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GAGjC,OAAO,IAAI,QAAQ,QAAQ,KAAA,IAAY,EAAE,SAAS,OAAO;GACzD,MAAM,OAAgB;IAAE,IAAI,WAAW,QAAQ;GAAkB;EACnE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAChC,aAAa,EAAE,MAAM;GACnB,GAAG,IAAI,IAAI,MAAM,cAAc;GAC/B,MAAM,OAAgB;IAAE,IAAI,SAAS,QAAQ;GAAkB;EACjE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,yBAAyB,gBAAgB;CACpD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAChC,aAAa,EAAE,KAAK;GAClB,GAAG,IAAI,IAAI,MAAM,oBAAoB;GACrC,MAAM,OAAgB;IAAE,IAAI,eAAe,QAAQ;GAAkB;EACvE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,oBAAoB;EAChC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,CAA4B;CAChF;AACF,CAAC"}

package/dist/components/hover-card/use-hover-card.d.ts

@@ -1,6 +1,6 @@
 import { ComputedRef, Ref } from "vue";
+import { Service } from "@xihan-ui/core";
 import { HoverCardApi, HoverCardSchema } from "@xihan-ui/headless";
-import { Service } from "@xihan-ui/machine";
 //#region src/components/hover-card/use-hover-card.d.ts
 interface HoverCardContext {
   service: Service<HoverCardSchema>;
@@ -11,9 +11,13 @@ interface HoverCardContext {
   positionerRef: Ref<HTMLElement | null>;
   /** 消解层节点，也是判定焦点是否仍在卡片内的依据。 */
   contentRef: Ref<HTMLElement | null>;
-  /** 此刻该不该渲染：退场动画播完之前仍为真。 */
+  /** title 部件；作者未放置它时卡片的可及名指回 trigger。 */
+  titleRef: Ref<HTMLElement | null>;
+  /** description 部件；作者未放置它时不发 aria-describedby。 */
+  descriptionRef: Ref<HTMLElement | null>;
+  /** 当前是否应当渲染：退场动画播完之前仍为真。 */
   visible: Ref<boolean>;
-  /** 浮层搬到哪儿：全局配置的 portalContainer > body。 */
+  /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */
   portalTarget: ComputedRef<string | Element>;
 }
 declare function useHoverCard(props: HoverCardSchema['props'], onOpenChange?: HoverCardSchema['props']['onOpenChange']): HoverCardContext;

package/dist/components/hover-card/use-hover-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-hover-card.d.ts","names":[],"sources":["../../../src/components/hover-card/use-hover-card.ts"],"mappings":";;;;UAciB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;;EAEjB,YAAY,IAAI;;EAEhB,eAAe,IAAI;;EAEnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,aACd,OAAO,0BACP,eAAe,2CACd"}
+{"version":3,"file":"use-hover-card.d.ts","names":[],"sources":["../../../src/components/hover-card/use-hover-card.ts"],"mappings":";;;;UAoBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;;EAEjB,YAAY,IAAI;;EAEhB,eAAe,IAAI;;EAEnB,YAAY,IAAI;;EAEhB,UAAU,IAAI;;EAEd,gBAAgB,IAAI;;EAEpB,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,aACd,OAAO,0BACP,eAAe,2CACd"}