@xihan-ui/vue 2.1.0 → 3.1.0

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

@@ -1,10 +1,12 @@
-import { ComputedRef } from "vue";
+import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
 import { FieldArrayApi, FieldArraySchema, FormSchema } from "@xihan-ui/headless";
 //#region src/components/field-array/use-field-array.d.ts
 interface FieldArrayContext {
   api: ComputedRef<FieldArrayApi>;
   service: Service<FieldArraySchema>;
+  /** 行所在的根节点：列表动效接在它上面。 */
+  rootRef: Ref<HTMLElement | null>;
 }
 declare function useFieldArray(props: FieldArraySchema['props'], handlers?: Pick<FieldArraySchema['props'], 'onValueChange'>, form?: Service<FormSchema> | null): FieldArrayContext;
 //#endregion

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

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

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

@@ -1,7 +1,7 @@
 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 { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
 import { connectFieldArray, fieldArrayMachine } from "@xihan-ui/headless";
 //#region src/components/field-array/use-field-array.ts
@@ -11,9 +11,12 @@ function useFieldArray(props, handlers = {}, form) {
 		...handlers
 	}), createScope(null, createVueIdGenerator()));
 	service.refs.set("form", form ?? null);
+	const rootRef = ref(null);
+	service.refs.set("getRootEl", () => rootRef.value);
 	return {
 		api: computed(() => connectFieldArray(service, vueNormalize)),
-		service
+		service,
+		rootRef
 	};
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-field-array.js","names":[],"sources":["../../../src/components/field-array/use-field-array.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use field array 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { FieldArrayApi, FieldArraySchema, FormSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectFieldArray, fieldArrayMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface FieldArrayContext {\n  api: ComputedRef<FieldArrayApi>\n  service: Service<FieldArraySchema>\n}\n\nexport function useFieldArray(\n  props: FieldArraySchema['props'],\n  handlers: Pick<FieldArraySchema['props'], 'onValueChange'> = {},\n  form?: Service<FormSchema> | null,\n): FieldArrayContext {\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(fieldArrayMachine, () => ({ ...props, ...handlers }), scope)\n  service.refs.set('form', form ?? null)\n  const api = computed(() => connectFieldArray(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;;;AAsBA,SAAgB,cACd,OACA,WAA6D,CAAC,GAC9D,MACmB;CAInB,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO,GAAG;CAAS,IAD/D,YAAY,MADZ,qBACsB,CACiD,CAAC;CACtF,QAAQ,KAAK,IAAI,QAAQ,QAAQ,IAAI;CAErC,OAAO;EAAE,KADG,eAAe,kBAAkB,SAAS,YAAY,CACvD;EAAG;CAAQ;AACxB"}
+{"version":3,"file":"use-field-array.js","names":[],"sources":["../../../src/components/field-array/use-field-array.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use field array 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { FieldArrayApi, FieldArraySchema, FormSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectFieldArray, fieldArrayMachine } 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 FieldArrayContext {\n  api: ComputedRef<FieldArrayApi>\n  service: Service<FieldArraySchema>\n  /** 行所在的根节点：列表动效接在它上面。 */\n  rootRef: Ref<HTMLElement | null>\n}\n\nexport function useFieldArray(\n  props: FieldArraySchema['props'],\n  handlers: Pick<FieldArraySchema['props'], 'onValueChange'> = {},\n  form?: Service<FormSchema> | null,\n): FieldArrayContext {\n  // scope id 走 Vue 的 useId，保证同页多实例的 IDREF 不相撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(fieldArrayMachine, () => ({ ...props, ...handlers }), scope)\n  service.refs.set('form', form ?? null)\n  const rootRef = ref<HTMLElement | null>(null)\n  // 传 getter 而非节点本身，ref 在挂载后才有值\n  service.refs.set('getRootEl', () => rootRef.value)\n  const api = computed(() => connectFieldArray(service, vueNormalize))\n  return { api, service, rootRef }\n}\n"],"mappings":";;;;;;;AAwBA,SAAgB,cACd,OACA,WAA6D,CAAC,GAC9D,MACmB;CAInB,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO,GAAG;CAAS,IAD/D,YAAY,MADZ,qBACsB,CACiD,CAAC;CACtF,QAAQ,KAAK,IAAI,QAAQ,QAAQ,IAAI;CACrC,MAAM,UAAU,IAAwB,IAAI;CAE5C,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CAEjD,OAAO;EAAE,KADG,eAAe,kBAAkB,SAAS,YAAY,CACvD;EAAG;EAAS;CAAQ;AACjC"}

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

@@ -4,7 +4,7 @@ import { FileUploadApi, FileUploadFile, FileUploadRemoteFile, FileUploadSchema,
 //#region src/components/file-upload/file-upload.d.ts
 type FileUploadProps = FileUploadSchema['props'];
 /** 默认插槽的载荷：文件清单与传输快照、投放区与数量状态，以及增删清空、开始上传、拉起选择器等命令。 */
-type FileUploadRootSlotProps = Pick<FileUploadApi, 'acceptedFiles' | 'remoteFiles' | 'allFiles' | 'uploadOf' | 'startUpload' | 'dragging' | 'empty' | 'disabled' | 'maxFiles' | 'getFileSizeText' | 'setFiles' | 'addFiles' | 'deleteFile' | 'clear' | 'openFilePicker'>;
+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<{
   files: {
     type: PropType<File[]>;
@@ -52,6 +52,16 @@ declare const XhFileUploadRoot: import("vue").DefineComponent<import("vue").Extr
     type: BooleanConstructor;
     default: undefined;
   };
+  allowPaste: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  validate: {
+    type: PropType<FileUploadProps["validate"]>;
+  };
+  maxConcurrentUploads: {
+    type: NumberConstructor;
+  };
   directory: BooleanConstructor;
   capture: {
     type: PropType<"user" | "environment">;
@@ -62,6 +72,7 @@ declare const XhFileUploadRoot: import("vue").DefineComponent<import("vue").Extr
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  clear: () => true;
   'files-change': (_details: PayloadOf<FileUploadProps, "onFilesChange">) => true;
   'update:files': (_files: PayloadOf<FileUploadProps, "onFilesChange">["files"]) => true;
   'file-accept': (_details: PayloadOf<FileUploadProps, "onFileAccept">) => true;
@@ -70,6 +81,7 @@ declare const XhFileUploadRoot: import("vue").DefineComponent<import("vue").Extr
   'update:remoteFiles': (_files: PayloadOf<FileUploadProps, "onRemoteFilesChange">["files"]) => true;
   'upload-complete': (_details: PayloadOf<FileUploadProps, "onUploadComplete">) => true;
   'upload-error': (_details: PayloadOf<FileUploadProps, "onUploadError">) => true;
+  'upload-cancel': (_details: PayloadOf<FileUploadProps, "onUploadCancel">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   files: {
     type: PropType<File[]>;
@@ -117,6 +129,16 @@ declare const XhFileUploadRoot: import("vue").DefineComponent<import("vue").Extr
     type: BooleanConstructor;
     default: undefined;
   };
+  allowPaste: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  validate: {
+    type: PropType<FileUploadProps["validate"]>;
+  };
+  maxConcurrentUploads: {
+    type: NumberConstructor;
+  };
   directory: BooleanConstructor;
   capture: {
     type: PropType<"user" | "environment">;
@@ -125,6 +147,7 @@ declare const XhFileUploadRoot: import("vue").DefineComponent<import("vue").Extr
     type: PropType<Partial<FileUploadTranslations>>;
   };
 }>> & Readonly<{
+  onClear?: (() => any) | undefined;
   "onFiles-change"?: ((_details: import("@xihan-ui/headless").FileUploadFilesChangeDetails) => any) | undefined;
   "onUpdate:files"?: ((_files: File[]) => any) | undefined;
   "onFile-accept"?: ((_details: import("@xihan-ui/headless").FileUploadFileAcceptDetails) => any) | undefined;
@@ -133,12 +156,14 @@ declare const XhFileUploadRoot: import("vue").DefineComponent<import("vue").Extr
   "onUpdate:remoteFiles"?: ((_files: FileUploadRemoteFile[]) => any) | undefined;
   "onUpload-complete"?: ((_details: import("@xihan-ui/headless").FileUploadCompleteDetails) => any) | undefined;
   "onUpload-error"?: ((_details: import("@xihan-ui/headless").FileUploadErrorDetails) => any) | undefined;
+  "onUpload-cancel"?: ((_details: import("@xihan-ui/headless").FileUploadCancelDetails) => any) | undefined;
 }>, {
   invalid: boolean;
   disabled: boolean;
   directory: boolean;
   autoUpload: boolean;
   allowDrop: boolean;
+  allowPaste: boolean;
 }, SlotsType<{
   default?: (props: FileUploadRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

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

@@ -1 +1 @@
-{"version":3,"file":"file-upload.d.ts","names":[],"sources":["../../../src/components/file-upload/file-upload.ts"],"mappings":";;;;KAkBK,kBAAkB;;KAGX,0BAA0B,KACpC;cAkBW,gCAAgB,8BAAA;;IAKD,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACV,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IAClB,MAAA,SAAS;;;;;;;IAEF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASR,MAAA;;;IACK,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACT,gBAAA,UAAA,UAAU;EACV,gBAAA,UAAA,UAAU;EACF,wBAAA,UAAA,UAAU;EACb,uBAAA,QAAA,UAAU;EACX,oBAAA,UAAA,UAAU;EACb,iBAAA,UAAA,UAAU;;;IA3Bb,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACV,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IAClB,MAAA,SAAS;;;;;;;IAEF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASR,MAAA;;;IACK,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;;;;EAcvC,WAAC,OAAO,4BAA4B;kCAmChD;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;;;;;;;;;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":";;;;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"}

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

@@ -1,6 +1,7 @@
 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 { provideFileUpload, provideFileUploadItem, useFileUploadContext, useFileUploadItemContext } from "./context.js";
 import { useFileUpload } from "./use-file-upload.js";
@@ -35,11 +36,18 @@ const XhFileUploadRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		allowPaste: {
+			type: Boolean,
+			default: void 0
+		},
+		validate: { type: Function },
+		maxConcurrentUploads: { type: Number },
 		directory: Boolean,
 		capture: { type: String },
 		translations: { type: Object }
 	},
 	emits: {
+		"clear": () => true,
 		"files-change": (_details) => true,
 		"update:files": (_files) => true,
 		"file-accept": (_details) => true,
@@ -47,7 +55,8 @@ const XhFileUploadRoot = defineComponent({
 		"remote-files-change": (_details) => true,
 		"update:remoteFiles": (_files) => true,
 		"upload-complete": (_details) => true,
-		"upload-error": (_details) => true
+		"upload-error": (_details) => true,
+		"upload-cancel": (_details) => true
 	},
 	slots: Object,
 	setup(props, { slots, emit }) {
@@ -63,13 +72,15 @@ const XhFileUploadRoot = defineComponent({
 		};
 		const onUploadComplete = (details) => emit("upload-complete", details);
 		const onUploadError = (details) => emit("upload-error", details);
-		const ctx = useFileUpload(withXhConfig("file-upload", useFormControlProps(props)), {
+		const onUploadCancel = (details) => emit("upload-cancel", details);
+		const ctx = useFileUpload(withHandlers(withXhConfig("file-upload", useFormControlProps(props)), { onClear: () => emit("clear") }), {
 			onFilesChange,
 			onFileAccept,
 			onFileReject,
 			onRemoteFilesChange,
 			onUploadComplete,
-			onUploadError
+			onUploadError,
+			onUploadCancel
 		});
 		provideFileUpload(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
@@ -78,6 +89,7 @@ const XhFileUploadRoot = defineComponent({
 			allFiles: ctx.api.value.allFiles,
 			uploadOf: ctx.api.value.uploadOf,
 			startUpload: ctx.api.value.startUpload,
+			cancelUpload: ctx.api.value.cancelUpload,
 			dragging: ctx.api.value.dragging,
 			empty: ctx.api.value.empty,
 			disabled: ctx.api.value.disabled,

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 { 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  | '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    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    '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  },\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 ctx = useFileUpload(withXhConfig('file-upload', useFormControlProps(props)) as FileUploadProps, { onFilesChange, onFileAccept, onFileReject, onRemoteFilesChange, onUploadComplete, onUploadError })\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      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 { 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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"}

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

@@ -4,7 +4,7 @@ import { FileUploadApi, FileUploadSchema } from "@xihan-ui/headless";
 interface FileUploadContext {
   api: ComputedRef<FileUploadApi>;
 }
-declare function useFileUpload(props: FileUploadSchema['props'], handlers?: Pick<FileUploadSchema['props'], 'onFilesChange' | 'onFileAccept' | 'onFileReject' | 'onRemoteFilesChange' | 'onUploadComplete' | 'onUploadError'>): FileUploadContext;
+declare function useFileUpload(props: FileUploadSchema['props'], handlers?: Pick<FileUploadSchema['props'], 'onFilesChange' | 'onFileAccept' | 'onFileReject' | 'onRemoteFilesChange' | 'onUploadComplete' | 'onUploadError' | 'onUploadCancel'>): FileUploadContext;
 //#endregion
 export { FileUploadContext, useFileUpload };
 //# sourceMappingURL=use-file-upload.d.ts.map

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,+IACd"}
+{"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"}

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'> = {},\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,WAA8J,CAAC,GAC5I;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 } 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"}

package/dist/components/flex/flex.d.ts

@@ -41,8 +41,8 @@ declare const XhFlex: import("vue").DefineComponent<import("vue").ExtractPropTyp
   wrap: BooleanConstructor;
   inline: BooleanConstructor;
 }>> & Readonly<{}>, {
-  wrap: boolean;
   inline: boolean;
+  wrap: boolean;
 }, SlotsType<{
   /** 子项，按写入的顺序排列。 */
   default?: () => VNode[];

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

@@ -1 +1 @@
-{"version":3,"file":"flex.d.ts","names":[],"sources":["../../../src/components/flex/flex.ts"],"mappings":";;;;;;;cAkBa,2BAAW,0BAAA,oBAAA,4BAAA;;8BAMtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAyCW,sBAAM,8BAAA;;IAIgB,MAAA,SAAS;;;IACf,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACb,MAAA,SAAS;;;;;;;;IAHD,MAAA,SAAS;;;IACf,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACb,MAAA,SAAS;;;;;;;;;EAMtB,gBAAM;;EAER,cAAM;kCAYhB"}
+{"version":3,"file":"flex.d.ts","names":[],"sources":["../../../src/components/flex/flex.ts"],"mappings":";;;;;;;cAkBa,2BAAW,0BAAA,oBAAA,4BAAA;;8BAMtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAyCW,sBAAM,8BAAA;;IAK0B,MAAA,SAAS;;;IACf,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACb,MAAA,SAAS;;;;;;;;IAHD,MAAA,SAAS;;;IACf,MAAA,SAAS;;;IACP,MAAA,SAAS;;;IACb,MAAA,SAAS;;;;;;;;;EAMhC,gBAAM;;EAER,cAAM;kCAYhB"}

package/dist/components/flex/flex.js

@@ -51,10 +51,10 @@ function interleave(items, split) {
 const XhFlex = defineComponent({
 	name: "XhFlex",
 	props: {
-		orientation: { type: String },
-		align: { type: String },
-		justify: { type: String },
-		gap: { type: String },
+		orientation: { type: [String, Object] },
+		align: { type: [String, Object] },
+		justify: { type: [String, Object] },
+		gap: { type: [String, Object] },
 		wrap: Boolean,
 		inline: Boolean
 	},

package/dist/components/flex/flex.js.map

@@ -1 +1 @@
-{"version":3,"file":"flex.js","names":[],"sources":["../../../src/components/flex/flex.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// 提供 flex 相关实现。\n\nimport type { FlexProps } from '@xihan-ui/headless'\nimport type { PropType, Slot, SlotsType, VNode } from 'vue'\nimport { connectFlex } from '@xihan-ui/headless'\nimport { Comment, computed, defineComponent, Fragment, h, Text } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideFlex, useFlexContext } from './context'\n\n/**\n * 分隔符部件。写 `split` 插槽时组件在每道缝隙中自动铺设一个，\n * 手写它也能得到同一种结构：两条路径产出的 DOM 完全一致。\n */\nexport const XhFlexSplit = defineComponent({\n  name: 'XhFlexSplit',\n  setup(_, { slots }) {\n    const ctx = useFlexContext()\n    return () => h('span', ctx.api.value.getSplitProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 把默认插槽摊平为一个个子项。\n *\n * `v-for` 产出的是一个片段而不是若干节点，不摊平就整段算一个子项，分隔符只会插在整段的两端；\n * `v-if` 为假留下的注释节点与模板缩进留下的空白文本不渲染任何像素，保留会插出两条相邻的分隔符。\n */\nfunction flexItems(nodes: readonly VNode[]): VNode[] {\n  const items: VNode[] = []\n  for (const node of nodes) {\n    if (node.type === Comment)\n      continue\n    if (node.type === Text) {\n      if (String(node.children ?? '').trim() !== '')\n        items.push(node)\n      continue\n    }\n    if (node.type === Fragment && Array.isArray(node.children)) {\n      items.push(...flexItems(node.children as VNode[]))\n      continue\n    }\n    items.push(node)\n  }\n  return items\n}\n\n/**\n * 在每两个子项之间铺设一个分隔符部件。\n * 插槽逐缝隙重新求值：同一份 vnode 挂在两处会被后一处替换。\n */\nfunction interleave(items: readonly VNode[], split: Slot): VNode[] {\n  const out: VNode[] = []\n  items.forEach((item, index) => {\n    if (index > 0)\n      out.push(h(XhFlexSplit, { key: `xh-flex-split-${index}` }, () => split()))\n    out.push(item)\n  })\n  return out\n}\n\nexport const XhFlex = defineComponent({\n  name: 'XhFlex',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    orientation: { type: String as PropType<FlexProps['orientation']> },\n    align: { type: String as PropType<FlexProps['align']> },\n    justify: { type: String as PropType<FlexProps['justify']> },\n    gap: { type: String as PropType<FlexProps['gap']> },\n    wrap: Boolean,\n    inline: Boolean,\n  },\n  slots: Object as SlotsType<{\n    /** 子项，按写入的顺序排列。 */\n    default?: () => VNode[]\n    /** 分隔符的内容：写了它，组件在每两个子项之间各铺设一个分隔符部件，逐缝隙重新求值一次。 */\n    split?: () => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const api = computed(() => connectFlex(props as FlexProps, vueNormalize))\n    provideFlex({ api })\n    return () => {\n      const children = slots.default?.() ?? []\n      // 没写分隔符插槽时原样交出去，不摊平：摊平会打散 v-for 的片段，白白丢掉它的复用信息\n      const content = slots.split ? interleave(flexItems(children), slots.split) : children\n      return h('div', api.value.getRootProps() as Record<string, unknown>, content)\n    }\n  },\n})\n"],"mappings":";;;;;;;;;AAkBA,MAAa,cAAc,gBAAgB;CACzC,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC;;;;;;;AAQD,SAAS,UAAU,OAAkC;CACnD,MAAM,QAAiB,CAAC;CACxB,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,KAAK,SAAS,SAChB;EACF,IAAI,KAAK,SAAS,MAAM;GACtB,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC,CAAC,KAAK,MAAM,IACzC,MAAM,KAAK,IAAI;GACjB;EACF;EACA,IAAI,KAAK,SAAS,YAAY,MAAM,QAAQ,KAAK,QAAQ,GAAG;GAC1D,MAAM,KAAK,GAAG,UAAU,KAAK,QAAmB,CAAC;GACjD;EACF;EACA,MAAM,KAAK,IAAI;CACjB;CACA,OAAO;AACT;;;;;AAMA,SAAS,WAAW,OAAyB,OAAsB;CACjE,MAAM,MAAe,CAAC;CACtB,MAAM,SAAS,MAAM,UAAU;EAC7B,IAAI,QAAQ,GACV,IAAI,KAAK,EAAE,aAAa,EAAE,KAAK,iBAAiB,QAAQ,SAAS,MAAM,CAAC,CAAC;EAC3E,IAAI,KAAK,IAAI;CACf,CAAC;CACD,OAAO;AACT;AAEA,MAAa,SAAS,gBAAgB;CACpC,MAAM;CAEN,OAAO;EACL,aAAa,EAAE,MAAM,OAA6C;EAClE,OAAO,EAAE,MAAM,OAAuC;EACtD,SAAS,EAAE,MAAM,OAAyC;EAC1D,KAAK,EAAE,MAAM,OAAqC;EAClD,MAAM;EACN,QAAQ;CACV;CACA,OAAO;CAMP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe,YAAY,OAAoB,YAAY,CAAC;EACxE,YAAY,EAAE,IAAI,CAAC;EACnB,aAAa;GACX,MAAM,WAAW,MAAM,UAAU,KAAK,CAAC;GAEvC,MAAM,UAAU,MAAM,QAAQ,WAAW,UAAU,QAAQ,GAAG,MAAM,KAAK,IAAI;GAC7E,OAAO,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,OAAO;EAC9E;CACF;AACF,CAAC"}
+{"version":3,"file":"flex.js","names":[],"sources":["../../../src/components/flex/flex.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// 提供 flex 相关实现。\n\nimport type { FlexProps } from '@xihan-ui/headless'\nimport type { PropType, Slot, SlotsType, VNode } from 'vue'\nimport { connectFlex } from '@xihan-ui/headless'\nimport { Comment, computed, defineComponent, Fragment, h, Text } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideFlex, useFlexContext } from './context'\n\n/**\n * 分隔符部件。写 `split` 插槽时组件在每道缝隙中自动铺设一个，\n * 手写它也能得到同一种结构：两条路径产出的 DOM 完全一致。\n */\nexport const XhFlexSplit = defineComponent({\n  name: 'XhFlexSplit',\n  setup(_, { slots }) {\n    const ctx = useFlexContext()\n    return () => h('span', ctx.api.value.getSplitProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 把默认插槽摊平为一个个子项。\n *\n * `v-for` 产出的是一个片段而不是若干节点，不摊平就整段算一个子项，分隔符只会插在整段的两端；\n * `v-if` 为假留下的注释节点与模板缩进留下的空白文本不渲染任何像素，保留会插出两条相邻的分隔符。\n */\nfunction flexItems(nodes: readonly VNode[]): VNode[] {\n  const items: VNode[] = []\n  for (const node of nodes) {\n    if (node.type === Comment)\n      continue\n    if (node.type === Text) {\n      if (String(node.children ?? '').trim() !== '')\n        items.push(node)\n      continue\n    }\n    if (node.type === Fragment && Array.isArray(node.children)) {\n      items.push(...flexItems(node.children as VNode[]))\n      continue\n    }\n    items.push(node)\n  }\n  return items\n}\n\n/**\n * 在每两个子项之间铺设一个分隔符部件。\n * 插槽逐缝隙重新求值：同一份 vnode 挂在两处会被后一处替换。\n */\nfunction interleave(items: readonly VNode[], split: Slot): VNode[] {\n  const out: VNode[] = []\n  items.forEach((item, index) => {\n    if (index > 0)\n      out.push(h(XhFlexSplit, { key: `xh-flex-split-${index}` }, () => split()))\n    out.push(item)\n  })\n  return out\n}\n\nexport const XhFlex = defineComponent({\n  name: 'XhFlex',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    // 四条排版轴都兼收断点对象，逐档写各自的取值\n    orientation: { type: [String, Object] as PropType<FlexProps['orientation']> },\n    align: { type: [String, Object] as PropType<FlexProps['align']> },\n    justify: { type: [String, Object] as PropType<FlexProps['justify']> },\n    gap: { type: [String, Object] as PropType<FlexProps['gap']> },\n    wrap: Boolean,\n    inline: Boolean,\n  },\n  slots: Object as SlotsType<{\n    /** 子项，按写入的顺序排列。 */\n    default?: () => VNode[]\n    /** 分隔符的内容：写了它，组件在每两个子项之间各铺设一个分隔符部件，逐缝隙重新求值一次。 */\n    split?: () => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const api = computed(() => connectFlex(props as FlexProps, vueNormalize))\n    provideFlex({ api })\n    return () => {\n      const children = slots.default?.() ?? []\n      // 没写分隔符插槽时原样交出去，不摊平：摊平会打散 v-for 的片段，白白丢掉它的复用信息\n      const content = slots.split ? interleave(flexItems(children), slots.split) : children\n      return h('div', api.value.getRootProps() as Record<string, unknown>, content)\n    }\n  },\n})\n"],"mappings":";;;;;;;;;AAkBA,MAAa,cAAc,gBAAgB;CACzC,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC;;;;;;;AAQD,SAAS,UAAU,OAAkC;CACnD,MAAM,QAAiB,CAAC;CACxB,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,KAAK,SAAS,SAChB;EACF,IAAI,KAAK,SAAS,MAAM;GACtB,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC,CAAC,KAAK,MAAM,IACzC,MAAM,KAAK,IAAI;GACjB;EACF;EACA,IAAI,KAAK,SAAS,YAAY,MAAM,QAAQ,KAAK,QAAQ,GAAG;GAC1D,MAAM,KAAK,GAAG,UAAU,KAAK,QAAmB,CAAC;GACjD;EACF;EACA,MAAM,KAAK,IAAI;CACjB;CACA,OAAO;AACT;;;;;AAMA,SAAS,WAAW,OAAyB,OAAsB;CACjE,MAAM,MAAe,CAAC;CACtB,MAAM,SAAS,MAAM,UAAU;EAC7B,IAAI,QAAQ,GACV,IAAI,KAAK,EAAE,aAAa,EAAE,KAAK,iBAAiB,QAAQ,SAAS,MAAM,CAAC,CAAC;EAC3E,IAAI,KAAK,IAAI;CACf,CAAC;CACD,OAAO;AACT;AAEA,MAAa,SAAS,gBAAgB;CACpC,MAAM;CAEN,OAAO;EAEL,aAAa,EAAE,MAAM,CAAC,QAAQ,MAAM,EAAwC;EAC5E,OAAO,EAAE,MAAM,CAAC,QAAQ,MAAM,EAAkC;EAChE,SAAS,EAAE,MAAM,CAAC,QAAQ,MAAM,EAAoC;EACpE,KAAK,EAAE,MAAM,CAAC,QAAQ,MAAM,EAAgC;EAC5D,MAAM;EACN,QAAQ;CACV;CACA,OAAO;CAMP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe,YAAY,OAAoB,YAAY,CAAC;EACxE,YAAY,EAAE,IAAI,CAAC;EACnB,aAAa;GACX,MAAM,WAAW,MAAM,UAAU,KAAK,CAAC;GAEvC,MAAM,UAAU,MAAM,QAAQ,WAAW,UAAU,QAAQ,GAAG,MAAM,KAAK,IAAI;GAC7E,OAAO,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,OAAO;EAC9E;CACF;AACF,CAAC"}

package/dist/components/float-button/float-button.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { ActionVariant, Direction, Size, Tone } from "@xihan-ui/core";
-import { FloatButtonApi, FloatButtonExpandTrigger, FloatButtonPlacement, FloatButtonProps, FloatButtonTranslations } from "@xihan-ui/headless";
+import { FloatButtonApi, FloatButtonExpandTrigger, FloatButtonPlacement, FloatButtonPosition, FloatButtonProps, FloatButtonSnap, FloatButtonTranslations } from "@xihan-ui/headless";
 //#region src/components/float-button/float-button.d.ts
 /** 默认插槽的载荷：展开组当前是否显示，以及改写展开状态的动作。 */
 type FloatButtonRootSlotProps = Pick<FloatButtonApi, 'open' | 'setOpen'>;
@@ -22,6 +22,16 @@ declare const XhFloatButtonRoot: import("vue").DefineComponent<import("vue").Ext
   offset: {
     type: NumberConstructor;
   };
+  draggable: BooleanConstructor;
+  snap: {
+    type: PropType<FloatButtonSnap>;
+  };
+  position: {
+    type: PropType<FloatButtonPosition>;
+  };
+  defaultPosition: {
+    type: PropType<FloatButtonPosition>;
+  };
   expandTrigger: {
     type: PropType<FloatButtonExpandTrigger>;
   };
@@ -42,6 +52,8 @@ declare const XhFloatButtonRoot: import("vue").DefineComponent<import("vue").Ext
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'open-change': (_details: PayloadOf<FloatButtonProps, "onOpenChange">) => true;
   'update:open': (_open: PayloadOf<FloatButtonProps, "onOpenChange">["open"]) => true;
+  'position-change': (_details: PayloadOf<FloatButtonProps, "onPositionChange">) => true;
+  'update:position': (_position: PayloadOf<FloatButtonProps, "onPositionChange">["position"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   open: {
     type: BooleanConstructor;
@@ -58,6 +70,16 @@ declare const XhFloatButtonRoot: import("vue").DefineComponent<import("vue").Ext
   offset: {
     type: NumberConstructor;
   };
+  draggable: BooleanConstructor;
+  snap: {
+    type: PropType<FloatButtonSnap>;
+  };
+  position: {
+    type: PropType<FloatButtonPosition>;
+  };
+  defaultPosition: {
+    type: PropType<FloatButtonPosition>;
+  };
   expandTrigger: {
     type: PropType<FloatButtonExpandTrigger>;
   };
@@ -76,10 +98,13 @@ declare const XhFloatButtonRoot: import("vue").DefineComponent<import("vue").Ext
 }>> & Readonly<{
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").CollapsibleOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
+  "onPosition-change"?: ((_details: import("@xihan-ui/headless").FloatButtonPositionChangeDetails) => any) | undefined;
+  "onUpdate:position"?: ((_position: FloatButtonPosition) => any) | undefined;
 }>, {
   disabled: boolean;
   open: boolean;
   defaultOpen: boolean;
+  draggable: boolean;
 }, SlotsType<{
   default?: (props: FloatButtonRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/components/float-button/float-button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"float-button.d.ts","names":[],"sources":["../../../src/components/float-button/float-button.ts"],"mappings":";;;;;;KAwBY,2BAA2B,KAAK;;cAG/B,iCAAiB,8BAAA;;;;;;;;IAOH,MAAA,SAAS;;;IACH,MAAA,SAAS;;;;;;IAEL,MAAA,SAAS;;;IACf,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAIvB,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;IAZV,MAAA,SAAS;;;IACH,MAAA,SAAS;;;;;;IAEL,MAAA,SAAS;;;IACf,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;EAQvC,WAAC,OAAO,6BAA6B;kCAgBjD;;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"float-button.d.ts","names":[],"sources":["../../../src/components/float-button/float-button.ts"],"mappings":";;;;;;KA0BY,2BAA2B,KAAK;;cAG/B,iCAAiB,8BAAA;;;;;;;;IAOH,MAAA,SAAS;;;IACH,MAAA,SAAS;;;;;;;IAGd,MAAA,SAAS;;;IACL,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACX,MAAA,SAAS;;;IACf,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAIvB,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACH,oBAAA,UAAA,UAAU;EACT,oBAAA,WAAA,UAAU;;;;;;;;;IAlBlB,MAAA,SAAS;;;IACH,MAAA,SAAS;;;;;;;IAGd,MAAA,SAAS;;;IACL,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACX,MAAA,SAAS;;;IACf,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;EAUvC,WAAC,OAAO,6BAA6B;kCAoBjD;;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/float-button/float-button.js

@@ -16,6 +16,10 @@ const XhFloatButtonRoot = defineComponent({
 		dir: { type: String },
 		placement: { type: String },
 		offset: { type: Number },
+		draggable: Boolean,
+		snap: { type: String },
+		position: { type: Object },
+		defaultPosition: { type: Object },
 		expandTrigger: { type: String },
 		variant: { type: String },
 		tone: { type: String },
@@ -24,14 +28,22 @@ const XhFloatButtonRoot = defineComponent({
 	},
 	emits: {
 		"open-change": (_details) => true,
-		"update:open": (_open) => true
+		"update:open": (_open) => true,
+		"position-change": (_details) => true,
+		"update:position": (_position) => true
 	},
 	slots: Object,
 	setup(props, { slots, emit }) {
-		const ctx = useFloatButton(withXhConfig("float-button", props), { onOpenChange: (details) => {
-			emit("open-change", details);
-			emit("update:open", details.open);
-		} });
+		const ctx = useFloatButton(withXhConfig("float-button", props), {
+			onOpenChange: (details) => {
+				emit("open-change", details);
+				emit("update:open", details.open);
+			},
+			onPositionChange: (details) => {
+				emit("position-change", details);
+				emit("update:position", details.position);
+			}
+		});
 		provideFloatButton(ctx);
 		return () => h("div", {
 			...ctx.api.value.getRootProps(),

package/dist/components/float-button/float-button.js.map

@@ -1 +1 @@
-{"version":3,"file":"float-button.js","names":[],"sources":["../../../src/components/float-button/float-button.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// 提供 float button 相关实现。\n\nimport type { ActionVariant, Direction, Size, Tone } from '@xihan-ui/core'\nimport type {\n  FloatButtonApi,\n  FloatButtonExpandTrigger,\n  FloatButtonNotifiers,\n  FloatButtonPlacement,\n  FloatButtonProps,\n  FloatButtonTranslations,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideFloatButton, useFloatButtonContext } from './context'\nimport { useFloatButton } from './use-float-button'\n\n/** 默认插槽的载荷：展开组当前是否显示，以及改写展开状态的动作。 */\nexport type FloatButtonRootSlotProps = Pick<FloatButtonApi, 'open' | 'setOpen'>\n\n/** 根节点是定位壳：把整组固定在视口一角，悬停展开时以进出它为准。 */\nexport const XhFloatButtonRoot = defineComponent({\n  name: 'XhFloatButtonRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    disabled: Boolean,\n    dir: { type: String as PropType<Direction> },\n    placement: { type: String as PropType<FloatButtonPlacement> },\n    offset: { type: Number },\n    expandTrigger: { type: String as PropType<FloatButtonExpandTrigger> },\n    variant: { type: String as PropType<ActionVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<FloatButtonTranslations>> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<FloatButtonProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<FloatButtonProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: FloatButtonRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: FloatButtonNotifiers = {\n      onOpenChange: (details) => {\n        emit('open-change', details)\n        emit('update:open', details.open)\n      },\n    }\n    const ctx = useFloatButton(withXhConfig('float-button', props) as FloatButtonProps, notify)\n    provideFloatButton(ctx)\n    return () => h('div', { ...ctx.api.value.getRootProps() as Record<string, unknown>, ref: ctx.rootRef }, slots.default?.({\n      open: ctx.api.value.open,\n      setOpen: ctx.api.value.setOpen,\n    }))\n  },\n})\n\n/** 原生 button：Enter / Space 的激活与 Tab 停靠都由平台提供。 */\nexport const XhFloatButtonTrigger = defineComponent({\n  name: 'XhFloatButtonTrigger',\n  setup(_, { slots }) {\n    const ctx = useFloatButtonContext()\n    return () => h('button', ctx.api.value.getTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 展开的动作组；收起时带 hidden，其中的按钮一并退出 Tab 序列。 */\nexport const XhFloatButtonList = defineComponent({\n  name: 'XhFloatButtonList',\n  setup(_, { slots }) {\n    const ctx = useFloatButtonContext()\n    return () => h('div', ctx.api.value.getListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AA2BA,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CAEN,OAAO;EACL,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;EACb,UAAU;EACV,KAAK,EAAE,MAAM,OAA8B;EAC3C,WAAW,EAAE,MAAM,OAAyC;EAC5D,QAAQ,EAAE,MAAM,OAAO;EACvB,eAAe,EAAE,MAAM,OAA6C;EACpE,SAAS,EAAE,MAAM,OAAkC;EACnD,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAAqD;CAC7E;CAEA,OAAO;EACL,gBAAgB,aAA0D;EAC1E,gBAAgB,UAA+D;CACjF;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAO5B,MAAM,MAAM,eAAe,aAAa,gBAAgB,KAAK,GAAuB,EALlF,eAAe,YAAY;GACzB,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC,EAEuF,CAAC;EAC1F,mBAAmB,GAAG;EACtB,aAAa,EAAE,OAAO;GAAE,GAAG,IAAI,IAAI,MAAM,aAAa;GAA8B,KAAK,IAAI;EAAQ,GAAG,MAAM,UAAU;GACtH,MAAM,IAAI,IAAI,MAAM;GACpB,SAAS,IAAI,IAAI,MAAM;EACzB,CAAC,CAAC;CACJ;AACF,CAAC;;AAGD,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC"}
+{"version":3,"file":"float-button.js","names":[],"sources":["../../../src/components/float-button/float-button.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// 提供 float button 相关实现。\n\nimport type { ActionVariant, Direction, Size, Tone } from '@xihan-ui/core'\nimport type {\n  FloatButtonApi,\n  FloatButtonExpandTrigger,\n  FloatButtonNotifiers,\n  FloatButtonPlacement,\n  FloatButtonPosition,\n  FloatButtonProps,\n  FloatButtonSnap,\n  FloatButtonTranslations,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideFloatButton, useFloatButtonContext } from './context'\nimport { useFloatButton } from './use-float-button'\n\n/** 默认插槽的载荷：展开组当前是否显示，以及改写展开状态的动作。 */\nexport type FloatButtonRootSlotProps = Pick<FloatButtonApi, 'open' | 'setOpen'>\n\n/** 根节点是定位壳：把整组固定在视口一角，悬停展开时以进出它为准。 */\nexport const XhFloatButtonRoot = defineComponent({\n  name: 'XhFloatButtonRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    disabled: Boolean,\n    dir: { type: String as PropType<Direction> },\n    placement: { type: String as PropType<FloatButtonPlacement> },\n    offset: { type: Number },\n    draggable: Boolean,\n    snap: { type: String as PropType<FloatButtonSnap> },\n    position: { type: Object as PropType<FloatButtonPosition> },\n    defaultPosition: { type: Object as PropType<FloatButtonPosition> },\n    expandTrigger: { type: String as PropType<FloatButtonExpandTrigger> },\n    variant: { type: String as PropType<ActionVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<FloatButtonTranslations>> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔；position-change 携带 { position }，update:position 携带裸位置\n  emits: {\n    'open-change': (_details: PayloadOf<FloatButtonProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<FloatButtonProps, 'onOpenChange'>['open']) => true,\n    'position-change': (_details: PayloadOf<FloatButtonProps, 'onPositionChange'>) => true,\n    'update:position': (_position: PayloadOf<FloatButtonProps, 'onPositionChange'>['position']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: FloatButtonRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: FloatButtonNotifiers = {\n      onOpenChange: (details) => {\n        emit('open-change', details)\n        emit('update:open', details.open)\n      },\n      onPositionChange: (details) => {\n        emit('position-change', details)\n        emit('update:position', details.position)\n      },\n    }\n    const ctx = useFloatButton(withXhConfig('float-button', props) as FloatButtonProps, notify)\n    provideFloatButton(ctx)\n    return () => h('div', { ...ctx.api.value.getRootProps() as Record<string, unknown>, ref: ctx.rootRef }, slots.default?.({\n      open: ctx.api.value.open,\n      setOpen: ctx.api.value.setOpen,\n    }))\n  },\n})\n\n/** 原生 button：Enter / Space 的激活与 Tab 停靠都由平台提供。 */\nexport const XhFloatButtonTrigger = defineComponent({\n  name: 'XhFloatButtonTrigger',\n  setup(_, { slots }) {\n    const ctx = useFloatButtonContext()\n    return () => h('button', ctx.api.value.getTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 展开的动作组；收起时带 hidden，其中的按钮一并退出 Tab 序列。 */\nexport const XhFloatButtonList = defineComponent({\n  name: 'XhFloatButtonList',\n  setup(_, { slots }) {\n    const ctx = useFloatButtonContext()\n    return () => h('div', ctx.api.value.getListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AA6BA,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CAEN,OAAO;EACL,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;EACb,UAAU;EACV,KAAK,EAAE,MAAM,OAA8B;EAC3C,WAAW,EAAE,MAAM,OAAyC;EAC5D,QAAQ,EAAE,MAAM,OAAO;EACvB,WAAW;EACX,MAAM,EAAE,MAAM,OAAoC;EAClD,UAAU,EAAE,MAAM,OAAwC;EAC1D,iBAAiB,EAAE,MAAM,OAAwC;EACjE,eAAe,EAAE,MAAM,OAA6C;EACpE,SAAS,EAAE,MAAM,OAAkC;EACnD,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAAqD;CAC7E;CAEA,OAAO;EACL,gBAAgB,aAA0D;EAC1E,gBAAgB,UAA+D;EAC/E,oBAAoB,aAA8D;EAClF,oBAAoB,cAA2E;CACjG;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAW5B,MAAM,MAAM,eAAe,aAAa,gBAAgB,KAAK,GAAuB;GATlF,eAAe,YAAY;IACzB,KAAK,eAAe,OAAO;IAC3B,KAAK,eAAe,QAAQ,IAAI;GAClC;GACA,mBAAmB,YAAY;IAC7B,KAAK,mBAAmB,OAAO;IAC/B,KAAK,mBAAmB,QAAQ,QAAQ;GAC1C;EAEuF,CAAC;EAC1F,mBAAmB,GAAG;EACtB,aAAa,EAAE,OAAO;GAAE,GAAG,IAAI,IAAI,MAAM,aAAa;GAA8B,KAAK,IAAI;EAAQ,GAAG,MAAM,UAAU;GACtH,MAAM,IAAI,IAAI,MAAM;GACpB,SAAS,IAAI,IAAI,MAAM;EACzB,CAAC,CAAC;CACJ;AACF,CAAC;;AAGD,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC"}

package/dist/components/float-button/use-float-button.js

@@ -17,7 +17,13 @@ function useFloatButton(props, notify) {
 		defaultOpen: props.defaultOpen,
 		disabled: props.disabled,
 		expandTrigger: props.expandTrigger,
-		onOpenChange: notify?.onOpenChange
+		offset: props.offset,
+		draggable: props.draggable,
+		snap: props.snap,
+		position: props.position,
+		defaultPosition: props.defaultPosition,
+		onOpenChange: notify?.onOpenChange,
+		onPositionChange: notify?.onPositionChange
 	}), scope);
 	let config = null;
 	if (typeof document !== "undefined") {

package/dist/components/float-button/use-float-button.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-float-button.js","names":[],"sources":["../../../src/components/float-button/use-float-button.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 float button 相关实现。\n\nimport type { Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { FloatButtonApi, FloatButtonNotifiers, FloatButtonProps, FloatButtonSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectFloatButton, floatButtonMachine } 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 FloatButtonContext {\n  api: ComputedRef<FloatButtonApi>\n  service: Service<FloatButtonSchema>\n  rootRef: Ref<HTMLElement | null>\n}\n\n/**\n * 专用状态机持有开合与逻辑层生命周期；Vue 只桥接所属 Document 的配置、登记函数与 root ref。\n */\nexport function useFloatButton(\n  props: FloatButtonProps,\n  notify?: FloatButtonNotifiers,\n): FloatButtonContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const rootRef = ref<HTMLElement | null>(null)\n\n  const service = useMachine(floatButtonMachine, (): FloatButtonSchema['props'] => ({\n    open: props.open,\n    defaultOpen: props.defaultOpen,\n    disabled: props.disabled,\n    expandTrigger: props.expandTrigger,\n    onOpenChange: notify?.onOpenChange,\n  }), scope)\n\n  let config: RuntimeConfig | null = null\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n    const registerLayer = (\n      layer: Omit<Layer, 'id'>,\n    ): ReturnType<RuntimeConfig['layerRegistry']['register']> => config!.layerRegistry.register(layer)\n    service.refs.set('config', config)\n    service.refs.set('registerLayer', registerLayer)\n  }\n  service.refs.set('getRootEl', () => rootRef.value)\n\n  const api = computed(() => connectFloatButton(service, props, vueNormalize))\n  return { api, service, rootRef }\n}\n"],"mappings":";;;;;;;;;;AA0BA,SAAgB,eACd,OACA,QACoB;CACpB,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,IAAwB,IAAI;CAE5C,MAAM,UAAU,WAAW,2BAAuD;EAChF,MAAM,MAAM;EACZ,aAAa,MAAM;EACnB,UAAU,MAAM;EAChB,eAAe,MAAM;EACrB,cAAc,QAAQ;CACxB,IAAI,KAAK;CAET,IAAI,SAA+B;CACnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAC1D,MAAM,iBACJ,UAC2D,OAAQ,cAAc,SAAS,KAAK;EACjG,QAAQ,KAAK,IAAI,UAAU,MAAM;EACjC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;CACjD;CACA,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CAGjD,OAAO;EAAE,KADG,eAAe,mBAAmB,SAAS,OAAO,YAAY,CAC/D;EAAG;EAAS;CAAQ;AACjC"}
+{"version":3,"file":"use-float-button.js","names":[],"sources":["../../../src/components/float-button/use-float-button.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 float button 相关实现。\n\nimport type { Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { FloatButtonApi, FloatButtonNotifiers, FloatButtonProps, FloatButtonSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectFloatButton, floatButtonMachine } 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 FloatButtonContext {\n  api: ComputedRef<FloatButtonApi>\n  service: Service<FloatButtonSchema>\n  rootRef: Ref<HTMLElement | null>\n}\n\n/**\n * 专用状态机持有开合与逻辑层生命周期；Vue 只桥接所属 Document 的配置、登记函数与 root ref。\n */\nexport function useFloatButton(\n  props: FloatButtonProps,\n  notify?: FloatButtonNotifiers,\n): FloatButtonContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const rootRef = ref<HTMLElement | null>(null)\n\n  const service = useMachine(floatButtonMachine, (): FloatButtonSchema['props'] => ({\n    open: props.open,\n    defaultOpen: props.defaultOpen,\n    disabled: props.disabled,\n    expandTrigger: props.expandTrigger,\n    offset: props.offset,\n    draggable: props.draggable,\n    snap: props.snap,\n    position: props.position,\n    defaultPosition: props.defaultPosition,\n    onOpenChange: notify?.onOpenChange,\n    onPositionChange: notify?.onPositionChange,\n  }), scope)\n\n  let config: RuntimeConfig | null = null\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n    const registerLayer = (\n      layer: Omit<Layer, 'id'>,\n    ): ReturnType<RuntimeConfig['layerRegistry']['register']> => config!.layerRegistry.register(layer)\n    service.refs.set('config', config)\n    service.refs.set('registerLayer', registerLayer)\n  }\n  service.refs.set('getRootEl', () => rootRef.value)\n\n  const api = computed(() => connectFloatButton(service, props, vueNormalize))\n  return { api, service, rootRef }\n}\n"],"mappings":";;;;;;;;;;AA0BA,SAAgB,eACd,OACA,QACoB;CACpB,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,IAAwB,IAAI;CAE5C,MAAM,UAAU,WAAW,2BAAuD;EAChF,MAAM,MAAM;EACZ,aAAa,MAAM;EACnB,UAAU,MAAM;EAChB,eAAe,MAAM;EACrB,QAAQ,MAAM;EACd,WAAW,MAAM;EACjB,MAAM,MAAM;EACZ,UAAU,MAAM;EAChB,iBAAiB,MAAM;EACvB,cAAc,QAAQ;EACtB,kBAAkB,QAAQ;CAC5B,IAAI,KAAK;CAET,IAAI,SAA+B;CACnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAC1D,MAAM,iBACJ,UAC2D,OAAQ,cAAc,SAAS,KAAK;EACjG,QAAQ,KAAK,IAAI,UAAU,MAAM;EACjC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;CACjD;CACA,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CAGjD,OAAO;EAAE,KADG,eAAe,mBAAmB,SAAS,OAAO,YAAY,CAC/D;EAAG;EAAS;CAAQ;AACjC"}

package/dist/components/form/context.js

@@ -17,10 +17,14 @@ const FIELD_KEY = Symbol.for("xh-form-field");
 function provideFormField(handle) {
 	provide(FIELD_KEY, handle);
 }
+/** 在这棵子树里断开表单字段组：后代控件不再按外层字段名取校验态与必填。 */
+function clearFormField() {
+	provide(FIELD_KEY, null);
+}
 function useOptionalFormField() {
 	return inject(FIELD_KEY, null);
 }
 //#endregion
-export { provideForm, provideFormField, useFormContext, useOptionalFormContext, useOptionalFormField };
+export { clearFormField, provideForm, provideFormField, useFormContext, useOptionalFormContext, useOptionalFormField };
 
 //# sourceMappingURL=context.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/form/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 { FormPath } from '@xihan-ui/headless'\nimport type { InjectionKey } from 'vue'\nimport type { FormContext } from './use-form'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<FormContext> = Symbol.for('xh-form')\n\nexport function provideForm(ctx: FormContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFormContext(): FormContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Form 部件必须用在 XhFormRoot 内')\n  return ctx\n}\n\n/** 表单外也能使用的部件（如 Field）从这里获取：不在表单内时为 null。 */\nexport function useOptionalFormContext(): FormContext | null {\n  return inject(KEY, null)\n}\n\n/** 字段容器把字段名交给后代：Field 据此从表单上下文自取校验态。 */\nexport interface FormFieldHandle {\n  name: () => FormPath\n}\n\nconst FIELD_KEY: InjectionKey<FormFieldHandle> = Symbol.for('xh-form-field')\n\nexport function provideFormField(handle: FormFieldHandle): void {\n  provide(FIELD_KEY, handle)\n}\n\nexport function useOptionalFormField(): FormFieldHandle | null {\n  return inject(FIELD_KEY, null)\n}\n"],"mappings":";;AAYA,MAAM,MAAiC,OAAO,IAAI,SAAS;AAE3D,SAAgB,YAAY,KAAwB;CAClD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,iBAA8B;CAC5C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT;;AAGA,SAAgB,yBAA6C;CAC3D,OAAO,OAAO,KAAK,IAAI;AACzB;AAOA,MAAM,YAA2C,OAAO,IAAI,eAAe;AAE3E,SAAgB,iBAAiB,QAA+B;CAC9D,QAAQ,WAAW,MAAM;AAC3B;AAEA,SAAgB,uBAA+C;CAC7D,OAAO,OAAO,WAAW,IAAI;AAC/B"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/form/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 { FormPath } from '@xihan-ui/headless'\nimport type { InjectionKey } from 'vue'\nimport type { FormContext } from './use-form'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<FormContext> = Symbol.for('xh-form')\n\nexport function provideForm(ctx: FormContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFormContext(): FormContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Form 部件必须用在 XhFormRoot 内')\n  return ctx\n}\n\n/** 表单外也能使用的部件（如 Field）从这里获取：不在表单内时为 null。 */\nexport function useOptionalFormContext(): FormContext | null {\n  return inject(KEY, null)\n}\n\n/** 字段容器把字段名交给后代：Field 据此从表单上下文自取校验态。 */\nexport interface FormFieldHandle {\n  name: () => FormPath\n}\n\nconst FIELD_KEY: InjectionKey<FormFieldHandle | null> = Symbol.for('xh-form-field')\n\nexport function provideFormField(handle: FormFieldHandle): void {\n  provide(FIELD_KEY, handle)\n}\n\n/** 在这棵子树里断开表单字段组：后代控件不再按外层字段名取校验态与必填。 */\nexport function clearFormField(): void {\n  provide(FIELD_KEY, null)\n}\n\nexport function useOptionalFormField(): FormFieldHandle | null {\n  return inject(FIELD_KEY, null)\n}\n"],"mappings":";;AAYA,MAAM,MAAiC,OAAO,IAAI,SAAS;AAE3D,SAAgB,YAAY,KAAwB;CAClD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,iBAA8B;CAC5C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT;;AAGA,SAAgB,yBAA6C;CAC3D,OAAO,OAAO,KAAK,IAAI;AACzB;AAOA,MAAM,YAAkD,OAAO,IAAI,eAAe;AAElF,SAAgB,iBAAiB,QAA+B;CAC9D,QAAQ,WAAW,MAAM;AAC3B;;AAGA,SAAgB,iBAAuB;CACrC,QAAQ,WAAW,IAAI;AACzB;AAEA,SAAgB,uBAA+C;CAC7D,OAAO,OAAO,WAAW,IAAI;AAC/B"}