@xihan-ui/vue 1.0.0 → 2.0.0

package/dist/components/editable/editable.js.map

@@ -1 +1 @@
-{"version":3,"file":"editable.js","names":[],"sources":["../../../src/components/editable/editable.ts"],"sourcesContent":["import type { EditableActivationMode, EditableApi, EditableSchema, EditableSubmitMode } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { provideEditable, useEditableContext } from './context'\nimport { useEditable } from './use-editable'\n\ntype EditableProps = EditableSchema['props']\n\n/** 默认插槽的载荷：当下的值与预览文字、编辑态，以及写值、进入编辑、提交、撤销的命令。 */\nexport type EditableRootSlotProps = Pick<\n  EditableApi,\n  'value' | 'displayValue' | 'editing' | 'empty' | 'setValue' | 'edit' | 'submit' | 'cancel'\n>\n\nexport const XhEditableRoot = defineComponent({\n  name: 'XhEditableRoot',\n  // 缺省值由 connect 与机器给出，这里一律 default: undefined\n  props: {\n    value: { type: String, default: undefined },\n    defaultValue: { type: String, default: undefined },\n    edit: { type: Boolean, default: undefined },\n    defaultEdit: Boolean,\n    placeholder: { type: String, default: undefined },\n    disabled: Boolean,\n    readOnly: Boolean,\n    invalid: Boolean,\n    maxLength: { type: Number, default: undefined },\n    name: { type: String, default: undefined },\n    submitMode: { type: String as PropType<EditableSubmitMode>, default: undefined },\n    activationMode: { type: String as PropType<EditableActivationMode>, default: undefined },\n    selectOnFocus: { type: Boolean, default: undefined },\n    autoResize: Boolean,\n  },\n  // value-change / edit-change 携带 details，update:* 携带裸值；提交与撤销只有语义事件\n  emits: {\n    'value-change': (_details: PayloadOf<EditableProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<EditableProps, 'onValueChange'>['value']) => true,\n    'value-commit': (_details: PayloadOf<EditableProps, 'onValueCommit'>) => true,\n    'value-revert': (_details: PayloadOf<EditableProps, 'onValueRevert'>) => true,\n    'edit-change': (_details: PayloadOf<EditableProps, 'onEditChange'>) => true,\n    'update:edit': (_edit: PayloadOf<EditableProps, 'onEditChange'>['edit']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: EditableRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useEditable(props as EditableProps, {\n      onValueChange: (details) => {\n        emit('value-change', details)\n        emit('update:value', details.value)\n      },\n      onValueCommit: details => emit('value-commit', details),\n      onValueRevert: details => emit('value-revert', details),\n      onEditChange: (details) => {\n        emit('edit-change', details)\n        emit('update:edit', details.edit)\n      },\n    })\n    provideEditable(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      displayValue: ctx.api.value.displayValue,\n      editing: ctx.api.value.editing,\n      empty: ctx.api.value.empty,\n      setValue: ctx.api.value.setValue,\n      edit: ctx.api.value.edit,\n      submit: ctx.api.value.submit,\n      cancel: ctx.api.value.cancel,\n    }))\n  },\n})\n\nexport const XhEditableLabel = defineComponent({\n  name: 'XhEditableLabel',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditableArea = defineComponent({\n  name: 'XhEditableArea',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('div', ctx.api.value.getAreaProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditablePreview = defineComponent({\n  name: 'XhEditablePreview',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    // 有插槽用插槽，否则显示当前值，值为空时显示 placeholder\n    return () => h(\n      'span',\n      { ...ctx.api.value.getPreviewProps() as Record<string, unknown>, ref: ctx.previewRef },\n      slots.default?.() ?? ctx.api.value.displayValue,\n    )\n  },\n})\n\nexport const XhEditableInput = defineComponent({\n  name: 'XhEditableInput',\n  setup() {\n    const ctx = useEditableContext()\n    return () => h('input', { ...ctx.api.value.getInputProps() as Record<string, unknown>, ref: ctx.inputRef })\n  },\n})\n\nexport const XhEditableEditTrigger = defineComponent({\n  name: 'XhEditableEditTrigger',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('button', ctx.api.value.getEditTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditableSubmitTrigger = defineComponent({\n  name: 'XhEditableSubmitTrigger',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('button', ctx.api.value.getSubmitTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditableCancelTrigger = defineComponent({\n  name: 'XhEditableCancelTrigger',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('button', ctx.api.value.getCancelTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditableControl = defineComponent({\n  name: 'XhEditableControl',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"editable.js","names":[],"sources":["../../../src/components/editable/editable.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// 提供 editable 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { EditableActivationMode, EditableApi, EditableSchema, EditableSubmitMode } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideEditable, useEditableContext } from './context'\nimport { useEditable } from './use-editable'\n\ntype EditableProps = EditableSchema['props']\n\n/** 默认插槽的载荷：当前的值与预览文字、编辑态，以及写值、进入编辑、提交、撤销的命令。 */\nexport type EditableRootSlotProps = Pick<\n  EditableApi,\n  'value' | 'displayValue' | 'editing' | 'empty' | 'setValue' | 'edit' | 'submit' | 'cancel'\n>\n\nexport const XhEditableRoot = defineComponent({\n  name: 'XhEditableRoot',\n  // 缺省值由 connect 与机器给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    value: { type: String },\n    defaultValue: { type: String },\n    edit: { type: Boolean, default: undefined },\n    defaultEdit: Boolean,\n    placeholder: { type: String },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    maxLength: { type: Number },\n    name: { type: String },\n    submitMode: { type: String as PropType<EditableSubmitMode> },\n    activationMode: { type: String as PropType<EditableActivationMode> },\n    selectOnFocus: { type: Boolean, default: undefined },\n    autoResize: Boolean,\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // value-change / edit-change 携带 details，update:* 携带裸值；提交与撤销只有语义事件\n  emits: {\n    'value-change': (_details: PayloadOf<EditableProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<EditableProps, 'onValueChange'>['value']) => true,\n    'value-commit': (_details: PayloadOf<EditableProps, 'onValueCommit'>) => true,\n    'value-revert': (_details: PayloadOf<EditableProps, 'onValueRevert'>) => true,\n    'edit-change': (_details: PayloadOf<EditableProps, 'onEditChange'>) => true,\n    'update:edit': (_edit: PayloadOf<EditableProps, 'onEditChange'>['edit']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: EditableRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useEditable(useFormControlProps(props) as EditableProps, {\n      onValueChange: (details) => {\n        emit('value-change', details)\n        emit('update:value', details.value)\n      },\n      onValueCommit: details => emit('value-commit', details),\n      onValueRevert: details => emit('value-revert', details),\n      onEditChange: (details) => {\n        emit('edit-change', details)\n        emit('update:edit', details.edit)\n      },\n    })\n    provideEditable(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      displayValue: ctx.api.value.displayValue,\n      editing: ctx.api.value.editing,\n      empty: ctx.api.value.empty,\n      setValue: ctx.api.value.setValue,\n      edit: ctx.api.value.edit,\n      submit: ctx.api.value.submit,\n      cancel: ctx.api.value.cancel,\n    }))\n  },\n})\n\nexport const XhEditableLabel = defineComponent({\n  name: 'XhEditableLabel',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditablePreview = defineComponent({\n  name: 'XhEditablePreview',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    // 有插槽用插槽，否则显示当前值，值为空时显示 placeholder\n    return () => h(\n      'span',\n      { ...ctx.api.value.getPreviewProps() as Record<string, unknown>, ref: ctx.previewRef },\n      slots.default?.() ?? ctx.api.value.displayValue,\n    )\n  },\n})\n\nexport const XhEditableInput = defineComponent({\n  name: 'XhEditableInput',\n  setup() {\n    const ctx = useEditableContext()\n    return () => h('input', { ...ctx.api.value.getInputProps() as Record<string, unknown>, ref: ctx.inputRef })\n  },\n})\n\nexport const XhEditableEditTrigger = defineComponent({\n  name: 'XhEditableEditTrigger',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('button', ctx.api.value.getEditTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditableSubmitTrigger = defineComponent({\n  name: 'XhEditableSubmitTrigger',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('button', ctx.api.value.getSubmitTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditableCancelTrigger = defineComponent({\n  name: 'XhEditableCancelTrigger',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('button', ctx.api.value.getCancelTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEditableControl = defineComponent({\n  name: 'XhEditableControl',\n  setup(_, { slots }) {\n    const ctx = useEditableContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 import { ComputedRef, Ref } from "vue";
+import { Service } from "@xihan-ui/core";
 import { EditableApi, EditableSchema } from "@xihan-ui/headless";
-import { Service } from "@xihan-ui/machine";
 //#region src/components/editable/use-editable.d.ts
 type Props = EditableSchema['props'];
 interface EditableCallbacks {
@@ -11,11 +11,11 @@ interface EditableCallbacks {
 }
 interface EditableContext {
   api: ComputedRef<EditableApi>;
-  /** 机器实例，供部件上报 DOM 侧的事实。 */
+  /** 状态机实例，供部件上报 DOM 侧的事实。 */
   service: Service<EditableSchema>;
-  /** 输入框节点，进编辑态后焦点搬进它。 */
+  /** 输入框节点，进入编辑态后焦点移入它。 */
   inputRef: Ref<HTMLElement | null>;
-  /** 预览区节点，退出编辑态后焦点还给它。 */
+  /** 预览区节点，退出编辑态后焦点交还给它。 */
   previewRef: Ref<HTMLElement | null>;
 }
 declare function useEditable(props: Props, callbacks?: EditableCallbacks): EditableContext;

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

@@ -1 +1 @@
-{"version":3,"file":"use-editable.d.ts","names":[],"sources":["../../../src/components/editable/use-editable.ts"],"mappings":";;;;KAUK,QAAQ;UAEI;EACf,gBAAgB;EAChB,gBAAgB;EAChB,gBAAgB;EAChB,eAAe;;UAGA;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;EAEjB,UAAU,IAAI;;EAEd,YAAY,IAAI;;iBAGF,YAAY,OAAO,OAAO,YAAW,oBAAyB"}
+{"version":3,"file":"use-editable.d.ts","names":[],"sources":["../../../src/components/editable/use-editable.ts"],"mappings":";;;;KAiBK,QAAQ;UAEI;EACf,gBAAgB;EAChB,gBAAgB;EAChB,gBAAgB;EAChB,eAAe;;UAGA;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;EAEjB,UAAU,IAAI;;EAEd,YAAY,IAAI;;iBAGF,YAAY,OAAO,OAAO,YAAW,oBAAyB"}

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

@@ -2,8 +2,8 @@ import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
 import { computed, ref } from "vue";
+import { createScope } from "@xihan-ui/core";
 import { connectEditable, editableMachine } from "@xihan-ui/headless";
-import { createScope } from "@xihan-ui/kernel";
 //#region src/components/editable/use-editable.ts
 function useEditable(props, callbacks = {}) {
 	const inputRef = ref(null);

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

@@ -1 +1 @@
-{"version":3,"file":"use-editable.js","names":[],"sources":["../../../src/components/editable/use-editable.ts"],"sourcesContent":["import type { EditableApi, EditableSchema } from '@xihan-ui/headless'\nimport type { Service } from '@xihan-ui/machine'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectEditable, editableMachine } from '@xihan-ui/headless'\nimport { createScope } from '@xihan-ui/kernel'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\ntype Props = EditableSchema['props']\n\nexport interface EditableCallbacks {\n  onValueChange?: Props['onValueChange']\n  onValueCommit?: Props['onValueCommit']\n  onValueRevert?: Props['onValueRevert']\n  onEditChange?: Props['onEditChange']\n}\n\nexport interface EditableContext {\n  api: ComputedRef<EditableApi>\n  /** 机器实例，供部件上报 DOM 侧的事实。 */\n  service: Service<EditableSchema>\n  /** 输入框节点，进编辑态后焦点搬进它。 */\n  inputRef: Ref<HTMLElement | null>\n  /** 预览区节点，退出编辑态后焦点还给它。 */\n  previewRef: Ref<HTMLElement | null>\n}\n\nexport function useEditable(props: Props, callbacks: EditableCallbacks = {}): EditableContext {\n  const inputRef = ref<HTMLElement | null>(null)\n  const previewRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(editableMachine, () => ({ ...props, ...callbacks }), scope)\n\n  // 传 getter 而非节点，进出编辑态时由机器现取\n  service.refs.set('getInputEl', () => inputRef.value)\n  service.refs.set('getPreviewEl', () => previewRef.value)\n\n  const api = computed(() => connectEditable(service, vueNormalize))\n  return { api, service, inputRef, previewRef }\n}\n"],"mappings":";;;;;;;AA6BA,SAAgB,YAAY,OAAc,YAA+B,CAAC,GAAoB;CAC5F,MAAM,WAAW,IAAwB,IAAI;CAC7C,MAAM,aAAa,IAAwB,IAAI;CAI/C,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO,GAAG;CAAU,IAD9D,YAAY,MADZ,qBACsB,CACgD,CAAC;CAGrF,QAAQ,KAAK,IAAI,oBAAoB,SAAS,KAAK;CACnD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CAGvD,OAAO;EAAE,KADG,eAAe,gBAAgB,SAAS,YAAY,CACrD;EAAG;EAAS;EAAU;CAAW;AAC9C"}
+{"version":3,"file":"use-editable.js","names":[],"sources":["../../../src/components/editable/use-editable.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 editable 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { EditableApi, EditableSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectEditable, editableMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\ntype Props = EditableSchema['props']\n\nexport interface EditableCallbacks {\n  onValueChange?: Props['onValueChange']\n  onValueCommit?: Props['onValueCommit']\n  onValueRevert?: Props['onValueRevert']\n  onEditChange?: Props['onEditChange']\n}\n\nexport interface EditableContext {\n  api: ComputedRef<EditableApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实。 */\n  service: Service<EditableSchema>\n  /** 输入框节点，进入编辑态后焦点移入它。 */\n  inputRef: Ref<HTMLElement | null>\n  /** 预览区节点，退出编辑态后焦点交还给它。 */\n  previewRef: Ref<HTMLElement | null>\n}\n\nexport function useEditable(props: Props, callbacks: EditableCallbacks = {}): EditableContext {\n  const inputRef = ref<HTMLElement | null>(null)\n  const previewRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(editableMachine, () => ({ ...props, ...callbacks }), scope)\n\n  // 传 getter 而非节点，进出编辑态时由机器现取\n  service.refs.set('getInputEl', () => inputRef.value)\n  service.refs.set('getPreviewEl', () => previewRef.value)\n\n  const api = computed(() => connectEditable(service, vueNormalize))\n  return { api, service, inputRef, previewRef }\n}\n"],"mappings":";;;;;;;AAoCA,SAAgB,YAAY,OAAc,YAA+B,CAAC,GAAoB;CAC5F,MAAM,WAAW,IAAwB,IAAI;CAC7C,MAAM,aAAa,IAAwB,IAAI;CAI/C,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO,GAAG;CAAU,IAD9D,YAAY,MADZ,qBACsB,CACgD,CAAC;CAGrF,QAAQ,KAAK,IAAI,oBAAoB,SAAS,KAAK;CACnD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CAGvD,OAAO;EAAE,KADG,eAAe,gBAAgB,SAAS,YAAY,CACrD;EAAG;EAAS;EAAU;CAAW;AAC9C"}

package/dist/components/empty-state/context.js.map

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

package/dist/components/empty-state/empty-state.d.ts

@@ -1,32 +1,41 @@
 import { PropType } from "vue";
-import { EmptyStateLive } from "@xihan-ui/headless";
+import { Tone } from "@xihan-ui/core";
+import { EmptyStateLive, EmptyStateStatus } from "@xihan-ui/headless";
 //#region src/components/empty-state/empty-state.d.ts
-/** 根节点渲染为 div，缺省值由 connect 给出，这里一律 default: undefined */
+/** 根节点渲染为 div，默认值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined */
 declare const XhEmptyStateRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   size: {
     type: PropType<"sm" | "md" | "lg">;
-    default: undefined;
   };
   live: {
     type: PropType<EmptyStateLive>;
-    default: undefined;
+  };
+  status: {
+    type: PropType<EmptyStateStatus>;
+  };
+  tone: {
+    type: PropType<Tone>;
   };
 }>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   size: {
     type: PropType<"sm" | "md" | "lg">;
-    default: undefined;
   };
   live: {
     type: PropType<EmptyStateLive>;
-    default: undefined;
   };
-}>> & Readonly<{}>, {
-  size: "sm" | "md" | "lg";
-  live: EmptyStateLive;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhEmptyStateIcon: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  status: {
+    type: PropType<EmptyStateStatus>;
+  };
+  tone: {
+    type: PropType<Tone>;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhEmptyStateMedia: 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 XhEmptyStateIndicator: 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 XhEmptyStateTitle: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
@@ -39,5 +48,5 @@ declare const XhEmptyStateAction: import("vue").DefineComponent<{}, () => import
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { XhEmptyStateAction, XhEmptyStateDescription, XhEmptyStateIcon, XhEmptyStateRoot, XhEmptyStateTitle };
+export { XhEmptyStateAction, XhEmptyStateDescription, XhEmptyStateIndicator, XhEmptyStateMedia, XhEmptyStateRoot, XhEmptyStateTitle };
 //# sourceMappingURL=empty-state.d.ts.map

package/dist/components/empty-state/empty-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"empty-state.d.ts","names":[],"sources":["../../../src/components/empty-state/empty-state.ts"],"mappings":";;;;cAQa,gCAAgB,8BAAA;;IAGD,MAAA;;;;IACA,MAAA,SAAS;;;;;;;IADT,MAAA;;;;IACA,MAAA,SAAS;;;;;;qCAOnC;cAGW,gCAAgB,wCAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,iCAAiB,wCAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,wCAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,kCAAkB,wCAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"empty-state.d.ts","names":[],"sources":["../../../src/components/empty-state/empty-state.ts"],"mappings":";;;;;cAgBa,gCAAgB,8BAAA;;IAGD,MAAA;;;IACA,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACX,MAAA,SAAS;;;;;;IAHT,MAAA;;;IACA,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACX,MAAA,SAAS;;MAOnC,oDAAA;cAGW,iCAAiB,wCAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,qCAAqB,wCAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,iCAAiB,wCAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,wCAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,kCAAkB,wCAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/empty-state/empty-state.js

@@ -3,18 +3,14 @@ import { provideEmptyState, useEmptyStateContext } from "./context.js";
 import { useEmptyState } from "./use-empty-state.js";
 import { defineComponent, h } from "vue";
 //#region src/components/empty-state/empty-state.ts
-/** 根节点渲染为 div，缺省值由 connect 给出，这里一律 default: undefined */
+/** 根节点渲染为 div，默认值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined */
 const XhEmptyStateRoot = defineComponent({
 	name: "XhEmptyStateRoot",
 	props: {
-		size: {
-			type: String,
-			default: void 0
-		},
-		live: {
-			type: String,
-			default: void 0
-		}
+		size: { type: String },
+		live: { type: String },
+		status: { type: String },
+		tone: { type: String }
 	},
 	setup(props, { slots }) {
 		const ctx = useEmptyState(withXhConfig("empty-state", props));
@@ -22,11 +18,18 @@ const XhEmptyStateRoot = defineComponent({
 		return () => h("div", ctx.api.value.getRootProps(), slots.default?.());
 	}
 });
-const XhEmptyStateIcon = defineComponent({
-	name: "XhEmptyStateIcon",
+const XhEmptyStateMedia = defineComponent({
+	name: "XhEmptyStateMedia",
 	setup(_, { slots }) {
 		const ctx = useEmptyStateContext();
-		return () => h("span", ctx.api.value.getIconProps(), slots.default?.());
+		return () => h("div", ctx.api.value.getMediaProps(), slots.default?.());
+	}
+});
+const XhEmptyStateIndicator = defineComponent({
+	name: "XhEmptyStateIndicator",
+	setup(_, { slots }) {
+		const ctx = useEmptyStateContext();
+		return () => h("span", ctx.api.value.getIndicatorProps(), slots.default?.());
 	}
 });
 const XhEmptyStateTitle = defineComponent({
@@ -51,6 +54,6 @@ const XhEmptyStateAction = defineComponent({
 	}
 });
 //#endregion
-export { XhEmptyStateAction, XhEmptyStateDescription, XhEmptyStateIcon, XhEmptyStateRoot, XhEmptyStateTitle };
+export { XhEmptyStateAction, XhEmptyStateDescription, XhEmptyStateIndicator, XhEmptyStateMedia, XhEmptyStateRoot, XhEmptyStateTitle };
 
 //# sourceMappingURL=empty-state.js.map

package/dist/components/empty-state/empty-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"empty-state.js","names":[],"sources":["../../../src/components/empty-state/empty-state.ts"],"sourcesContent":["import type { EmptyStateLive, EmptyStateProps } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideEmptyState, useEmptyStateContext } from './context'\nimport { useEmptyState } from './use-empty-state'\n\n/** 根节点渲染为 div，缺省值由 connect 给出，这里一律 default: undefined */\nexport const XhEmptyStateRoot = defineComponent({\n  name: 'XhEmptyStateRoot',\n  props: {\n    size: { type: String as PropType<'sm' | 'md' | 'lg'>, default: undefined },\n    live: { type: String as PropType<EmptyStateLive>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useEmptyState(withXhConfig('empty-state', props as EmptyStateProps))\n    provideEmptyState(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 装饰性图标容器，内容由作者塞（字形、内联 svg 都行）\nexport const XhEmptyStateIcon = defineComponent({\n  name: 'XhEmptyStateIcon',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('span', ctx.api.value.getIconProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 标题渲染为 p 而不是 hN：它只做视觉主次，不该往文档大纲里插一级标题\nexport const XhEmptyStateTitle = defineComponent({\n  name: 'XhEmptyStateTitle',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('p', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEmptyStateDescription = defineComponent({\n  name: 'XhEmptyStateDescription',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 操作槽只排版，按钮由作者放进插槽\nexport const XhEmptyStateAction = defineComponent({\n  name: 'XhEmptyStateAction',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('div', ctx.api.value.getActionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAQA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;EACL,MAAM;GAAE,MAAM;GAAwC,SAAS,KAAA;EAAU;EACzE,MAAM;GAAE,MAAM;GAAoC,SAAS,KAAA;EAAU;CACvE;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,cAAc,aAAa,eAAe,KAAwB,CAAC;EAC/E,kBAAkB,GAAG;EACrB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;AAGD,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC"}
+{"version":3,"file":"empty-state.js","names":[],"sources":["../../../src/components/empty-state/empty-state.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// 提供 empty state 相关实现。\n\nimport type { Tone } from '@xihan-ui/core'\nimport type { EmptyStateLive, EmptyStateProps, EmptyStateStatus } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideEmptyState, useEmptyStateContext } from './context'\nimport { useEmptyState } from './use-empty-state'\n\n/** 根节点渲染为 div，默认值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined */\nexport const XhEmptyStateRoot = defineComponent({\n  name: 'XhEmptyStateRoot',\n  props: {\n    size: { type: String as PropType<'sm' | 'md' | 'lg'> },\n    live: { type: String as PropType<EmptyStateLive> },\n    status: { type: String as PropType<EmptyStateStatus> },\n    tone: { type: String as PropType<Tone> },\n  },\n  setup(props, { slots }) {\n    const ctx = useEmptyState(withXhConfig('empty-state', props as EmptyStateProps))\n    provideEmptyState(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 插画槽，内容由作者塞（img、内联 svg 都行）；与图标槽二选一\nexport const XhEmptyStateMedia = defineComponent({\n  name: 'XhEmptyStateMedia',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('div', ctx.api.value.getMediaProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 装饰性图标容器，内容由作者塞（字形、内联 svg 都行）\nexport const XhEmptyStateIndicator = defineComponent({\n  name: 'XhEmptyStateIndicator',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 标题渲染为 p 而不是 hN：它只做视觉主次，不该往文档大纲里插一级标题\nexport const XhEmptyStateTitle = defineComponent({\n  name: 'XhEmptyStateTitle',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('p', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhEmptyStateDescription = defineComponent({\n  name: 'XhEmptyStateDescription',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 操作槽只排版，按钮由作者放进插槽\nexport const XhEmptyStateAction = defineComponent({\n  name: 'XhEmptyStateAction',\n  setup(_, { slots }) {\n    const ctx = useEmptyStateContext()\n    return () => h('div', ctx.api.value.getActionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAgBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;EACL,MAAM,EAAE,MAAM,OAAuC;EACrD,MAAM,EAAE,MAAM,OAAmC;EACjD,QAAQ,EAAE,MAAM,OAAqC;EACrD,MAAM,EAAE,MAAM,OAAyB;CACzC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,cAAc,aAAa,eAAe,KAAwB,CAAC;EAC/E,kBAAkB,GAAG;EACrB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAGD,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC"}

package/dist/components/empty-state/use-empty-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-empty-state.js","names":[],"sources":["../../../src/components/empty-state/use-empty-state.ts"],"sourcesContent":["import type { EmptyStateApi, EmptyStateProps } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectEmptyState } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\n\nexport interface EmptyStateContext {\n  api: ComputedRef<EmptyStateApi>\n}\n\n// EmptyState 无状态机也不派生 part id，props 变了由 computed 重算属性\nexport function useEmptyState(props: EmptyStateProps): EmptyStateContext {\n  const api = computed(() => connectEmptyState(props, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;AAWA,SAAgB,cAAc,OAA2C;CAEvE,OAAO,EAAE,KADG,eAAe,kBAAkB,OAAO,YAAY,CACrD,EAAE;AACf"}
+{"version":3,"file":"use-empty-state.js","names":[],"sources":["../../../src/components/empty-state/use-empty-state.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 empty state 相关实现。\n\nimport type { EmptyStateApi, EmptyStateProps } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectEmptyState } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\n\nexport interface EmptyStateContext {\n  api: ComputedRef<EmptyStateApi>\n}\n\n// EmptyState 无状态机也不派生 part id，props 变了由 computed 重算属性\nexport function useEmptyState(props: EmptyStateProps): EmptyStateContext {\n  const api = computed(() => connectEmptyState(props, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;AAkBA,SAAgB,cAAc,OAA2C;CAEvE,OAAO,EAAE,KADG,eAAe,kBAAkB,OAAO,YAAY,CACrD,EAAE;AACf"}

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/field/context.ts"],"mappings":";;iBAMgB,aAAa,KAAK;;iBAKlB,2BAA2B;iBAI3B,mBAAmB"}
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/field/context.ts"],"mappings":";;iBAagB,aAAa,KAAK;;iBAKlB,2BAA2B;iBAI3B,mBAAmB"}

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/field/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { FieldContext } from './use-field'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<FieldContext> = Symbol.for('xh-field')\n\nexport function provideField(ctx: FieldContext): void {\n  provide(KEY, ctx)\n}\n\n/** 字段外调用时返回 null，供薄封装在字段内外都能安全使用。 */\nexport function useOptionalFieldContext(): FieldContext | null {\n  return inject(KEY, null)\n}\n\nexport function useFieldContext(): FieldContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Field 部件必须用在 XhFieldRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAkC,OAAO,IAAI,UAAU;AAE7D,SAAgB,aAAa,KAAyB;CACpD,QAAQ,KAAK,GAAG;AAClB;;AAGA,SAAgB,0BAA+C;CAC7D,OAAO,OAAO,KAAK,IAAI;AACzB;AAEA,SAAgB,kBAAgC;CAC9C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,iCAAiC;CACnD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/field/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 { FieldContext } from './use-field'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<FieldContext> = Symbol.for('xh-field')\n\nexport function provideField(ctx: FieldContext): void {\n  provide(KEY, ctx)\n}\n\n/** 字段外调用时返回 null，供薄封装在字段内外都能安全使用。 */\nexport function useOptionalFieldContext(): FieldContext | null {\n  return inject(KEY, null)\n}\n\nexport function useFieldContext(): FieldContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Field 部件必须用在 XhFieldRoot 内')\n  return ctx\n}\n"],"mappings":";;AAWA,MAAM,MAAkC,OAAO,IAAI,UAAU;AAE7D,SAAgB,aAAa,KAAyB;CACpD,QAAQ,KAAK,GAAG;AAClB;;AAGA,SAAgB,0BAA+C;CAC7D,OAAO,OAAO,KAAK,IAAI;AACzB;AAEA,SAAgB,kBAAgC;CAC9C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,iCAAiC;CACnD,OAAO;AACT"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"field.d.ts","names":[],"sources":["../../../src/components/field/field.ts"],"mappings":";;cAaa,2BAAW,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAoCtB;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;KAGU,wBAAwB;cAYvB,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYb,WAAC,OAAO,0BAA0B;kCAiB9C;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAe3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"field.d.ts","names":[],"sources":["../../../src/components/field/field.ts"],"mappings":";;cAea,2BAAW,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAgBtB;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"}

package/dist/components/field/field.js

@@ -1,13 +1,10 @@
 import { provideField, useFieldContext } from "./context.js";
-import { carriesOwnAnatomy } from "../../runtime/as-child.js";
+import { isRoleMarker, mergeIntoChild } from "../../runtime/as-child.js";
 import { useOptionalFormContext, useOptionalFormField } from "../form/context.js";
+import { useFormControlProps } from "../form/use-form-control.js";
 import { useField } from "./use-field.js";
-import { Comment, Text, cloneVNode, defineComponent, h } from "vue";
+import { defineComponent, h } from "vue";
 //#region src/components/field/field.ts
-/** 滤掉注释与纯文本节点，只留能挂属性的节点。 */
-function attributable(nodes) {
-	return nodes.filter((node) => node.type !== Comment && node.type !== Text);
-}
 const XhFieldRoot = defineComponent({
 	name: "XhFieldRoot",
 	props: {
@@ -27,31 +24,10 @@ const XhFieldRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
-		controlId: {
-			type: String,
-			default: void 0
-		}
+		controlId: { type: String }
 	},
 	setup(props, { slots }) {
-		const form = useOptionalFormContext();
-		const handle = useOptionalFormField();
-		const ctx = useField({
-			get invalid() {
-				return props.invalid ?? (form && handle ? form.api.value.isFieldInvalid(handle.name()) : void 0);
-			},
-			get required() {
-				return props.required ?? (form && handle ? form.api.value.isFieldRequired(handle.name()) : void 0);
-			},
-			get disabled() {
-				return props.disabled ?? (form && handle ? form.api.value.disabled : void 0);
-			},
-			get readOnly() {
-				return props.readOnly ?? (form && handle ? form.api.value.readOnly : void 0);
-			},
-			get controlId() {
-				return props.controlId;
-			}
-		});
+		const ctx = useField(useFormControlProps(props));
 		provideField(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), slots.default?.());
 	}
@@ -63,20 +39,25 @@ const XhFieldLabel = defineComponent({
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
-/** 去掉角色标记，只留接线属性（id 与 aria-*）。 */
+/**
+* 去掉角色标记，只保留接线属性（id、aria-* 与状态位）。
+*
+* 角色标记含解剖两位与家族标记（data-xh-*）：control 投影了 Field Chrome 的视觉盒标记，
+* 落到薄封装的根上会在封装自己的视觉盒外再画一层壳。
+*/
 function wiringOnly(controlProps) {
 	const rest = {};
-	for (const [key, value] of Object.entries(controlProps)) if (key !== "data-scope" && key !== "data-part") rest[key] = value;
+	for (const [key, value] of Object.entries(controlProps)) if (!isRoleMarker(key)) rest[key] = value;
 	return rest;
 }
 const XhFieldControl = defineComponent({
 	name: "XhFieldControl",
 	props: { 
 	/**
-	* 把接线属性合到唯一的子节点上，缺省开。
+	* 把接线属性合并到唯一的子节点上，默认开启。
 	*
-	* 子节点是薄封装（根不是可聚焦元素）时关掉它：属性只经插槽载荷交出去，
-	* 由封装内部调 useFieldControl 绑到真控件上。
+	* 子节点是薄封装（根不是可聚焦元素）时关闭它：属性只经插槽载荷交出，
+	* 由封装内部调用 useFieldControl 绑定到真实控件上。
 	*/
 asChild: {
 		type: Boolean,
@@ -88,10 +69,8 @@ asChild: {
 		return () => {
 			const controlProps = ctx.api.value.getControlProps();
 			const children = slots.default?.(controlProps) ?? [];
-			const nodes = attributable(children);
-			if (!props.asChild || nodes.length !== 1) return children;
-			const node = nodes[0];
-			return cloneVNode(node, carriesOwnAnatomy(node) ? wiringOnly(controlProps) : controlProps);
+			if (!props.asChild) return children;
+			return mergeIntoChild(children, controlProps, "field/control");
 		};
 	}
 });

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

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

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

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

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":";;;;;;;;;;;;iBAegB,mBAAmB,YAAY;;;;;;;;;;;;;iBAqB/B,uBAAuB,YAAY;;;;;;;;;;;;iBA0BnC,uBAAuB,aAAa,OAAO,4BAA4B"}
+{"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;;;;;;;;;;;;iBA0BnC,uBAAuB,aAAa,OAAO,4BAA4B"}

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

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