@xihan-ui/vue 4.1.0 → 5.0.0

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;;;;;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"}
+{"version":3,"file":"json-viewer.d.ts","names":[],"sources":["../../../src/components/json-viewer/json-viewer.ts"],"mappings":";;;;;KAgBK,kBAAkB;;;;;KAMX,6BAA6B,KAAK;cAuFjC,gCAAgB,8BAAA;;IAKS,MAAA;IAAyC;;;IACnD,MAAA,SAAS;;;;IAEF,MAAA,SAAS;;;;;;;;;;;;;;;;;;IAQL,MAAA,mBAAmB;;;;;IAE3B,MAAA,SAAS;;;IACJ,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;IAMhB,MAAA,SAAS;;;IACR,MAAA,SAAS;;;;;;;IAGD,MAAA,SAAS,QAAQ;;;;;EAYb,0BAAA,UAAA,UAAU;EACb,yBAAA,QAAA,UAAU;EACjB,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACR,eAAA,UAAA,UAAU;;;IA3CD,MAAA;IAAyC;;;IACnD,MAAA,SAAS;;;;IAEF,MAAA,SAAS;;;;;;;;;;;;;;;;;;IAQL,MAAA,mBAAmB;;;;;IAE3B,MAAA,SAAS;;;IACJ,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;IAMhB,MAAA,SAAS;;;IACR,MAAA,SAAS;;;;;;;IAGD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;EAIzC,cAAM;;EAEJ,WAAC,OAAO,+BAA+B;kCAoEnD"}

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

@@ -1,12 +1,32 @@
 import { withXhConfig } from "../../config/config.js";
 import { useJsonViewer } from "./use-json-viewer.js";
-import { Fragment, defineComponent, h, mergeProps } from "vue";
 import { groupJsonViewerNodesByParent } from "@xihan-ui/headless";
+import { Fragment, defineComponent, h, mergeProps } from "vue";
 //#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);
 }
+/** 原文按段铺：有类别的段包进 token 部件着色，空白与解析不了的原文是纯文本。 */
+function renderTextSegments(api) {
+	return api.textSegments.map((segment) => segment.kind ? h("span", api.getTokenProps({ kind: segment.kind }), segment.text) : segment.text);
+}
+/**
+* 内建工具条：根的第一个孩子。钮里不写内容，字形由皮肤按部件画；
+* 播报区跟着复制钮常驻，成功那一刻才有文字，读屏才念得出回执。
+*/
+function renderToolbar(api) {
+	if (!api.tools.length) return null;
+	const buttons = [];
+	if (api.tools.includes("expand")) buttons.push(h("button", api.getExpandTriggerProps()));
+	if (api.tools.includes("wrap")) buttons.push(h("button", api.getWrapTriggerProps()));
+	if (api.tools.includes("copy")) {
+		buttons.push(h("button", api.getCopyTriggerProps()));
+		buttons.push(h("span", api.getStatusProps(), api.announcement));
+	}
+	if (api.tools.includes("view")) buttons.push(h("button", api.getViewTriggerProps()));
+	return h("div", api.getToolbarProps(), buttons);
+}
 function renderRows(api, children, parent) {
 	return (children.get(parent) ?? []).map((node) => renderRow(api, children, node));
 }
@@ -28,6 +48,7 @@ function renderRow(api, children, node) {
 	const control = [h("span", api.getBranchTriggerProps(ref), [h("span", api.getBranchIndicatorProps(ref))])];
 	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)));
+	control.push(h("span", api.getBranchSummaryProps(ref), api.branchSummary(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)));
 	return h("div", {
@@ -43,6 +64,25 @@ const XhJsonViewerRoot = defineComponent({
 			default: void 0
 		},
 		view: { type: String },
+		/** 非受控的初始形态，默认 tree。 */
+		defaultView: { type: String },
+		/** 值的原文：提供时原文档与复制钮取它，只重排缩进、字面量一字不改。 */
+		source: { type: String },
+		/** 原文档是否自动换行；提供即受控。 */
+		wrap: {
+			type: Boolean,
+			default: void 0
+		},
+		/** 非受控的初始换行，默认 false。 */
+		defaultWrap: {
+			type: Boolean,
+			default: void 0
+		},
+		/** 内建工具条：不提供即没有；true 铺出全部工具；数组只铺列出的几项（expand / wrap / copy / view）。 */
+		tools: {
+			type: [Boolean, Array],
+			default: void 0
+		},
 		/** 外框形态：outline 带描边与底色（默认），subtle 淡底无描边，ghost 去掉描边与底色只保留内容。 */
 		variant: { type: String },
 		expandedValue: { type: Array },
@@ -68,20 +108,43 @@ const XhJsonViewerRoot = defineComponent({
 	inheritAttrs: false,
 	emits: {
 		"expanded-value-change": (_details) => true,
-		"update:expandedValue": (_value) => true
+		"update:expandedValue": (_value) => true,
+		"view-change": (_details) => true,
+		"update:view": (_view) => true,
+		"wrap-change": (_details) => true,
+		"update:wrap": (_wrap) => true,
+		"copy-error": (_details) => true
 	},
 	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 ctx = useJsonViewer(withXhConfig("json-viewer", props), notify, {
+			onViewChange: (details) => {
+				emit("view-change", details);
+				emit("update:view", details.view);
+			},
+			onWrapChange: (details) => {
+				emit("wrap-change", details);
+				emit("update:wrap", details.wrap);
+			},
+			onCopyError: (details) => emit("copy-error", details)
+		});
 		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)]);
+			if (api.view === "text") return h("div", rootProps, [
+				renderToolbar(api),
+				h("pre", api.getTextProps(), renderTextSegments(api)),
+				renderEmpty(api)
+			]);
 			const children = groupJsonViewerNodesByParent(api.visibleNodes);
-			return h("div", rootProps, [h("div", api.getTreeProps(), renderRows(api, children, null)), renderEmpty(api)]);
+			return h("div", rootProps, [
+				renderToolbar(api),
+				h("div", api.getTreeProps(), renderRows(api, children, null)),
+				renderEmpty(api)
+			]);
 		};
 		return () => {
 			const api = ctx.api.value;

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 { 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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"}
+{"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, JsonViewerTool, 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\n/** 原文按段铺：有类别的段包进 token 部件着色，空白与解析不了的原文是纯文本。 */\nfunction renderTextSegments(api: JsonViewerApi): Array<VNode | string> {\n  return api.textSegments.map(segment => (segment.kind\n    ? h('span', api.getTokenProps({ kind: segment.kind }) as Record<string, unknown>, segment.text)\n    : segment.text))\n}\n\n/**\n * 内建工具条：根的第一个孩子。钮里不写内容，字形由皮肤按部件画；\n * 播报区跟着复制钮常驻，成功那一刻才有文字，读屏才念得出回执。\n */\nfunction renderToolbar(api: JsonViewerApi): VNode | null {\n  if (!api.tools.length)\n    return null\n  const buttons: VNode[] = []\n  if (api.tools.includes('expand'))\n    buttons.push(h('button', api.getExpandTriggerProps() as Record<string, unknown>))\n  if (api.tools.includes('wrap'))\n    buttons.push(h('button', api.getWrapTriggerProps() as Record<string, unknown>))\n  if (api.tools.includes('copy')) {\n    buttons.push(h('button', api.getCopyTriggerProps() as Record<string, unknown>))\n    buttons.push(h('span', api.getStatusProps() as Record<string, unknown>, api.announcement))\n  }\n  if (api.tools.includes('view'))\n    buttons.push(h('button', api.getViewTriggerProps() as Record<string, unknown>))\n  return h('div', api.getToolbarProps() as Record<string, unknown>, buttons)\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  control.push(h('span', api.getBranchSummaryProps(ref) as Record<string, unknown>, api.branchSummary(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    /** 非受控的初始形态，默认 tree。 */\n    defaultView: { type: String as PropType<JsonViewerView> },\n    /** 值的原文：提供时原文档与复制钮取它，只重排缩进、字面量一字不改。 */\n    source: { type: String },\n    /** 原文档是否自动换行；提供即受控。 */\n    wrap: { type: Boolean, default: undefined },\n    /** 非受控的初始换行，默认 false。 */\n    defaultWrap: { type: Boolean, default: undefined },\n    /** 内建工具条：不提供即没有；true 铺出全部工具；数组只铺列出的几项（expand / wrap / copy / view）。 */\n    tools: { type: [Boolean, Array] as PropType<boolean | JsonViewerTool[]>, default: undefined },\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  // *-change 携带 details 对象，update:* 携带裸值（v-model）\n  emits: {\n    'expanded-value-change': (_details: PayloadOf<JsonViewerProps, 'onExpandedValueChange'>) => true,\n    'update:expandedValue': (_value: PayloadOf<JsonViewerProps, 'onExpandedValueChange'>['value']) => true,\n    'view-change': (_details: PayloadOf<JsonViewerProps, 'onViewChange'>) => true,\n    'update:view': (_view: PayloadOf<JsonViewerProps, 'onViewChange'>['view']) => true,\n    'wrap-change': (_details: PayloadOf<JsonViewerProps, 'onWrapChange'>) => true,\n    'update:wrap': (_wrap: PayloadOf<JsonViewerProps, 'onWrapChange'>['wrap']) => true,\n    'copy-error': (_details: PayloadOf<JsonViewerProps, 'onCopyError'>) => 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      onViewChange: (details) => {\n        emit('view-change', details)\n        emit('update:view', details.view)\n      },\n      onWrapChange: (details) => {\n        emit('wrap-change', details)\n        emit('update:wrap', details.wrap)\n      },\n      onCopyError: details => emit('copy-error', details),\n    })\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          renderToolbar(api),\n          h('pre', api.getTextProps() as Record<string, unknown>, renderTextSegments(api)),\n          renderEmpty(api),\n        ])\n      }\n\n      const children = groupJsonViewerNodesByParent(api.visibleNodes)\n      return h('div', rootProps, [\n        renderToolbar(api),\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/json-viewer/use-json-viewer.d.ts

@@ -1,13 +1,15 @@
+import { JsonViewerApi, JsonViewerSchema } from "@xihan-ui/headless";
 import { ComputedRef } from "vue";
 import { Service } from "@xihan-ui/core";
-import { JsonViewerApi, JsonViewerSchema } from "@xihan-ui/headless";
 //#region src/components/json-viewer/use-json-viewer.d.ts
 interface JsonViewerContext {
   api: ComputedRef<JsonViewerApi>;
   /** 状态机实例，供调用方直接发送事件（如从外部展开某一条路径）。 */
   service: Service<JsonViewerSchema>;
 }
-declare function useJsonViewer(props: JsonViewerSchema['props'], onExpandedValueChange?: JsonViewerSchema['props']['onExpandedValueChange']): JsonViewerContext;
+/** 工具条的三路通知：Vue 的 props 里不带回调，由组件把各自的 emit 接进来。 */
+type JsonViewerToolEvents = Pick<JsonViewerSchema['props'], 'onViewChange' | 'onWrapChange' | 'onCopyError'>;
+declare function useJsonViewer(props: JsonViewerSchema['props'], onExpandedValueChange?: JsonViewerSchema['props']['onExpandedValueChange'], events?: JsonViewerToolEvents): JsonViewerContext;
 //#endregion
-export { JsonViewerContext, useJsonViewer };
+export { JsonViewerContext, JsonViewerToolEvents, useJsonViewer };
 //# sourceMappingURL=use-json-viewer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-json-viewer.d.ts","names":[],"sources":["../../../src/components/json-viewer/use-json-viewer.ts"],"mappings":";;;;UAeiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAIH,cACd,OAAO,2BACP,wBAAwB,qDACvB"}
+{"version":3,"file":"use-json-viewer.d.ts","names":[],"sources":["../../../src/components/json-viewer/use-json-viewer.ts"],"mappings":";;;;UAeiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;;KAIP,uBAAuB,KAAK;iBAGxB,cACd,OAAO,2BACP,wBAAwB,oDACxB,SAAQ,uBACP"}

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

@@ -1,12 +1,13 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed } from "vue";
 import { connectJsonViewer, jsonViewerMachine } from "@xihan-ui/headless";
+import { computed } from "vue";
 //#region src/components/json-viewer/use-json-viewer.ts
-function useJsonViewer(props, onExpandedValueChange) {
+function useJsonViewer(props, onExpandedValueChange, events = {}) {
 	const service = useMachine(jsonViewerMachine, () => ({
 		...props,
-		onExpandedValueChange
+		onExpandedValueChange,
+		...events
 	}));
 	return {
 		api: computed(() => connectJsonViewer(service, vueNormalize)),

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

@@ -1 +1 @@
-{"version":3,"file":"use-json-viewer.js","names":[],"sources":["../../../src/components/json-viewer/use-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// 提供 use json viewer 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { JsonViewerApi, JsonViewerSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectJsonViewer, jsonViewerMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface JsonViewerContext {\n  api: ComputedRef<JsonViewerApi>\n  /** 状态机实例，供调用方直接发送事件（如从外部展开某一条路径）。 */\n  service: Service<JsonViewerSchema>\n}\n\n// 不建 scope：connect 不派生任何 id\nexport function useJsonViewer(\n  props: JsonViewerSchema['props'],\n  onExpandedValueChange?: JsonViewerSchema['props']['onExpandedValueChange'],\n): JsonViewerContext {\n  const service = useMachine(jsonViewerMachine, () => ({ ...props, onExpandedValueChange }))\n  const api = computed(() => connectJsonViewer(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;AAsBA,SAAgB,cACd,OACA,uBACmB;CACnB,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO;CAAsB,EAAE;CAEzF,OAAO;EAAE,KADG,eAAe,kBAAkB,SAAS,YAAY,CACvD;EAAG;CAAQ;AACxB"}
+{"version":3,"file":"use-json-viewer.js","names":[],"sources":["../../../src/components/json-viewer/use-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// 提供 use json viewer 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { JsonViewerApi, JsonViewerSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectJsonViewer, jsonViewerMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface JsonViewerContext {\n  api: ComputedRef<JsonViewerApi>\n  /** 状态机实例，供调用方直接发送事件（如从外部展开某一条路径）。 */\n  service: Service<JsonViewerSchema>\n}\n\n/** 工具条的三路通知：Vue 的 props 里不带回调，由组件把各自的 emit 接进来。 */\nexport type JsonViewerToolEvents = Pick<JsonViewerSchema['props'], 'onViewChange' | 'onWrapChange' | 'onCopyError'>\n\n// 不建 scope：connect 不派生任何 id\nexport function useJsonViewer(\n  props: JsonViewerSchema['props'],\n  onExpandedValueChange?: JsonViewerSchema['props']['onExpandedValueChange'],\n  events: JsonViewerToolEvents = {},\n): JsonViewerContext {\n  const service = useMachine(jsonViewerMachine, () => ({ ...props, onExpandedValueChange, ...events }))\n  const api = computed(() => connectJsonViewer(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;AAyBA,SAAgB,cACd,OACA,uBACA,SAA+B,CAAC,GACb;CACnB,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO;EAAuB,GAAG;CAAO,EAAE;CAEpG,OAAO;EAAE,KADG,eAAe,kBAAkB,SAAS,YAAY,CACvD;EAAG;CAAQ;AACxB"}

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

@@ -1,6 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { KbdProps, KbdTarget, KbdTranslations, KbdVariant } from "@xihan-ui/headless";
 import { PropType } from "vue";
-import { KbdPlatform, KbdProps, KbdTarget, KbdTranslations, KbdVariant } from "@xihan-ui/headless";
+import { KbdPlatform } from "@xihan-ui/core/hotkey";
 //#region src/components/kbd/kbd.d.ts
 declare const XhKbd: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   keys: {

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;;;;;;;;qCA8DnD"}
+{"version":3,"file":"kbd.d.ts","names":[],"sources":["../../../src/components/kbd/kbd.ts"],"mappings":";;;;;cAiBa,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

@@ -1,8 +1,8 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { withXhConfig } from "../../config/config.js";
 import { useKbdPlatform } from "./use-kbd-platform.js";
-import { computed, defineComponent, h, onBeforeUnmount, watchEffect } from "vue";
 import { connectKbd } from "@xihan-ui/headless";
+import { computed, defineComponent, h, onBeforeUnmount, watchEffect } from "vue";
 //#region src/components/kbd/kbd.ts
 const XhKbd = defineComponent({
 	name: "XhKbd",

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    // 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"}
+{"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 } from '@xihan-ui/core/hotkey'\nimport type { 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":";;;;;;AAiBA,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/kbd/use-kbd-platform.js

@@ -1,5 +1,5 @@
 import { onMounted, ref } from "vue";
-import { detectKbdPlatform } from "@xihan-ui/headless";
+import { detectKbdPlatform } from "@xihan-ui/core/hotkey";
 //#region src/components/kbd/use-kbd-platform.ts
 /** 浏览器平台侦测只属于适配器；Headless 仍只接收显式平台事实。 */
 function useKbdPlatform() {

package/dist/components/kbd/use-kbd-platform.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-kbd-platform.js","names":[],"sources":["../../../src/components/kbd/use-kbd-platform.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 kbd platform 相关实现。\n\nimport type { KbdPlatform } from '@xihan-ui/headless'\nimport type { Ref } from 'vue'\nimport { detectKbdPlatform } from '@xihan-ui/headless'\nimport { onMounted, ref } from 'vue'\n\n/** 浏览器平台侦测只属于适配器；Headless 仍只接收显式平台事实。 */\nexport function useKbdPlatform(): Ref<KbdPlatform> {\n  const detected = ref<KbdPlatform>('auto')\n  onMounted(() => {\n    detected.value = detectKbdPlatform()\n  })\n  return detected\n}\n"],"mappings":";;;;AAaA,SAAgB,iBAAmC;CACjD,MAAM,WAAW,IAAiB,MAAM;CACxC,gBAAgB;EACd,SAAS,QAAQ,kBAAkB;CACrC,CAAC;CACD,OAAO;AACT"}
+{"version":3,"file":"use-kbd-platform.js","names":[],"sources":["../../../src/components/kbd/use-kbd-platform.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 kbd platform 相关实现。\n\nimport type { KbdPlatform } from '@xihan-ui/core/hotkey'\nimport type { Ref } from 'vue'\nimport { detectKbdPlatform } from '@xihan-ui/core/hotkey'\nimport { onMounted, ref } from 'vue'\n\n/** 浏览器平台侦测只属于适配器；Headless 仍只接收显式平台事实。 */\nexport function useKbdPlatform(): Ref<KbdPlatform> {\n  const detected = ref<KbdPlatform>('auto')\n  onMounted(() => {\n    detected.value = detectKbdPlatform()\n  })\n  return detected\n}\n"],"mappings":";;;;AAaA,SAAgB,iBAAmC;CACjD,MAAM,WAAW,IAAiB,MAAM;CACxC,gBAAgB;EACd,SAAS,QAAQ,kBAAkB;CACrC,CAAC;CACD,OAAO;AACT"}

package/dist/components/layout/layout.d.ts

@@ -1,6 +1,6 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { PropType } from "vue";
 import { LayoutBreakpoint, LayoutSchema, LayoutSiderPlacement, LayoutSiderPresentation } from "@xihan-ui/headless";
+import { PropType } from "vue";
 //#region src/components/layout/layout.d.ts
 type LayoutProps = LayoutSchema['props'];
 /** 各段一律渲染为 div：地标（banner / navigation / main / contentinfo）由作者自行标注。 */

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

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { LayoutApi, LayoutSchema } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/layout/use-layout.d.ts
 interface LayoutContext {
   api: ComputedRef<LayoutApi>;

package/dist/components/layout/use-layout.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 { connectLayout, layoutMachine } from "@xihan-ui/headless";
 import { computed } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { connectLayout, layoutMachine } from "@xihan-ui/headless";
 //#region src/components/layout/use-layout.ts
 function useLayout(props, onSiderCollapsedChange, onSiderBreakpoint) {
 	const idGen = createVueIdGenerator();

package/dist/components/list/context.d.ts

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

package/dist/components/list/list.js

@@ -1,8 +1,8 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { withXhConfig } from "../../config/config.js";
 import { provideList, useListContext } from "./context.js";
-import { computed, defineComponent, h } from "vue";
 import { connectList } from "@xihan-ui/headless";
+import { computed, defineComponent, h } from "vue";
 //#region src/components/list/list.ts
 const XhListRoot = defineComponent({
 	name: "XhListRoot",

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

@@ -1,12 +1,16 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { CollectionVirtualizer, ListboxApi, ListboxNode, ListboxNodeMeta, ListboxSchema, ListboxSelectionMode, ListboxTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Orientation, Size, Tone } from "@xihan-ui/core";
-import { CollectionVirtualizer, ListboxApi, ListboxNode, ListboxNodeMeta, ListboxSchema, ListboxSelectionMode } from "@xihan-ui/headless";
 //#region src/components/listbox/listbox.d.ts
 type ListboxProps = ListboxSchema['props'];
 /** 默认插槽的载荷：选中集合、选择模式与焦点锚点，以及判定选中与整份赋值、单选、切换的命令。 */
 type ListboxRootSlotProps = Pick<ListboxApi, 'value' | 'selectionMode' | 'focusedValue' | 'isSelected' | 'setValue' | 'select' | 'toggle'>;
 declare const XhListboxRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   collection: {
     type: PropType<ListboxNode[]>;
   };
@@ -59,12 +63,19 @@ declare const XhListboxRoot: import("vue").DefineComponent<import("vue").Extract
   orientation: {
     type: PropType<Orientation>;
   };
+  translations: {
+    type: PropType<Partial<ListboxTranslations>>;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'value-change': (_details: PayloadOf<ListboxProps, "onValueChange">) => true;
   'update:value': (_value: PayloadOf<ListboxProps, "onValueChange">["value"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   collection: {
     type: PropType<ListboxNode[]>;
   };
@@ -117,6 +128,9 @@ declare const XhListboxRoot: import("vue").DefineComponent<import("vue").Extract
   orientation: {
     type: PropType<Orientation>;
   };
+  translations: {
+    type: PropType<Partial<ListboxTranslations>>;
+  };
 }>> & Readonly<{
   "onValue-change"?: ((_details: import("@xihan-ui/headless").ListboxValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: string[]) => any) | undefined;
@@ -130,6 +144,8 @@ declare const XhListboxRoot: import("vue").DefineComponent<import("vue").Extract
 }, SlotsType<{
   default?: (props: ListboxRootSlotProps) => VNode[];
   label?: () => VNode[];
+  /** 不写默认插槽时空态占位的内容；未写时取 translations.empty。 */
+  empty?: () => VNode[];
   /** 只填条目的文字槽，副文本与首尾两格照旧各归各的 */
   item?: (node: ListboxNodeMeta) => VNode[];
   /** 只接管行首那一格，其余槽照旧由数据铺 */

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;;;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"}
+{"version":3,"file":"listbox.d.ts","names":[],"sources":["../../../src/components/listbox/listbox.ts"],"mappings":";;;;;KA4BK,eAAe;;KAGR,uBAAuB,KACjC;cAIW,6BAAa,8BAAA;;;;;;IAMO,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;;;;IAGN,MAAA;;;IACO,MAAA;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;IAKlB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;IAGV,MAAA,SAAS;;;IACD,MAAA,SAAS;;;IACR,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;IAtBN,MAAA,SAAS;;;IACP,MAAA,SAAS;;;;;;;IAGN,MAAA;;;IACO,MAAA;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;IAKlB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;IAGV,MAAA,SAAS;;;IACD,MAAA,SAAS;;;IACR,MAAA,SAAS,QAAQ;;;;;;;;;;;;;EAQrC,WAAC,OAAO,yBAAyB;EACnC,cAAM;;EAEN,cAAM;;EAEP,QAAC,MAAM,oBAAoB;;EAEpB,iBAAC,MAAM,oBAAoB;;EAE3B,iBAAC,MAAM,oBAAoB;kCA6B7C;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAWzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;gCA6B3B,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

@@ -1,12 +1,18 @@
+import { renderStructure } from "../../runtime/structure.js";
+import { withXhConfig } from "../../config/config.js";
 import { useScrollbars } from "../../runtime/use-scrollbars.js";
 import { useFormControlProps } from "../form/use-form-control.js";
+import { useFieldGroupWiring, useFieldLabelWiring } from "../field/use-field-control.js";
 import { provideListbox, provideListboxItem, provideListboxItemGroup, useListboxContext, useListboxItemContext, useListboxItemGroupContext } from "./context.js";
 import { useListbox } from "./use-listbox.js";
-import { computed, defineComponent, h, mergeProps, onBeforeUnmount, onUpdated, ref, watch } from "vue";
+import { listboxStructure } from "@xihan-ui/headless";
+import { computed, defineComponent, h, mergeProps, onBeforeUnmount, onUnmounted, onUpdated, ref, watch } from "vue";
 //#region src/components/listbox/listbox.ts
 const XhListboxRoot = defineComponent({
 	name: "XhListboxRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		collection: { type: Array },
 		virtualizer: { type: Object },
 		/** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */
@@ -38,7 +44,8 @@ const XhListboxRoot = defineComponent({
 			default: void 0
 		},
 		dir: { type: String },
-		orientation: { type: String }
+		orientation: { type: String },
+		translations: { type: Object }
 	},
 	emits: {
 		"value-change": (_details) => true,
@@ -50,7 +57,7 @@ const XhListboxRoot = defineComponent({
 			emit("value-change", details);
 			emit("update:value", details.value);
 		};
-		const ctx = useListbox(useFormControlProps(props), notify);
+		const ctx = useListbox(withXhConfig("listbox", useFormControlProps(props)), notify);
 		provideListbox(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), [...slots.default ? slots.default({
 			value: ctx.api.value.value,
@@ -60,13 +67,23 @@ 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, slots["item-prefix"], slots["item-suffix"]) : []]);
+		}) ?? [] : renderDefaultStructure(ctx.api.value, props.label, {
+			"label": slots.label,
+			"empty": slots.empty,
+			"item": slots.item,
+			"item-prefix": slots["item-prefix"],
+			"item-suffix": slots["item-suffix"]
+		})]);
 	}
 });
 const XhListboxLabel = defineComponent({
 	name: "XhListboxLabel",
 	setup(_, { slots }) {
 		const ctx = useListboxContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("span", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -75,6 +92,8 @@ const XhListboxContent = defineComponent({
 	inheritAttrs: false,
 	setup(_, { slots, attrs }) {
 		const ctx = useListboxContext();
+		const fieldWiring = useFieldGroupWiring();
+		const fieldLabel = useFieldLabelWiring();
 		const contentRef = ref(null);
 		const bars = useScrollbars({
 			scrollable: () => contentRef.value,
@@ -84,7 +103,10 @@ const XhListboxContent = defineComponent({
 		});
 		onUpdated(() => bars.measure());
 		return () => [h("div", {
-			...mergeProps(ctx.api.value.getContentProps(), attrs),
+			...mergeProps(fieldLabel.value({
+				...fieldWiring.value,
+				...ctx.api.value.getContentProps()
+			}), attrs),
 			ref: (el) => {
 				contentRef.value = el;
 			}
@@ -217,21 +239,38 @@ const XhListboxItemIndicator = defineComponent({
 		return () => h("span", ctx.api.value.getItemIndicatorProps(item.value), slots.default?.());
 	}
 });
+/** 标准结构里各部件对应的组件。 */
+const LISTBOX_PARTS = {
+	"label": XhListboxLabel,
+	"content": XhListboxContent,
+	"item": XhListboxItem,
+	"item-prefix": XhListboxItemPrefix,
+	"item-text": XhListboxItemText,
+	"item-description": XhListboxItemDescription,
+	"item-suffix": XhListboxItemSuffix,
+	"item-indicator": XhListboxItemIndicator,
+	"empty": XhListboxEmpty,
+	"loading": XhListboxLoading
+};
 /**
-* 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
-* 与手写部件产出的 DOM 完全一致，需要修改结构（分组、条目外的节点）时写默认插槽。
+* 未写默认插槽时铺开的整套结构，作者只提供数据：照 headless 的 listboxStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题、条目文字与行首行尾由对应插槽接管。
 */
-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
-	}, () => [
-		...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)
-	])))];
+function renderDefaultStructure(api, label, authored) {
+	return renderStructure(listboxStructure(api, {
+		label,
+		slotted: (name) => authored[name] != null
+	}), LISTBOX_PARTS, (node) => {
+		const meta = node.data;
+		switch (node.slot?.name) {
+			case "label": return authored.label?.();
+			case "empty": return authored.empty?.();
+			case "item": return authored.item?.(meta) ?? meta.label;
+			case "item-prefix": return authored["item-prefix"]?.(meta);
+			case "item-suffix": return authored["item-suffix"]?.(meta);
+			default: return;
+		}
+	});
 }
 //#endregion
 export { XhListboxContent, XhListboxEmpty, XhListboxGroup, XhListboxGroupLabel, XhListboxItem, XhListboxItemDescription, XhListboxItemIndicator, XhListboxItemPrefix, XhListboxItemSuffix, XhListboxItemText, XhListboxLabel, XhListboxLoadMoreTrigger, XhListboxLoading, XhListboxRoot };