@fast-china/utils 2.1.9 → 2.1.10

package/dist/index.mjs

@@ -26,7 +26,8 @@ import { useNow } from "./vue/now.mjs";
 import { definePropType, useProps } from "./vue/props.mjs";
 import { useRender } from "./vue/render.mjs";
 import { makeSlots } from "./vue/slots.mjs";
+import { useTransition } from "./vue/transition.mjs";
 import { useWindowSize } from "./vue/window-size.mjs";
 import { withDefineType } from "./vue/with.mjs";
 import "./vue/index.mjs";
-export { AESDecrypt, AESDecryptAuthenticated, AESDecryptWithPassword, AESEncrypt, AESEncryptAuthenticated, AESEncryptWithPassword, DeriveECDHKeySHA256, DeriveECDHSecret, ECDSASign, ECDSAVerify, FixedTimeEquals, GenerateECDHKeyPair, GenerateECDSAKeyPair, GenerateRSAKeyPair, GenerateRandomBytes, HKDFSHA256, HMACSHA256Encrypt, HMACSHA384Encrypt, HMACSHA512Encrypt, HashPasswordPBKDF2SHA256, Local, MD5Encrypt, PBKDF2SHA256, RSADecryptOAEP, RSAEncryptOAEP, RSASignPSS, RSAVerifyPSS, SHA1Encrypt, SHA256Bytes, SHA256Encrypt, SHA384Bytes, SHA384Encrypt, SHA512Bytes, SHA512Encrypt, Session, VerifyPasswordPBKDF2SHA256, addCssUnit, addDays, addMonths, addYears, allEqualBy, average, base64StorageCodec, callOptionalFunction, camelCase, chunk, clamp, cloneDeep, configureInstallationIdentity, configureLogger, configureStorage, contrastRatio, copy, createDateRangeShortcuts, createDateShortcuts, createLogger, createOneMonthRangeFromToday, debounce, decodeBase64, decodeBase64Bytes, decodeBase64Url, decodeBase64UrlBytes, decodeLatin1Base64, decodeSecureBase64, decodeURIComponentRepeatedly, definePropType, detectRuntime, difference, encodeBase64, encodeBase64Bytes, encodeBase64Url, encodeBase64UrlBytes, encodeLatin1Base64, encodeSecureBase64, endOfDay, escapeHtml, formatBytes, formatChineseRelativeTime, formatHexColor, formatRelativeTime, generateUuidV4, getLocalDayBounds, getLocalTimeGreeting, getOrCreateInstallationId, getStartOfToday, groupBy, hasDuplicatesBy, hasOwn, hasWebCrypto, inRange, installationIdentity, intersection, isBrowser, isDateAfterNow, isEqual, isFuture, isMobileUserAgent, isNode, isPlainObject, isSameDay, isStorageConfigured, isTabletUserAgent, isUniApp, isUuidV4, isValidDate, isValidJson, isWebWorker, isWithinInterval, kebabCase, lerp, logger, lowerFirst, makeSlots, mapConcurrent, mapValues, mixHexColorWithBlack, mixHexColorWithWhite, mixHexColors, normalizeWhitespace, omit, omitBy, once, parseHexColor, parseQueryString, partition, pascalCase, pick, pickBy, pickHigherContrastColor, randomInt, randomString, relativeLuminance, removeNullishValues, retry, roundTo, serializeStyle, shallowEqual, sleep, splitWords, startOfDay, sum, symmetricDifference, throttle, toDate, toQueryString, truncateGraphemes, unique, uniqueBy, upperFirst, useBreakpoints, useElementSize, useEmits, useEventListener, useExpose, useNow, useProps, useRender, useResizeObserver, useWindowSize, withDefineType, withInstall, withInstallDirective, withNoopInstall, withTimeout };
+export { AESDecrypt, AESDecryptAuthenticated, AESDecryptWithPassword, AESEncrypt, AESEncryptAuthenticated, AESEncryptWithPassword, DeriveECDHKeySHA256, DeriveECDHSecret, ECDSASign, ECDSAVerify, FixedTimeEquals, GenerateECDHKeyPair, GenerateECDSAKeyPair, GenerateRSAKeyPair, GenerateRandomBytes, HKDFSHA256, HMACSHA256Encrypt, HMACSHA384Encrypt, HMACSHA512Encrypt, HashPasswordPBKDF2SHA256, Local, MD5Encrypt, PBKDF2SHA256, RSADecryptOAEP, RSAEncryptOAEP, RSASignPSS, RSAVerifyPSS, SHA1Encrypt, SHA256Bytes, SHA256Encrypt, SHA384Bytes, SHA384Encrypt, SHA512Bytes, SHA512Encrypt, Session, VerifyPasswordPBKDF2SHA256, addCssUnit, addDays, addMonths, addYears, allEqualBy, average, base64StorageCodec, callOptionalFunction, camelCase, chunk, clamp, cloneDeep, configureInstallationIdentity, configureLogger, configureStorage, contrastRatio, copy, createDateRangeShortcuts, createDateShortcuts, createLogger, createOneMonthRangeFromToday, debounce, decodeBase64, decodeBase64Bytes, decodeBase64Url, decodeBase64UrlBytes, decodeLatin1Base64, decodeSecureBase64, decodeURIComponentRepeatedly, definePropType, detectRuntime, difference, encodeBase64, encodeBase64Bytes, encodeBase64Url, encodeBase64UrlBytes, encodeLatin1Base64, encodeSecureBase64, endOfDay, escapeHtml, formatBytes, formatChineseRelativeTime, formatHexColor, formatRelativeTime, generateUuidV4, getLocalDayBounds, getLocalTimeGreeting, getOrCreateInstallationId, getStartOfToday, groupBy, hasDuplicatesBy, hasOwn, hasWebCrypto, inRange, installationIdentity, intersection, isBrowser, isDateAfterNow, isEqual, isFuture, isMobileUserAgent, isNode, isPlainObject, isSameDay, isStorageConfigured, isTabletUserAgent, isUniApp, isUuidV4, isValidDate, isValidJson, isWebWorker, isWithinInterval, kebabCase, lerp, logger, lowerFirst, makeSlots, mapConcurrent, mapValues, mixHexColorWithBlack, mixHexColorWithWhite, mixHexColors, normalizeWhitespace, omit, omitBy, once, parseHexColor, parseQueryString, partition, pascalCase, pick, pickBy, pickHigherContrastColor, randomInt, randomString, relativeLuminance, removeNullishValues, retry, roundTo, serializeStyle, shallowEqual, sleep, splitWords, startOfDay, sum, symmetricDifference, throttle, toDate, toQueryString, truncateGraphemes, unique, uniqueBy, upperFirst, useBreakpoints, useElementSize, useEmits, useEventListener, useExpose, useNow, useProps, useRender, useResizeObserver, useTransition, useWindowSize, withDefineType, withInstall, withInstallDirective, withNoopInstall, withTimeout };

package/dist/vue/index.mjs

@@ -10,6 +10,7 @@ import { useNow } from "./now.mjs";
 import { definePropType, useProps } from "./props.mjs";
 import { useRender } from "./render.mjs";
 import { makeSlots } from "./slots.mjs";
+import { useTransition } from "./transition.mjs";
 import { useWindowSize } from "./window-size.mjs";
 import { withDefineType } from "./with.mjs";
-export { callOptionalFunction, definePropType, makeSlots, useBreakpoints, useElementSize, useEmits, useEventListener, useExpose, useNow, useProps, useRender, useResizeObserver, useWindowSize, withDefineType, withInstall, withInstallDirective, withNoopInstall };
+export { callOptionalFunction, definePropType, makeSlots, useBreakpoints, useElementSize, useEmits, useEventListener, useExpose, useNow, useProps, useRender, useResizeObserver, useTransition, useWindowSize, withDefineType, withInstall, withInstallDirective, withNoopInstall };

package/dist/vue/transition.mjs

@@ -0,0 +1,60 @@
+import { runtimeGlobals } from "../internal/runtime.mjs";
+import { computed, getCurrentScope, readonly, shallowRef, toValue, watch } from "vue";
+//#region src/vue/transition.ts
+/**
+* 将响应式数值的变化平滑过渡为只读数值。
+*
+* @param source - 有限数值、Ref 或 getter；初值直接显示，不执行入场动画。
+* @param options - 创建时读取的时长与缓动选项
+* @returns 只读数值 Ref；SSR 或缺少动画帧 API 时直接跟随输入。
+* @remarks 浏览器动画必须在 Vue 响应式作用域内创建，停止作用域时自动取消。
+* 新目标从当前显示值继续过渡，首个动画帧开始计时，完成时精确落到目标值。
+* `duration: 0` 直接同步目标。选项不响应后续修改；仅支持单个数值。
+* @throws `Error` 当支持动画帧的环境中不存在 Vue 响应式作用域。
+* @throws `RangeError` 当输入或时长非法；后续非法输入由 Vue watcher 报错，非法缓动结果在动画帧中抛错。
+*/
+function useTransition(source, options = {}) {
+	const { duration = 300, transition = (progress) => progress } = options;
+	if (!Number.isFinite(duration) || duration < 0) throw new RangeError("`duration` 必须是非负有限数。");
+	const readSource = () => {
+		const value = toValue(source);
+		if (!Number.isFinite(value)) throw new RangeError("`source` 必须是有限数值。");
+		return value;
+	};
+	const output = shallowRef(readSource());
+	const window = runtimeGlobals.window;
+	if (window === void 0 || typeof window.requestAnimationFrame !== "function" || typeof window.cancelAnimationFrame !== "function") return computed(readSource);
+	if (getCurrentScope() === void 0) throw new Error("`useTransition` 必须在 Vue 响应式作用域内调用。");
+	watch(readSource, (target, _previous, onCleanup) => {
+		let frame;
+		let active = true;
+		onCleanup(() => {
+			active = false;
+			if (frame !== void 0) window.cancelAnimationFrame(frame);
+		});
+		if (duration === 0 || output.value === target) {
+			output.value = target;
+			return;
+		}
+		const from = output.value;
+		let startedAt;
+		const tick = (timestamp) => {
+			frame = void 0;
+			if (!active) return;
+			startedAt ??= timestamp;
+			const progress = Math.min(1, Math.max(0, (timestamp - startedAt) / duration));
+			const weight = progress === 1 ? 1 : transition(progress);
+			const value = progress === 1 ? target : from * (1 - weight) + target * weight;
+			if (!Number.isFinite(weight) || !Number.isFinite(value)) throw new RangeError("缓动结果必须是有限数值。");
+			if (!active) return;
+			output.value = value;
+			if (active && progress < 1) frame = window.requestAnimationFrame(tick);
+		};
+		frame = window.requestAnimationFrame(tick);
+	}, { flush: "sync" });
+	return readonly(output);
+}
+//#endregion
+export { useTransition };
+
+//# sourceMappingURL=transition.mjs.map

package/dist/vue/transition.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition.mjs","names":[],"sources":["../../src/vue/transition.ts"],"sourcesContent":["import { computed, getCurrentScope, readonly, shallowRef, toValue, watch } from \"vue\";\nimport { runtimeGlobals } from \"../internal/runtime\";\nimport type { MaybeRefOrGetter, ShallowRef } from \"vue\";\n\n/** 数值过渡选项 */\nexport interface UseTransitionOptions {\n\t/** 过渡时长，单位为毫秒；必须是非负有限数。默认 `300`。 */\n\tduration?: number;\n\t/** 将 `[0, 1]` 的进度映射为有限插值系数，默认线性；允许超出区间以实现回弹。 */\n\ttransition?: (progress: number) => number;\n}\n\n/**\n * 将响应式数值的变化平滑过渡为只读数值。\n *\n * @param source - 有限数值、Ref 或 getter；初值直接显示，不执行入场动画。\n * @param options - 创建时读取的时长与缓动选项\n * @returns 只读数值 Ref；SSR 或缺少动画帧 API 时直接跟随输入。\n * @remarks 浏览器动画必须在 Vue 响应式作用域内创建，停止作用域时自动取消。\n * 新目标从当前显示值继续过渡，首个动画帧开始计时，完成时精确落到目标值。\n * `duration: 0` 直接同步目标。选项不响应后续修改；仅支持单个数值。\n * @throws `Error` 当支持动画帧的环境中不存在 Vue 响应式作用域。\n * @throws `RangeError` 当输入或时长非法；后续非法输入由 Vue watcher 报错，非法缓动结果在动画帧中抛错。\n */\nexport function useTransition(source: MaybeRefOrGetter<number>, options: UseTransitionOptions = {}): Readonly<ShallowRef<number>> {\n\tconst { duration = 300, transition = (progress: number) => progress } = options;\n\tif (!Number.isFinite(duration) || duration < 0) throw new RangeError(\"`duration` 必须是非负有限数。\");\n\tconst readSource = () => {\n\t\tconst value = toValue(source);\n\t\tif (!Number.isFinite(value)) throw new RangeError(\"`source` 必须是有限数值。\");\n\t\treturn value;\n\t};\n\tconst output = shallowRef(readSource());\n\tconst window = runtimeGlobals.window;\n\tif (window === undefined || typeof window.requestAnimationFrame !== \"function\" || typeof window.cancelAnimationFrame !== \"function\") {\n\t\treturn computed(readSource);\n\t}\n\tif (getCurrentScope() === undefined) throw new Error(\"`useTransition` 必须在 Vue 响应式作用域内调用。\");\n\twatch(\n\t\treadSource,\n\t\t(target, _previous, onCleanup) => {\n\t\t\tlet frame: number | undefined;\n\t\t\tlet active = true;\n\t\t\tonCleanup(() => {\n\t\t\t\tactive = false;\n\t\t\t\tif (frame !== undefined) window.cancelAnimationFrame(frame);\n\t\t\t});\n\t\t\tif (duration === 0 || output.value === target) {\n\t\t\t\toutput.value = target;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst from = output.value;\n\t\t\tlet startedAt: number | undefined;\n\t\t\tconst tick = (timestamp: number) => {\n\t\t\t\tframe = undefined;\n\t\t\t\tif (!active) return;\n\t\t\t\tstartedAt ??= timestamp;\n\t\t\t\tconst progress = Math.min(1, Math.max(0, (timestamp - startedAt) / duration));\n\t\t\t\tconst weight = progress === 1 ? 1 : transition(progress);\n\t\t\t\tconst value = progress === 1 ? target : from * (1 - weight) + target * weight;\n\t\t\t\tif (!Number.isFinite(weight) || !Number.isFinite(value)) throw new RangeError(\"缓动结果必须是有限数值。\");\n\t\t\t\tif (!active) return;\n\t\t\t\toutput.value = value;\n\t\t\t\tif (active && progress < 1) frame = window.requestAnimationFrame(tick);\n\t\t\t};\n\t\t\tframe = window.requestAnimationFrame(tick);\n\t\t},\n\t\t{ flush: \"sync\" }\n\t);\n\treturn readonly(output);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAwBA,SAAgB,cAAc,QAAkC,UAAgC,CAAC,GAAiC;CACjI,MAAM,EAAE,WAAW,KAAK,cAAc,aAAqB,aAAa;CACxE,IAAI,CAAC,OAAO,SAAS,QAAQ,KAAK,WAAW,GAAG,MAAM,IAAI,WAAW,sBAAsB;CAC3F,MAAM,mBAAmB;EACxB,MAAM,QAAQ,QAAQ,MAAM;EAC5B,IAAI,CAAC,OAAO,SAAS,KAAK,GAAG,MAAM,IAAI,WAAW,mBAAmB;EACrE,OAAO;CACR;CACA,MAAM,SAAS,WAAW,WAAW,CAAC;CACtC,MAAM,SAAS,eAAe;CAC9B,IAAI,WAAW,KAAA,KAAa,OAAO,OAAO,0BAA0B,cAAc,OAAO,OAAO,yBAAyB,YACxH,OAAO,SAAS,UAAU;CAE3B,IAAI,gBAAgB,MAAM,KAAA,GAAW,MAAM,IAAI,MAAM,oCAAoC;CACzF,MACC,aACC,QAAQ,WAAW,cAAc;EACjC,IAAI;EACJ,IAAI,SAAS;EACb,gBAAgB;GACf,SAAS;GACT,IAAI,UAAU,KAAA,GAAW,OAAO,qBAAqB,KAAK;EAC3D,CAAC;EACD,IAAI,aAAa,KAAK,OAAO,UAAU,QAAQ;GAC9C,OAAO,QAAQ;GACf;EACD;EACA,MAAM,OAAO,OAAO;EACpB,IAAI;EACJ,MAAM,QAAQ,cAAsB;GACnC,QAAQ,KAAA;GACR,IAAI,CAAC,QAAQ;GACb,cAAc;GACd,MAAM,WAAW,KAAK,IAAI,GAAG,KAAK,IAAI,IAAI,YAAY,aAAa,QAAQ,CAAC;GAC5E,MAAM,SAAS,aAAa,IAAI,IAAI,WAAW,QAAQ;GACvD,MAAM,QAAQ,aAAa,IAAI,SAAS,QAAQ,IAAI,UAAU,SAAS;GACvE,IAAI,CAAC,OAAO,SAAS,MAAM,KAAK,CAAC,OAAO,SAAS,KAAK,GAAG,MAAM,IAAI,WAAW,cAAc;GAC5F,IAAI,CAAC,QAAQ;GACb,OAAO,QAAQ;GACf,IAAI,UAAU,WAAW,GAAG,QAAQ,OAAO,sBAAsB,IAAI;EACtE;EACA,QAAQ,OAAO,sBAAsB,IAAI;CAC1C,GACA,EAAE,OAAO,OAAO,CACjB;CACA,OAAO,SAAS,MAAM;AACvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fast-china/utils",
-	"version": "2.1.9",
+	"version": "2.1.10",
 	"description": "Typed utilities for modern browsers, WebViews, Vue 3, and uni-app applications.",
 	"type": "module",
 	"keywords": [