@xihan-ui/vue 4.2.0 → 5.1.0

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

@@ -1 +1 @@
-{"version":3,"file":"fieldset.js","names":[],"sources":["../../../src/components/fieldset/fieldset.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 fieldset 相关实现。\n\nimport type { FieldsetProps, FieldsetTranslations } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { computed, defineComponent, h } from 'vue'\nimport { provideXhConfig, useXhConfig, withXhConfig } from '../../config/config'\nimport { provideFieldset, provideFieldsetOuterDisabled, useFieldsetContext, useFieldsetOuterDisabled } from './context'\nimport { useFieldset } from './use-fieldset'\n\nexport const XhFieldsetRoot = defineComponent({\n  name: 'XhFieldsetRoot',\n  // 三个布尔缺省 undefined：缺省值的事实源在 connect，写死 false 会挡住将来从上下文取值\n  props: {\n    disabled: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<FieldsetTranslations>> },\n  },\n  setup(props, { slots }) {\n    const outer = useXhConfig()\n    const ctx = useFieldset(withXhConfig('fieldset', props) as FieldsetProps)\n    provideFieldset(ctx)\n    // 整组禁用经作用域配置压进子树：组内组件库的控件各自拿到 disabled，行为与禁用面一起到位。\n    // 原生 fieldset[disabled] 只管得住原生表单控件，滑块、取色区这类非原生交互节点与各家族的禁用面它够不着\n    provideXhConfig(() => ({ disabled: ctx.api.value.disabled || undefined }))\n    provideFieldsetOuterDisabled(computed(() => outer.value.disabled === true))\n    // 必须是原生 <fieldset>：整组禁用连坐组内控件是浏览器给的，换成 div 就只剩一层灰样式\n    return () => h('fieldset', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldsetLegend = defineComponent({\n  name: 'XhFieldsetLegend',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    // legend 里的控件不吃本组的禁用（原生语义：首个 legend 内的控件不受所在 fieldset 禁用），恢复成外层的\n    const outer = useFieldsetOuterDisabled()\n    provideXhConfig(() => ({ disabled: outer?.value ?? false }))\n    // 原生 <legend> 只有作为 <fieldset> 的首个子节点时才充当这一组的名字\n    return () => h('legend', ctx.api.value.getLegendProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldsetDescription = defineComponent({\n  name: 'XhFieldsetDescription',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 把并排的几个字段圈为一段；纯排版。 */\nexport const XhFieldsetFieldGroup = defineComponent({\n  name: 'XhFieldsetFieldGroup',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    return () => h('div', ctx.api.value.getFieldGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 组末尾的按钮行；纯排版。 */\nexport const XhFieldsetActions = defineComponent({\n  name: 'XhFieldsetActions',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    return () => h('div', ctx.api.value.getActionsProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldsetErrorText = defineComponent({\n  name: 'XhFieldsetErrorText',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    // 节点常挂，靠 hidden 显隐：活区要先在场才播报得出来，卸载重挂读屏读不到\n    return () => h('p', ctx.api.value.getErrorTextProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;AAcA,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CAEN,OAAO;EACL,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,cAAc,EAAE,MAAM,OAAkD;CAC1E;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,QAAQ,YAAY;EAC1B,MAAM,MAAM,YAAY,aAAa,YAAY,KAAK,CAAkB;EACxE,gBAAgB,GAAG;EAGnB,uBAAuB,EAAE,UAAU,IAAI,IAAI,MAAM,YAAY,KAAA,EAAU,EAAE;EACzE,6BAA6B,eAAe,MAAM,MAAM,aAAa,IAAI,CAAC;EAE1E,aAAa,EAAE,YAAY,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAE/B,MAAM,QAAQ,yBAAyB;EACvC,uBAAuB,EAAE,UAAU,OAAO,SAAS,MAAM,EAAE;EAE3D,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;;AAGD,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,mBAAmB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAE/B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC"}
+{"version":3,"file":"fieldset.js","names":[],"sources":["../../../src/components/fieldset/fieldset.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 fieldset 相关实现。\n\nimport type { FieldsetProps, FieldsetTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport { fieldsetStructure, hasNamingContent } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, ref } from 'vue'\nimport { provideXhConfig, useXhConfig, withXhConfig } from '../../config/config'\nimport { renderStructure } from '../../runtime/structure'\nimport { provideFieldset, provideFieldsetOuterDisabled, useFieldsetContext, useFieldsetOuterDisabled } from './context'\nimport { useFieldset, useFieldsetPartPresence } from './use-fieldset'\n\nexport const XhFieldsetRoot = defineComponent({\n  name: 'XhFieldsetRoot',\n  // 三个布尔缺省 undefined：缺省值的事实源在 connect，写死 false 会挡住将来从上下文取值\n  props: {\n    /** 组标题文字。不写默认插槽时铺 legend 部件；需要放置其他内容时改用 legend 插槽。 */\n    legend: { type: String },\n    disabled: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<FieldsetTranslations>> },\n  },\n  slots: Object as SlotsType<{\n    default?: () => VNode[]\n    legend?: () => VNode[]\n    description?: () => VNode[]\n    fieldGroup?: () => VNode[]\n    errorText?: () => VNode[]\n    actions?: () => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const outer = useXhConfig()\n    const ctx = useFieldset(withXhConfig('fieldset', props) as FieldsetProps)\n    provideFieldset(ctx)\n    // 整组禁用经作用域配置压进子树：组内组件库的控件各自拿到 disabled，行为与禁用面一起到位。\n    // 原生 fieldset[disabled] 只管得住原生表单控件，滑块、取色区这类非原生交互节点与各家族的禁用面它够不着\n    provideXhConfig(() => ({ disabled: ctx.api.value.disabled || undefined }))\n    provideFieldsetOuterDisabled(computed(() => outer.value.disabled === true))\n    // 必须是原生 <fieldset>：整组禁用连坐组内控件是浏览器给的，换成 div 就只剩一层灰样式\n    return () => h('fieldset', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default\n      ? slots.default()\n      : renderDefaultStructure(props.legend, {\n          'legend': slots.legend,\n          'description': slots.description,\n          'field-group': slots.fieldGroup,\n          'error-text': slots.errorText,\n          'actions': slots.actions,\n        }))\n  },\n})\n\nexport const XhFieldsetLegend = defineComponent({\n  name: 'XhFieldsetLegend',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    // legend 里的控件不吃本组的禁用（原生语义：首个 legend 内的控件不受所在 fieldset 禁用），恢复成外层的\n    const outer = useFieldsetOuterDisabled()\n    provideXhConfig(() => ({ disabled: outer?.value ?? false }))\n    // 原生 <legend> 只有作为 <fieldset> 的首个子节点时才充当这一组的名字\n    return () => h('legend', ctx.api.value.getLegendProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldsetDescription = defineComponent({\n  name: 'XhFieldsetDescription',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    const el = ref<HTMLElement | null>(null)\n    // 读不出一句话的说明不进描述链\n    useFieldsetPartPresence(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\n/** 把并排的几个字段圈为一段；纯排版。 */\nexport const XhFieldsetFieldGroup = defineComponent({\n  name: 'XhFieldsetFieldGroup',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    return () => h('div', ctx.api.value.getFieldGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 组末尾的按钮行；纯排版。 */\nexport const XhFieldsetActions = defineComponent({\n  name: 'XhFieldsetActions',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    return () => h('div', ctx.api.value.getActionsProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldsetErrorText = defineComponent({\n  name: 'XhFieldsetErrorText',\n  setup(_, { slots }) {\n    const ctx = useFieldsetContext()\n    useFieldsetPartPresence(ctx, 'errorText')\n    // 节点常挂，靠 hidden 显隐：活区要先在场才播报得出来，卸载重挂读屏读不到\n    return () => h('p', ctx.api.value.getErrorTextProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst FIELDSET_PARTS = {\n  'legend': XhFieldsetLegend,\n  'description': XhFieldsetDescription,\n  'field-group': XhFieldsetFieldGroup,\n  'error-text': XhFieldsetErrorText,\n  'actions': XhFieldsetActions,\n}\n\ntype FieldsetSectionSlots = Readonly<Partial<Record<'legend' | 'description' | 'field-group' | 'error-text' | 'actions', () => VNode[]>>>\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 fieldsetStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。组标题恒在，其余给了哪个插槽才铺哪一段。\n */\nfunction renderDefaultStructure(legend: string | undefined, sections: FieldsetSectionSlots): VNode[] {\n  const nodes = fieldsetStructure({ legend, slotted: name => sections[name as keyof FieldsetSectionSlots] != null })\n  return renderStructure(nodes, FIELDSET_PARTS, node => (node.slot ? sections[node.slot.name as keyof FieldsetSectionSlots]?.() : undefined))\n}\n"],"mappings":";;;;;;;AAgBA,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CAEN,OAAO;;EAEL,QAAQ,EAAE,MAAM,OAAO;EACvB,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,cAAc,EAAE,MAAM,OAAkD;CAC1E;CACA,OAAO;CAQP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,QAAQ,YAAY;EAC1B,MAAM,MAAM,YAAY,aAAa,YAAY,KAAK,CAAkB;EACxE,gBAAgB,GAAG;EAGnB,uBAAuB,EAAE,UAAU,IAAI,IAAI,MAAM,YAAY,KAAA,EAAU,EAAE;EACzE,6BAA6B,eAAe,MAAM,MAAM,aAAa,IAAI,CAAC;EAE1E,aAAa,EAAE,YAAY,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UACtF,MAAM,QAAQ,IACd,uBAAuB,MAAM,QAAQ;GACnC,UAAU,MAAM;GAChB,eAAe,MAAM;GACrB,eAAe,MAAM;GACrB,cAAc,MAAM;GACpB,WAAW,MAAM;EACnB,CAAC,CAAC;CACR;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAE/B,MAAM,QAAQ,yBAAyB;EACvC,uBAAuB,EAAE,UAAU,OAAO,SAAS,MAAM,EAAE;EAE3D,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,MAAM,KAAK,IAAwB,IAAI;EAEvC,wBAAwB,KAAK,qBAAqB,GAAG,SAAS,QAAQ,iBAAiB,GAAG,KAAK,CAAC;EAChG,aAAa,EAAE,KAAK;GAAE,GAAG,IAAI,IAAI,MAAM,oBAAoB;GAA8B,KAAK;EAAG,GAAG,MAAM,UAAU,CAAC;CACvH;AACF,CAAC;;AAGD,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,mBAAmB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,mBAAmB;EAC/B,wBAAwB,KAAK,WAAW;EAExC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;;AAGD,MAAM,iBAAiB;CACrB,UAAU;CACV,eAAe;CACf,eAAe;CACf,cAAc;CACd,WAAW;AACb;;;;;AAQA,SAAS,uBAAuB,QAA4B,UAAyC;CAEnG,OAAO,gBADO,kBAAkB;EAAE;EAAQ,UAAS,SAAQ,SAAS,SAAuC;CAAK,CACrF,GAAG,iBAAgB,SAAS,KAAK,OAAO,SAAS,KAAK,KAAK,KAAmC,GAAG,IAAI,KAAA,CAAU;AAC5I"}

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

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

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

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

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

@@ -1,14 +1,48 @@
 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 { connectFieldset } from "@xihan-ui/headless";
+import { computed, onBeforeUnmount, onMounted, onUpdated, reactive, ref } from "vue";
+import { createScope } from "@xihan-ui/core";
 //#region src/components/fieldset/use-fieldset.ts
 function useFieldset(props) {
 	const scope = createScope(null, createVueIdGenerator());
-	return { api: computed(() => connectFieldset(props, scope, vueNormalize)) };
+	const partCounts = reactive({
+		description: 0,
+		errorText: 0
+	});
+	const mounted = ref(false);
+	onMounted(() => {
+		mounted.value = true;
+	});
+	const parts = computed(() => mounted.value ? {
+		description: partCounts.description > 0,
+		errorText: partCounts.errorText > 0
+	} : void 0);
+	return {
+		api: computed(() => connectFieldset({
+			...props,
+			parts: parts.value
+		}, scope, vueNormalize)),
+		partCounts
+	};
+}
+/** 部件挂载期间登记在场，卸载时撤销；present 给出时每次渲染后现判（说明读不出一句话时不算在场）。 */
+function useFieldsetPartPresence(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 { useFieldset };
+export { useFieldset, useFieldsetPartPresence };
 
 //# sourceMappingURL=use-fieldset.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-fieldset.js","names":[],"sources":["../../../src/components/fieldset/use-fieldset.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use fieldset 相关实现。\n\nimport type { FieldsetApi, FieldsetProps } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectFieldset } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface FieldsetContext {\n  api: ComputedRef<FieldsetApi>\n}\n\n// Fieldset 无状态机，只用一份实例级 scope 派生 part id，props 变了由 computed 重算属性\nexport function useFieldset(props: FieldsetProps): FieldsetContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const api = computed(() => connectFieldset(props, scope, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;;AAoBA,SAAgB,YAAY,OAAuC;CAEjE,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CAErC,OAAO,EAAE,KADG,eAAe,gBAAgB,OAAO,OAAO,YAAY,CAC1D,EAAE;AACf"}
+{"version":3,"file":"use-fieldset.js","names":[],"sources":["../../../src/components/fieldset/use-fieldset.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use fieldset 相关实现。\n\nimport type { FieldsetApi, FieldsetProps, FieldsetRenderedParts } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectFieldset } 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 FieldsetPartName = keyof FieldsetRenderedParts\n\nexport interface FieldsetContext {\n  api: ComputedRef<FieldsetApi>\n  /** 已挂载的 description / error-text 各几个，由部件自行登记。 */\n  partCounts: Record<FieldsetPartName, number>\n}\n\n// Fieldset 无状态机，只用一份实例级 scope 派生 part id，props 变了由 computed 重算属性\nexport function useFieldset(props: FieldsetProps): FieldsetContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const partCounts = reactive<Record<FieldsetPartName, number>>({ description: 0, errorText: 0 })\n  // 挂载前（含服务端直出）不知道部件在不在场，按在场处理；子部件先于根挂载，根挂载时登记已齐\n  const mounted = ref(false)\n  onMounted(() => {\n    mounted.value = true\n  })\n  const parts = computed<FieldsetRenderedParts | undefined>(() => mounted.value\n    ? { description: partCounts.description > 0, errorText: partCounts.errorText > 0 }\n    : undefined)\n  const api = computed(() => connectFieldset({ ...props, parts: parts.value }, scope, vueNormalize))\n  return { api, partCounts }\n}\n\n/** 部件挂载期间登记在场，卸载时撤销；present 给出时每次渲染后现判（说明读不出一句话时不算在场）。 */\nexport function useFieldsetPartPresence(ctx: FieldsetContext, part: FieldsetPartName, 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,YAAY,OAAuC;CAEjE,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,aAAa,SAA2C;EAAE,aAAa;EAAG,WAAW;CAAE,CAAC;CAE9F,MAAM,UAAU,IAAI,KAAK;CACzB,gBAAgB;EACd,QAAQ,QAAQ;CAClB,CAAC;CACD,MAAM,QAAQ,eAAkD,QAAQ,QACpE;EAAE,aAAa,WAAW,cAAc;EAAG,WAAW,WAAW,YAAY;CAAE,IAC/E,KAAA,CAAS;CAEb,OAAO;EAAE,KADG,eAAe,gBAAgB;GAAE,GAAG;GAAO,OAAO,MAAM;EAAM,GAAG,OAAO,YAAY,CACrF;EAAG;CAAW;AAC3B;;AAGA,SAAgB,wBAAwB,KAAsB,MAAwB,gBAA+B,MAAY;CAC/H,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/file-upload/file-upload.d.ts

@@ -1,11 +1,15 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { PropType, SlotsType, VNode } from "vue";
 import { FileUploadApi, FileUploadFile, FileUploadRemoteFile, FileUploadSchema, FileUploadTranslations } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
 //#region src/components/file-upload/file-upload.d.ts
 type FileUploadProps = FileUploadSchema['props'];
 /** 默认插槽的载荷：文件清单与传输快照、投放区与数量状态，以及增删清空、开始上传、拉起选择器等命令。 */
 type FileUploadRootSlotProps = Pick<FileUploadApi, 'acceptedFiles' | 'remoteFiles' | 'allFiles' | 'uploadOf' | 'startUpload' | 'cancelUpload' | 'dragging' | 'empty' | 'disabled' | 'maxFiles' | 'getFileSizeText' | 'setFiles' | 'addFiles' | 'deleteFile' | 'clear' | 'openFilePicker'>;
 declare const XhFileUploadRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   files: {
     type: PropType<File[]>;
   };
@@ -45,6 +49,14 @@ declare const XhFileUploadRoot: import("vue").DefineComponent<import("vue").Extr
     type: BooleanConstructor;
     default: undefined;
   };
+  readOnly: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   name: {
     type: StringConstructor;
   };
@@ -66,9 +78,19 @@ declare const XhFileUploadRoot: import("vue").DefineComponent<import("vue").Extr
   capture: {
     type: PropType<"user" | "environment">;
   };
+  /** 附件链接的打开方式（target），缺省在当前页打开；写 _blank 时同时带 rel="noopener noreferrer"。 */
+  linkTarget: {
+    type: StringConstructor;
+  };
   translations: {
     type: PropType<Partial<FileUploadTranslations>>;
   };
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不写默认插槽时列表之后带清空整份列表的按钮；写了默认插槽时放 clear-trigger 部件即可清空。 */
+  clearable: BooleanConstructor;
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
@@ -83,6 +105,10 @@ declare const XhFileUploadRoot: import("vue").DefineComponent<import("vue").Extr
   'upload-error': (_details: PayloadOf<FileUploadProps, "onUploadError">) => true;
   'upload-cancel': (_details: PayloadOf<FileUploadProps, "onUploadCancel">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   files: {
     type: PropType<File[]>;
   };
@@ -122,6 +148,14 @@ declare const XhFileUploadRoot: import("vue").DefineComponent<import("vue").Extr
     type: BooleanConstructor;
     default: undefined;
   };
+  readOnly: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   name: {
     type: StringConstructor;
   };
@@ -143,9 +177,19 @@ declare const XhFileUploadRoot: import("vue").DefineComponent<import("vue").Extr
   capture: {
     type: PropType<"user" | "environment">;
   };
+  /** 附件链接的打开方式（target），缺省在当前页打开；写 _blank 时同时带 rel="noopener noreferrer"。 */
+  linkTarget: {
+    type: StringConstructor;
+  };
   translations: {
     type: PropType<Partial<FileUploadTranslations>>;
   };
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不写默认插槽时列表之后带清空整份列表的按钮；写了默认插槽时放 clear-trigger 部件即可清空。 */
+  clearable: BooleanConstructor;
 }>> & Readonly<{
   onClear?: (() => any) | undefined;
   "onFiles-change"?: ((_details: import("@xihan-ui/headless").FileUploadFilesChangeDetails) => any) | undefined;
@@ -158,14 +202,20 @@ declare const XhFileUploadRoot: import("vue").DefineComponent<import("vue").Extr
   "onUpload-error"?: ((_details: import("@xihan-ui/headless").FileUploadErrorDetails) => any) | undefined;
   "onUpload-cancel"?: ((_details: import("@xihan-ui/headless").FileUploadCancelDetails) => any) | undefined;
 }>, {
+  required: boolean;
   invalid: boolean;
   disabled: boolean;
+  readOnly: boolean;
+  clearable: boolean;
   directory: boolean;
   autoUpload: boolean;
   allowDrop: boolean;
   allowPaste: boolean;
 }, SlotsType<{
   default?: (props: FileUploadRootSlotProps) => VNode[];
+  label?: () => VNode[];
+  /** 不写默认插槽时投放区里的内容；未写时取 translations.dropzone。 */
+  dropzone?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhFileUploadLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -214,6 +264,10 @@ declare const XhFileUploadItem: import("vue").DefineComponent<import("vue").Extr
 declare const XhFileUploadItemName: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 附件链接：指向文件的安全地址，未提供内容时显示文件名。 */
+declare const XhFileUploadItemLink: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhFileUploadItemSizeText: 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>;
@@ -230,5 +284,5 @@ declare const XhFileUploadClearTrigger: import("vue").DefineComponent<{}, () =>
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { FileUploadRootSlotProps, XhFileUploadClearTrigger, XhFileUploadDropzone, XhFileUploadHiddenInput, XhFileUploadItem, XhFileUploadItemDeleteTrigger, XhFileUploadItemName, XhFileUploadItemPreview, XhFileUploadItemProgress, XhFileUploadItemSizeText, XhFileUploadLabel, XhFileUploadList, XhFileUploadRoot, XhFileUploadTrigger };
+export { FileUploadRootSlotProps, XhFileUploadClearTrigger, XhFileUploadDropzone, XhFileUploadHiddenInput, XhFileUploadItem, XhFileUploadItemDeleteTrigger, XhFileUploadItemLink, XhFileUploadItemName, XhFileUploadItemPreview, XhFileUploadItemProgress, XhFileUploadItemSizeText, XhFileUploadLabel, XhFileUploadList, XhFileUploadRoot, XhFileUploadTrigger };
 //# sourceMappingURL=file-upload.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"file-upload.d.ts","names":[],"sources":["../../../src/components/file-upload/file-upload.ts"],"mappings":";;;;KAmBK,kBAAkB;;KAGX,0BAA0B,KACpC;cAmBW,gCAAgB,8BAAA;;IAKD,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACV,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IAClB,MAAA,SAAS;;;;;;;IAEF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASL,MAAA,SAAS;;;;;;;IAGZ,MAAA;;;IACK,MAAA,SAAS,QAAQ;;;;;;EAKtB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACT,gBAAA,UAAA,UAAU;EACV,gBAAA,UAAA,UAAU;EACF,wBAAA,UAAA,UAAU;EACb,uBAAA,QAAA,UAAU;EACX,oBAAA,UAAA,UAAU;EACb,iBAAA,UAAA,UAAU;EACT,kBAAA,UAAA,UAAU;;;IAhCd,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACV,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IAClB,MAAA,SAAS;;;;;;;IAEF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASL,MAAA,SAAS;;;;;;;IAGZ,MAAA;;;IACK,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;;;EAgBvC,WAAC,OAAO,4BAA4B;kCAqChD;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;;;;;;;;;qCAsB9B;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,8BAAA;;;IAID,MAAA,SAAS;;;;IAEE,MAAA;;;;;;;IAFX,MAAA,SAAS;;;;IAEE,MAAA;;MAqBrC,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAY/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAYnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAWxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"file-upload.d.ts","names":[],"sources":["../../../src/components/file-upload/file-upload.ts"],"mappings":";;;;KAsBK,kBAAkB;;KAGX,0BAA0B,KACpC;cAmBW,gCAAgB,8BAAA;;;;;;IAOD,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACV,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IAClB,MAAA,SAAS;;;;;;;IAEF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWL,MAAA,SAAS;;;;;;;IAGZ,MAAA;;;;;;;IAGK,MAAA,SAAS,QAAQ;;;;;;;;;;;;EAStB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACT,gBAAA,UAAA,UAAU;EACV,gBAAA,UAAA,UAAU;EACF,wBAAA,UAAA,UAAU;EACb,uBAAA,QAAA,UAAU;EACX,oBAAA,UAAA,UAAU;EACb,iBAAA,UAAA,UAAU;EACT,kBAAA,UAAA,UAAU;;;;;;;IAxCd,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACV,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IAClB,MAAA,SAAS;;;;;;;IAEF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWL,MAAA,SAAS;;;;;;;IAGZ,MAAA;;;;;;;IAGK,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBvC,WAAC,OAAO,4BAA4B;EACtC,cAAM;;EAEH,iBAAM;kCAuCnB;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAY5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAS/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;;;;;;;;;qCAsB9B;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAQlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,8BAAA;;;IAID,MAAA,SAAS;;;;IAEE,MAAA;;;;;;;IAFX,MAAA,SAAS;;;;IAEE,MAAA;;MAqBrC,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAY/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAYnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAWxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

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

@@ -1,15 +1,20 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
 import { withHandlers } from "../../runtime/with-handlers.js";
 import { useFormControlProps } from "../form/use-form-control.js";
+import { useFieldGroupWiring, useFieldLabelWiring } from "../field/use-field-control.js";
 import { provideFileUpload, provideFileUploadItem, useFileUploadContext, useFileUploadItemContext } from "./context.js";
 import { useFileUpload } from "./use-file-upload.js";
-import { computed, defineComponent, h } from "vue";
+import { fileUploadStructure } from "@xihan-ui/headless";
+import { computed, defineComponent, h, onUnmounted } from "vue";
 //#region src/components/file-upload/file-upload.ts
 const XhFileUploadRoot = defineComponent({
 	name: "XhFileUploadRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		files: { type: Array },
 		defaultFiles: { type: Array },
 		remoteFiles: { type: Array },
@@ -31,6 +36,14 @@ const XhFileUploadRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		readOnly: {
+			type: Boolean,
+			default: void 0
+		},
+		required: {
+			type: Boolean,
+			default: void 0
+		},
 		name: { type: String },
 		allowDrop: {
 			type: Boolean,
@@ -44,7 +57,13 @@ const XhFileUploadRoot = defineComponent({
 		maxConcurrentUploads: { type: Number },
 		directory: Boolean,
 		capture: { type: String },
-		translations: { type: Object }
+		/** 附件链接的打开方式（target），缺省在当前页打开；写 _blank 时同时带 rel="noopener noreferrer"。 */
+		linkTarget: { type: String },
+		translations: { type: Object },
+		/** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
+		/** 不写默认插槽时列表之后带清空整份列表的按钮；写了默认插槽时放 clear-trigger 部件即可清空。 */
+		clearable: Boolean
 	},
 	emits: {
 		"clear": () => true,
@@ -83,7 +102,13 @@ const XhFileUploadRoot = defineComponent({
 			onUploadCancel
 		});
 		provideFileUpload(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
+		return () => h("div", ctx.api.value.getRootProps(), !slots.default ? renderDefaultStructure(ctx.api.value, {
+			label: props.label,
+			clearable: props.clearable
+		}, {
+			label: slots.label,
+			dropzone: slots.dropzone
+		}) : slots.default({
 			acceptedFiles: ctx.api.value.acceptedFiles,
 			remoteFiles: ctx.api.value.remoteFiles,
 			allFiles: ctx.api.value.allFiles,
@@ -107,14 +132,23 @@ const XhFileUploadLabel = defineComponent({
 	name: "XhFileUploadLabel",
 	setup(_, { slots }) {
 		const ctx = useFileUploadContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
 const XhFileUploadDropzone = defineComponent({
 	name: "XhFileUploadDropzone",
 	setup(_, { slots }) {
+		const fieldWiring = useFieldGroupWiring();
+		const fieldLabel = useFieldLabelWiring();
 		const ctx = useFileUploadContext();
-		return () => h("div", ctx.api.value.getDropzoneProps(), slots.default?.());
+		return () => h("div", fieldLabel.value({
+			...fieldWiring.value,
+			...ctx.api.value.getDropzoneProps()
+		}), slots.default?.());
 	}
 });
 const XhFileUploadTrigger = defineComponent({
@@ -139,8 +173,9 @@ asChild: Boolean },
 const XhFileUploadHiddenInput = defineComponent({
 	name: "XhFileUploadHiddenInput",
 	setup() {
+		const fieldLabel = useFieldLabelWiring();
 		const ctx = useFileUploadContext();
-		return () => h("input", ctx.api.value.getHiddenInputProps());
+		return () => h("input", fieldLabel.value(ctx.api.value.getHiddenInputProps()));
 	}
 });
 const XhFileUploadList = defineComponent({
@@ -181,6 +216,15 @@ const XhFileUploadItemName = defineComponent({
 		return () => h("span", ctx.api.value.getItemNameProps(item.value), slots.default?.() ?? item.value.file.name);
 	}
 });
+/** 附件链接：指向文件的安全地址，未提供内容时显示文件名。 */
+const XhFileUploadItemLink = defineComponent({
+	name: "XhFileUploadItemLink",
+	setup(_, { slots }) {
+		const ctx = useFileUploadContext();
+		const { item } = useFileUploadItemContext();
+		return () => h("a", ctx.api.value.getItemLinkProps(item.value), slots.default?.() ?? item.value.file.name);
+	}
+});
 const XhFileUploadItemSizeText = defineComponent({
 	name: "XhFileUploadItemSizeText",
 	setup(_, { slots }) {
@@ -220,7 +264,38 @@ const XhFileUploadClearTrigger = defineComponent({
 		return () => h("button", ctx.api.value.getClearTriggerProps(), slots.default?.());
 	}
 });
+/** 标准结构里各部件对应的组件。 */
+const FILE_UPLOAD_PARTS = {
+	"label": XhFileUploadLabel,
+	"dropzone": XhFileUploadDropzone,
+	"hidden-input": XhFileUploadHiddenInput,
+	"list": XhFileUploadList,
+	"item": XhFileUploadItem,
+	"item-preview": XhFileUploadItemPreview,
+	"item-name": XhFileUploadItemName,
+	"item-link": XhFileUploadItemLink,
+	"item-size-text": XhFileUploadItemSizeText,
+	"item-progress": XhFileUploadItemProgress,
+	"item-delete-trigger": XhFileUploadItemDeleteTrigger,
+	"clear-trigger": XhFileUploadClearTrigger
+};
+/**
+* 未写默认插槽时铺开的整套结构，作者只提供数据：照 headless 的 fileUploadStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题与投放区的内容由对应插槽接管。
+*/
+function renderDefaultStructure(api, options, authored) {
+	return renderStructure(fileUploadStructure(api, {
+		...options,
+		slotted: (name) => authored[name] != null
+	}), FILE_UPLOAD_PARTS, (node) => {
+		switch (node.slot?.name) {
+			case "label": return authored.label?.();
+			case "dropzone": return authored.dropzone?.();
+			default: return;
+		}
+	});
+}
 //#endregion
-export { XhFileUploadClearTrigger, XhFileUploadDropzone, XhFileUploadHiddenInput, XhFileUploadItem, XhFileUploadItemDeleteTrigger, XhFileUploadItemName, XhFileUploadItemPreview, XhFileUploadItemProgress, XhFileUploadItemSizeText, XhFileUploadLabel, XhFileUploadList, XhFileUploadRoot, XhFileUploadTrigger };
+export { XhFileUploadClearTrigger, XhFileUploadDropzone, XhFileUploadHiddenInput, XhFileUploadItem, XhFileUploadItemDeleteTrigger, XhFileUploadItemLink, XhFileUploadItemName, XhFileUploadItemPreview, XhFileUploadItemProgress, XhFileUploadItemSizeText, XhFileUploadLabel, XhFileUploadList, XhFileUploadRoot, XhFileUploadTrigger };
 
 //# sourceMappingURL=file-upload.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"file-upload.js","names":[],"sources":["../../../src/components/file-upload/file-upload.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// 提供 file upload 相关实现。\n\nimport type { FileUploadApi, FileUploadFile, FileUploadItemProps, FileUploadRemoteFile, FileUploadSchema, FileUploadTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideFileUpload, provideFileUploadItem, useFileUploadContext, useFileUploadItemContext } from './context'\nimport { useFileUpload } from './use-file-upload'\n\ntype FileUploadProps = FileUploadSchema['props']\n\n/** 默认插槽的载荷：文件清单与传输快照、投放区与数量状态，以及增删清空、开始上传、拉起选择器等命令。 */\nexport type FileUploadRootSlotProps = Pick<\n  FileUploadApi,\n  | 'acceptedFiles'\n  | 'remoteFiles'\n  | 'allFiles'\n  | 'uploadOf'\n  | 'startUpload'\n  | 'cancelUpload'\n  | 'dragging'\n  | 'empty'\n  | 'disabled'\n  | 'maxFiles'\n  | 'getFileSizeText'\n  | 'setFiles'\n  | 'addFiles'\n  | 'deleteFile'\n  | 'clear'\n  | 'openFilePicker'\n>\n\nexport const XhFileUploadRoot = defineComponent({\n  name: 'XhFileUploadRoot',\n  // 有 connect 与机器兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    // 缺席值 undefined 表示非受控\n    files: { type: Array as PropType<File[]> },\n    defaultFiles: { type: Array as PropType<File[]> },\n    remoteFiles: { type: Array as PropType<FileUploadRemoteFile[]> },\n    defaultRemoteFiles: { type: Array as PropType<FileUploadRemoteFile[]> },\n    upload: { type: Function as PropType<FileUploadProps['upload']> },\n    autoUpload: { type: Boolean, default: undefined },\n    accept: { type: [String, Array] as PropType<string | string[]> },\n    maxFiles: { type: Number },\n    maxFileSize: { type: Number },\n    minFileSize: { type: Number },\n    disabled: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    name: { type: String },\n    allowDrop: { type: Boolean, default: undefined },\n    allowPaste: { type: Boolean, default: undefined },\n    validate: { type: Function as PropType<FileUploadProps['validate']> },\n    maxConcurrentUploads: { type: Number },\n    directory: Boolean,\n    capture: { type: String as PropType<'user' | 'environment'> },\n    translations: { type: Object as PropType<Partial<FileUploadTranslations>> },\n  },\n  // files-change 携带 { files }，update:files 携带裸数组；file-accept / file-reject 逐个文件报告\n  emits: {\n    'clear': () => true,\n    'files-change': (_details: PayloadOf<FileUploadProps, 'onFilesChange'>) => true,\n    'update:files': (_files: PayloadOf<FileUploadProps, 'onFilesChange'>['files']) => true,\n    'file-accept': (_details: PayloadOf<FileUploadProps, 'onFileAccept'>) => true,\n    'file-reject': (_details: PayloadOf<FileUploadProps, 'onFileReject'>) => true,\n    'remote-files-change': (_details: PayloadOf<FileUploadProps, 'onRemoteFilesChange'>) => true,\n    'update:remoteFiles': (_files: PayloadOf<FileUploadProps, 'onRemoteFilesChange'>['files']) => true,\n    'upload-complete': (_details: PayloadOf<FileUploadProps, 'onUploadComplete'>) => true,\n    'upload-error': (_details: PayloadOf<FileUploadProps, 'onUploadError'>) => true,\n    'upload-cancel': (_details: PayloadOf<FileUploadProps, 'onUploadCancel'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: FileUploadRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onFilesChange: FileUploadProps['onFilesChange'] = (details) => {\n      emit('files-change', details)\n      emit('update:files', details.files)\n    }\n    const onFileAccept: FileUploadProps['onFileAccept'] = details => emit('file-accept', details)\n    const onFileReject: FileUploadProps['onFileReject'] = details => emit('file-reject', details)\n    const onRemoteFilesChange: FileUploadProps['onRemoteFilesChange'] = (details) => {\n      emit('remote-files-change', details)\n      emit('update:remoteFiles', details.files)\n    }\n    const onUploadComplete: FileUploadProps['onUploadComplete'] = details => emit('upload-complete', details)\n    const onUploadError: FileUploadProps['onUploadError'] = details => emit('upload-error', details)\n    const onUploadCancel: FileUploadProps['onUploadCancel'] = details => emit('upload-cancel', details)\n    const ctx = useFileUpload(withHandlers(withXhConfig('file-upload', useFormControlProps(props)), { onClear: () => emit('clear') }) as FileUploadProps, { onFilesChange, onFileAccept, onFileReject, onRemoteFilesChange, onUploadComplete, onUploadError, onUploadCancel })\n    provideFileUpload(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      acceptedFiles: ctx.api.value.acceptedFiles,\n      remoteFiles: ctx.api.value.remoteFiles,\n      allFiles: ctx.api.value.allFiles,\n      uploadOf: ctx.api.value.uploadOf,\n      startUpload: ctx.api.value.startUpload,\n      cancelUpload: ctx.api.value.cancelUpload,\n      dragging: ctx.api.value.dragging,\n      empty: ctx.api.value.empty,\n      disabled: ctx.api.value.disabled,\n      maxFiles: ctx.api.value.maxFiles,\n      getFileSizeText: ctx.api.value.getFileSizeText,\n      setFiles: ctx.api.value.setFiles,\n      addFiles: ctx.api.value.addFiles,\n      deleteFile: ctx.api.value.deleteFile,\n      clear: ctx.api.value.clear,\n      openFilePicker: ctx.api.value.openFilePicker,\n    }))\n  },\n})\n\nexport const XhFileUploadLabel = defineComponent({\n  name: 'XhFileUploadLabel',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    // 用原生 label，getLabelProps 的 for 指向隐藏输入\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFileUploadDropzone = defineComponent({\n  name: 'XhFileUploadDropzone',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    return () => h('div', ctx.api.value.getDropzoneProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFileUploadTrigger = defineComponent({\n  name: 'XhFileUploadTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useFileUploadContext()\n    return () => {\n      const part = mergePartProps(ctx.api.value.getTriggerProps() as Record<string, unknown>, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'file-upload')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhFileUploadHiddenInput = defineComponent({\n  name: 'XhFileUploadHiddenInput',\n  setup() {\n    const ctx = useFileUploadContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhFileUploadList = defineComponent({\n  name: 'XhFileUploadList',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    return () => h('div', ctx.api.value.getListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFileUploadItem = defineComponent({\n  name: 'XhFileUploadItem',\n  props: {\n    /** 该行显示哪个文件（本地或远程附件）。 */\n    file: { type: Object as PropType<FileUploadFile> },\n    /** 改用下标从 allFiles（远程在前、本地在后）中取文件，兼收字符串以支持模板中写 index=\"0\"。 */\n    index: { type: [Number, String] as PropType<number | string> },\n  },\n  setup(props, { slots }) {\n    const ctx = useFileUploadContext()\n    const file = computed<FileUploadFile | undefined>(() => {\n      if (props.file)\n        return props.file\n      if (props.index == null)\n        return undefined\n      return ctx.api.value.allFiles[Math.trunc(Number(props.index))]\n    })\n    // 条目上下文，子部件从中取文件\n    const item = computed<FileUploadItemProps>(() => ({ file: file.value as FileUploadFile }))\n    provideFileUploadItem({ item })\n    return () => {\n      // 下标指向的文件不存在时只渲染空壳，不打组件属性也不渲染子部件\n      if (!file.value)\n        return h('div')\n      return h('div', ctx.api.value.getItemProps(item.value) as Record<string, unknown>, slots.default?.())\n    }\n  },\n})\n\nexport const XhFileUploadItemName = defineComponent({\n  name: 'XhFileUploadItemName',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    const { item } = useFileUploadItemContext()\n    // 有插槽用插槽，否则显示文件名\n    return () => h(\n      'span',\n      ctx.api.value.getItemNameProps(item.value) as Record<string, unknown>,\n      slots.default?.() ?? item.value.file.name,\n    )\n  },\n})\n\nexport const XhFileUploadItemSizeText = defineComponent({\n  name: 'XhFileUploadItemSizeText',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    const { item } = useFileUploadItemContext()\n    // 有插槽用插槽，否则显示格式化后的文件大小\n    return () => h(\n      'span',\n      ctx.api.value.getItemSizeTextProps(item.value) as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.getFileSizeText(item.value.file),\n    )\n  },\n})\n\nexport const XhFileUploadItemPreview = defineComponent({\n  name: 'XhFileUploadItemPreview',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    const { item } = useFileUploadItemContext()\n    return () => h('div', ctx.api.value.getItemPreviewProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFileUploadItemProgress = defineComponent({\n  name: 'XhFileUploadItemProgress',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    const { item } = useFileUploadItemContext()\n    return () => h('div', ctx.api.value.getItemProgressProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFileUploadItemDeleteTrigger = defineComponent({\n  name: 'XhFileUploadItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    const { item } = useFileUploadItemContext()\n    return () => h(\n      'button',\n      ctx.api.value.getItemDeleteTriggerProps(item.value) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhFileUploadClearTrigger = defineComponent({\n  name: 'XhFileUploadClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"file-upload.js","names":[],"sources":["../../../src/components/file-upload/file-upload.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// 提供 file upload 相关实现。\n\nimport type { FileUploadApi, FileUploadFile, FileUploadItemProps, FileUploadRemoteFile, FileUploadSchema, FileUploadTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { fileUploadStructure } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, onUnmounted } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { renderStructure } from '../../runtime/structure'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideFileUpload, provideFileUploadItem, useFileUploadContext, useFileUploadItemContext } from './context'\nimport { useFileUpload } from './use-file-upload'\n\ntype FileUploadProps = FileUploadSchema['props']\n\n/** 默认插槽的载荷：文件清单与传输快照、投放区与数量状态，以及增删清空、开始上传、拉起选择器等命令。 */\nexport type FileUploadRootSlotProps = Pick<\n  FileUploadApi,\n  | 'acceptedFiles'\n  | 'remoteFiles'\n  | 'allFiles'\n  | 'uploadOf'\n  | 'startUpload'\n  | 'cancelUpload'\n  | 'dragging'\n  | 'empty'\n  | 'disabled'\n  | 'maxFiles'\n  | 'getFileSizeText'\n  | 'setFiles'\n  | 'addFiles'\n  | 'deleteFile'\n  | 'clear'\n  | 'openFilePicker'\n>\n\nexport const XhFileUploadRoot = defineComponent({\n  name: 'XhFileUploadRoot',\n  // 有 connect 与机器兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    // 缺席值 undefined 表示非受控\n    files: { type: Array as PropType<File[]> },\n    defaultFiles: { type: Array as PropType<File[]> },\n    remoteFiles: { type: Array as PropType<FileUploadRemoteFile[]> },\n    defaultRemoteFiles: { type: Array as PropType<FileUploadRemoteFile[]> },\n    upload: { type: Function as PropType<FileUploadProps['upload']> },\n    autoUpload: { type: Boolean, default: undefined },\n    accept: { type: [String, Array] as PropType<string | string[]> },\n    maxFiles: { type: Number },\n    maxFileSize: { type: Number },\n    minFileSize: { type: Number },\n    disabled: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    name: { type: String },\n    allowDrop: { type: Boolean, default: undefined },\n    allowPaste: { type: Boolean, default: undefined },\n    validate: { type: Function as PropType<FileUploadProps['validate']> },\n    maxConcurrentUploads: { type: Number },\n    directory: Boolean,\n    capture: { type: String as PropType<'user' | 'environment'> },\n    /** 附件链接的打开方式（target），缺省在当前页打开；写 _blank 时同时带 rel=\"noopener noreferrer\"。 */\n    linkTarget: { type: String },\n    translations: { type: Object as PropType<Partial<FileUploadTranslations>> },\n    /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    /** 不写默认插槽时列表之后带清空整份列表的按钮；写了默认插槽时放 clear-trigger 部件即可清空。 */\n    clearable: Boolean,\n  },\n  // files-change 携带 { files }，update:files 携带裸数组；file-accept / file-reject 逐个文件报告\n  emits: {\n    'clear': () => true,\n    'files-change': (_details: PayloadOf<FileUploadProps, 'onFilesChange'>) => true,\n    'update:files': (_files: PayloadOf<FileUploadProps, 'onFilesChange'>['files']) => true,\n    'file-accept': (_details: PayloadOf<FileUploadProps, 'onFileAccept'>) => true,\n    'file-reject': (_details: PayloadOf<FileUploadProps, 'onFileReject'>) => true,\n    'remote-files-change': (_details: PayloadOf<FileUploadProps, 'onRemoteFilesChange'>) => true,\n    'update:remoteFiles': (_files: PayloadOf<FileUploadProps, 'onRemoteFilesChange'>['files']) => true,\n    'upload-complete': (_details: PayloadOf<FileUploadProps, 'onUploadComplete'>) => true,\n    'upload-error': (_details: PayloadOf<FileUploadProps, 'onUploadError'>) => true,\n    'upload-cancel': (_details: PayloadOf<FileUploadProps, 'onUploadCancel'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: FileUploadRootSlotProps) => VNode[]\n    label?: () => VNode[]\n    /** 不写默认插槽时投放区里的内容；未写时取 translations.dropzone。 */\n    dropzone?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onFilesChange: FileUploadProps['onFilesChange'] = (details) => {\n      emit('files-change', details)\n      emit('update:files', details.files)\n    }\n    const onFileAccept: FileUploadProps['onFileAccept'] = details => emit('file-accept', details)\n    const onFileReject: FileUploadProps['onFileReject'] = details => emit('file-reject', details)\n    const onRemoteFilesChange: FileUploadProps['onRemoteFilesChange'] = (details) => {\n      emit('remote-files-change', details)\n      emit('update:remoteFiles', details.files)\n    }\n    const onUploadComplete: FileUploadProps['onUploadComplete'] = details => emit('upload-complete', details)\n    const onUploadError: FileUploadProps['onUploadError'] = details => emit('upload-error', details)\n    const onUploadCancel: FileUploadProps['onUploadCancel'] = details => emit('upload-cancel', details)\n    const ctx = useFileUpload(withHandlers(withXhConfig('file-upload', useFormControlProps(props)), { onClear: () => emit('clear') }) as FileUploadProps, { onFilesChange, onFileAccept, onFileReject, onRemoteFilesChange, onUploadComplete, onUploadError, onUploadCancel })\n    provideFileUpload(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, !slots.default\n      ? renderDefaultStructure(ctx.api.value, { label: props.label, clearable: props.clearable }, { label: slots.label, dropzone: slots.dropzone })\n      : slots.default({\n          acceptedFiles: ctx.api.value.acceptedFiles,\n          remoteFiles: ctx.api.value.remoteFiles,\n          allFiles: ctx.api.value.allFiles,\n          uploadOf: ctx.api.value.uploadOf,\n          startUpload: ctx.api.value.startUpload,\n          cancelUpload: ctx.api.value.cancelUpload,\n          dragging: ctx.api.value.dragging,\n          empty: ctx.api.value.empty,\n          disabled: ctx.api.value.disabled,\n          maxFiles: ctx.api.value.maxFiles,\n          getFileSizeText: ctx.api.value.getFileSizeText,\n          setFiles: ctx.api.value.setFiles,\n          addFiles: ctx.api.value.addFiles,\n          deleteFile: ctx.api.value.deleteFile,\n          clear: ctx.api.value.clear,\n          openFilePicker: ctx.api.value.openFilePicker,\n        }))\n  },\n})\n\nexport const XhFileUploadLabel = defineComponent({\n  name: 'XhFileUploadLabel',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    // 用原生 label，getLabelProps 的 for 指向隐藏输入\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFileUploadDropzone = defineComponent({\n  name: 'XhFileUploadDropzone',\n  setup(_, { slots }) {\n    // 放进字段时字段的标签并进名字链、说明与错误文案进描述链；投放区是按钮，只取描述链，aria-invalid 由组件自己投影\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useFileUploadContext()\n    return () => h('div', fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getDropzoneProps() as Record<string, unknown> }), slots.default?.())\n  },\n})\n\nexport const XhFileUploadTrigger = defineComponent({\n  name: 'XhFileUploadTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useFileUploadContext()\n    return () => {\n      const part = mergePartProps(ctx.api.value.getTriggerProps() as Record<string, unknown>, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'file-upload')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhFileUploadHiddenInput = defineComponent({\n  name: 'XhFileUploadHiddenInput',\n  setup() {\n    // 隐藏输入也并进字段的标签：原生表单控件没有名字会被判为未标注\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useFileUploadContext()\n    return () => h('input', fieldLabel.value(ctx.api.value.getHiddenInputProps() as Record<string, unknown>))\n  },\n})\n\nexport const XhFileUploadList = defineComponent({\n  name: 'XhFileUploadList',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    return () => h('div', ctx.api.value.getListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFileUploadItem = defineComponent({\n  name: 'XhFileUploadItem',\n  props: {\n    /** 该行显示哪个文件（本地或远程附件）。 */\n    file: { type: Object as PropType<FileUploadFile> },\n    /** 改用下标从 allFiles（远程在前、本地在后）中取文件，兼收字符串以支持模板中写 index=\"0\"。 */\n    index: { type: [Number, String] as PropType<number | string> },\n  },\n  setup(props, { slots }) {\n    const ctx = useFileUploadContext()\n    const file = computed<FileUploadFile | undefined>(() => {\n      if (props.file)\n        return props.file\n      if (props.index == null)\n        return undefined\n      return ctx.api.value.allFiles[Math.trunc(Number(props.index))]\n    })\n    // 条目上下文，子部件从中取文件\n    const item = computed<FileUploadItemProps>(() => ({ file: file.value as FileUploadFile }))\n    provideFileUploadItem({ item })\n    return () => {\n      // 下标指向的文件不存在时只渲染空壳，不打组件属性也不渲染子部件\n      if (!file.value)\n        return h('div')\n      return h('div', ctx.api.value.getItemProps(item.value) as Record<string, unknown>, slots.default?.())\n    }\n  },\n})\n\nexport const XhFileUploadItemName = defineComponent({\n  name: 'XhFileUploadItemName',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    const { item } = useFileUploadItemContext()\n    // 有插槽用插槽，否则显示文件名\n    return () => h(\n      'span',\n      ctx.api.value.getItemNameProps(item.value) as Record<string, unknown>,\n      slots.default?.() ?? item.value.file.name,\n    )\n  },\n})\n\n/** 附件链接：指向文件的安全地址，未提供内容时显示文件名。 */\nexport const XhFileUploadItemLink = defineComponent({\n  name: 'XhFileUploadItemLink',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    const { item } = useFileUploadItemContext()\n    return () => h('a', ctx.api.value.getItemLinkProps(item.value) as Record<string, unknown>, slots.default?.() ?? item.value.file.name)\n  },\n})\n\nexport const XhFileUploadItemSizeText = defineComponent({\n  name: 'XhFileUploadItemSizeText',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    const { item } = useFileUploadItemContext()\n    // 有插槽用插槽，否则显示格式化后的文件大小\n    return () => h(\n      'span',\n      ctx.api.value.getItemSizeTextProps(item.value) as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.getFileSizeText(item.value.file),\n    )\n  },\n})\n\nexport const XhFileUploadItemPreview = defineComponent({\n  name: 'XhFileUploadItemPreview',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    const { item } = useFileUploadItemContext()\n    return () => h('div', ctx.api.value.getItemPreviewProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFileUploadItemProgress = defineComponent({\n  name: 'XhFileUploadItemProgress',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    const { item } = useFileUploadItemContext()\n    return () => h('div', ctx.api.value.getItemProgressProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFileUploadItemDeleteTrigger = defineComponent({\n  name: 'XhFileUploadItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    const { item } = useFileUploadItemContext()\n    return () => h(\n      'button',\n      ctx.api.value.getItemDeleteTriggerProps(item.value) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhFileUploadClearTrigger = defineComponent({\n  name: 'XhFileUploadClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useFileUploadContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst FILE_UPLOAD_PARTS = {\n  'label': XhFileUploadLabel,\n  'dropzone': XhFileUploadDropzone,\n  'hidden-input': XhFileUploadHiddenInput,\n  'list': XhFileUploadList,\n  'item': XhFileUploadItem,\n  'item-preview': XhFileUploadItemPreview,\n  'item-name': XhFileUploadItemName,\n  'item-link': XhFileUploadItemLink,\n  'item-size-text': XhFileUploadItemSizeText,\n  'item-progress': XhFileUploadItemProgress,\n  'item-delete-trigger': XhFileUploadItemDeleteTrigger,\n  'clear-trigger': XhFileUploadClearTrigger,\n}\n\ninterface FileUploadStructureSlots {\n  label?: () => VNode[]\n  dropzone?: () => VNode[]\n}\n\n/**\n * 未写默认插槽时铺开的整套结构，作者只提供数据：照 headless 的 fileUploadStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题与投放区的内容由对应插槽接管。\n */\nfunction renderDefaultStructure(api: FileUploadApi, options: { label?: string, clearable: boolean }, authored: FileUploadStructureSlots): VNode[] {\n  const nodes = fileUploadStructure(api, { ...options, slotted: name => authored[name as keyof FileUploadStructureSlots] != null })\n  return renderStructure(nodes, FILE_UPLOAD_PARTS, (node) => {\n    switch (node.slot?.name) {\n      case 'label':\n        return authored.label?.()\n      case 'dropzone':\n        return authored.dropzone?.()\n      default:\n        return undefined\n    }\n  })\n}\n"],"mappings":"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"}

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

@@ -1,7 +1,12 @@
-import { ComputedRef } from "vue";
 import { FileUploadApi, FileUploadSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/file-upload/use-file-upload.d.ts
 interface FileUploadContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhFileUploadLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<FileUploadApi>;
 }
 declare function useFileUpload(props: FileUploadSchema['props'], handlers?: Pick<FileUploadSchema['props'], 'onFilesChange' | 'onFileAccept' | 'onFileReject' | 'onRemoteFilesChange' | 'onUploadComplete' | 'onUploadError' | 'onUploadCancel'>): FileUploadContext;

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

@@ -1 +1 @@
-{"version":3,"file":"use-file-upload.d.ts","names":[],"sources":["../../../src/components/file-upload/use-file-upload.ts"],"mappings":";;;UAgBiB;EACf,KAAK,YAAY;;iBAGH,cACd,OAAO,2BACP,WAAU,KAAK,kKACd"}
+{"version":3,"file":"use-file-upload.d.ts","names":[],"sources":["../../../src/components/file-upload/use-file-upload.ts"],"mappings":";;;UAgBiB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;;iBAGH,cACd,OAAO,2BACP,WAAU,KAAK,kKACd"}

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

@@ -1,16 +1,22 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
-import { computed } from "vue";
-import { createScope } from "@xihan-ui/core";
 import { connectFileUpload, fileUploadMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
+import { createScope } from "@xihan-ui/core";
 //#region src/components/file-upload/use-file-upload.ts
 function useFileUpload(props, handlers = {}) {
+	const scope = createScope(null, createVueIdGenerator());
+	const labelCount = ref(0);
 	const service = useMachine(fileUploadMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		...handlers
-	}), createScope(null, createVueIdGenerator()));
-	return { api: computed(() => connectFileUpload(service, vueNormalize)) };
+	}), scope);
+	return {
+		labelCount,
+		api: computed(() => connectFileUpload(service, vueNormalize))
+	};
 }
 //#endregion
 export { useFileUpload };

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

@@ -1 +1 @@
-{"version":3,"file":"use-file-upload.js","names":[],"sources":["../../../src/components/file-upload/use-file-upload.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 file upload 相关实现。\n\nimport type { FileUploadApi, FileUploadSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectFileUpload, fileUploadMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface FileUploadContext {\n  api: ComputedRef<FileUploadApi>\n}\n\nexport function useFileUpload(\n  props: FileUploadSchema['props'],\n  handlers: Pick<FileUploadSchema['props'], 'onFilesChange' | 'onFileAccept' | 'onFileReject' | 'onRemoteFilesChange' | 'onUploadComplete' | 'onUploadError' | 'onUploadCancel'> = {},\n): FileUploadContext {\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 与隐藏输入不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(fileUploadMachine, () => ({ ...props, ...handlers }), scope)\n  const api = computed(() => connectFileUpload(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;;;AAoBA,SAAgB,cACd,OACA,WAAiL,CAAC,GAC/J;CAInB,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO,GAAG;CAAS,IAD/D,YAAY,MADZ,qBACsB,CACiD,CAAC;CAEtF,OAAO,EAAE,KADG,eAAe,kBAAkB,SAAS,YAAY,CACvD,EAAE;AACf"}
+{"version":3,"file":"use-file-upload.js","names":[],"sources":["../../../src/components/file-upload/use-file-upload.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 file upload 相关实现。\n\nimport type { FileUploadApi, FileUploadSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectFileUpload, fileUploadMachine } 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\nexport interface FileUploadContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhFileUploadLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<FileUploadApi>\n}\n\nexport function useFileUpload(\n  props: FileUploadSchema['props'],\n  handlers: Pick<FileUploadSchema['props'], 'onFilesChange' | 'onFileAccept' | 'onFileReject' | 'onRemoteFilesChange' | 'onUploadComplete' | 'onUploadError' | 'onUploadCancel'> = {},\n): FileUploadContext {\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 与隐藏输入不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const labelCount = ref(0)\n  const service = useMachine(fileUploadMachine, () => ({ ...props, labelled: labelCount.value > 0, ...handlers }), scope)\n  const api = computed(() => connectFileUpload(service, vueNormalize))\n  return { labelCount, api }\n}\n"],"mappings":";;;;;;;AAyBA,SAAgB,cACd,OACA,WAAiL,CAAC,GAC/J;CAGnB,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG,GAAG;CAAS,IAAI,KAAK;CAEtH,OAAO;EAAE;EAAY,KADT,eAAe,kBAAkB,SAAS,YAAY,CAC3C;CAAE;AAC3B"}

package/dist/components/filter-builder/context.js

@@ -0,0 +1,35 @@
+import { inject, provide } from "vue";
+//#region src/components/filter-builder/context.ts
+const KEY = Symbol.for("xh-filter-builder");
+const GROUP_KEY = Symbol.for("xh-filter-builder-group");
+const CONDITION_KEY = Symbol.for("xh-filter-builder-condition");
+function provideFilterBuilder(ctx) {
+	provide(KEY, ctx);
+}
+function useFilterBuilderContext() {
+	const ctx = inject(KEY, null);
+	if (!ctx) throw new Error("[xh] FilterBuilder 部件必须用在 XhFilterBuilderRoot 内");
+	return ctx;
+}
+/** 组把自己的路径交给组头、条目、组尾与里面的触发钮。 */
+function provideFilterBuilderGroup(path) {
+	provide(GROUP_KEY, path);
+}
+function useFilterBuilderGroup() {
+	const path = inject(GROUP_KEY, null);
+	if (!path) throw new Error("[xh] 组头、条目、组尾与组的触发钮必须用在 XhFilterBuilderGroup 内");
+	return path;
+}
+/** 条件把自己的路径交给行里的部件。 */
+function provideFilterBuilderCondition(path) {
+	provide(CONDITION_KEY, path);
+}
+function useFilterBuilderCondition() {
+	const path = inject(CONDITION_KEY, null);
+	if (!path) throw new Error("[xh] 条件行里的部件必须用在 XhFilterBuilderCondition 内");
+	return path;
+}
+//#endregion
+export { provideFilterBuilder, provideFilterBuilderCondition, provideFilterBuilderGroup, useFilterBuilderCondition, useFilterBuilderContext, useFilterBuilderGroup };
+
+//# sourceMappingURL=context.js.map