@xihan-ui/vue 4.1.0 → 5.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"hover-card.js","names":[],"sources":["../../../src/components/hover-card/hover-card.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 hover card 相关实现。\n\nimport type { Direction, Placement, Size } from '@xihan-ui/core'\nimport type { HoverCardApi, HoverCardSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps } from 'vue'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { provideHoverCard, useHoverCardContext } from './context'\nimport { useHoverCard } from './use-hover-card'\n\ntype HoverCardProps = HoverCardSchema['props']\n\n/** 默认插槽的载荷：浮层的开合状态与程序化开合的方法。 */\nexport type HoverCardRootSlotProps = Pick<HoverCardApi, 'open' | 'setOpen'>\n\nexport const XhHoverCardRoot = defineComponent({\n  name: 'XhHoverCardRoot',\n  // 缺省值由机器与 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    openDelay: { type: Number },\n    closeDelay: { type: Number },\n    dir: { type: String as PropType<Direction> },\n    disabled: Boolean,\n    size: { type: String as PropType<Size> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<HoverCardProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<HoverCardProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: HoverCardRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: HoverCardProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useHoverCard(props as HoverCardProps, notify)\n    provideHoverCard(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      setOpen: ctx.api.value.setOpen,\n    }))\n  },\n})\n\nexport const XhHoverCardTrigger = defineComponent({\n  name: 'XhHoverCardTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useHoverCardContext()\n    return () => {\n      const part = mergePartProps({\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'hover-card')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhHoverCardPositioner = defineComponent({\n  name: 'XhHoverCardPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useHoverCardContext()\n    // 卡片内容的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner；浮层里走 4px 档\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhHoverCardContent = defineComponent({\n  name: 'XhHoverCardContent',\n  setup(_, { slots }) {\n    const ctx = useHoverCardContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场\n      // 就一帧都播不出来），所以真正的收起落成内联 display——节点始终留在原地\n      style: ctx.visible.value ? undefined : { display: 'none' },\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhHoverCardTitle = defineComponent({\n  name: 'XhHoverCardTitle',\n  setup(_, { slots }) {\n    const ctx = useHoverCardContext()\n    return () => h('h2', {\n      ...ctx.api.value.getTitleProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.titleRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhHoverCardDescription = defineComponent({\n  name: 'XhHoverCardDescription',\n  setup(_, { slots }) {\n    const ctx = useHoverCardContext()\n    return () => h('p', {\n      ...ctx.api.value.getDescriptionProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.descriptionRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhHoverCardArrow = defineComponent({\n  name: 'XhHoverCardArrow',\n  setup() {\n    const ctx = useHoverCardContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"hover-card.js","names":[],"sources":["../../../src/components/hover-card/hover-card.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 hover card 相关实现。\n\nimport type { Direction, Placement, Size } from '@xihan-ui/core'\nimport type { HoverCardApi, HoverCardSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps } from 'vue'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhPortal } from '../../runtime/portal'\nimport { useDescriptionPart, useTitleDescriptionPart } from '../../runtime/title-description'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { provideHoverCard, useHoverCardContext } from './context'\nimport { useHoverCard } from './use-hover-card'\n\ntype HoverCardProps = HoverCardSchema['props']\n\n/** 默认插槽的载荷：浮层的开合状态与程序化开合的方法。 */\nexport type HoverCardRootSlotProps = Pick<HoverCardApi, 'open' | 'setOpen'>\n\nexport const XhHoverCardRoot = defineComponent({\n  name: 'XhHoverCardRoot',\n  // 缺省值由机器与 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    openDelay: { type: Number },\n    closeDelay: { type: Number },\n    dir: { type: String as PropType<Direction> },\n    disabled: Boolean,\n    size: { type: String as PropType<Size> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<HoverCardProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<HoverCardProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: HoverCardRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: HoverCardProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useHoverCard(props as HoverCardProps, notify)\n    provideHoverCard(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      setOpen: ctx.api.value.setOpen,\n    }))\n  },\n})\n\nexport const XhHoverCardTrigger = defineComponent({\n  name: 'XhHoverCardTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useHoverCardContext()\n    return () => {\n      const part = mergePartProps({\n        ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n      }, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'hover-card')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhHoverCardPositioner = defineComponent({\n  name: 'XhHoverCardPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useHoverCardContext()\n    // 卡片内容的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner；浮层里走 4px 档\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhHoverCardContent = defineComponent({\n  name: 'XhHoverCardContent',\n  setup(_, { slots }) {\n    const ctx = useHoverCardContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场\n      // 就一帧都播不出来），所以真正的收起落成内联 display——节点始终留在原地\n      style: ctx.visible.value ? undefined : { display: 'none' },\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhHoverCardTitle = defineComponent({\n  name: 'XhHoverCardTitle',\n  setup(_, { slots }) {\n    const ctx = useHoverCardContext()\n    useTitleDescriptionPart(ctx.presence, 'title')\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhHoverCardDescription = defineComponent({\n  name: 'XhHoverCardDescription',\n  setup(_, { slots }) {\n    const ctx = useHoverCardContext()\n    // 读不出一句话的说明不进描述链\n    const el = useDescriptionPart(ctx.presence)\n    return () => h('p', { ...ctx.api.value.getDescriptionProps() as Record<string, unknown>, ref: el }, slots.default?.())\n  },\n})\n\nexport const XhHoverCardArrow = defineComponent({\n  name: 'XhHoverCardArrow',\n  setup() {\n    const ctx = useHoverCardContext()\n    return () => h('div', ctx.api.value.getArrowProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}

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

@@ -1,6 +1,7 @@
+import { TitleDescriptionPresence } from "../../runtime/title-description.js";
+import { HoverCardApi, HoverCardSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { HoverCardApi, HoverCardSchema } from "@xihan-ui/headless";
 //#region src/components/hover-card/use-hover-card.d.ts
 interface HoverCardContext {
   service: Service<HoverCardSchema>;
@@ -11,10 +12,8 @@ interface HoverCardContext {
   positionerRef: Ref<HTMLElement | null>;
   /** 消解层节点，也是判定焦点是否仍在卡片内的依据。 */
   contentRef: Ref<HTMLElement | null>;
-  /** title 部件；作者未放置它时卡片的可及名指回 trigger。 */
-  titleRef: Ref<HTMLElement | null>;
-  /** description 部件；作者未放置它时不发 aria-describedby。 */
-  descriptionRef: Ref<HTMLElement | null>;
+  /** 标题与说明在不在场，由 XhHoverCardTitle / XhHoverCardDescription 登记：title 不在场时卡片的可及名指回 trigger。 */
+  presence: TitleDescriptionPresence;
   /** 当前是否应当渲染：退场动画播完之前仍为真。 */
   visible: Ref<boolean>;
   /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */

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

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

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

@@ -3,9 +3,10 @@ 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 { useTitleDescriptionPresence } from "../../runtime/title-description.js";
+import { connectHoverCard, hoverCardMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { connectHoverCard, hoverCardMachine } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/hover-card/use-hover-card.ts
 function useHoverCard(props, onOpenChange) {
@@ -13,12 +14,12 @@ function useHoverCard(props, onOpenChange) {
 	const triggerRef = ref(null);
 	const positionerRef = ref(null);
 	const contentRef = ref(null);
-	const titleRef = ref(null);
-	const descriptionRef = ref(null);
 	const idGen = createVueIdGenerator();
 	const scope = createScope(null, idGen);
+	const presence = useTitleDescriptionPresence();
 	const service = useMachine(hoverCardMachine, () => ({
 		...props,
+		parts: presence.parts.value,
 		onOpenChange
 	}), scope);
 	let config = null;
@@ -41,8 +42,6 @@ function useHoverCard(props, onOpenChange) {
 	service.refs.set("getAnchorEl", () => triggerRef.value);
 	service.refs.set("getFloatingEl", () => positionerRef.value);
 	service.refs.set("getContentEl", () => contentRef.value);
-	service.refs.set("getTitleEl", () => titleRef.value);
-	service.refs.set("getDescriptionEl", () => descriptionRef.value);
 	const api = computed(() => connectHoverCard(service, vueNormalize));
 	return {
 		visible: useOverlayExit({
@@ -56,8 +55,7 @@ function useHoverCard(props, onOpenChange) {
 		triggerRef,
 		positionerRef,
 		contentRef,
-		titleRef,
-		descriptionRef,
+		presence,
 		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body")
 	};
 }

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

@@ -1 +1 @@
-{"version":3,"file":"use-hover-card.js","names":[],"sources":["../../../src/components/hover-card/use-hover-card.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use hover card 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { HoverCardApi, HoverCardSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectHoverCard, hoverCardMachine } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\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 HoverCardContext {\n  service: Service<HoverCardSchema>\n  api: ComputedRef<HoverCardApi>\n  /** 定位锚点。 */\n  triggerRef: Ref<HTMLElement | null>\n  /** 被定位的浮层。 */\n  positionerRef: Ref<HTMLElement | null>\n  /** 消解层节点，也是判定焦点是否仍在卡片内的依据。 */\n  contentRef: Ref<HTMLElement | null>\n  /** title 部件；作者未放置它时卡片的可及名指回 trigger。 */\n  titleRef: Ref<HTMLElement | null>\n  /** description 部件；作者未放置它时不发 aria-describedby。 */\n  descriptionRef: Ref<HTMLElement | null>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useHoverCard(\n  props: HoverCardSchema['props'],\n  onOpenChange?: HoverCardSchema['props']['onOpenChange'],\n): HoverCardContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n  const titleRef = ref<HTMLElement | null>(null)\n  const descriptionRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(hoverCardMachine, () => ({ ...props, onOpenChange }), scope)\n\n  // 无 DOM 环境（SSR）不建引擎与消解层\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按可见态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // trigger 记为本层分支，指针按在它上面算层内交互；\n      // 浮层壳一并记上：卡片之外还浮着自绘滚动条，按住它拖动不该把卡片消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      // 悬停卡片非模态：不陷焦点、不锁滚动、无遮罩\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n  }\n\n  // 元素 getter 在无 DOM 环境下也要设，连接层判定焦点去向时经它们取节点\n  service.refs.set('getAnchorEl', () => triggerRef.value)\n  service.refs.set('getFloatingEl', () => positionerRef.value)\n  service.refs.set('getContentEl', () => contentRef.value)\n  service.refs.set('getTitleEl', () => titleRef.value)\n  service.refs.set('getDescriptionEl', () => descriptionRef.value)\n\n  const api = computed(() => connectHoverCard(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 先问全局配置的落点，没有才落 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, triggerRef, positionerRef, contentRef, titleRef, descriptionRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAuCA,SAAgB,aACd,OACA,cACkB;CAClB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,WAAW,IAAwB,IAAI;CAC7C,MAAM,iBAAiB,IAAwB,IAAI;CAEnD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO;CAAa,IAAI,KAAK;CAItF,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GAEtE,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;CACrD;CAGA,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;CACtD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;CAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACvD,QAAQ,KAAK,IAAI,oBAAoB,SAAS,KAAK;CACnD,QAAQ,KAAK,IAAI,0BAA0B,eAAe,KAAK;CAE/D,MAAM,MAAM,eAAe,iBAAiB,SAAS,YAAY,CAAC;CAWlE,OAAO;EAAE,SATO,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAIe;EAAG;EAAS;EAAK;EAAY;EAAe;EAAY;EAAU;EAAgB,cAF5E,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEb;CAAE;AAChH"}
+{"version":3,"file":"use-hover-card.js","names":[],"sources":["../../../src/components/hover-card/use-hover-card.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use hover card 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { HoverCardApi, HoverCardSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport type { TitleDescriptionPresence } from '../../runtime/title-description'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectHoverCard, hoverCardMachine } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useTitleDescriptionPresence } from '../../runtime/title-description'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface HoverCardContext {\n  service: Service<HoverCardSchema>\n  api: ComputedRef<HoverCardApi>\n  /** 定位锚点。 */\n  triggerRef: Ref<HTMLElement | null>\n  /** 被定位的浮层。 */\n  positionerRef: Ref<HTMLElement | null>\n  /** 消解层节点，也是判定焦点是否仍在卡片内的依据。 */\n  contentRef: Ref<HTMLElement | null>\n  /** 标题与说明在不在场，由 XhHoverCardTitle / XhHoverCardDescription 登记：title 不在场时卡片的可及名指回 trigger。 */\n  presence: TitleDescriptionPresence\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useHoverCard(\n  props: HoverCardSchema['props'],\n  onOpenChange?: HoverCardSchema['props']['onOpenChange'],\n): HoverCardContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const presence = useTitleDescriptionPresence()\n  const service = useMachine(hoverCardMachine, () => ({ ...props, parts: presence.parts.value, onOpenChange }), scope)\n\n  // 无 DOM 环境（SSR）不建引擎与消解层\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按可见态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // trigger 记为本层分支，指针按在它上面算层内交互；\n      // 浮层壳一并记上：卡片之外还浮着自绘滚动条，按住它拖动不该把卡片消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      // 悬停卡片非模态：不陷焦点、不锁滚动、无遮罩\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n  }\n\n  // 元素 getter 在无 DOM 环境下也要设，连接层判定焦点去向时经它们取节点\n  service.refs.set('getAnchorEl', () => triggerRef.value)\n  service.refs.set('getFloatingEl', () => positionerRef.value)\n  service.refs.set('getContentEl', () => contentRef.value)\n\n  const api = computed(() => connectHoverCard(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 先问全局配置的落点，没有才落 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, triggerRef, positionerRef, contentRef, presence, portalTarget }\n}\n"],"mappings":";;;;;;;;;;;AAuCA,SAAgB,aACd,OACA,cACkB;CAClB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,WAAW,4BAA4B;CAC7C,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO,OAAO,SAAS,MAAM;EAAO;CAAa,IAAI,KAAK;CAInH,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GAEtE,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;CACrD;CAGA,QAAQ,KAAK,IAAI,qBAAqB,WAAW,KAAK;CACtD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;CAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CAEvD,MAAM,MAAM,eAAe,iBAAiB,SAAS,YAAY,CAAC;CAWlE,OAAO;EAAE,SATO,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAIe;EAAG;EAAS;EAAK;EAAY;EAAe;EAAY;EAAU,cAF5D,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAE7B;CAAE;AAChG"}

package/dist/components/icon/icon.d.ts

@@ -1,9 +1,9 @@
+import { IconFlip, IconRotate, IconSize, IconWeight } from "@xihan-ui/headless";
 import { PropType, VNode } from "vue";
 import { ActionVariant, IconRecord, Tone } from "@xihan-ui/core";
-import { IconFlip, IconRotate, IconSize, IconWeight } from "@xihan-ui/headless";
 //#region src/components/icon/icon.d.ts
 /**
- * 根 `<svg>` 加一层 `<g>` 空壳，图元铺在空壳中。
+ * 根 `<svg>` 里照 headless 的 iconStructure 铺一层 `<g>` 空壳，图元铺在空壳中。
  * 默认插槽给出内容时改由插槽内容填充根，元素不再生成 glyph 与图元；
  * 判据是插槽产出中有真正会渲染出内容的节点：既不是插槽函数是否存在（宿主可能恒传一个插槽），
  * 也不是产出数组非空（`v-if` 为假时产出中还剩一个注释节点）。

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

@@ -1 +1 @@
-{"version":3,"file":"icon.d.ts","names":[],"sources":["../../../src/components/icon/icon.ts"],"mappings":";;;;;;;;;;cA6Ba,sBAAM,8BAAA;;IAIS,MAAA,SAAS;;;;;;IAET,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACX,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACE,MAAA,SAAS;;;IACrB,MAAA,SAAS;;;;;;IAPT,MAAA,SAAS;;;;;;IAET,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACX,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACE,MAAA,SAAS;;;IACrB,MAAA,SAAS;;MAmBnC,oDAAA"}
+{"version":3,"file":"icon.d.ts","names":[],"sources":["../../../src/components/icon/icon.ts"],"mappings":";;;;;;;;;;cAyCa,sBAAM,8BAAA;;IAIS,MAAA,SAAS;;;;;;IAET,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACX,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACE,MAAA,SAAS;;;IACrB,MAAA,SAAS;;;;;;IAPT,MAAA,SAAS;;;;;;IAET,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACX,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACE,MAAA,SAAS;;;IACrB,MAAA,SAAS;;MAenC,oDAAA"}

package/dist/components/icon/icon.js

@@ -1,6 +1,9 @@
+import { renderStructure } from "../../runtime/structure.js";
+import { vueNormalize } from "../../runtime/normalize-props.js";
 import { withXhConfig } from "../../config/config.js";
 import { slotPaints } from "../../runtime/slot-content.js";
 import { useIcon } from "./use-icon.js";
+import { connectIcon, iconStructure } from "@xihan-ui/headless";
 import { defineComponent, h } from "vue";
 //#region src/components/icon/icon.ts
 /**
@@ -10,8 +13,13 @@ import { defineComponent, h } from "vue";
 function renderNode(node) {
 	return h(node.tag, node.attrs, node.children?.map(renderNode));
 }
+const NO_PROPS = {};
+/** glyph 空壳：只带解剖标记，图元由标准结构的内容回调铺进来。 */
+const XhIconGlyph = (_, { slots }) => h("g", connectIcon(NO_PROPS, vueNormalize).getGlyphProps(), slots.default?.());
+/** 标准结构里各部件对应的组件。 */
+const ICON_PARTS = { glyph: XhIconGlyph };
 /**
-* 根 `<svg>` 加一层 `<g>` 空壳，图元铺在空壳中。
+* 根 `<svg>` 里照 headless 的 iconStructure 铺一层 `<g>` 空壳，图元铺在空壳中。
 * 默认插槽给出内容时改由插槽内容填充根，元素不再生成 glyph 与图元；
 * 判据是插槽产出中有真正会渲染出内容的节点：既不是插槽函数是否存在（宿主可能恒传一个插槽），
 * 也不是产出数组非空（`v-if` 为假时产出中还剩一个注释节点）。
@@ -32,7 +40,7 @@ const XhIcon = defineComponent({
 		const ctx = useIcon(withXhConfig("icon", props));
 		return () => {
 			const authored = slots.default?.();
-			return h("svg", ctx.api.value.getRootProps(), slotPaints(authored) ? authored : [h("g", ctx.api.value.getGlyphProps(), ctx.api.value.nodes.map(renderNode))]);
+			return h("svg", ctx.api.value.getRootProps(), slotPaints(authored) ? authored : renderStructure(iconStructure(), ICON_PARTS, () => ctx.api.value.nodes.map(renderNode)));
 		};
 	}
 });

package/dist/components/icon/icon.js.map

@@ -1 +1 @@
-{"version":3,"file":"icon.js","names":[],"sources":["../../../src/components/icon/icon.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// 提供 icon 相关实现。\n\nimport type { ActionVariant, IconNode, IconRecord, Tone } from '@xihan-ui/core'\nimport type { IconFlip, IconProps, IconRotate, IconSize, IconWeight } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { useIcon } from './use-icon'\n\n/**\n * 把一个图元节点建为 VNode，递归到底。\n * 标签与属性名逐字透传（连字符与大小写都保留），命名空间由 Vue 从父 `<svg>` 向下传递。\n */\nfunction renderNode(node: IconNode): VNode {\n  return h(node.tag, node.attrs as Record<string, unknown> | undefined, node.children?.map(renderNode))\n}\n\n/**\n * 根 `<svg>` 加一层 `<g>` 空壳，图元铺在空壳中。\n * 默认插槽给出内容时改由插槽内容填充根，元素不再生成 glyph 与图元；\n * 判据是插槽产出中有真正会渲染出内容的节点：既不是插槽函数是否存在（宿主可能恒传一个插槽），\n * 也不是产出数组非空（`v-if` 为假时产出中还剩一个注释节点）。\n */\nexport const XhIcon = defineComponent({\n  name: 'XhIcon',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    icon: { type: Object as PropType<IconRecord> },\n    label: { type: String },\n    size: { type: String as PropType<IconSize> },\n    weight: { type: String as PropType<IconWeight> },\n    tone: { type: String as PropType<Tone> },\n    frame: { type: String as PropType<ActionVariant> },\n    rotate: { type: [Number, String] as PropType<IconRotate | string> },\n    flip: { type: String as PropType<IconFlip> },\n  },\n  setup(props, { slots }) {\n    const ctx = useIcon(withXhConfig('icon', props) as IconProps)\n    return () => {\n      const authored = slots.default?.()\n      return h(\n        'svg',\n        ctx.api.value.getRootProps() as Record<string, unknown>,\n        slotPaints(authored)\n          ? authored\n          : [h(\n              'g',\n              ctx.api.value.getGlyphProps() as Record<string, unknown>,\n              ctx.api.value.nodes.map(renderNode),\n            )],\n      )\n    }\n  },\n})\n"],"mappings":";;;;;;;;;AAmBA,SAAS,WAAW,MAAuB;CACzC,OAAO,EAAE,KAAK,KAAK,KAAK,OAA8C,KAAK,UAAU,IAAI,UAAU,CAAC;AACtG;;;;;;;AAQA,MAAa,SAAS,gBAAgB;CACpC,MAAM;CAEN,OAAO;EACL,MAAM,EAAE,MAAM,OAA+B;EAC7C,OAAO,EAAE,MAAM,OAAO;EACtB,MAAM,EAAE,MAAM,OAA6B;EAC3C,QAAQ,EAAE,MAAM,OAA+B;EAC/C,MAAM,EAAE,MAAM,OAAyB;EACvC,OAAO,EAAE,MAAM,OAAkC;EACjD,QAAQ,EAAE,MAAM,CAAC,QAAQ,MAAM,EAAmC;EAClE,MAAM,EAAE,MAAM,OAA6B;CAC7C;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,QAAQ,aAAa,QAAQ,KAAK,CAAc;EAC5D,aAAa;GACX,MAAM,WAAW,MAAM,UAAU;GACjC,OAAO,EACL,OACA,IAAI,IAAI,MAAM,aAAa,GAC3B,WAAW,QAAQ,IACf,WACA,CAAC,EACC,KACA,IAAI,IAAI,MAAM,cAAc,GAC5B,IAAI,IAAI,MAAM,MAAM,IAAI,UAAU,CACpC,CAAC,CACP;EACF;CACF;AACF,CAAC"}
+{"version":3,"file":"icon.js","names":[],"sources":["../../../src/components/icon/icon.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// 提供 icon 相关实现。\n\nimport type { ActionVariant, IconNode, IconRecord, Tone } from '@xihan-ui/core'\nimport type { IconFlip, IconProps, IconRotate, IconSize, IconWeight } from '@xihan-ui/headless'\nimport type { FunctionalComponent, PropType, VNode } from 'vue'\nimport { connectIcon, iconStructure } from '@xihan-ui/headless'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { renderStructure } from '../../runtime/structure'\nimport { useIcon } from './use-icon'\n\n/**\n * 把一个图元节点建为 VNode，递归到底。\n * 标签与属性名逐字透传（连字符与大小写都保留），命名空间由 Vue 从父 `<svg>` 向下传递。\n */\nfunction renderNode(node: IconNode): VNode {\n  return h(node.tag, node.attrs as Record<string, unknown> | undefined, node.children?.map(renderNode))\n}\n\nconst NO_PROPS: IconProps = {}\n\n/** glyph 空壳：只带解剖标记，图元由标准结构的内容回调铺进来。 */\nconst XhIconGlyph: FunctionalComponent = (_, { slots }) =>\n  h('g', connectIcon(NO_PROPS, vueNormalize).getGlyphProps() as Record<string, unknown>, slots.default?.())\n\n/** 标准结构里各部件对应的组件。 */\nconst ICON_PARTS = { glyph: XhIconGlyph }\n\n/**\n * 根 `<svg>` 里照 headless 的 iconStructure 铺一层 `<g>` 空壳，图元铺在空壳中。\n * 默认插槽给出内容时改由插槽内容填充根，元素不再生成 glyph 与图元；\n * 判据是插槽产出中有真正会渲染出内容的节点：既不是插槽函数是否存在（宿主可能恒传一个插槽），\n * 也不是产出数组非空（`v-if` 为假时产出中还剩一个注释节点）。\n */\nexport const XhIcon = defineComponent({\n  name: 'XhIcon',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    icon: { type: Object as PropType<IconRecord> },\n    label: { type: String },\n    size: { type: String as PropType<IconSize> },\n    weight: { type: String as PropType<IconWeight> },\n    tone: { type: String as PropType<Tone> },\n    frame: { type: String as PropType<ActionVariant> },\n    rotate: { type: [Number, String] as PropType<IconRotate | string> },\n    flip: { type: String as PropType<IconFlip> },\n  },\n  setup(props, { slots }) {\n    const ctx = useIcon(withXhConfig('icon', props) as IconProps)\n    return () => {\n      const authored = slots.default?.()\n      return h(\n        'svg',\n        ctx.api.value.getRootProps() as Record<string, unknown>,\n        slotPaints(authored)\n          ? authored\n          : renderStructure(iconStructure(), ICON_PARTS, () => ctx.api.value.nodes.map(renderNode)),\n      )\n    }\n  },\n})\n"],"mappings":";;;;;;;;;;;;AAsBA,SAAS,WAAW,MAAuB;CACzC,OAAO,EAAE,KAAK,KAAK,KAAK,OAA8C,KAAK,UAAU,IAAI,UAAU,CAAC;AACtG;AAEA,MAAM,WAAsB,CAAC;;AAG7B,MAAM,eAAoC,GAAG,EAAE,YAC7C,EAAE,KAAK,YAAY,UAAU,YAAY,CAAC,CAAC,cAAc,GAA8B,MAAM,UAAU,CAAC;;AAG1G,MAAM,aAAa,EAAE,OAAO,YAAY;;;;;;;AAQxC,MAAa,SAAS,gBAAgB;CACpC,MAAM;CAEN,OAAO;EACL,MAAM,EAAE,MAAM,OAA+B;EAC7C,OAAO,EAAE,MAAM,OAAO;EACtB,MAAM,EAAE,MAAM,OAA6B;EAC3C,QAAQ,EAAE,MAAM,OAA+B;EAC/C,MAAM,EAAE,MAAM,OAAyB;EACvC,OAAO,EAAE,MAAM,OAAkC;EACjD,QAAQ,EAAE,MAAM,CAAC,QAAQ,MAAM,EAAmC;EAClE,MAAM,EAAE,MAAM,OAA6B;CAC7C;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,QAAQ,aAAa,QAAQ,KAAK,CAAc;EAC5D,aAAa;GACX,MAAM,WAAW,MAAM,UAAU;GACjC,OAAO,EACL,OACA,IAAI,IAAI,MAAM,aAAa,GAC3B,WAAW,QAAQ,IACf,WACA,gBAAgB,cAAc,GAAG,kBAAkB,IAAI,IAAI,MAAM,MAAM,IAAI,UAAU,CAAC,CAC5F;EACF;CACF;AACF,CAAC"}

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

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { IconApi, IconProps } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/icon/use-icon.d.ts
 interface IconContext {
   api: ComputedRef<IconApi>;

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

@@ -1,6 +1,6 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
-import { computed } from "vue";
 import { connectIcon } from "@xihan-ui/headless";
+import { computed } from "vue";
 //#region src/components/icon/use-icon.ts
 function useIcon(props) {
 	return { api: computed(() => connectIcon(props, vueNormalize)) };

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

@@ -1,6 +1,6 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { SlotsType, VNode } from "vue";
 import { ImageApi, ImageSchema } from "@xihan-ui/headless";
+import { SlotsType, VNode } from "vue";
 //#region src/components/image/image.d.ts
 type ImageProps = ImageSchema['props'];
 /** 默认插槽的载荷：加载状态、是否已加载完成，以及回退内容当前是否应当显示。 */

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

@@ -1,6 +1,6 @@
+import { ImageApi, ImageSchema } from "@xihan-ui/headless";
 import { ComputedRef } from "vue";
 import { Service } from "@xihan-ui/core";
-import { ImageApi, ImageSchema } from "@xihan-ui/headless";
 //#region src/components/image/use-image.d.ts
 interface ImageContext {
   service: Service<ImageSchema>;

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

@@ -1,9 +1,9 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectImage, imageMachine } from "@xihan-ui/headless";
 import { computed } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectImage, imageMachine } from "@xihan-ui/headless";
 //#region src/components/image/use-image.ts
 function useImage(props, onStatusChange) {
 	const service = useMachine(imageMachine, () => ({

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

@@ -1,11 +1,15 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { PropType, SlotsType, VNode } from "vue";
 import { ImageCropperApi, ImageCropperFlip, ImageCropperFlipAxis, ImageCropperHandlePosition, ImageCropperRect, ImageCropperSchema, ImageCropperShape } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
 //#region src/components/image-cropper/image-cropper.d.ts
 type ImageCropperProps = ImageCropperSchema['props'];
 /** 默认插槽的载荷：裁切矩形与图片自然尺寸、缩放、旋转与翻转、两种拖动标记，以及修改值、修改呈现与出图。 */
 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<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   src: {
     type: StringConstructor;
   };
@@ -93,6 +97,10 @@ declare const XhImageCropperRoot: import("vue").DefineComponent<import("vue").Ex
   'flip-change': (_details: PayloadOf<ImageCropperProps, "onFlipChange">) => true;
   'update:flip': (_flip: PayloadOf<ImageCropperProps, "onFlipChange">["flip"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   src: {
     type: StringConstructor;
   };

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":";;;;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"}
+{"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;;;;;;;;;;;;IAQI,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

@@ -7,6 +7,8 @@ import { defineComponent, h } from "vue";
 const XhImageCropperRoot = defineComponent({
 	name: "XhImageCropperRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		src: { type: String },
 		alt: { type: String },
 		aspectRatio: { type: Number },

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  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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"}
+{"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    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\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":";;;;;;AAiCA,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CAEN,OAAO;;EAEL,WAAW,EAAE,MAAM,OAAO;EAC1B,KAAK,EAAE,MAAM,OAAO;EACpB,KAAK,EAAE,MAAM,OAAO;EACpB,aAAa,EAAE,MAAM,OAAkC;EACvD,OAAO,EAAE,MAAM,OAAqC;EACpD,cAAc,EAAE,MAAM,OAAqC;EAC3D,UAAU,EAAE,MAAM,OAAO;EACzB,WAAW,EAAE,MAAM,OAAO;EAC1B,MAAM,EAAE,MAAM,OAAO;EACrB,aAAa,EAAE,MAAM,OAAO;EAC5B,SAAS,EAAE,MAAM,OAAO;EACxB,SAAS,EAAE,MAAM,OAAO;EACxB,UAAU,EAAE,MAAM,OAAO;EACzB,UAAU,EAAE,MAAM,OAAO;EACzB,iBAAiB,EAAE,MAAM,OAAO;EAChC,aAAa,EAAE,MAAM,OAAO;EAC5B,aAAa,EAAE,MAAM,OAAO;EAC5B,cAAc,EAAE,MAAM,OAAO;EAC7B,MAAM,EAAE,MAAM,OAAqC;EACnD,aAAa,EAAE,MAAM,OAAqC;EAC1D,OAAO,EAAE,MAAM,OAAsC;EACrD,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,MAAM,EAAE,MAAM,OAAO;EACrB,cAAc,EACZ,MAAM,OACR;CACF;CAGA,OAAO;EACL,iBAAiB,aAA4D;EAC7E,iBAAiB,WAAmE;EACpF,qBAAqB,aAA+D;EACpF,gBAAgB,aAA2D;EAC3E,gBAAgB,UAAgE;EAChF,oBAAoB,aAA+D;EACnF,oBAAoB,cAA4E;EAChG,gBAAgB,aAA2D;EAC3E,gBAAgB,UAAgE;CAClF;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,iBAAqD,YAAY;GACrE,KAAK,gBAAgB,OAAO;GAC5B,KAAK,gBAAgB,QAAQ,KAAK;EACpC;EACA,MAAM,oBAA2D,YAAY;GAC3E,KAAK,oBAAoB,OAAO;EAClC;EACA,MAAM,gBAAmD,YAAY;GACnE,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EACA,MAAM,oBAA2D,YAAY;GAC3E,KAAK,mBAAmB,OAAO;GAC/B,KAAK,mBAAmB,QAAQ,QAAQ;EAC1C;EACA,MAAM,gBAAmD,YAAY;GACnE,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EACA,MAAM,MAAM,gBACV,aAAa,iBAAiB,oBAAoB,KAAK,CAAC,GACxD;GAAE;GAAe;GAAkB;GAAc;GAAkB;EAAa,CAClF;EACA,oBAAoB,GAAG;EACvB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,OAAO,IAAI,IAAI,MAAM;GACrB,MAAM,IAAI,IAAI,MAAM;GACpB,UAAU,IAAI,IAAI,MAAM;GACxB,MAAM,IAAI,IAAI,MAAM;GACpB,SAAS,IAAI,IAAI,MAAM;GACvB,UAAU,IAAI,IAAI,MAAM;GACxB,UAAU,IAAI,IAAI,MAAM;GACxB,UAAU,IAAI,IAAI,MAAM;GACxB,UAAU,IAAI,IAAI,MAAM;GACxB,aAAa,IAAI,IAAI,MAAM;GAC3B,UAAU,IAAI,IAAI,MAAM;GACxB,UAAU,IAAI,IAAI,MAAM;GACxB,SAAS,IAAI,IAAI,MAAM;GACvB,aAAa,IAAI,IAAI,MAAM;GAC3B,SAAS,IAAI,IAAI,MAAM;GACvB,YAAY,IAAI,IAAI,MAAM;EAC5B,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,yBAAyB,gBAAgB;CACpD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,uBAAuB;EAEnC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,iBAAiB;GAClC,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,uBAAuB;EAEnC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,cAAc;GAC/B,KAAK,IAAI;EACX,CAAC;CACH;AACF,CAAC;AAED,MAAa,yBAAyB,gBAAgB;CACpD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,iBAAiB,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC;AAED,MAAa,2BAA2B,gBAAgB;CACtD,MAAM;CACN,OAAO;;AAEL,UAAU;EAAE,MAAM;EAAgD,UAAU;CAAK,EACnF;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EAEnC,aAAa,EACX,UACA,IAAI,IAAI,MAAM,mBAAmB,EAAE,UAAU,MAAM,SAAS,CAAC,GAC7D,MAAM,UAAU,CAClB;CACF;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;AAED,MAAa,2BAA2B,gBAAgB;CACtD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,uBAAuB;EAEnC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,mBAAmB,CAA4B;CACvF;AACF,CAAC;AAED,MAAa,6BAA6B,gBAAgB;CACxD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,qBAAqB,CAA4B;CACzF;AACF,CAAC;AAED,MAAa,4BAA4B,gBAAgB;CACvD,MAAM;CACN,OAAO;;AAEL,MAAM;EAAE,MAAM;EAA0C,UAAU;CAAK,EACzE;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EACX,UACA,IAAI,IAAI,MAAM,oBAAoB,EAAE,MAAM,MAAM,KAAK,CAAC,GACtD,MAAM,UAAU,CAClB;CACF;AACF,CAAC;AAED,MAAa,4BAA4B,gBAAgB;CACvD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,oBAAoB,CAA4B;CACxF;AACF,CAAC"}

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

@@ -1,6 +1,6 @@
+import { ImageCropperApi, ImageCropperSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { ImageCropperApi, ImageCropperSchema } from "@xihan-ui/headless";
 //#region src/components/image-cropper/use-image-cropper.d.ts
 interface ImageCropperContext {
   api: ComputedRef<ImageCropperApi>;

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

@@ -1,7 +1,7 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed, ref } from "vue";
 import { connectImageCropper, imageCropperMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
 //#region src/components/image-cropper/use-image-cropper.ts
 function useImageCropper(props, handlers = {}) {
 	const viewportRef = ref(null);

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { ImageViewerApi, ImageViewerItem, ImageViewerSchema } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { OverlayBackdropVariant, Size } from "@xihan-ui/core";
-import { ImageViewerApi, ImageViewerItem, ImageViewerSchema } from "@xihan-ui/headless";
 //#region src/components/image-viewer/image-viewer.d.ts
 type ImageViewerProps = ImageViewerSchema['props'];
 /** 默认插槽的载荷：当前图与下标、变换与可翻页状态，以及翻页、缩放、旋转、翻转、归零等命令。 */

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

@@ -4,8 +4,8 @@ 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";
 import { imageViewerCounterText } from "@xihan-ui/headless";
+import { defineComponent, h, mergeProps } from "vue";
 //#region src/components/image-viewer/image-viewer.ts
 const XhImageViewerRoot = defineComponent({
 	name: "XhImageViewerRoot",

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

@@ -1,6 +1,6 @@
+import { ImageViewerApi, ImageViewerSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { ImageViewerApi, ImageViewerSchema } from "@xihan-ui/headless";
 //#region src/components/image-viewer/use-image-viewer.d.ts
 interface ImageViewerContext {
   service: Service<ImageViewerSchema>;

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

@@ -3,9 +3,9 @@ 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 { connectImageViewer, imageViewerMachine } from "@xihan-ui/headless";
 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
 function useImageViewer(props, handlers = {}) {
 	const contentRef = ref(null);

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

@@ -1,5 +1,5 @@
-import { PropType, SlotsType, VNode } from "vue";
 import { InfiniteScrollApi, InfiniteScrollEdge } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
 //#region src/components/infinite-scroll/infinite-scroll.d.ts
 /** 默认插槽的载荷：取数所处的阶段，以及正在取数与已关闭两个状态。 */
 type InfiniteScrollRootSlotProps = Pick<InfiniteScrollApi, 'phase' | 'loading' | 'disabled'>;

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

@@ -1,6 +1,6 @@
+import { InfiniteScrollApi, InfiniteScrollSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { InfiniteScrollApi, InfiniteScrollSchema } from "@xihan-ui/headless";
 //#region src/components/infinite-scroll/use-infinite-scroll.d.ts
 interface InfiniteScrollContext {
   api: ComputedRef<InfiniteScrollApi>;

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

@@ -1,7 +1,7 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed, ref } from "vue";
 import { connectInfiniteScroll, infiniteScrollMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
 //#region src/components/infinite-scroll/use-infinite-scroll.ts
 /** 观察在状态机的效应中运行，两处 DOM 取值口经 refs 交入；getTargetEl 返回滚动容器，null 即整页滚动。 */
 function useInfiniteScroll(props, onLoad, getTargetEl = () => null) {

package/dist/components/input-group/context.d.ts

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { InputGroupApi } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/input-group/context.d.ts
 interface InputGroupContext {
   api: ComputedRef<InputGroupApi>;

package/dist/components/input-group/input-group.js

@@ -1,8 +1,8 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { withXhConfig } from "../../config/config.js";
 import { provideInputGroup, useInputGroupContext } from "./context.js";
-import { computed, defineComponent, h } from "vue";
 import { connectInputGroup } from "@xihan-ui/headless";
+import { computed, defineComponent, h } from "vue";
 //#region src/components/input-group/input-group.ts
 const XhInputGroupRoot = defineComponent({
 	name: "XhInputGroupRoot",

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { JsonViewerApi, JsonViewerSchema, JsonViewerTool, JsonViewerTranslations, JsonViewerView } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Direction, Size } from "@xihan-ui/core";
-import { JsonViewerApi, JsonViewerSchema, JsonViewerTranslations, JsonViewerView } from "@xihan-ui/headless";
 //#region src/components/json-viewer/json-viewer.d.ts
 type JsonViewerProps = JsonViewerSchema['props'];
 /**
@@ -17,6 +17,29 @@ declare const XhJsonViewerRoot: import("vue").DefineComponent<import("vue").Extr
   view: {
     type: PropType<JsonViewerView>;
   };
+  /** 非受控的初始形态，默认 tree。 */
+  defaultView: {
+    type: PropType<JsonViewerView>;
+  };
+  /** 值的原文：提供时原文档与复制钮取它，只重排缩进、字面量一字不改。 */
+  source: {
+    type: StringConstructor;
+  };
+  /** 原文档是否自动换行；提供即受控。 */
+  wrap: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  /** 非受控的初始换行，默认 false。 */
+  defaultWrap: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  /** 内建工具条：不提供即没有；true 铺出全部工具；数组只铺列出的几项（expand / wrap / copy / view）。 */
+  tools: {
+    type: PropType<boolean | JsonViewerTool[]>;
+    default: undefined;
+  };
   /** 外框形态：outline 带描边与底色（默认），subtle 淡底无描边，ghost 去掉描边与底色只保留内容。 */
   variant: {
     type: PropType<ControlVariant>;
@@ -62,6 +85,11 @@ declare const XhJsonViewerRoot: import("vue").DefineComponent<import("vue").Extr
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'expanded-value-change': (_details: PayloadOf<JsonViewerProps, "onExpandedValueChange">) => true;
   'update:expandedValue': (_value: PayloadOf<JsonViewerProps, "onExpandedValueChange">["value"]) => true;
+  'view-change': (_details: PayloadOf<JsonViewerProps, "onViewChange">) => true;
+  'update:view': (_view: PayloadOf<JsonViewerProps, "onViewChange">["view"]) => true;
+  'wrap-change': (_details: PayloadOf<JsonViewerProps, "onWrapChange">) => true;
+  'update:wrap': (_wrap: PayloadOf<JsonViewerProps, "onWrapChange">["wrap"]) => true;
+  'copy-error': (_details: PayloadOf<JsonViewerProps, "onCopyError">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   value: {
     type: PropType<unknown>;
@@ -70,6 +98,29 @@ declare const XhJsonViewerRoot: import("vue").DefineComponent<import("vue").Extr
   view: {
     type: PropType<JsonViewerView>;
   };
+  /** 非受控的初始形态，默认 tree。 */
+  defaultView: {
+    type: PropType<JsonViewerView>;
+  };
+  /** 值的原文：提供时原文档与复制钮取它，只重排缩进、字面量一字不改。 */
+  source: {
+    type: StringConstructor;
+  };
+  /** 原文档是否自动换行；提供即受控。 */
+  wrap: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  /** 非受控的初始换行，默认 false。 */
+  defaultWrap: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  /** 内建工具条：不提供即没有；true 铺出全部工具；数组只铺列出的几项（expand / wrap / copy / view）。 */
+  tools: {
+    type: PropType<boolean | JsonViewerTool[]>;
+    default: undefined;
+  };
   /** 外框形态：outline 带描边与底色（默认），subtle 淡底无描边，ghost 去掉描边与底色只保留内容。 */
   variant: {
     type: PropType<ControlVariant>;
@@ -111,11 +162,19 @@ declare const XhJsonViewerRoot: import("vue").DefineComponent<import("vue").Extr
     type: PropType<Partial<JsonViewerTranslations>>;
   };
 }>> & Readonly<{
+  "onCopy-error"?: ((_details: import("@xihan-ui/headless").JsonViewerCopyErrorDetails) => any) | undefined;
   "onExpanded-value-change"?: ((_details: import("@xihan-ui/headless").JsonViewerExpandedValueChangeDetails) => any) | undefined;
   "onUpdate:expandedValue"?: ((_value: string[]) => any) | undefined;
+  "onView-change"?: ((_details: import("@xihan-ui/headless").JsonViewerViewChangeDetails) => any) | undefined;
+  "onUpdate:view"?: ((_view: JsonViewerView) => any) | undefined;
+  "onWrap-change"?: ((_details: import("@xihan-ui/headless").JsonViewerWrapChangeDetails) => any) | undefined;
+  "onUpdate:wrap"?: ((_wrap: boolean) => any) | undefined;
 }>, {
   value: unknown;
   loop: boolean;
+  wrap: boolean;
+  defaultWrap: boolean;
+  tools: boolean | JsonViewerTool[];
   sortKeys: boolean;
 }, SlotsType<{
   empty?: () => VNode[];