@xihan-ui/vue 2.1.0 → 3.1.0

package/dist/components/dialog/dialog.js.map

@@ -1 +1 @@
-{"version":3,"file":"dialog.js","names":[],"sources":["../../../src/components/dialog/dialog.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// 提供 dialog 相关实现。\n\nimport type { OverlayBackdropVariant, Size } from '@xihan-ui/core'\nimport type { DialogApi, DialogSchema } 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 { provideDialog, useDialogContext } from './context'\nimport { useDialog } from './use-dialog'\n\ntype DialogProps = DialogSchema['props']\n\n/** 默认插槽的载荷：展开态与修改展开的动作。 */\nexport type DialogRootSlotProps = Pick<DialogApi, 'open' | 'setOpen'>\n\nexport const XhDialogRoot = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogRoot',\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    modal: { type: Boolean, default: true },\n    role: { type: String as PropType<'dialog' | 'alertdialog'>, default: 'dialog' },\n    closeOnEscape: { type: Boolean, default: true },\n    closeOnInteractOutside: { type: Boolean, default: undefined },\n    restoreFocus: { type: Boolean, default: true },\n    initialFocus: { type: String },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<OverlayBackdropVariant> },\n    translations: { type: Object as PropType<DialogProps['translations']> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<DialogProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<DialogProps, 'onOpenChange'>['open']) => true,\n    'exit-complete': () => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DialogRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: DialogProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useDialog(withXhConfig('dialog', props) as DialogProps, notify, () => emit('exit-complete'))\n    provideDialog(ctx)\n    return () => slots.default?.({ open: ctx.api.value.open, setOpen: ctx.api.value.setOpen })\n  },\n})\n\nexport const XhDialogTrigger = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useDialogContext()\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, 'dialog')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhDialogContent = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogContent',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 content 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useDialogContext()\n    return () => {\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: props.container ?? 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 XhDialogHeader = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogHeader',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('header', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 语气徽记：未提供内容时由皮肤按节点上的 data-tone 绘制兜底字形，放入节点即整个替换。 */\nexport const XhDialogIndicator = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogIndicator',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogTitle = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogTitle',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogDescription = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogDescription',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogBody = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogBody',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('div', ctx.api.value.getBodyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogFooter = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogFooter',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('footer', ctx.api.value.getFooterProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogCloseTrigger = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"dialog.js","names":[],"sources":["../../../src/components/dialog/dialog.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// 提供 dialog 相关实现。\n\nimport type { OverlayBackdropVariant, Size } from '@xihan-ui/core'\nimport type { DialogApi, DialogSchema } 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 { provideDialog, useDialogContext } from './context'\nimport { useDialog } from './use-dialog'\n\ntype DialogProps = DialogSchema['props']\n\n/** 默认插槽的载荷：展开态与修改展开的动作。 */\nexport type DialogRootSlotProps = Pick<DialogApi, 'open' | 'setOpen'>\n\nexport const XhDialogRoot = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogRoot',\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    modal: { type: Boolean, default: true },\n    role: { type: String as PropType<'dialog' | 'alertdialog'>, default: 'dialog' },\n    closeOnEscape: { type: Boolean, default: true },\n    closeOnInteractOutside: { type: Boolean, default: undefined },\n    restoreFocus: { type: Boolean, default: true },\n    initialFocus: { type: String },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<OverlayBackdropVariant> },\n    /** 可拖动：按住标题栏或拖动把手挪走面板，方向键在把手上挪一步；面板始终夹在视口内。 */\n    draggable: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<DialogProps['translations']> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<DialogProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<DialogProps, 'onOpenChange'>['open']) => true,\n    'exit-complete': () => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DialogRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: DialogProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useDialog(withXhConfig('dialog', props) as DialogProps, notify, () => emit('exit-complete'))\n    provideDialog(ctx)\n    return () => slots.default?.({ open: ctx.api.value.open, setOpen: ctx.api.value.setOpen })\n  },\n})\n\nexport const XhDialogTrigger = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useDialogContext()\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, 'dialog')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhDialogContent = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogContent',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 content 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useDialogContext()\n    return () => {\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: props.container ?? 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 XhDialogHeader = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogHeader',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('header', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 拖动把手：键盘挪动面板的入口；放在 XhDialogHeader 里时铺满标题栏。 */\nexport const XhDialogDragTrigger = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogDragTrigger',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('button', ctx.api.value.getDragTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 语气徽记：未提供内容时由皮肤按节点上的 data-tone 绘制兜底字形，放入节点即整个替换。 */\nexport const XhDialogIndicator = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogIndicator',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogTitle = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogTitle',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogDescription = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogDescription',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogBody = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogBody',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('div', ctx.api.value.getBodyProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogFooter = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogFooter',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('footer', ctx.api.value.getFooterProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogCloseTrigger = /* @__PURE__ */ defineComponent({\n  name: 'XhDialogCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-dialog.d.ts","names":[],"sources":["../../../src/components/dialog/use-dialog.ts"],"mappings":";;;;UAoBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;;EAEjB,cAAc,qBAAqB;EACnC,UAAU;EACV,YAAY,IAAI;EAChB,aAAa,IAAI;;iBAGH,UACd,OAAO,uBACP,eAAe,uCACf,iBAAiB,0CAChB"}
+{"version":3,"file":"use-dialog.d.ts","names":[],"sources":["../../../src/components/dialog/use-dialog.ts"],"mappings":";;;;UAmBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;;EAEjB,cAAc,qBAAqB;EACnC,UAAU;EACV,YAAY,IAAI;EAChB,aAAa,IAAI;;iBAGH,UACd,OAAO,uBACP,eAAe,uCACf,iBAAiB,0CAChB"}

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

@@ -1,9 +1,9 @@
+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 { connectDialog, dialogMachine } from "@xihan-ui/headless";
 //#region src/components/dialog/use-dialog.ts
@@ -17,7 +17,6 @@ function useDialog(props, onOpenChange, onExitComplete) {
 		onOpenChange,
 		onExitComplete
 	}), scope);
-	const rendered = ref(service.state.get() === "open");
 	const xhConfig = useXhConfig();
 	let config = null;
 	if (typeof document !== "undefined") {
@@ -33,36 +32,19 @@ function useDialog(props, onOpenChange, 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(() => connectDialog(service, vueNormalize)),

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

@@ -1 +1 @@
-{"version":3,"file":"use-dialog.js","names":[],"sources":["../../../src/components/dialog/use-dialog.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 dialog 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { PresenceHandle } from '@xihan-ui/core/presence'\nimport type { DialogApi, DialogSchema } 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 { connectDialog, dialogMachine } 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 DialogContext {\n  service: Service<DialogSchema>\n  api: ComputedRef<DialogApi>\n  /** 浮层迁移到的位置：全局配置 > 单一落点。 */\n  portalTarget: ComputedRef<string | Element>\n  rendered: Ref<boolean>\n  contentRef: Ref<HTMLElement | null>\n  backdropRef: Ref<HTMLElement | null>\n}\n\nexport function useDialog(\n  props: DialogSchema['props'],\n  onOpenChange?: DialogSchema['props']['onOpenChange'],\n  onExitComplete?: DialogSchema['props']['onExitComplete'],\n): DialogContext {\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  const service = useMachine(dialogMachine, () => ({ ...props, onOpenChange, onExitComplete }), scope)\n\n  // 初值取状态而不是 false：presence 只在有 DOM 时才建，服务端拿不到它。\n  // 服务端算不出 rendered 就只发一个空占位，客户端水合时补出整棵子树 = mismatch。\n  const rendered = ref(service.state.get() === 'open')\n\n  const xhConfig = useXhConfig()\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,\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(() => connectDialog(service, vueNormalize))\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { service, api, rendered, contentRef, backdropRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;AA8BA,SAAgB,UACd,OACA,cACA,gBACe;CACf,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,cAAc,IAAwB,IAAI;CAEhD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,sBAAsB;EAAE,GAAG;EAAO;EAAc;CAAe,IAAI,KAAK;CAInG,MAAM,WAAW,IAAI,QAAQ,MAAM,IAAI,MAAM,MAAM;CAEnD,MAAM,WAAW,YAAY;CAC7B,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;GAC9C;GACA,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;CAKA,OAAO;EAAE;EAAS,KAHN,eAAe,cAAc,SAAS,YAAY,CAG1C;EAAG;EAAU;EAAY;EAAa,cAFrC,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEpD;CAAE;AACzE"}
+{"version":3,"file":"use-dialog.js","names":[],"sources":["../../../src/components/dialog/use-dialog.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 dialog 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { DialogApi, DialogSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectDialog, dialogMachine } 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 DialogContext {\n  service: Service<DialogSchema>\n  api: ComputedRef<DialogApi>\n  /** 浮层迁移到的位置：全局配置 > 单一落点。 */\n  portalTarget: ComputedRef<string | Element>\n  rendered: Ref<boolean>\n  contentRef: Ref<HTMLElement | null>\n  backdropRef: Ref<HTMLElement | null>\n}\n\nexport function useDialog(\n  props: DialogSchema['props'],\n  onOpenChange?: DialogSchema['props']['onOpenChange'],\n  onExitComplete?: DialogSchema['props']['onExitComplete'],\n): DialogContext {\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  const service = useMachine(dialogMachine, () => ({ ...props, onOpenChange, onExitComplete }), scope)\n\n  const xhConfig = useXhConfig()\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(() => connectDialog(service, vueNormalize))\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { service, api, rendered, contentRef, backdropRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;AA6BA,SAAgB,UACd,OACA,cACA,gBACe;CACf,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,cAAc,IAAwB,IAAI;CAEhD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,sBAAsB;EAAE,GAAG;EAAO;EAAc;CAAe,IAAI,KAAK;CAEnG,MAAM,WAAW,YAAY;CAC7B,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;CAKD,OAAO;EAAE;EAAS,KAHN,eAAe,cAAc,SAAS,YAAY,CAG1C;EAAG;EAAU;EAAY;EAAa,cAFrC,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEpD;CAAE;AACzE"}

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { Size } from "@xihan-ui/core";
-import { DiffChange, DiffModel, DiffViewApi, DiffViewMode, DiffViewSchema, DiffViewTranslations } from "@xihan-ui/headless";
+import { DiffChange, DiffModel, DiffViewApi, DiffViewCommentRequestDetails, DiffViewLineRef, DiffViewMode, DiffViewSchema, DiffViewTranslations } from "@xihan-ui/headless";
 //#region src/components/diff-view/diff-view.d.ts
 type Props = DiffViewSchema['props'];
 /** 默认插槽的载荷：可见行序、增删统计与展开集合。 */
@@ -26,6 +26,13 @@ declare const XhDiffViewRoot: import("vue").DefineComponent<import("vue").Extrac
     type: BooleanConstructor;
     default: undefined;
   };
+  commentable: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  commentLines: {
+    type: PropType<readonly DiffViewLineRef[]>;
+  };
   size: {
     type: PropType<Size>;
   };
@@ -37,6 +44,7 @@ declare const XhDiffViewRoot: import("vue").DefineComponent<import("vue").Extrac
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'expanded-value-change': (_details: PayloadOf<Props, "onExpandedValueChange">) => true;
   'update:expandedValue': (_value: string[]) => true;
+  'comment-request': (_details: PayloadOf<Props, "onCommentRequest">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   model: {
     type: PropType<DiffModel>;
@@ -57,6 +65,13 @@ declare const XhDiffViewRoot: import("vue").DefineComponent<import("vue").Extrac
     type: BooleanConstructor;
     default: undefined;
   };
+  commentable: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  commentLines: {
+    type: PropType<readonly DiffViewLineRef[]>;
+  };
   size: {
     type: PropType<Size>;
   };
@@ -66,8 +81,10 @@ declare const XhDiffViewRoot: import("vue").DefineComponent<import("vue").Extrac
 }>> & Readonly<{
   "onExpanded-value-change"?: ((_details: import("@xihan-ui/headless").DiffViewExpandedValueChangeDetails) => any) | undefined;
   "onUpdate:expandedValue"?: ((_value: string[]) => any) | undefined;
+  "onComment-request"?: ((_details: DiffViewCommentRequestDetails) => any) | undefined;
 }>, {
   wrap: boolean;
+  commentable: boolean;
 }, SlotsType<{
   default?: (props: DiffViewRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -101,7 +118,10 @@ declare const XhDiffViewViewport: import("vue").DefineComponent<{}, () => VNode<
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhDiffViewBody: 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>;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, SlotsType<{
+  default?: () => VNode[];
+  comment?: (props: DiffViewCommentRequestDetails) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhDiffViewEmpty: 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>;

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

@@ -1 +1 @@
-{"version":3,"file":"diff-view.d.ts","names":[],"sources":["../../../src/components/diff-view/diff-view.ts"],"mappings":";;;;;KAiBK,QAAQ;;KAGD,wBAAwB,KAClC;cAIW,8BAAc,8BAAA;;IAGE,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;IAED,MAAA;;;IACO,MAAA;;;;;;;IAEf,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAGb,0BAAA,UAAA,UAAU;EACb,yBAAA;;;IAXR,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;IAED,MAAA;;;IACO,MAAA;;;;;;;IAEf,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;EAOvC,WAAC,OAAO,0BAA0B;kCAoB9C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;cAOW,iCAAiB,8BAAA;;IAGA,MAAA,SAAS,QAAQ;;;;;;;IAAjB,MAAA,SAAS,QAAQ;;;;EAGjC,WAAC;IAAS;QAAoB;kCAc1C;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAwCzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cA6BW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;;cAQW,oCAAoB,0BAAA,oBAAA,4BAAA;;;EAGnB,WAAC;IAAS;QAAoB;kCAa1C"}
+{"version":3,"file":"diff-view.d.ts","names":[],"sources":["../../../src/components/diff-view/diff-view.ts"],"mappings":";;;;;KAiBK,QAAQ;;KAGD,wBAAwB,KAClC;cAIW,8BAAc,8BAAA;;IAGE,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;IAED,MAAA;;;IACO,MAAA;;;;;;;;;;;IAGR,MAAA,kBAAkB;;;IACzB,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAIb,0BAAA,UAAA,UAAU;EACb,yBAAA;EACH,oBAAA,UAAA,UAAU;;;IAff,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;IAED,MAAA;;;IACO,MAAA;;;;;;;;;;;IAGR,MAAA,kBAAkB;;;IACzB,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;EASvC,WAAC,OAAO,0BAA0B;kCAoB9C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAa3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;cAOW,iCAAiB,8BAAA;;IAGA,MAAA,SAAS,QAAQ;;;;;;;IAAjB,MAAA,SAAS,QAAQ;;;;EAGjC,WAAC;IAAS;QAAoB;kCAc1C;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;;EAIb,gBAAM;EACN,WAAC,OAAO,kCAAkC;kCAkDtD;cA6BW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;;cAQW,oCAAoB,0BAAA,oBAAA,4BAAA;;;EAGnB,WAAC;IAAS;QAAoB;kCAa1C"}

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

@@ -1,7 +1,7 @@
 import { withXhConfig } from "../../config/config.js";
 import { provideDiffView, useDiffViewContext } from "./context.js";
 import { useDiffView } from "./use-diff-view.js";
-import { defineComponent, h } from "vue";
+import { defineComponent, h, onBeforeUnmount, onMounted } from "vue";
 import { diffViewSides } from "@xihan-ui/headless";
 //#region src/components/diff-view/diff-view.ts
 const XhDiffViewRoot = defineComponent({
@@ -16,19 +16,25 @@ const XhDiffViewRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		commentable: {
+			type: Boolean,
+			default: void 0
+		},
+		commentLines: { type: Array },
 		size: { type: String },
 		translations: { type: Object }
 	},
 	emits: {
 		"expanded-value-change": (_details) => true,
-		"update:expandedValue": (_value) => true
+		"update:expandedValue": (_value) => true,
+		"comment-request": (_details) => true
 	},
 	slots: Object,
 	setup(props, { slots, emit }) {
 		const ctx = useDiffView(withXhConfig("diff-view", props), (details) => {
 			emit("expanded-value-change", details);
 			emit("update:expandedValue", details.value);
-		});
+		}, (details) => emit("comment-request", details));
 		provideDiffView(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
 			view: ctx.api.value.view,
@@ -47,6 +53,12 @@ const XhDiffViewHeader = defineComponent({
 	name: "XhDiffViewHeader",
 	setup(_, { slots }) {
 		const ctx = useDiffViewContext();
+		onMounted(() => {
+			ctx.headerCount.value++;
+		});
+		onBeforeUnmount(() => {
+			ctx.headerCount.value--;
+		});
 		return () => h("div", ctx.api.value.getHeaderProps(), slots.default?.());
 	}
 });
@@ -80,6 +92,7 @@ const XhDiffViewViewport = defineComponent({
 });
 const XhDiffViewBody = defineComponent({
 	name: "XhDiffViewBody",
+	slots: Object,
 	setup(_, { slots }) {
 		const ctx = useDiffViewContext();
 		return () => {
@@ -97,19 +110,29 @@ const XhDiffViewBody = defineComponent({
 				return h("div", {
 					...api.getRowProps({ rowIndex }),
 					key: `row:${rowIndex}`
-				}, sides.flatMap((side) => [h("span", {
-					...api.getLineNumberProps({
-						rowIndex,
-						side
-					}),
-					key: `n:${side}`
-				}), h("span", {
-					...api.getLineContentProps({
+				}, sides.flatMap((side) => {
+					const cell = {
 						rowIndex,
 						side
-					}),
-					key: `c:${side}`
-				}, [h("span", api.getChangeLabelProps({ change: row.line.change }), api.changeLabel(row.line.change)), ...renderCell(api, rowIndex, side)])]));
+					};
+					const ref = api.commentRefAt(cell);
+					return [h("span", {
+						...api.getLineNumberProps(cell),
+						key: `n:${side}`
+					}), h("span", {
+						...api.getLineContentProps(cell),
+						key: `c:${side}`
+					}, [
+						h("span", api.getChangeLabelProps({ change: row.line.change }), api.changeLabel(row.line.change)),
+						api.commentable && ref !== void 0 ? h("button", api.getCommentTriggerProps(cell)) : null,
+						...renderCell(api, rowIndex, side),
+						api.hasComment(cell) ? h("div", api.getCommentThreadProps(cell), slots.comment?.({
+							...ref,
+							change: row.line.change,
+							text: row.line.text
+						})) : null
+					])];
+				}));
 			}), slots.default?.() ?? []]);
 		};
 	}

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,13 +164,16 @@ 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;
-  modal: boolean;
+  resizable: boolean;
   closeOnEscape: boolean;
   closeOnInteractOutside: boolean;
   restoreFocus: boolean;
+  modal: boolean;
   contained: boolean;
 }, SlotsType<{
   default?: (props: DrawerRootSlotProps) => VNode[];
@@ -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