@xihan-ui/vue 2.1.0 → 3.0.0

package/dist/components/diff-view/diff-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"diff-view.js","names":[],"sources":["../../../src/components/diff-view/diff-view.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// 提供 diff view 相关实现。\n\nimport type { CodeToken, Size } from '@xihan-ui/core'\nimport type { DiffChange, DiffModel, DiffSide, DiffViewApi, DiffViewMode, DiffViewSchema, DiffViewTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { diffViewSides } from '@xihan-ui/headless'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideDiffView, useDiffViewContext } from './context'\nimport { useDiffView } from './use-diff-view'\n\ntype Props = DiffViewSchema['props']\n\n/** 默认插槽的载荷：可见行序、增删统计与展开集合。 */\nexport type DiffViewRootSlotProps = Pick<\n  DiffViewApi,\n  'view' | 'rows' | 'expandedValue' | 'stats' | 'truncated' | 'truncatedLines' | 'isEmpty' | 'toggleGap' | 'setExpandedValue'\n>\n\nexport const XhDiffViewRoot = defineComponent({\n  name: 'XhDiffViewRoot',\n  props: {\n    model: { type: Object as PropType<DiffModel> },\n    view: { type: String as PropType<DiffViewMode> },\n    contextLines: { type: Number },\n    expandedValue: { type: Array as PropType<readonly string[]> },\n    defaultExpandedValue: { type: Array as PropType<readonly string[]> },\n    wrap: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<DiffViewTranslations>> },\n  },\n  emits: {\n    'expanded-value-change': (_details: PayloadOf<Props, 'onExpandedValueChange'>) => true,\n    'update:expandedValue': (_value: string[]) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DiffViewRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useDiffView(withXhConfig('diff-view', props) as Props, (details) => {\n      emit('expanded-value-change', details)\n      emit('update:expandedValue', details.value)\n    })\n    provideDiffView(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      view: ctx.api.value.view,\n      rows: ctx.api.value.rows,\n      expandedValue: ctx.api.value.expandedValue,\n      stats: ctx.api.value.stats,\n      truncated: ctx.api.value.truncated,\n      truncatedLines: ctx.api.value.truncatedLines,\n      isEmpty: ctx.api.value.isEmpty,\n      toggleGap: ctx.api.value.toggleGap,\n      setExpandedValue: ctx.api.value.setExpandedValue,\n    }))\n  },\n})\n\nexport const XhDiffViewHeader = defineComponent({\n  name: 'XhDiffViewHeader',\n  setup(_, { slots }) {\n    const ctx = useDiffViewContext()\n    return () => h('div', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 头部右侧的增删统计位，增删各放一个。\n *\n * 数字取自模型，默认渲染为 `+N` / `−N`；提供插槽时由插槽自行排版。\n */\nexport const XhDiffViewSummary = defineComponent({\n  name: 'XhDiffViewSummary',\n  props: {\n    change: { type: String as PropType<Extract<DiffChange, 'added' | 'removed'>>, required: true },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: { count: number }) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useDiffViewContext()\n    return () => {\n      const api = ctx.api.value\n      const count = props.change === 'added' ? api.stats.added : api.stats.removed\n      return h(\n        'span',\n        api.getSummaryProps({ change: props.change }) as Record<string, unknown>,\n        slots.default?.({ count }) ?? `${props.change === 'added' ? '+' : '−'}${count}`,\n      )\n    }\n  },\n})\n\nexport const XhDiffViewViewport = defineComponent({\n  name: 'XhDiffViewViewport',\n  setup(_, { slots }) {\n    const ctx = useDiffViewContext()\n    // 唯一的 Tab 停靠点，横纵滚动交给浏览器\n    return () => h('div', ctx.api.value.getViewportProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDiffViewBody = defineComponent({\n  name: 'XhDiffViewBody',\n  setup(_, { slots }) {\n    const ctx = useDiffViewContext()\n    // 行是模型算出来的派生结构，作者写不出 N 行，由组件铺\n    return () => {\n      const api = ctx.api.value\n      const sides = diffViewSides(api.view)\n      return h('div', api.getBodyProps() as Record<string, unknown>, [\n        ...api.rows.map((row) => {\n          if (row.kind === 'gap') {\n            const gapId = row.gapId!\n            return h('div', { ...api.getGapProps({ gapId }) as Record<string, unknown>, key: `gap:${gapId}` }, [\n              h('div', api.getGapCellProps() as Record<string, unknown>, [\n                h(\n                  'button',\n                  api.getGapTriggerProps({ gapId }) as Record<string, unknown>,\n                  `⋯ ${row.hiddenCount}`,\n                ),\n              ]),\n            ])\n          }\n          const { rowIndex } = row\n          return h('div', { ...api.getRowProps({ rowIndex }) as Record<string, unknown>, key: `row:${rowIndex}` }, sides.flatMap(side => [\n            h('span', { ...api.getLineNumberProps({ rowIndex, side }) as Record<string, unknown>, key: `n:${side}` }),\n            h('span', { ...api.getLineContentProps({ rowIndex, side }) as Record<string, unknown>, key: `c:${side}` }, [\n              // 变更类型的读屏文字住在内容格里面：变更不能只靠颜色传达\n              h(\n                'span',\n                api.getChangeLabelProps({ change: row.line!.change }) as Record<string, unknown>,\n                api.changeLabel(row.line!.change),\n              ),\n              ...renderCell(api, rowIndex, side),\n            ]),\n          ]))\n        }),\n        slots.default?.() ?? [],\n      ])\n    }\n  },\n})\n\n/** 着色记号逐个铺为 span。 */\nfunction renderTokens(api: DiffViewApi, tokens: readonly CodeToken[]): VNode[] {\n  return tokens.map((token, i) => h(\n    'span',\n    { ...api.getTokenProps(token) as Record<string, unknown>, key: i },\n    token.text,\n  ))\n}\n\n/** 一格的正文：计算了词级差异时先按片段包一层，否则整行按记号铺设；都没有时为一个文本节点。 */\nfunction renderCell(api: DiffViewApi, rowIndex: number, side: DiffSide): VNode[] {\n  const segments = api.cellSegments({ rowIndex, side })\n  if (segments.length > 0) {\n    return segments.map((segment, i) => h(\n      'span',\n      { ...api.getInlineChangeProps({ rowIndex, changed: segment.changed }) as Record<string, unknown>, key: `s:${i}` },\n      segment.tokens.length === 0 ? segment.text : renderTokens(api, segment.tokens),\n    ))\n  }\n  const tokens = api.cellTokens({ rowIndex, side })\n  if (tokens.length === 0) {\n    const text = api.cellText({ rowIndex, side })\n    return text === undefined ? [] : [h('span', text)]\n  }\n  return renderTokens(api, tokens)\n}\n\nexport const XhDiffViewEmpty = defineComponent({\n  name: 'XhDiffViewEmpty',\n  setup(_, { slots }) {\n    const ctx = useDiffViewContext()\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 截断提示条：这份差异被上限截去了多少行。\n *\n * 文字默认由组件自行填入：留给作者填写时，作者不填就又变回一份看似完整的残缺差异，\n * 而这正是该提示要防止的情况。提供插槽时由插槽自行排版，行数一并交出。\n */\nexport const XhDiffViewTruncation = defineComponent({\n  name: 'XhDiffViewTruncation',\n  slots: Object as SlotsType<{\n    default?: (props: { count: number }) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useDiffViewContext()\n    return () => {\n      const api = ctx.api.value\n      return h(\n        'div',\n        api.getTruncationProps() as Record<string, unknown>,\n        slots.default?.({ count: api.truncatedLines }) ?? api.truncationText,\n      )\n    }\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"diff-view.js","names":[],"sources":["../../../src/components/diff-view/diff-view.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// 提供 diff view 相关实现。\n\nimport type { CodeToken, Size } from '@xihan-ui/core'\nimport type { DiffChange, DiffModel, DiffSide, DiffViewApi, DiffViewCommentRequestDetails, DiffViewLineRef, DiffViewMode, DiffViewSchema, DiffViewTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { diffViewSides } from '@xihan-ui/headless'\nimport { defineComponent, h, onBeforeUnmount, onMounted } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideDiffView, useDiffViewContext } from './context'\nimport { useDiffView } from './use-diff-view'\n\ntype Props = DiffViewSchema['props']\n\n/** 默认插槽的载荷：可见行序、增删统计与展开集合。 */\nexport type DiffViewRootSlotProps = Pick<\n  DiffViewApi,\n  'view' | 'rows' | 'expandedValue' | 'stats' | 'truncated' | 'truncatedLines' | 'isEmpty' | 'toggleGap' | 'setExpandedValue'\n>\n\nexport const XhDiffViewRoot = defineComponent({\n  name: 'XhDiffViewRoot',\n  props: {\n    model: { type: Object as PropType<DiffModel> },\n    view: { type: String as PropType<DiffViewMode> },\n    contextLines: { type: Number },\n    expandedValue: { type: Array as PropType<readonly string[]> },\n    defaultExpandedValue: { type: Array as PropType<readonly string[]> },\n    wrap: { type: Boolean, default: undefined },\n    commentable: { type: Boolean, default: undefined },\n    commentLines: { type: Array as PropType<readonly DiffViewLineRef[]> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<DiffViewTranslations>> },\n  },\n  // comment-request 携带 { side, line, change, text }\n  emits: {\n    'expanded-value-change': (_details: PayloadOf<Props, 'onExpandedValueChange'>) => true,\n    'update:expandedValue': (_value: string[]) => true,\n    'comment-request': (_details: PayloadOf<Props, 'onCommentRequest'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DiffViewRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useDiffView(withXhConfig('diff-view', props) as Props, (details) => {\n      emit('expanded-value-change', details)\n      emit('update:expandedValue', details.value)\n    }, details => emit('comment-request', details))\n    provideDiffView(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      view: ctx.api.value.view,\n      rows: ctx.api.value.rows,\n      expandedValue: ctx.api.value.expandedValue,\n      stats: ctx.api.value.stats,\n      truncated: ctx.api.value.truncated,\n      truncatedLines: ctx.api.value.truncatedLines,\n      isEmpty: ctx.api.value.isEmpty,\n      toggleGap: ctx.api.value.toggleGap,\n      setExpandedValue: ctx.api.value.setExpandedValue,\n    }))\n  },\n})\n\nexport const XhDiffViewHeader = defineComponent({\n  name: 'XhDiffViewHeader',\n  setup(_, { slots }) {\n    const ctx = useDiffViewContext()\n    // 渲出来了才登记：表格的 aria-labelledby 只在这个节点真在场时才指过来\n    onMounted(() => {\n      ctx.headerCount.value++\n    })\n    onBeforeUnmount(() => {\n      ctx.headerCount.value--\n    })\n    return () => h('div', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 头部右侧的增删统计位，增删各放一个。\n *\n * 数字取自模型，默认渲染为 `+N` / `−N`；提供插槽时由插槽自行排版。\n */\nexport const XhDiffViewSummary = defineComponent({\n  name: 'XhDiffViewSummary',\n  props: {\n    change: { type: String as PropType<Extract<DiffChange, 'added' | 'removed'>>, required: true },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: { count: number }) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useDiffViewContext()\n    return () => {\n      const api = ctx.api.value\n      const count = props.change === 'added' ? api.stats.added : api.stats.removed\n      return h(\n        'span',\n        api.getSummaryProps({ change: props.change }) as Record<string, unknown>,\n        slots.default?.({ count }) ?? `${props.change === 'added' ? '+' : '−'}${count}`,\n      )\n    }\n  },\n})\n\nexport const XhDiffViewViewport = defineComponent({\n  name: 'XhDiffViewViewport',\n  setup(_, { slots }) {\n    const ctx = useDiffViewContext()\n    // 唯一的 Tab 停靠点，横纵滚动交给浏览器\n    return () => h('div', ctx.api.value.getViewportProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDiffViewBody = defineComponent({\n  name: 'XhDiffViewBody',\n  // comment 插槽：挂着评论的那一行在代码下方铺出评论容器，内容由这里写；载荷是这一行的侧、行号、变更类型与文本\n  slots: Object as SlotsType<{\n    default?: () => VNode[]\n    comment?: (props: DiffViewCommentRequestDetails) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useDiffViewContext()\n    // 行是模型算出来的派生结构，作者写不出 N 行，由组件铺\n    return () => {\n      const api = ctx.api.value\n      const sides = diffViewSides(api.view)\n      return h('div', api.getBodyProps() as Record<string, unknown>, [\n        ...api.rows.map((row) => {\n          if (row.kind === 'gap') {\n            const gapId = row.gapId!\n            return h('div', { ...api.getGapProps({ gapId }) as Record<string, unknown>, key: `gap:${gapId}` }, [\n              h('div', api.getGapCellProps() as Record<string, unknown>, [\n                h(\n                  'button',\n                  api.getGapTriggerProps({ gapId }) as Record<string, unknown>,\n                  `⋯ ${row.hiddenCount}`,\n                ),\n              ]),\n            ])\n          }\n          const { rowIndex } = row\n          return h('div', { ...api.getRowProps({ rowIndex }) as Record<string, unknown>, key: `row:${rowIndex}` }, sides.flatMap((side) => {\n            const cell = { rowIndex, side }\n            const ref = api.commentRefAt(cell)\n            return [\n              h('span', { ...api.getLineNumberProps(cell) as Record<string, unknown>, key: `n:${side}` }),\n              h('span', { ...api.getLineContentProps(cell) as Record<string, unknown>, key: `c:${side}` }, [\n                // 变更类型的读屏文字住在内容格里面：变更不能只靠颜色传达\n                h(\n                  'span',\n                  api.getChangeLabelProps({ change: row.line!.change }) as Record<string, unknown>,\n                  api.changeLabel(row.line!.change),\n                ),\n                // 评论钮放在正文最前面，由皮肤定位到正文让出的那一列里；空侧不建\n                api.commentable && ref !== undefined ? h('button', api.getCommentTriggerProps(cell) as Record<string, unknown>) : null,\n                ...renderCell(api, rowIndex, side),\n                // 挂着评论的行在代码下方铺出评论容器，与代码同住一个 cell，行序不受影响\n                api.hasComment(cell)\n                  ? h('div', api.getCommentThreadProps(cell) as Record<string, unknown>, slots.comment?.({ ...ref!, change: row.line!.change, text: row.line!.text }))\n                  : null,\n              ]),\n            ]\n          }))\n        }),\n        slots.default?.() ?? [],\n      ])\n    }\n  },\n})\n\n/** 着色记号逐个铺为 span。 */\nfunction renderTokens(api: DiffViewApi, tokens: readonly CodeToken[]): VNode[] {\n  return tokens.map((token, i) => h(\n    'span',\n    { ...api.getTokenProps(token) as Record<string, unknown>, key: i },\n    token.text,\n  ))\n}\n\n/** 一格的正文：计算了词级差异时先按片段包一层，否则整行按记号铺设；都没有时为一个文本节点。 */\nfunction renderCell(api: DiffViewApi, rowIndex: number, side: DiffSide): VNode[] {\n  const segments = api.cellSegments({ rowIndex, side })\n  if (segments.length > 0) {\n    return segments.map((segment, i) => h(\n      'span',\n      { ...api.getInlineChangeProps({ rowIndex, changed: segment.changed }) as Record<string, unknown>, key: `s:${i}` },\n      segment.tokens.length === 0 ? segment.text : renderTokens(api, segment.tokens),\n    ))\n  }\n  const tokens = api.cellTokens({ rowIndex, side })\n  if (tokens.length === 0) {\n    const text = api.cellText({ rowIndex, side })\n    return text === undefined ? [] : [h('span', text)]\n  }\n  return renderTokens(api, tokens)\n}\n\nexport const XhDiffViewEmpty = defineComponent({\n  name: 'XhDiffViewEmpty',\n  setup(_, { slots }) {\n    const ctx = useDiffViewContext()\n    return () => h('div', ctx.api.value.getEmptyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 截断提示条：这份差异被上限截去了多少行。\n *\n * 文字默认由组件自行填入：留给作者填写时，作者不填就又变回一份看似完整的残缺差异，\n * 而这正是该提示要防止的情况。提供插槽时由插槽自行排版，行数一并交出。\n */\nexport const XhDiffViewTruncation = defineComponent({\n  name: 'XhDiffViewTruncation',\n  slots: Object as SlotsType<{\n    default?: (props: { count: number }) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useDiffViewContext()\n    return () => {\n      const api = ctx.api.value\n      return h(\n        'div',\n        api.getTruncationProps() as Record<string, unknown>,\n        slots.default?.({ count: api.truncatedLines }) ?? api.truncationText,\n      )\n    }\n  },\n})\n"],"mappings":"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"}

package/dist/components/diff-view/use-diff-view.d.ts

@@ -1,11 +1,16 @@
-import { ComputedRef } from "vue";
+import { ComputedRef, Ref } from "vue";
 import { DiffViewApi, DiffViewSchema } from "@xihan-ui/headless";
 //#region src/components/diff-view/use-diff-view.d.ts
 type Props = DiffViewSchema['props'];
 interface DiffViewContext {
   api: ComputedRef<DiffViewApi>;
+  /**
+   * 作者渲染的 header 部件数量，由 XhDiffViewHeader 自行登记。
+   * 表格的可访问名据此决定指向头部还是直接用路径：没渲头部时指过去就是一个不存在的 id。
+   */
+  headerCount: Ref<number>;
 }
-declare function useDiffView(props: Props, onExpandedValueChange?: Props['onExpandedValueChange']): DiffViewContext;
+declare function useDiffView(props: Props, onExpandedValueChange?: Props['onExpandedValueChange'], onCommentRequest?: Props['onCommentRequest']): DiffViewContext;
 //#endregion
 export { DiffViewContext, useDiffView };
 //# sourceMappingURL=use-diff-view.d.ts.map

package/dist/components/diff-view/use-diff-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-diff-view.d.ts","names":[],"sources":["../../../src/components/diff-view/use-diff-view.ts"],"mappings":";;;KAgBK,QAAQ;UAEI;EACf,KAAK,YAAY;;iBAGH,YAAY,OAAO,OAAO,wBAAwB,iCAAiC"}
+{"version":3,"file":"use-diff-view.d.ts","names":[],"sources":["../../../src/components/diff-view/use-diff-view.ts"],"mappings":";;;KAgBK,QAAQ;UAEI;EACf,KAAK,YAAY;;;;;EAKjB,aAAa;;iBAGC,YACd,OAAO,OACP,wBAAwB,gCACxB,mBAAmB,4BAClB"}

package/dist/components/diff-view/use-diff-view.js

@@ -1,16 +1,23 @@
 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 { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
 import { connectDiffView, diffViewMachine } from "@xihan-ui/headless";
 //#region src/components/diff-view/use-diff-view.ts
-function useDiffView(props, onExpandedValueChange) {
+function useDiffView(props, onExpandedValueChange, onCommentRequest) {
+	const scope = createScope(null, createVueIdGenerator());
+	const headerCount = ref(0);
 	const service = useMachine(diffViewMachine, () => ({
 		...props,
-		onExpandedValueChange
-	}), createScope(null, createVueIdGenerator()));
-	return { api: computed(() => connectDiffView(service, vueNormalize)) };
+		labelled: headerCount.value > 0,
+		onExpandedValueChange,
+		onCommentRequest
+	}), scope);
+	return {
+		api: computed(() => connectDiffView(service, vueNormalize)),
+		headerCount
+	};
 }
 //#endregion
 export { useDiffView };

package/dist/components/diff-view/use-diff-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-diff-view.js","names":[],"sources":["../../../src/components/diff-view/use-diff-view.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 diff view 相关实现。\n\nimport type { DiffViewApi, DiffViewSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectDiffView, diffViewMachine } 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\ntype Props = DiffViewSchema['props']\n\nexport interface DiffViewContext {\n  api: ComputedRef<DiffViewApi>\n}\n\nexport function useDiffView(props: Props, onExpandedValueChange?: Props['onExpandedValueChange']): DiffViewContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(diffViewMachine, () => ({ ...props, onExpandedValueChange }), scope)\n  const api = computed(() => connectDiffView(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;;;AAsBA,SAAgB,YAAY,OAAc,uBAAyE;CAGjH,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO;CAAsB,IADvE,YAAY,MADZ,qBACsB,CACyD,CAAC;CAE9F,OAAO,EAAE,KADG,eAAe,gBAAgB,SAAS,YAAY,CACrD,EAAE;AACf"}
+{"version":3,"file":"use-diff-view.js","names":[],"sources":["../../../src/components/diff-view/use-diff-view.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 diff view 相关实现。\n\nimport type { DiffViewApi, DiffViewSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectDiffView, diffViewMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\ntype Props = DiffViewSchema['props']\n\nexport interface DiffViewContext {\n  api: ComputedRef<DiffViewApi>\n  /**\n   * 作者渲染的 header 部件数量，由 XhDiffViewHeader 自行登记。\n   * 表格的可访问名据此决定指向头部还是直接用路径：没渲头部时指过去就是一个不存在的 id。\n   */\n  headerCount: Ref<number>\n}\n\nexport function useDiffView(\n  props: Props,\n  onExpandedValueChange?: Props['onExpandedValueChange'],\n  onCommentRequest?: Props['onCommentRequest'],\n): DiffViewContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const headerCount = ref(0)\n  const service = useMachine(diffViewMachine, () => ({\n    ...props,\n    labelled: headerCount.value > 0,\n    onExpandedValueChange,\n    onCommentRequest,\n  }), scope)\n  const api = computed(() => connectDiffView(service, vueNormalize))\n  return { api, headerCount }\n}\n"],"mappings":";;;;;;;AA2BA,SAAgB,YACd,OACA,uBACA,kBACiB;CAEjB,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,cAAc,IAAI,CAAC;CACzB,MAAM,UAAU,WAAW,wBAAwB;EACjD,GAAG;EACH,UAAU,YAAY,QAAQ;EAC9B;EACA;CACF,IAAI,KAAK;CAET,OAAO;EAAE,KADG,eAAe,gBAAgB,SAAS,YAAY,CACrD;EAAG;CAAY;AAC5B"}

package/dist/components/drawer/drawer.d.ts

@@ -58,6 +58,24 @@ declare const XhDrawerRoot: import("vue").DefineComponent<import("vue").ExtractP
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 可调厚度：朝向页面那条边上的把手拖动或用方向键推。 */
+  resizable: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  /** 受控厚度（像素），支持 v-model:panel-size；未提供即非受控。 */
+  panelSize: {
+    type: NumberConstructor;
+  };
+  defaultPanelSize: {
+    type: NumberConstructor;
+  };
+  minPanelSize: {
+    type: NumberConstructor;
+  };
+  maxPanelSize: {
+    type: NumberConstructor;
+  };
   translations: {
     type: PropType<DrawerProps["translations"]>;
   };
@@ -67,6 +85,8 @@ declare const XhDrawerRoot: import("vue").DefineComponent<import("vue").ExtractP
   'open-change': (_details: PayloadOf<DrawerProps, "onOpenChange">) => true;
   'update:open': (_open: PayloadOf<DrawerProps, "onOpenChange">["open"]) => true;
   'exit-complete': () => true;
+  'panel-size-change': (_details: PayloadOf<DrawerProps, "onPanelSizeChange">) => true;
+  'update:panelSize': (_size: PayloadOf<DrawerProps, "onPanelSizeChange">["panelSize"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   open: {
     type: BooleanConstructor;
@@ -119,6 +139,24 @@ declare const XhDrawerRoot: import("vue").DefineComponent<import("vue").ExtractP
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 可调厚度：朝向页面那条边上的把手拖动或用方向键推。 */
+  resizable: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  /** 受控厚度（像素），支持 v-model:panel-size；未提供即非受控。 */
+  panelSize: {
+    type: NumberConstructor;
+  };
+  defaultPanelSize: {
+    type: NumberConstructor;
+  };
+  minPanelSize: {
+    type: NumberConstructor;
+  };
+  maxPanelSize: {
+    type: NumberConstructor;
+  };
   translations: {
     type: PropType<DrawerProps["translations"]>;
   };
@@ -126,9 +164,12 @@ declare const XhDrawerRoot: import("vue").DefineComponent<import("vue").ExtractP
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").DrawerOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
   "onExit-complete"?: (() => any) | undefined;
+  "onPanel-size-change"?: ((_details: import("@xihan-ui/headless").DrawerPanelSizeChangeDetails) => any) | undefined;
+  "onUpdate:panelSize"?: ((_size: number) => any) | undefined;
 }>, {
   open: boolean;
   defaultOpen: boolean;
+  resizable: boolean;
   modal: boolean;
   closeOnEscape: boolean;
   closeOnInteractOutside: boolean;
@@ -169,6 +210,10 @@ declare const XhDrawerFooter: import("vue").DefineComponent<{}, () => VNode<impo
 declare const XhDrawerCloseTrigger: 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>;
+/** 改尺把手：role=separator，落在朝向页面的那条边上；放在 XhDrawerContent 里。 */
+declare const XhDrawerResizeTrigger: 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 { DrawerRootSlotProps, XhDrawerBody, XhDrawerCloseTrigger, XhDrawerContent, XhDrawerDescription, XhDrawerFooter, XhDrawerHeader, XhDrawerRoot, XhDrawerTitle, XhDrawerTrigger };
+export { DrawerRootSlotProps, XhDrawerBody, XhDrawerCloseTrigger, XhDrawerContent, XhDrawerDescription, XhDrawerFooter, XhDrawerHeader, XhDrawerResizeTrigger, XhDrawerRoot, XhDrawerTitle, XhDrawerTrigger };
 //# sourceMappingURL=drawer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"drawer.d.ts","names":[],"sources":["../../../src/components/drawer/drawer.ts"],"mappings":";;;;;KAmBK,cAAc;;KAGP,sBAAsB,KAAK;cAE1B,4BAAY,8BAAA;;;;;;;;;;;IAOG,MAAA,SAAS;;;IACT,MAAA;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;IAQG,MAAA,kBAAkB;;;;;;;;;;;IAMzB,MAAA,SAAS;;;;;EAIf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;;;;;IAzBT,MAAA,SAAS;;;IACT,MAAA;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;IAQG,MAAA,kBAAkB;;;;;;;;;;;IAMzB,MAAA,SAAS;;;;;;;;;;;;;;;EAS/B,WAAC,OAAO,wBAAwB;kCAkB5C;cAEW,+BAAe,8BAAA;;;;;;;;;;qCAsB1B;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;qCA6B1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"drawer.d.ts","names":[],"sources":["../../../src/components/drawer/drawer.ts"],"mappings":";;;;;KAmBK,cAAc;;KAGP,sBAAsB,KAAK;cAE1B,4BAAY,8BAAA;;;;;;;;;;;IAOG,MAAA,SAAS;;;IACT,MAAA;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;IAQG,MAAA,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAazB,MAAA,SAAS;;;;;EAIf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;EAED,sBAAA,UAAA,UAAU;EACd,qBAAA,OAAA,UAAU;;;;;;;;;;;;IAnCd,MAAA,SAAS;;;IACT,MAAA;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;IAQG,MAAA,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAazB,MAAA,SAAS;;;;;;;;;;;;;;;;;;EAW/B,WAAC,OAAO,wBAAwB;kCAsB5C;cAEW,+BAAe,8BAAA;;;;;;;;;;qCAsB1B;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;qCA6B1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/drawer/drawer.js

@@ -1,7 +1,7 @@
 import { withXhConfig } from "../../config/config.js";
-import { XhPortal } from "../../runtime/portal.js";
 import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
+import { XhPortal } from "../../runtime/portal.js";
 import { provideDrawer, useDrawerContext } from "./context.js";
 import { useDrawer } from "./use-drawer.js";
 import { defineComponent, h, mergeProps } from "vue";
@@ -50,12 +50,24 @@ const XhDrawerRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		/** 可调厚度：朝向页面那条边上的把手拖动或用方向键推。 */
+		resizable: {
+			type: Boolean,
+			default: void 0
+		},
+		/** 受控厚度（像素），支持 v-model:panel-size；未提供即非受控。 */
+		panelSize: { type: Number },
+		defaultPanelSize: { type: Number },
+		minPanelSize: { type: Number },
+		maxPanelSize: { type: Number },
 		translations: { type: Object }
 	},
 	emits: {
 		"open-change": (_details) => true,
 		"update:open": (_open) => true,
-		"exit-complete": () => true
+		"exit-complete": () => true,
+		"panel-size-change": (_details) => true,
+		"update:panelSize": (_size) => true
 	},
 	slots: Object,
 	setup(props, { slots, emit }) {
@@ -63,7 +75,11 @@ const XhDrawerRoot = defineComponent({
 			emit("open-change", details);
 			emit("update:open", details.open);
 		};
-		const ctx = useDrawer(withXhConfig("drawer", props), notify, () => props.container, () => emit("exit-complete"));
+		const notifySize = (details) => {
+			emit("panel-size-change", details);
+			emit("update:panelSize", details.panelSize);
+		};
+		const ctx = useDrawer(withXhConfig("drawer", props), notify, () => props.container, () => emit("exit-complete"), notifySize);
 		provideDrawer(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
 			open: ctx.api.value.open,
@@ -157,7 +173,15 @@ const XhDrawerCloseTrigger = defineComponent({
 		return () => h("button", ctx.api.value.getCloseTriggerProps(), slots.default?.());
 	}
 });
+/** 改尺把手：role=separator，落在朝向页面的那条边上；放在 XhDrawerContent 里。 */
+const XhDrawerResizeTrigger = defineComponent({
+	name: "XhDrawerResizeTrigger",
+	setup() {
+		const ctx = useDrawerContext();
+		return () => h("div", ctx.api.value.getResizeTriggerProps());
+	}
+});
 //#endregion
-export { XhDrawerBody, XhDrawerCloseTrigger, XhDrawerContent, XhDrawerDescription, XhDrawerFooter, XhDrawerHeader, XhDrawerRoot, XhDrawerTitle, XhDrawerTrigger };
+export { XhDrawerBody, XhDrawerCloseTrigger, XhDrawerContent, XhDrawerDescription, XhDrawerFooter, XhDrawerHeader, XhDrawerResizeTrigger, XhDrawerRoot, XhDrawerTitle, XhDrawerTrigger };
 
 //# sourceMappingURL=drawer.js.map

package/dist/components/drawer/drawer.js.map

@@ -1 +1 @@
-{"version":3,"file":"drawer.js","names":[],"sources":["../../../src/components/drawer/drawer.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// 提供 drawer 相关实现。\n\nimport type { OverlayBackdropVariant, Size } from '@xihan-ui/core'\nimport type { DrawerApi, DrawerSchema, DrawerSide } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { provideDrawer, useDrawerContext } from './context'\nimport { useDrawer } from './use-drawer'\n\ntype DrawerProps = DrawerSchema['props']\n\n/** 默认插槽的载荷：展开状态、已解析的滑出边，与开合命令。 */\nexport type DrawerRootSlotProps = Pick<DrawerApi, 'open' | 'side' | 'setOpen'>\n\nexport const XhDrawerRoot = defineComponent({\n  name: 'XhDrawerRoot',\n  props: {\n    // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    modal: { type: Boolean, default: undefined },\n    side: { type: String as PropType<DrawerSide> },\n    role: { type: String as PropType<'dialog' | 'alertdialog'> },\n    closeOnEscape: { type: Boolean, default: undefined },\n    closeOnInteractOutside: { type: Boolean, default: undefined },\n    restoreFocus: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<OverlayBackdropVariant> },\n    /**\n     * 挂载的容器（CSS 选择器或元素）。提供后即为局部抽屉：\n     * 浮层迁移进该容器，遮罩与定位层从 fixed 换为 absolute，只覆盖它而不是整屏。\n     *\n     * 该容器要自带 position（relative 等），否则 absolute 会向上找到其他定位祖先。\n     * 未提供时查询全局配置的 portalContainer，再没有才落到 body。\n     */\n    container: { type: [String, Object] as PropType<string | Element> },\n    /**\n     * 只把绘制方式改为局部（遮罩与定位层从 fixed 换为 absolute），不改变迁移位置。\n     * 提供 container 后默认为真，不必再写一遍；两个都未提供即铺满视口。\n     */\n    contained: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<DrawerProps['translations']> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<DrawerProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<DrawerProps, 'onOpenChange'>['open']) => true,\n    'exit-complete': () => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DrawerRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: DrawerProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    // 容器一处给定，两件事都从它派生：contained 交给机器（皮肤据此把遮罩与定位层\n    // 从 fixed 换成 absolute），同一个值又是 Teleport 的落点，两边不会各说各话\n    const ctx = useDrawer(withXhConfig('drawer', props) as DrawerProps, notify, () => props.container, () => emit('exit-complete'))\n    provideDrawer(ctx)\n    // root 是真实节点，content 会被 portal 到 body，data-side 挂在这里供页面内的部分读取\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      side: ctx.api.value.side,\n      setOpen: ctx.api.value.setOpen,\n    }))\n  },\n})\n\nexport const XhDrawerTrigger = defineComponent({\n  name: 'XhDrawerTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useDrawerContext()\n    return () => {\n      const part = mergePartProps(ctx.api.value.getTriggerProps() as Record<string, unknown>, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'drawer')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhDrawerContent = defineComponent({\n  name: 'XhDrawerContent',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 content 上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useDrawerContext()\n    return () => {\n      // presence 判定不在场则整棵不渲染，退场动画播完才翻假\n      if (!ctx.rendered.value)\n        return null\n      const api = ctx.api.value\n      const backdrop = api.getBackdropProps() as Record<string, unknown>\n      return h(XhPortal, { to: ctx.portalTarget.value }, () => [\n        !backdrop.hidden\n          ? h('div', {\n              ...backdrop,\n              ref: (el: unknown) => { ctx.backdropRef.value = el as HTMLElement },\n            })\n          : null,\n        h('div', api.getPositionerProps() as Record<string, unknown>, [\n          h('div', {\n            ...mergeProps(api.getContentProps() as Record<string, unknown>, attrs),\n            hidden: !ctx.rendered.value || undefined,\n            ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n          }, slots.default?.()),\n        ]),\n      ])\n    }\n  },\n})\n\nexport const XhDrawerHeader = defineComponent({\n  name: 'XhDrawerHeader',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('header', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerTitle = defineComponent({\n  name: 'XhDrawerTitle',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerDescription = defineComponent({\n  name: 'XhDrawerDescription',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerBody = defineComponent({\n  name: 'XhDrawerBody',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('div', ctx.api.value.getBodyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerFooter = defineComponent({\n  name: 'XhDrawerFooter',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('footer', ctx.api.value.getFooterProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerCloseTrigger = defineComponent({\n  name: 'XhDrawerCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;;;AAwBA,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,OAAO;EAEL,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;EACb,OAAO;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC3C,MAAM,EAAE,MAAM,OAA+B;EAC7C,MAAM,EAAE,MAAM,OAA6C;EAC3D,eAAe;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EACnD,wBAAwB;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC5D,cAAc;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAClD,MAAM,EAAE,MAAM,OAAyB;EACvC,SAAS,EAAE,MAAM,OAA2C;;;;;;;;EAQ5D,WAAW,EAAE,MAAM,CAAC,QAAQ,MAAM,EAAgC;;;;;EAKlE,WAAW;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC/C,cAAc,EAAE,MAAM,OAAgD;CACxE;CAEA,OAAO;EACL,gBAAgB,aAAqD;EACrE,gBAAgB,UAA0D;EAC1E,uBAAuB;CACzB;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAAuC,YAAY;GACvD,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EAGA,MAAM,MAAM,UAAU,aAAa,UAAU,KAAK,GAAkB,cAAc,MAAM,iBAAiB,KAAK,eAAe,CAAC;EAC9H,cAAc,GAAG;EAEjB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,MAAM,IAAI,IAAI,MAAM;GACpB,MAAM,IAAI,IAAI,MAAM;GACpB,SAAS,IAAI,IAAI,MAAM;EACzB,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CAEN,cAAc;CACd,OAAO;;AAEL,SAAS,QACX;CACA,MAAM,OAAO,EAAE,OAAO,SAAS;EAC7B,MAAM,MAAM,iBAAiB;EAC7B,aAAa;GACX,MAAM,OAAO,eAAe,IAAI,IAAI,MAAM,gBAAgB,GAA8B,KAAK;GAC7F,MAAM,WAAW,MAAM,UAAU;GAEjC,IAAI,MAAM,SAAS;IACjB,MAAM,SAAS,eAAe,UAAU,MAAM,QAAQ;IACtD,IAAI,QACF,OAAO;GACX;GACA,OAAO,EAAE,UAAU,MAAM,QAAQ;EACnC;CACF;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CAEN,cAAc;CACd,MAAM,GAAG,EAAE,OAAO,SAAS;EACzB,MAAM,MAAM,iBAAiB;EAC7B,aAAa;GAEX,IAAI,CAAC,IAAI,SAAS,OAChB,OAAO;GACT,MAAM,MAAM,IAAI,IAAI;GACpB,MAAM,WAAW,IAAI,iBAAiB;GACtC,OAAO,EAAE,UAAU,EAAE,IAAI,IAAI,aAAa,MAAM,SAAS,CACvD,CAAC,SAAS,SACN,EAAE,OAAO;IACP,GAAG;IACH,MAAM,OAAgB;KAAE,IAAI,YAAY,QAAQ;IAAkB;GACpE,CAAC,IACD,MACJ,EAAE,OAAO,IAAI,mBAAmB,GAA8B,CAC5D,EAAE,OAAO;IACP,GAAG,WAAW,IAAI,gBAAgB,GAA8B,KAAK;IACrE,QAAQ,CAAC,IAAI,SAAS,SAAS,KAAA;IAC/B,MAAM,OAAgB;KAAE,IAAI,WAAW,QAAQ;IAAkB;GACnE,GAAG,MAAM,UAAU,CAAC,CACtB,CAAC,CACH,CAAC;EACH;CACF;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAED,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAED,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,qBAAqB,GAA8B,MAAM,UAAU,CAAC;CAC7G;AACF,CAAC"}
+{"version":3,"file":"drawer.js","names":[],"sources":["../../../src/components/drawer/drawer.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// 提供 drawer 相关实现。\n\nimport type { OverlayBackdropVariant, Size } from '@xihan-ui/core'\nimport type { DrawerApi, DrawerSchema, DrawerSide } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { provideDrawer, useDrawerContext } from './context'\nimport { useDrawer } from './use-drawer'\n\ntype DrawerProps = DrawerSchema['props']\n\n/** 默认插槽的载荷：展开状态、已解析的滑出边，与开合命令。 */\nexport type DrawerRootSlotProps = Pick<DrawerApi, 'open' | 'side' | 'setOpen'>\n\nexport const XhDrawerRoot = defineComponent({\n  name: 'XhDrawerRoot',\n  props: {\n    // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    modal: { type: Boolean, default: undefined },\n    side: { type: String as PropType<DrawerSide> },\n    role: { type: String as PropType<'dialog' | 'alertdialog'> },\n    closeOnEscape: { type: Boolean, default: undefined },\n    closeOnInteractOutside: { type: Boolean, default: undefined },\n    restoreFocus: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<OverlayBackdropVariant> },\n    /**\n     * 挂载的容器（CSS 选择器或元素）。提供后即为局部抽屉：\n     * 浮层迁移进该容器，遮罩与定位层从 fixed 换为 absolute，只覆盖它而不是整屏。\n     *\n     * 该容器要自带 position（relative 等），否则 absolute 会向上找到其他定位祖先。\n     * 未提供时查询全局配置的 portalContainer，再没有才落到 body。\n     */\n    container: { type: [String, Object] as PropType<string | Element> },\n    /**\n     * 只把绘制方式改为局部（遮罩与定位层从 fixed 换为 absolute），不改变迁移位置。\n     * 提供 container 后默认为真，不必再写一遍；两个都未提供即铺满视口。\n     */\n    contained: { type: Boolean, default: undefined },\n    /** 可调厚度：朝向页面那条边上的把手拖动或用方向键推。 */\n    resizable: { type: Boolean, default: undefined },\n    /** 受控厚度（像素），支持 v-model:panel-size；未提供即非受控。 */\n    panelSize: { type: Number },\n    defaultPanelSize: { type: Number },\n    minPanelSize: { type: Number },\n    maxPanelSize: { type: Number },\n    translations: { type: Object as PropType<DrawerProps['translations']> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔；panel-size-change 携带 { panelSize }\n  emits: {\n    'open-change': (_details: PayloadOf<DrawerProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<DrawerProps, 'onOpenChange'>['open']) => true,\n    'exit-complete': () => true,\n    'panel-size-change': (_details: PayloadOf<DrawerProps, 'onPanelSizeChange'>) => true,\n    'update:panelSize': (_size: PayloadOf<DrawerProps, 'onPanelSizeChange'>['panelSize']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DrawerRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: DrawerProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    // 容器一处给定，两件事都从它派生：contained 交给机器（皮肤据此把遮罩与定位层\n    // 从 fixed 换成 absolute），同一个值又是 Teleport 的落点，两边不会各说各话\n    const notifySize: DrawerProps['onPanelSizeChange'] = (details) => {\n      emit('panel-size-change', details)\n      emit('update:panelSize', details.panelSize)\n    }\n    const ctx = useDrawer(withXhConfig('drawer', props) as DrawerProps, notify, () => props.container, () => emit('exit-complete'), notifySize)\n    provideDrawer(ctx)\n    // root 是真实节点，content 会被 portal 到 body，data-side 挂在这里供页面内的部分读取\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      side: ctx.api.value.side,\n      setOpen: ctx.api.value.setOpen,\n    }))\n  },\n})\n\nexport const XhDrawerTrigger = defineComponent({\n  name: 'XhDrawerTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useDrawerContext()\n    return () => {\n      const part = mergePartProps(ctx.api.value.getTriggerProps() as Record<string, unknown>, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'drawer')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhDrawerContent = defineComponent({\n  name: 'XhDrawerContent',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 content 上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useDrawerContext()\n    return () => {\n      // presence 判定不在场则整棵不渲染，退场动画播完才翻假\n      if (!ctx.rendered.value)\n        return null\n      const api = ctx.api.value\n      const backdrop = api.getBackdropProps() as Record<string, unknown>\n      return h(XhPortal, { to: ctx.portalTarget.value }, () => [\n        !backdrop.hidden\n          ? h('div', {\n              ...backdrop,\n              ref: (el: unknown) => { ctx.backdropRef.value = el as HTMLElement },\n            })\n          : null,\n        h('div', api.getPositionerProps() as Record<string, unknown>, [\n          h('div', {\n            ...mergeProps(api.getContentProps() as Record<string, unknown>, attrs),\n            hidden: !ctx.rendered.value || undefined,\n            ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n          }, slots.default?.()),\n        ]),\n      ])\n    }\n  },\n})\n\nexport const XhDrawerHeader = defineComponent({\n  name: 'XhDrawerHeader',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('header', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerTitle = defineComponent({\n  name: 'XhDrawerTitle',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerDescription = defineComponent({\n  name: 'XhDrawerDescription',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerBody = defineComponent({\n  name: 'XhDrawerBody',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('div', ctx.api.value.getBodyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerFooter = defineComponent({\n  name: 'XhDrawerFooter',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('footer', ctx.api.value.getFooterProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDrawerCloseTrigger = defineComponent({\n  name: 'XhDrawerCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useDrawerContext()\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 改尺把手：role=separator，落在朝向页面的那条边上；放在 XhDrawerContent 里。 */\nexport const XhDrawerResizeTrigger = defineComponent({\n  name: 'XhDrawerResizeTrigger',\n  setup() {\n    const ctx = useDrawerContext()\n    return () => h('div', ctx.api.value.getResizeTriggerProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}

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

@@ -11,7 +11,7 @@ interface DrawerContext {
   /** 浮层迁移到的位置：实例提供的容器 > 全局配置 > 单一落点。 */
   portalTarget: ComputedRef<string | Element>;
 }
-declare function useDrawer(props: DrawerSchema['props'], onOpenChange?: DrawerSchema['props']['onOpenChange'], container?: () => string | Element | null | undefined, onExitComplete?: DrawerSchema['props']['onExitComplete']): DrawerContext;
+declare function useDrawer(props: DrawerSchema['props'], onOpenChange?: DrawerSchema['props']['onOpenChange'], container?: () => string | Element | null | undefined, onExitComplete?: DrawerSchema['props']['onExitComplete'], onPanelSizeChange?: DrawerSchema['props']['onPanelSizeChange']): DrawerContext;
 //#endregion
 export { DrawerContext, useDrawer };
 //# sourceMappingURL=use-drawer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-drawer.d.ts","names":[],"sources":["../../../src/components/drawer/use-drawer.ts"],"mappings":";;;;UAoBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,UAAU;EACV,YAAY,IAAI;EAChB,aAAa,IAAI;;EAEjB,cAAc,qBAAqB;;iBAGrB,UACd,OAAO,uBACP,eAAe,uCACf,2BAA2B,4BAC3B,iBAAiB,0CAChB"}
+{"version":3,"file":"use-drawer.d.ts","names":[],"sources":["../../../src/components/drawer/use-drawer.ts"],"mappings":";;;;UAmBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,UAAU;EACV,YAAY,IAAI;EAChB,aAAa,IAAI;;EAEjB,cAAc,qBAAqB;;iBAGrB,UACd,OAAO,uBACP,eAAe,uCACf,2BAA2B,4BAC3B,iBAAiB,yCACjB,oBAAoB,6CACnB"}

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

@@ -1,13 +1,13 @@
+import { useOverlayExit } from "../../runtime/use-overlay-exit.js";
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useXhConfig } from "../../config/config.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
-import { computed, onBeforeUnmount, ref, watch } from "vue";
-import { attachCssExit, createPresence } from "@xihan-ui/core/presence";
+import { computed, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
 import { connectDrawer, drawerMachine } from "@xihan-ui/headless";
 //#region src/components/drawer/use-drawer.ts
-function useDrawer(props, onOpenChange, container, onExitComplete) {
+function useDrawer(props, onOpenChange, container, onExitComplete, onPanelSizeChange) {
 	const xhConfig = useXhConfig();
 	const contentRef = ref(null);
 	const backdropRef = ref(null);
@@ -17,9 +17,9 @@ function useDrawer(props, onOpenChange, container, onExitComplete) {
 		...props,
 		contained: props.contained ?? container?.() != null,
 		onOpenChange,
-		onExitComplete
+		onExitComplete,
+		onPanelSizeChange
 	}), scope);
-	const rendered = ref(service.state.get() === "open");
 	let config = null;
 	if (typeof document !== "undefined") {
 		config = createRuntimeConfig({
@@ -34,36 +34,19 @@ function useDrawer(props, onOpenChange, container, onExitComplete) {
 			isModal: () => props.modal ?? true,
 			surfaces: () => [backdropRef.value].filter(Boolean)
 		});
-		const presence = createPresence({
-			config,
-			open: service.state.get() === "open",
-			onRenderedChange: (r) => {
-				rendered.value = r;
-			}
-		});
-		rendered.value = presence.rendered;
 		service.refs.set("config", config);
 		service.refs.set("registerLayer", registerLayer);
-		service.refs.set("presence", presence);
 		service.refs.set("getContentEl", () => contentRef.value);
 		service.refs.set("getTriggerEl", () => null);
 		service.refs.set("branches", () => []);
-		watch(() => service.state.get() === "open", (open) => presence.update(open), { flush: "post" });
-		const tracked = /* @__PURE__ */ new Map();
-		watch([contentRef, backdropRef], (nodes) => {
-			const next = new Set(nodes.filter((node) => node !== null));
-			for (const node of next) if (!tracked.has(node)) tracked.set(node, attachCssExit(node, presence));
-			for (const [node, detach] of tracked) if (!next.has(node)) {
-				tracked.delete(node);
-				detach();
-			}
-		}, { flush: "post" });
-		onBeforeUnmount(() => {
-			presence.dispose();
-			for (const detach of tracked.values()) detach();
-			tracked.clear();
-		});
 	}
+	const rendered = useOverlayExit({
+		config,
+		isOpen: () => service.state.get() === "open",
+		contentRef,
+		additionalExitRefs: [backdropRef],
+		onPresence: (presence) => service.refs.set("presence", presence)
+	});
 	return {
 		service,
 		api: computed(() => connectDrawer(service, vueNormalize)),

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

@@ -1 +1 @@
-{"version":3,"file":"use-drawer.js","names":[],"sources":["../../../src/components/drawer/use-drawer.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 drawer 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { PresenceHandle } from '@xihan-ui/core/presence'\nimport type { DrawerApi, DrawerSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { attachCssExit, createPresence } from '@xihan-ui/core/presence'\nimport { connectDrawer, drawerMachine } from '@xihan-ui/headless'\nimport { computed, onBeforeUnmount, ref, watch } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface DrawerContext {\n  service: Service<DrawerSchema>\n  api: ComputedRef<DrawerApi>\n  rendered: Ref<boolean>\n  contentRef: Ref<HTMLElement | null>\n  backdropRef: Ref<HTMLElement | null>\n  /** 浮层迁移到的位置：实例提供的容器 > 全局配置 > 单一落点。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useDrawer(\n  props: DrawerSchema['props'],\n  onOpenChange?: DrawerSchema['props']['onOpenChange'],\n  container?: () => string | Element | null | undefined,\n  onExitComplete?: DrawerSchema['props']['onExitComplete'],\n): DrawerContext {\n  // 应用级默认挂载点：core 的 RuntimeConfig 一直留着这个字段，这里把它真正接上\n  const xhConfig = useXhConfig()\n  const contentRef = ref<HTMLElement | null>(null)\n  const backdropRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // contained 由 container 派生,在 getter 里算:在 setup 期展开 props 会把响应式冻住,\n  // 之后改 side / open 这些都推不动了\n  const service = useMachine(\n    drawerMachine,\n    // 显式写了 contained 以它为准；没写则「给了容器即局部」\n    () => ({ ...props, contained: props.contained ?? container?.() != null, onOpenChange, onExitComplete }),\n    scope,\n  )\n\n  // 初值取状态而不是 false：presence 只在有 DOM 时才建，服务端拿不到它。\n  // 服务端算不出 rendered 就只发一个空占位，客户端水合时补出整棵子树 = mismatch。\n  const rendered = ref(service.state.get() === 'open')\n\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({\n      scope,\n      idGenerator: idGen,\n      // 宿主把滚动搬进内容容器时 body 本身不滚，加锁会是空操作；这条把真正在滚的那层交给滚动锁\n      scrollRoot: () => xhConfig.value.scrollRoot?.() ?? null,\n    })\n    // 只提供注册函数，入栈出栈由机器的 trackOverlay 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'modal',\n      node: () => contentRef.value,\n      branches: () => [],\n      isModal: () => props.modal ?? true,\n      surfaces: () => [backdropRef.value].filter(Boolean) as Element[],\n    })\n    const presence: PresenceHandle = createPresence({\n      config: config!,\n      open: service.state.get() === 'open',\n      onRenderedChange: (r) => {\n        rendered.value = r\n      },\n    })\n    rendered.value = presence.rendered\n\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('presence', presence)\n    service.refs.set('getContentEl', () => contentRef.value)\n    service.refs.set('getTriggerEl', () => null)\n    service.refs.set('branches', () => [])\n\n    // data-state 提交到 DOM 之后再驱动 presence，让退场探测读到正确的 animationName\n    watch(() => service.state.get() === 'open', open => presence.update(open), { flush: 'post' })\n\n    // content 就位后把它的 CSS 退场动画接到 presence 退出租约，无动画时关闭即卸载\n    const tracked = new Map<HTMLElement, Cleanup>()\n    watch([contentRef, backdropRef], (nodes) => {\n      const next = new Set(nodes.filter((node): node is HTMLElement => node !== null))\n      for (const node of next) {\n        if (!tracked.has(node))\n          tracked.set(node, attachCssExit(node, presence))\n      }\n      for (const [node, detach] of tracked) {\n        if (!next.has(node)) {\n          tracked.delete(node)\n          detach()\n        }\n      }\n    }, { flush: 'post' })\n\n    onBeforeUnmount(() => {\n      presence.dispose()\n      for (const detach of tracked.values()) detach()\n      tracked.clear()\n    })\n  }\n\n  const api = computed(() => connectDrawer(service, vueNormalize))\n  // 实例给的容器优先；没给就问全局配置；都没有才落单一落点\n  const portalTarget = computed<string | Element>(() => container?.() ?? xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { service, api, rendered, contentRef, backdropRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;AA8BA,SAAgB,UACd,OACA,cACA,WACA,gBACe;CAEf,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,cAAc,IAAwB,IAAI;CAEhD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CAGrC,MAAM,UAAU,WACd,sBAEO;EAAE,GAAG;EAAO,WAAW,MAAM,aAAa,YAAY,KAAK;EAAM;EAAc;CAAe,IACrG,KACF;CAIA,MAAM,WAAW,IAAI,QAAQ,MAAM,IAAI,MAAM,MAAM;CAEnD,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAC3B;GACA,aAAa;GAEb,kBAAkB,SAAS,MAAM,aAAa,KAAK;EACrD,CAAC;EAED,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GACvB,gBAAgB,CAAC;GACjB,eAAe,MAAM,SAAS;GAC9B,gBAAgB,CAAC,YAAY,KAAK,CAAC,CAAC,OAAO,OAAO;EACpD,CAAC;EACD,MAAM,WAA2B,eAAe;GACtC;GACR,MAAM,QAAQ,MAAM,IAAI,MAAM;GAC9B,mBAAmB,MAAM;IACvB,SAAS,QAAQ;GACnB;EACF,CAAC;EACD,SAAS,QAAQ,SAAS;EAE1B,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,QAAQ;EACrC,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,sBAAsB,IAAI;EAC3C,QAAQ,KAAK,IAAI,kBAAkB,CAAC,CAAC;EAGrC,YAAY,QAAQ,MAAM,IAAI,MAAM,SAAQ,SAAQ,SAAS,OAAO,IAAI,GAAG,EAAE,OAAO,OAAO,CAAC;EAG5F,MAAM,0BAAU,IAAI,IAA0B;EAC9C,MAAM,CAAC,YAAY,WAAW,IAAI,UAAU;GAC1C,MAAM,OAAO,IAAI,IAAI,MAAM,QAAQ,SAA8B,SAAS,IAAI,CAAC;GAC/E,KAAK,MAAM,QAAQ,MACjB,IAAI,CAAC,QAAQ,IAAI,IAAI,GACnB,QAAQ,IAAI,MAAM,cAAc,MAAM,QAAQ,CAAC;GAEnD,KAAK,MAAM,CAAC,MAAM,WAAW,SAC3B,IAAI,CAAC,KAAK,IAAI,IAAI,GAAG;IACnB,QAAQ,OAAO,IAAI;IACnB,OAAO;GACT;EAEJ,GAAG,EAAE,OAAO,OAAO,CAAC;EAEpB,sBAAsB;GACpB,SAAS,QAAQ;GACjB,KAAK,MAAM,UAAU,QAAQ,OAAO,GAAG,OAAO;GAC9C,QAAQ,MAAM;EAChB,CAAC;CACH;CAMA,OAAO;EAAE;EAAS,KAJN,eAAe,cAAc,SAAS,YAAY,CAI1C;EAAG;EAAU;EAAY;EAAa,cAFrC,eAAiC,YAAY,KAAK,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAErE;CAAE;AACzE"}
+{"version":3,"file":"use-drawer.js","names":[],"sources":["../../../src/components/drawer/use-drawer.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 drawer 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { DrawerApi, DrawerSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectDrawer, drawerMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface DrawerContext {\n  service: Service<DrawerSchema>\n  api: ComputedRef<DrawerApi>\n  rendered: Ref<boolean>\n  contentRef: Ref<HTMLElement | null>\n  backdropRef: Ref<HTMLElement | null>\n  /** 浮层迁移到的位置：实例提供的容器 > 全局配置 > 单一落点。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useDrawer(\n  props: DrawerSchema['props'],\n  onOpenChange?: DrawerSchema['props']['onOpenChange'],\n  container?: () => string | Element | null | undefined,\n  onExitComplete?: DrawerSchema['props']['onExitComplete'],\n  onPanelSizeChange?: DrawerSchema['props']['onPanelSizeChange'],\n): DrawerContext {\n  // 应用级默认挂载点：core 的 RuntimeConfig 一直留着这个字段，这里把它真正接上\n  const xhConfig = useXhConfig()\n  const contentRef = ref<HTMLElement | null>(null)\n  const backdropRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // contained 由 container 派生,在 getter 里算:在 setup 期展开 props 会把响应式冻住,\n  // 之后改 side / open 这些都推不动了\n  const service = useMachine(\n    drawerMachine,\n    // 显式写了 contained 以它为准；没写则「给了容器即局部」\n    () => ({ ...props, contained: props.contained ?? container?.() != null, onOpenChange, onExitComplete, onPanelSizeChange }),\n    scope,\n  )\n\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({\n      scope,\n      idGenerator: idGen,\n      // 宿主把滚动搬进内容容器时 body 本身不滚，加锁会是空操作；这条把真正在滚的那层交给滚动锁\n      scrollRoot: () => xhConfig.value.scrollRoot?.() ?? null,\n    })\n    // 只提供注册函数，入栈出栈由机器的 trackOverlay 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'modal',\n      node: () => contentRef.value,\n      branches: () => [],\n      isModal: () => props.modal ?? true,\n      surfaces: () => [backdropRef.value].filter(Boolean) as Element[],\n    })\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('getContentEl', () => contentRef.value)\n    service.refs.set('getTriggerEl', () => null)\n    service.refs.set('branches', () => [])\n  }\n\n  // 内容与遮罩的退场动画共同决定何时收起；服务端没有 DOM，可见与否跟着展开态走\n  const rendered = useOverlayExit({\n    config,\n    isOpen: () => service.state.get() === 'open',\n    contentRef,\n    additionalExitRefs: [backdropRef],\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n\n  const api = computed(() => connectDrawer(service, vueNormalize))\n  // 实例给的容器优先；没给就问全局配置；都没有才落单一落点\n  const portalTarget = computed<string | Element>(() => container?.() ?? xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { service, api, rendered, contentRef, backdropRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;AA6BA,SAAgB,UACd,OACA,cACA,WACA,gBACA,mBACe;CAEf,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,cAAc,IAAwB,IAAI;CAEhD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CAGrC,MAAM,UAAU,WACd,sBAEO;EAAE,GAAG;EAAO,WAAW,MAAM,aAAa,YAAY,KAAK;EAAM;EAAc;EAAgB;CAAkB,IACxH,KACF;CAEA,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAC3B;GACA,aAAa;GAEb,kBAAkB,SAAS,MAAM,aAAa,KAAK;EACrD,CAAC;EAED,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GACvB,gBAAgB,CAAC;GACjB,eAAe,MAAM,SAAS;GAC9B,gBAAgB,CAAC,YAAY,KAAK,CAAC,CAAC,OAAO,OAAO;EACpD,CAAC;EACD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,sBAAsB,IAAI;EAC3C,QAAQ,KAAK,IAAI,kBAAkB,CAAC,CAAC;CACvC;CAGA,MAAM,WAAW,eAAe;EAC9B;EACA,cAAc,QAAQ,MAAM,IAAI,MAAM;EACtC;EACA,oBAAoB,CAAC,WAAW;EAChC,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;CAC/D,CAAC;CAMD,OAAO;EAAE;EAAS,KAJN,eAAe,cAAc,SAAS,YAAY,CAI1C;EAAG;EAAU;EAAY;EAAa,cAFrC,eAAiC,YAAY,KAAK,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAErE;CAAE;AACzE"}

package/dist/components/empty-state/empty-state.js

@@ -15,7 +15,10 @@ const XhEmptyStateRoot = defineComponent({
 	setup(props, { slots }) {
 		const ctx = useEmptyState(withXhConfig("empty-state", props));
 		provideEmptyState(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.());
+		return () => h("div", {
+			...ctx.api.value.getRootProps(),
+			ref: ctx.rootRef
+		}, slots.default?.());
 	}
 });
 const XhEmptyStateMedia = defineComponent({

package/dist/components/empty-state/empty-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"empty-state.js","names":[],"sources":["../../../src/components/empty-state/empty-state.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// 提供 empty state 相关实现。\n\nimport type { Tone } from '@xihan-ui/core'\nimport type { EmptyStateLive, EmptyStateProps, EmptyStateStatus } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideEmptyState, useEmptyStateContext } from './context'\nimport { useEmptyState } from './use-empty-state'\n\n/** 根节点渲染为 div，默认值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined */\nexport const XhEmptyStateRoot = defineComponent({\n  name: 'XhEmptyStateRoot',\n  props: {\n    size: { type: String as PropType<'sm' | 'md' | 'lg'> },\n    live: { type: String as PropType<EmptyStateLive> },\n    status: { type: String as PropType<EmptyStateStatus> },\n    tone: { type: String as PropType<Tone> },\n  },\n  setup(props, { slots }) {\n    const ctx = useEmptyState(withXhConfig('empty-state', props as EmptyStateProps))\n    provideEmptyState(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 插画槽，内容由作者塞（img、内联 svg 都行）；与图标槽二选一\nexport const XhEmptyStateMedia = defineComponent({\n  name: 'XhEmptyStateMedia',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('div', ctx.api.value.getMediaProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 装饰性图标容器，内容由作者塞（字形、内联 svg 都行）\nexport const XhEmptyStateIndicator = defineComponent({\n  name: 'XhEmptyStateIndicator',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 标题渲染为 p 而不是 hN：它只做视觉主次，不该往文档大纲里插一级标题\nexport const XhEmptyStateTitle = defineComponent({\n  name: 'XhEmptyStateTitle',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('p', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEmptyStateDescription = defineComponent({\n  name: 'XhEmptyStateDescription',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 操作槽只排版，按钮由作者放进插槽\nexport const XhEmptyStateAction = defineComponent({\n  name: 'XhEmptyStateAction',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('div', ctx.api.value.getActionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAgBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;EACL,MAAM,EAAE,MAAM,OAAuC;EACrD,MAAM,EAAE,MAAM,OAAmC;EACjD,QAAQ,EAAE,MAAM,OAAqC;EACrD,MAAM,EAAE,MAAM,OAAyB;CACzC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,cAAc,aAAa,eAAe,KAAwB,CAAC;EAC/E,kBAAkB,GAAG;EACrB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAGD,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC"}
+{"version":3,"file":"empty-state.js","names":[],"sources":["../../../src/components/empty-state/empty-state.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// 提供 empty state 相关实现。\n\nimport type { Tone } from '@xihan-ui/core'\nimport type { EmptyStateLive, EmptyStateProps, EmptyStateStatus } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideEmptyState, useEmptyStateContext } from './context'\nimport { useEmptyState } from './use-empty-state'\n\n/** 根节点渲染为 div，默认值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined */\nexport const XhEmptyStateRoot = defineComponent({\n  name: 'XhEmptyStateRoot',\n  props: {\n    size: { type: String as PropType<'sm' | 'md' | 'lg'> },\n    live: { type: String as PropType<EmptyStateLive> },\n    status: { type: String as PropType<EmptyStateStatus> },\n    tone: { type: String as PropType<Tone> },\n  },\n  setup(props, { slots }) {\n    const ctx = useEmptyState(withXhConfig('empty-state', props as EmptyStateProps))\n    provideEmptyState(ctx)\n    return () => h('div', { ...ctx.api.value.getRootProps() as Record<string, unknown>, ref: ctx.rootRef }, slots.default?.())\n  },\n})\n\n// 插画槽，内容由作者塞（img、内联 svg 都行）；与图标槽二选一\nexport const XhEmptyStateMedia = defineComponent({\n  name: 'XhEmptyStateMedia',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('div', ctx.api.value.getMediaProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 装饰性图标容器，内容由作者塞（字形、内联 svg 都行）\nexport const XhEmptyStateIndicator = defineComponent({\n  name: 'XhEmptyStateIndicator',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 标题渲染为 p 而不是 hN：它只做视觉主次，不该往文档大纲里插一级标题\nexport const XhEmptyStateTitle = defineComponent({\n  name: 'XhEmptyStateTitle',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('p', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEmptyStateDescription = defineComponent({\n  name: 'XhEmptyStateDescription',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 操作槽只排版，按钮由作者放进插槽\nexport const XhEmptyStateAction = defineComponent({\n  name: 'XhEmptyStateAction',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('div', ctx.api.value.getActionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAgBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;EACL,MAAM,EAAE,MAAM,OAAuC;EACrD,MAAM,EAAE,MAAM,OAAmC;EACjD,QAAQ,EAAE,MAAM,OAAqC;EACrD,MAAM,EAAE,MAAM,OAAyB;CACzC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,cAAc,aAAa,eAAe,KAAwB,CAAC;EAC/E,kBAAkB,GAAG;EACrB,aAAa,EAAE,OAAO;GAAE,GAAG,IAAI,IAAI,MAAM,aAAa;GAA8B,KAAK,IAAI;EAAQ,GAAG,MAAM,UAAU,CAAC;CAC3H;AACF,CAAC;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAGD,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC"}

package/dist/components/empty-state/use-empty-state.js

@@ -1,9 +1,18 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
-import { computed } from "vue";
-import { connectEmptyState } from "@xihan-ui/headless";
+import { useMachine } from "../../runtime/use-machine.js";
+import { isHydratingSetup } from "../../runtime/hydration.js";
+import { computed, shallowRef } from "vue";
+import { connectEmptyState, emptyStateMachine } from "@xihan-ui/headless";
 //#region src/components/empty-state/use-empty-state.ts
 function useEmptyState(props) {
-	return { api: computed(() => connectEmptyState(props, vueNormalize)) };
+	const rootRef = shallowRef(null);
+	const service = useMachine(emptyStateMachine, () => props);
+	service.refs.set("getRootEl", () => rootRef.value);
+	service.refs.set("adopted", isHydratingSetup());
+	return {
+		api: computed(() => connectEmptyState(service, vueNormalize)),
+		rootRef
+	};
 }
 //#endregion
 export { useEmptyState };

package/dist/components/empty-state/use-empty-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-empty-state.js","names":[],"sources":["../../../src/components/empty-state/use-empty-state.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 empty state 相关实现。\n\nimport type { EmptyStateApi, EmptyStateProps } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectEmptyState } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\n\nexport interface EmptyStateContext {\n  api: ComputedRef<EmptyStateApi>\n}\n\n// EmptyState 无状态机也不派生 part id，props 变了由 computed 重算属性\nexport function useEmptyState(props: EmptyStateProps): EmptyStateContext {\n  const api = computed(() => connectEmptyState(props, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;AAkBA,SAAgB,cAAc,OAA2C;CAEvE,OAAO,EAAE,KADG,eAAe,kBAAkB,OAAO,YAAY,CACrD,EAAE;AACf"}
+{"version":3,"file":"use-empty-state.js","names":[],"sources":["../../../src/components/empty-state/use-empty-state.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 empty state 相关实现。\n\nimport type { EmptyStateApi, EmptyStateProps } from '@xihan-ui/headless'\nimport type { ComputedRef, ShallowRef } from 'vue'\nimport { connectEmptyState, emptyStateMachine } from '@xihan-ui/headless'\nimport { computed, shallowRef } from 'vue'\nimport { isHydratingSetup } from '../../runtime/hydration'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface EmptyStateContext {\n  api: ComputedRef<EmptyStateApi>\n  /** 根节点：开幕播不播按它出现与否判断。 */\n  rootRef: ShallowRef<HTMLElement | null>\n}\n\nexport function useEmptyState(props: EmptyStateProps): EmptyStateContext {\n  const rootRef = shallowRef<HTMLElement | null>(null)\n  const service = useMachine(emptyStateMachine, () => props)\n  // 机器在挂载时起跑，出现追踪那时才取根节点\n  service.refs.set('getRootEl', () => rootRef.value)\n  service.refs.set('adopted', isHydratingSetup())\n  const api = computed(() => connectEmptyState(service, vueNormalize))\n  return { api, rootRef }\n}\n"],"mappings":";;;;;;AAqBA,SAAgB,cAAc,OAA2C;CACvE,MAAM,UAAU,WAA+B,IAAI;CACnD,MAAM,UAAU,WAAW,yBAAyB,KAAK;CAEzD,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CACjD,QAAQ,KAAK,IAAI,WAAW,iBAAiB,CAAC;CAE9C,OAAO;EAAE,KADG,eAAe,kBAAkB,SAAS,YAAY,CACvD;EAAG;CAAQ;AACxB"}

package/dist/components/field/field.js

@@ -1,5 +1,5 @@
-import { provideField, useFieldContext } from "./context.js";
 import { isRoleMarker, mergeIntoChild } from "../../runtime/as-child.js";
+import { provideField, useFieldContext } from "./context.js";
 import { useOptionalFormContext, useOptionalFormField } from "../form/context.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { useField } from "./use-field.js";

package/dist/components/field-array/field-array.d.ts

@@ -4,7 +4,7 @@ import { FieldArrayApi, FieldArraySchema, FieldArrayTranslations, FormPath } fro
 //#region src/components/field-array/field-array.d.ts
 type FieldArrayProps = FieldArraySchema['props'];
 /** 默认插槽的载荷：逐行投影与整份值、行数与上下限状态，以及整份替换、增删、移动的动作。 */
-type FieldArrayRootSlotProps = Pick<FieldArrayApi, 'items' | 'value' | 'count' | 'empty' | 'atMin' | 'atMax' | 'canAdd' | 'setValue' | 'add' | 'remove' | 'move' | 'moveUp' | 'moveDown'>;
+type FieldArrayRootSlotProps = Pick<FieldArrayApi, 'items' | 'value' | 'count' | 'empty' | 'atMin' | 'atMax' | 'canAdd' | 'setValue' | 'add' | 'insert' | 'remove' | 'move' | 'moveUp' | 'moveDown'>;
 declare const XhFieldArrayRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: PropType<unknown[]>;

package/dist/components/field-array/field-array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-array.d.ts","names":[],"sources":["../../../src/components/field-array/field-array.ts"],"mappings":";;;;KAiBK,kBAAkB;;KAGX,0BAA0B,KACpC;cAgBW,gCAAgB,8BAAA;;IAKD,MAAA;;;IACO,MAAA;;;;;;;;;IAGC,MAAA;;;;;;;;;;;;;;;;IAKC,MAAA,SAAS;;;IACV,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IAfX,MAAA;;;IACO,MAAA;;;;;;;;;IAGC,MAAA;;;;;;;;;;;;;;;;IAKC,MAAA,SAAS;;;IACV,MAAA,SAAS,QAAQ;;;;;;;;;;;EAQvC,WAAC,OAAO,4BAA4B;kCA2BhD;cAEW,gCAAgB,8BAAA;;IAIU,MAAA;;;;;;;IAAA,MAAA;;;MAQrC,oDAAA;;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAOxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAOpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2CAA2B,0BAAA,oBAAA,4BAAA;;8BAOtC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"field-array.d.ts","names":[],"sources":["../../../src/components/field-array/field-array.ts"],"mappings":";;;;KAiBK,kBAAkB;;KAGX,0BAA0B,KACpC;cAiBW,gCAAgB,8BAAA;;IAKD,MAAA;;;IACO,MAAA;;;;;;;;;IAGC,MAAA;;;;;;;;;;;;;;;;IAKC,MAAA,SAAS;;;IACV,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IAfX,MAAA;;;IACO,MAAA;;;;;;;;;IAGC,MAAA;;;;;;;;;;;;;;;;IAKC,MAAA,SAAS;;;IACV,MAAA,SAAS,QAAQ;;;;;;;;;;;EAQvC,WAAC,OAAO,4BAA4B;kCA4BhD;cAEW,gCAAgB,8BAAA;;IAIU,MAAA;;;;;;;IAAA,MAAA;;;MAQrC,oDAAA;;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAOxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAOpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2CAA2B,0BAAA,oBAAA,4BAAA;;8BAOtC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/field-array/field-array.js

@@ -42,7 +42,10 @@ const XhFieldArrayRoot = defineComponent({
 		};
 		const ctx = useFieldArray(withXhConfig("field-array", useFormControlProps(props)), { onValueChange }, form?.service);
 		provideFieldArray(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
+		return () => h("div", {
+			...ctx.api.value.getRootProps(),
+			ref: ctx.rootRef
+		}, slots.default?.({
 			items: ctx.api.value.items,
 			value: ctx.api.value.value,
 			count: ctx.api.value.count,
@@ -52,6 +55,7 @@ const XhFieldArrayRoot = defineComponent({
 			canAdd: ctx.api.value.canAdd,
 			setValue: ctx.api.value.setValue,
 			add: ctx.api.value.add,
+			insert: ctx.api.value.insert,
 			remove: ctx.api.value.remove,
 			move: ctx.api.value.move,
 			moveUp: ctx.api.value.moveUp,