@xihan-ui/vue 2.0.0 → 3.0.0

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/input-group/input-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-group.d.ts","names":[],"sources":["../../../src/components/input-group/input-group.ts"],"mappings":";;;cAgBa,gCAAgB,8BAAA;EAIN,SAAA,SAAS;;IACJ,MAAA,SAAS;;;;;EADd,SAAA,SAAS;;IACJ,MAAA,SAAS;;MAQnC,oDAAA;cAEW,gCAAgB,wCAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"input-group.d.ts","names":[],"sources":["../../../src/components/input-group/input-group.ts"],"mappings":";;;cAgBa,gCAAgB,8BAAA;EAIN,SAAA,SAAS;;IACJ,MAAA,SAAS;;;;;EADd,SAAA,SAAS;;IACJ,MAAA,SAAS;;MAUnC,oDAAA;cAEW,gCAAgB,wCAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

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

@@ -11,7 +11,8 @@ const XhInputGroupRoot = defineComponent({
 		size: { type: String }
 	},
 	setup(props, { slots }) {
-		const api = computed(() => connectInputGroup(withXhConfig("input-group", props), vueNormalize));
+		const configured = withXhConfig("input-group", props);
+		const api = computed(() => connectInputGroup(configured, vueNormalize));
 		provideInputGroup({ api });
 		return () => h("div", api.value.getRootProps(), slots.default?.());
 	}

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

@@ -1 +1 @@
-{"version":3,"file":"input-group.js","names":[],"sources":["../../../src/components/input-group/input-group.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// 提供 input group 相关实现。\n\nimport type { ControlVariant, Size } from '@xihan-ui/core'\nimport type { InputGroupProps } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectInputGroup } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideInputGroup, useInputGroupContext } from './context'\n\nexport const XhInputGroupRoot = defineComponent({\n  name: 'XhInputGroupRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    variant: String as PropType<ControlVariant>,\n    size: { type: String as PropType<Size> },\n  },\n  setup(props, { slots }) {\n    const api = computed(() => connectInputGroup(withXhConfig('input-group', props) as InputGroupProps, vueNormalize))\n    provideInputGroup({ api })\n    // 组内每一段是作者放进插槽的控件，直接当直接子节点摆\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhInputGroupItem = defineComponent({\n  name: 'XhInputGroupItem',\n  setup(_, { slots }) {\n    const ctx = useInputGroupContext()\n    // 前后缀文本由作者写进插槽\n    return () => h('span', ctx.api.value.getItemProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAgBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CAEN,OAAO;EACL,SAAS;EACT,MAAM,EAAE,MAAM,OAAyB;CACzC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe,kBAAkB,aAAa,eAAe,KAAK,GAAsB,YAAY,CAAC;EACjH,kBAAkB,EAAE,IAAI,CAAC;EAEzB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC9F;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EAEjC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC"}
+{"version":3,"file":"input-group.js","names":[],"sources":["../../../src/components/input-group/input-group.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// 提供 input group 相关实现。\n\nimport type { ControlVariant, Size } from '@xihan-ui/core'\nimport type { InputGroupProps } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectInputGroup } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideInputGroup, useInputGroupContext } from './context'\n\nexport const XhInputGroupRoot = defineComponent({\n  name: 'XhInputGroupRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    variant: String as PropType<ControlVariant>,\n    size: { type: String as PropType<Size> },\n  },\n  setup(props, { slots }) {\n    // withXhConfig 只能在 setup 期调，连接层在渲染期读这份代理\n    const configured = withXhConfig('input-group', props)\n    const api = computed(() => connectInputGroup(configured as InputGroupProps, vueNormalize))\n    provideInputGroup({ api })\n    // 组内每一段是作者放进插槽的控件，直接当直接子节点摆\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhInputGroupItem = defineComponent({\n  name: 'XhInputGroupItem',\n  setup(_, { slots }) {\n    const ctx = useInputGroupContext()\n    // 前后缀文本由作者写进插槽\n    return () => h('span', ctx.api.value.getItemProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAgBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CAEN,OAAO;EACL,SAAS;EACT,MAAM,EAAE,MAAM,OAAyB;CACzC;CACA,MAAM,OAAO,EAAE,SAAS;EAEtB,MAAM,aAAa,aAAa,eAAe,KAAK;EACpD,MAAM,MAAM,eAAe,kBAAkB,YAA+B,YAAY,CAAC;EACzF,kBAAkB,EAAE,IAAI,CAAC;EAEzB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC9F;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EAEjC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACnG;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;
 		};
 	}
 });

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

@@ -1 +1 @@
-{"version":3,"file":"json-viewer.js","names":[],"sources":["../../../src/components/json-viewer/json-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// 提供 json viewer 相关实现。\n\nimport type { ControlVariant, Direction, Size } from '@xihan-ui/core'\nimport type { JsonViewerApi, JsonViewerNode, JsonViewerSchema, JsonViewerTranslations, JsonViewerView } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { groupJsonViewerNodesByParent } from '@xihan-ui/headless'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useJsonViewer } from './use-json-viewer'\n\ntype JsonViewerProps = JsonViewerSchema['props']\n\nfunction renderRows(\n  api: JsonViewerApi,\n  children: Map<string | null, JsonViewerNode[]>,\n  parent: string | null,\n): VNode[] {\n  return (children.get(parent) ?? []).map(node => renderRow(api, children, node))\n}\n\n/**\n * 一行：标量是 item（键名 + 值），对象与数组是 branch（控制行 + 子层）。\n * 没有键名的行（根行、截断占位）不渲染键名部件，避免多出一个空盒子。\n */\nfunction renderRow(\n  api: JsonViewerApi,\n  children: Map<string | null, JsonViewerNode[]>,\n  node: JsonViewerNode,\n): VNode {\n  const ref = { value: node.value }\n\n  if (!node.branch) {\n    const parts: VNode[] = []\n    if (node.key != null)\n      parts.push(h('span', api.getItemKeyProps(ref) as Record<string, unknown>, node.key))\n    parts.push(h('span', api.getItemValueProps(ref) as Record<string, unknown>, api.valueText(node)))\n    return h('div', { ...api.getItemProps(ref) as Record<string, unknown>, key: node.value }, parts)\n  }\n\n  const control: VNode[] = [\n    h('span', api.getBranchTriggerProps(ref) as Record<string, unknown>, [\n      h('span', api.getBranchIndicatorProps(ref) as Record<string, unknown>),\n    ]),\n  ]\n  if (node.key != null)\n    control.push(h('span', api.getBranchTextProps(ref) as Record<string, unknown>, node.key))\n  control.push(h('span', api.getPreviewProps(ref) as Record<string, unknown>, api.previewText(node)))\n\n  const parts: VNode[] = [h('div', api.getBranchControlProps(ref) as Record<string, unknown>, control)]\n  // 收起的子层不渲染：一份大 JSON 全铺出来会把页面压住，展开集合本来也是逐层放开的\n  if (api.isExpanded(node.value)) {\n    parts.push(h(\n      'div',\n      api.getBranchContentProps(ref) as Record<string, unknown>,\n      renderRows(api, children, node.value),\n    ))\n  }\n  return h('div', { ...api.getBranchProps(ref) as Record<string, unknown>, key: node.value }, parts)\n}\n\nexport const XhJsonViewerRoot = defineComponent({\n  name: 'XhJsonViewerRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    // 任意形状都收，类型检查交给使用方\n    value: { type: null as unknown as PropType<unknown>, default: undefined as unknown },\n    view: { type: String as PropType<JsonViewerView> },\n    /** 外框形态：outline 带描边与底色（默认），subtle 淡底无描边，ghost 去掉描边与底色只保留内容。 */\n    variant: { type: String as PropType<ControlVariant> },\n    expandedValue: { type: Array as PropType<string[]> },\n    defaultExpandedValue: { type: Array as PropType<string[]> },\n    defaultExpandedDepth: { type: Number },\n    maxStringLength: { type: Number },\n    maxItems: { type: Number },\n    sortKeys: { type: Boolean, default: undefined },\n    loop: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<JsonViewerTranslations>> },\n  },\n  // 空态那一格的内容：不写即铺 translations 里的兜底文案\n  slots: Object as SlotsType<{\n    empty?: () => VNode[]\n  }>,\n  // expanded-change 携带 { value }，update:expandedValue 携带裸集合\n  emits: {\n    'expanded-value-change': (_details: PayloadOf<JsonViewerProps, 'onExpandedValueChange'>) => true,\n    'update:expandedValue': (_value: PayloadOf<JsonViewerProps, 'onExpandedValueChange'>['value']) => true,\n  },\n  setup(props, { emit, slots }) {\n    const notify: JsonViewerProps['onExpandedValueChange'] = (details) => {\n      emit('expanded-value-change', details)\n      emit('update:expandedValue', details.value)\n    }\n    const ctx = useJsonViewer(withXhConfig('json-viewer', props) as JsonViewerProps, notify)\n    // 两档容器是页内结构容器（与 Tree 同类）：滚动条走 reset 层的原生细条，不接自绘条（§6.6）\n    // 行是按数据摊出来的，作者写不出也不必写：整棵树由组件自己铺\n    // 空态与滚动层同级：一行也摊不出来时由它说话，有行可摊时 connect 给它打 hidden\n    const renderEmpty = (api: JsonViewerApi): VNode => h(\n      'div',\n      api.getEmptyProps() as Record<string, unknown>,\n      slots.empty?.() ?? api.emptyText,\n    )\n    return () => {\n      const api = ctx.api.value\n      // 原文档不铺行：整块文本交给 pre，框选与复制才拿得到与后端一字不差的那份\n      if (api.view === 'text') {\n        return h('div', api.getRootProps() as Record<string, unknown>, [\n          h('pre', api.getTextProps() as Record<string, unknown>, api.text),\n          renderEmpty(api),\n        ])\n      }\n\n      const children = groupJsonViewerNodesByParent(api.visibleNodes)\n      return h('div', api.getRootProps() as Record<string, unknown>, [\n        h('div', api.getTreeProps() as Record<string, unknown>, renderRows(api, children, null)),\n        renderEmpty(api),\n      ])\n    }\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"json-viewer.js","names":[],"sources":["../../../src/components/json-viewer/json-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// 提供 json viewer 相关实现。\n\nimport type { ControlVariant, Direction, Size } from '@xihan-ui/core'\nimport type { HighlightSegment, JsonViewerApi, JsonViewerNode, JsonViewerSchema, JsonViewerTranslations, JsonViewerView } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { groupJsonViewerNodesByParent } from '@xihan-ui/headless'\nimport { defineComponent, Fragment, h, mergeProps } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useJsonViewer } from './use-json-viewer'\n\ntype JsonViewerProps = JsonViewerSchema['props']\n\n/**\n * 工具条插槽的载荷：搜索命中与在命中之间逐个走的两个动作。\n * 搜索框、上一条 / 下一条与计数由作者摆在这里，搜索词经 search 交给根。\n */\nexport type JsonViewerToolbarSlotProps = Pick<JsonViewerApi, 'searchMatches' | 'activeMatch' | 'nextMatch' | 'prevMatch'>\n\n/** 按片段铺文字：命中搜索词的那一段包进 mark 部件，其余原样是文本。 */\nfunction renderSegments(api: JsonViewerApi, segments: readonly HighlightSegment[]): Array<VNode | string> {\n  return segments.map(segment => (segment.matched\n    ? h('mark', api.getMarkProps() as Record<string, unknown>, segment.text)\n    : segment.text))\n}\n\nfunction renderRows(\n  api: JsonViewerApi,\n  children: Map<string | null, JsonViewerNode[]>,\n  parent: string | null,\n): VNode[] {\n  return (children.get(parent) ?? []).map(node => renderRow(api, children, node))\n}\n\n/**\n * 一行：标量是 item（键名 + 值），对象与数组是 branch（控制行 + 子层）。\n * 没有键名的行（根行、截断占位）不渲染键名部件，避免多出一个空盒子。\n */\nfunction renderRow(\n  api: JsonViewerApi,\n  children: Map<string | null, JsonViewerNode[]>,\n  node: JsonViewerNode,\n): VNode {\n  const ref = { value: node.value }\n\n  if (!node.branch) {\n    const parts: VNode[] = []\n    if (node.key != null)\n      parts.push(h('span', api.getItemKeyProps(ref) as Record<string, unknown>, renderSegments(api, api.keySegments(node))))\n    parts.push(h('span', api.getItemValueProps(ref) as Record<string, unknown>, renderSegments(api, api.valueSegments(node))))\n    return h('div', { ...api.getItemProps(ref) as Record<string, unknown>, key: node.value }, parts)\n  }\n\n  const control: VNode[] = [\n    h('span', api.getBranchTriggerProps(ref) as Record<string, unknown>, [\n      h('span', api.getBranchIndicatorProps(ref) as Record<string, unknown>),\n    ]),\n  ]\n  if (node.key != null)\n    control.push(h('span', api.getBranchTextProps(ref) as Record<string, unknown>, renderSegments(api, api.keySegments(node))))\n  control.push(h('span', api.getPreviewProps(ref) as Record<string, unknown>, api.previewText(node)))\n\n  const parts: VNode[] = [h('div', api.getBranchControlProps(ref) as Record<string, unknown>, control)]\n  // 收起的子层不渲染：一份大 JSON 全铺出来会把页面压住，展开集合本来也是逐层放开的\n  if (api.isExpanded(node.value)) {\n    parts.push(h(\n      'div',\n      api.getBranchContentProps(ref) as Record<string, unknown>,\n      renderRows(api, children, node.value),\n    ))\n  }\n  return h('div', { ...api.getBranchProps(ref) as Record<string, unknown>, key: node.value }, parts)\n}\n\nexport const XhJsonViewerRoot = defineComponent({\n  name: 'XhJsonViewerRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    // 任意形状都收，类型检查交给使用方\n    value: { type: null as unknown as PropType<unknown>, default: undefined as unknown },\n    view: { type: String as PropType<JsonViewerView> },\n    /** 外框形态：outline 带描边与底色（默认），subtle 淡底无描边，ghost 去掉描边与底色只保留内容。 */\n    variant: { type: String as PropType<ControlVariant> },\n    expandedValue: { type: Array as PropType<string[]> },\n    defaultExpandedValue: { type: Array as PropType<string[]> },\n    defaultExpandedDepth: { type: Number },\n    maxStringLength: { type: Number },\n    maxItems: { type: Number },\n    sortKeys: { type: Boolean, default: undefined },\n    loop: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    size: { type: String as PropType<Size> },\n    /** 搜索词：键名与值里含有它的行即命中，命中行的祖先自动展开，命中片段铺成 mark。 */\n    search: { type: String },\n    translations: { type: Object as PropType<Partial<JsonViewerTranslations>> },\n  },\n  // 空态那一格的内容：不写即铺 translations 里的兜底文案\n  slots: Object as SlotsType<{\n    empty?: () => VNode[]\n    /** 树之前的一条：放搜索框与上一条 / 下一条，渲染为根的前一个兄弟。 */\n    toolbar?: (props: JsonViewerToolbarSlotProps) => VNode[]\n  }>,\n  // 写了工具条时根是片段，接不住自动透传：作者写在 XhJsonViewerRoot 上的 class / aria-* 自己合到根上\n  inheritAttrs: false,\n  // expanded-change 携带 { value }，update:expandedValue 携带裸集合\n  emits: {\n    'expanded-value-change': (_details: PayloadOf<JsonViewerProps, 'onExpandedValueChange'>) => true,\n    'update:expandedValue': (_value: PayloadOf<JsonViewerProps, 'onExpandedValueChange'>['value']) => true,\n  },\n  setup(props, { emit, slots, attrs }) {\n    const notify: JsonViewerProps['onExpandedValueChange'] = (details) => {\n      emit('expanded-value-change', details)\n      emit('update:expandedValue', details.value)\n    }\n    const ctx = useJsonViewer(withXhConfig('json-viewer', props) as JsonViewerProps, notify)\n    // 两档容器是页内结构容器（与 Tree 同类）：滚动条走 reset 层的原生细条，不接自绘条\n    // 行是按数据摊出来的，作者写不出也不必写：整棵树由组件自己铺\n    // 空态与滚动层同级：一行也摊不出来时由它说话，有行可摊时 connect 给它打 hidden\n    const renderEmpty = (api: JsonViewerApi): VNode => h(\n      'div',\n      api.getEmptyProps() as Record<string, unknown>,\n      slots.empty?.() ?? api.emptyText,\n    )\n    const renderRoot = (api: JsonViewerApi): VNode => {\n      const rootProps = mergeProps(api.getRootProps() as Record<string, unknown>, attrs)\n      // 原文档不铺行：整块文本交给 pre，框选与复制才拿得到与后端一字不差的那份\n      if (api.view === 'text') {\n        return h('div', rootProps, [\n          h('pre', api.getTextProps() as Record<string, unknown>, api.text),\n          renderEmpty(api),\n        ])\n      }\n\n      const children = groupJsonViewerNodesByParent(api.visibleNodes)\n      return h('div', rootProps, [\n        h('div', api.getTreeProps() as Record<string, unknown>, renderRows(api, children, null)),\n        renderEmpty(api),\n      ])\n    }\n    return () => {\n      const api = ctx.api.value\n      const toolbar = slots.toolbar?.({\n        searchMatches: api.searchMatches,\n        activeMatch: api.activeMatch,\n        nextMatch: api.nextMatch,\n        prevMatch: api.prevMatch,\n      })\n      const root = renderRoot(api)\n      return toolbar ? h(Fragment, [...toolbar, root]) : root\n    }\n  },\n})\n"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"kbd.d.ts","names":[],"sources":["../../../src/components/kbd/kbd.ts"],"mappings":";;;;cAgBa,qBAAK,8BAAA;;IAGS,MAAA;;;;IACK,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;;IAEE,MAAA,SAAS;;;;;;;;;;;IAGf,MAAA,SAAS,QAAQ;;;;;EAG3B,YAAA,UAAA,UAAU;;;IAVT,MAAA;;;;IACK,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;;IAEE,MAAA,SAAS;;;;;;;;;;;IAGf,MAAA,SAAS,QAAQ;;;;;;;;qCAwCnD"}
+{"version":3,"file":"kbd.d.ts","names":[],"sources":["../../../src/components/kbd/kbd.ts"],"mappings":";;;;cAgBa,qBAAK,8BAAA;;IAGS,MAAA;;;;IACK,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;;IAEE,MAAA,SAAS;;;;;;;;;;;IAGf,MAAA,SAAS,QAAQ;;;;;EAG3B,YAAA,UAAA,UAAU;;;IAVT,MAAA;;;;IACK,MAAA,SAAS;;;IACV,MAAA,SAAS;;;;;;;IAEE,MAAA,SAAS;;;;;;;;;;;IAGf,MAAA,SAAS,QAAQ;;;;;;;;qCA8DnD"}

package/dist/components/kbd/kbd.js

@@ -31,17 +31,34 @@ const XhKbd = defineComponent({
 	emits: { "hot-key": (_details) => true },
 	setup(props, { emit }) {
 		const detected = useKbdPlatform();
-		const api = computed(() => connectKbd(withXhConfig("kbd", {
-			keys: props.keys,
-			platform: props.platform && props.platform !== "auto" ? props.platform : detected.value,
-			variant: props.variant,
-			register: props.register,
-			target: props.target,
-			preventDefault: props.preventDefault,
-			enabled: props.enabled,
-			translations: props.translations,
+		const configured = withXhConfig("kbd", {
+			get keys() {
+				return props.keys;
+			},
+			get platform() {
+				return props.platform && props.platform !== "auto" ? props.platform : detected.value;
+			},
+			get variant() {
+				return props.variant;
+			},
+			get register() {
+				return props.register;
+			},
+			get target() {
+				return props.target;
+			},
+			get preventDefault() {
+				return props.preventDefault;
+			},
+			get enabled() {
+				return props.enabled;
+			},
+			get translations() {
+				return props.translations;
+			},
 			onHotKey: (details) => emit("hot-key", details)
-		}), vueNormalize));
+		});
+		const api = computed(() => connectKbd(configured, vueNormalize));
 		const onKeyDown = (event) => api.value.handleKeyDown(event);
 		let bound = null;
 		const stop = () => {

package/dist/components/kbd/kbd.js.map

@@ -1 +1 @@
-{"version":3,"file":"kbd.js","names":[],"sources":["../../../src/components/kbd/kbd.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// 提供 kbd 展示与快捷键注册实现。\n\nimport type { KbdPlatform, KbdProps, KbdTarget, KbdTranslations, KbdVariant } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { connectKbd } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, onBeforeUnmount, watchEffect } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useKbdPlatform } from './use-kbd-platform'\n\nexport const XhKbd = defineComponent({\n  name: 'XhKbd',\n  props: {\n    keys: { type: Array as PropType<string[]>, required: true },\n    platform: { type: String as PropType<KbdPlatform> },\n    variant: { type: String as PropType<KbdVariant> },\n    register: { type: Boolean, default: undefined },\n    target: { type: [String, Function] as PropType<KbdTarget> },\n    preventDefault: { type: Boolean, default: undefined },\n    enabled: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<KbdTranslations>> },\n  },\n  emits: {\n    'hot-key': (_details: PayloadOf<KbdProps, 'onHotKey'>) => true,\n  },\n  setup(props, { emit }) {\n    const detected = useKbdPlatform()\n    const api = computed(() => connectKbd(withXhConfig('kbd', {\n      keys: props.keys,\n      platform: props.platform && props.platform !== 'auto' ? props.platform : detected.value,\n      variant: props.variant,\n      register: props.register,\n      target: props.target,\n      preventDefault: props.preventDefault,\n      enabled: props.enabled,\n      translations: props.translations,\n      onHotKey: details => emit('hot-key', details),\n    }) as KbdProps, vueNormalize))\n    const onKeyDown = (event: Event): void => api.value.handleKeyDown(event as KeyboardEvent)\n    let bound: EventTarget | null = null\n    const stop = (): void => {\n      bound?.removeEventListener('keydown', onKeyDown)\n      bound = null\n    }\n    watchEffect(() => {\n      const next = api.value.resolveTarget(typeof document === 'undefined' ? null : document)\n      if (next === bound)\n        return\n      stop()\n      bound = next\n      bound?.addEventListener('keydown', onKeyDown)\n    })\n    onBeforeUnmount(stop)\n\n    return () => h('kbd', api.value.getRootProps() as Record<string, unknown>, api.value.segments.map((segment, index) => h(\n      'span',\n      { ...api.value.getKeyProps({ value: segment.source }) as Record<string, unknown>, key: `${segment.source}-${index}` },\n      segment.label,\n    )))\n  },\n})\n"],"mappings":";;;;;;AAgBA,MAAa,QAAQ,gBAAgB;CACnC,MAAM;CACN,OAAO;EACL,MAAM;GAAE,MAAM;GAA6B,UAAU;EAAK;EAC1D,UAAU,EAAE,MAAM,OAAgC;EAClD,SAAS,EAAE,MAAM,OAA+B;EAChD,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,QAAQ,EAAE,MAAM,CAAC,QAAQ,QAAQ,EAAyB;EAC1D,gBAAgB;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EACpD,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,cAAc,EAAE,MAAM,OAA6C;CACrE;CACA,OAAO,EACL,YAAY,aAA8C,KAC5D;CACA,MAAM,OAAO,EAAE,QAAQ;EACrB,MAAM,WAAW,eAAe;EAChC,MAAM,MAAM,eAAe,WAAW,aAAa,OAAO;GACxD,MAAM,MAAM;GACZ,UAAU,MAAM,YAAY,MAAM,aAAa,SAAS,MAAM,WAAW,SAAS;GAClF,SAAS,MAAM;GACf,UAAU,MAAM;GAChB,QAAQ,MAAM;GACd,gBAAgB,MAAM;GACtB,SAAS,MAAM;GACf,cAAc,MAAM;GACpB,WAAU,YAAW,KAAK,WAAW,OAAO;EAC9C,CAAC,GAAe,YAAY,CAAC;EAC7B,MAAM,aAAa,UAAuB,IAAI,MAAM,cAAc,KAAsB;EACxF,IAAI,QAA4B;EAChC,MAAM,aAAmB;GACvB,OAAO,oBAAoB,WAAW,SAAS;GAC/C,QAAQ;EACV;EACA,kBAAkB;GAChB,MAAM,OAAO,IAAI,MAAM,cAAc,OAAO,aAAa,cAAc,OAAO,QAAQ;GACtF,IAAI,SAAS,OACX;GACF,KAAK;GACL,QAAQ;GACR,OAAO,iBAAiB,WAAW,SAAS;EAC9C,CAAC;EACD,gBAAgB,IAAI;EAEpB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,IAAI,MAAM,SAAS,KAAK,SAAS,UAAU,EACpH,QACA;GAAE,GAAG,IAAI,MAAM,YAAY,EAAE,OAAO,QAAQ,OAAO,CAAC;GAA8B,KAAK,GAAG,QAAQ,OAAO,GAAG;EAAQ,GACpH,QAAQ,KACV,CAAC,CAAC;CACJ;AACF,CAAC"}
+{"version":3,"file":"kbd.js","names":[],"sources":["../../../src/components/kbd/kbd.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// 提供 kbd 展示与快捷键注册实现。\n\nimport type { KbdPlatform, KbdProps, KbdTarget, KbdTranslations, KbdVariant } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { connectKbd } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, onBeforeUnmount, watchEffect } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useKbdPlatform } from './use-kbd-platform'\n\nexport const XhKbd = defineComponent({\n  name: 'XhKbd',\n  props: {\n    keys: { type: Array as PropType<string[]>, required: true },\n    platform: { type: String as PropType<KbdPlatform> },\n    variant: { type: String as PropType<KbdVariant> },\n    register: { type: Boolean, default: undefined },\n    target: { type: [String, Function] as PropType<KbdTarget> },\n    preventDefault: { type: Boolean, default: undefined },\n    enabled: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<KbdTranslations>> },\n  },\n  emits: {\n    'hot-key': (_details: PayloadOf<KbdProps, 'onHotKey'>) => true,\n  },\n  setup(props, { emit }) {\n    const detected = useKbdPlatform()\n    // withXhConfig 只能在 setup 期调，连接层在渲染期读这份代理。\n    // 本组件不能把它写进 computed：useKbdPlatform 在 onMounted 改写平台会让 api 失效，\n    // 下一次求值发生在下面 watchEffect 的作业里，那时已不在组件上下文中，inject 拿不到\n    // 全局配置，translations 与 locale 会被静默丢回内建英文。\n    // 代理包的是一组取值函数：props 与 detected 仍在求值期被追踪，响应性不变。\n    const configured = withXhConfig('kbd', {\n      get keys() {\n        return props.keys\n      },\n      get platform() {\n        return props.platform && props.platform !== 'auto' ? props.platform : detected.value\n      },\n      get variant() {\n        return props.variant\n      },\n      get register() {\n        return props.register\n      },\n      get target() {\n        return props.target\n      },\n      get preventDefault() {\n        return props.preventDefault\n      },\n      get enabled() {\n        return props.enabled\n      },\n      get translations() {\n        return props.translations\n      },\n      onHotKey: (details: PayloadOf<KbdProps, 'onHotKey'>) => emit('hot-key', details),\n    }) as KbdProps\n    const api = computed(() => connectKbd(configured, vueNormalize))\n    const onKeyDown = (event: Event): void => api.value.handleKeyDown(event as KeyboardEvent)\n    let bound: EventTarget | null = null\n    const stop = (): void => {\n      bound?.removeEventListener('keydown', onKeyDown)\n      bound = null\n    }\n    watchEffect(() => {\n      const next = api.value.resolveTarget(typeof document === 'undefined' ? null : document)\n      if (next === bound)\n        return\n      stop()\n      bound = next\n      bound?.addEventListener('keydown', onKeyDown)\n    })\n    onBeforeUnmount(stop)\n\n    return () => h('kbd', api.value.getRootProps() as Record<string, unknown>, api.value.segments.map((segment, index) => h(\n      'span',\n      { ...api.value.getKeyProps({ value: segment.source }) as Record<string, unknown>, key: `${segment.source}-${index}` },\n      segment.label,\n    )))\n  },\n})\n"],"mappings":";;;;;;AAgBA,MAAa,QAAQ,gBAAgB;CACnC,MAAM;CACN,OAAO;EACL,MAAM;GAAE,MAAM;GAA6B,UAAU;EAAK;EAC1D,UAAU,EAAE,MAAM,OAAgC;EAClD,SAAS,EAAE,MAAM,OAA+B;EAChD,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,QAAQ,EAAE,MAAM,CAAC,QAAQ,QAAQ,EAAyB;EAC1D,gBAAgB;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EACpD,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,cAAc,EAAE,MAAM,OAA6C;CACrE;CACA,OAAO,EACL,YAAY,aAA8C,KAC5D;CACA,MAAM,OAAO,EAAE,QAAQ;EACrB,MAAM,WAAW,eAAe;EAMhC,MAAM,aAAa,aAAa,OAAO;GACrC,IAAI,OAAO;IACT,OAAO,MAAM;GACf;GACA,IAAI,WAAW;IACb,OAAO,MAAM,YAAY,MAAM,aAAa,SAAS,MAAM,WAAW,SAAS;GACjF;GACA,IAAI,UAAU;IACZ,OAAO,MAAM;GACf;GACA,IAAI,WAAW;IACb,OAAO,MAAM;GACf;GACA,IAAI,SAAS;IACX,OAAO,MAAM;GACf;GACA,IAAI,iBAAiB;IACnB,OAAO,MAAM;GACf;GACA,IAAI,UAAU;IACZ,OAAO,MAAM;GACf;GACA,IAAI,eAAe;IACjB,OAAO,MAAM;GACf;GACA,WAAW,YAA6C,KAAK,WAAW,OAAO;EACjF,CAAC;EACD,MAAM,MAAM,eAAe,WAAW,YAAY,YAAY,CAAC;EAC/D,MAAM,aAAa,UAAuB,IAAI,MAAM,cAAc,KAAsB;EACxF,IAAI,QAA4B;EAChC,MAAM,aAAmB;GACvB,OAAO,oBAAoB,WAAW,SAAS;GAC/C,QAAQ;EACV;EACA,kBAAkB;GAChB,MAAM,OAAO,IAAI,MAAM,cAAc,OAAO,aAAa,cAAc,OAAO,QAAQ;GACtF,IAAI,SAAS,OACX;GACF,KAAK;GACL,QAAQ;GACR,OAAO,iBAAiB,WAAW,SAAS;EAC9C,CAAC;EACD,gBAAgB,IAAI;EAEpB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,IAAI,MAAM,SAAS,KAAK,SAAS,UAAU,EACpH,QACA;GAAE,GAAG,IAAI,MAAM,YAAY,EAAE,OAAO,QAAQ,OAAO,CAAC;GAA8B,KAAK,GAAG,QAAQ,OAAO,GAAG;EAAQ,GACpH,QAAQ,KACV,CAAC,CAAC;CACJ;AACF,CAAC"}

package/dist/components/listbox/listbox.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Orientation, Size, Tone } from "@xihan-ui/core";
-import { ListboxApi, ListboxNode, ListboxNodeMeta, ListboxSchema, ListboxSelectionMode } from "@xihan-ui/headless";
+import { CollectionVirtualizer, ListboxApi, ListboxNode, ListboxNodeMeta, ListboxSchema, ListboxSelectionMode } from "@xihan-ui/headless";
 //#region src/components/listbox/listbox.d.ts
 type ListboxProps = ListboxSchema['props'];
 /** 默认插槽的载荷：选中集合、选择模式与焦点锚点，以及判定选中与整份赋值、单选、切换的命令。 */
@@ -10,6 +10,9 @@ declare const XhListboxRoot: import("vue").DefineComponent<import("vue").Extract
   collection: {
     type: PropType<ListboxNode[]>;
   };
+  virtualizer: {
+    type: PropType<CollectionVirtualizer>;
+  };
   /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */
   label: {
     type: StringConstructor;
@@ -65,6 +68,9 @@ declare const XhListboxRoot: import("vue").DefineComponent<import("vue").Extract
   collection: {
     type: PropType<ListboxNode[]>;
   };
+  virtualizer: {
+    type: PropType<CollectionVirtualizer>;
+  };
   /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */
   label: {
     type: StringConstructor;
@@ -124,7 +130,12 @@ declare const XhListboxRoot: import("vue").DefineComponent<import("vue").Extract
 }, SlotsType<{
   default?: (props: ListboxRootSlotProps) => VNode[];
   label?: () => VNode[];
+  /** 只填条目的文字槽，副文本与首尾两格照旧各归各的 */
   item?: (node: ListboxNodeMeta) => VNode[];
+  /** 只接管行首那一格，其余槽照旧由数据铺 */
+  'item-prefix'?: (node: ListboxNodeMeta) => VNode[];
+  /** 只接管行尾那一格（计数、徽标、次级图标），其余槽照旧由数据铺 */
+  'item-suffix'?: (node: ListboxNodeMeta) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhListboxLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -183,9 +194,21 @@ declare const XhListboxItem: import("vue").DefineComponent<import("vue").Extract
 declare const XhListboxItemText: 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 XhListboxItemPrefix: 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 XhListboxItemSuffix: 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>;
+/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */
+declare const XhListboxItemDescription: 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 XhListboxItemIndicator: 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 { ListboxRootSlotProps, XhListboxContent, XhListboxEmpty, XhListboxGroup, XhListboxGroupLabel, XhListboxItem, XhListboxItemIndicator, XhListboxItemText, XhListboxLabel, XhListboxLoadMoreTrigger, XhListboxLoading, XhListboxRoot };
+export { ListboxRootSlotProps, XhListboxContent, XhListboxEmpty, XhListboxGroup, XhListboxGroupLabel, XhListboxItem, XhListboxItemDescription, XhListboxItemIndicator, XhListboxItemPrefix, XhListboxItemSuffix, XhListboxItemText, XhListboxLabel, XhListboxLoadMoreTrigger, XhListboxLoading, XhListboxRoot };
 //# sourceMappingURL=listbox.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"listbox.d.ts","names":[],"sources":["../../../src/components/listbox/listbox.ts"],"mappings":";;;;;KAwBK,eAAe;;KAGR,uBAAuB,KACjC;cAIW,6BAAa,8BAAA;;IAIO,MAAA,SAAS;;;;;;;IAGJ,MAAA;;;IACO,MAAA;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;IAKlB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;IAGV,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;EAIb,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IApBN,MAAA,SAAS;;;;;;;IAGJ,MAAA;;;IACO,MAAA;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;IAKlB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;IAGV,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;;;;;;;EAQ9B,WAAC,OAAO,yBAAyB;EACnC,cAAM;EACP,QAAC,MAAM,oBAAoB;kCA6BpC;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;gCA0B3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAQzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;MAWzB,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAoCxB;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"listbox.d.ts","names":[],"sources":["../../../src/components/listbox/listbox.ts"],"mappings":";;;;;KAwBK,eAAe;;KAGR,uBAAuB,KACjC;cAIW,6BAAa,8BAAA;;IAIO,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;;;;IAGN,MAAA;;;IACO,MAAA;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;IAKlB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;IAGV,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;EAIb,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IArBN,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;;;;IAGN,MAAA;;;IACO,MAAA;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;IAKlB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;IAGV,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;;;;;;;EAQ5B,WAAC,OAAO,yBAAyB;EACnC,cAAM;;EAEP,QAAC,MAAM,oBAAoB;;EAEpB,iBAAC,MAAM,oBAAoB;;EAE3B,iBAAC,MAAM,oBAAoB;kCA+B7C;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;gCA0B3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAQzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;MAWzB,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAsCxB;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/listbox/listbox.js

@@ -8,6 +8,7 @@ const XhListboxRoot = defineComponent({
 	name: "XhListboxRoot",
 	props: {
 		collection: { type: Array },
+		virtualizer: { type: Object },
 		/** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */
 		label: { type: String },
 		value: { type: [String, Array] },
@@ -59,7 +60,7 @@ const XhListboxRoot = defineComponent({
 			setValue: ctx.api.value.setValue,
 			select: ctx.api.value.select,
 			toggle: ctx.api.value.toggle
-		}) ?? [] : props.collection ? renderDefaultTree(ctx.api.value.collection, slots.label?.() ?? (props.label != null ? [props.label] : null), slots.item) : []]);
+		}) ?? [] : props.collection ? renderDefaultTree(ctx.api.value.collection, slots.label?.() ?? (props.label != null ? [props.label] : null), slots.item, slots["item-prefix"], slots["item-suffix"]) : []]);
 	}
 });
 const XhListboxLabel = defineComponent({
@@ -156,6 +157,7 @@ const XhListboxItem = defineComponent({
 			if (next === prev) return;
 			const { service } = ctx;
 			if (service.getStatus() !== "Started") return;
+			if (service.prop("virtualizer") && service.prop("collection")?.some((node) => node.value === props.value)) return;
 			if (itemEl.value && service.scope.getActiveElement() === itemEl.value) service.send({
 				type: "ITEM.FOCUS",
 				value: next
@@ -180,6 +182,33 @@ const XhListboxItemText = defineComponent({
 		return () => h("span", ctx.api.value.getItemTextProps(item.value), slots.default?.());
 	}
 });
+/** 条目行首的作者内容（图标、色块、头像），对读屏隐藏 */
+const XhListboxItemPrefix = defineComponent({
+	name: "XhListboxItemPrefix",
+	setup(_, { slots }) {
+		const ctx = useListboxContext();
+		const { item } = useListboxItemContext();
+		return () => h("span", ctx.api.value.getItemPrefixProps(item.value), slots.default?.());
+	}
+});
+/** 条目行尾的作者内容（计数、徽标） */
+const XhListboxItemSuffix = defineComponent({
+	name: "XhListboxItemSuffix",
+	setup(_, { slots }) {
+		const ctx = useListboxContext();
+		const { item } = useListboxItemContext();
+		return () => h("span", ctx.api.value.getItemSuffixProps(item.value), slots.default?.());
+	}
+});
+/** 条目的第 2 行副文本，跨文字槽、走 muted 档 */
+const XhListboxItemDescription = defineComponent({
+	name: "XhListboxItemDescription",
+	setup(_, { slots }) {
+		const ctx = useListboxContext();
+		const { item } = useListboxItemContext();
+		return () => h("span", ctx.api.value.getItemDescriptionProps(item.value), slots.default?.());
+	}
+});
 const XhListboxItemIndicator = defineComponent({
 	name: "XhListboxItemIndicator",
 	setup(_, { slots }) {
@@ -192,13 +221,19 @@ const XhListboxItemIndicator = defineComponent({
 * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
 * 与手写部件产出的 DOM 完全一致，需要修改结构（分组、条目外的节点）时写默认插槽。
 */
-function renderDefaultTree(collection, label, itemSlot) {
+function renderDefaultTree(collection, label, itemSlot, prefixSlot, suffixSlot) {
 	return [...label ? [h(XhListboxLabel, null, () => label)] : [], h(XhListboxContent, null, () => collection.map((node) => h(XhListboxItem, {
 		key: node.value,
 		value: node.value
-	}, () => [h(XhListboxItemText, null, () => itemSlot?.(node) ?? node.label), h(XhListboxItemIndicator)])))];
+	}, () => [
+		...prefixSlot ? [h(XhListboxItemPrefix, null, () => prefixSlot(node))] : [],
+		h(XhListboxItemText, null, () => itemSlot?.(node) ?? node.label),
+		...node.description != null ? [h(XhListboxItemDescription, null, () => node.description)] : [],
+		...suffixSlot ? [h(XhListboxItemSuffix, null, () => suffixSlot(node))] : [],
+		h(XhListboxItemIndicator)
+	])))];
 }
 //#endregion
-export { XhListboxContent, XhListboxEmpty, XhListboxGroup, XhListboxGroupLabel, XhListboxItem, XhListboxItemIndicator, XhListboxItemText, XhListboxLabel, XhListboxLoadMoreTrigger, XhListboxLoading, XhListboxRoot };
+export { XhListboxContent, XhListboxEmpty, XhListboxGroup, XhListboxGroupLabel, XhListboxItem, XhListboxItemDescription, XhListboxItemIndicator, XhListboxItemPrefix, XhListboxItemSuffix, XhListboxItemText, XhListboxLabel, XhListboxLoadMoreTrigger, XhListboxLoading, XhListboxRoot };
 
 //# sourceMappingURL=listbox.js.map