@xihan-ui/vue 1.0.0-alpha.2 → 1.0.0

package/dist/components/field/field.d.ts

@@ -13,6 +13,10 @@ declare const XhFieldRoot: import("vue").DefineComponent<import("vue").ExtractPr
     type: BooleanConstructor;
     default: undefined;
   };
+  readOnly: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   controlId: {
     type: StringConstructor;
     default: undefined;
@@ -32,6 +36,10 @@ declare const XhFieldRoot: import("vue").DefineComponent<import("vue").ExtractPr
     type: BooleanConstructor;
     default: undefined;
   };
+  readOnly: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   controlId: {
     type: StringConstructor;
     default: undefined;
@@ -40,6 +48,7 @@ declare const XhFieldRoot: import("vue").DefineComponent<import("vue").ExtractPr
   required: boolean;
   invalid: boolean;
   disabled: boolean;
+  readOnly: boolean;
   controlId: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhFieldLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
@@ -47,11 +56,35 @@ declare const XhFieldLabel: import("vue").DefineComponent<{}, () => VNode<import
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /** 默认插槽的载荷：控件节点该挂的那组属性，作者把它交给自己渲染的控件。 */
 type FieldControlSlotProps = Record<string, unknown>;
-declare const XhFieldControl: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhFieldControl: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /**
+   * 把接线属性合到唯一的子节点上，缺省开。
+   *
+   * 子节点是薄封装（根不是可聚焦元素）时关掉它：属性只经插槽载荷交出去，
+   * 由封装内部调 useFieldControl 绑到真控件上。
+   */
+  asChild: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }> | VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
-}>[], {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, SlotsType<{
+}>[], {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /**
+   * 把接线属性合到唯一的子节点上，缺省开。
+   *
+   * 子节点是薄封装（根不是可聚焦元素）时关掉它：属性只经插槽载荷交出去，
+   * 由封装内部调 useFieldControl 绑到真控件上。
+   */
+  asChild: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+}>> & Readonly<{}>, {
+  asChild: boolean;
+}, SlotsType<{
   default?: (props: FieldControlSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhFieldDescription: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {

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

@@ -1 +1 @@
-{"version":3,"file":"field.d.ts","names":[],"sources":["../../../src/components/field/field.ts"],"mappings":";;cAYa,2BAAW,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAgCtB;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;KAGU,wBAAwB;cAEvB,8BAAc,0BAAA,oBAAA,4BAAA;;;;;EAGb,WAAC,OAAO,0BAA0B;kCAa9C;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAe3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"field.d.ts","names":[],"sources":["../../../src/components/field/field.ts"],"mappings":";;cAaa,2BAAW,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAoCtB;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;KAGU,wBAAwB;cAYvB,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYb,WAAC,OAAO,0BAA0B;kCAiB9C;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAe3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/field/field.js

@@ -1,5 +1,6 @@
-import { useOptionalFormContext, useOptionalFormField } from "../form/context.js";
 import { provideField, useFieldContext } from "./context.js";
+import { carriesOwnAnatomy } from "../../runtime/as-child.js";
+import { useOptionalFormContext, useOptionalFormField } from "../form/context.js";
 import { useField } from "./use-field.js";
 import { Comment, Text, cloneVNode, defineComponent, h } from "vue";
 //#region src/components/field/field.ts
@@ -22,6 +23,10 @@ const XhFieldRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		readOnly: {
+			type: Boolean,
+			default: void 0
+		},
 		controlId: {
 			type: String,
 			default: void 0
@@ -40,6 +45,9 @@ const XhFieldRoot = defineComponent({
 			get disabled() {
 				return props.disabled ?? (form && handle ? form.api.value.disabled : void 0);
 			},
+			get readOnly() {
+				return props.readOnly ?? (form && handle ? form.api.value.readOnly : void 0);
+			},
 			get controlId() {
 				return props.controlId;
 			}
@@ -55,16 +63,35 @@ const XhFieldLabel = defineComponent({
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
+/** 去掉角色标记，只留接线属性（id 与 aria-*）。 */
+function wiringOnly(controlProps) {
+	const rest = {};
+	for (const [key, value] of Object.entries(controlProps)) if (key !== "data-scope" && key !== "data-part") rest[key] = value;
+	return rest;
+}
 const XhFieldControl = defineComponent({
 	name: "XhFieldControl",
+	props: { 
+	/**
+	* 把接线属性合到唯一的子节点上，缺省开。
+	*
+	* 子节点是薄封装（根不是可聚焦元素）时关掉它：属性只经插槽载荷交出去，
+	* 由封装内部调 useFieldControl 绑到真控件上。
+	*/
+asChild: {
+		type: Boolean,
+		default: true
+	} },
 	slots: Object,
-	setup(_, { slots }) {
+	setup(props, { slots }) {
 		const ctx = useFieldContext();
 		return () => {
 			const controlProps = ctx.api.value.getControlProps();
 			const children = slots.default?.(controlProps) ?? [];
 			const nodes = attributable(children);
-			return nodes.length === 1 ? cloneVNode(nodes[0], controlProps) : children;
+			if (!props.asChild || nodes.length !== 1) return children;
+			const node = nodes[0];
+			return cloneVNode(node, carriesOwnAnatomy(node) ? wiringOnly(controlProps) : controlProps);
 		};
 	}
 });
@@ -89,6 +116,6 @@ const XhFieldErrorText = defineComponent({
 	}
 });
 //#endregion
-export { XhFieldControl, XhFieldDescription, XhFieldErrorText, XhFieldLabel, XhFieldRoot };
+export { XhFieldControl, XhFieldDescription, XhFieldErrorText, XhFieldLabel, XhFieldRoot, wiringOnly };
 
 //# sourceMappingURL=field.js.map

package/dist/components/field/field.js.map

@@ -1 +1 @@
-{"version":3,"file":"field.js","names":[],"sources":["../../../src/components/field/field.ts"],"sourcesContent":["import type { FieldProps } from '@xihan-ui/headless'\nimport type { SlotsType, VNode } from 'vue'\nimport { cloneVNode, Comment, defineComponent, h, Text } from 'vue'\nimport { useOptionalFormContext, useOptionalFormField } from '../form/context'\nimport { provideField, useFieldContext } from './context'\nimport { useField } from './use-field'\n\n/** 滤掉注释与纯文本节点，只留能挂属性的节点。 */\nfunction attributable(nodes: readonly VNode[]): VNode[] {\n  return nodes.filter(node => node.type !== Comment && node.type !== Text)\n}\n\nexport const XhFieldRoot = defineComponent({\n  name: 'XhFieldRoot',\n  // 三个布尔缺省 undefined：在 XhFormFieldGroup 里没写就从表单上下文自取，写了以写的为准\n  props: {\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    // 控件节点的 id，不占用根节点自己的 DOM id\n    controlId: { type: String, default: undefined },\n  },\n  setup(props, { slots }) {\n    const form = useOptionalFormContext()\n    const handle = useOptionalFormField()\n    // getter 透传保住响应性：props 与表单 api 谁变都会带动 connect 重算\n    const merged: FieldProps = {\n      get invalid() {\n        return props.invalid ?? (form && handle ? form.api.value.isFieldInvalid(handle.name()) : undefined)\n      },\n      get required() {\n        return props.required ?? (form && handle ? form.api.value.isFieldRequired(handle.name()) : undefined)\n      },\n      get disabled() {\n        return props.disabled ?? (form && handle ? form.api.value.disabled : undefined)\n      },\n      get controlId() {\n        return props.controlId\n      },\n    }\n    const ctx = useField(merged)\n    provideField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldLabel = defineComponent({\n  name: 'XhFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 默认插槽的载荷：控件节点该挂的那组属性，作者把它交给自己渲染的控件。 */\nexport type FieldControlSlotProps = Record<string, unknown>\n\nexport const XhFieldControl = defineComponent({\n  name: 'XhFieldControl',\n  slots: Object as SlotsType<{\n    default?: (props: FieldControlSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    return () => {\n      const controlProps = ctx.api.value.getControlProps() as Record<string, unknown>\n      // control props 经 slot props 交给作者，控件节点由作者渲染\n      const children = slots.default?.(controlProps) ?? []\n      const nodes = attributable(children)\n      // 单个节点直接合并属性，多个节点视为作者已用 slot props 自行接线\n      return nodes.length === 1 ? cloneVNode(nodes[0]!, controlProps) : children\n    }\n  },\n})\n\nexport const XhFieldDescription = defineComponent({\n  name: 'XhFieldDescription',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldErrorText = defineComponent({\n  name: 'XhFieldErrorText',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    const form = useOptionalFormContext()\n    const handle = useOptionalFormField()\n    // 节点常挂，靠 hidden 显隐；插槽没给内容时在表单里自取该字段的错误文案\n    return () => {\n      const kids = slots.default?.()\n      const auto = (!kids || kids.length === 0) && form && handle\n        ? form.api.value.getFieldError(handle.name())\n        : undefined\n      return h('p', ctx.api.value.getErrorTextProps() as Record<string, unknown>, kids?.length ? kids : auto)\n    }\n  },\n})\n"],"mappings":";;;;;;AAQA,SAAS,aAAa,OAAkC;CACtD,OAAO,MAAM,QAAO,SAAQ,KAAK,SAAS,WAAW,KAAK,SAAS,IAAI;AACzE;AAEA,MAAa,cAAc,gBAAgB;CACzC,MAAM;CAEN,OAAO;EACL,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAE9C,WAAW;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;CAChD;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,OAAO,uBAAuB;EACpC,MAAM,SAAS,qBAAqB;EAgBpC,MAAM,MAAM,SAAS;GAbnB,IAAI,UAAU;IACZ,OAAO,MAAM,YAAY,QAAQ,SAAS,KAAK,IAAI,MAAM,eAAe,OAAO,KAAK,CAAC,IAAI,KAAA;GAC3F;GACA,IAAI,WAAW;IACb,OAAO,MAAM,aAAa,QAAQ,SAAS,KAAK,IAAI,MAAM,gBAAgB,OAAO,KAAK,CAAC,IAAI,KAAA;GAC7F;GACA,IAAI,WAAW;IACb,OAAO,MAAM,aAAa,QAAQ,SAAS,KAAK,IAAI,MAAM,WAAW,KAAA;GACvE;GACA,IAAI,YAAY;IACd,OAAO,MAAM;GACf;EAEwB,CAAC;EAC3B,aAAa,GAAG;EAChB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;AAED,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,gBAAgB;EAC5B,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAKD,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,OAAO;CAGP,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,gBAAgB;EAC5B,aAAa;GACX,MAAM,eAAe,IAAI,IAAI,MAAM,gBAAgB;GAEnD,MAAM,WAAW,MAAM,UAAU,YAAY,KAAK,CAAC;GACnD,MAAM,QAAQ,aAAa,QAAQ;GAEnC,OAAO,MAAM,WAAW,IAAI,WAAW,MAAM,IAAK,YAAY,IAAI;EACpE;CACF;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,gBAAgB;EAC5B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,gBAAgB;EAC5B,MAAM,OAAO,uBAAuB;EACpC,MAAM,SAAS,qBAAqB;EAEpC,aAAa;GACX,MAAM,OAAO,MAAM,UAAU;GAC7B,MAAM,QAAQ,CAAC,QAAQ,KAAK,WAAW,MAAM,QAAQ,SACjD,KAAK,IAAI,MAAM,cAAc,OAAO,KAAK,CAAC,IAC1C,KAAA;GACJ,OAAO,EAAE,KAAK,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,SAAS,OAAO,IAAI;EACxG;CACF;AACF,CAAC"}
+{"version":3,"file":"field.js","names":[],"sources":["../../../src/components/field/field.ts"],"sourcesContent":["import type { FieldProps } from '@xihan-ui/headless'\nimport type { SlotsType, VNode } from 'vue'\nimport { cloneVNode, Comment, defineComponent, h, Text } from 'vue'\nimport { carriesOwnAnatomy } from '../../runtime/as-child'\nimport { useOptionalFormContext, useOptionalFormField } from '../form/context'\nimport { provideField, useFieldContext } from './context'\nimport { useField } from './use-field'\n\n/** 滤掉注释与纯文本节点，只留能挂属性的节点。 */\nfunction attributable(nodes: readonly VNode[]): VNode[] {\n  return nodes.filter(node => node.type !== Comment && node.type !== Text)\n}\n\nexport const XhFieldRoot = defineComponent({\n  name: 'XhFieldRoot',\n  // 三个布尔缺省 undefined：在 XhFormFieldGroup 里没写就从表单上下文自取，写了以写的为准\n  props: {\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    // 控件节点的 id，不占用根节点自己的 DOM id\n    controlId: { type: String, default: undefined },\n  },\n  setup(props, { slots }) {\n    const form = useOptionalFormContext()\n    const handle = useOptionalFormField()\n    // getter 透传保住响应性：props 与表单 api 谁变都会带动 connect 重算\n    const merged: FieldProps = {\n      get invalid() {\n        return props.invalid ?? (form && handle ? form.api.value.isFieldInvalid(handle.name()) : undefined)\n      },\n      get required() {\n        return props.required ?? (form && handle ? form.api.value.isFieldRequired(handle.name()) : undefined)\n      },\n      get disabled() {\n        return props.disabled ?? (form && handle ? form.api.value.disabled : undefined)\n      },\n      get readOnly() {\n        return props.readOnly ?? (form && handle ? form.api.value.readOnly : undefined)\n      },\n      get controlId() {\n        return props.controlId\n      },\n    }\n    const ctx = useField(merged)\n    provideField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldLabel = defineComponent({\n  name: 'XhFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 默认插槽的载荷：控件节点该挂的那组属性，作者把它交给自己渲染的控件。 */\nexport type FieldControlSlotProps = Record<string, unknown>\n\n/** 去掉角色标记，只留接线属性（id 与 aria-*）。 */\nexport function wiringOnly(controlProps: Record<string, unknown>): Record<string, unknown> {\n  const rest: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(controlProps)) {\n    if (key !== 'data-scope' && key !== 'data-part')\n      rest[key] = value\n  }\n  return rest\n}\n\nexport const XhFieldControl = defineComponent({\n  name: 'XhFieldControl',\n  props: {\n    /**\n     * 把接线属性合到唯一的子节点上，缺省开。\n     *\n     * 子节点是薄封装（根不是可聚焦元素）时关掉它：属性只经插槽载荷交出去，\n     * 由封装内部调 useFieldControl 绑到真控件上。\n     */\n    asChild: { type: Boolean, default: true },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: FieldControlSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useFieldContext()\n    return () => {\n      const controlProps = ctx.api.value.getControlProps() as Record<string, unknown>\n      // control props 经 slot props 交给作者，控件节点由作者渲染\n      const children = slots.default?.(controlProps) ?? []\n      const nodes = attributable(children)\n      // 关了 asChild、或不止一个节点：都视为作者已用 slot props 自行接线\n      if (!props.asChild || nodes.length !== 1)\n        return children\n      const node = nodes[0]!\n      // 单个节点合并属性；它自带角色标记时不覆盖，只落接线属性\n      return cloneVNode(node, carriesOwnAnatomy(node) ? wiringOnly(controlProps) : controlProps)\n    }\n  },\n})\n\nexport const XhFieldDescription = defineComponent({\n  name: 'XhFieldDescription',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldErrorText = defineComponent({\n  name: 'XhFieldErrorText',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    const form = useOptionalFormContext()\n    const handle = useOptionalFormField()\n    // 节点常挂，靠 hidden 显隐；插槽没给内容时在表单里自取该字段的错误文案\n    return () => {\n      const kids = slots.default?.()\n      const auto = (!kids || kids.length === 0) && form && handle\n        ? form.api.value.getFieldError(handle.name())\n        : undefined\n      return h('p', ctx.api.value.getErrorTextProps() as Record<string, unknown>, kids?.length ? kids : auto)\n    }\n  },\n})\n"],"mappings":"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"}

package/dist/components/field/use-field-control.d.ts

@@ -0,0 +1,41 @@
+import { ComputedRef } from "vue";
+//#region src/components/field/use-field-control.d.ts
+/**
+ * 在薄封装内部取字段的控件接线属性（id 与 aria-*），把它们绑到真正可聚焦的那个节点上。
+ *
+ * XhFieldControl 默认把属性合到它唯一的子节点上，而子节点是组件时合的是组件根——
+ * 封装的根往往是个 div，label 的 for 指过去就聚不到焦（for 只对可标注元素生效），
+ * 而且这种失效不报错。封装内部调一次本组合式，接线就落在该落的节点上。
+ *
+ * 外层要写 `<XhFieldControl :as-child="false">`，否则属性会被合两遍。
+ * 不在字段里时返回空对象，封装照样能单独用。
+ */
+declare function useFieldControl(): ComputedRef<Record<string, unknown>>;
+/**
+ * 只取字段的「状态接线」（说明、校验、只读），不含 id 与名字。
+ *
+ * 给库自己的薄封装用：XhFieldControl 默认把整套属性合到封装根上，id 与
+ * aria-labelledby 落在那里是对的（label 的 for 得指得到一个真节点）；但
+ * aria-describedby 与 aria-invalid 落在根上就等于没落——焦点进的是里面那个
+ * input / button，读屏只念焦点所在节点的描述，说明与错误文本因此播报不出来。
+ * 封装把这几条补到真控件上，两边不冲突：id 只有一份，描述有两份不影响播报。
+ *
+ * 作者自己写封装时用上面那个 useFieldControl（配 `:as-child="false"`），
+ * 那条路整套属性都落到真控件上。
+ */
+declare function useFieldStateWiring(): ComputedRef<Record<string, unknown>>;
+/**
+ * 把字段标签的 id 并进这份属性里的名字链，供库自己的薄封装包在渲染属性外面。
+ *
+ * 复合控件的可聚焦部件自带 aria-labelledby，指的是它自己的 label 部件。套进字段时
+ * 作者用的是字段的标签、组件那个 label 部件根本没渲染，这条引用于是指向一个不存在的
+ * 节点——按 accname 规则悬空 IDREF 直接跳过，而名字也回退不到 label 的 for：for 指的
+ * 是封装根那个 div，只对可标注元素生效。结果是焦点所在的那个控件一个名字都没有。
+ *
+ * 字段的标签排在最前，控件自己的那截（值文本这类）跟在后面，两边都念得到。
+ * 不在字段里时属性原样返回。
+ */
+declare function useFieldLabelWiring(): ComputedRef<(props: Record<string, unknown>) => Record<string, unknown>>;
+//#endregion
+export { useFieldControl, useFieldLabelWiring, useFieldStateWiring };
+//# sourceMappingURL=use-field-control.d.ts.map

package/dist/components/field/use-field-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-field-control.d.ts","names":[],"sources":["../../../src/components/field/use-field-control.ts"],"mappings":";;;;;;;;;;;;iBAegB,mBAAmB,YAAY;;;;;;;;;;;;;iBAqB/B,uBAAuB,YAAY;;;;;;;;;;;;iBA0BnC,uBAAuB,aAAa,OAAO,4BAA4B"}

package/dist/components/field/use-field-control.js

@@ -0,0 +1,77 @@
+import { useOptionalFieldContext } from "./context.js";
+import { wiringOnly } from "./field.js";
+import { computed } from "vue";
+//#region src/components/field/use-field-control.ts
+/**
+* 在薄封装内部取字段的控件接线属性（id 与 aria-*），把它们绑到真正可聚焦的那个节点上。
+*
+* XhFieldControl 默认把属性合到它唯一的子节点上，而子节点是组件时合的是组件根——
+* 封装的根往往是个 div，label 的 for 指过去就聚不到焦（for 只对可标注元素生效），
+* 而且这种失效不报错。封装内部调一次本组合式，接线就落在该落的节点上。
+*
+* 外层要写 `<XhFieldControl :as-child="false">`，否则属性会被合两遍。
+* 不在字段里时返回空对象，封装照样能单独用。
+*/
+function useFieldControl() {
+	const ctx = useOptionalFieldContext();
+	return computed(() => {
+		if (!ctx) return {};
+		return wiringOnly(ctx.api.value.getControlProps());
+	});
+}
+/**
+* 只取字段的「状态接线」（说明、校验、只读），不含 id 与名字。
+*
+* 给库自己的薄封装用：XhFieldControl 默认把整套属性合到封装根上，id 与
+* aria-labelledby 落在那里是对的（label 的 for 得指得到一个真节点）；但
+* aria-describedby 与 aria-invalid 落在根上就等于没落——焦点进的是里面那个
+* input / button，读屏只念焦点所在节点的描述，说明与错误文本因此播报不出来。
+* 封装把这几条补到真控件上，两边不冲突：id 只有一份，描述有两份不影响播报。
+*
+* 作者自己写封装时用上面那个 useFieldControl（配 `:as-child="false"`），
+* 那条路整套属性都落到真控件上。
+*/
+function useFieldStateWiring() {
+	const ctx = useOptionalFieldContext();
+	return computed(() => {
+		if (!ctx) return {};
+		const control = ctx.api.value.getControlProps();
+		const wiring = {};
+		for (const key of [
+			"aria-describedby",
+			"aria-invalid",
+			"aria-required",
+			"aria-readonly"
+		]) if (control[key] !== void 0) wiring[key] = control[key];
+		return wiring;
+	});
+}
+/**
+* 把字段标签的 id 并进这份属性里的名字链，供库自己的薄封装包在渲染属性外面。
+*
+* 复合控件的可聚焦部件自带 aria-labelledby，指的是它自己的 label 部件。套进字段时
+* 作者用的是字段的标签、组件那个 label 部件根本没渲染，这条引用于是指向一个不存在的
+* 节点——按 accname 规则悬空 IDREF 直接跳过，而名字也回退不到 label 的 for：for 指的
+* 是封装根那个 div，只对可标注元素生效。结果是焦点所在的那个控件一个名字都没有。
+*
+* 字段的标签排在最前，控件自己的那截（值文本这类）跟在后面，两边都念得到。
+* 不在字段里时属性原样返回。
+*/
+function useFieldLabelWiring() {
+	const ctx = useOptionalFieldContext();
+	return computed(() => {
+		const labelId = ctx?.api.value.labelId;
+		return (props) => {
+			if (!labelId) return props;
+			const own = props["aria-labelledby"];
+			return {
+				...props,
+				"aria-labelledby": typeof own === "string" && own ? `${labelId} ${own}` : labelId
+			};
+		};
+	});
+}
+//#endregion
+export { useFieldControl, useFieldLabelWiring, useFieldStateWiring };
+
+//# sourceMappingURL=use-field-control.js.map

package/dist/components/field/use-field-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-field-control.js","names":[],"sources":["../../../src/components/field/use-field-control.ts"],"sourcesContent":["import type { ComputedRef } from 'vue'\nimport { computed } from 'vue'\nimport { useOptionalFieldContext } from './context'\nimport { wiringOnly } from './field'\n\n/**\n * 在薄封装内部取字段的控件接线属性（id 与 aria-*），把它们绑到真正可聚焦的那个节点上。\n *\n * XhFieldControl 默认把属性合到它唯一的子节点上，而子节点是组件时合的是组件根——\n * 封装的根往往是个 div，label 的 for 指过去就聚不到焦（for 只对可标注元素生效），\n * 而且这种失效不报错。封装内部调一次本组合式，接线就落在该落的节点上。\n *\n * 外层要写 `<XhFieldControl :as-child=\"false\">`，否则属性会被合两遍。\n * 不在字段里时返回空对象，封装照样能单独用。\n */\nexport function useFieldControl(): ComputedRef<Record<string, unknown>> {\n  const ctx = useOptionalFieldContext()\n  return computed(() => {\n    if (!ctx)\n      return {}\n    return wiringOnly(ctx.api.value.getControlProps() as Record<string, unknown>)\n  })\n}\n\n/**\n * 只取字段的「状态接线」（说明、校验、只读），不含 id 与名字。\n *\n * 给库自己的薄封装用：XhFieldControl 默认把整套属性合到封装根上，id 与\n * aria-labelledby 落在那里是对的（label 的 for 得指得到一个真节点）；但\n * aria-describedby 与 aria-invalid 落在根上就等于没落——焦点进的是里面那个\n * input / button，读屏只念焦点所在节点的描述，说明与错误文本因此播报不出来。\n * 封装把这几条补到真控件上，两边不冲突：id 只有一份，描述有两份不影响播报。\n *\n * 作者自己写封装时用上面那个 useFieldControl（配 `:as-child=\"false\"`），\n * 那条路整套属性都落到真控件上。\n */\nexport function useFieldStateWiring(): ComputedRef<Record<string, unknown>> {\n  const ctx = useOptionalFieldContext()\n  return computed(() => {\n    if (!ctx)\n      return {}\n    const control = ctx.api.value.getControlProps() as Record<string, unknown>\n    const wiring: Record<string, unknown> = {}\n    for (const key of ['aria-describedby', 'aria-invalid', 'aria-required', 'aria-readonly']) {\n      if (control[key] !== undefined)\n        wiring[key] = control[key]\n    }\n    return wiring\n  })\n}\n\n/**\n * 把字段标签的 id 并进这份属性里的名字链，供库自己的薄封装包在渲染属性外面。\n *\n * 复合控件的可聚焦部件自带 aria-labelledby，指的是它自己的 label 部件。套进字段时\n * 作者用的是字段的标签、组件那个 label 部件根本没渲染，这条引用于是指向一个不存在的\n * 节点——按 accname 规则悬空 IDREF 直接跳过，而名字也回退不到 label 的 for：for 指的\n * 是封装根那个 div，只对可标注元素生效。结果是焦点所在的那个控件一个名字都没有。\n *\n * 字段的标签排在最前，控件自己的那截（值文本这类）跟在后面，两边都念得到。\n * 不在字段里时属性原样返回。\n */\nexport function useFieldLabelWiring(): ComputedRef<(props: Record<string, unknown>) => Record<string, unknown>> {\n  const ctx = useOptionalFieldContext()\n  return computed(() => {\n    const labelId = ctx?.api.value.labelId\n    return (props: Record<string, unknown>) => {\n      if (!labelId)\n        return props\n      const own = props['aria-labelledby']\n      return {\n        ...props,\n        'aria-labelledby': typeof own === 'string' && own ? `${labelId} ${own}` : labelId,\n      }\n    }\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,kBAAwD;CACtE,MAAM,MAAM,wBAAwB;CACpC,OAAO,eAAe;EACpB,IAAI,CAAC,KACH,OAAO,CAAC;EACV,OAAO,WAAW,IAAI,IAAI,MAAM,gBAAgB,CAA4B;CAC9E,CAAC;AACH;;;;;;;;;;;;;AAcA,SAAgB,sBAA4D;CAC1E,MAAM,MAAM,wBAAwB;CACpC,OAAO,eAAe;EACpB,IAAI,CAAC,KACH,OAAO,CAAC;EACV,MAAM,UAAU,IAAI,IAAI,MAAM,gBAAgB;EAC9C,MAAM,SAAkC,CAAC;EACzC,KAAK,MAAM,OAAO;GAAC;GAAoB;GAAgB;GAAiB;EAAe,GACrF,IAAI,QAAQ,SAAS,KAAA,GACnB,OAAO,OAAO,QAAQ;EAE1B,OAAO;CACT,CAAC;AACH;;;;;;;;;;;;AAaA,SAAgB,sBAAgG;CAC9G,MAAM,MAAM,wBAAwB;CACpC,OAAO,eAAe;EACpB,MAAM,UAAU,KAAK,IAAI,MAAM;EAC/B,QAAQ,UAAmC;GACzC,IAAI,CAAC,SACH,OAAO;GACT,MAAM,MAAM,MAAM;GAClB,OAAO;IACL,GAAG;IACH,mBAAmB,OAAO,QAAQ,YAAY,MAAM,GAAG,QAAQ,GAAG,QAAQ;GAC5E;EACF;CACF,CAAC;AACH"}

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

@@ -0,0 +1,6 @@
+import { FieldsetContext } from "./use-fieldset.js";
+//#region src/components/fieldset/context.d.ts
+declare function useFieldsetContext(): FieldsetContext;
+//#endregion
+export { useFieldsetContext };
+//# sourceMappingURL=context.d.ts.map

package/dist/components/fieldset/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/fieldset/context.ts"],"mappings":";;iBAUgB,sBAAsB"}

package/dist/components/fieldset/context.js

@@ -0,0 +1,15 @@
+import { inject, provide } from "vue";
+//#region src/components/fieldset/context.ts
+const KEY = Symbol.for("xh-fieldset");
+function provideFieldset(ctx) {
+	provide(KEY, ctx);
+}
+function useFieldsetContext() {
+	const ctx = inject(KEY, null);
+	if (!ctx) throw new Error("[xh] Fieldset 部件必须用在 XhFieldsetRoot 内");
+	return ctx;
+}
+//#endregion
+export { provideFieldset, useFieldsetContext };
+
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/fieldset/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { FieldsetContext } from './use-fieldset'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<FieldsetContext> = Symbol.for('xh-fieldset')\n\nexport function provideFieldset(ctx: FieldsetContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFieldsetContext(): FieldsetContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Fieldset 部件必须用在 XhFieldsetRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAqC,OAAO,IAAI,aAAa;AAEnE,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,uCAAuC;CACzD,OAAO;AACT"}

package/dist/components/fieldset/fieldset.d.ts

@@ -0,0 +1,57 @@
+import { PropType } from "vue";
+import { FieldsetTranslations } from "@xihan-ui/headless";
+//#region src/components/fieldset/fieldset.d.ts
+declare const XhFieldsetRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  invalid: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  translations: {
+    type: PropType<Partial<FieldsetTranslations>>;
+    default: undefined;
+  };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  invalid: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  translations: {
+    type: PropType<Partial<FieldsetTranslations>>;
+    default: undefined;
+  };
+}>> & Readonly<{}>, {
+  required: boolean;
+  invalid: boolean;
+  disabled: boolean;
+  translations: Partial<FieldsetTranslations>;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhFieldsetLegend: import("vue").DefineComponent<{}, () => import("vue").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 XhFieldsetHelperText: import("vue").DefineComponent<{}, () => import("vue").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 XhFieldsetErrorText: import("vue").DefineComponent<{}, () => import("vue").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 { XhFieldsetErrorText, XhFieldsetHelperText, XhFieldsetLegend, XhFieldsetRoot };
+//# sourceMappingURL=fieldset.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fieldset.d.ts","names":[],"sources":["../../../src/components/fieldset/fieldset.ts"],"mappings":";;;cAOa,8BAAc,8BAAA;;;;;;;;;;;;;;IAOS,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;IAAjB,MAAA,SAAS,QAAQ;;;;;;;;qCAQnD;cAEW,gCAAgB,wCAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,wCAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,wCAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/fieldset/fieldset.js

@@ -0,0 +1,56 @@
+import { withXhConfig } from "../../config/config.js";
+import { provideFieldset, useFieldsetContext } from "./context.js";
+import { useFieldset } from "./use-fieldset.js";
+import { defineComponent, h } from "vue";
+//#region src/components/fieldset/fieldset.ts
+const XhFieldsetRoot = defineComponent({
+	name: "XhFieldsetRoot",
+	props: {
+		disabled: {
+			type: Boolean,
+			default: void 0
+		},
+		invalid: {
+			type: Boolean,
+			default: void 0
+		},
+		required: {
+			type: Boolean,
+			default: void 0
+		},
+		translations: {
+			type: Object,
+			default: void 0
+		}
+	},
+	setup(props, { slots }) {
+		const ctx = useFieldset(withXhConfig("fieldset", props));
+		provideFieldset(ctx);
+		return () => h("fieldset", ctx.api.value.getRootProps(), slots.default?.());
+	}
+});
+const XhFieldsetLegend = defineComponent({
+	name: "XhFieldsetLegend",
+	setup(_, { slots }) {
+		const ctx = useFieldsetContext();
+		return () => h("legend", ctx.api.value.getLegendProps(), slots.default?.());
+	}
+});
+const XhFieldsetHelperText = defineComponent({
+	name: "XhFieldsetHelperText",
+	setup(_, { slots }) {
+		const ctx = useFieldsetContext();
+		return () => h("p", ctx.api.value.getHelperTextProps(), slots.default?.());
+	}
+});
+const XhFieldsetErrorText = defineComponent({
+	name: "XhFieldsetErrorText",
+	setup(_, { slots }) {
+		const ctx = useFieldsetContext();
+		return () => h("p", ctx.api.value.getErrorTextProps(), slots.default?.());
+	}
+});
+//#endregion
+export { XhFieldsetErrorText, XhFieldsetHelperText, XhFieldsetLegend, XhFieldsetRoot };
+
+//# sourceMappingURL=fieldset.js.map

package/dist/components/fieldset/fieldset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldset.js","names":[],"sources":["../../../src/components/fieldset/fieldset.ts"],"sourcesContent":["import type { FieldsetProps, FieldsetTranslations } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideFieldset, useFieldsetContext } from './context'\nimport { useFieldset } from './use-fieldset'\n\nexport const XhFieldsetRoot = defineComponent({\n  name: 'XhFieldsetRoot',\n  // 三个布尔缺省 undefined：缺省值的事实源在 connect，写死 false 会挡住将来从上下文取值\n  props: {\n    disabled: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<FieldsetTranslations>>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useFieldset(withXhConfig('fieldset', props) as FieldsetProps)\n    provideFieldset(ctx)\n    // 必须是原生 <fieldset>：整组禁用连坐组内控件是浏览器给的，换成 div 就只剩一层灰样式\n    return () => h('fieldset', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldsetLegend = defineComponent({\n  name: 'XhFieldsetLegend',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    // 原生 <legend> 只有作为 <fieldset> 的首个子节点时才充当这一组的名字\n    return () => h('legend', ctx.api.value.getLegendProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldsetHelperText = defineComponent({\n  name: 'XhFieldsetHelperText',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    return () => h('p', ctx.api.value.getHelperTextProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldsetErrorText = defineComponent({\n  name: 'XhFieldsetErrorText',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    // 节点常挂，靠 hidden 显隐：翻转时 role=alert 才播报得出来，卸载重挂读屏读不到\n    return () => h('p', ctx.api.value.getErrorTextProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;AAOA,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CAEN,OAAO;EACL,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,cAAc;GAAE,MAAM;GAAmD,SAAS,KAAA;EAAU;CAC9F;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,YAAY,aAAa,YAAY,KAAK,CAAkB;EACxE,gBAAgB,GAAG;EAEnB,aAAa,EAAE,YAAY,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAE/B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,mBAAmB,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAE/B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC"}

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

@@ -0,0 +1,10 @@
+import { ComputedRef } from "vue";
+import { FieldsetApi, FieldsetProps } from "@xihan-ui/headless";
+//#region src/components/fieldset/use-fieldset.d.ts
+interface FieldsetContext {
+  api: ComputedRef<FieldsetApi>;
+}
+declare function useFieldset(props: FieldsetProps): FieldsetContext;
+//#endregion
+export { FieldsetContext, useFieldset };
+//# sourceMappingURL=use-fieldset.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-fieldset.d.ts","names":[],"sources":["../../../src/components/fieldset/use-fieldset.ts"],"mappings":";;;UAQiB;EACf,KAAK,YAAY;;iBAIH,YAAY,OAAO,gBAAgB"}

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

@@ -0,0 +1,14 @@
+import { vueNormalize } from "../../runtime/normalize-props.js";
+import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { computed } from "vue";
+import { connectFieldset } from "@xihan-ui/headless";
+import { createScope } from "@xihan-ui/kernel";
+//#region src/components/fieldset/use-fieldset.ts
+function useFieldset(props) {
+	const scope = createScope(null, createVueIdGenerator());
+	return { api: computed(() => connectFieldset(props, scope, vueNormalize)) };
+}
+//#endregion
+export { useFieldset };
+
+//# sourceMappingURL=use-fieldset.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-fieldset.js","names":[],"sources":["../../../src/components/fieldset/use-fieldset.ts"],"sourcesContent":["import type { FieldsetApi, FieldsetProps } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectFieldset } from '@xihan-ui/headless'\nimport { createScope } from '@xihan-ui/kernel'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface FieldsetContext {\n  api: ComputedRef<FieldsetApi>\n}\n\n// Fieldset 无状态机，只用一份实例级 scope 派生 part id，props 变了由 computed 重算属性\nexport function useFieldset(props: FieldsetProps): FieldsetContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const api = computed(() => connectFieldset(props, scope, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;;AAaA,SAAgB,YAAY,OAAuC;CAEjE,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CAErC,OAAO,EAAE,KADG,eAAe,gBAAgB,OAAO,OAAO,YAAY,CAC1D,EAAE;AACf"}

package/dist/components/file-upload/context.js

@@ -1,7 +1,7 @@
 import { inject, provide } from "vue";
 //#region src/components/file-upload/context.ts
-const KEY = Symbol("xh-file-upload");
-const ITEM_KEY = Symbol("xh-file-upload-item");
+const KEY = Symbol.for("xh-file-upload");
+const ITEM_KEY = Symbol.for("xh-file-upload-item");
 function provideFileUpload(ctx) {
 	provide(KEY, ctx);
 }

package/dist/components/file-upload/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/file-upload/context.ts"],"sourcesContent":["import type { FileUploadItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { FileUploadContext } from './use-file-upload'\nimport { inject, provide } from 'vue'\n\n/** 条目自报的文件，供 item-name / item-size-text / 删除按钮这些子部件复用同一份声明。 */\nexport interface FileUploadItemContext {\n  item: ComputedRef<FileUploadItemProps>\n}\n\nconst KEY: InjectionKey<FileUploadContext> = Symbol('xh-file-upload')\nconst ITEM_KEY: InjectionKey<FileUploadItemContext> = Symbol('xh-file-upload-item')\n\nexport function provideFileUpload(ctx: FileUploadContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFileUploadContext(): FileUploadContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] FileUpload 部件必须用在 XhFileUploadRoot 内')\n  return ctx\n}\n\nexport function provideFileUploadItem(ctx: FileUploadItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useFileUploadItemContext(): FileUploadItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] FileUpload 条目子部件必须用在 XhFileUploadItem 内')\n  return ctx\n}\n"],"mappings":";;AAUA,MAAM,MAAuC,OAAO,gBAAgB;AACpE,MAAM,WAAgD,OAAO,qBAAqB;AAElF,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;AAEA,SAAgB,sBAAsB,KAAkC;CACtE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,2BAAkD;CAChE,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,8CAA8C;CAChE,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/file-upload/context.ts"],"sourcesContent":["import type { FileUploadItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { FileUploadContext } from './use-file-upload'\nimport { inject, provide } from 'vue'\n\n/** 条目自报的文件，供 item-name / item-size-text / 删除按钮这些子部件复用同一份声明。 */\nexport interface FileUploadItemContext {\n  item: ComputedRef<FileUploadItemProps>\n}\n\nconst KEY: InjectionKey<FileUploadContext> = Symbol.for('xh-file-upload')\nconst ITEM_KEY: InjectionKey<FileUploadItemContext> = Symbol.for('xh-file-upload-item')\n\nexport function provideFileUpload(ctx: FileUploadContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFileUploadContext(): FileUploadContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] FileUpload 部件必须用在 XhFileUploadRoot 内')\n  return ctx\n}\n\nexport function provideFileUploadItem(ctx: FileUploadItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useFileUploadItemContext(): FileUploadItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] FileUpload 条目子部件必须用在 XhFileUploadItem 内')\n  return ctx\n}\n"],"mappings":";;AAUA,MAAM,MAAuC,OAAO,IAAI,gBAAgB;AACxE,MAAM,WAAgD,OAAO,IAAI,qBAAqB;AAEtF,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;AAEA,SAAgB,sBAAsB,KAAkC;CACtE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,2BAAkD;CAChE,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,8CAA8C;CAChE,OAAO;AACT"}

package/dist/components/file-upload/file-upload.d.ts

@@ -4,7 +4,7 @@ import { FileUploadApi, FileUploadFile, FileUploadRemoteFile, FileUploadSchema,
 //#region src/components/file-upload/file-upload.d.ts
 type FileUploadProps = FileUploadSchema['props'];
 /** 默认插槽的载荷：文件清单与传输快照、投放区与数量状态，与增删清空、开传、拉起选择器等命令。 */
-type FileUploadRootSlotProps = Pick<FileUploadApi, 'acceptedFiles' | 'remoteFiles' | 'allFiles' | 'uploadOf' | 'startUpload' | 'dragging' | 'empty' | 'disabled' | 'maxFiles' | 'getFileSizeText' | 'setFiles' | 'addFiles' | 'deleteFile' | 'clearFiles' | 'openFilePicker'>;
+type FileUploadRootSlotProps = Pick<FileUploadApi, 'acceptedFiles' | 'remoteFiles' | 'allFiles' | 'uploadOf' | 'startUpload' | 'dragging' | 'empty' | 'disabled' | 'maxFiles' | 'getFileSizeText' | 'setFiles' | 'addFiles' | 'deleteFile' | 'clear' | 'openFilePicker'>;
 declare const XhFileUploadRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   files: {
     type: PropType<File[]>;
@@ -172,9 +172,17 @@ declare const XhFileUploadLabel: import("vue").DefineComponent<{}, () => VNode<i
 declare const XhFileUploadDropzone: 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 XhFileUploadTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhFileUploadTrigger: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  asChild: BooleanConstructor;
+}>, () => 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>;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  asChild: BooleanConstructor;
+}>> & Readonly<{}>, {
+  asChild: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhFileUploadHiddenInput: 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>;

package/dist/components/file-upload/file-upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-upload.d.ts","names":[],"sources":["../../../src/components/file-upload/file-upload.ts"],"mappings":";;;;KAQK,kBAAkB;;KAGX,0BAA0B,KACpC;cAkBW,gCAAgB,8BAAA;;IAKD,MAAA,SAAS;;;;IACF,MAAA,SAAS;;;;IACV,MAAA,SAAS;;;;IACF,MAAA,SAAS;;;;IAClB,MAAA,SAAS;;;;;;;;IAEF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;IASR,MAAA;;;;IACK,MAAA,SAAS,QAAQ;;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACT,gBAAA,UAAA,UAAU;EACV,gBAAA,UAAA,UAAU;EACF,wBAAA,UAAA,UAAU;EACb,uBAAA,QAAA,UAAU;EACX,oBAAA,UAAA,UAAU;EACb,iBAAA,UAAA,UAAU;;;IA3Bb,MAAA,SAAS;;;;IACF,MAAA,SAAS;;;;IACV,MAAA,SAAS;;;;IACF,MAAA,SAAS;;;;IAClB,MAAA,SAAS;;;;;;;;IAEF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;IASR,MAAA;;;;IACK,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcvC,WAAC,OAAO,4BAA4B;kCAmChD;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,8BAAA;;;IAID,MAAA,SAAS;;;;;IAEE,MAAA;;;;;;;;IAFX,MAAA,SAAS;;;;;IAEE,MAAA;;;;;;qCAqBrC;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAY/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAYnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAWxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"file-upload.d.ts","names":[],"sources":["../../../src/components/file-upload/file-upload.ts"],"mappings":";;;;KASK,kBAAkB;;KAGX,0BAA0B,KACpC;cAkBW,gCAAgB,8BAAA;;IAKD,MAAA,SAAS;;;;IACF,MAAA,SAAS;;;;IACV,MAAA,SAAS;;;;IACF,MAAA,SAAS;;;;IAClB,MAAA,SAAS;;;;;;;;IAEF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;IASR,MAAA;;;;IACK,MAAA,SAAS,QAAQ;;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACT,gBAAA,UAAA,UAAU;EACV,gBAAA,UAAA,UAAU;EACF,wBAAA,UAAA,UAAU;EACb,uBAAA,QAAA,UAAU;EACX,oBAAA,UAAA,UAAU;EACb,iBAAA,UAAA,UAAU;;;IA3Bb,MAAA,SAAS;;;;IACF,MAAA,SAAS;;;;IACV,MAAA,SAAS;;;;IACF,MAAA,SAAS;;;;IAClB,MAAA,SAAS;;;;;;;;IAEF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;IASR,MAAA;;;;IACK,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcvC,WAAC,OAAO,4BAA4B;kCAmChD;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;;;;;;;;;qCAoB9B;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,8BAAA;;;IAID,MAAA,SAAS;;;;;IAEE,MAAA;;;;;;;;IAFX,MAAA,SAAS;;;;;IAEE,MAAA;;;;;;qCAqBrC;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAY/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAYnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAWxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/file-upload/file-upload.js

@@ -1,4 +1,5 @@
 import { withXhConfig } from "../../config/config.js";
+import { mergeIntoChild } from "../../runtime/as-child.js";
 import { provideFileUpload, provideFileUploadItem, useFileUploadContext, useFileUploadItemContext } from "./context.js";
 import { useFileUpload } from "./use-file-upload.js";
 import { computed, defineComponent, h } from "vue";
@@ -113,7 +114,7 @@ const XhFileUploadRoot = defineComponent({
 			setFiles: ctx.api.value.setFiles,
 			addFiles: ctx.api.value.addFiles,
 			deleteFile: ctx.api.value.deleteFile,
-			clearFiles: ctx.api.value.clearFiles,
+			clear: ctx.api.value.clear,
 			openFilePicker: ctx.api.value.openFilePicker
 		}));
 	}
@@ -134,9 +135,20 @@ const XhFileUploadDropzone = defineComponent({
 });
 const XhFileUploadTrigger = defineComponent({
 	name: "XhFileUploadTrigger",
-	setup(_, { slots }) {
+	props: { 
+	/** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+asChild: Boolean },
+	setup(props, { slots }) {
 		const ctx = useFileUploadContext();
-		return () => h("button", ctx.api.value.getTriggerProps(), slots.default?.());
+		return () => {
+			const attrs = ctx.api.value.getTriggerProps();
+			const children = slots.default?.();
+			if (props.asChild) {
+				const merged = mergeIntoChild(children, attrs, "file-upload");
+				if (merged) return merged;
+			}
+			return h("button", attrs, children);
+		};
 	}
 });
 const XhFileUploadHiddenInput = defineComponent({