sard 1.0.0 → 1.0.2

package/utils/dom.d.ts

@@ -0,0 +1,6 @@
+export interface ViewportScrollInfo {
+    scrollLeft: number;
+    scrollTop: number;
+}
+export declare function toTouchEvent(event: MouseEvent | TouchEvent, end?: boolean): TouchEvent;
+export declare function checkRtl(el: HTMLElement): boolean;

package/utils/dom.js

@@ -0,0 +1,19 @@
+//#region packages/sard/utils/dom.ts
+function toTouchEvent(event, end) {
+	if (!("touches" in event)) {
+		const touches = [{
+			clientX: event.clientX,
+			clientY: event.clientY,
+			pageY: event.pageY,
+			pageX: event.pageX
+		}];
+		event.changedTouches = touches;
+		event.touches = end ? [] : touches;
+	}
+	return event;
+}
+function checkRtl(el) {
+	return el.dir.toLowerCase() === "rtl" || getComputedStyle(el).direction === "rtl";
+}
+//#endregion
+export { checkRtl, toTouchEvent };

package/utils/file.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @description: 判断url是否为图片url
+ * @param url
+ */
+export declare function isImageUrl(url: string): boolean;
+/**
+ * 判断文件类型是否为图片
+ */
+export declare function isImageFile(file: File): boolean;
+/**
+ * 判断文件类型是否为视频
+ */
+export declare function isVideoFile(file: File): boolean;
+/**
+ * @description: 判断url是否为视频url
+ * @param url
+ */
+export declare function isVideoUrl(url: string): boolean;
+/**
+ * @description: 判断url是否为文件url
+ * @param url
+ */
+export declare function isFileUrl(url: string): boolean;
+export type FileReaderResultType = 'file' | 'dataUrl' | 'text';
+/**
+ * @description 读取文件内容
+ * @param file
+ * @param resultType
+ */
+export declare function readFileContent(file: File, resultType: FileReaderResultType): Promise<string | void>;
+/**
+ * @description 从路径中获取文件名
+ * @param path 文件路径
+ * @param ext 是否包含扩展名
+ */
+export declare function getFileName(path: string, ext?: boolean): string;
+/**
+ * @description 加载图片
+ * @param src 图片 src
+ */
+export declare function loadImage(src: string): Promise<HTMLImageElement>;
+/**
+ * @description 将 ImageData 转换为 DataURL
+ * @param imageData
+ * @returns
+ */
+export declare function imageDataToDataURL(imageData: ImageData, type?: string, quality?: number): string;
+export interface ChooseFileOptions {
+    accept?: string[];
+    multiple?: boolean;
+    capture?: 'environment' | 'user';
+}
+/**
+ * 选择文件，如果没有选择文件，会触发 catch
+ * @param options
+ */
+export declare function chooseFile(options?: ChooseFileOptions): Promise<File[]>;

package/utils/file.js

@@ -0,0 +1,113 @@
+//#region packages/sard/utils/file.ts
+/**
+* @description: 判断url是否为图片url
+* @param url
+*/
+function isImageUrl(url) {
+	return typeof url === "string" && (/\.(?:jpg|jpeg|png|gif|svg|bmp|webp|tiff|tif|heic|heif)$/i.test(url) || url.indexOf("data:image") === 0);
+}
+/**
+* 判断文件类型是否为图片
+*/
+function isImageFile(file) {
+	return file.type.split("/")[0] === "image";
+}
+/**
+* 判断文件类型是否为视频
+*/
+function isVideoFile(file) {
+	return file.type.split("/")[0] === "video";
+}
+/**
+* @description: 判断url是否为视频url
+* @param url
+*/
+function isVideoUrl(url) {
+	return typeof url === "string" && (/\.(avi|mp4|mov|wmv|flv|mkv|mpeg|mpg|3gp|webm|swf|rmvb|vob|ts|mts|m2ts|divx|asf|ogv|f4v)$/i.test(url) || url.indexOf("data:video") === 0);
+}
+/**
+* @description: 判断url是否为文件url
+* @param url
+*/
+function isFileUrl(url) {
+	return url.includes("/");
+}
+/**
+* @description 读取文件内容
+* @param file
+* @param resultType
+*/
+function readFileContent(file, resultType) {
+	return new Promise((resolve) => {
+		if (resultType === "file") {
+			resolve();
+			return;
+		}
+		const reader = new FileReader();
+		reader.onload = () => {
+			resolve(reader.result);
+		};
+		if (resultType === "dataUrl") reader.readAsDataURL(file);
+		else if (resultType === "text") reader.readAsText(file);
+	});
+}
+/**
+* @description 从路径中获取文件名
+* @param path 文件路径
+* @param ext 是否包含扩展名
+*/
+function getFileName(path, ext = true) {
+	const name = path.match(/\/([^/]+)$/)?.[1] || "";
+	return ext ? name : name.replace(/\.[^.]+$/, "");
+}
+/**
+* @description 加载图片
+* @param src 图片 src
+*/
+function loadImage(src) {
+	return new Promise((resolve, reject) => {
+		const image = new Image();
+		image.src = src;
+		image.onload = () => {
+			resolve(image);
+		};
+		image.onerror = (err) => {
+			reject(err);
+		};
+	});
+}
+/**
+* @description 将 ImageData 转换为 DataURL
+* @param imageData
+* @returns
+*/
+function imageDataToDataURL(imageData, type, quality) {
+	const canvas = document.createElement("canvas");
+	canvas.width = imageData.width;
+	canvas.height = imageData.height;
+	canvas.getContext("2d").putImageData(imageData, 0, 0);
+	return canvas.toDataURL(type, quality);
+}
+/**
+* 选择文件，如果没有选择文件，会触发 catch
+* @param options
+*/
+function chooseFile(options = {}) {
+	const { accept = [], multiple = false, capture } = options;
+	return new Promise((resolve, reject) => {
+		const input = document.createElement("input");
+		input.type = "file";
+		input.accept = accept.join(",");
+		input.multiple = multiple;
+		if (capture) input.capture = capture;
+		input.onchange = () => {
+			const files = input.files;
+			input.remove();
+			if (!files || files.length === 0) reject();
+			else resolve(Array.from(files));
+		};
+		input.click();
+	});
+}
+//#endregion
+export { chooseFile, getFileName, imageDataToDataURL, isFileUrl, isImageFile, isImageUrl, isVideoFile, isVideoUrl, loadImage, readFileContent };

package/utils/geometry.d.ts

@@ -0,0 +1,98 @@
+export type ScrollIntoViewPosition = 'start' | 'center' | 'end' | 'nearest';
+export type Size = {
+    width: number;
+    height: number;
+};
+export interface ScrollIntoViewOptions {
+    position?: ScrollIntoViewPosition;
+    startOffset?: number;
+    endOffset?: number;
+}
+/**
+ * 根据最后位置计算 page 滚动到顶部的值。
+ *
+ * 也可计算水平方向的滚动值。
+ *
+ *                      page
+ *                     ╱
+ *    ╭───────────────╮    viewport
+ *  ╭─│─ ─ ─ ─ ─ ─ ─ ─│─╮ ╱
+ *  │ │ ╭───────────╮ │ │
+ *  │ │ │  element  │ │ │
+ *  │ │ ╰───────────╯ │ │
+ *  ╰─│─ ─ ─ ─ ─ ─ ─ ─│─╯
+ *    │               │
+ *    │               │
+ *    ╰───────────────╯
+ *
+ * @param {number} viewportHeight viewport 高度
+ * @param {number} viewportScrollTop viewport 垂直滚动值
+ * @param {number} elementHeight element 高度
+ * @param {number} elementOffsetTop element 距离页面顶部距离
+ * @param {string} options.position element 在 viewport 中的位置，可选：'start' | 'center' | 'end' | 'nearest'
+ * @param {number} options.startOffset element 距离视窗顶部的偏移量
+ * @param {number} options.endOffset element 距离视窗底部的偏移量
+ * @return {number} viewport 新的垂直滚动值
+ */
+export declare function getScrollIntoViewValue(viewportHeight: number, viewportScrollTop: number, elementHeight: number, elementOffsetTop: number, options?: ScrollIntoViewOptions): number;
+export declare function scrollToTarget(scrollEl: HTMLElement, targetEl: HTMLElement, options?: ScrollIntoViewOptions & {
+    animated?: boolean;
+    vertical?: boolean;
+}): void;
+export interface MatchScrollVisibleOptions {
+    offset?: number;
+    errorValue?: number;
+}
+/**
+ * 匹配元素列表中第一个位于滚动盒子可视区域的元素
+ *
+ * @param {array} rects DOMRect 类型数组
+ * @param {function} callback 匹配成功时调用，会接收匹配的元素的下标
+ * @param {number} options.offset 偏移量
+ * @param {number} options.errorValue 容错值
+ */
+export declare function matchScrollVisible(rects: DOMRect[], callback: (index: number) => unknown, options?: MatchScrollVisibleOptions): Promise<unknown>;
+/**
+ * 保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取。
+ */
+export declare function getAspectFillSize(origWidth: number, origHeight: number, containerWidth: number, containerHeight: number): [number, number];
+/**
+ * 保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来。
+ */
+export declare function getAspectFitSize(origWidth: number, origHeight: number, containerWidth: number, containerHeight: number): [number, number];
+export interface Point {
+    x: number;
+    y: number;
+}
+/**
+ * 获取两点间的距离
+ */
+export declare function getTwoPointsDistance(p1: Point, p2: Point): number;
+interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * @description: 根据原始坐标尺寸和缩放后的坐标尺寸算出转换的原点
+ * @param {Rect} rect
+ * @param {Rect} scaleRect
+ * @return {[number, number]}
+ */
+export declare function getTransformOrigin(rect: Rect, scaleRect: Rect): [number, number];
+/**
+ * 获取一个矩形以中心点为原点旋转一定角度后的矩形
+ */
+export declare function getRotatedRect(width: number, height: number, rotate: number): {
+    w1: number;
+    w2: number;
+    h1: number;
+    h2: number;
+    width: number;
+    height: number;
+};
+export declare const getTouchPoint: (event: TouchEvent) => Point;
+export declare function isRectEqual(a: DOMRect, b: DOMRect): boolean;
+export declare function isSizeEqual(a: Size, b: Size): boolean;
+export {};

package/utils/geometry.js

@@ -0,0 +1,174 @@
+//#region packages/sard/utils/geometry.ts
+/**
+* 根据最后位置计算 page 滚动到顶部的值。
+*
+* 也可计算水平方向的滚动值。
+*
+*                      page
+*                     ╱
+*    ╭───────────────╮    viewport
+*  ╭─│─ ─ ─ ─ ─ ─ ─ ─│─╮ ╱
+*  │ │ ╭───────────╮ │ │
+*  │ │ │  element  │ │ │
+*  │ │ ╰───────────╯ │ │
+*  ╰─│─ ─ ─ ─ ─ ─ ─ ─│─╯
+*    │               │
+*    │               │
+*    ╰───────────────╯
+*
+* @param {number} viewportHeight viewport 高度
+* @param {number} viewportScrollTop viewport 垂直滚动值
+* @param {number} elementHeight element 高度
+* @param {number} elementOffsetTop element 距离页面顶部距离
+* @param {string} options.position element 在 viewport 中的位置，可选：'start' | 'center' | 'end' | 'nearest'
+* @param {number} options.startOffset element 距离视窗顶部的偏移量
+* @param {number} options.endOffset element 距离视窗底部的偏移量
+* @return {number} viewport 新的垂直滚动值
+*/
+function getScrollIntoViewValue(viewportHeight, viewportScrollTop, elementHeight, elementOffsetTop, options = {}) {
+	const { startOffset = 0, endOffset = 0 } = options;
+	let position = options.position || "nearest";
+	const elementToViewportTopOffset = elementOffsetTop - viewportScrollTop - startOffset;
+	const elementToViewportBottomOffset = elementOffsetTop + elementHeight - viewportScrollTop - viewportHeight + endOffset;
+	if (position === "nearest") if (elementToViewportTopOffset >= 0 && elementToViewportBottomOffset <= 0) return viewportScrollTop;
+	else position = Math.abs(elementToViewportTopOffset) > Math.abs(elementToViewportBottomOffset) ? "end" : "start";
+	let nextScrollTop = 0;
+	switch (position) {
+		case "start":
+			nextScrollTop = elementOffsetTop - startOffset;
+			break;
+		case "center":
+			nextScrollTop = elementOffsetTop - (viewportHeight - elementHeight - endOffset - startOffset) / 2 + startOffset;
+			break;
+		case "end":
+			nextScrollTop = elementOffsetTop + elementHeight - viewportHeight + endOffset;
+			break;
+	}
+	return nextScrollTop;
+}
+function scrollToTarget(scrollEl, targetEl, options = {}) {
+	const { animated, vertical, ...scrollOptions } = options;
+	const scrollRect = scrollEl.getBoundingClientRect();
+	const scrollSize = vertical ? scrollRect.height : scrollRect.width;
+	const scrollOffset = vertical ? scrollEl.scrollTop : scrollEl.scrollLeft;
+	const scrollStart = vertical ? scrollRect.top : scrollRect.left;
+	const targetRect = targetEl.getBoundingClientRect();
+	const scrollValue = getScrollIntoViewValue(scrollSize, scrollOffset, vertical ? targetRect.height : targetRect.width, (vertical ? targetRect.top : targetRect.left) - scrollStart + scrollOffset, scrollOptions);
+	if (typeof scrollEl.scrollTo === "function") scrollEl.scrollTo({
+		[vertical ? "top" : "left"]: scrollValue,
+		behavior: animated ? "smooth" : "instant"
+	});
+	else if (vertical) scrollEl.scrollTop = scrollValue;
+	else scrollEl.scrollLeft = scrollValue;
+}
+/**
+* 匹配元素列表中第一个位于滚动盒子可视区域的元素
+*
+* @param {array} rects DOMRect 类型数组
+* @param {function} callback 匹配成功时调用，会接收匹配的元素的下标
+* @param {number} options.offset 偏移量
+* @param {number} options.errorValue 容错值
+*/
+async function matchScrollVisible(rects, callback, options = {}) {
+	const { offset: optionOffset = 0, errorValue = 3 } = options;
+	const offset = optionOffset + errorValue;
+	const convertedRect = rects.map((rect, i) => {
+		return {
+			top: rect.top,
+			bottom: i < rects.length - 1 ? rects[i + 1].top : 0
+		};
+	});
+	for (let i = 0, l = convertedRect.length; i < l; i++) {
+		const rect = convertedRect[i];
+		if (i === 0 && rect.top > offset) return callback(0);
+		if (rect.top <= offset && rect.bottom > offset) return callback(i);
+		if (i === l - 1 && rect.bottom <= offset) return callback(i);
+	}
+}
+/**
+* 保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取。
+*/
+function getAspectFillSize(origWidth, origHeight, containerWidth, containerHeight) {
+	let width = 0;
+	let height = 0;
+	if (origWidth > 0 && origHeight > 0) if (origWidth / origHeight > containerWidth / containerHeight) {
+		height = containerHeight;
+		width = origWidth / origHeight * containerHeight;
+	} else {
+		width = containerWidth;
+		height = origHeight / origWidth * containerWidth;
+	}
+	return [width, height];
+}
+/**
+* 保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来。
+*/
+function getAspectFitSize(origWidth, origHeight, containerWidth, containerHeight) {
+	let width = 0;
+	let height = 0;
+	if (origWidth > 0 && origHeight > 0) if (origWidth / origHeight > containerWidth / containerHeight) {
+		width = containerWidth;
+		height = origHeight / origWidth * containerWidth;
+	} else {
+		height = containerHeight;
+		width = origWidth / origHeight * containerHeight;
+	}
+	return [width, height];
+}
+/**
+* 获取两点间的距离
+*/
+function getTwoPointsDistance(p1, p2) {
+	return Math.sqrt(Math.pow(p2.x - p1.x, 2) + Math.pow(p2.y - p1.y, 2));
+}
+/**
+* @description: 根据原始坐标尺寸和缩放后的坐标尺寸算出转换的原点
+* @param {Rect} rect
+* @param {Rect} scaleRect
+* @return {[number, number]}
+*/
+function getTransformOrigin(rect, scaleRect) {
+	const ratio = scaleRect.width / rect.width;
+	return [(rect.x + rect.width / 2 - scaleRect.x - scaleRect.width / 2) / (ratio - 1) + rect.width / 2, (rect.y + rect.height / 2 - scaleRect.y - scaleRect.height / 2) / (ratio - 1) + rect.height / 2];
+}
+/**
+* 获取一个矩形以中心点为原点旋转一定角度后的矩形
+*/
+function getRotatedRect(width, height, rotate) {
+	function normalizeAngle0To180(angle) {
+		let normalized = (angle % 360 + 360) % 360;
+		if (normalized > 180) normalized -= 180;
+		return normalized;
+	}
+	rotate = normalizeAngle0To180(rotate);
+	const radian = rotate * Math.PI / 180;
+	const sin = Math.abs(Math.sin(radian));
+	const cos = Math.abs(Math.cos(radian));
+	const w1 = sin * height;
+	const w2 = cos * width;
+	const h1 = cos * height;
+	const h2 = sin * width;
+	return {
+		w1: rotate >= 90 ? w2 : w1,
+		w2: rotate >= 90 ? w1 : w2,
+		h1: rotate >= 90 ? h2 : h1,
+		h2: rotate >= 90 ? h1 : h2,
+		width: w1 + w2,
+		height: h1 + h2
+	};
+}
+const getTouchPoint = (event) => {
+	const touch = event.touches[0] || event.changedTouches[0];
+	return {
+		x: touch.clientX,
+		y: touch.clientY
+	};
+};
+function isRectEqual(a, b) {
+	return a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height;
+}
+function isSizeEqual(a, b) {
+	return a.width === b.width && a.height === b.height;
+}
+//#endregion
+export { getAspectFillSize, getAspectFitSize, getRotatedRect, getScrollIntoViewValue, getTouchPoint, getTransformOrigin, getTwoPointsDistance, isRectEqual, isSizeEqual, matchScrollVisible, scrollToTarget };

package/utils/index.d.ts

@@ -0,0 +1,24 @@
+export * from './bem';
+export * from './date';
+export * from './dom';
+export * from './file';
+export * from './is';
+export * from './utils';
+export * from './qrcode';
+export * from './object';
+export * from './array';
+export * from './string';
+export * from './number';
+export * from './geometry';
+export * from './physics';
+export * from './inertialAnimate';
+export * from './tree';
+export * from './log';
+export * from './color';
+export * from './barcode';
+export * from './canvas';
+export * from './clipboard';
+export * from './vnode';
+export * from './component';
+export * from './scroller';
+export * from './polyfill';

package/utils/index.js

@@ -0,0 +1,27 @@
+import { createBem, createBemStruct, cssVar, cssVarName, defaultBemConfig } from "./bem.js";
+import { clamp, formatNumber, getDecimalsLength, inRange, looseToNumber, mround, random, round } from "./number.js";
+import { baseLunarYear, earthlyBranches, formatDate, getDayOfYear, getDaysAfterLastDay, getDaysBeforeFirstDay, getDaysInMonth, getDaysSinceUnixEpoch, getFirstDayWeekday, getLunarDayName, getLunarHourName, getLunarLeapMonth, getLunarLeapMonthDays, getLunarMonthDays, getLunarMonthName, getLunarYearDays, getLunarYearName, getNextMonthDate, getNextMonthHeadDays, getPrevMonthDate, getPrevMonthTailDays, heavenlyStems, isLeapYear, lunarDayNames, lunarInfo, lunarMonthNames, lunarToSolar, lunarYearNames, minmaxDate, parseDate, solarToLunar, springFestivals, toDate, toDateNumber, toDateString, toMonthNumber } from "./date.js";
+import { checkRtl, toTouchEvent } from "./dom.js";
+import { chooseFile, getFileName, imageDataToDataURL, isFileUrl, isImageFile, isImageUrl, isVideoFile, isVideoUrl, loadImage, readFileContent } from "./file.js";
+import { isBoolean, isConfigObject, isDate, isEmptyArray, isFunction, isNoEmptyArray, isNullish, isNumber, isObject, isPlainObject, isPrimitive, isString, isUndefined } from "./is.js";
+import { addUnit, debounce, getPageRange, isEmptyBinding, isEmptyValue, isRenderVisible, isVisibleEmpty, noop, sleep, splitUnit, throttle } from "./utils.js";
+import { ALPHANUMERIC_CHARS, ECLList, qrcode } from "./qrcode.js";
+import { chainGet, chainSet, deepClone, extend, nestedToMulti, omit, partition, pick, treeToMap } from "./object.js";
+import { arrayEqual, arrayMove, shuffle, spreadEach, toArray } from "./array.js";
+import { addSeparator, camelCase, capitalize, isKorean, kebabCase, lowerFirst, pascalCase, snakeCase, uniqid, upperFirst } from "./string.js";
+import { getAspectFillSize, getAspectFitSize, getRotatedRect, getScrollIntoViewValue, getTouchPoint, getTransformOrigin, getTwoPointsDistance, isRectEqual, isSizeEqual, matchScrollVisible, scrollToTarget } from "./geometry.js";
+import { getDampingValue, getInBoundValue, getOverflowRangeInArea, getRectDampingValue } from "./physics.js";
+import { createInertialAnimate } from "./inertialAnimate.js";
+import { getLeafNodes, getNodeLevel, getTreeCheckedKeys, getTreeHalfCheckedKeys, initializeCheckNodes, mapTreeToGrid, setCheckedRecursively, updateAncestorsChecked, walkAncestor, walkDescendant, walkNodes } from "./tree.js";
+import { logError } from "./log.js";
+import { defaultColorPickerPresets, defaultColorPickerValue, formatColor, getPreviewColor, hslToHsv, hslToHwb, hslToRgb, hsvToHsl, hwbToHsl, normalizeHsla, normalizeHsva, parseColor, rgbToHsl } from "./color.js";
+import { BarcodeFormatList, BarcodeTextPositionList, barcode, calculateBarcodeLayout, normalizeBarcodeOptions } from "./barcode.js";
+import { measureTextWidth } from "./canvas.js";
+import { clipboard } from "./clipboard.js";
+import { OnlyChild, flatVNode } from "./vnode.js";
+import { defineSetupFnComponent, enhanceComponent } from "./component.js";
+import { Friction } from "./scroller/Friction.js";
+import { Spring } from "./scroller/Spring.js";
+import { withResolvers } from "./polyfill.js";
+import { useScroller } from "./scroller/useScroller.js";
+export { ALPHANUMERIC_CHARS, BarcodeFormatList, BarcodeTextPositionList, ECLList, Friction, OnlyChild, Spring, addSeparator, addUnit, arrayEqual, arrayMove, barcode, baseLunarYear, calculateBarcodeLayout, camelCase, capitalize, chainGet, chainSet, checkRtl, chooseFile, clamp, clipboard, createBem, createBemStruct, createInertialAnimate, cssVar, cssVarName, debounce, deepClone, defaultBemConfig, defaultColorPickerPresets, defaultColorPickerValue, defineSetupFnComponent, earthlyBranches, enhanceComponent, extend, flatVNode, formatColor, formatDate, formatNumber, getAspectFillSize, getAspectFitSize, getDampingValue, getDayOfYear, getDaysAfterLastDay, getDaysBeforeFirstDay, getDaysInMonth, getDaysSinceUnixEpoch, getDecimalsLength, getFileName, getFirstDayWeekday, getInBoundValue, getLeafNodes, getLunarDayName, getLunarHourName, getLunarLeapMonth, getLunarLeapMonthDays, getLunarMonthDays, getLunarMonthName, getLunarYearDays, getLunarYearName, getNextMonthDate, getNextMonthHeadDays, getNodeLevel, getOverflowRangeInArea, getPageRange, getPrevMonthDate, getPrevMonthTailDays, getPreviewColor, getRectDampingValue, getRotatedRect, getScrollIntoViewValue, getTouchPoint, getTransformOrigin, getTreeCheckedKeys, getTreeHalfCheckedKeys, getTwoPointsDistance, heavenlyStems, hslToHsv, hslToHwb, hslToRgb, hsvToHsl, hwbToHsl, imageDataToDataURL, inRange, initializeCheckNodes, isBoolean, isConfigObject, isDate, isEmptyArray, isEmptyBinding, isEmptyValue, isFileUrl, isFunction, isImageFile, isImageUrl, isKorean, isLeapYear, isNoEmptyArray, isNullish, isNumber, isObject, isPlainObject, isPrimitive, isRectEqual, isRenderVisible, isSizeEqual, isString, isUndefined, isVideoFile, isVideoUrl, isVisibleEmpty, kebabCase, loadImage, logError, looseToNumber, lowerFirst, lunarDayNames, lunarInfo, lunarMonthNames, lunarToSolar, lunarYearNames, mapTreeToGrid, matchScrollVisible, measureTextWidth, minmaxDate, mround, nestedToMulti, noop, normalizeBarcodeOptions, normalizeHsla, normalizeHsva, omit, parseColor, parseDate, partition, pascalCase, pick, qrcode, random, readFileContent, rgbToHsl, round, scrollToTarget, setCheckedRecursively, shuffle, sleep, snakeCase, solarToLunar, splitUnit, spreadEach, springFestivals, throttle, toArray, toDate, toDateNumber, toDateString, toMonthNumber, toTouchEvent, treeToMap, uniqid, updateAncestorsChecked, upperFirst, useScroller, walkAncestor, walkDescendant, walkNodes, withResolvers };

package/utils/inertialAnimate.d.ts

@@ -0,0 +1,10 @@
+export interface InertialAnimateOptions {
+    update?: (value: number) => void;
+    complete?: () => void;
+}
+export declare function createInertialAnimate(v: number, options: InertialAnimateOptions): {
+    stop: () => void;
+    play: () => void;
+    isAnimating(): boolean;
+};
+export type InertialAnimate = ReturnType<typeof createInertialAnimate>;

package/utils/inertialAnimate.js

@@ -0,0 +1,44 @@
+import { ticker } from "lwa";
+//#region packages/sard/utils/inertialAnimate.ts
+const friction = .95;
+const minVelocity = .1;
+function createInertialAnimate(v, options) {
+	const initialVelocity = Math.abs(v);
+	let isAnimating = false;
+	const reversed = v < 0;
+	const { update, complete } = options;
+	let velocity = initialVelocity;
+	function animate() {
+		if (!isAnimating) return;
+		velocity *= friction;
+		let displacement = velocity * 15;
+		displacement *= reversed ? -1 : 1;
+		update?.(displacement);
+		if (velocity < minVelocity) {
+			isAnimating = false;
+			ticker.remove(animate);
+			complete?.();
+		}
+	}
+	function play() {
+		if (!isAnimating) {
+			isAnimating = true;
+			ticker.add(animate);
+		}
+	}
+	function stop() {
+		if (isAnimating) {
+			isAnimating = false;
+			ticker.remove(animate);
+		}
+	}
+	return {
+		stop,
+		play,
+		isAnimating() {
+			return isAnimating;
+		}
+	};
+}
+//#endregion
+export { createInertialAnimate };

package/utils/is.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @description: 判断是否为纯对象
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isPlainObject(target: any): target is Record<PropertyKey, any>;
+/**
+ * @description: 判断是否为空数组
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isEmptyArray(target: any): target is [];
+/**
+ * @description: 判断是否为非空数组
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isNoEmptyArray(target: any): target is [];
+/**
+ * @description: 判断是否为对象
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isObject(target: any): target is object & {
+    [key: PropertyKey]: any;
+};
+/**
+ * @description: 判断是否为函数
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isFunction(target: any): target is (...args: any[]) => any;
+/**
+ * @description: 判断是否为字符串
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isString(target: any): target is string;
+/**
+ * @description: 判断是否为数值
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isNumber(target: any): target is number;
+/**
+ * @description: 判断是否为布尔值
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isBoolean(target: any): target is boolean;
+/**
+ * @description: 判断是否为undefined
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isUndefined(target: any): target is undefined;
+/**
+ * @description: 判断是否为null或者undefined
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isNullish(target: any): target is null | undefined;
+/**
+ * @description: 判断是否为原始类型
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isPrimitive(target: any): target is string | number | boolean;
+/**
+ * @description: 判断是否为日期类型
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isDate(target: any): target is Date;
+/**
+ * 判断是否为配置对象（而非 VNode）
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isConfigObject(target: any): target is Record<PropertyKey, any>;