@will-ui/vue 1.0.0

package/dist/use/useSlot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSlot.js","names":[],"sources":["../../use/useSlot.ts"],"sourcesContent":["import type { VNode, ComputedRef } from \"vue\"\r\nimport { computed, createVNode } from \"vue\"\r\nimport { isArray, isComment, isFragment, isText } from \"../util\"\r\n\r\n// const TEMPLATE: 'template' = 'template'\r\n\r\n/**\r\n *\r\n * 插槽内容有以下种类，当调用时，也就是slots.slotname()时\r\n * 1. 无，连<template #slotname></template>都没有的情况下，结果是undefined\r\n * 2. 有<template #slotname></template>但没有内容，结果是[]\r\n * 3. <template #slotname>有内容</template>时，结果是[{...}...]\r\n *\r\n */\r\n\r\n//返回插槽内容，如果是要返回插槽中第一个可用的节点。则需要判断是否为\r\n//文本、片段，是的话，则进行包装之后再返回。\r\nexport default function useSlot(\r\n  slotContent: ComputedRef,\r\n  isFirst: boolean = false,\r\n  elementTag: string = \"span\",\r\n  elementAttrs: Record<string, any> = {}\r\n): ComputedRef<VNode | undefined> {\r\n  return computed(() => {\r\n    let c = slotContent.value\r\n\r\n    if (hasSlot(c)) {\r\n      if (isFirst) {\r\n        //renderSlot得出的内容总是Fragment类型\r\n        if (isFragment(c)) {\r\n          c = c.children\r\n          // console.log(c)\r\n        }\r\n        const first = getFirstValidChild(c)\r\n\r\n        if (first !== undefined) {\r\n          if (isText(first) || isFragment(first)) {\r\n            const wrapper_c = createVNode(elementTag, elementAttrs, [first])\r\n            return wrapper_c\r\n          }\r\n          return first\r\n        }\r\n      } else {\r\n        return c\r\n      }\r\n    }\r\n  })\r\n}\r\n\r\n/**\r\n *\r\n * @param slotContent VNode[]\r\n * @returns boolean\r\n */\r\n\r\nfunction hasSlot(slotContent: VNode | VNode[] | undefined): boolean {\r\n  const c = slotContent\r\n  if (c === undefined || (c && isArray(c) && c.length === 0)) {\r\n    return false\r\n  }\r\n  return true\r\n}\r\n\r\n//注释不算有效节点\r\nfunction getFirstValidChild(slotContent: VNode | VNode[]): VNode | undefined {\r\n  if (isArray(slotContent)) {\r\n    let vnode: VNode | undefined\r\n    let i = 0\r\n    const len = slotContent.length\r\n    while (i < len) {\r\n      const c = slotContent[i]\r\n      if (!isComment(c)) {\r\n        vnode = c\r\n        break\r\n      }\r\n      i++\r\n    }\r\n    return vnode\r\n  }\r\n  return slotContent\r\n}\r\n"],"mappings":";;;;;;;;;;;AAiBA,SAAwB,QACtB,aACA,UAAmB,OACnB,aAAqB,QACrB,eAAoC,CAAC,GACL;CAChC,OAAO,eAAe;EACpB,IAAI,IAAI,YAAY;EAEpB,IAAI,QAAQ,CAAC,GAAG;GACd,IAAI,SAAS;IAEX,IAAI,WAAW,CAAC,GACd,IAAI,EAAE;IAGR,MAAM,QAAQ,mBAAmB,CAAC;IAElC,IAAI,UAAU,KAAA,GAAW;KACvB,IAAI,OAAO,KAAK,KAAK,WAAW,KAAK,GAEnC,OADkB,YAAY,YAAY,cAAc,CAAC,KAAK,CACvD;KAET,OAAO;IACT;GACF,OACE,OAAO;EAEX;CACF,CAAC;AACH;;;;;;AAQA,SAAS,QAAQ,aAAmD;CAClE,MAAM,IAAI;CACV,IAAI,MAAM,KAAA,KAAc,KAAK,QAAQ,CAAC,KAAK,EAAE,WAAW,GACtD,OAAO;CAET,OAAO;AACT;AAGA,SAAS,mBAAmB,aAAiD;CAC3E,IAAI,QAAQ,WAAW,GAAG;EACxB,IAAI;EACJ,IAAI,IAAI;EACR,MAAM,MAAM,YAAY;EACxB,OAAO,IAAI,KAAK;GACd,MAAM,IAAI,YAAY;GACtB,IAAI,CAAC,UAAU,CAAC,GAAG;IACjB,QAAQ;IACR;GACF;GACA;EACF;EACA,OAAO;CACT;CACA,OAAO;AACT"}

package/dist/use/useTabIndex.d.ts

@@ -0,0 +1 @@
+export default function useTabIndex(el: any): void;

package/dist/use/useTabIndex.js

@@ -0,0 +1,18 @@
+import { getElement, getStyle, isElement, setAttr } from "../util/dom.js";
+import { computed, onMounted, onUpdated } from "vue";
+//#region use/useTabIndex.ts
+function useTabIndex(el) {
+	const _ = computed(() => getElement(el));
+	function setTabindex() {
+		const _el = _.value;
+		if (_el && isElement(_el)) {
+			if (getStyle(_el, "tabindex") === void 0) setAttr(_el, { tabindex: -1 });
+		}
+	}
+	onMounted(setTabindex);
+	onUpdated(setTabindex);
+}
+//#endregion
+export { useTabIndex as default };
+
+//# sourceMappingURL=useTabIndex.js.map

package/dist/use/useTabIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTabIndex.js","names":[],"sources":["../../use/useTabIndex.ts"],"sourcesContent":["import { computed, onMounted, onUpdated } from \"vue\"\r\nimport { getStyle, getElement, setAttr, isElement } from \"../util\"\r\n\r\nexport default function useTabIndex(el: any) {\r\n  const _ = computed(() => getElement(el))\r\n  function setTabindex() {\r\n    const _el = _.value\r\n    if (_el && isElement(_el)) {\r\n      const t = getStyle(_el, \"tabindex\")\r\n      if (t === undefined) {\r\n        setAttr(_el, { tabindex: -1 })\r\n      }\r\n    }\r\n  }\r\n  onMounted(setTabindex)\r\n  onUpdated(setTabindex)\r\n}\r\n"],"mappings":";;;AAGA,SAAwB,YAAY,IAAS;CAC3C,MAAM,IAAI,eAAe,WAAW,EAAE,CAAC;CACvC,SAAS,cAAc;EACrB,MAAM,MAAM,EAAE;EACd,IAAI,OAAO,UAAU,GAAG,GACZ;OAAA,SAAS,KAAK,UACpB,MAAM,KAAA,GACR,QAAQ,KAAK,EAAE,UAAU,GAAG,CAAC;EAAA;CAGnC;CACA,UAAU,WAAW;CACrB,UAAU,WAAW;AACvB"}

package/dist/use/useUII18n.js

@@ -0,0 +1,26 @@
+import { uiI18n } from "../config/i18n.js";
+//#region use/useUII18n.ts
+/**
+* UI 组件通用国际化 Hook
+* 提供独立于项目主 i18n 的国际化能力
+*
+* @returns 安全的国际化方法，即使初始化失败也不会报错
+*/
+function useUII18n() {
+	if (!uiI18n || !uiI18n.global || !uiI18n.global.t) {
+		console.warn("[UII18n] UI i18n instance not properly initialized, using fallback");
+		const fallbackT = (key, params) => key;
+		return {
+			t: fallbackT,
+			locale: { value: "zh-CN" }
+		};
+	}
+	return {
+		t: uiI18n.global.t,
+		locale: uiI18n.global.locale
+	};
+}
+//#endregion
+export { useUII18n };
+
+//# sourceMappingURL=useUII18n.js.map

package/dist/use/useUII18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUII18n.js","names":[],"sources":["../../use/useUII18n.ts"],"sourcesContent":["import { useI18n } from \"vue-i18n\"\r\nimport { uiI18n } from \"../config/i18n\"\r\n\r\n/**\r\n * UI 组件通用国际化 Hook\r\n * 提供独立于项目主 i18n 的国际化能力\r\n *\r\n * @returns 安全的国际化方法，即使初始化失败也不会报错\r\n */\r\nexport function useUII18n() {\r\n  // 安全检查：确保 uiI18n 已正确初始化\r\n  if (!uiI18n || !uiI18n.global || !uiI18n.global.t) {\r\n    console.warn(\r\n      \"[UII18n] UI i18n instance not properly initialized, using fallback\"\r\n    )\r\n    // 返回降级方案：直接返回 key 的函数\r\n    const fallbackT = (key: string, params?: Record<string, any>) => key\r\n    return {\r\n      t: fallbackT,\r\n      locale: { value: \"zh-CN\" },\r\n    }\r\n  }\r\n\r\n  return {\r\n    t: uiI18n.global.t,\r\n    locale: uiI18n.global.locale,\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;AASA,SAAgB,YAAY;CAE1B,IAAI,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,OAAO,OAAO,GAAG;EACjD,QAAQ,KACN,oEACF;EAEA,MAAM,aAAa,KAAa,WAAiC;EACjE,OAAO;GACL,GAAG;GACH,QAAQ,EAAE,OAAO,QAAQ;EAC3B;CACF;CAEA,OAAO;EACL,GAAG,OAAO,OAAO;EACjB,QAAQ,OAAO,OAAO;CACxB;AACF"}

package/dist/use/useUpload.d.ts

@@ -0,0 +1,49 @@
+import { ComputedRef, MaybeRef, Ref } from 'vue';
+import { UploadBeforeRemove, UploadBeforeUpload, UploadFile, UploadHttpRequest } from '../components/upload/types';
+export declare function isImageFile(file: Pick<UploadFile, 'name' | 'type' | 'url'>): boolean;
+export declare function formatFileSize(size?: number): string;
+export interface UseUploadOptions {
+    modelValue?: MaybeRef<UploadFile[] | undefined>;
+    accept?: MaybeRef<string>;
+    multiple?: MaybeRef<boolean>;
+    disabled?: MaybeRef<boolean>;
+    maxSize?: MaybeRef<number>;
+    maxCount?: MaybeRef<number>;
+    autoUpload?: MaybeRef<boolean>;
+    drag?: MaybeRef<boolean>;
+    paste?: MaybeRef<boolean>;
+    action?: MaybeRef<string | undefined>;
+    httpRequest?: MaybeRef<UploadHttpRequest | undefined>;
+    data?: MaybeRef<Record<string, unknown> | undefined>;
+    headers?: MaybeRef<Record<string, string> | undefined>;
+    withCredentials?: MaybeRef<boolean | undefined>;
+    name?: MaybeRef<string>;
+    beforeUpload?: UploadBeforeUpload;
+    beforeRemove?: UploadBeforeRemove;
+    t: (key: string, params?: Record<string, string | number>) => string;
+    onUpdateModelValue?: (list: UploadFile[]) => void;
+    onChange?: (file: UploadFile, fileList: UploadFile[]) => void;
+    onRemove?: (file: UploadFile, fileList: UploadFile[]) => void;
+    onError?: (error: Error, file?: UploadFile, fileList?: UploadFile[]) => void;
+    onProgress?: (file: UploadFile, fileList: UploadFile[]) => void;
+    onSuccess?: (response: unknown, file: UploadFile, fileList: UploadFile[]) => void;
+    onExceed?: (files: File[], fileList: UploadFile[]) => void;
+}
+export interface UseUploadReturn {
+    fileList: ComputedRef<UploadFile[]>;
+    isDragging: Ref<boolean>;
+    addFiles: (files: File[] | FileList | null | undefined) => Promise<void>;
+    remove: (uid: string) => Promise<void>;
+    clear: () => void;
+    upload: (uid?: string) => void;
+    uploadAll: () => void;
+    abort: (uid?: string) => void;
+    retry: (uid: string) => void;
+    handleDragEnter: (e: DragEvent) => void;
+    handleDragOver: (e: DragEvent) => void;
+    handleDragLeave: (e: DragEvent) => void;
+    handleDrop: (e: DragEvent) => void;
+    handlePaste: (e: ClipboardEvent) => void;
+    canAddMore: ComputedRef<boolean>;
+}
+export default function useUpload(options: UseUploadOptions): UseUploadReturn;

package/dist/use/useUpload.js

@@ -0,0 +1,396 @@
+import { computed, onUnmounted, ref, unref, watch } from "vue";
+//#region use/useUpload.ts
+var uidSeed = 0;
+function nextUid() {
+	uidSeed += 1;
+	return `upload-${Date.now()}-${uidSeed}`;
+}
+var IMAGE_EXT = /* @__PURE__ */ new Set([
+	"jpg",
+	"jpeg",
+	"png",
+	"gif",
+	"bmp",
+	"webp",
+	"svg",
+	"ico",
+	"avif"
+]);
+function isImageFile(file) {
+	if (file.type?.startsWith("image/")) return true;
+	const ext = (file.name || file.url || "").split("?")[0].split(".").pop()?.toLowerCase();
+	return ext ? IMAGE_EXT.has(ext) : false;
+}
+function formatFileSize(size) {
+	if (size == null || Number.isNaN(size)) return "";
+	if (size < 1024) return `${size}B`;
+	if (size < 1048576) return `${(size / 1024).toFixed(1)}KB`;
+	return `${(size / 1024 / 1024).toFixed(1)}MB`;
+}
+function matchAccept(file, accept) {
+	const raw = accept.trim();
+	if (!raw || raw === "*") return true;
+	const tokens = raw.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
+	if (!tokens.length) return true;
+	const fileName = file.name.toLowerCase();
+	const mime = (file.type || "").toLowerCase();
+	return tokens.some((token) => {
+		if (token.startsWith(".")) return fileName.endsWith(token);
+		if (token.endsWith("/*")) {
+			const prefix = token.slice(0, -1);
+			return mime.startsWith(prefix);
+		}
+		return mime === token;
+	});
+}
+function defaultXhrRequest(options) {
+	const { action, file, filename, data, headers, withCredentials, onProgress, onSuccess, onError } = options;
+	if (!action) {
+		onError(/* @__PURE__ */ new Error("Upload action is required"));
+		return;
+	}
+	const xhr = new XMLHttpRequest();
+	const form = new FormData();
+	form.append(filename, file, file.name);
+	if (data) Object.keys(data).forEach((key) => {
+		const value = data[key];
+		if (value == null) return;
+		form.append(key, value instanceof Blob ? value : String(value));
+	});
+	if (xhr.upload) xhr.upload.onprogress = (e) => {
+		if (e.total > 0) onProgress({ percent: Math.min(100, Math.round(e.loaded / e.total * 100)) });
+	};
+	xhr.onerror = () => {
+		onError(/* @__PURE__ */ new Error("Upload network error"));
+	};
+	xhr.onload = () => {
+		if (xhr.status >= 200 && xhr.status < 300) {
+			let response = xhr.responseText;
+			try {
+				response = JSON.parse(xhr.responseText);
+			} catch {}
+			onSuccess(response);
+		} else onError(/* @__PURE__ */ new Error(`Upload failed with status ${xhr.status}`));
+	};
+	xhr.open("POST", action, true);
+	if (withCredentials) xhr.withCredentials = true;
+	if (headers) Object.keys(headers).forEach((key) => {
+		const value = headers[key];
+		if (value != null) xhr.setRequestHeader(key, value);
+	});
+	xhr.send(form);
+	return { abort: () => xhr.abort() };
+}
+function useUpload(options) {
+	const innerList = ref([]);
+	const isDragging = ref(false);
+	const dragCounter = ref(0);
+	/** 本组件创建的 blob URL，卸载时释放 */
+	const localObjectUrls = /* @__PURE__ */ new Set();
+	const abortMap = /* @__PURE__ */ new Map();
+	const fileList = computed(() => innerList.value);
+	watch(() => unref(options.modelValue), (val) => {
+		if (val !== void 0 && val !== innerList.value) innerList.value = val;
+	}, { immediate: true });
+	function emitList(next) {
+		const list = next.slice();
+		innerList.value = list;
+		options.onUpdateModelValue?.(list);
+	}
+	function patchFile(uid, patch) {
+		const list = fileList.value;
+		const idx = list.findIndex((f) => f.uid === uid);
+		if (idx < 0) return;
+		const next = list.slice();
+		next[idx] = {
+			...next[idx],
+			...patch
+		};
+		emitList(next);
+	}
+	function getFile(uid) {
+		return fileList.value.find((f) => f.uid === uid);
+	}
+	function revokeUrl(url) {
+		if (!url || !localObjectUrls.has(url)) return;
+		URL.revokeObjectURL(url);
+		localObjectUrls.delete(url);
+	}
+	function createPreviewUrl(file) {
+		if (!file.type.startsWith("image/") && !isImageFile({
+			name: file.name,
+			type: file.type
+		})) return;
+		const url = URL.createObjectURL(file);
+		localObjectUrls.add(url);
+		return url;
+	}
+	function validateFile(file) {
+		const accept = unref(options.accept) ?? "*";
+		const maxSize = unref(options.maxSize) ?? Infinity;
+		if (!matchAccept(file, accept)) return new Error(options.t("upload.invalidType", {
+			name: file.name,
+			accept
+		}));
+		if (file.size > maxSize) return new Error(options.t("upload.fileSizeExceeded", {
+			name: file.name,
+			size: (maxSize / 1024 / 1024).toFixed(1)
+		}));
+		return null;
+	}
+	const canAddMore = computed(() => {
+		const maxCount = unref(options.maxCount) ?? Infinity;
+		if (!(unref(options.multiple) ?? false)) return fileList.value.length < 1;
+		return fileList.value.length < maxCount;
+	});
+	async function addFiles(input) {
+		if (unref(options.disabled)) return;
+		if (!input || input.length === 0) return;
+		const incoming = Array.from(input);
+		const multiple = unref(options.multiple) ?? false;
+		const maxCount = unref(options.maxCount) ?? Infinity;
+		let current = fileList.value.slice();
+		if (!multiple) {
+			current.forEach((f) => {
+				abortMap.get(f.uid)?.();
+				abortMap.delete(f.uid);
+				revokeUrl(f.url);
+			});
+			current = [];
+		}
+		const remain = multiple ? Math.max(0, maxCount - current.length) : 1;
+		if (remain <= 0 || incoming.length > remain) {
+			options.onExceed?.(incoming, fileList.value);
+			if (remain <= 0) {
+				options.onError?.(new Error(options.t("upload.fileCountExceeded", { count: maxCount })));
+				return;
+			}
+		}
+		const take = incoming.slice(0, remain);
+		if (incoming.length > remain) {
+			options.onExceed?.(incoming, fileList.value);
+			options.onError?.(new Error(options.t("upload.fileCountExceeded", { count: maxCount })));
+		}
+		const created = [];
+		for (const raw of take) {
+			let file = raw;
+			const err = validateFile(file);
+			if (err) {
+				options.onError?.(err);
+				continue;
+			}
+			if (options.beforeUpload) try {
+				const result = await options.beforeUpload(file);
+				if (result === false) continue;
+				if (result instanceof File) file = result;
+			} catch (e) {
+				options.onError?.(e instanceof Error ? e : new Error(String(e)));
+				continue;
+			}
+			const item = {
+				uid: nextUid(),
+				name: file.name,
+				size: file.size,
+				type: file.type,
+				status: "ready",
+				percent: 0,
+				url: createPreviewUrl(file),
+				raw: file
+			};
+			created.push(item);
+			current.push(item);
+		}
+		if (!created.length) return;
+		emitList(current);
+		created.forEach((f) => options.onChange?.(f, fileList.value));
+		if (unref(options.autoUpload)) created.forEach((f) => startUpload(f.uid));
+	}
+	function resolveRequest() {
+		const custom = unref(options.httpRequest);
+		if (custom) return custom;
+		if (unref(options.action)) return defaultXhrRequest;
+		return null;
+	}
+	function startUpload(uid) {
+		const file = getFile(uid);
+		if (!file?.raw) return;
+		if (file.status === "uploading") return;
+		const request = resolveRequest();
+		if (!request) return;
+		abortMap.get(uid)?.();
+		abortMap.delete(uid);
+		patchFile(uid, {
+			status: "uploading",
+			percent: 0,
+			error: void 0
+		});
+		const handle = request({
+			file: file.raw,
+			filename: unref(options.name) ?? "file",
+			data: unref(options.data),
+			headers: unref(options.headers),
+			withCredentials: unref(options.withCredentials),
+			action: unref(options.action),
+			onProgress: ({ percent }) => {
+				patchFile(uid, {
+					percent,
+					status: "uploading"
+				});
+				const latest = getFile(uid);
+				if (latest) options.onProgress?.(latest, fileList.value);
+			},
+			onSuccess: (response) => {
+				abortMap.delete(uid);
+				const patch = {
+					status: "success",
+					percent: 100,
+					response,
+					error: void 0
+				};
+				if (response && typeof response === "object" && "url" in response && typeof response.url === "string") {
+					const nextUrl = response.url;
+					revokeUrl(file.url);
+					patch.url = nextUrl;
+				}
+				patchFile(uid, patch);
+				const latest = getFile(uid);
+				if (latest) options.onSuccess?.(response, latest, fileList.value);
+			},
+			onError: (error) => {
+				abortMap.delete(uid);
+				patchFile(uid, {
+					status: "error",
+					error
+				});
+				const latest = getFile(uid);
+				options.onError?.(error, latest, fileList.value);
+			}
+		});
+		if (handle?.abort) abortMap.set(uid, handle.abort);
+	}
+	function upload(uid) {
+		if (uid) {
+			startUpload(uid);
+			return;
+		}
+		uploadAll();
+	}
+	function uploadAll() {
+		fileList.value.filter((f) => f.raw && (f.status === "ready" || f.status === "error")).forEach((f) => startUpload(f.uid));
+	}
+	function abort(uid) {
+		if (uid) {
+			abortMap.get(uid)?.();
+			abortMap.delete(uid);
+			if (getFile(uid)?.status === "uploading") patchFile(uid, {
+				status: "ready",
+				percent: 0
+			});
+			return;
+		}
+		abortMap.forEach((fn) => fn());
+		abortMap.clear();
+		emitList(fileList.value.map((f) => f.status === "uploading" ? {
+			...f,
+			status: "ready",
+			percent: 0
+		} : f));
+	}
+	function retry(uid) {
+		if (!getFile(uid)?.raw) return;
+		patchFile(uid, {
+			status: "ready",
+			percent: 0,
+			error: void 0
+		});
+		startUpload(uid);
+	}
+	async function remove(uid) {
+		if (unref(options.disabled)) return;
+		const file = getFile(uid);
+		if (!file) return;
+		if (options.beforeRemove) try {
+			if (!await options.beforeRemove(file)) return;
+		} catch {
+			return;
+		}
+		abortMap.get(uid)?.();
+		abortMap.delete(uid);
+		revokeUrl(file.url);
+		const next = fileList.value.filter((f) => f.uid !== uid);
+		emitList(next);
+		options.onRemove?.(file, next);
+	}
+	function clear() {
+		fileList.value.forEach((f) => {
+			abortMap.get(f.uid)?.();
+			revokeUrl(f.url);
+		});
+		abortMap.clear();
+		emitList([]);
+	}
+	function handleDragEnter(e) {
+		if (unref(options.disabled) || !unref(options.drag)) return;
+		e.preventDefault();
+		e.stopPropagation();
+		dragCounter.value += 1;
+		isDragging.value = true;
+	}
+	function handleDragOver(e) {
+		if (unref(options.disabled) || !unref(options.drag)) return;
+		e.preventDefault();
+		e.stopPropagation();
+	}
+	function handleDragLeave(e) {
+		if (unref(options.disabled) || !unref(options.drag)) return;
+		e.preventDefault();
+		e.stopPropagation();
+		dragCounter.value -= 1;
+		if (dragCounter.value <= 0) {
+			dragCounter.value = 0;
+			isDragging.value = false;
+		}
+	}
+	function handleDrop(e) {
+		if (unref(options.disabled) || !unref(options.drag)) return;
+		e.preventDefault();
+		e.stopPropagation();
+		dragCounter.value = 0;
+		isDragging.value = false;
+		addFiles(e.dataTransfer?.files);
+	}
+	function handlePaste(e) {
+		if (unref(options.disabled) || !unref(options.paste)) return;
+		const files = e.clipboardData?.files;
+		if (!files?.length) return;
+		e.preventDefault();
+		addFiles(files);
+	}
+	onUnmounted(() => {
+		abortMap.forEach((fn) => fn());
+		abortMap.clear();
+		localObjectUrls.forEach((url) => URL.revokeObjectURL(url));
+		localObjectUrls.clear();
+	});
+	return {
+		fileList,
+		isDragging,
+		addFiles,
+		remove,
+		clear,
+		upload,
+		uploadAll,
+		abort,
+		retry,
+		handleDragEnter,
+		handleDragOver,
+		handleDragLeave,
+		handleDrop,
+		handlePaste,
+		canAddMore
+	};
+}
+//#endregion
+export { useUpload as default, formatFileSize, isImageFile };
+
+//# sourceMappingURL=useUpload.js.map

package/dist/use/useUpload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpload.js","names":[],"sources":["../../use/useUpload.ts"],"sourcesContent":["import {\r\n  computed,\r\n  onUnmounted,\r\n  ref,\r\n  unref,\r\n  watch,\r\n  type ComputedRef,\r\n  type MaybeRef,\r\n  type Ref,\r\n} from 'vue'\r\nimport type {\r\n  UploadBeforeRemove,\r\n  UploadBeforeUpload,\r\n  UploadFile,\r\n  UploadHttpRequest,\r\n  UploadHttpRequestOptions,\r\n} from '../components/upload/types'\r\n\r\nlet uidSeed = 0\r\nfunction nextUid() {\r\n  uidSeed += 1\r\n  return `upload-${Date.now()}-${uidSeed}`\r\n}\r\n\r\nconst IMAGE_EXT = new Set([\r\n  'jpg',\r\n  'jpeg',\r\n  'png',\r\n  'gif',\r\n  'bmp',\r\n  'webp',\r\n  'svg',\r\n  'ico',\r\n  'avif',\r\n])\r\n\r\nexport function isImageFile(file: Pick<UploadFile, 'name' | 'type' | 'url'>) {\r\n  if (file.type?.startsWith('image/')) return true\r\n  const name = file.name || file.url || ''\r\n  const ext = name.split('?')[0].split('.').pop()?.toLowerCase()\r\n  return ext ? IMAGE_EXT.has(ext) : false\r\n}\r\n\r\nexport function formatFileSize(size?: number) {\r\n  if (size == null || Number.isNaN(size)) return ''\r\n  if (size < 1024) return `${size}B`\r\n  if (size < 1024 * 1024) return `${(size / 1024).toFixed(1)}KB`\r\n  return `${(size / 1024 / 1024).toFixed(1)}MB`\r\n}\r\n\r\nfunction matchAccept(file: File, accept: string): boolean {\r\n  const raw = accept.trim()\r\n  if (!raw || raw === '*') return true\r\n  const tokens = raw.split(',').map((s) => s.trim().toLowerCase()).filter(Boolean)\r\n  if (!tokens.length) return true\r\n  const fileName = file.name.toLowerCase()\r\n  const mime = (file.type || '').toLowerCase()\r\n  return tokens.some((token) => {\r\n    if (token.startsWith('.')) {\r\n      return fileName.endsWith(token)\r\n    }\r\n    if (token.endsWith('/*')) {\r\n      const prefix = token.slice(0, -1) // e.g. image/\r\n      return mime.startsWith(prefix)\r\n    }\r\n    return mime === token\r\n  })\r\n}\r\n\r\nfunction defaultXhrRequest(options: UploadHttpRequestOptions) {\r\n  const {\r\n    action,\r\n    file,\r\n    filename,\r\n    data,\r\n    headers,\r\n    withCredentials,\r\n    onProgress,\r\n    onSuccess,\r\n    onError,\r\n  } = options\r\n\r\n  if (!action) {\r\n    onError(new Error('Upload action is required'))\r\n    return\r\n  }\r\n\r\n  const xhr = new XMLHttpRequest()\r\n  const form = new FormData()\r\n  form.append(filename, file, file.name)\r\n  if (data) {\r\n    Object.keys(data).forEach((key) => {\r\n      const value = data[key]\r\n      if (value == null) return\r\n      form.append(key, value instanceof Blob ? value : String(value))\r\n    })\r\n  }\r\n\r\n  if (xhr.upload) {\r\n    xhr.upload.onprogress = (e) => {\r\n      if (e.total > 0) {\r\n        onProgress({ percent: Math.min(100, Math.round((e.loaded / e.total) * 100)) })\r\n      }\r\n    }\r\n  }\r\n\r\n  xhr.onerror = () => {\r\n    onError(new Error('Upload network error'))\r\n  }\r\n\r\n  xhr.onload = () => {\r\n    if (xhr.status >= 200 && xhr.status < 300) {\r\n      let response: unknown = xhr.responseText\r\n      try {\r\n        response = JSON.parse(xhr.responseText)\r\n      } catch {\r\n        // keep text\r\n      }\r\n      onSuccess(response)\r\n    } else {\r\n      onError(new Error(`Upload failed with status ${xhr.status}`))\r\n    }\r\n  }\r\n\r\n  xhr.open('POST', action, true)\r\n  if (withCredentials) {\r\n    xhr.withCredentials = true\r\n  }\r\n  if (headers) {\r\n    Object.keys(headers).forEach((key) => {\r\n      const value = headers[key]\r\n      if (value != null) xhr.setRequestHeader(key, value)\r\n    })\r\n  }\r\n  xhr.send(form)\r\n\r\n  return {\r\n    abort: () => xhr.abort(),\r\n  }\r\n}\r\n\r\nexport interface UseUploadOptions {\r\n  modelValue?: MaybeRef<UploadFile[] | undefined>\r\n  accept?: MaybeRef<string>\r\n  multiple?: MaybeRef<boolean>\r\n  disabled?: MaybeRef<boolean>\r\n  maxSize?: MaybeRef<number>\r\n  maxCount?: MaybeRef<number>\r\n  autoUpload?: MaybeRef<boolean>\r\n  drag?: MaybeRef<boolean>\r\n  paste?: MaybeRef<boolean>\r\n  action?: MaybeRef<string | undefined>\r\n  httpRequest?: MaybeRef<UploadHttpRequest | undefined>\r\n  data?: MaybeRef<Record<string, unknown> | undefined>\r\n  headers?: MaybeRef<Record<string, string> | undefined>\r\n  withCredentials?: MaybeRef<boolean | undefined>\r\n  name?: MaybeRef<string>\r\n  beforeUpload?: UploadBeforeUpload\r\n  beforeRemove?: UploadBeforeRemove\r\n  t: (key: string, params?: Record<string, string | number>) => string\r\n  onUpdateModelValue?: (list: UploadFile[]) => void\r\n  onChange?: (file: UploadFile, fileList: UploadFile[]) => void\r\n  onRemove?: (file: UploadFile, fileList: UploadFile[]) => void\r\n  onError?: (error: Error, file?: UploadFile, fileList?: UploadFile[]) => void\r\n  onProgress?: (file: UploadFile, fileList: UploadFile[]) => void\r\n  onSuccess?: (response: unknown, file: UploadFile, fileList: UploadFile[]) => void\r\n  onExceed?: (files: File[], fileList: UploadFile[]) => void\r\n}\r\n\r\nexport interface UseUploadReturn {\r\n  fileList: ComputedRef<UploadFile[]>\r\n  isDragging: Ref<boolean>\r\n  addFiles: (files: File[] | FileList | null | undefined) => Promise<void>\r\n  remove: (uid: string) => Promise<void>\r\n  clear: () => void\r\n  upload: (uid?: string) => void\r\n  uploadAll: () => void\r\n  abort: (uid?: string) => void\r\n  retry: (uid: string) => void\r\n  handleDragEnter: (e: DragEvent) => void\r\n  handleDragOver: (e: DragEvent) => void\r\n  handleDragLeave: (e: DragEvent) => void\r\n  handleDrop: (e: DragEvent) => void\r\n  handlePaste: (e: ClipboardEvent) => void\r\n  canAddMore: ComputedRef<boolean>\r\n}\r\n\r\nexport default function useUpload(options: UseUploadOptions): UseUploadReturn {\r\n  const innerList = ref<UploadFile[]>([])\r\n  const isDragging = ref(false)\r\n  const dragCounter = ref(0)\r\n  /** 本组件创建的 blob URL，卸载时释放 */\r\n  const localObjectUrls = new Set<string>()\r\n  const abortMap = new Map<string, () => void>()\r\n\r\n  const fileList = computed(() => innerList.value)\r\n\r\n  watch(\r\n    () => unref(options.modelValue),\r\n    (val) => {\r\n      // 同引用说明是我们刚 emit 出去的，避免进度连发时被旧值回写覆盖\r\n      if (val !== undefined && val !== innerList.value) {\r\n        innerList.value = val\r\n      }\r\n    },\r\n    { immediate: true },\r\n  )\r\n\r\n  function emitList(next: UploadFile[]) {\r\n    const list = next.slice()\r\n    innerList.value = list\r\n    options.onUpdateModelValue?.(list)\r\n  }\r\n\r\n  function patchFile(uid: string, patch: Partial<UploadFile>) {\r\n    const list = fileList.value\r\n    const idx = list.findIndex((f) => f.uid === uid)\r\n    if (idx < 0) return\r\n    const next = list.slice()\r\n    next[idx] = { ...next[idx], ...patch }\r\n    emitList(next)\r\n  }\r\n\r\n  function getFile(uid: string) {\r\n    return fileList.value.find((f) => f.uid === uid)\r\n  }\r\n\r\n  function revokeUrl(url?: string) {\r\n    if (!url || !localObjectUrls.has(url)) return\r\n    URL.revokeObjectURL(url)\r\n    localObjectUrls.delete(url)\r\n  }\r\n\r\n  function createPreviewUrl(file: File): string | undefined {\r\n    if (!file.type.startsWith('image/') && !isImageFile({ name: file.name, type: file.type })) {\r\n      return undefined\r\n    }\r\n    const url = URL.createObjectURL(file)\r\n    localObjectUrls.add(url)\r\n    return url\r\n  }\r\n\r\n  function validateFile(file: File): Error | null {\r\n    const accept = unref(options.accept) ?? '*'\r\n    const maxSize = unref(options.maxSize) ?? Infinity\r\n    if (!matchAccept(file, accept)) {\r\n      return new Error(\r\n        options.t('upload.invalidType', { name: file.name, accept }),\r\n      )\r\n    }\r\n    if (file.size > maxSize) {\r\n      return new Error(\r\n        options.t('upload.fileSizeExceeded', {\r\n          name: file.name,\r\n          size: (maxSize / 1024 / 1024).toFixed(1),\r\n        }),\r\n      )\r\n    }\r\n    return null\r\n  }\r\n\r\n  const canAddMore = computed(() => {\r\n    const maxCount = unref(options.maxCount) ?? Infinity\r\n    const multiple = unref(options.multiple) ?? false\r\n    if (!multiple) return fileList.value.length < 1\r\n    return fileList.value.length < maxCount\r\n  })\r\n\r\n  async function addFiles(input: File[] | FileList | null | undefined) {\r\n    if (unref(options.disabled)) return\r\n    if (!input || (input as FileList).length === 0) return\r\n\r\n    const incoming = Array.from(input as FileList | File[])\r\n    const multiple = unref(options.multiple) ?? false\r\n    const maxCount = unref(options.maxCount) ?? Infinity\r\n    let current = fileList.value.slice()\r\n\r\n    if (!multiple) {\r\n      // 单选：清空现有并替换\r\n      current.forEach((f) => {\r\n        abortMap.get(f.uid)?.()\r\n        abortMap.delete(f.uid)\r\n        revokeUrl(f.url)\r\n      })\r\n      current = []\r\n    }\r\n\r\n    const remain = multiple\r\n      ? Math.max(0, maxCount - current.length)\r\n      : 1\r\n\r\n    if (remain <= 0 || incoming.length > remain) {\r\n      options.onExceed?.(incoming, fileList.value)\r\n      if (remain <= 0) {\r\n        options.onError?.(\r\n          new Error(\r\n            options.t('upload.fileCountExceeded', { count: maxCount }),\r\n          ),\r\n        )\r\n        return\r\n      }\r\n    }\r\n\r\n    const take = incoming.slice(0, remain)\r\n    if (incoming.length > remain) {\r\n      options.onExceed?.(incoming, fileList.value)\r\n      options.onError?.(\r\n        new Error(options.t('upload.fileCountExceeded', { count: maxCount })),\r\n      )\r\n    }\r\n\r\n    const created: UploadFile[] = []\r\n\r\n    for (const raw of take) {\r\n      let file: File = raw\r\n      const err = validateFile(file)\r\n      if (err) {\r\n        options.onError?.(err)\r\n        continue\r\n      }\r\n\r\n      if (options.beforeUpload) {\r\n        try {\r\n          const result = await options.beforeUpload(file)\r\n          if (result === false) continue\r\n          if (result instanceof File) file = result\r\n        } catch (e) {\r\n          options.onError?.(e instanceof Error ? e : new Error(String(e)))\r\n          continue\r\n        }\r\n      }\r\n\r\n      const item: UploadFile = {\r\n        uid: nextUid(),\r\n        name: file.name,\r\n        size: file.size,\r\n        type: file.type,\r\n        status: 'ready',\r\n        percent: 0,\r\n        url: createPreviewUrl(file),\r\n        raw: file,\r\n      }\r\n      created.push(item)\r\n      current.push(item)\r\n    }\r\n\r\n    if (!created.length) return\r\n\r\n    emitList(current)\r\n    created.forEach((f) => options.onChange?.(f, fileList.value))\r\n\r\n    if (unref(options.autoUpload)) {\r\n      created.forEach((f) => startUpload(f.uid))\r\n    }\r\n  }\r\n\r\n  function resolveRequest(): UploadHttpRequest | null {\r\n    const custom = unref(options.httpRequest)\r\n    if (custom) return custom\r\n    const action = unref(options.action)\r\n    if (action) return defaultXhrRequest\r\n    return null\r\n  }\r\n\r\n  function startUpload(uid: string) {\r\n    const file = getFile(uid)\r\n    if (!file?.raw) return\r\n    if (file.status === 'uploading') return\r\n\r\n    const request = resolveRequest()\r\n    if (!request) {\r\n      // 无上传实现：保持 ready，由业务自行处理\r\n      return\r\n    }\r\n\r\n    abortMap.get(uid)?.()\r\n    abortMap.delete(uid)\r\n\r\n    patchFile(uid, { status: 'uploading', percent: 0, error: undefined })\r\n\r\n    const handle = request({\r\n      file: file.raw,\r\n      filename: unref(options.name) ?? 'file',\r\n      data: unref(options.data),\r\n      headers: unref(options.headers),\r\n      withCredentials: unref(options.withCredentials),\r\n      action: unref(options.action),\r\n      onProgress: ({ percent }) => {\r\n        patchFile(uid, { percent, status: 'uploading' })\r\n        const latest = getFile(uid)\r\n        if (latest) options.onProgress?.(latest, fileList.value)\r\n      },\r\n      onSuccess: (response) => {\r\n        abortMap.delete(uid)\r\n        const patch: Partial<UploadFile> = {\r\n          status: 'success',\r\n          percent: 100,\r\n          response,\r\n          error: undefined,\r\n        }\r\n        // 若响应里带 url 可覆盖预览\r\n        if (\r\n          response &&\r\n          typeof response === 'object' &&\r\n          'url' in response &&\r\n          typeof (response as { url: unknown }).url === 'string'\r\n        ) {\r\n          const nextUrl = (response as { url: string }).url\r\n          revokeUrl(file.url)\r\n          patch.url = nextUrl\r\n        }\r\n        patchFile(uid, patch)\r\n        const latest = getFile(uid)\r\n        if (latest) options.onSuccess?.(response, latest, fileList.value)\r\n      },\r\n      onError: (error) => {\r\n        abortMap.delete(uid)\r\n        patchFile(uid, { status: 'error', error })\r\n        const latest = getFile(uid)\r\n        options.onError?.(error, latest, fileList.value)\r\n      },\r\n    })\r\n\r\n    if (handle?.abort) {\r\n      abortMap.set(uid, handle.abort)\r\n    }\r\n  }\r\n\r\n  function upload(uid?: string) {\r\n    if (uid) {\r\n      startUpload(uid)\r\n      return\r\n    }\r\n    uploadAll()\r\n  }\r\n\r\n  function uploadAll() {\r\n    fileList.value\r\n      .filter((f) => f.raw && (f.status === 'ready' || f.status === 'error'))\r\n      .forEach((f) => startUpload(f.uid))\r\n  }\r\n\r\n  function abort(uid?: string) {\r\n    if (uid) {\r\n      abortMap.get(uid)?.()\r\n      abortMap.delete(uid)\r\n      const f = getFile(uid)\r\n      if (f?.status === 'uploading') {\r\n        patchFile(uid, { status: 'ready', percent: 0 })\r\n      }\r\n      return\r\n    }\r\n    abortMap.forEach((fn) => fn())\r\n    abortMap.clear()\r\n    emitList(\r\n      fileList.value.map((f) =>\r\n        f.status === 'uploading' ? { ...f, status: 'ready', percent: 0 } : f,\r\n      ),\r\n    )\r\n  }\r\n\r\n  function retry(uid: string) {\r\n    const f = getFile(uid)\r\n    if (!f?.raw) return\r\n    patchFile(uid, { status: 'ready', percent: 0, error: undefined })\r\n    startUpload(uid)\r\n  }\r\n\r\n  async function remove(uid: string) {\r\n    if (unref(options.disabled)) return\r\n    const file = getFile(uid)\r\n    if (!file) return\r\n\r\n    if (options.beforeRemove) {\r\n      try {\r\n        const ok = await options.beforeRemove(file)\r\n        if (!ok) return\r\n      } catch {\r\n        return\r\n      }\r\n    }\r\n\r\n    abortMap.get(uid)?.()\r\n    abortMap.delete(uid)\r\n    revokeUrl(file.url)\r\n\r\n    const next = fileList.value.filter((f) => f.uid !== uid)\r\n    emitList(next)\r\n    options.onRemove?.(file, next)\r\n  }\r\n\r\n  function clear() {\r\n    fileList.value.forEach((f) => {\r\n      abortMap.get(f.uid)?.()\r\n      revokeUrl(f.url)\r\n    })\r\n    abortMap.clear()\r\n    emitList([])\r\n  }\r\n\r\n  function handleDragEnter(e: DragEvent) {\r\n    if (unref(options.disabled) || !unref(options.drag)) return\r\n    e.preventDefault()\r\n    e.stopPropagation()\r\n    dragCounter.value += 1\r\n    isDragging.value = true\r\n  }\r\n\r\n  function handleDragOver(e: DragEvent) {\r\n    if (unref(options.disabled) || !unref(options.drag)) return\r\n    e.preventDefault()\r\n    e.stopPropagation()\r\n  }\r\n\r\n  function handleDragLeave(e: DragEvent) {\r\n    if (unref(options.disabled) || !unref(options.drag)) return\r\n    e.preventDefault()\r\n    e.stopPropagation()\r\n    dragCounter.value -= 1\r\n    if (dragCounter.value <= 0) {\r\n      dragCounter.value = 0\r\n      isDragging.value = false\r\n    }\r\n  }\r\n\r\n  function handleDrop(e: DragEvent) {\r\n    if (unref(options.disabled) || !unref(options.drag)) return\r\n    e.preventDefault()\r\n    e.stopPropagation()\r\n    dragCounter.value = 0\r\n    isDragging.value = false\r\n    void addFiles(e.dataTransfer?.files)\r\n  }\r\n\r\n  function handlePaste(e: ClipboardEvent) {\r\n    if (unref(options.disabled) || !unref(options.paste)) return\r\n    const files = e.clipboardData?.files\r\n    if (!files?.length) return\r\n    e.preventDefault()\r\n    void addFiles(files)\r\n  }\r\n\r\n  onUnmounted(() => {\r\n    abortMap.forEach((fn) => fn())\r\n    abortMap.clear()\r\n    localObjectUrls.forEach((url) => URL.revokeObjectURL(url))\r\n    localObjectUrls.clear()\r\n  })\r\n\r\n  return {\r\n    fileList,\r\n    isDragging,\r\n    addFiles,\r\n    remove,\r\n    clear,\r\n    upload,\r\n    uploadAll,\r\n    abort,\r\n    retry,\r\n    handleDragEnter,\r\n    handleDragOver,\r\n    handleDragLeave,\r\n    handleDrop,\r\n    handlePaste,\r\n    canAddMore,\r\n  }\r\n}\r\n"],"mappings":"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"}

package/dist/use/useVisibleResize.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 元素从隐藏变为可见，或盒子宽高变化时调用 listener。
+ * keep-alive 失活时断开观察，避免量到 0；激活后强制补一次。
+ * 宽高未变则跳过，避免 listener 改内部布局再触发 ResizeObserver 死循环。
+ */
+export default function useVisibleResize(el: any, listener: () => void): void;

package/dist/use/useVisibleResize.js

@@ -0,0 +1,77 @@
+import { getElement, isElement, isInvisible } from "../util/dom.js";
+import { nextTick, onActivated, onDeactivated, onUnmounted, watch } from "vue";
+//#region use/useVisibleResize.ts
+/**
+* 元素从隐藏变为可见，或盒子宽高变化时调用 listener。
+* keep-alive 失活时断开观察，避免量到 0；激活后强制补一次。
+* 宽高未变则跳过，避免 listener 改内部布局再触发 ResizeObserver 死循环。
+*/
+function useVisibleResize(el, listener) {
+	let observer;
+	let lastW = -1;
+	let lastH = -1;
+	let wasInvisible = true;
+	let raf = 0;
+	function node() {
+		const n = getElement(el);
+		return n && isElement(n) ? n : void 0;
+	}
+	function flush() {
+		const target = node();
+		if (!target) return;
+		if (isInvisible(target)) {
+			wasInvisible = true;
+			return;
+		}
+		const w = target.clientWidth;
+		const h = target.clientHeight;
+		const appeared = wasInvisible;
+		wasInvisible = false;
+		if (!appeared && w === lastW && h === lastH) return;
+		lastW = w;
+		lastH = h;
+		listener();
+	}
+	function schedule() {
+		if (raf) return;
+		raf = requestAnimationFrame(() => {
+			raf = 0;
+			flush();
+		});
+	}
+	function disconnect() {
+		observer?.disconnect();
+		observer = void 0;
+		if (raf) {
+			cancelAnimationFrame(raf);
+			raf = 0;
+		}
+	}
+	function observe() {
+		disconnect();
+		const target = node();
+		if (!target || typeof ResizeObserver === "undefined") return;
+		observer = new ResizeObserver(schedule);
+		observer.observe(target);
+	}
+	watch(() => node(), () => {
+		lastW = -1;
+		lastH = -1;
+		wasInvisible = true;
+		observe();
+		schedule();
+	}, { immediate: true });
+	onDeactivated(() => {
+		wasInvisible = true;
+		disconnect();
+	});
+	onActivated(() => {
+		observe();
+		nextTick(flush);
+	});
+	onUnmounted(disconnect);
+}
+//#endregion
+export { useVisibleResize as default };
+
+//# sourceMappingURL=useVisibleResize.js.map

package/dist/use/useVisibleResize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVisibleResize.js","names":[],"sources":["../../use/useVisibleResize.ts"],"sourcesContent":["import {\r\n  watch,\r\n  onUnmounted,\r\n  onActivated,\r\n  onDeactivated,\r\n  nextTick,\r\n} from \"vue\"\r\nimport { getElement, isElement, isInvisible } from \"../util\"\r\n\r\n/**\r\n * 元素从隐藏变为可见，或盒子宽高变化时调用 listener。\r\n * keep-alive 失活时断开观察，避免量到 0；激活后强制补一次。\r\n * 宽高未变则跳过，避免 listener 改内部布局再触发 ResizeObserver 死循环。\r\n */\r\nexport default function useVisibleResize(el: any, listener: () => void) {\r\n  let observer: ResizeObserver | undefined\r\n  let lastW = -1\r\n  let lastH = -1\r\n  let wasInvisible = true\r\n  let raf = 0\r\n\r\n  function node(): HTMLElement | undefined {\r\n    const n = getElement(el)\r\n    return n && isElement(n) ? (n as HTMLElement) : undefined\r\n  }\r\n\r\n  function flush() {\r\n    const target = node()\r\n    if (!target) return\r\n    if (isInvisible(target)) {\r\n      wasInvisible = true\r\n      return\r\n    }\r\n    const w = target.clientWidth\r\n    const h = target.clientHeight\r\n    const appeared = wasInvisible\r\n    wasInvisible = false\r\n    if (!appeared && w === lastW && h === lastH) return\r\n    lastW = w\r\n    lastH = h\r\n    listener()\r\n  }\r\n\r\n  function schedule() {\r\n    if (raf) return\r\n    raf = requestAnimationFrame(() => {\r\n      raf = 0\r\n      flush()\r\n    })\r\n  }\r\n\r\n  function disconnect() {\r\n    observer?.disconnect()\r\n    observer = undefined\r\n    if (raf) {\r\n      cancelAnimationFrame(raf)\r\n      raf = 0\r\n    }\r\n  }\r\n\r\n  function observe() {\r\n    disconnect()\r\n    const target = node()\r\n    if (!target || typeof ResizeObserver === \"undefined\") return\r\n    observer = new ResizeObserver(schedule)\r\n    observer.observe(target)\r\n  }\r\n\r\n  watch(\r\n    () => node(),\r\n    () => {\r\n      lastW = -1\r\n      lastH = -1\r\n      wasInvisible = true\r\n      observe()\r\n      schedule()\r\n    },\r\n    { immediate: true }\r\n  )\r\n\r\n  onDeactivated(() => {\r\n    wasInvisible = true\r\n    disconnect()\r\n  })\r\n  onActivated(() => {\r\n    observe()\r\n    nextTick(flush)\r\n  })\r\n  onUnmounted(disconnect)\r\n}\r\n"],"mappings":";;;;;;;;AAcA,SAAwB,iBAAiB,IAAS,UAAsB;CACtE,IAAI;CACJ,IAAI,QAAQ;CACZ,IAAI,QAAQ;CACZ,IAAI,eAAe;CACnB,IAAI,MAAM;CAEV,SAAS,OAAgC;EACvC,MAAM,IAAI,WAAW,EAAE;EACvB,OAAO,KAAK,UAAU,CAAC,IAAK,IAAoB,KAAA;CAClD;CAEA,SAAS,QAAQ;EACf,MAAM,SAAS,KAAK;EACpB,IAAI,CAAC,QAAQ;EACb,IAAI,YAAY,MAAM,GAAG;GACvB,eAAe;GACf;EACF;EACA,MAAM,IAAI,OAAO;EACjB,MAAM,IAAI,OAAO;EACjB,MAAM,WAAW;EACjB,eAAe;EACf,IAAI,CAAC,YAAY,MAAM,SAAS,MAAM,OAAO;EAC7C,QAAQ;EACR,QAAQ;EACR,SAAS;CACX;CAEA,SAAS,WAAW;EAClB,IAAI,KAAK;EACT,MAAM,4BAA4B;GAChC,MAAM;GACN,MAAM;EACR,CAAC;CACH;CAEA,SAAS,aAAa;EACpB,UAAU,WAAW;EACrB,WAAW,KAAA;EACX,IAAI,KAAK;GACP,qBAAqB,GAAG;GACxB,MAAM;EACR;CACF;CAEA,SAAS,UAAU;EACjB,WAAW;EACX,MAAM,SAAS,KAAK;EACpB,IAAI,CAAC,UAAU,OAAO,mBAAmB,aAAa;EACtD,WAAW,IAAI,eAAe,QAAQ;EACtC,SAAS,QAAQ,MAAM;CACzB;CAEA,YACQ,KAAK,SACL;EACJ,QAAQ;EACR,QAAQ;EACR,eAAe;EACf,QAAQ;EACR,SAAS;CACX,GACA,EAAE,WAAW,KAAK,CACpB;CAEA,oBAAoB;EAClB,eAAe;EACf,WAAW;CACb,CAAC;CACD,kBAAkB;EAChB,QAAQ;EACR,SAAS,KAAK;CAChB,CAAC;CACD,YAAY,UAAU;AACxB"}