@xihan-ui/vue 1.1.0 → 2.0.0

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

@@ -1 +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"}
+{"version":3,"file":"use-field-control.js","names":[],"sources":["../../../src/components/field/use-field-control.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 field control 相关实现。\n\nimport 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":";;;;;;;;;;;;;;AAsBA,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/field/use-field.d.ts.map

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

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

@@ -1,8 +1,8 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
 import { computed } from "vue";
+import { createScope } from "@xihan-ui/core";
 import { connectField } from "@xihan-ui/headless";
-import { createScope } from "@xihan-ui/kernel";
 //#region src/components/field/use-field.ts
 function useField(props) {
 	const scope = createScope(null, createVueIdGenerator());

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

@@ -1 +1 @@
-{"version":3,"file":"use-field.js","names":[],"sources":["../../../src/components/field/use-field.ts"],"sourcesContent":["import type { FieldApi, FieldProps } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectField } 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 FieldContext {\n  api: ComputedRef<FieldApi>\n}\n\n// Field 无状态机，只用一份实例级 scope 派生 part id，props 变了由 computed 重算属性\nexport function useField(props: FieldProps): FieldContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const api = computed(() => connectField(props, scope, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;;AAaA,SAAgB,SAAS,OAAiC;CAExD,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CAErC,OAAO,EAAE,KADG,eAAe,aAAa,OAAO,OAAO,YAAY,CACvD,EAAE;AACf"}
+{"version":3,"file":"use-field.js","names":[],"sources":["../../../src/components/field/use-field.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 field 相关实现。\n\nimport type { FieldApi, FieldProps } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectField } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface FieldContext {\n  api: ComputedRef<FieldApi>\n}\n\n// Field 无状态机，只用一份实例级 scope 派生 part id，props 变了由 computed 重算属性\nexport function useField(props: FieldProps): FieldContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const api = computed(() => connectField(props, scope, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;;AAoBA,SAAgB,SAAS,OAAiC;CAExD,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CAErC,OAAO,EAAE,KADG,eAAe,aAAa,OAAO,OAAO,YAAY,CACvD,EAAE;AACf"}

package/dist/components/field-array/context.d.ts

@@ -0,0 +1,15 @@
+import { FieldArrayContext } from "./use-field-array.js";
+import { ComputedRef } from "vue";
+import { FieldArrayItemProps } from "@xihan-ui/headless";
+//#region src/components/field-array/context.d.ts
+/** 行声明的下标，供 item-content / item-action 与三个操作按钮复用同一份声明。 */
+interface FieldArrayItemContext {
+  item: ComputedRef<FieldArrayItemProps>;
+}
+declare function provideFieldArray(ctx: FieldArrayContext): void;
+declare function useFieldArrayContext(): FieldArrayContext;
+declare function provideFieldArrayItem(ctx: FieldArrayItemContext): void;
+declare function useFieldArrayItemContext(): FieldArrayItemContext;
+//#endregion
+export { FieldArrayItemContext, provideFieldArray, provideFieldArrayItem, useFieldArrayContext, useFieldArrayItemContext };
+//# sourceMappingURL=context.d.ts.map

package/dist/components/field-array/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/field-array/context.ts"],"mappings":";;;;;UAaiB;EACf,MAAM,YAAY;;iBAMJ,kBAAkB,KAAK;iBAIvB,wBAAwB;iBAOxB,sBAAsB,KAAK;iBAI3B,4BAA4B"}

package/dist/components/field-array/context.js

@@ -0,0 +1,24 @@
+import { inject, provide } from "vue";
+//#region src/components/field-array/context.ts
+const KEY = Symbol.for("xh-field-array");
+const ITEM_KEY = Symbol.for("xh-field-array-item");
+function provideFieldArray(ctx) {
+	provide(KEY, ctx);
+}
+function useFieldArrayContext() {
+	const ctx = inject(KEY, null);
+	if (!ctx) throw new Error("[xh] FieldArray 部件必须用在 XhFieldArrayRoot 内");
+	return ctx;
+}
+function provideFieldArrayItem(ctx) {
+	provide(ITEM_KEY, ctx);
+}
+function useFieldArrayItemContext() {
+	const ctx = inject(ITEM_KEY, null);
+	if (!ctx) throw new Error("[xh] FieldArray 行内部件必须用在 XhFieldArrayItem 内");
+	return ctx;
+}
+//#endregion
+export { provideFieldArray, provideFieldArrayItem, useFieldArrayContext, useFieldArrayItemContext };
+
+//# sourceMappingURL=context.js.map

package/dist/components/field-array/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/field-array/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 { FieldArrayItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { FieldArrayContext } from './use-field-array'\nimport { inject, provide } from 'vue'\n\n/** 行声明的下标，供 item-content / item-action 与三个操作按钮复用同一份声明。 */\nexport interface FieldArrayItemContext {\n  item: ComputedRef<FieldArrayItemProps>\n}\n\nconst KEY: InjectionKey<FieldArrayContext> = Symbol.for('xh-field-array')\nconst ITEM_KEY: InjectionKey<FieldArrayItemContext> = Symbol.for('xh-field-array-item')\n\nexport function provideFieldArray(ctx: FieldArrayContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFieldArrayContext(): FieldArrayContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] FieldArray 部件必须用在 XhFieldArrayRoot 内')\n  return ctx\n}\n\nexport function provideFieldArrayItem(ctx: FieldArrayItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useFieldArrayItemContext(): FieldArrayItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] FieldArray 行内部件必须用在 XhFieldArrayItem 内')\n  return ctx\n}\n"],"mappings":";;AAiBA,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,6CAA6C;CAC/D,OAAO;AACT"}

package/dist/components/{dynamic-input/dynamic-input.d.ts → field-array/field-array.d.ts}

@@ -1,85 +1,97 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
-import { DynamicInputApi, DynamicInputSchema, DynamicInputTranslations } from "@xihan-ui/headless";
-//#region src/components/dynamic-input/dynamic-input.d.ts
-type DynamicInputProps = DynamicInputSchema['props'];
+import { FieldArrayApi, FieldArraySchema, FieldArrayTranslations, FormPath } from "@xihan-ui/headless";
+//#region src/components/field-array/field-array.d.ts
+type FieldArrayProps = FieldArraySchema['props'];
 /** 默认插槽的载荷：逐行投影与整份值、行数与上下限状态，以及整份替换、增删、移动的动作。 */
-type DynamicInputRootSlotProps = Pick<DynamicInputApi, 'items' | 'value' | 'count' | 'empty' | 'atMin' | 'atMax' | 'canAdd' | 'setValue' | 'add' | 'remove' | 'move' | 'moveUp' | 'moveDown'>;
-declare const XhDynamicInputRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+type FieldArrayRootSlotProps = Pick<FieldArrayApi, 'items' | 'value' | 'count' | 'empty' | 'atMin' | 'atMax' | 'canAdd' | 'setValue' | 'add' | 'remove' | 'move' | 'moveUp' | 'moveDown'>;
+declare const XhFieldArrayRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: PropType<unknown[]>;
-    default: undefined;
   };
   defaultValue: {
     type: PropType<unknown[]>;
-    default: undefined;
   };
   min: {
     type: NumberConstructor;
-    default: undefined;
   };
   max: {
     type: NumberConstructor;
-    default: undefined;
   };
   createItem: {
     type: PropType<() => unknown>;
-    default: undefined;
   };
   movable: BooleanConstructor;
-  disabled: BooleanConstructor;
-  translations: {
-    type: PropType<Partial<DynamicInputTranslations>>;
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  readOnly: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  invalid: {
+    type: BooleanConstructor;
     default: undefined;
   };
+  name: {
+    type: PropType<FormPath>;
+  };
+  translations: {
+    type: PropType<Partial<FieldArrayTranslations>>;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-  'value-change': (_details: PayloadOf<DynamicInputProps, "onValueChange">) => true;
-  'update:value': (_value: PayloadOf<DynamicInputProps, "onValueChange">["value"]) => true;
+  'value-change': (_details: PayloadOf<FieldArrayProps, "onValueChange">) => true;
+  'update:value': (_value: PayloadOf<FieldArrayProps, "onValueChange">["value"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   value: {
     type: PropType<unknown[]>;
-    default: undefined;
   };
   defaultValue: {
     type: PropType<unknown[]>;
-    default: undefined;
   };
   min: {
     type: NumberConstructor;
-    default: undefined;
   };
   max: {
     type: NumberConstructor;
-    default: undefined;
   };
   createItem: {
     type: PropType<() => unknown>;
-    default: undefined;
   };
   movable: BooleanConstructor;
-  disabled: BooleanConstructor;
-  translations: {
-    type: PropType<Partial<DynamicInputTranslations>>;
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  readOnly: {
+    type: BooleanConstructor;
     default: undefined;
   };
+  invalid: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  name: {
+    type: PropType<FormPath>;
+  };
+  translations: {
+    type: PropType<Partial<FieldArrayTranslations>>;
+  };
 }>> & Readonly<{
-  "onValue-change"?: ((_details: import("@xihan-ui/headless").DynamicInputValueChangeDetails) => any) | undefined;
+  "onValue-change"?: ((_details: import("@xihan-ui/headless").FieldArrayValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: unknown[]) => any) | undefined;
 }>, {
-  value: unknown[];
-  defaultValue: unknown[];
+  invalid: boolean;
   disabled: boolean;
-  translations: Partial<DynamicInputTranslations>;
-  max: number;
-  min: number;
+  readOnly: boolean;
   movable: boolean;
-  createItem: () => unknown;
 }, SlotsType<{
-  default?: (props: DynamicInputRootSlotProps) => VNode[];
+  default?: (props: FieldArrayRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhDynamicInputItem: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+declare const XhFieldArrayItem: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   index: {
     type: PropType<number | string>;
     required: true;
@@ -92,24 +104,28 @@ declare const XhDynamicInputItem: import("vue").DefineComponent<import("vue").Ex
     required: true;
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhDynamicInputItemContent: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+/** 行前的行号或名目；纯标注，不与行内的控件建立 for 关联。 */
+declare const XhFieldArrayItemLabel: 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 XhFieldArrayItemContent: 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 XhDynamicInputItemAction: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhFieldArrayItemAction: 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 XhDynamicInputAddTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhFieldArrayAddTrigger: 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 XhDynamicInputItemDeleteTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhFieldArrayItemDeleteTrigger: 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 XhDynamicInputMoveUpTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhFieldArrayMoveUpTrigger: 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 XhDynamicInputMoveDownTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhFieldArrayMoveDownTrigger: 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 { DynamicInputRootSlotProps, XhDynamicInputAddTrigger, XhDynamicInputItem, XhDynamicInputItemAction, XhDynamicInputItemContent, XhDynamicInputItemDeleteTrigger, XhDynamicInputMoveDownTrigger, XhDynamicInputMoveUpTrigger, XhDynamicInputRoot };
-//# sourceMappingURL=dynamic-input.d.ts.map
+export { FieldArrayRootSlotProps, XhFieldArrayAddTrigger, XhFieldArrayItem, XhFieldArrayItemAction, XhFieldArrayItemContent, XhFieldArrayItemDeleteTrigger, XhFieldArrayItemLabel, XhFieldArrayMoveDownTrigger, XhFieldArrayMoveUpTrigger, XhFieldArrayRoot };
+//# sourceMappingURL=field-array.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field-array.d.ts","names":[],"sources":["../../../src/components/field-array/field-array.ts"],"mappings":";;;;KAiBK,kBAAkB;;KAGX,0BAA0B,KACpC;cAgBW,gCAAgB,8BAAA;;IAKD,MAAA;;;IACO,MAAA;;;;;;;;;IAGC,MAAA;;;;;;;;;;;;;;;;IAKC,MAAA,SAAS;;;IACV,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IAfX,MAAA;;;IACO,MAAA;;;;;;;;;IAGC,MAAA;;;;;;;;;;;;;;;;IAKC,MAAA,SAAS;;;IACV,MAAA,SAAS,QAAQ;;;;;;;;;;;EAQvC,WAAC,OAAO,4BAA4B;kCA2BhD;cAEW,gCAAgB,8BAAA;;IAIU,MAAA;;;;;;;IAAA,MAAA;;;MAQrC,oDAAA;;cAGW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAOxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAOpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2CAA2B,0BAAA,oBAAA,4BAAA;;8BAOtC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/field-array/field-array.js

@@ -0,0 +1,134 @@
+import { withXhConfig } from "../../config/config.js";
+import { useOptionalFormContext } from "../form/context.js";
+import { useFormControlProps } from "../form/use-form-control.js";
+import { provideFieldArray, provideFieldArrayItem, useFieldArrayContext, useFieldArrayItemContext } from "./context.js";
+import { useFieldArray } from "./use-field-array.js";
+import { computed, defineComponent, h } from "vue";
+//#region src/components/field-array/field-array.ts
+const XhFieldArrayRoot = defineComponent({
+	name: "XhFieldArrayRoot",
+	props: {
+		value: { type: Array },
+		defaultValue: { type: Array },
+		min: { type: Number },
+		max: { type: Number },
+		createItem: { type: Function },
+		movable: Boolean,
+		disabled: {
+			type: Boolean,
+			default: void 0
+		},
+		readOnly: {
+			type: Boolean,
+			default: void 0
+		},
+		invalid: {
+			type: Boolean,
+			default: void 0
+		},
+		name: { type: [String, Array] },
+		translations: { type: Object }
+	},
+	emits: {
+		"value-change": (_details) => true,
+		"update:value": (_value) => true
+	},
+	slots: Object,
+	setup(props, { slots, emit }) {
+		const form = useOptionalFormContext();
+		const onValueChange = (details) => {
+			emit("value-change", details);
+			emit("update:value", details.value);
+		};
+		const ctx = useFieldArray(withXhConfig("field-array", useFormControlProps(props)), { onValueChange }, form?.service);
+		provideFieldArray(ctx);
+		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
+			items: ctx.api.value.items,
+			value: ctx.api.value.value,
+			count: ctx.api.value.count,
+			empty: ctx.api.value.empty,
+			atMin: ctx.api.value.atMin,
+			atMax: ctx.api.value.atMax,
+			canAdd: ctx.api.value.canAdd,
+			setValue: ctx.api.value.setValue,
+			add: ctx.api.value.add,
+			remove: ctx.api.value.remove,
+			move: ctx.api.value.move,
+			moveUp: ctx.api.value.moveUp,
+			moveDown: ctx.api.value.moveDown
+		}));
+	}
+});
+const XhFieldArrayItem = defineComponent({
+	name: "XhFieldArrayItem",
+	props: { index: {
+		type: [Number, String],
+		required: true
+	} },
+	setup(props, { slots }) {
+		const ctx = useFieldArrayContext();
+		const item = computed(() => ({ index: Math.trunc(Number(props.index)) }));
+		provideFieldArrayItem({ item });
+		return () => h("div", ctx.api.value.getItemProps(item.value), slots.default?.());
+	}
+});
+/** 行前的行号或名目；纯标注，不与行内的控件建立 for 关联。 */
+const XhFieldArrayItemLabel = defineComponent({
+	name: "XhFieldArrayItemLabel",
+	setup(_, { slots }) {
+		const ctx = useFieldArrayContext();
+		const { item } = useFieldArrayItemContext();
+		return () => h("span", ctx.api.value.getItemLabelProps(item.value), slots.default?.());
+	}
+});
+const XhFieldArrayItemContent = defineComponent({
+	name: "XhFieldArrayItemContent",
+	setup(_, { slots }) {
+		const ctx = useFieldArrayContext();
+		const { item } = useFieldArrayItemContext();
+		return () => h("div", ctx.api.value.getItemContentProps(item.value), slots.default?.());
+	}
+});
+const XhFieldArrayItemAction = defineComponent({
+	name: "XhFieldArrayItemAction",
+	setup(_, { slots }) {
+		const ctx = useFieldArrayContext();
+		const { item } = useFieldArrayItemContext();
+		return () => h("div", ctx.api.value.getItemActionProps(item.value), slots.default?.());
+	}
+});
+const XhFieldArrayAddTrigger = defineComponent({
+	name: "XhFieldArrayAddTrigger",
+	setup(_, { slots }) {
+		const ctx = useFieldArrayContext();
+		return () => h("button", ctx.api.value.getAddTriggerProps(), slots.default?.());
+	}
+});
+const XhFieldArrayItemDeleteTrigger = defineComponent({
+	name: "XhFieldArrayItemDeleteTrigger",
+	setup(_, { slots }) {
+		const ctx = useFieldArrayContext();
+		const { item } = useFieldArrayItemContext();
+		return () => h("button", ctx.api.value.getItemDeleteTriggerProps(item.value), slots.default?.());
+	}
+});
+const XhFieldArrayMoveUpTrigger = defineComponent({
+	name: "XhFieldArrayMoveUpTrigger",
+	setup(_, { slots }) {
+		const ctx = useFieldArrayContext();
+		const { item } = useFieldArrayItemContext();
+		return () => h("button", ctx.api.value.getMoveUpTriggerProps(item.value), slots.default?.());
+	}
+});
+const XhFieldArrayMoveDownTrigger = defineComponent({
+	name: "XhFieldArrayMoveDownTrigger",
+	setup(_, { slots }) {
+		const ctx = useFieldArrayContext();
+		const { item } = useFieldArrayItemContext();
+		return () => h("button", ctx.api.value.getMoveDownTriggerProps(item.value), slots.default?.());
+	}
+});
+//#endregion
+export { XhFieldArrayAddTrigger, XhFieldArrayItem, XhFieldArrayItemAction, XhFieldArrayItemContent, XhFieldArrayItemDeleteTrigger, XhFieldArrayItemLabel, XhFieldArrayMoveDownTrigger, XhFieldArrayMoveUpTrigger, XhFieldArrayRoot };
+
+//# sourceMappingURL=field-array.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field-array.js","names":[],"sources":["../../../src/components/field-array/field-array.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// 提供 field array 相关实现。\n\nimport type { FieldArrayApi, FieldArrayItemProps, FieldArraySchema, FieldArrayTranslations, FormPath } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useOptionalFormContext } from '../form/context'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideFieldArray, provideFieldArrayItem, useFieldArrayContext, useFieldArrayItemContext } from './context'\nimport { useFieldArray } from './use-field-array'\n\ntype FieldArrayProps = FieldArraySchema['props']\n\n/** 默认插槽的载荷：逐行投影与整份值、行数与上下限状态，以及整份替换、增删、移动的动作。 */\nexport type FieldArrayRootSlotProps = Pick<\n  FieldArrayApi,\n  | 'items'\n  | 'value'\n  | 'count'\n  | 'empty'\n  | 'atMin'\n  | 'atMax'\n  | 'canAdd'\n  | 'setValue'\n  | 'add'\n  | 'remove'\n  | 'move'\n  | 'moveUp'\n  | 'moveDown'\n>\n\nexport const XhFieldArrayRoot = defineComponent({\n  name: 'XhFieldArrayRoot',\n  // 有 connect 与机器兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    // 缺席值 undefined 表示非受控\n    value: { type: Array as PropType<unknown[]> },\n    defaultValue: { type: Array as PropType<unknown[]> },\n    min: { type: Number },\n    max: { type: Number },\n    createItem: { type: Function as PropType<() => unknown> },\n    movable: Boolean,\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    name: { type: [String, Array] as PropType<FormPath> },\n    translations: { type: Object as PropType<Partial<FieldArrayTranslations>> },\n  },\n  // value-change 携带 { value }，update:value 携带裸数组\n  emits: {\n    'value-change': (_details: PayloadOf<FieldArrayProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<FieldArrayProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: FieldArrayRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const form = useOptionalFormContext()\n    const onValueChange: FieldArrayProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useFieldArray(withXhConfig('field-array', useFormControlProps(props)) as FieldArrayProps, { onValueChange }, form?.service)\n    provideFieldArray(ctx)\n    // items 里每一项都带 key，作者铺行时直接 :key=\"row.key\"\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      items: ctx.api.value.items,\n      value: ctx.api.value.value,\n      count: ctx.api.value.count,\n      empty: ctx.api.value.empty,\n      atMin: ctx.api.value.atMin,\n      atMax: ctx.api.value.atMax,\n      canAdd: ctx.api.value.canAdd,\n      setValue: ctx.api.value.setValue,\n      add: ctx.api.value.add,\n      remove: ctx.api.value.remove,\n      move: ctx.api.value.move,\n      moveUp: ctx.api.value.moveUp,\n      moveDown: ctx.api.value.moveDown,\n    }))\n  },\n})\n\nexport const XhFieldArrayItem = defineComponent({\n  name: 'XhFieldArrayItem',\n  props: {\n    // 下标由作者声明，兼收字符串以支持模板里写 index=\"0\"\n    index: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useFieldArrayContext()\n    const item = computed<FieldArrayItemProps>(() => ({ index: Math.trunc(Number(props.index)) }))\n    provideFieldArrayItem({ item })\n    return () => h('div', ctx.api.value.getItemProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 行前的行号或名目；纯标注，不与行内的控件建立 for 关联。 */\nexport const XhFieldArrayItemLabel = defineComponent({\n  name: 'XhFieldArrayItemLabel',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('span', ctx.api.value.getItemLabelProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayItemContent = defineComponent({\n  name: 'XhFieldArrayItemContent',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('div', ctx.api.value.getItemContentProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayItemAction = defineComponent({\n  name: 'XhFieldArrayItemAction',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('div', ctx.api.value.getItemActionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayAddTrigger = defineComponent({\n  name: 'XhFieldArrayAddTrigger',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    return () => h('button', ctx.api.value.getAddTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayItemDeleteTrigger = defineComponent({\n  name: 'XhFieldArrayItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayMoveUpTrigger = defineComponent({\n  name: 'XhFieldArrayMoveUpTrigger',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('button', ctx.api.value.getMoveUpTriggerProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldArrayMoveDownTrigger = defineComponent({\n  name: 'XhFieldArrayMoveDownTrigger',\n  setup(_, { slots }) {\n    const ctx = useFieldArrayContext()\n    const { item } = useFieldArrayItemContext()\n    return () => h('button', ctx.api.value.getMoveDownTriggerProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}

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

@@ -0,0 +1,12 @@
+import { ComputedRef } from "vue";
+import { Service } from "@xihan-ui/core";
+import { FieldArrayApi, FieldArraySchema, FormSchema } from "@xihan-ui/headless";
+//#region src/components/field-array/use-field-array.d.ts
+interface FieldArrayContext {
+  api: ComputedRef<FieldArrayApi>;
+  service: Service<FieldArraySchema>;
+}
+declare function useFieldArray(props: FieldArraySchema['props'], handlers?: Pick<FieldArraySchema['props'], 'onValueChange'>, form?: Service<FormSchema> | null): FieldArrayContext;
+//#endregion
+export { FieldArrayContext, useFieldArray };
+//# sourceMappingURL=use-field-array.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-field-array.d.ts","names":[],"sources":["../../../src/components/field-array/use-field-array.ts"],"mappings":";;;;UAiBiB;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;iBAGH,cACd,OAAO,2BACP,WAAU,KAAK,6CACf,OAAO,QAAQ,qBACd"}

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

@@ -0,0 +1,22 @@
+import { vueNormalize } from "../../runtime/normalize-props.js";
+import { useMachine } from "../../runtime/use-machine.js";
+import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { computed } from "vue";
+import { createScope } from "@xihan-ui/core";
+import { connectFieldArray, fieldArrayMachine } from "@xihan-ui/headless";
+//#region src/components/field-array/use-field-array.ts
+function useFieldArray(props, handlers = {}, form) {
+	const service = useMachine(fieldArrayMachine, () => ({
+		...props,
+		...handlers
+	}), createScope(null, createVueIdGenerator()));
+	service.refs.set("form", form ?? null);
+	return {
+		api: computed(() => connectFieldArray(service, vueNormalize)),
+		service
+	};
+}
+//#endregion
+export { useFieldArray };
+
+//# sourceMappingURL=use-field-array.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-field-array.js","names":[],"sources":["../../../src/components/field-array/use-field-array.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 field array 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { FieldArrayApi, FieldArraySchema, FormSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectFieldArray, fieldArrayMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface FieldArrayContext {\n  api: ComputedRef<FieldArrayApi>\n  service: Service<FieldArraySchema>\n}\n\nexport function useFieldArray(\n  props: FieldArraySchema['props'],\n  handlers: Pick<FieldArraySchema['props'], 'onValueChange'> = {},\n  form?: Service<FormSchema> | null,\n): FieldArrayContext {\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(fieldArrayMachine, () => ({ ...props, ...handlers }), scope)\n  service.refs.set('form', form ?? null)\n  const api = computed(() => connectFieldArray(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;;;AAsBA,SAAgB,cACd,OACA,WAA6D,CAAC,GAC9D,MACmB;CAInB,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO,GAAG;CAAS,IAD/D,YAAY,MADZ,qBACsB,CACiD,CAAC;CACtF,QAAQ,KAAK,IAAI,QAAQ,QAAQ,IAAI;CAErC,OAAO;EAAE,KADG,eAAe,kBAAkB,SAAS,YAAY,CACvD;EAAG;CAAQ;AACxB"}

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

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

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

@@ -1 +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"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/fieldset/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 { 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":";;AAWA,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

@@ -16,7 +16,6 @@ declare const XhFieldsetRoot: import("vue").DefineComponent<import("vue").Extrac
   };
   translations: {
     type: PropType<Partial<FieldsetTranslations>>;
-    default: undefined;
   };
 }>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -35,23 +34,29 @@ declare const XhFieldsetRoot: import("vue").DefineComponent<import("vue").Extrac
   };
   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, {
+declare const XhFieldsetDescription: 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 XhFieldsetFieldGroup: 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 XhFieldsetActions: 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 };
+export { XhFieldsetActions, XhFieldsetDescription, XhFieldsetErrorText, XhFieldsetFieldGroup, XhFieldsetLegend, XhFieldsetRoot };
 //# sourceMappingURL=fieldset.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"fieldset.d.ts","names":[],"sources":["../../../src/components/fieldset/fieldset.ts"],"mappings":";;;cAca,8BAAc,8BAAA;;;;;;;;;;;;;;IAOS,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;IAAjB,MAAA,SAAS,QAAQ;;;;;;qCAQnD;cAEW,gCAAgB,wCAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,wCAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,oCAAoB,wCAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,iCAAiB,wCAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,wCAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/fieldset/fieldset.js

@@ -18,10 +18,7 @@ const XhFieldsetRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
-		translations: {
-			type: Object,
-			default: void 0
-		}
+		translations: { type: Object }
 	},
 	setup(props, { slots }) {
 		const ctx = useFieldset(withXhConfig("fieldset", props));
@@ -36,11 +33,27 @@ const XhFieldsetLegend = defineComponent({
 		return () => h("legend", ctx.api.value.getLegendProps(), slots.default?.());
 	}
 });
-const XhFieldsetHelperText = defineComponent({
-	name: "XhFieldsetHelperText",
+const XhFieldsetDescription = defineComponent({
+	name: "XhFieldsetDescription",
+	setup(_, { slots }) {
+		const ctx = useFieldsetContext();
+		return () => h("p", ctx.api.value.getDescriptionProps(), slots.default?.());
+	}
+});
+/** 把并排的几个字段圈为一段；纯排版。 */
+const XhFieldsetFieldGroup = defineComponent({
+	name: "XhFieldsetFieldGroup",
+	setup(_, { slots }) {
+		const ctx = useFieldsetContext();
+		return () => h("div", ctx.api.value.getFieldGroupProps(), slots.default?.());
+	}
+});
+/** 组末尾的按钮行；纯排版。 */
+const XhFieldsetActions = defineComponent({
+	name: "XhFieldsetActions",
 	setup(_, { slots }) {
 		const ctx = useFieldsetContext();
-		return () => h("p", ctx.api.value.getHelperTextProps(), slots.default?.());
+		return () => h("div", ctx.api.value.getActionsProps(), slots.default?.());
 	}
 });
 const XhFieldsetErrorText = defineComponent({
@@ -51,6 +64,6 @@ const XhFieldsetErrorText = defineComponent({
 	}
 });
 //#endregion
-export { XhFieldsetErrorText, XhFieldsetHelperText, XhFieldsetLegend, XhFieldsetRoot };
+export { XhFieldsetActions, XhFieldsetDescription, XhFieldsetErrorText, XhFieldsetFieldGroup, XhFieldsetLegend, XhFieldsetRoot };
 
 //# sourceMappingURL=fieldset.js.map

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

@@ -1 +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"}
+{"version":3,"file":"fieldset.js","names":[],"sources":["../../../src/components/fieldset/fieldset.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// 提供 fieldset 相关实现。\n\nimport 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>> },\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 XhFieldsetDescription = defineComponent({\n  name: 'XhFieldsetDescription',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 把并排的几个字段圈为一段；纯排版。 */\nexport const XhFieldsetFieldGroup = defineComponent({\n  name: 'XhFieldsetFieldGroup',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    return () => h('div', ctx.api.value.getFieldGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 组末尾的按钮行；纯排版。 */\nexport const XhFieldsetActions = defineComponent({\n  name: 'XhFieldsetActions',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    return () => h('div', ctx.api.value.getActionsProps() 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 显隐：活区要先在场才播报得出来，卸载重挂读屏读不到\n    return () => h('p', ctx.api.value.getErrorTextProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;AAcA,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,EAAE,MAAM,OAAkD;CAC1E;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,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;;AAGD,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,mBAAmB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;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"}