@xihan-ui/vue 1.1.0 → 2.0.0

package/dist/components/bar-code/bar-code.js

@@ -0,0 +1,70 @@
+import { vueNormalize } from "../../runtime/normalize-props.js";
+import { computed, defineComponent, h } from "vue";
+import { connectBarCode } from "@xihan-ui/headless";
+//#region src/components/bar-code/bar-code.ts
+/**
+* 整张码绘制为一个 `<svg>`，`format` 选择码制：全部条合成一条 `<path>`，人读文字每段一个 `<text>`，
+* 静区依靠 viewBox 留出。条空序列由 connect 计算一次，这里只取现成的 path 与文字；
+* 没有可绘制的内容时不生成任何几何节点。
+*/
+const XhBarCode = defineComponent({
+	name: "XhBarCode",
+	props: {
+		format: { type: String },
+		value: { type: String },
+		gs1: {
+			type: Boolean,
+			default: void 0
+		},
+		text: {
+			type: Boolean,
+			default: void 0
+		},
+		checksum: {
+			type: Boolean,
+			default: void 0
+		},
+		barWidth: { type: Number },
+		height: { type: Number },
+		margin: { type: Number },
+		bearerBars: {
+			type: Boolean,
+			default: void 0
+		},
+		label: { type: String }
+	},
+	setup(props) {
+		const api = computed(() => connectBarCode({
+			format: props.format,
+			value: props.value,
+			gs1: props.gs1,
+			text: props.text,
+			checksum: props.checksum,
+			barWidth: props.barWidth,
+			height: props.height,
+			margin: props.margin,
+			bearerBars: props.bearerBars,
+			label: props.label
+		}, vueNormalize));
+		return () => {
+			const current = api.value;
+			const children = [];
+			if (current.path !== "") children.push(h("path", {
+				"data-xh-geom": "bars",
+				"d": current.path
+			}));
+			for (const run of current.text) children.push(h("text", {
+				"data-xh-geom": "text",
+				"x": run.x,
+				"y": run.y,
+				"text-anchor": run.anchor,
+				"font-size": current.fontSize
+			}, run.text));
+			return h("svg", current.getRootProps(), children);
+		};
+	}
+});
+//#endregion
+export { XhBarCode };
+
+//# sourceMappingURL=bar-code.js.map

package/dist/components/bar-code/bar-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bar-code.js","names":[],"sources":["../../../src/components/bar-code/bar-code.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// 提供 bar code 相关实现。\n\nimport type { BarCodeFormat, BarCodeProps } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport { connectBarCode } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\n\n/**\n * 整张码绘制为一个 `<svg>`，`format` 选择码制：全部条合成一条 `<path>`，人读文字每段一个 `<text>`，\n * 静区依靠 viewBox 留出。条空序列由 connect 计算一次，这里只取现成的 path 与文字；\n * 没有可绘制的内容时不生成任何几何节点。\n */\nexport const XhBarCode = defineComponent({\n  name: 'XhBarCode',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined——\n  // 没给与给了 false 在 connect 里是两回事（checksum / bearerBars 给了别的码制要报警告）\n  props: {\n    format: { type: String as PropType<BarCodeFormat> },\n    value: { type: String },\n    gs1: { type: Boolean, default: undefined },\n    text: { type: Boolean, default: undefined },\n    checksum: { type: Boolean, default: undefined },\n    barWidth: { type: Number },\n    height: { type: Number },\n    margin: { type: Number },\n    bearerBars: { type: Boolean, default: undefined },\n    label: { type: String },\n  },\n  setup(props) {\n    const api = computed(() => connectBarCode({\n      format: props.format,\n      value: props.value,\n      gs1: props.gs1,\n      text: props.text,\n      checksum: props.checksum,\n      barWidth: props.barWidth,\n      height: props.height,\n      margin: props.margin,\n      bearerBars: props.bearerBars,\n      label: props.label,\n    } satisfies BarCodeProps, vueNormalize))\n\n    return () => {\n      const current = api.value\n      const children: VNode[] = []\n      if (current.path !== '')\n        children.push(h('path', { 'data-xh-geom': 'bars', 'd': current.path }))\n      for (const run of current.text) {\n        children.push(h('text', {\n          'data-xh-geom': 'text',\n          'x': run.x,\n          'y': run.y,\n          'text-anchor': run.anchor,\n          'font-size': current.fontSize,\n        }, run.text))\n      }\n      return h('svg', current.getRootProps() as Record<string, unknown>, children)\n    }\n  },\n})\n"],"mappings":";;;;;;;;;AAkBA,MAAa,YAAY,gBAAgB;CACvC,MAAM;CAGN,OAAO;EACL,QAAQ,EAAE,MAAM,OAAkC;EAClD,OAAO,EAAE,MAAM,OAAO;EACtB,KAAK;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EACzC,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU,EAAE,MAAM,OAAO;EACzB,QAAQ,EAAE,MAAM,OAAO;EACvB,QAAQ,EAAE,MAAM,OAAO;EACvB,YAAY;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAChD,OAAO,EAAE,MAAM,OAAO;CACxB;CACA,MAAM,OAAO;EACX,MAAM,MAAM,eAAe,eAAe;GACxC,QAAQ,MAAM;GACd,OAAO,MAAM;GACb,KAAK,MAAM;GACX,MAAM,MAAM;GACZ,UAAU,MAAM;GAChB,UAAU,MAAM;GAChB,QAAQ,MAAM;GACd,QAAQ,MAAM;GACd,YAAY,MAAM;GAClB,OAAO,MAAM;EACf,GAA0B,YAAY,CAAC;EAEvC,aAAa;GACX,MAAM,UAAU,IAAI;GACpB,MAAM,WAAoB,CAAC;GAC3B,IAAI,QAAQ,SAAS,IACnB,SAAS,KAAK,EAAE,QAAQ;IAAE,gBAAgB;IAAQ,KAAK,QAAQ;GAAK,CAAC,CAAC;GACxE,KAAK,MAAM,OAAO,QAAQ,MACxB,SAAS,KAAK,EAAE,QAAQ;IACtB,gBAAgB;IAChB,KAAK,IAAI;IACT,KAAK,IAAI;IACT,eAAe,IAAI;IACnB,aAAa,QAAQ;GACvB,GAAG,IAAI,IAAI,CAAC;GAEd,OAAO,EAAE,OAAO,QAAQ,aAAa,GAA8B,QAAQ;EAC7E;CACF;AACF,CAAC"}

package/dist/components/breadcrumb/breadcrumb.d.ts

@@ -1,72 +1,84 @@
-import { PropType } from "vue";
-import { BreadcrumbTranslations } from "@xihan-ui/headless";
-import { Direction, Size, Tone } from "@xihan-ui/kernel";
+import { PropType, VNode } from "vue";
+import { Direction, Size, Tone } from "@xihan-ui/core";
+import { BreadcrumbNode, BreadcrumbTranslations } from "@xihan-ui/headless";
 //#region src/components/breadcrumb/breadcrumb.d.ts
 /** 根节点渲染为 nav 地标 */
 declare const XhBreadcrumbRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  collection: {
+    type: PropType<readonly BreadcrumbNode[]>;
+  };
+  maxItems: {
+    type: NumberConstructor;
+  };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   translations: {
     type: PropType<Partial<BreadcrumbTranslations>>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  collection: {
+    type: PropType<readonly BreadcrumbNode[]>;
+  };
+  maxItems: {
+    type: NumberConstructor;
+  };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   translations: {
     type: PropType<Partial<BreadcrumbTranslations>>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
-}>> & Readonly<{}>, {
-  dir: Direction;
-  tone: Tone;
-  size: Size;
-  translations: Partial<BreadcrumbTranslations>;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhBreadcrumbList: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhBreadcrumbList: 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 XhBreadcrumbItem: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhBreadcrumbItem: 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>;
-/** href 由作者写，这里只补当前页标记与点击守卫；当前页同样渲染为 `<a>`。 */
+/**
+ * href 由作者写，这里只补当前页标记与点击守卫；当前页同样渲染为 `<a>`。
+ * value 是链接身份，按压通道按它记住正被按住的那一条；未声明时派生一个实例内稳定的键。
+ */
 declare const XhBreadcrumbLink: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  value: {
+    type: StringConstructor;
+  };
   current: BooleanConstructor;
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  value: {
+    type: StringConstructor;
+  };
   current: BooleanConstructor;
 }>> & Readonly<{}>, {
   current: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhBreadcrumbSeparator: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+/** 链接中的图标位，与文字并排；纯装饰 */
+declare const XhBreadcrumbLinkIcon: 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 XhBreadcrumbSeparator: 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 XhBreadcrumbEllipsis: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhBreadcrumbEllipsis: 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 { XhBreadcrumbEllipsis, XhBreadcrumbItem, XhBreadcrumbLink, XhBreadcrumbList, XhBreadcrumbRoot, XhBreadcrumbSeparator };
+export { XhBreadcrumbEllipsis, XhBreadcrumbItem, XhBreadcrumbLink, XhBreadcrumbLinkIcon, XhBreadcrumbList, XhBreadcrumbRoot, XhBreadcrumbSeparator };
 //# sourceMappingURL=breadcrumb.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"breadcrumb.d.ts","names":[],"sources":["../../../src/components/breadcrumb/breadcrumb.ts"],"mappings":";;;;;cASa,gCAAgB,8BAAA;;IAIF,MAAA,SAAS;;;;IACA,MAAA,SAAS,QAAQ;;;;IACzB,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;IAHV,MAAA,SAAS;;;;IACA,MAAA,SAAS,QAAQ;;;;IACzB,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;qCAOnC;cAGW,gCAAgB,wCAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,wCAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,gCAAgB,8BAAA;;;;;;;;qCAa3B;cAGW,qCAAqB,wCAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,wCAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"breadcrumb.d.ts","names":[],"sources":["../../../src/components/breadcrumb/breadcrumb.ts"],"mappings":";;;;;cAgBa,gCAAgB,8BAAA;;IAII,MAAA,kBAAkB;;;;;;IAExB,MAAA,SAAS;;;IACA,MAAA,SAAS,QAAQ;;;IACzB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;IALJ,MAAA,kBAAkB;;;;;;IAExB,MAAA,SAAS;;;IACA,MAAA,SAAS,QAAQ;;;IACzB,MAAA,SAAS;;;IACT,MAAA,SAAS;;MAenC,oDAAA;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;cAMW,gCAAgB,8BAAA;;;;;;;;;;;;;;qCAe3B;;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/breadcrumb/breadcrumb.js

@@ -1,33 +1,23 @@
 import { withXhConfig } from "../../config/config.js";
 import { provideBreadcrumb, useBreadcrumbContext } from "./context.js";
 import { useBreadcrumb } from "./use-breadcrumb.js";
-import { defineComponent, h } from "vue";
+import { defineComponent, h, useId } from "vue";
 //#region src/components/breadcrumb/breadcrumb.ts
 /** 根节点渲染为 nav 地标 */
 const XhBreadcrumbRoot = defineComponent({
 	name: "XhBreadcrumbRoot",
 	props: {
-		dir: {
-			type: String,
-			default: void 0
-		},
-		translations: {
-			type: Object,
-			default: void 0
-		},
-		tone: {
-			type: String,
-			default: void 0
-		},
-		size: {
-			type: String,
-			default: void 0
-		}
+		collection: { type: Array },
+		maxItems: { type: Number },
+		dir: { type: String },
+		translations: { type: Object },
+		tone: { type: String },
+		size: { type: String }
 	},
 	setup(props, { slots }) {
 		const ctx = useBreadcrumb(withXhConfig("breadcrumb", props));
 		provideBreadcrumb(ctx);
-		return () => h("nav", ctx.api.value.getRootProps(), slots.default?.());
+		return () => h("nav", ctx.api.value.getRootProps(), slots.default ? slots.default() : props.collection ? renderDefaultTree(ctx.api.value.items, slots.separator, slots.ellipsis) : []);
 	}
 });
 const XhBreadcrumbList = defineComponent({
@@ -44,13 +34,31 @@ const XhBreadcrumbItem = defineComponent({
 		return () => h("li", ctx.api.value.getItemProps(), slots.default?.());
 	}
 });
-/** href 由作者写，这里只补当前页标记与点击守卫；当前页同样渲染为 `<a>`。 */
+/**
+* href 由作者写，这里只补当前页标记与点击守卫；当前页同样渲染为 `<a>`。
+* value 是链接身份，按压通道按它记住正被按住的那一条；未声明时派生一个实例内稳定的键。
+*/
 const XhBreadcrumbLink = defineComponent({
 	name: "XhBreadcrumbLink",
-	props: { current: Boolean },
+	props: {
+		value: { type: String },
+		current: Boolean
+	},
 	setup(props, { slots }) {
 		const ctx = useBreadcrumbContext();
-		return () => h("a", ctx.api.value.getLinkProps({ current: props.current }), slots.default?.());
+		const fallbackValue = useId();
+		return () => h("a", ctx.api.value.getLinkProps({
+			value: props.value ?? fallbackValue,
+			current: props.current
+		}), slots.default?.());
+	}
+});
+/** 链接中的图标位，与文字并排；纯装饰 */
+const XhBreadcrumbLinkIcon = defineComponent({
+	name: "XhBreadcrumbLinkIcon",
+	setup(_, { slots }) {
+		const ctx = useBreadcrumbContext();
+		return () => h("span", ctx.api.value.getLinkIconProps(), slots.default?.());
 	}
 });
 const XhBreadcrumbSeparator = defineComponent({
@@ -67,7 +75,33 @@ const XhBreadcrumbEllipsis = defineComponent({
 		return () => h("li", ctx.api.value.getEllipsisProps(), slots.default?.());
 	}
 });
+/**
+* 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
+* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
+* 分隔符与省略位的内容默认是文字，写同名插槽即由作者接管。
+*/
+function renderDefaultTree(items, separatorSlot, ellipsisSlot) {
+	return [h(XhBreadcrumbList, null, () => renderItems(items, separatorSlot, ellipsisSlot))];
+}
+/** ol 中的序列：层与层之间铺分隔符，被折叠的一段铺为一个省略位。 */
+function renderItems(items, separatorSlot, ellipsisSlot) {
+	const out = [];
+	items.forEach((item, index) => {
+		if (index > 0) out.push(h(XhBreadcrumbSeparator, { key: `sep-${index}` }, () => separatorSlot?.()));
+		if (item.type === "ellipsis") {
+			out.push(h(XhBreadcrumbEllipsis, { key: "ellipsis" }, () => ellipsisSlot?.(item.nodes) ?? "…"));
+			return;
+		}
+		const node = item.node;
+		out.push(h(XhBreadcrumbItem, { key: node.value }, () => [h(XhBreadcrumbLink, {
+			value: node.value,
+			current: node.current,
+			href: node.href
+		}, () => [node.icon ? h(XhBreadcrumbLinkIcon, null, () => node.icon) : null, node.label])]));
+	});
+	return out;
+}
 //#endregion
-export { XhBreadcrumbEllipsis, XhBreadcrumbItem, XhBreadcrumbLink, XhBreadcrumbList, XhBreadcrumbRoot, XhBreadcrumbSeparator };
+export { XhBreadcrumbEllipsis, XhBreadcrumbItem, XhBreadcrumbLink, XhBreadcrumbLinkIcon, XhBreadcrumbList, XhBreadcrumbRoot, XhBreadcrumbSeparator };
 
 //# sourceMappingURL=breadcrumb.js.map

package/dist/components/breadcrumb/breadcrumb.js.map

@@ -1 +1 @@
-{"version":3,"file":"breadcrumb.js","names":[],"sources":["../../../src/components/breadcrumb/breadcrumb.ts"],"sourcesContent":["import type { BreadcrumbProps, BreadcrumbTranslations } from '@xihan-ui/headless'\nimport type { Direction, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideBreadcrumb, useBreadcrumbContext } from './context'\nimport { useBreadcrumb } from './use-breadcrumb'\n\n/** 根节点渲染为 nav 地标 */\nexport const XhBreadcrumbRoot = defineComponent({\n  name: 'XhBreadcrumbRoot',\n  // 缺省值由 connect 给出，这里一律 default: undefined\n  props: {\n    dir: { type: String as PropType<Direction>, default: undefined },\n    translations: { type: Object as PropType<Partial<BreadcrumbTranslations>>, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useBreadcrumb(withXhConfig('breadcrumb', props) as BreadcrumbProps)\n    provideBreadcrumb(ctx)\n    return () => h('nav', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 渲染为 ol，把层级路径表达成有序列表\nexport const XhBreadcrumbList = defineComponent({\n  name: 'XhBreadcrumbList',\n  setup(_, { slots }) {\n    const ctx = useBreadcrumbContext()\n    return () => h('ol', ctx.api.value.getListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhBreadcrumbItem = defineComponent({\n  name: 'XhBreadcrumbItem',\n  setup(_, { slots }) {\n    const ctx = useBreadcrumbContext()\n    return () => h('li', ctx.api.value.getItemProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** href 由作者写，这里只补当前页标记与点击守卫；当前页同样渲染为 `<a>`。 */\nexport const XhBreadcrumbLink = defineComponent({\n  name: 'XhBreadcrumbLink',\n  props: {\n    current: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = useBreadcrumbContext()\n    return () => h(\n      'a',\n      ctx.api.value.getLinkProps({ current: props.current }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\n// 分隔符与省略号同为 ol 的直接子节点，渲染为 li 并对读屏隐藏\nexport const XhBreadcrumbSeparator = defineComponent({\n  name: 'XhBreadcrumbSeparator',\n  setup(_, { slots }) {\n    const ctx = useBreadcrumbContext()\n    return () => h('li', ctx.api.value.getSeparatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhBreadcrumbEllipsis = defineComponent({\n  name: 'XhBreadcrumbEllipsis',\n  setup(_, { slots }) {\n    const ctx = useBreadcrumbContext()\n    return () => h('li', ctx.api.value.getEllipsisProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AASA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CAEN,OAAO;EACL,KAAK;GAAE,MAAM;GAA+B,SAAS,KAAA;EAAU;EAC/D,cAAc;GAAE,MAAM;GAAqD,SAAS,KAAA;EAAU;EAC9F,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;EAC3D,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;CAC7D;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,cAAc,aAAa,cAAc,KAAK,CAAoB;EAC9E,kBAAkB,GAAG;EACrB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;AAGD,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;;AAGD,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO,EACL,SAAS,QACX;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EACX,KACA,IAAI,IAAI,MAAM,aAAa,EAAE,SAAS,MAAM,QAAQ,CAAC,GACrD,MAAM,UAAU,CAClB;CACF;AACF,CAAC;AAGD,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,iBAAiB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC"}
+{"version":3,"file":"breadcrumb.js","names":[],"sources":["../../../src/components/breadcrumb/breadcrumb.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// 提供 breadcrumb 相关实现。\n\nimport type { Direction, Size, Tone } from '@xihan-ui/core'\nimport type { BreadcrumbItem, BreadcrumbNode, BreadcrumbNodeMeta, BreadcrumbProps, BreadcrumbTranslations } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport { defineComponent, h, useId } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideBreadcrumb, useBreadcrumbContext } from './context'\nimport { useBreadcrumb } from './use-breadcrumb'\n\n/** 根节点渲染为 nav 地标 */\nexport const XhBreadcrumbRoot = defineComponent({\n  name: 'XhBreadcrumbRoot',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<readonly BreadcrumbNode[]> },\n    maxItems: { type: Number },\n    dir: { type: String as PropType<Direction> },\n    translations: { type: Object as PropType<Partial<BreadcrumbTranslations>> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  setup(props, { slots }) {\n    const ctx = useBreadcrumb(withXhConfig('breadcrumb', props) as BreadcrumbProps)\n    provideBreadcrumb(ctx)\n    return () => h(\n      'nav',\n      ctx.api.value.getRootProps() as Record<string, unknown>,\n      slots.default\n        ? slots.default()\n        : props.collection\n          ? renderDefaultTree(ctx.api.value.items, slots.separator, slots.ellipsis)\n          : [],\n    )\n  },\n})\n\n// 渲染为 ol，把层级路径表达成有序列表\nexport const XhBreadcrumbList = defineComponent({\n  name: 'XhBreadcrumbList',\n  setup(_, { slots }) {\n    const ctx = useBreadcrumbContext()\n    return () => h('ol', ctx.api.value.getListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhBreadcrumbItem = defineComponent({\n  name: 'XhBreadcrumbItem',\n  setup(_, { slots }) {\n    const ctx = useBreadcrumbContext()\n    return () => h('li', ctx.api.value.getItemProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * href 由作者写，这里只补当前页标记与点击守卫；当前页同样渲染为 `<a>`。\n * value 是链接身份，按压通道按它记住正被按住的那一条；未声明时派生一个实例内稳定的键。\n */\nexport const XhBreadcrumbLink = defineComponent({\n  name: 'XhBreadcrumbLink',\n  props: {\n    value: { type: String },\n    current: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = useBreadcrumbContext()\n    const fallbackValue = useId()\n    return () => h(\n      'a',\n      ctx.api.value.getLinkProps({ value: props.value ?? fallbackValue, current: props.current }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\n/** 链接中的图标位，与文字并排；纯装饰 */\nexport const XhBreadcrumbLinkIcon = defineComponent({\n  name: 'XhBreadcrumbLinkIcon',\n  setup(_, { slots }) {\n    const ctx = useBreadcrumbContext()\n    return () => h('span', ctx.api.value.getLinkIconProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 分隔符与省略号同为 ol 的直接子节点，渲染为 li 并对读屏隐藏\nexport const XhBreadcrumbSeparator = defineComponent({\n  name: 'XhBreadcrumbSeparator',\n  setup(_, { slots }) {\n    const ctx = useBreadcrumbContext()\n    return () => h('li', ctx.api.value.getSeparatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhBreadcrumbEllipsis = defineComponent({\n  name: 'XhBreadcrumbEllipsis',\n  setup(_, { slots }) {\n    const ctx = useBreadcrumbContext()\n    return () => h('li', ctx.api.value.getEllipsisProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * 分隔符与省略位的内容默认是文字，写同名插槽即由作者接管。\n */\nfunction renderDefaultTree(\n  items: readonly BreadcrumbItem[],\n  separatorSlot?: () => VNode[],\n  ellipsisSlot?: (nodes: readonly BreadcrumbNodeMeta[]) => VNode[],\n): VNode[] {\n  return [h(XhBreadcrumbList, null, () => renderItems(items, separatorSlot, ellipsisSlot))]\n}\n\n/** ol 中的序列：层与层之间铺分隔符，被折叠的一段铺为一个省略位。 */\nfunction renderItems(\n  items: readonly BreadcrumbItem[],\n  separatorSlot?: () => VNode[],\n  ellipsisSlot?: (nodes: readonly BreadcrumbNodeMeta[]) => VNode[],\n): VNode[] {\n  const out: VNode[] = []\n  items.forEach((item, index) => {\n    if (index > 0)\n      out.push(h(XhBreadcrumbSeparator, { key: `sep-${index}` }, () => separatorSlot?.()))\n    if (item.type === 'ellipsis') {\n      out.push(h(XhBreadcrumbEllipsis, { key: 'ellipsis' }, () => ellipsisSlot?.(item.nodes) ?? '…'))\n      return\n    }\n    const node = item.node\n    out.push(h(XhBreadcrumbItem, { key: node.value }, () => [\n      h(\n        XhBreadcrumbLink,\n        { value: node.value, current: node.current, href: node.href },\n        () => [\n          node.icon ? h(XhBreadcrumbLinkIcon, null, () => node.icon) : null,\n          node.label,\n        ],\n      ),\n    ]))\n  })\n  return out\n}\n"],"mappings":";;;;;;AAgBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CAEN,OAAO;EACL,YAAY,EAAE,MAAM,MAA6C;EACjE,UAAU,EAAE,MAAM,OAAO;EACzB,KAAK,EAAE,MAAM,OAA8B;EAC3C,cAAc,EAAE,MAAM,OAAoD;EAC1E,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;CACzC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,cAAc,aAAa,cAAc,KAAK,CAAoB;EAC9E,kBAAkB,GAAG;EACrB,aAAa,EACX,OACA,IAAI,IAAI,MAAM,aAAa,GAC3B,MAAM,UACF,MAAM,QAAQ,IACd,MAAM,aACJ,kBAAkB,IAAI,IAAI,MAAM,OAAO,MAAM,WAAW,MAAM,QAAQ,IACtE,CAAC,CACT;CACF;AACF,CAAC;AAGD,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;;;;;AAMD,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;EACL,OAAO,EAAE,MAAM,OAAO;EACtB,SAAS;CACX;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,qBAAqB;EACjC,MAAM,gBAAgB,MAAM;EAC5B,aAAa,EACX,KACA,IAAI,IAAI,MAAM,aAAa;GAAE,OAAO,MAAM,SAAS;GAAe,SAAS,MAAM;EAAQ,CAAC,GAC1F,MAAM,UAAU,CAClB;CACF;AACF,CAAC;;AAGD,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,iBAAiB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAGD,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,iBAAiB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;;;;;;AAOD,SAAS,kBACP,OACA,eACA,cACS;CACT,OAAO,CAAC,EAAE,kBAAkB,YAAY,YAAY,OAAO,eAAe,YAAY,CAAC,CAAC;AAC1F;;AAGA,SAAS,YACP,OACA,eACA,cACS;CACT,MAAM,MAAe,CAAC;CACtB,MAAM,SAAS,MAAM,UAAU;EAC7B,IAAI,QAAQ,GACV,IAAI,KAAK,EAAE,uBAAuB,EAAE,KAAK,OAAO,QAAQ,SAAS,gBAAgB,CAAC,CAAC;EACrF,IAAI,KAAK,SAAS,YAAY;GAC5B,IAAI,KAAK,EAAE,sBAAsB,EAAE,KAAK,WAAW,SAAS,eAAe,KAAK,KAAK,KAAK,GAAG,CAAC;GAC9F;EACF;EACA,MAAM,OAAO,KAAK;EAClB,IAAI,KAAK,EAAE,kBAAkB,EAAE,KAAK,KAAK,MAAM,SAAS,CACtD,EACE,kBACA;GAAE,OAAO,KAAK;GAAO,SAAS,KAAK;GAAS,MAAM,KAAK;EAAK,SACtD,CACJ,KAAK,OAAO,EAAE,sBAAsB,YAAY,KAAK,IAAI,IAAI,MAC7D,KAAK,KACP,CACF,CACF,CAAC,CAAC;CACJ,CAAC;CACD,OAAO;AACT"}

package/dist/components/breadcrumb/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/breadcrumb/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { BreadcrumbContext } from './use-breadcrumb'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<BreadcrumbContext> = Symbol.for('xh-breadcrumb')\n\nexport function provideBreadcrumb(ctx: BreadcrumbContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useBreadcrumbContext(): BreadcrumbContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Breadcrumb 部件必须用在 XhBreadcrumbRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAuC,OAAO,IAAI,eAAe;AAEvE,SAAgB,kBAAkB,KAA8B;CAC9D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,uBAA0C;CACxD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,2CAA2C;CAC7D,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/breadcrumb/context.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// 提供 context 相关实现。\n\nimport type { InjectionKey } from 'vue'\nimport type { BreadcrumbContext } from './use-breadcrumb'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<BreadcrumbContext> = Symbol.for('xh-breadcrumb')\n\nexport function provideBreadcrumb(ctx: BreadcrumbContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useBreadcrumbContext(): BreadcrumbContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Breadcrumb 部件必须用在 XhBreadcrumbRoot 内')\n  return ctx\n}\n"],"mappings":";;AAWA,MAAM,MAAuC,OAAO,IAAI,eAAe;AAEvE,SAAgB,kBAAkB,KAA8B;CAC9D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,uBAA0C;CACxD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,2CAA2C;CAC7D,OAAO;AACT"}

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

@@ -1,10 +1,12 @@
 import { ComputedRef } from "vue";
-import { BreadcrumbApi, BreadcrumbProps } from "@xihan-ui/headless";
+import { Service } from "@xihan-ui/core";
+import { BreadcrumbApi, BreadcrumbSchema } from "@xihan-ui/headless";
 //#region src/components/breadcrumb/use-breadcrumb.d.ts
 interface BreadcrumbContext {
   api: ComputedRef<BreadcrumbApi>;
+  service: Service<BreadcrumbSchema>;
 }
-declare function useBreadcrumb(props: BreadcrumbProps): BreadcrumbContext;
+declare function useBreadcrumb(props: BreadcrumbSchema['props']): BreadcrumbContext;
 //#endregion
 export { BreadcrumbContext, useBreadcrumb };
 //# sourceMappingURL=use-breadcrumb.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-breadcrumb.d.ts","names":[],"sources":["../../../src/components/breadcrumb/use-breadcrumb.ts"],"mappings":";;;UAMiB;EACf,KAAK,YAAY;;iBAIH,cAAc,OAAO,kBAAkB"}
+{"version":3,"file":"use-breadcrumb.d.ts","names":[],"sources":["../../../src/components/breadcrumb/use-breadcrumb.ts"],"mappings":";;;;UAeiB;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;iBAIH,cAAc,OAAO,4BAA4B"}

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

@@ -1,9 +1,14 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
+import { useMachine } from "../../runtime/use-machine.js";
 import { computed } from "vue";
-import { connectBreadcrumb } from "@xihan-ui/headless";
+import { breadcrumbMachine, connectBreadcrumb } from "@xihan-ui/headless";
 //#region src/components/breadcrumb/use-breadcrumb.ts
 function useBreadcrumb(props) {
-	return { api: computed(() => connectBreadcrumb(props, vueNormalize)) };
+	const service = useMachine(breadcrumbMachine, () => ({ ...props }));
+	return {
+		api: computed(() => connectBreadcrumb(service, vueNormalize)),
+		service
+	};
 }
 //#endregion
 export { useBreadcrumb };

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

@@ -1 +1 @@
-{"version":3,"file":"use-breadcrumb.js","names":[],"sources":["../../../src/components/breadcrumb/use-breadcrumb.ts"],"sourcesContent":["import type { BreadcrumbApi, BreadcrumbProps } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectBreadcrumb } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\n\nexport interface BreadcrumbContext {\n  api: ComputedRef<BreadcrumbApi>\n}\n\n// Breadcrumb 无状态机也不派生 part id，props 变了由 computed 重算属性\nexport function useBreadcrumb(props: BreadcrumbProps): BreadcrumbContext {\n  const api = computed(() => connectBreadcrumb(props, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;AAWA,SAAgB,cAAc,OAA2C;CAEvE,OAAO,EAAE,KADG,eAAe,kBAAkB,OAAO,YAAY,CACrD,EAAE;AACf"}
+{"version":3,"file":"use-breadcrumb.js","names":[],"sources":["../../../src/components/breadcrumb/use-breadcrumb.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 breadcrumb 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { BreadcrumbApi, BreadcrumbSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { breadcrumbMachine, connectBreadcrumb } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface BreadcrumbContext {\n  api: ComputedRef<BreadcrumbApi>\n  service: Service<BreadcrumbSchema>\n}\n\n// Breadcrumb 不派生 part id，故不另建 scope；机器只承载按压通道，属性仍随 props 由 computed 重算\nexport function useBreadcrumb(props: BreadcrumbSchema['props']): BreadcrumbContext {\n  const service = useMachine(breadcrumbMachine, () => ({ ...props }))\n  const api = computed(() => connectBreadcrumb(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;AAqBA,SAAgB,cAAc,OAAqD;CACjF,MAAM,UAAU,WAAW,0BAA0B,EAAE,GAAG,MAAM,EAAE;CAElE,OAAO;EAAE,KADG,eAAe,kBAAkB,SAAS,YAAY,CACvD;EAAG;CAAQ;AACxB"}

package/dist/components/button-group/button-group.d.ts

@@ -1,47 +1,62 @@
-import { PropType } from "vue";
-import { ActionVariant, Size, Tone } from "@xihan-ui/kernel";
+import { PropType, VNode } from "vue";
+import { ActionVariant, Size, Tone } from "@xihan-ui/core";
 //#region src/components/button-group/button-group.d.ts
 declare const XhButtonGroup: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   orientation: {
     type: PropType<"horizontal" | "vertical">;
-    default: undefined;
   };
   variant: {
     type: PropType<ActionVariant>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
+  };
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  fullWidth: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  separators: {
+    type: BooleanConstructor;
     default: undefined;
   };
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   orientation: {
     type: PropType<"horizontal" | "vertical">;
-    default: undefined;
   };
   variant: {
     type: PropType<ActionVariant>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
+  };
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  fullWidth: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  separators: {
+    type: BooleanConstructor;
     default: undefined;
   };
 }>> & Readonly<{}>, {
-  orientation: "horizontal" | "vertical";
-  tone: Tone;
-  size: Size;
-  variant: ActionVariant;
+  disabled: boolean;
+  fullWidth: boolean;
+  separators: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
 export { XhButtonGroup };

package/dist/components/button-group/button-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button-group.d.ts","names":[],"sources":["../../../src/components/button-group/button-group.ts"],"mappings":";;;cAQa,6BAAa,8BAAA;;IAIS,MAAA;;;;IACJ,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;IAHF,MAAA;;;;IACJ,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;qCAUnC"}
+{"version":3,"file":"button-group.d.ts","names":[],"sources":["../../../src/components/button-group/button-group.ts"],"mappings":";;;cAgDa,6BAAa,8BAAA;;IAIS,MAAA;;;IACJ,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;IAHF,MAAA;;;IACJ,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;qCAuBnC"}

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

@@ -1,30 +1,62 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { withXhConfig } from "../../config/config.js";
-import { defineComponent, h } from "vue";
+import { provideButtonGroupContext } from "./context.js";
+import { Comment, Fragment, Text, computed, defineComponent, h } from "vue";
 import { connectButtonGroup } from "@xihan-ui/headless";
 //#region src/components/button-group/button-group.ts
+function flattenChildren(children) {
+	const result = [];
+	for (const child of children) {
+		if (child.type === Comment || child.type === Text) continue;
+		if (child.type === Fragment && Array.isArray(child.children)) {
+			result.push(...flattenChildren(child.children.filter((value) => typeof value === "object")));
+			continue;
+		}
+		result.push(child);
+	}
+	return result;
+}
+function renderChildren(children, api) {
+	const nodes = flattenChildren(children);
+	if (!api.separators) return nodes;
+	return nodes.flatMap((node, index) => index === 0 ? [node] : [h("span", {
+		"key": `separator-${index}`,
+		"aria-hidden": true,
+		"data-xh-button-group-separator": "",
+		"data-orientation": api.orientation === "horizontal" ? "vertical" : "horizontal",
+		"data-disabled": api.disabled ? "" : void 0
+	}), node]);
+}
 const XhButtonGroup = defineComponent({
 	name: "XhButtonGroup",
 	props: {
-		orientation: {
-			type: String,
-			default: void 0
-		},
-		variant: {
-			type: String,
+		orientation: { type: String },
+		variant: { type: String },
+		tone: { type: String },
+		size: { type: String },
+		disabled: {
+			type: Boolean,
 			default: void 0
 		},
-		tone: {
-			type: String,
+		fullWidth: {
+			type: Boolean,
 			default: void 0
 		},
-		size: {
-			type: String,
+		separators: {
+			type: Boolean,
 			default: void 0
 		}
 	},
 	setup(props, { slots }) {
-		return () => h("div", connectButtonGroup(withXhConfig("button-group", props), vueNormalize).getRootProps(), slots.default?.());
+		const configured = withXhConfig("button-group", props);
+		const api = computed(() => connectButtonGroup(configured, vueNormalize));
+		provideButtonGroupContext(computed(() => ({
+			disabled: api.value.disabled,
+			variant: api.value.variant,
+			tone: api.value.tone,
+			size: api.value.size
+		})));
+		return () => h("div", api.value.getRootProps(), renderChildren(slots.default?.() ?? [], api.value));
 	}
 });
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"button-group.js","names":[],"sources":["../../../src/components/button-group/button-group.ts"],"sourcesContent":["import type { ButtonGroupProps } from '@xihan-ui/headless'\nimport type { ActionVariant, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType } from 'vue'\nimport { connectButtonGroup } from '@xihan-ui/headless'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\n\nexport const XhButtonGroup = defineComponent({\n  name: 'XhButtonGroup',\n  // 有 connect 兜底的 prop 一律 default: undefined\n  props: {\n    orientation: { type: String as PropType<'horizontal' | 'vertical'>, default: undefined },\n    variant: { type: String as PropType<ActionVariant>, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  setup(props, { slots }) {\n    // 组内每一段是作者放进插槽的按钮，直接当直接子节点摆\n    return () => h(\n      'div',\n      connectButtonGroup(withXhConfig('button-group', props) as ButtonGroupProps, vueNormalize).getRootProps() as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":";;;;;AAQA,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CAEN,OAAO;EACL,aAAa;GAAE,MAAM;GAA+C,SAAS,KAAA;EAAU;EACvF,SAAS;GAAE,MAAM;GAAmC,SAAS,KAAA;EAAU;EACvE,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;EAC3D,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;CAC7D;CACA,MAAM,OAAO,EAAE,SAAS;EAEtB,aAAa,EACX,OACA,mBAAmB,aAAa,gBAAgB,KAAK,GAAuB,YAAY,CAAC,CAAC,aAAa,GACvG,MAAM,UAAU,CAClB;CACF;AACF,CAAC"}
+{"version":3,"file":"button-group.js","names":[],"sources":["../../../src/components/button-group/button-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// 提供 button group 相关实现。\n\nimport type { ActionVariant, Size, Tone } from '@xihan-ui/core'\nimport type { ButtonGroupProps } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport { connectButtonGroup } from '@xihan-ui/headless'\nimport { Comment, computed, defineComponent, Fragment, h, Text } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideButtonGroupContext } from './context'\n\n/** 从实际调用推导 api 形状，避免再写一遍 normalize 的类型参数。 */\ntype VueButtonGroupApi = ReturnType<typeof connectButtonGroup>\n\nfunction flattenChildren(children: readonly VNode[]): VNode[] {\n  const result: VNode[] = []\n  for (const child of children) {\n    if (child.type === Comment || child.type === Text)\n      continue\n    if (child.type === Fragment && Array.isArray(child.children)) {\n      result.push(...flattenChildren(child.children.filter(value => typeof value === 'object') as VNode[]))\n      continue\n    }\n    result.push(child)\n  }\n  return result\n}\n\nfunction renderChildren(children: readonly VNode[], api: VueButtonGroupApi): VNode[] {\n  const nodes = flattenChildren(children)\n  if (!api.separators)\n    return nodes\n  return nodes.flatMap((node, index) => index === 0\n    ? [node]\n    : [h('span', {\n        'key': `separator-${index}`,\n        'aria-hidden': true,\n        'data-xh-button-group-separator': '',\n        'data-orientation': api.orientation === 'horizontal' ? 'vertical' : 'horizontal',\n        'data-disabled': api.disabled ? '' : undefined,\n      }), node])\n}\n\nexport const XhButtonGroup = defineComponent({\n  name: 'XhButtonGroup',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    orientation: { type: String as PropType<'horizontal' | 'vertical'> },\n    variant: { type: String as PropType<ActionVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    disabled: { type: Boolean, default: undefined },\n    fullWidth: { type: Boolean, default: undefined },\n    separators: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const configured = withXhConfig('button-group', props) as ButtonGroupProps\n    const api = computed<VueButtonGroupApi>(() => connectButtonGroup(configured, vueNormalize))\n    // 组内每一段收到的是真禁用：只打 data-* 的话按钮照样点得动。\n    // 组的 variant / tone / size 走同一条路下发，段自己写了的优先；段因此自带形态矩阵属性\n    provideButtonGroupContext(computed(() => ({\n      disabled: api.value.disabled,\n      variant: api.value.variant,\n      tone: api.value.tone,\n      size: api.value.size,\n    })))\n    // 组内每一段是作者放进插槽的按钮，直接当直接子节点摆\n    return () => h(\n      'div',\n      api.value.getRootProps() as Record<string, unknown>,\n      renderChildren(slots.default?.() ?? [], api.value),\n    )\n  },\n})\n"],"mappings":";;;;;;AAmBA,SAAS,gBAAgB,UAAqC;CAC5D,MAAM,SAAkB,CAAC;CACzB,KAAK,MAAM,SAAS,UAAU;EAC5B,IAAI,MAAM,SAAS,WAAW,MAAM,SAAS,MAC3C;EACF,IAAI,MAAM,SAAS,YAAY,MAAM,QAAQ,MAAM,QAAQ,GAAG;GAC5D,OAAO,KAAK,GAAG,gBAAgB,MAAM,SAAS,QAAO,UAAS,OAAO,UAAU,QAAQ,CAAY,CAAC;GACpG;EACF;EACA,OAAO,KAAK,KAAK;CACnB;CACA,OAAO;AACT;AAEA,SAAS,eAAe,UAA4B,KAAiC;CACnF,MAAM,QAAQ,gBAAgB,QAAQ;CACtC,IAAI,CAAC,IAAI,YACP,OAAO;CACT,OAAO,MAAM,SAAS,MAAM,UAAU,UAAU,IAC5C,CAAC,IAAI,IACL,CAAC,EAAE,QAAQ;EACT,OAAO,aAAa;EACpB,eAAe;EACf,kCAAkC;EAClC,oBAAoB,IAAI,gBAAgB,eAAe,aAAa;EACpE,iBAAiB,IAAI,WAAW,KAAK,KAAA;CACvC,CAAC,GAAG,IAAI,CAAC;AACf;AAEA,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CAEN,OAAO;EACL,aAAa,EAAE,MAAM,OAA8C;EACnE,SAAS,EAAE,MAAM,OAAkC;EACnD,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;EACvC,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,WAAW;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC/C,YAAY;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;CAClD;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,aAAa,aAAa,gBAAgB,KAAK;EACrD,MAAM,MAAM,eAAkC,mBAAmB,YAAY,YAAY,CAAC;EAG1F,0BAA0B,gBAAgB;GACxC,UAAU,IAAI,MAAM;GACpB,SAAS,IAAI,MAAM;GACnB,MAAM,IAAI,MAAM;GAChB,MAAM,IAAI,MAAM;EAClB,EAAE,CAAC;EAEH,aAAa,EACX,OACA,IAAI,MAAM,aAAa,GACvB,eAAe,MAAM,UAAU,KAAK,CAAC,GAAG,IAAI,KAAK,CACnD;CACF;AACF,CAAC"}

package/dist/components/button-group/context.js

@@ -0,0 +1,15 @@
+import { inject, provide } from "vue";
+//#region src/components/button-group/context.ts
+const CONTEXT_KEY = Symbol.for("xh-button-group");
+/** 把整组的禁用与三轴放进子树，组内的按钮据此把自己也禁用、并补上未自写的 variant / tone / size。 */
+function provideButtonGroupContext(context) {
+	provide(CONTEXT_KEY, context);
+}
+/** 读取外层按钮组下发的值；不在组内时为 null。 */
+function useButtonGroupContext() {
+	return inject(CONTEXT_KEY, null);
+}
+//#endregion
+export { provideButtonGroupContext, useButtonGroupContext };
+
+//# sourceMappingURL=context.js.map

package/dist/components/button-group/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/button-group/context.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// 提供 context 相关实现。\n\nimport type { ActionVariant, Size, Tone } from '@xihan-ui/core'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport { inject, provide } from 'vue'\n\n/** 整组下发给每一段的值：禁用与三个视觉轴，段自己写了的优先。 */\nexport interface ButtonGroupContext {\n  disabled: boolean\n  variant: ActionVariant\n  tone: Tone | undefined\n  size: Size | undefined\n}\n\nconst CONTEXT_KEY: InjectionKey<ComputedRef<ButtonGroupContext>> = Symbol.for('xh-button-group')\n\n/** 把整组的禁用与三轴放进子树，组内的按钮据此把自己也禁用、并补上未自写的 variant / tone / size。 */\nexport function provideButtonGroupContext(context: ComputedRef<ButtonGroupContext>): void {\n  provide(CONTEXT_KEY, context)\n}\n\n/** 读取外层按钮组下发的值；不在组内时为 null。 */\nexport function useButtonGroupContext(): ComputedRef<ButtonGroupContext> | null {\n  return inject(CONTEXT_KEY, null)\n}\n"],"mappings":";;AAmBA,MAAM,cAA6D,OAAO,IAAI,iBAAiB;;AAG/F,SAAgB,0BAA0B,SAAgD;CACxF,QAAQ,aAAa,OAAO;AAC9B;;AAGA,SAAgB,wBAAgE;CAC9E,OAAO,OAAO,aAAa,IAAI;AACjC"}