@xihan-ui/vue 4.2.0 → 5.1.0

package/dist/components/expression-input/use-expression-input.d.ts

@@ -0,0 +1,26 @@
+import { ExpressionInputApi, ExpressionInputEl, ExpressionInputSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
+import { Service } from "@xihan-ui/core";
+//#region src/components/expression-input/use-expression-input.d.ts
+interface ExpressionInputContext {
+  /** 已渲染的 label 部件数量，由 XhExpressionInputLabel 在 setup 里同步登记、卸载时撤销。 */
+  labelCount: Ref<number>;
+  /** 已渲染的 issues 部件数量，决定输入框的描述链引不引用它。 */
+  issuesCount: Ref<number>;
+  /** 输入框是不是多行宿主，由 XhExpressionInputInput 按 as 登记。 */
+  multiline: Ref<boolean>;
+  service: Service<ExpressionInputSchema>;
+  api: ComputedRef<ExpressionInputApi>;
+  inputRef: Ref<ExpressionInputEl | null>;
+  highlightRef: Ref<HTMLElement | null>;
+  positionerRef: Ref<HTMLElement | null>;
+  contentRef: Ref<HTMLElement | null>;
+  /** 当前是否应当渲染：退场动画播完之前仍为真。 */
+  visible: Ref<boolean>;
+  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */
+  portalTarget: ComputedRef<string | Element>;
+}
+declare function useExpressionInput(props: ExpressionInputSchema['props'], handlers?: Pick<ExpressionInputSchema['props'], 'onValueChange' | 'onIssuesChange' | 'onCompletionSelect' | 'onOpenChange'>): ExpressionInputContext;
+//#endregion
+export { ExpressionInputContext, useExpressionInput };
+//# sourceMappingURL=use-expression-input.d.ts.map

package/dist/components/expression-input/use-expression-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-expression-input.d.ts","names":[],"sources":["../../../src/components/expression-input/use-expression-input.ts"],"mappings":";;;;UAoBiB;;EAEf,YAAY;;EAEZ,aAAa;;EAEb,WAAW;EACX,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,UAAU,IAAI;EACd,cAAc,IAAI;EAClB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,mBACd,OAAO,gCACP,WAAU,KAAK,8GACd"}

package/dist/components/expression-input/use-expression-input.js

@@ -0,0 +1,72 @@
+import { useOverlayExit } from "../../runtime/use-overlay-exit.js";
+import { vueNormalize } from "../../runtime/normalize-props.js";
+import { useXhConfig } from "../../config/config.js";
+import { useMachine } from "../../runtime/use-machine.js";
+import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectExpressionInput, expressionInputMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
+import { createRuntimeConfig, createScope } from "@xihan-ui/core";
+import { createPositionEngine } from "@xihan-ui/position";
+//#region src/components/expression-input/use-expression-input.ts
+function useExpressionInput(props, handlers = {}) {
+	const xhConfig = useXhConfig();
+	const inputRef = ref(null);
+	const highlightRef = ref(null);
+	const positionerRef = ref(null);
+	const contentRef = ref(null);
+	const idGen = createVueIdGenerator();
+	const scope = createScope(null, idGen);
+	const labelCount = ref(0);
+	const issuesCount = ref(0);
+	const multiline = ref(false);
+	const service = useMachine(expressionInputMachine, () => ({
+		...props,
+		labelled: labelCount.value > 0,
+		issuesRendered: issuesCount.value > 0,
+		multiline: multiline.value,
+		...handlers
+	}), scope);
+	let config = null;
+	if (typeof document !== "undefined") {
+		config = createRuntimeConfig({
+			scope,
+			idGenerator: idGen
+		});
+		const registerLayer = () => config.layerRegistry.register({
+			kind: "popover",
+			node: () => contentRef.value,
+			branches: () => [inputRef.value, positionerRef.value].filter(Boolean),
+			isModal: () => false,
+			surfaces: () => []
+		});
+		service.refs.set("config", config);
+		service.refs.set("registerLayer", registerLayer);
+		service.refs.set("position", createPositionEngine());
+		service.refs.set("getFloatingEl", () => positionerRef.value);
+		service.refs.set("getInputEl", () => inputRef.value);
+		service.refs.set("getHighlightEl", () => highlightRef.value);
+	}
+	const api = computed(() => connectExpressionInput(service, vueNormalize));
+	return {
+		labelCount,
+		issuesCount,
+		multiline,
+		visible: useOverlayExit({
+			config,
+			isOpen: () => api.value.open,
+			contentRef,
+			onPresence: (presence) => service.refs.set("presence", presence)
+		}),
+		service,
+		api,
+		inputRef,
+		highlightRef,
+		positionerRef,
+		contentRef,
+		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body")
+	};
+}
+//#endregion
+export { useExpressionInput };
+
+//# sourceMappingURL=use-expression-input.js.map

package/dist/components/expression-input/use-expression-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-expression-input.js","names":[],"sources":["../../../src/components/expression-input/use-expression-input.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 expression input 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { ExpressionInputApi, ExpressionInputEl, ExpressionInputSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectExpressionInput, expressionInputMachine } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface ExpressionInputContext {\n  /** 已渲染的 label 部件数量，由 XhExpressionInputLabel 在 setup 里同步登记、卸载时撤销。 */\n  labelCount: Ref<number>\n  /** 已渲染的 issues 部件数量，决定输入框的描述链引不引用它。 */\n  issuesCount: Ref<number>\n  /** 输入框是不是多行宿主，由 XhExpressionInputInput 按 as 登记。 */\n  multiline: Ref<boolean>\n  service: Service<ExpressionInputSchema>\n  api: ComputedRef<ExpressionInputApi>\n  inputRef: Ref<ExpressionInputEl | null>\n  highlightRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useExpressionInput(\n  props: ExpressionInputSchema['props'],\n  handlers: Pick<ExpressionInputSchema['props'], 'onValueChange' | 'onIssuesChange' | 'onCompletionSelect' | 'onOpenChange'> = {},\n): ExpressionInputContext {\n  const xhConfig = useXhConfig()\n  const inputRef = ref<ExpressionInputEl | null>(null)\n  const highlightRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const labelCount = ref(0)\n  const issuesCount = ref(0)\n  const multiline = ref(false)\n  const service = useMachine(expressionInputMachine, () => ({\n    ...props,\n    labelled: labelCount.value > 0,\n    issuesRendered: issuesCount.value > 0,\n    multiline: multiline.value,\n    ...handlers,\n  }), scope)\n\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，实际入栈出栈由机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // 输入框记为本层分支：在里面打字、点击都算层内交互，不该把补全点没\n      branches: () => [inputRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getInputEl', () => inputRef.value)\n    service.refs.set('getHighlightEl', () => highlightRef.value)\n  }\n\n  const api = computed(() => connectExpressionInput(service, vueNormalize))\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { labelCount, issuesCount, multiline, visible, service, api, inputRef, highlightRef, positionerRef, contentRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAuCA,SAAgB,mBACd,OACA,WAA6H,CAAC,GACtG;CACxB,MAAM,WAAW,YAAY;CAC7B,MAAM,WAAW,IAA8B,IAAI;CACnD,MAAM,eAAe,IAAwB,IAAI;CACjD,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,cAAc,IAAI,CAAC;CACzB,MAAM,YAAY,IAAI,KAAK;CAC3B,MAAM,UAAU,WAAW,+BAA+B;EACxD,GAAG;EACH,UAAU,WAAW,QAAQ;EAC7B,gBAAgB,YAAY,QAAQ;EACpC,WAAW,UAAU;EACrB,GAAG;CACL,IAAI,KAAK;CAET,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAEvB,gBAAgB,CAAC,SAAS,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACpE,eAAe;GACf,gBAAgB,CAAC;EACnB,CAAC;EAED,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,oBAAoB,SAAS,KAAK;EACnD,QAAQ,KAAK,IAAI,wBAAwB,aAAa,KAAK;CAC7D;CAEA,MAAM,MAAM,eAAe,uBAAuB,SAAS,YAAY,CAAC;CASxE,OAAO;EAAE;EAAY;EAAa;EAAW,SAR7B,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAGmD;EAAG;EAAS;EAAK;EAAU;EAAc;EAAe;EAAY,cAFlG,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAES;CAAE;AACtI"}

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

@@ -0,0 +1,12 @@
+//#region src/components/field/boundary.d.ts
+/**
+ * 字段边界：子树里的控件不再继承外层字段的标签、说明、状态与控件 id，表单字段组也一并断开。
+ * 组合控件把自己的内部输入（图标选择器里的搜索框、筛选框）包进来，它们就不会被读成外层字段的名字，
+ * 两个封装同处一个字段时也不会拿到同一个 id。本身不渲染节点；浮层内容经 Portal 搬走时已自动断开。
+ */
+declare const XhFieldBoundary: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>[] | undefined, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+export { XhFieldBoundary };
+//# sourceMappingURL=boundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.d.ts","names":[],"sources":["../../../src/components/field/boundary.ts"],"mappings":";;;;;;cAea,+BAAe,wCAAA,oBAAA,4BAAA;;4CAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/field/boundary.js

@@ -0,0 +1,19 @@
+import { clearFieldContext } from "./context.js";
+import { defineComponent } from "vue";
+//#region src/components/field/boundary.ts
+/**
+* 字段边界：子树里的控件不再继承外层字段的标签、说明、状态与控件 id，表单字段组也一并断开。
+* 组合控件把自己的内部输入（图标选择器里的搜索框、筛选框）包进来，它们就不会被读成外层字段的名字，
+* 两个封装同处一个字段时也不会拿到同一个 id。本身不渲染节点；浮层内容经 Portal 搬走时已自动断开。
+*/
+const XhFieldBoundary = defineComponent({
+	name: "XhFieldBoundary",
+	setup(_, { slots }) {
+		clearFieldContext();
+		return () => slots.default?.();
+	}
+});
+//#endregion
+export { XhFieldBoundary };
+
+//# sourceMappingURL=boundary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.js","names":[],"sources":["../../../src/components/field/boundary.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 boundary 相关实现。\n\nimport { defineComponent } from 'vue'\nimport { clearFieldContext } from './context'\n\n/**\n * 字段边界：子树里的控件不再继承外层字段的标签、说明、状态与控件 id，表单字段组也一并断开。\n * 组合控件把自己的内部输入（图标选择器里的搜索框、筛选框）包进来，它们就不会被读成外层字段的名字，\n * 两个封装同处一个字段时也不会拿到同一个 id。本身不渲染节点；浮层内容经 Portal 搬走时已自动断开。\n */\nexport const XhFieldBoundary = defineComponent({\n  name: 'XhFieldBoundary',\n  setup(_, { slots }) {\n    clearFieldContext()\n    return () => slots.default?.()\n  },\n})\n"],"mappings":";;;;;;;;AAeA,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,kBAAkB;EAClB,aAAa,MAAM,UAAU;CAC/B;AACF,CAAC"}

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

@@ -1,6 +1,18 @@
 import { SlotsType, VNode } from "vue";
 //#region src/components/field/field.d.ts
 declare const XhFieldRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 说明文字。不写默认插槽时铺说明部件；需要放置其他内容时改用 description 插槽。 */
+  description: {
+    type: StringConstructor;
+  };
+  /** 错误文案。不写默认插槽时给了（空串也算）就铺错误文案部件，空串时在表单里自取该项的错误。 */
+  errorText: {
+    type: StringConstructor;
+  };
   invalid: {
     type: BooleanConstructor;
     default: undefined;
@@ -23,6 +35,18 @@ declare const XhFieldRoot: import("vue").DefineComponent<import("vue").ExtractPr
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 说明文字。不写默认插槽时铺说明部件；需要放置其他内容时改用 description 插槽。 */
+  description: {
+    type: StringConstructor;
+  };
+  /** 错误文案。不写默认插槽时给了（空串也算）就铺错误文案部件，空串时在表单里自取该项的错误。 */
+  errorText: {
+    type: StringConstructor;
+  };
   invalid: {
     type: BooleanConstructor;
     default: undefined;
@@ -47,15 +71,13 @@ declare const XhFieldRoot: import("vue").DefineComponent<import("vue").ExtractPr
   invalid: boolean;
   disabled: boolean;
   readOnly: boolean;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/**
- * 字段边界：子树里的控件不再继承外层字段的标签、说明、状态与控件 id，表单字段组也一并断开。
- * 组合控件把自己的内部输入（图标选择器里的搜索框、筛选框）包进来，它们就不会被读成外层字段的名字，
- * 两个封装同处一个字段时也不会拿到同一个 id。本身不渲染节点；浮层内容经 Portal 搬走时已自动断开。
- */
-declare const XhFieldBoundary: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
-  [key: string]: any;
-}>[] | undefined, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+  default?: () => VNode[];
+  label?: () => VNode[];
+  control?: () => VNode[];
+  description?: () => VNode[];
+  errorText?: () => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhFieldLabel: 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>;
@@ -99,5 +121,5 @@ declare const XhFieldErrorText: import("vue").DefineComponent<{}, () => VNode<im
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { FieldControlSlotProps, XhFieldBoundary, XhFieldControl, XhFieldDescription, XhFieldErrorText, XhFieldLabel, XhFieldRoot };
+export { FieldControlSlotProps, XhFieldControl, XhFieldDescription, XhFieldErrorText, XhFieldLabel, XhFieldRoot };
 //# sourceMappingURL=field.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"field.d.ts","names":[],"sources":["../../../src/components/field/field.ts"],"mappings":";;cAea,2BAAW,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAgBtB;;;;;;cAOW,+BAAe,0BAAA,oBAAA,4BAAA;;4CAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;KAGU,wBAAwB;cAiBvB,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYb,WAAC,OAAO,0BAA0B;kCAc9C;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":";;cAmBa,2BAAW,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBV,gBAAM;EACR,cAAM;EACJ,gBAAM;EACF,oBAAM;EACR,kBAAM;kCAapB;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAOvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;KAGU,wBAAwB;cAiBvB,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYb,WAAC,OAAO,0BAA0B;kCAgB9C;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAS7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAgB3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/field/field.js

@@ -1,13 +1,22 @@
-import { isRoleMarker, mergeIntoChild } from "../../runtime/as-child.js";
 import { useOptionalFormContext, useOptionalFormField } from "../form/context.js";
-import { clearFieldContext, provideField, useFieldContext } from "./context.js";
+import { provideField, useFieldContext } from "./context.js";
+import { renderStructure } from "../../runtime/structure.js";
+import { withXhConfig } from "../../config/config.js";
+import { isRoleMarker, mergeIntoChild } from "../../runtime/as-child.js";
 import { useFormControlProps } from "../form/use-form-control.js";
-import { useField } from "./use-field.js";
-import { defineComponent, h } from "vue";
+import { useField, useFieldPartPresence } from "./use-field.js";
+import { fieldStructure, hasNamingContent } from "@xihan-ui/headless";
+import { defineComponent, h, ref } from "vue";
 //#region src/components/field/field.ts
 const XhFieldRoot = defineComponent({
 	name: "XhFieldRoot",
 	props: {
+		/** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
+		/** 说明文字。不写默认插槽时铺说明部件；需要放置其他内容时改用 description 插槽。 */
+		description: { type: String },
+		/** 错误文案。不写默认插槽时给了（空串也算）就铺错误文案部件，空串时在表单里自取该项的错误。 */
+		errorText: { type: String },
 		invalid: {
 			type: Boolean,
 			default: void 0
@@ -26,28 +35,27 @@ const XhFieldRoot = defineComponent({
 		},
 		controlId: { type: String }
 	},
+	slots: Object,
 	setup(props, { slots }) {
-		const ctx = useField(useFormControlProps(props));
+		const ctx = useField(withXhConfig("field", useFormControlProps(props)));
 		provideField(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.());
-	}
-});
-/**
-* 字段边界：子树里的控件不再继承外层字段的标签、说明、状态与控件 id，表单字段组也一并断开。
-* 组合控件把自己的内部输入（图标选择器里的搜索框、筛选框）包进来，它们就不会被读成外层字段的名字，
-* 两个封装同处一个字段时也不会拿到同一个 id。本身不渲染节点；浮层内容经 Portal 搬走时已自动断开。
-*/
-const XhFieldBoundary = defineComponent({
-	name: "XhFieldBoundary",
-	setup(_, { slots }) {
-		clearFieldContext();
-		return () => slots.default?.();
+		return () => h("div", ctx.api.value.getRootProps(), slots.default ? slots.default() : renderDefaultStructure({
+			label: props.label,
+			description: props.description,
+			errorText: props.errorText
+		}, {
+			"label": slots.label,
+			"control": slots.control,
+			"description": slots.description,
+			"error-text": slots.errorText
+		}));
 	}
 });
 const XhFieldLabel = defineComponent({
 	name: "XhFieldLabel",
 	setup(_, { slots }) {
 		const ctx = useFieldContext();
+		useFieldPartPresence(ctx, "label");
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -78,6 +86,7 @@ asChild: {
 	slots: Object,
 	setup(props, { slots }) {
 		const ctx = useFieldContext();
+		useFieldPartPresence(ctx, "control");
 		return () => {
 			const controlProps = ctx.api.value.getControlProps();
 			const children = slots.default?.(controlProps) ?? [];
@@ -90,13 +99,19 @@ const XhFieldDescription = defineComponent({
 	name: "XhFieldDescription",
 	setup(_, { slots }) {
 		const ctx = useFieldContext();
-		return () => h("p", ctx.api.value.getDescriptionProps(), slots.default?.());
+		const el = ref(null);
+		useFieldPartPresence(ctx, "description", () => el.value != null && hasNamingContent(el.value));
+		return () => h("p", {
+			...ctx.api.value.getDescriptionProps(),
+			ref: el
+		}, slots.default?.());
 	}
 });
 const XhFieldErrorText = defineComponent({
 	name: "XhFieldErrorText",
 	setup(_, { slots }) {
 		const ctx = useFieldContext();
+		useFieldPartPresence(ctx, "errorText");
 		const form = useOptionalFormContext();
 		const handle = useOptionalFormField();
 		return () => {
@@ -106,7 +121,23 @@ const XhFieldErrorText = defineComponent({
 		};
 	}
 });
+/** 标准结构里各部件对应的组件；控件是出口，原样放作者给的内容。 */
+const FIELD_PARTS = {
+	"label": XhFieldLabel,
+	"description": XhFieldDescription,
+	"error-text": XhFieldErrorText
+};
+/**
+* 未写默认插槽时铺开的整套结构：照 headless 的 fieldStructure 渲，与 Web Components 不写部件时元素生成的节点出自同一份。
+* control 插槽的内容原样放在标题之后；标题、说明、错误文案取文字，或由同名插槽接管。
+*/
+function renderDefaultStructure(text, sections) {
+	return renderStructure(fieldStructure({
+		...text,
+		slotted: (name) => sections[name] != null
+	}), FIELD_PARTS, (node) => node.slot ? sections[node.slot.name]?.() : void 0, {}, () => sections.control?.());
+}
 //#endregion
-export { XhFieldBoundary, XhFieldControl, XhFieldDescription, XhFieldErrorText, XhFieldLabel, XhFieldRoot, wiringOnly };
+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":["/*\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 相关实现。\n\nimport type { SlotsType, VNode } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { isRoleMarker, mergeIntoChild } from '../../runtime/as-child'\nimport { useOptionalFormContext, useOptionalFormField } from '../form/context'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { clearFieldContext, provideField, useFieldContext } from './context'\nimport { useField } from './use-field'\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 },\n  },\n  setup(props, { slots }) {\n    const ctx = useField(useFormControlProps(props))\n    provideField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 字段边界：子树里的控件不再继承外层字段的标签、说明、状态与控件 id，表单字段组也一并断开。\n * 组合控件把自己的内部输入（图标选择器里的搜索框、筛选框）包进来，它们就不会被读成外层字段的名字，\n * 两个封装同处一个字段时也不会拿到同一个 id。本身不渲染节点；浮层内容经 Portal 搬走时已自动断开。\n */\nexport const XhFieldBoundary = defineComponent({\n  name: 'XhFieldBoundary',\n  setup(_, { slots }) {\n    clearFieldContext()\n    return () => 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/**\n * 去掉角色标记，只保留接线属性（id、aria-* 与状态位）。\n *\n * 角色标记含解剖两位与家族标记（data-xh-*）：control 投影了 Field Chrome 的视觉盒标记，\n * 落到薄封装的根上会在封装自己的视觉盒外再画一层壳。\n */\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 (!isRoleMarker(key))\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      // 手工接线必须显式关闭 asChild，不能根据无效结构猜测作者意图。\n      if (!props.asChild)\n        return children\n      return mergeIntoChild(children, controlProps, 'field/control')\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":";;;;;;;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;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAE9C,WAAW,EAAE,MAAM,OAAO;CAC5B;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,SAAS,oBAAoB,KAAK,CAAC;EAC/C,aAAa,GAAG;EAChB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;;;;;;AAOD,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,kBAAkB;EAClB,aAAa,MAAM,UAAU;CAC/B;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;;;;;;;AAWD,SAAgB,WAAW,cAAgE;CACzF,MAAM,OAAgC,CAAC;CACvC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,YAAY,GACpD,IAAI,CAAC,aAAa,GAAG,GACnB,KAAK,OAAO;CAEhB,OAAO;AACT;AAEA,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,OAAO;;;;;;;AAOL,SAAS;EAAE,MAAM;EAAS,SAAS;CAAK,EAC1C;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,gBAAgB;EAC5B,aAAa;GACX,MAAM,eAAe,IAAI,IAAI,MAAM,gBAAgB;GAEnD,MAAM,WAAW,MAAM,UAAU,YAAY,KAAK,CAAC;GAEnD,IAAI,CAAC,MAAM,SACT,OAAO;GACT,OAAO,eAAe,UAAU,cAAc,eAAe;EAC/D;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":["/*\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 相关实现。\n\nimport type { FieldStructureOptions } from '@xihan-ui/headless'\nimport type { SlotsType, VNode } from 'vue'\nimport { fieldStructure, hasNamingContent } from '@xihan-ui/headless'\nimport { defineComponent, h, ref } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { isRoleMarker, mergeIntoChild } from '../../runtime/as-child'\nimport { renderStructure } from '../../runtime/structure'\nimport { useOptionalFormContext, useOptionalFormField } from '../form/context'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideField, useFieldContext } from './context'\nimport { useField, useFieldPartPresence } from './use-field'\n\nexport const XhFieldRoot = defineComponent({\n  name: 'XhFieldRoot',\n  // 三个布尔缺省 undefined：在 XhFormFieldGroup 里没写就从表单上下文自取，写了以写的为准\n  props: {\n    /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    /** 说明文字。不写默认插槽时铺说明部件；需要放置其他内容时改用 description 插槽。 */\n    description: { type: String },\n    /** 错误文案。不写默认插槽时给了（空串也算）就铺错误文案部件，空串时在表单里自取该项的错误。 */\n    errorText: { type: String },\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 },\n  },\n  slots: Object as SlotsType<{\n    default?: () => VNode[]\n    label?: () => VNode[]\n    control?: () => VNode[]\n    description?: () => VNode[]\n    errorText?: () => VNode[]\n  }>,\n  setup(props, { slots }) {\n    // 字段集压下来的作用域禁用也落到字段上：标题与说明随组内控件一起变淡\n    const ctx = useField(withXhConfig('field', useFormControlProps(props)))\n    provideField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default\n      ? slots.default()\n      : renderDefaultStructure(\n          { label: props.label, description: props.description, errorText: props.errorText },\n          { 'label': slots.label, 'control': slots.control, 'description': slots.description, 'error-text': slots.errorText },\n        ))\n  },\n})\n\nexport const XhFieldLabel = defineComponent({\n  name: 'XhFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    useFieldPartPresence(ctx, 'label')\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/**\n * 去掉角色标记，只保留接线属性（id、aria-* 与状态位）。\n *\n * 角色标记含解剖两位与家族标记（data-xh-*）：control 投影了 Field Chrome 的视觉盒标记，\n * 落到薄封装的根上会在封装自己的视觉盒外再画一层壳。\n */\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 (!isRoleMarker(key))\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    // control 在场：label 的 for 指向它；不在场时由字段代为聚焦库内控件\n    useFieldPartPresence(ctx, 'control')\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      // 手工接线必须显式关闭 asChild，不能根据无效结构猜测作者意图。\n      if (!props.asChild)\n        return children\n      return mergeIntoChild(children, controlProps, 'field/control')\n    }\n  },\n})\n\nexport const XhFieldDescription = defineComponent({\n  name: 'XhFieldDescription',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    const el = ref<HTMLElement | null>(null)\n    // 读不出一句话的说明不进描述链\n    useFieldPartPresence(ctx, 'description', () => el.value != null && hasNamingContent(el.value))\n    return () => h('p', { ...ctx.api.value.getDescriptionProps() as Record<string, unknown>, ref: el }, slots.default?.())\n  },\n})\n\nexport const XhFieldErrorText = defineComponent({\n  name: 'XhFieldErrorText',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    useFieldPartPresence(ctx, 'errorText')\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\n/** 标准结构里各部件对应的组件；控件是出口，原样放作者给的内容。 */\nconst FIELD_PARTS = {\n  'label': XhFieldLabel,\n  'description': XhFieldDescription,\n  'error-text': XhFieldErrorText,\n}\n\ntype FieldSectionSlots = Readonly<Partial<Record<'label' | 'control' | 'description' | 'error-text', () => VNode[]>>>\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 fieldStructure 渲，与 Web Components 不写部件时元素生成的节点出自同一份。\n * control 插槽的内容原样放在标题之后；标题、说明、错误文案取文字，或由同名插槽接管。\n */\nfunction renderDefaultStructure(text: Pick<FieldStructureOptions, 'label' | 'description' | 'errorText'>, sections: FieldSectionSlots): VNode[] {\n  const nodes = fieldStructure({ ...text, slotted: name => sections[name as keyof FieldSectionSlots] != null })\n  return renderStructure(\n    nodes,\n    FIELD_PARTS,\n    node => (node.slot ? sections[node.slot.name as keyof FieldSectionSlots]?.() : undefined),\n    {},\n    () => sections.control?.(),\n  )\n}\n"],"mappings":"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"}

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

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

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

@@ -1,5 +1,6 @@
 import { useOptionalFieldContext } from "./context.js";
 import { wiringOnly } from "./field.js";
+import { fieldControlWiring, fieldGroupAttrs, fieldStateAttrs, withFieldLabel } from "@xihan-ui/headless";
 import { computed } from "vue";
 //#region src/components/field/use-field-control.ts
 /**
@@ -33,18 +34,7 @@ function useFieldControl() {
 */
 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;
-	});
+	return computed(() => ctx ? fieldStateAttrs(fieldControlWiring(ctx.api.value)) : {});
 }
 /**
 * 组类控件（单选组、复选框组、滑块、评分、分格输入……）只取字段的描述链。
@@ -54,10 +44,7 @@ function useFieldStateWiring() {
 */
 function useFieldGroupWiring() {
 	const ctx = useOptionalFieldContext();
-	return computed(() => {
-		const describedBy = ctx ? ctx.api.value.getControlProps()["aria-describedby"] : void 0;
-		return describedBy === void 0 ? {} : { "aria-describedby": describedBy };
-	});
+	return computed(() => ctx ? fieldGroupAttrs(fieldControlWiring(ctx.api.value)) : {});
 }
 /**
 * 把字段标签的 id 并入该份属性中的名字链，供库自身的薄封装包在渲染属性外面。
@@ -73,15 +60,8 @@ function useFieldGroupWiring() {
 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
-			};
-		};
+		const labelId = ctx ? fieldControlWiring(ctx.api.value).labelId : void 0;
+		return (props) => withFieldLabel(props, labelId);
 	});
 }
 //#endregion

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":["/*\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 * 组类控件（单选组、复选框组、滑块、评分、分格输入……）只取字段的描述链。\n *\n * 焦点宿主是组根、拇指或格子，名字由 useFieldLabelWiring 并入；校验、必填与只读由组件按字段状态\n * 自己投影（role=group 不接受 aria-invalid / aria-required，组件的 connect 也只在支持它们的角色上发）。\n */\nexport function useFieldGroupWiring(): ComputedRef<Record<string, unknown>> {\n  const ctx = useOptionalFieldContext()\n  return computed(() => {\n    const describedBy = ctx ? (ctx.api.value.getControlProps() as Record<string, unknown>)['aria-describedby'] : undefined\n    return describedBy === undefined ? {} : { 'aria-describedby': describedBy }\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;;;;;;;AAQA,SAAgB,sBAA4D;CAC1E,MAAM,MAAM,wBAAwB;CACpC,OAAO,eAAe;EACpB,MAAM,cAAc,MAAO,IAAI,IAAI,MAAM,gBAAgB,CAAC,CAA6B,sBAAsB,KAAA;EAC7G,OAAO,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,oBAAoB,YAAY;CAC5E,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 { fieldControlWiring, fieldGroupAttrs, fieldStateAttrs, withFieldLabel } from '@xihan-ui/headless'\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(() => (ctx ? fieldStateAttrs(fieldControlWiring(ctx.api.value)) : {}))\n}\n\n/**\n * 组类控件（单选组、复选框组、滑块、评分、分格输入……）只取字段的描述链。\n *\n * 焦点宿主是组根、拇指或格子，名字由 useFieldLabelWiring 并入；校验、必填与只读由组件按字段状态\n * 自己投影（role=group 不接受 aria-invalid / aria-required，组件的 connect 也只在支持它们的角色上发）。\n */\nexport function useFieldGroupWiring(): ComputedRef<Record<string, unknown>> {\n  const ctx = useOptionalFieldContext()\n  return computed(() => (ctx ? fieldGroupAttrs(fieldControlWiring(ctx.api.value)) : {}))\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 ? fieldControlWiring(ctx.api.value).labelId : undefined\n    return (props: Record<string, unknown>) => withFieldLabel(props, labelId)\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;AAuBA,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,eAAgB,MAAM,gBAAgB,mBAAmB,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,CAAE;AACvF;;;;;;;AAQA,SAAgB,sBAA4D;CAC1E,MAAM,MAAM,wBAAwB;CACpC,OAAO,eAAgB,MAAM,gBAAgB,mBAAmB,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,CAAE;AACvF;;;;;;;;;;;;AAaA,SAAgB,sBAAgG;CAC9G,MAAM,MAAM,wBAAwB;CACpC,OAAO,eAAe;EACpB,MAAM,UAAU,MAAM,mBAAmB,IAAI,IAAI,KAAK,CAAC,CAAC,UAAU,KAAA;EAClE,QAAQ,UAAmC,eAAe,OAAO,OAAO;CAC1E,CAAC;AACH"}

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

@@ -1,10 +1,14 @@
+import { FieldApi, FieldProps, FieldRenderedParts } from "@xihan-ui/headless";
 import { ComputedRef } from "vue";
-import { FieldApi, FieldProps } from "@xihan-ui/headless";
 //#region src/components/field/use-field.d.ts
+/** 字段里登记在场的部件名。 */
+type FieldPartName = keyof FieldRenderedParts;
 interface FieldContext {
   api: ComputedRef<FieldApi>;
+  /** 已挂载的 label / description / error-text 各几个，由部件自行登记。 */
+  partCounts: Record<FieldPartName, number>;
 }
 declare function useField(props: FieldProps): FieldContext;
 //#endregion
-export { FieldContext, useField };
+export { FieldContext, FieldPartName, useField };
 //# sourceMappingURL=use-field.d.ts.map

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":";;;UAeiB;EACf,KAAK,YAAY;;iBAIH,SAAS,OAAO,aAAa"}
+{"version":3,"file":"use-field.d.ts","names":[],"sources":["../../../src/components/field/use-field.ts"],"mappings":";;;;KAgBY,sBAAsB;UAEjB;EACf,KAAK,YAAY;;EAEjB,YAAY,OAAO;;iBAIL,SAAS,OAAO,aAAa"}

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

@@ -1,14 +1,55 @@
 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 { computed, onBeforeUnmount, onMounted, onUpdated, reactive, ref } from "vue";
+import { createScope } from "@xihan-ui/core";
 //#region src/components/field/use-field.ts
 function useField(props) {
 	const scope = createScope(null, createVueIdGenerator());
-	return { api: computed(() => connectField(props, scope, vueNormalize)) };
+	const partCounts = reactive({
+		label: 0,
+		description: 0,
+		errorText: 0,
+		control: 0
+	});
+	const mounted = ref(false);
+	onMounted(() => {
+		mounted.value = true;
+	});
+	const parts = computed(() => mounted.value ? {
+		label: partCounts.label > 0,
+		description: partCounts.description > 0,
+		errorText: partCounts.errorText > 0,
+		control: partCounts.control > 0
+	} : void 0);
+	return {
+		api: computed(() => connectField({
+			...props,
+			parts: parts.value
+		}, scope, vueNormalize)),
+		partCounts
+	};
+}
+/**
+* 部件挂载期间登记在场，卸载时撤销；present 给出时每次渲染后现判（说明没有文字时不算在场）。
+* 控件的名字链与描述链只收登记在场的部件 id。
+*/
+function useFieldPartPresence(ctx, part, present = () => true) {
+	let counted = false;
+	const sync = () => {
+		const next = present();
+		if (next === counted) return;
+		ctx.partCounts[part] += next ? 1 : -1;
+		counted = next;
+	};
+	onMounted(sync);
+	onUpdated(sync);
+	onBeforeUnmount(() => {
+		if (counted) ctx.partCounts[part]--;
+		counted = false;
+	});
 }
 //#endregion
-export { useField };
+export { useField, useFieldPartPresence };
 
 //# sourceMappingURL=use-field.js.map

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":["/*\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"}
+{"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, FieldRenderedParts } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectField } from '@xihan-ui/headless'\nimport { computed, onBeforeUnmount, onMounted, onUpdated, reactive, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\n/** 字段里登记在场的部件名。 */\nexport type FieldPartName = keyof FieldRenderedParts\n\nexport interface FieldContext {\n  api: ComputedRef<FieldApi>\n  /** 已挂载的 label / description / error-text 各几个，由部件自行登记。 */\n  partCounts: Record<FieldPartName, number>\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 partCounts = reactive<Record<FieldPartName, number>>({ label: 0, description: 0, errorText: 0, control: 0 })\n  // 挂载前（含服务端直出）不知道部件在不在场，按在场处理；子部件先于根挂载，根挂载时登记已齐\n  const mounted = ref(false)\n  onMounted(() => {\n    mounted.value = true\n  })\n  const parts = computed<FieldRenderedParts | undefined>(() => mounted.value\n    ? { label: partCounts.label > 0, description: partCounts.description > 0, errorText: partCounts.errorText > 0, control: partCounts.control > 0 }\n    : undefined)\n  const api = computed(() => connectField({ ...props, parts: parts.value }, scope, vueNormalize))\n  return { api, partCounts }\n}\n\n/**\n * 部件挂载期间登记在场，卸载时撤销；present 给出时每次渲染后现判（说明没有文字时不算在场）。\n * 控件的名字链与描述链只收登记在场的部件 id。\n */\nexport function useFieldPartPresence(ctx: FieldContext, part: FieldPartName, present: () => boolean = () => true): void {\n  let counted = false\n  const sync = (): void => {\n    const next = present()\n    if (next === counted)\n      return\n    ctx.partCounts[part] += next ? 1 : -1\n    counted = next\n  }\n  onMounted(sync)\n  onUpdated(sync)\n  onBeforeUnmount(() => {\n    if (counted)\n      ctx.partCounts[part]--\n    counted = false\n  })\n}\n"],"mappings":";;;;;;AAyBA,SAAgB,SAAS,OAAiC;CAExD,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,aAAa,SAAwC;EAAE,OAAO;EAAG,aAAa;EAAG,WAAW;EAAG,SAAS;CAAE,CAAC;CAEjH,MAAM,UAAU,IAAI,KAAK;CACzB,gBAAgB;EACd,QAAQ,QAAQ;CAClB,CAAC;CACD,MAAM,QAAQ,eAA+C,QAAQ,QACjE;EAAE,OAAO,WAAW,QAAQ;EAAG,aAAa,WAAW,cAAc;EAAG,WAAW,WAAW,YAAY;EAAG,SAAS,WAAW,UAAU;CAAE,IAC7I,KAAA,CAAS;CAEb,OAAO;EAAE,KADG,eAAe,aAAa;GAAE,GAAG;GAAO,OAAO,MAAM;EAAM,GAAG,OAAO,YAAY,CAClF;EAAG;CAAW;AAC3B;;;;;AAMA,SAAgB,qBAAqB,KAAmB,MAAqB,gBAA+B,MAAY;CACtH,IAAI,UAAU;CACd,MAAM,aAAmB;EACvB,MAAM,OAAO,QAAQ;EACrB,IAAI,SAAS,SACX;EACF,IAAI,WAAW,SAAS,OAAO,IAAI;EACnC,UAAU;CACZ;CACA,UAAU,IAAI;CACd,UAAU,IAAI;CACd,sBAAsB;EACpB,IAAI,SACF,IAAI,WAAW,KAAK;EACtB,UAAU;CACZ,CAAC;AACH"}

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

@@ -1,6 +1,6 @@
 import { FieldArrayContext } from "./use-field-array.js";
-import { ComputedRef } from "vue";
 import { FieldArrayItemProps } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/field-array/context.d.ts
 /** 行声明的下标，供 item-content / item-action 与三个操作按钮复用同一份声明。 */
 interface FieldArrayItemContext {