@xihan-ui/vue 2.1.0 → 3.1.0

package/dist/components/image-cropper/image-cropper.d.ts

@@ -1,10 +1,10 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
-import { ImageCropperApi, ImageCropperHandlePosition, ImageCropperRect, ImageCropperSchema, ImageCropperShape } from "@xihan-ui/headless";
+import { ImageCropperApi, ImageCropperFlip, ImageCropperFlipAxis, ImageCropperHandlePosition, ImageCropperRect, ImageCropperSchema, ImageCropperShape } from "@xihan-ui/headless";
 //#region src/components/image-cropper/image-cropper.d.ts
 type ImageCropperProps = ImageCropperSchema['props'];
-/** 默认插槽的载荷：裁切矩形与图片自然尺寸、缩放与旋转、两种拖动标记，以及修改值、修改倍率与获取结果。 */
-type ImageCropperRootSlotProps = Pick<ImageCropperApi, 'value' | 'zoom' | 'rotation' | 'natural' | 'dragging' | 'resizing' | 'disabled' | 'readOnly' | 'getCropRect' | 'setValue' | 'setZoom' | 'setRotation'>;
+/** 默认插槽的载荷：裁切矩形与图片自然尺寸、缩放、旋转与翻转、两种拖动标记，以及修改值、修改呈现与出图。 */
+type ImageCropperRootSlotProps = Pick<ImageCropperApi, 'value' | 'zoom' | 'rotation' | 'flip' | 'natural' | 'dragging' | 'resizing' | 'disabled' | 'readOnly' | 'getCropRect' | 'toCanvas' | 'setValue' | 'setZoom' | 'setRotation' | 'setFlip' | 'toggleFlip'>;
 declare const XhImageCropperRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   src: {
     type: StringConstructor;
@@ -57,6 +57,12 @@ declare const XhImageCropperRoot: import("vue").DefineComponent<import("vue").Ex
   rotationStep: {
     type: NumberConstructor;
   };
+  flip: {
+    type: PropType<ImageCropperFlip>;
+  };
+  defaultFlip: {
+    type: PropType<ImageCropperFlip>;
+  };
   shape: {
     type: PropType<ImageCropperShape>;
   };
@@ -84,6 +90,8 @@ declare const XhImageCropperRoot: import("vue").DefineComponent<import("vue").Ex
   'update:zoom': (_zoom: PayloadOf<ImageCropperProps, "onZoomChange">["zoom"]) => true;
   'rotation-change': (_details: PayloadOf<ImageCropperProps, "onRotationChange">) => true;
   'update:rotation': (_rotation: PayloadOf<ImageCropperProps, "onRotationChange">["rotation"]) => true;
+  'flip-change': (_details: PayloadOf<ImageCropperProps, "onFlipChange">) => true;
+  'update:flip': (_flip: PayloadOf<ImageCropperProps, "onFlipChange">["flip"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   src: {
     type: StringConstructor;
@@ -136,6 +144,12 @@ declare const XhImageCropperRoot: import("vue").DefineComponent<import("vue").Ex
   rotationStep: {
     type: NumberConstructor;
   };
+  flip: {
+    type: PropType<ImageCropperFlip>;
+  };
+  defaultFlip: {
+    type: PropType<ImageCropperFlip>;
+  };
   shape: {
     type: PropType<ImageCropperShape>;
   };
@@ -161,6 +175,8 @@ declare const XhImageCropperRoot: import("vue").DefineComponent<import("vue").Ex
   "onUpdate:zoom"?: ((_zoom: number) => any) | undefined;
   "onRotation-change"?: ((_details: import("@xihan-ui/headless").ImageCropperRotationChangeDetails) => any) | undefined;
   "onUpdate:rotation"?: ((_rotation: number) => any) | undefined;
+  "onFlip-change"?: ((_details: import("@xihan-ui/headless").ImageCropperFlipChangeDetails) => any) | undefined;
+  "onUpdate:flip"?: ((_flip: ImageCropperFlip) => any) | undefined;
 }>, {
   disabled: boolean;
   readOnly: boolean;
@@ -200,9 +216,24 @@ declare const XhImageCropperZoomSlider: import("vue").DefineComponent<{}, () =>
 declare const XhImageCropperRotateSlider: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhImageCropperFlipTrigger: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 这颗按钮翻哪条轴，必填。 */
+  axis: {
+    type: PropType<ImageCropperFlipAxis>;
+    required: true;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 这颗按钮翻哪条轴，必填。 */
+  axis: {
+    type: PropType<ImageCropperFlipAxis>;
+    required: true;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhImageCropperHiddenInput: 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 { ImageCropperRootSlotProps, XhImageCropperCropArea, XhImageCropperCropHandle, XhImageCropperGrid, XhImageCropperHiddenInput, XhImageCropperImage, XhImageCropperRoot, XhImageCropperRotateSlider, XhImageCropperViewport, XhImageCropperZoomSlider };
+export { ImageCropperRootSlotProps, XhImageCropperCropArea, XhImageCropperCropHandle, XhImageCropperFlipTrigger, XhImageCropperGrid, XhImageCropperHiddenInput, XhImageCropperImage, XhImageCropperRoot, XhImageCropperRotateSlider, XhImageCropperViewport, XhImageCropperZoomSlider };
 //# sourceMappingURL=image-cropper.d.ts.map

package/dist/components/image-cropper/image-cropper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-cropper.d.ts","names":[],"sources":["../../../src/components/image-cropper/image-cropper.ts"],"mappings":";;;;KAsBK,oBAAoB;;KAGb,4BAA4B,KACtC;cAKW,kCAAkB,8BAAA;;;;;;;;IAMI,MAAA;;;IACN,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAahB,MAAA,SAAS;;;;;;;;;;;;;;IAKhB,MAAA,SAAS;;;;;EAMA,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACJ,qBAAA,UAAA,UAAU;EACf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACH,oBAAA,UAAA,UAAU;EACT,oBAAA,WAAA,UAAU;;;;;;;;;IAhCV,MAAA;;;IACN,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAahB,MAAA,SAAS;;;;;;;;;;;;;;IAKhB,MAAA,SAAS;;;;;;;;;;;;;;EAejB,WAAC,OAAO,8BAA8B;kCAsClD;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAUjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,8BAAA;;;IAIL,MAAA,SAAS;;;;;;;;IAAT,MAAA,SAAS;;;MAWvC,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAMrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"image-cropper.d.ts","names":[],"sources":["../../../src/components/image-cropper/image-cropper.ts"],"mappings":";;;;KAwBK,oBAAoB;;KAGb,4BAA4B,KACtC;cAKW,kCAAkB,8BAAA;;;;;;;;IAMI,MAAA;;;IACN,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAajB,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACf,MAAA,SAAS;;;;;;;;;;;;;;IAKhB,MAAA,SAAS;;;;;EAMA,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACJ,qBAAA,UAAA,UAAU;EACf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACH,oBAAA,UAAA,UAAU;EACT,oBAAA,WAAA,UAAU;EACf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;IApCF,MAAA;;;IACN,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAajB,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACf,MAAA,SAAS;;;;;;;;;;;;;;IAKhB,MAAA,SAAS;;;;;;;;;;;;;;;;EAiBjB,WAAC,OAAO,8BAA8B;kCA8ClD;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAUjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAU9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,8BAAA;;;IAIL,MAAA,SAAS;;;;;;;;IAAT,MAAA,SAAS;;;MAWvC,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAMrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,8BAAA;;;IAIV,MAAA,SAAS;;;;;;;;IAAT,MAAA,SAAS;;;MAUnC,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/image-cropper/image-cropper.js

@@ -24,6 +24,8 @@ const XhImageCropperRoot = defineComponent({
 		minRotation: { type: Number },
 		maxRotation: { type: Number },
 		rotationStep: { type: Number },
+		flip: { type: Object },
+		defaultFlip: { type: Object },
 		shape: { type: String },
 		disabled: {
 			type: Boolean,
@@ -43,7 +45,9 @@ const XhImageCropperRoot = defineComponent({
 		"zoom-change": (_details) => true,
 		"update:zoom": (_zoom) => true,
 		"rotation-change": (_details) => true,
-		"update:rotation": (_rotation) => true
+		"update:rotation": (_rotation) => true,
+		"flip-change": (_details) => true,
+		"update:flip": (_flip) => true
 	},
 	slots: Object,
 	setup(props, { slots, emit }) {
@@ -62,26 +66,35 @@ const XhImageCropperRoot = defineComponent({
 			emit("rotation-change", details);
 			emit("update:rotation", details.rotation);
 		};
+		const onFlipChange = (details) => {
+			emit("flip-change", details);
+			emit("update:flip", details.flip);
+		};
 		const ctx = useImageCropper(withXhConfig("image-cropper", useFormControlProps(props)), {
 			onValueChange,
 			onValueChangeEnd,
 			onZoomChange,
-			onRotationChange
+			onRotationChange,
+			onFlipChange
 		});
 		provideImageCropper(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
 			value: ctx.api.value.value,
 			zoom: ctx.api.value.zoom,
 			rotation: ctx.api.value.rotation,
+			flip: ctx.api.value.flip,
 			natural: ctx.api.value.natural,
 			dragging: ctx.api.value.dragging,
 			resizing: ctx.api.value.resizing,
 			disabled: ctx.api.value.disabled,
 			readOnly: ctx.api.value.readOnly,
 			getCropRect: ctx.api.value.getCropRect,
+			toCanvas: ctx.api.value.toCanvas,
 			setValue: ctx.api.value.setValue,
 			setZoom: ctx.api.value.setZoom,
-			setRotation: ctx.api.value.setRotation
+			setRotation: ctx.api.value.setRotation,
+			setFlip: ctx.api.value.setFlip,
+			toggleFlip: ctx.api.value.toggleFlip
 		}));
 	}
 });
@@ -99,7 +112,10 @@ const XhImageCropperImage = defineComponent({
 	name: "XhImageCropperImage",
 	setup() {
 		const ctx = useImageCropperContext();
-		return () => h("img", ctx.api.value.getImageProps());
+		return () => h("img", {
+			...ctx.api.value.getImageProps(),
+			ref: ctx.imageRef
+		});
 	}
 });
 const XhImageCropperCropArea = defineComponent({
@@ -143,6 +159,19 @@ const XhImageCropperRotateSlider = defineComponent({
 		return () => h("input", ctx.api.value.getRotateSliderProps());
 	}
 });
+const XhImageCropperFlipTrigger = defineComponent({
+	name: "XhImageCropperFlipTrigger",
+	props: { 
+	/** 这颗按钮翻哪条轴，必填。 */
+axis: {
+		type: String,
+		required: true
+	} },
+	setup(props, { slots }) {
+		const ctx = useImageCropperContext();
+		return () => h("button", ctx.api.value.getFlipTriggerProps({ axis: props.axis }), slots.default?.());
+	}
+});
 const XhImageCropperHiddenInput = defineComponent({
 	name: "XhImageCropperHiddenInput",
 	setup() {
@@ -151,6 +180,6 @@ const XhImageCropperHiddenInput = defineComponent({
 	}
 });
 //#endregion
-export { XhImageCropperCropArea, XhImageCropperCropHandle, XhImageCropperGrid, XhImageCropperHiddenInput, XhImageCropperImage, XhImageCropperRoot, XhImageCropperRotateSlider, XhImageCropperViewport, XhImageCropperZoomSlider };
+export { XhImageCropperCropArea, XhImageCropperCropHandle, XhImageCropperFlipTrigger, XhImageCropperGrid, XhImageCropperHiddenInput, XhImageCropperImage, XhImageCropperRoot, XhImageCropperRotateSlider, XhImageCropperViewport, XhImageCropperZoomSlider };
 
 //# sourceMappingURL=image-cropper.js.map

package/dist/components/image-cropper/image-cropper.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-cropper.js","names":[],"sources":["../../../src/components/image-cropper/image-cropper.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// 提供 image cropper 相关实现。\n\nimport type {\n  ImageCropperApi,\n  ImageCropperHandlePosition,\n  ImageCropperRect,\n  ImageCropperSchema,\n  ImageCropperShape,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideImageCropper, useImageCropperContext } from './context'\nimport { useImageCropper } from './use-image-cropper'\n\ntype ImageCropperProps = ImageCropperSchema['props']\n\n/** 默认插槽的载荷：裁切矩形与图片自然尺寸、缩放与旋转、两种拖动标记，以及修改值、修改倍率与获取结果。 */\nexport type ImageCropperRootSlotProps = Pick<\n  ImageCropperApi,\n  'value' | 'zoom' | 'rotation' | 'natural' | 'dragging' | 'resizing' | 'disabled' | 'readOnly'\n  | 'getCropRect' | 'setValue' | 'setZoom' | 'setRotation'\n>\n\nexport const XhImageCropperRoot = defineComponent({\n  name: 'XhImageCropperRoot',\n  // 缺省值由 connect 与机器决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    src: { type: String },\n    alt: { type: String },\n    aspectRatio: { type: Number as PropType<number | null> },\n    value: { type: Object as PropType<ImageCropperRect> },\n    defaultValue: { type: Object as PropType<ImageCropperRect> },\n    minWidth: { type: Number },\n    minHeight: { type: Number },\n    zoom: { type: Number },\n    defaultZoom: { type: Number },\n    minZoom: { type: Number },\n    maxZoom: { type: Number },\n    zoomStep: { type: Number },\n    rotation: { type: Number },\n    defaultRotation: { type: Number },\n    minRotation: { type: Number },\n    maxRotation: { type: Number },\n    rotationStep: { type: Number },\n    shape: { type: String as PropType<ImageCropperShape> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    name: { type: String },\n    translations: {\n      type: Object as PropType<ImageCropperProps['translations']>,\n    },\n  },\n  // value-change 携带 { value }，update:value 携带裸矩形；\n  // value-change-end 在一次指针拖动松手时发一次，一次方向键微调也发一次\n  emits: {\n    'value-change': (_details: PayloadOf<ImageCropperProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<ImageCropperProps, 'onValueChange'>['value']) => true,\n    'value-change-end': (_details: PayloadOf<ImageCropperProps, 'onValueChangeEnd'>) => true,\n    'zoom-change': (_details: PayloadOf<ImageCropperProps, 'onZoomChange'>) => true,\n    'update:zoom': (_zoom: PayloadOf<ImageCropperProps, 'onZoomChange'>['zoom']) => true,\n    'rotation-change': (_details: PayloadOf<ImageCropperProps, 'onRotationChange'>) => true,\n    'update:rotation': (_rotation: PayloadOf<ImageCropperProps, 'onRotationChange'>['rotation']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ImageCropperRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onValueChange: ImageCropperProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const onValueChangeEnd: ImageCropperProps['onValueChangeEnd'] = (details) => {\n      emit('value-change-end', details)\n    }\n    const onZoomChange: ImageCropperProps['onZoomChange'] = (details) => {\n      emit('zoom-change', details)\n      emit('update:zoom', details.zoom)\n    }\n    const onRotationChange: ImageCropperProps['onRotationChange'] = (details) => {\n      emit('rotation-change', details)\n      emit('update:rotation', details.rotation)\n    }\n    const ctx = useImageCropper(\n      withXhConfig('image-cropper', useFormControlProps(props)) as ImageCropperProps,\n      { onValueChange, onValueChangeEnd, onZoomChange, onRotationChange },\n    )\n    provideImageCropper(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      zoom: ctx.api.value.zoom,\n      rotation: ctx.api.value.rotation,\n      natural: ctx.api.value.natural,\n      dragging: ctx.api.value.dragging,\n      resizing: ctx.api.value.resizing,\n      disabled: ctx.api.value.disabled,\n      readOnly: ctx.api.value.readOnly,\n      getCropRect: ctx.api.value.getCropRect,\n      setValue: ctx.api.value.setValue,\n      setZoom: ctx.api.value.setZoom,\n      setRotation: ctx.api.value.setRotation,\n    }))\n  },\n})\n\nexport const XhImageCropperViewport = defineComponent({\n  name: 'XhImageCropperViewport',\n  setup(_, { slots }) {\n    const ctx = useImageCropperContext()\n    // 视口节点交给机器，矩形在指针事件里现量\n    return () => h('div', {\n      ...ctx.api.value.getViewportProps() as Record<string, unknown>,\n      ref: ctx.viewportRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhImageCropperImage = defineComponent({\n  name: 'XhImageCropperImage',\n  setup() {\n    const ctx = useImageCropperContext()\n    // 用原生 img：自然尺寸与 load 事件都归它。src 与 alt 由根上的同名 prop 写进来\n    return () => h('img', ctx.api.value.getImageProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhImageCropperCropArea = defineComponent({\n  name: 'XhImageCropperCropArea',\n  setup(_, { slots }) {\n    const ctx = useImageCropperContext()\n    return () => h('div', ctx.api.value.getCropAreaProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhImageCropperCropHandle = defineComponent({\n  name: 'XhImageCropperCropHandle',\n  props: {\n    /** 该把手拖动的方位，必填。 */\n    position: { type: String as PropType<ImageCropperHandlePosition>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useImageCropperContext()\n    // 用原生 button：它天然可聚焦、天然在 Tab 序列里\n    return () => h(\n      'button',\n      ctx.api.value.getCropHandleProps({ position: props.position }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhImageCropperGrid = defineComponent({\n  name: 'XhImageCropperGrid',\n  setup(_, { slots }) {\n    const ctx = useImageCropperContext()\n    return () => h('div', ctx.api.value.getGridProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhImageCropperZoomSlider = defineComponent({\n  name: 'XhImageCropperZoomSlider',\n  setup() {\n    const ctx = useImageCropperContext()\n    // 用原生 range：拇指拖动、方向键步进与读屏播报都归它\n    return () => h('input', ctx.api.value.getZoomSliderProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhImageCropperRotateSlider = defineComponent({\n  name: 'XhImageCropperRotateSlider',\n  setup() {\n    const ctx = useImageCropperContext()\n    return () => h('input', ctx.api.value.getRotateSliderProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhImageCropperHiddenInput = defineComponent({\n  name: 'XhImageCropperHiddenInput',\n  setup() {\n    const ctx = useImageCropperContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"image-cropper.js","names":[],"sources":["../../../src/components/image-cropper/image-cropper.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// 提供 image cropper 相关实现。\n\nimport type {\n  ImageCropperApi,\n  ImageCropperFlip,\n  ImageCropperFlipAxis,\n  ImageCropperHandlePosition,\n  ImageCropperRect,\n  ImageCropperSchema,\n  ImageCropperShape,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideImageCropper, useImageCropperContext } from './context'\nimport { useImageCropper } from './use-image-cropper'\n\ntype ImageCropperProps = ImageCropperSchema['props']\n\n/** 默认插槽的载荷：裁切矩形与图片自然尺寸、缩放、旋转与翻转、两种拖动标记，以及修改值、修改呈现与出图。 */\nexport type ImageCropperRootSlotProps = Pick<\n  ImageCropperApi,\n  'value' | 'zoom' | 'rotation' | 'flip' | 'natural' | 'dragging' | 'resizing' | 'disabled' | 'readOnly'\n  | 'getCropRect' | 'toCanvas' | 'setValue' | 'setZoom' | 'setRotation' | 'setFlip' | 'toggleFlip'\n>\n\nexport const XhImageCropperRoot = defineComponent({\n  name: 'XhImageCropperRoot',\n  // 缺省值由 connect 与机器决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    src: { type: String },\n    alt: { type: String },\n    aspectRatio: { type: Number as PropType<number | null> },\n    value: { type: Object as PropType<ImageCropperRect> },\n    defaultValue: { type: Object as PropType<ImageCropperRect> },\n    minWidth: { type: Number },\n    minHeight: { type: Number },\n    zoom: { type: Number },\n    defaultZoom: { type: Number },\n    minZoom: { type: Number },\n    maxZoom: { type: Number },\n    zoomStep: { type: Number },\n    rotation: { type: Number },\n    defaultRotation: { type: Number },\n    minRotation: { type: Number },\n    maxRotation: { type: Number },\n    rotationStep: { type: Number },\n    flip: { type: Object as PropType<ImageCropperFlip> },\n    defaultFlip: { type: Object as PropType<ImageCropperFlip> },\n    shape: { type: String as PropType<ImageCropperShape> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    name: { type: String },\n    translations: {\n      type: Object as PropType<ImageCropperProps['translations']>,\n    },\n  },\n  // value-change 携带 { value }，update:value 携带裸矩形；\n  // value-change-end 在一次指针拖动松手时发一次，一次方向键微调也发一次\n  emits: {\n    'value-change': (_details: PayloadOf<ImageCropperProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<ImageCropperProps, 'onValueChange'>['value']) => true,\n    'value-change-end': (_details: PayloadOf<ImageCropperProps, 'onValueChangeEnd'>) => true,\n    'zoom-change': (_details: PayloadOf<ImageCropperProps, 'onZoomChange'>) => true,\n    'update:zoom': (_zoom: PayloadOf<ImageCropperProps, 'onZoomChange'>['zoom']) => true,\n    'rotation-change': (_details: PayloadOf<ImageCropperProps, 'onRotationChange'>) => true,\n    'update:rotation': (_rotation: PayloadOf<ImageCropperProps, 'onRotationChange'>['rotation']) => true,\n    'flip-change': (_details: PayloadOf<ImageCropperProps, 'onFlipChange'>) => true,\n    'update:flip': (_flip: PayloadOf<ImageCropperProps, 'onFlipChange'>['flip']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ImageCropperRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onValueChange: ImageCropperProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const onValueChangeEnd: ImageCropperProps['onValueChangeEnd'] = (details) => {\n      emit('value-change-end', details)\n    }\n    const onZoomChange: ImageCropperProps['onZoomChange'] = (details) => {\n      emit('zoom-change', details)\n      emit('update:zoom', details.zoom)\n    }\n    const onRotationChange: ImageCropperProps['onRotationChange'] = (details) => {\n      emit('rotation-change', details)\n      emit('update:rotation', details.rotation)\n    }\n    const onFlipChange: ImageCropperProps['onFlipChange'] = (details) => {\n      emit('flip-change', details)\n      emit('update:flip', details.flip)\n    }\n    const ctx = useImageCropper(\n      withXhConfig('image-cropper', useFormControlProps(props)) as ImageCropperProps,\n      { onValueChange, onValueChangeEnd, onZoomChange, onRotationChange, onFlipChange },\n    )\n    provideImageCropper(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      zoom: ctx.api.value.zoom,\n      rotation: ctx.api.value.rotation,\n      flip: ctx.api.value.flip,\n      natural: ctx.api.value.natural,\n      dragging: ctx.api.value.dragging,\n      resizing: ctx.api.value.resizing,\n      disabled: ctx.api.value.disabled,\n      readOnly: ctx.api.value.readOnly,\n      getCropRect: ctx.api.value.getCropRect,\n      toCanvas: ctx.api.value.toCanvas,\n      setValue: ctx.api.value.setValue,\n      setZoom: ctx.api.value.setZoom,\n      setRotation: ctx.api.value.setRotation,\n      setFlip: ctx.api.value.setFlip,\n      toggleFlip: ctx.api.value.toggleFlip,\n    }))\n  },\n})\n\nexport const XhImageCropperViewport = defineComponent({\n  name: 'XhImageCropperViewport',\n  setup(_, { slots }) {\n    const ctx = useImageCropperContext()\n    // 视口节点交给机器，矩形在指针事件里现量\n    return () => h('div', {\n      ...ctx.api.value.getViewportProps() as Record<string, unknown>,\n      ref: ctx.viewportRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhImageCropperImage = defineComponent({\n  name: 'XhImageCropperImage',\n  setup() {\n    const ctx = useImageCropperContext()\n    // 用原生 img：自然尺寸与 load 事件都归它，出图也从它取像素。src 与 alt 由根上的同名 prop 写进来\n    return () => h('img', {\n      ...ctx.api.value.getImageProps() as Record<string, unknown>,\n      ref: ctx.imageRef,\n    })\n  },\n})\n\nexport const XhImageCropperCropArea = defineComponent({\n  name: 'XhImageCropperCropArea',\n  setup(_, { slots }) {\n    const ctx = useImageCropperContext()\n    return () => h('div', ctx.api.value.getCropAreaProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhImageCropperCropHandle = defineComponent({\n  name: 'XhImageCropperCropHandle',\n  props: {\n    /** 该把手拖动的方位，必填。 */\n    position: { type: String as PropType<ImageCropperHandlePosition>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useImageCropperContext()\n    // 用原生 button：它天然可聚焦、天然在 Tab 序列里\n    return () => h(\n      'button',\n      ctx.api.value.getCropHandleProps({ position: props.position }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhImageCropperGrid = defineComponent({\n  name: 'XhImageCropperGrid',\n  setup(_, { slots }) {\n    const ctx = useImageCropperContext()\n    return () => h('div', ctx.api.value.getGridProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhImageCropperZoomSlider = defineComponent({\n  name: 'XhImageCropperZoomSlider',\n  setup() {\n    const ctx = useImageCropperContext()\n    // 用原生 range：拇指拖动、方向键步进与读屏播报都归它\n    return () => h('input', ctx.api.value.getZoomSliderProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhImageCropperRotateSlider = defineComponent({\n  name: 'XhImageCropperRotateSlider',\n  setup() {\n    const ctx = useImageCropperContext()\n    return () => h('input', ctx.api.value.getRotateSliderProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhImageCropperFlipTrigger = defineComponent({\n  name: 'XhImageCropperFlipTrigger',\n  props: {\n    /** 这颗按钮翻哪条轴，必填。 */\n    axis: { type: String as PropType<ImageCropperFlipAxis>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useImageCropperContext()\n    return () => h(\n      'button',\n      ctx.api.value.getFlipTriggerProps({ axis: props.axis }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhImageCropperHiddenInput = defineComponent({\n  name: 'XhImageCropperHiddenInput',\n  setup() {\n    const ctx = useImageCropperContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}

package/dist/components/image-cropper/use-image-cropper.d.ts

@@ -7,8 +7,10 @@ interface ImageCropperContext {
   service: Service<ImageCropperSchema>;
   /** 视口节点，状态机在指针事件中读取它的矩形。 */
   viewportRef: Ref<HTMLElement | null>;
+  /** 源图节点，出图时从它取像素。 */
+  imageRef: Ref<HTMLImageElement | null>;
 }
-type Handlers = Pick<ImageCropperSchema['props'], 'onValueChange' | 'onValueChangeEnd' | 'onZoomChange' | 'onRotationChange'>;
+type Handlers = Pick<ImageCropperSchema['props'], 'onValueChange' | 'onValueChangeEnd' | 'onZoomChange' | 'onRotationChange' | 'onFlipChange'>;
 declare function useImageCropper(props: ImageCropperSchema['props'], handlers?: Handlers): ImageCropperContext;
 //#endregion
 export { ImageCropperContext, useImageCropper };

package/dist/components/image-cropper/use-image-cropper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-image-cropper.d.ts","names":[],"sources":["../../../src/components/image-cropper/use-image-cropper.ts"],"mappings":";;;;UAeiB;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;EAEjB,aAAa,IAAI;;KAGd,WAAW,KAAK;iBAGL,gBACd,OAAO,6BACP,WAAU,WACT"}
+{"version":3,"file":"use-image-cropper.d.ts","names":[],"sources":["../../../src/components/image-cropper/use-image-cropper.ts"],"mappings":";;;;UAeiB;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;EAEjB,aAAa,IAAI;;EAEjB,UAAU,IAAI;;KAGX,WAAW,KAAK;iBAGL,gBACd,OAAO,6BACP,WAAU,WACT"}

package/dist/components/image-cropper/use-image-cropper.js

@@ -5,15 +5,18 @@ import { connectImageCropper, imageCropperMachine } from "@xihan-ui/headless";
 //#region src/components/image-cropper/use-image-cropper.ts
 function useImageCropper(props, handlers = {}) {
 	const viewportRef = ref(null);
+	const imageRef = ref(null);
 	const service = useMachine(imageCropperMachine, () => ({
 		...props,
 		...handlers
 	}));
 	service.refs.set("getViewportEl", () => viewportRef.value);
+	service.refs.set("getImageEl", () => imageRef.value);
 	return {
 		api: computed(() => connectImageCropper(service, vueNormalize)),
 		service,
-		viewportRef
+		viewportRef,
+		imageRef
 	};
 }
 //#endregion

package/dist/components/image-cropper/use-image-cropper.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-image-cropper.js","names":[],"sources":["../../../src/components/image-cropper/use-image-cropper.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 image cropper 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { ImageCropperApi, ImageCropperSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectImageCropper, imageCropperMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface ImageCropperContext {\n  api: ComputedRef<ImageCropperApi>\n  service: Service<ImageCropperSchema>\n  /** 视口节点，状态机在指针事件中读取它的矩形。 */\n  viewportRef: Ref<HTMLElement | null>\n}\n\ntype Handlers = Pick<ImageCropperSchema['props'], 'onValueChange' | 'onValueChangeEnd' | 'onZoomChange' | 'onRotationChange'>\n\n// 不建 scope：connect 不派生任何 id\nexport function useImageCropper(\n  props: ImageCropperSchema['props'],\n  handlers: Handlers = {},\n): ImageCropperContext {\n  const viewportRef = ref<HTMLElement | null>(null)\n  const service = useMachine(imageCropperMachine, () => ({ ...props, ...handlers }))\n\n  // 传 getter 而非节点，ref 在挂载后才有值\n  service.refs.set('getViewportEl', () => viewportRef.value)\n\n  const api = computed(() => connectImageCropper(service, vueNormalize))\n  return { api, service, viewportRef }\n}\n"],"mappings":";;;;;AAyBA,SAAgB,gBACd,OACA,WAAqB,CAAC,GACD;CACrB,MAAM,cAAc,IAAwB,IAAI;CAChD,MAAM,UAAU,WAAW,4BAA4B;EAAE,GAAG;EAAO,GAAG;CAAS,EAAE;CAGjF,QAAQ,KAAK,IAAI,uBAAuB,YAAY,KAAK;CAGzD,OAAO;EAAE,KADG,eAAe,oBAAoB,SAAS,YAAY,CACzD;EAAG;EAAS;CAAY;AACrC"}
+{"version":3,"file":"use-image-cropper.js","names":[],"sources":["../../../src/components/image-cropper/use-image-cropper.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 image cropper 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { ImageCropperApi, ImageCropperSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectImageCropper, imageCropperMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface ImageCropperContext {\n  api: ComputedRef<ImageCropperApi>\n  service: Service<ImageCropperSchema>\n  /** 视口节点，状态机在指针事件中读取它的矩形。 */\n  viewportRef: Ref<HTMLElement | null>\n  /** 源图节点，出图时从它取像素。 */\n  imageRef: Ref<HTMLImageElement | null>\n}\n\ntype Handlers = Pick<ImageCropperSchema['props'], 'onValueChange' | 'onValueChangeEnd' | 'onZoomChange' | 'onRotationChange' | 'onFlipChange'>\n\n// 不建 scope：connect 不派生任何 id\nexport function useImageCropper(\n  props: ImageCropperSchema['props'],\n  handlers: Handlers = {},\n): ImageCropperContext {\n  const viewportRef = ref<HTMLElement | null>(null)\n  const imageRef = ref<HTMLImageElement | null>(null)\n  const service = useMachine(imageCropperMachine, () => ({ ...props, ...handlers }))\n\n  // 传 getter 而非节点，ref 在挂载后才有值\n  service.refs.set('getViewportEl', () => viewportRef.value)\n  service.refs.set('getImageEl', () => imageRef.value)\n\n  const api = computed(() => connectImageCropper(service, vueNormalize))\n  return { api, service, viewportRef, imageRef }\n}\n"],"mappings":";;;;;AA2BA,SAAgB,gBACd,OACA,WAAqB,CAAC,GACD;CACrB,MAAM,cAAc,IAAwB,IAAI;CAChD,MAAM,WAAW,IAA6B,IAAI;CAClD,MAAM,UAAU,WAAW,4BAA4B;EAAE,GAAG;EAAO,GAAG;CAAS,EAAE;CAGjF,QAAQ,KAAK,IAAI,uBAAuB,YAAY,KAAK;CACzD,QAAQ,KAAK,IAAI,oBAAoB,SAAS,KAAK;CAGnD,OAAO;EAAE,KADG,eAAe,oBAAoB,SAAS,YAAY,CACzD;EAAG;EAAS;EAAa;CAAS;AAC/C"}

package/dist/components/image-viewer/image-viewer.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 { provideImageViewer, useImageViewerContext } from "./context.js";
 import { useImageViewer } from "./use-image-viewer.js";
 import { defineComponent, h, mergeProps } from "vue";

package/dist/components/image-viewer/use-image-viewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-image-viewer.d.ts","names":[],"sources":["../../../src/components/image-viewer/use-image-viewer.ts"],"mappings":";;;;UAoBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;;EAEjB,cAAc,qBAAqB;EACnC,UAAU;EACV,YAAY,IAAI;EAChB,aAAa,IAAI;;iBAGH,eACd,OAAO,4BACP,WAAU,KAAK,gEACd"}
+{"version":3,"file":"use-image-viewer.d.ts","names":[],"sources":["../../../src/components/image-viewer/use-image-viewer.ts"],"mappings":";;;;UAmBiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;;EAEjB,cAAc,qBAAqB;EACnC,UAAU;EACV,YAAY,IAAI;EAChB,aAAa,IAAI;;iBAGH,eACd,OAAO,4BACP,WAAU,KAAK,gEACd"}

package/dist/components/image-viewer/use-image-viewer.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 { connectImageViewer, imageViewerMachine } from "@xihan-ui/headless";
 //#region src/components/image-viewer/use-image-viewer.ts
@@ -16,7 +16,6 @@ function useImageViewer(props, handlers = {}) {
 		...props,
 		...handlers
 	}), scope);
-	const rendered = ref(service.state.get() === "open");
 	const xhConfig = useXhConfig();
 	let config = null;
 	if (typeof document !== "undefined") {
@@ -32,34 +31,17 @@ function useImageViewer(props, handlers = {}) {
 			isModal: () => 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);
-		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(() => connectImageViewer(service, vueNormalize)),

package/dist/components/image-viewer/use-image-viewer.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-image-viewer.js","names":[],"sources":["../../../src/components/image-viewer/use-image-viewer.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 image viewer 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { PresenceHandle } from '@xihan-ui/core/presence'\nimport type { ImageViewerApi, ImageViewerSchema } 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 { connectImageViewer, imageViewerMachine } 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 ImageViewerContext {\n  service: Service<ImageViewerSchema>\n  api: ComputedRef<ImageViewerApi>\n  /** 浮层迁移到的位置：全局配置 > 单一落点。 */\n  portalTarget: ComputedRef<string | Element>\n  rendered: Ref<boolean>\n  contentRef: Ref<HTMLElement | null>\n  backdropRef: Ref<HTMLElement | null>\n}\n\nexport function useImageViewer(\n  props: ImageViewerSchema['props'],\n  handlers: Pick<ImageViewerSchema['props'], 'onOpenChange' | 'onIndexChange'> = {},\n): ImageViewerContext {\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(imageViewerMachine, () => ({ ...props, ...handlers }), 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: () => 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\n    // data-state 提交到 DOM 之后再驱动 presence，让退场探测读到正确的 animationName\n    watch(() => service.state.get() === 'open', open => presence.update(open), { flush: 'post' })\n\n    // 内容与遮罩各自的动画都要申领退出租约；任一未结束都不能提早释放模态资源。\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(() => connectImageViewer(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,eACd,OACA,WAA+E,CAAC,GAC5D;CACpB,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,cAAc,IAAwB,IAAI;CAEhD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,2BAA2B;EAAE,GAAG;EAAO,GAAG;CAAS,IAAI,KAAK;CAIvF,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;GACf,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;EAGvD,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,mBAAmB,SAAS,YAAY,CAG/C;EAAG;EAAU;EAAY;EAAa,cAFrC,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEpD;CAAE;AACzE"}
+{"version":3,"file":"use-image-viewer.js","names":[],"sources":["../../../src/components/image-viewer/use-image-viewer.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 image viewer 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { ImageViewerApi, ImageViewerSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectImageViewer, imageViewerMachine } 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 ImageViewerContext {\n  service: Service<ImageViewerSchema>\n  api: ComputedRef<ImageViewerApi>\n  /** 浮层迁移到的位置：全局配置 > 单一落点。 */\n  portalTarget: ComputedRef<string | Element>\n  rendered: Ref<boolean>\n  contentRef: Ref<HTMLElement | null>\n  backdropRef: Ref<HTMLElement | null>\n}\n\nexport function useImageViewer(\n  props: ImageViewerSchema['props'],\n  handlers: Pick<ImageViewerSchema['props'], 'onOpenChange' | 'onIndexChange'> = {},\n): ImageViewerContext {\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(imageViewerMachine, () => ({ ...props, ...handlers }), 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: () => 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  }\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(() => connectImageViewer(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,eACd,OACA,WAA+E,CAAC,GAC5D;CACpB,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,cAAc,IAAwB,IAAI;CAEhD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,2BAA2B;EAAE,GAAG;EAAO,GAAG;CAAS,IAAI,KAAK;CAEvF,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;GACf,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;CACzD;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,mBAAmB,SAAS,YAAY,CAG/C;EAAG;EAAU;EAAY;EAAa,cAFrC,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEpD;CAAE;AACzE"}

package/dist/components/infinite-scroll/infinite-scroll.d.ts

@@ -1,5 +1,5 @@
 import { PropType, SlotsType, VNode } from "vue";
-import { InfiniteScrollApi } from "@xihan-ui/headless";
+import { InfiniteScrollApi, InfiniteScrollEdge } from "@xihan-ui/headless";
 //#region src/components/infinite-scroll/infinite-scroll.d.ts
 /** 默认插槽的载荷：取数所处的阶段，以及正在取数与已关闭两个状态。 */
 type InfiniteScrollRootSlotProps = Pick<InfiniteScrollApi, 'phase' | 'loading' | 'disabled'>;
@@ -16,6 +16,10 @@ declare const XhInfiniteScrollRoot: import("vue").DefineComponent<import("vue").
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 取数的那一头：end 在末尾往后取，start 在开头往前取、取数期间保住视口。 */
+  edge: {
+    type: PropType<InfiniteScrollEdge>;
+  };
   /** 裁剪出可视区的滚动容器，默认即整页滚动；distance 的提前量扩展的正是这块区域。 */
   target: {
     type: PropType<HTMLElement | null>;
@@ -36,6 +40,10 @@ declare const XhInfiniteScrollRoot: import("vue").DefineComponent<import("vue").
     type: BooleanConstructor;
     default: undefined;
   };
+  /** 取数的那一头：end 在末尾往后取，start 在开头往前取、取数期间保住视口。 */
+  edge: {
+    type: PropType<InfiniteScrollEdge>;
+  };
   /** 裁剪出可视区的滚动容器，默认即整页滚动；distance 的提前量扩展的正是这块区域。 */
   target: {
     type: PropType<HTMLElement | null>;

package/dist/components/infinite-scroll/infinite-scroll.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"infinite-scroll.d.ts","names":[],"sources":["../../../src/components/infinite-scroll/infinite-scroll.ts"],"mappings":";;;;KAgBY,8BAA8B,KAAK;;cAGlC,oCAAoB,8BAAA;;;;;;;;;;;;;;IAQH,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAAT,MAAA,SAAS;;;;;;;;EAMzB,WAAC,OAAO,gCAAgC;kCAapD;;;;;;cAOW,+CAA+B,0BAAA,oBAAA,4BAAA;;8BAU1C,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BASnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"infinite-scroll.d.ts","names":[],"sources":["../../../src/components/infinite-scroll/infinite-scroll.ts"],"mappings":";;;;KAgBY,8BAA8B,KAAK;;cAGlC,oCAAoB,8BAAA;;;;;;;;;;;;;;IAQL,MAAA,SAAS;;;;IAEP,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAFX,MAAA,SAAS;;;;IAEP,MAAA,SAAS;;;;;;;;EAMzB,WAAC,OAAO,gCAAgC;kCAapD;;;;;;cAOW,+CAA+B,0BAAA,oBAAA,4BAAA;;8BAU1C,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BASnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/infinite-scroll/infinite-scroll.js

@@ -15,6 +15,8 @@ const XhInfiniteScrollRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		/** 取数的那一头：end 在末尾往后取，start 在开头往前取、取数期间保住视口。 */
+		edge: { type: String },
 		/** 裁剪出可视区的滚动容器，默认即整页滚动；distance 的提前量扩展的正是这块区域。 */
 		target: { type: Object }
 	},

package/dist/components/infinite-scroll/infinite-scroll.js.map

@@ -1 +1 @@
-{"version":3,"file":"infinite-scroll.js","names":[],"sources":["../../../src/components/infinite-scroll/infinite-scroll.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// 提供 infinite scroll 相关实现。\n\nimport type { InfiniteScrollApi, InfiniteScrollSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { provideInfiniteScroll, useInfiniteScrollContext } from './context'\nimport { useInfiniteScroll } from './use-infinite-scroll'\n\ntype InfiniteScrollProps = InfiniteScrollSchema['props']\n\n/** 默认插槽的载荷：取数所处的阶段，以及正在取数与已关闭两个状态。 */\nexport type InfiniteScrollRootSlotProps = Pick<InfiniteScrollApi, 'phase' | 'loading' | 'disabled'>\n\n/** 根节点是列表的外壳，状态挂在它上面；滚动本身经浏览器原生通路，组件不接管。 */\nexport const XhInfiniteScrollRoot = defineComponent({\n  name: 'XhInfiniteScrollRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    distance: { type: Number },\n    disabled: { type: Boolean, default: undefined },\n    loading: { type: Boolean, default: undefined },\n    /** 裁剪出可视区的滚动容器，默认即整页滚动；distance 的提前量扩展的正是这块区域。 */\n    target: { type: Object as PropType<HTMLElement | null> },\n  },\n  emits: {\n    load: () => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: InfiniteScrollRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: InfiniteScrollProps['onLoad'] = () => emit('load')\n    // 传响应式 props 对象本身而非快照，供机器每次读时重新展开\n    const ctx = useInfiniteScroll(props as InfiniteScrollProps, notify, () => props.target ?? null)\n    provideInfiniteScroll(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      phase: ctx.api.value.phase,\n      loading: ctx.api.value.loading,\n      disabled: ctx.api.value.disabled,\n    }))\n  },\n})\n\n/**\n * 取下一页的按钮：与哨兵是同一条通路的两个入口。\n * 读屏在虚拟光标模式下不产生滚动事件，哨兵路径无法触及，该按钮是它的键盘等价通路。\n * 文案写在插槽中，组件不代填。\n */\nexport const XhInfiniteScrollLoadMoreTrigger = defineComponent({\n  name: 'XhInfiniteScrollLoadMoreTrigger',\n  setup(_, { slots }) {\n    const ctx = useInfiniteScrollContext()\n    return () => h(\n      'button',\n      ctx.api.value.getLoadMoreTriggerProps() as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\n/** 放置在列表末尾的哨兵，进入可视区即报告应取下一页。 */\nexport const XhInfiniteScrollSentinel = defineComponent({\n  name: 'XhInfiniteScrollSentinel',\n  setup(_, { slots }) {\n    const ctx = useInfiniteScrollContext()\n    return () => h('div', {\n      ...ctx.api.value.getSentinelProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.sentinelRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n"],"mappings":";;;;;AAmBA,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CAEN,OAAO;EACL,UAAU,EAAE,MAAM,OAAO;EACzB,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;;EAE7C,QAAQ,EAAE,MAAM,OAAuC;CACzD;CACA,OAAO,EACL,YAAY,KACd;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,eAA8C,KAAK,MAAM;EAE/D,MAAM,MAAM,kBAAkB,OAA8B,cAAc,MAAM,UAAU,IAAI;EAC9F,sBAAsB,GAAG;EACzB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,OAAO,IAAI,IAAI,MAAM;GACrB,SAAS,IAAI,IAAI,MAAM;GACvB,UAAU,IAAI,IAAI,MAAM;EAC1B,CAAC,CAAC;CACJ;AACF,CAAC;;;;;;AAOD,MAAa,kCAAkC,gBAAgB;CAC7D,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,yBAAyB;EACrC,aAAa,EACX,UACA,IAAI,IAAI,MAAM,wBAAwB,GACtC,MAAM,UAAU,CAClB;CACF;AACF,CAAC;;AAGD,MAAa,2BAA2B,gBAAgB;CACtD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,yBAAyB;EACrC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,iBAAiB;GAClC,MAAM,OAAgB;IAAE,IAAI,YAAY,QAAQ;GAAkB;EACpE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC"}
+{"version":3,"file":"infinite-scroll.js","names":[],"sources":["../../../src/components/infinite-scroll/infinite-scroll.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// 提供 infinite scroll 相关实现。\n\nimport type { InfiniteScrollApi, InfiniteScrollEdge, InfiniteScrollSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { provideInfiniteScroll, useInfiniteScrollContext } from './context'\nimport { useInfiniteScroll } from './use-infinite-scroll'\n\ntype InfiniteScrollProps = InfiniteScrollSchema['props']\n\n/** 默认插槽的载荷：取数所处的阶段，以及正在取数与已关闭两个状态。 */\nexport type InfiniteScrollRootSlotProps = Pick<InfiniteScrollApi, 'phase' | 'loading' | 'disabled'>\n\n/** 根节点是列表的外壳，状态挂在它上面；滚动本身经浏览器原生通路，组件不接管。 */\nexport const XhInfiniteScrollRoot = defineComponent({\n  name: 'XhInfiniteScrollRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    distance: { type: Number },\n    disabled: { type: Boolean, default: undefined },\n    loading: { type: Boolean, default: undefined },\n    /** 取数的那一头：end 在末尾往后取，start 在开头往前取、取数期间保住视口。 */\n    edge: { type: String as PropType<InfiniteScrollEdge> },\n    /** 裁剪出可视区的滚动容器，默认即整页滚动；distance 的提前量扩展的正是这块区域。 */\n    target: { type: Object as PropType<HTMLElement | null> },\n  },\n  emits: {\n    load: () => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: InfiniteScrollRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: InfiniteScrollProps['onLoad'] = () => emit('load')\n    // 传响应式 props 对象本身而非快照，供机器每次读时重新展开\n    const ctx = useInfiniteScroll(props as InfiniteScrollProps, notify, () => props.target ?? null)\n    provideInfiniteScroll(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      phase: ctx.api.value.phase,\n      loading: ctx.api.value.loading,\n      disabled: ctx.api.value.disabled,\n    }))\n  },\n})\n\n/**\n * 取下一页的按钮：与哨兵是同一条通路的两个入口。\n * 读屏在虚拟光标模式下不产生滚动事件，哨兵路径无法触及，该按钮是它的键盘等价通路。\n * 文案写在插槽中，组件不代填。\n */\nexport const XhInfiniteScrollLoadMoreTrigger = defineComponent({\n  name: 'XhInfiniteScrollLoadMoreTrigger',\n  setup(_, { slots }) {\n    const ctx = useInfiniteScrollContext()\n    return () => h(\n      'button',\n      ctx.api.value.getLoadMoreTriggerProps() as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\n/** 放置在列表末尾的哨兵，进入可视区即报告应取下一页。 */\nexport const XhInfiniteScrollSentinel = defineComponent({\n  name: 'XhInfiniteScrollSentinel',\n  setup(_, { slots }) {\n    const ctx = useInfiniteScrollContext()\n    return () => h('div', {\n      ...ctx.api.value.getSentinelProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.sentinelRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n"],"mappings":";;;;;AAmBA,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CAEN,OAAO;EACL,UAAU,EAAE,MAAM,OAAO;EACzB,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;;EAE7C,MAAM,EAAE,MAAM,OAAuC;;EAErD,QAAQ,EAAE,MAAM,OAAuC;CACzD;CACA,OAAO,EACL,YAAY,KACd;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,eAA8C,KAAK,MAAM;EAE/D,MAAM,MAAM,kBAAkB,OAA8B,cAAc,MAAM,UAAU,IAAI;EAC9F,sBAAsB,GAAG;EACzB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,OAAO,IAAI,IAAI,MAAM;GACrB,SAAS,IAAI,IAAI,MAAM;GACvB,UAAU,IAAI,IAAI,MAAM;EAC1B,CAAC,CAAC;CACJ;AACF,CAAC;;;;;;AAOD,MAAa,kCAAkC,gBAAgB;CAC7D,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,yBAAyB;EACrC,aAAa,EACX,UACA,IAAI,IAAI,MAAM,wBAAwB,GACtC,MAAM,UAAU,CAClB;CACF;AACF,CAAC;;AAGD,MAAa,2BAA2B,gBAAgB;CACtD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,yBAAyB;EACrC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,iBAAiB;GAClC,MAAM,OAAgB;IAAE,IAAI,YAAY,QAAQ;GAAkB;EACpE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC"}

package/dist/components/json-viewer/json-viewer.d.ts

@@ -1,9 +1,14 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Direction, Size } from "@xihan-ui/core";
-import { JsonViewerSchema, JsonViewerTranslations, JsonViewerView } from "@xihan-ui/headless";
+import { JsonViewerApi, JsonViewerSchema, JsonViewerTranslations, JsonViewerView } from "@xihan-ui/headless";
 //#region src/components/json-viewer/json-viewer.d.ts
 type JsonViewerProps = JsonViewerSchema['props'];
+/**
+ * 工具条插槽的载荷：搜索命中与在命中之间逐个走的两个动作。
+ * 搜索框、上一条 / 下一条与计数由作者摆在这里，搜索词经 search 交给根。
+ */
+type JsonViewerToolbarSlotProps = Pick<JsonViewerApi, 'searchMatches' | 'activeMatch' | 'nextMatch' | 'prevMatch'>;
 declare const XhJsonViewerRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: PropType<unknown>;
@@ -45,6 +50,10 @@ declare const XhJsonViewerRoot: import("vue").DefineComponent<import("vue").Extr
   size: {
     type: PropType<Size>;
   };
+  /** 搜索词：键名与值里含有它的行即命中，命中行的祖先自动展开，命中片段铺成 mark。 */
+  search: {
+    type: StringConstructor;
+  };
   translations: {
     type: PropType<Partial<JsonViewerTranslations>>;
   };
@@ -94,6 +103,10 @@ declare const XhJsonViewerRoot: import("vue").DefineComponent<import("vue").Extr
   size: {
     type: PropType<Size>;
   };
+  /** 搜索词：键名与值里含有它的行即命中，命中行的祖先自动展开，命中片段铺成 mark。 */
+  search: {
+    type: StringConstructor;
+  };
   translations: {
     type: PropType<Partial<JsonViewerTranslations>>;
   };
@@ -106,7 +119,9 @@ declare const XhJsonViewerRoot: import("vue").DefineComponent<import("vue").Extr
   sortKeys: boolean;
 }, SlotsType<{
   empty?: () => VNode[];
+  /** 树之前的一条：放搜索框与上一条 / 下一条，渲染为根的前一个兄弟。 */
+  toolbar?: (props: JsonViewerToolbarSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { XhJsonViewerRoot };
+export { JsonViewerToolbarSlotProps, XhJsonViewerRoot };
 //# sourceMappingURL=json-viewer.d.ts.map

package/dist/components/json-viewer/json-viewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-viewer.d.ts","names":[],"sources":["../../../src/components/json-viewer/json-viewer.ts"],"mappings":";;;;;KAgBK,kBAAkB;cAkDV,gCAAgB,8BAAA;;IAKS,MAAA;IAAyC;;;IACnD,MAAA,SAAS;;;;IAEN,MAAA,SAAS;;;IACJ,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;IAMhB,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAQb,0BAAA,UAAA,UAAU;EACb,yBAAA,QAAA,UAAU;;;IAtBT,MAAA;IAAyC;;;IACnD,MAAA,SAAS;;;;IAEN,MAAA,SAAS;;;IACJ,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;IAMhB,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;EAIzC,cAAM;kCAsChB"}
+{"version":3,"file":"json-viewer.d.ts","names":[],"sources":["../../../src/components/json-viewer/json-viewer.ts"],"mappings":";;;;;KAgBK,kBAAkB;;;;;KAMX,6BAA6B,KAAK;cAyDjC,gCAAgB,8BAAA;;IAKS,MAAA;IAAyC;;;IACnD,MAAA,SAAS;;;;IAEN,MAAA,SAAS;;;IACJ,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;IAMhB,MAAA,SAAS;;;IACR,MAAA,SAAS;;;;;;;IAGD,MAAA,SAAS,QAAQ;;;;;EAYb,0BAAA,UAAA,UAAU;EACb,yBAAA,QAAA,UAAU;;;IA5BT,MAAA;IAAyC;;;IACnD,MAAA,SAAS;;;;IAEN,MAAA,SAAS;;;IACJ,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;IAMhB,MAAA,SAAS;;;IACR,MAAA,SAAS;;;;;;;IAGD,MAAA,SAAS,QAAQ;;;;;;;;;;EAIzC,cAAM;;EAEJ,WAAC,OAAO,+BAA+B;kCAmDnD"}

package/dist/components/json-viewer/json-viewer.js

@@ -1,8 +1,12 @@
 import { withXhConfig } from "../../config/config.js";
 import { useJsonViewer } from "./use-json-viewer.js";
-import { defineComponent, h } from "vue";
+import { Fragment, defineComponent, h, mergeProps } from "vue";
 import { groupJsonViewerNodesByParent } from "@xihan-ui/headless";
 //#region src/components/json-viewer/json-viewer.ts
+/** 按片段铺文字：命中搜索词的那一段包进 mark 部件，其余原样是文本。 */
+function renderSegments(api, segments) {
+	return segments.map((segment) => segment.matched ? h("mark", api.getMarkProps(), segment.text) : segment.text);
+}
 function renderRows(api, children, parent) {
 	return (children.get(parent) ?? []).map((node) => renderRow(api, children, node));
 }
@@ -14,15 +18,15 @@ function renderRow(api, children, node) {
 	const ref = { value: node.value };
 	if (!node.branch) {
 		const parts = [];
-		if (node.key != null) parts.push(h("span", api.getItemKeyProps(ref), node.key));
-		parts.push(h("span", api.getItemValueProps(ref), api.valueText(node)));
+		if (node.key != null) parts.push(h("span", api.getItemKeyProps(ref), renderSegments(api, api.keySegments(node))));
+		parts.push(h("span", api.getItemValueProps(ref), renderSegments(api, api.valueSegments(node))));
 		return h("div", {
 			...api.getItemProps(ref),
 			key: node.value
 		}, parts);
 	}
 	const control = [h("span", api.getBranchTriggerProps(ref), [h("span", api.getBranchIndicatorProps(ref))])];
-	if (node.key != null) control.push(h("span", api.getBranchTextProps(ref), node.key));
+	if (node.key != null) control.push(h("span", api.getBranchTextProps(ref), renderSegments(api, api.keySegments(node))));
 	control.push(h("span", api.getPreviewProps(ref), api.previewText(node)));
 	const parts = [h("div", api.getBranchControlProps(ref), control)];
 	if (api.isExpanded(node.value)) parts.push(h("div", api.getBranchContentProps(ref), renderRows(api, children, node.value)));
@@ -56,25 +60,39 @@ const XhJsonViewerRoot = defineComponent({
 		},
 		dir: { type: String },
 		size: { type: String },
+		/** 搜索词：键名与值里含有它的行即命中，命中行的祖先自动展开，命中片段铺成 mark。 */
+		search: { type: String },
 		translations: { type: Object }
 	},
 	slots: Object,
+	inheritAttrs: false,
 	emits: {
 		"expanded-value-change": (_details) => true,
 		"update:expandedValue": (_value) => true
 	},
-	setup(props, { emit, slots }) {
+	setup(props, { emit, slots, attrs }) {
 		const notify = (details) => {
 			emit("expanded-value-change", details);
 			emit("update:expandedValue", details.value);
 		};
 		const ctx = useJsonViewer(withXhConfig("json-viewer", props), notify);
 		const renderEmpty = (api) => h("div", api.getEmptyProps(), slots.empty?.() ?? api.emptyText);
+		const renderRoot = (api) => {
+			const rootProps = mergeProps(api.getRootProps(), attrs);
+			if (api.view === "text") return h("div", rootProps, [h("pre", api.getTextProps(), api.text), renderEmpty(api)]);
+			const children = groupJsonViewerNodesByParent(api.visibleNodes);
+			return h("div", rootProps, [h("div", api.getTreeProps(), renderRows(api, children, null)), renderEmpty(api)]);
+		};
 		return () => {
 			const api = ctx.api.value;
-			if (api.view === "text") return h("div", api.getRootProps(), [h("pre", api.getTextProps(), api.text), renderEmpty(api)]);
-			const children = groupJsonViewerNodesByParent(api.visibleNodes);
-			return h("div", api.getRootProps(), [h("div", api.getTreeProps(), renderRows(api, children, null)), renderEmpty(api)]);
+			const toolbar = slots.toolbar?.({
+				searchMatches: api.searchMatches,
+				activeMatch: api.activeMatch,
+				nextMatch: api.nextMatch,
+				prevMatch: api.prevMatch
+			});
+			const root = renderRoot(api);
+			return toolbar ? h(Fragment, [...toolbar, root]) : root;
 		};
 	}
 });