@ceale/util 1.12.5 → 1.13.0

package/README.md

@@ -40,4 +40,6 @@
     - class `QuadraticBezier`
     - class `CubicBezier`
 - `error.ts`
-    - tryCatch()
+    - tryCatch()
+- `type.ts`
+    - assert()

package/dist/cjs/index.js

@@ -40,6 +40,7 @@ __export(exports_src, {
   debounce: () => debounce,
   cubicCurve: () => cubicCurve,
   css: () => css,
+  assert: () => assert,
   QuadraticBezier: () => QuadraticBezier,
   CubicBezier: () => CubicBezier
 });
@@ -255,12 +256,6 @@ var throttle = (func, delay) => {
   };
 };
 // src/bezier.ts
-class BezierError extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "BezierError";
-  }
-}
 var quadraticCurve;
 ((quadraticCurve) => {
   quadraticCurve.solveX = (p1, t) => {
@@ -346,7 +341,7 @@ class QuadraticBezier {
     this.p1 = p1;
     this.accuracy = accuracy;
     if (this.p1[0] < 0 || this.p1[0] > 1) {
-      throw new BezierError("控制点P1的x坐标必须在[0, 1]之间");
+      throw new TypeError("控制点P1的x坐标必须在[0, 1]之间");
     }
     if (accuracy !== -1) {
       this.accuracy = 10 ** accuracy;
@@ -382,10 +377,10 @@ class CubicBezier {
     this.p2 = p2;
     this.accuracy = accuracy;
     if (this.p1[0] < 0 || this.p1[0] > 1) {
-      throw new BezierError("控制点P1的x坐标必须在[0, 1]之间");
+      throw new TypeError("控制点P1的x坐标必须在[0, 1]之间");
     }
     if (this.p2[0] < 0 || this.p2[0] > 1) {
-      throw new BezierError("控制点P2的x坐标必须在[0, 1]之间");
+      throw new TypeError("控制点P2的x坐标必须在[0, 1]之间");
     }
     if (accuracy !== -1) {
       this.accuracy = 10 ** accuracy;
@@ -425,3 +420,5 @@ var tryCatch = (parameter) => {
   }
   throw new TypeError("参数类型错误，应为 Promise 或函数");
 };
+// src/type.ts
+var assert = (v) => {};

package/dist/esm/index.js

@@ -208,12 +208,6 @@ var throttle = (func, delay) => {
   };
 };
 // src/bezier.ts
-class BezierError extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "BezierError";
-  }
-}
 var quadraticCurve;
 ((quadraticCurve) => {
   quadraticCurve.solveX = (p1, t) => {
@@ -299,7 +293,7 @@ class QuadraticBezier {
     this.p1 = p1;
     this.accuracy = accuracy;
     if (this.p1[0] < 0 || this.p1[0] > 1) {
-      throw new BezierError("控制点P1的x坐标必须在[0, 1]之间");
+      throw new TypeError("控制点P1的x坐标必须在[0, 1]之间");
     }
     if (accuracy !== -1) {
       this.accuracy = 10 ** accuracy;
@@ -335,10 +329,10 @@ class CubicBezier {
     this.p2 = p2;
     this.accuracy = accuracy;
     if (this.p1[0] < 0 || this.p1[0] > 1) {
-      throw new BezierError("控制点P1的x坐标必须在[0, 1]之间");
+      throw new TypeError("控制点P1的x坐标必须在[0, 1]之间");
     }
     if (this.p2[0] < 0 || this.p2[0] > 1) {
-      throw new BezierError("控制点P2的x坐标必须在[0, 1]之间");
+      throw new TypeError("控制点P2的x坐标必须在[0, 1]之间");
     }
     if (accuracy !== -1) {
       this.accuracy = 10 ** accuracy;
@@ -378,6 +372,8 @@ var tryCatch = (parameter) => {
   }
   throw new TypeError("参数类型错误，应为 Promise 或函数");
 };
+// src/type.ts
+var assert = (v) => {};
 export {
   waitSync,
   wait,
@@ -390,6 +386,7 @@ export {
   debounce,
   cubicCurve,
   css,
+  assert,
   QuadraticBezier,
   CubicBezier
 };

package/dist/types/index.d.ts

@@ -6,3 +6,4 @@ export * from "./time";
 export * from "./task";
 export * from "./bezier";
 export * from "./error";
+export * from "./type";

package/dist/types/object.d.ts

@@ -0,0 +1,34 @@
+declare global {
+    interface Object {
+        deepAssign<T, U>(target: T, source: U, options?: DeepAssignOptions): T & U;
+        deepAssign<T, U, V>(target: T, source1: U, source2: V, options?: DeepAssignOptions): T & U & V;
+        deepAssign<T, U, V, W>(target: T, source1: U, source2: V, source3: W, options?: DeepAssignOptions): T & U & V & W;
+        deepAssign(target: any, ...sources: any[]): any;
+    }
+}
+interface DeepAssignOptions {
+    /**
+     * 合并深度:
+     * - true: 无限深度
+     * - false: 浅层合并 (等同于 Object.assign)
+     * - number: 指定最大深度
+     * @default true
+     */
+    deep?: boolean | number;
+    /**
+     * 是否覆盖目标对象属性:
+     * - true: 源对象属性覆盖目标对象
+     * - false: 只合并目标对象没有的属性
+     * @default true
+     */
+    overwrite?: boolean;
+    /**
+     * 数组合并策略:
+     * - 'merge': （默认）合并数组项 (递归合并数组元素)
+     * - 'concat': 连接数组
+     * - 'replace': 替换整个数组
+     * @default 'replace'
+     */
+    arrayStrategy?: 'replace' | 'merge' | 'concat';
+}
+export {};

package/dist/types/type.d.ts

@@ -0,0 +1 @@
+export declare const assert: <T = any>(v: any) => asserts v is T;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ceale/util",
   "author": "Ceale",
-  "version": "1.12.5",
+  "version": "1.13.0",
   "module": "index.ts",
   "type": "module",
   "main": "dist/esm/index.js",