@wener/utils 1.1.26 → 1.1.29

package/lib/validations/asserts.js

@@ -0,0 +1,14 @@
+export function assert(condition, msg) {
+    // if (!condition) {
+    //   throw new AssertionError(msg);
+    // }
+    console.assert(!condition, msg);
+}
+export function assertIsDefined(val) {
+    // if (val === undefined || val === null) {
+    //   throw new AssertionError(`Expected 'val' to be defined, but received ${val}`);
+    // }
+    console.assert(val === undefined || val === null, 'Expected defined');
+}
+
+//# sourceMappingURL=asserts.js.map

package/lib/validations/asserts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/validations/asserts.ts"],"sourcesContent":["export function assert(condition: any, msg?: string): asserts condition {\n  // if (!condition) {\n  //   throw new AssertionError(msg);\n  // }\n  console.assert(!condition, msg);\n}\n\nexport function assertIsDefined<T>(val: T): asserts val is NonNullable<T> {\n  // if (val === undefined || val === null) {\n  //   throw new AssertionError(`Expected 'val' to be defined, but received ${val}`);\n  // }\n  console.assert(val === undefined || val === null, 'Expected defined');\n}\n"],"names":["assert","condition","msg","console","assertIsDefined","val","undefined"],"mappings":"AAAA,OAAO,SAASA,OAAOC,SAAc,EAAEC,GAAY;IACjD,oBAAoB;IACpB,mCAAmC;IACnC,IAAI;IACJC,QAAQH,MAAM,CAAC,CAACC,WAAWC;AAC7B;AAEA,OAAO,SAASE,gBAAmBC,GAAM;IACvC,2CAA2C;IAC3C,mFAAmF;IACnF,IAAI;IACJF,QAAQH,MAAM,CAACK,QAAQC,aAAaD,QAAQ,MAAM;AACpD"}

package/lib/validations/isUUID.js

@@ -1,6 +1,5 @@
-function isUUID(str) {
-  return Boolean(str) && /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(String(str));
+export function isUUID(str) {
+    return Boolean(str) && /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(String(str));
 }
 
-export { isUUID };
-//# sourceMappingURL=isUUID.js.map
+//# sourceMappingURL=isUUID.js.map

package/lib/validations/isUUID.js.map

@@ -1 +1 @@
-{"version":3,"file":"isUUID.js","sources":["../../src/validations/isUUID.ts"],"sourcesContent":["export function isUUID(str: string | undefined | null) {\n  return Boolean(str) && /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(String(str));\n}\n"],"names":[],"mappings":"AAAO,SAAS,OAAO,GAAgC,EAAA;AACrD,EAAA,OAAO,QAAQ,GAAG,CAAA,IAAK,yEAAyE,IAAK,CAAA,MAAA,CAAO,GAAG,CAAC,CAAA,CAAA;AAClH;;;;"}
+{"version":3,"sources":["../../src/validations/isUUID.ts"],"sourcesContent":["export function isUUID(str: string | undefined | null) {\n  return Boolean(str) && /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(String(str));\n}\n"],"names":["isUUID","str","Boolean","test","String"],"mappings":"AAAA,OAAO,SAASA,OAAOC,GAA8B;IACnD,OAAOC,QAAQD,QAAQ,yEAAyEE,IAAI,CAACC,OAAOH;AAC9G"}

package/lib/validations/parseTimestamp.js

@@ -1,25 +1,29 @@
-function parseTimestamp(raw) {
-  if (!raw) {
-    return void 0;
-  }
-  if (raw instanceof Date) {
-    return raw;
-  }
-  if (typeof raw === "string" && /^[0-9.]+$/.test(raw)) {
-    let n = parseFloat(raw);
-    const len = Math.floor(n).toString().length;
-    if (len <= 11) {
-      n *= 1e3;
+export function parseTimestamp(raw) {
+    if (!raw) {
+        return undefined;
     }
-    return new Date(n);
-  } else if (typeof raw === "string") {
-    const date = new Date(raw);
-    if (!isNaN(+date)) {
-      return date;
+    if (raw instanceof Date) {
+        return raw;
     }
-  }
-  throw new Error(`parseTimestamp: invalid "${raw}"`);
+    if (typeof raw === 'string' && /^[0-9.]+$/.test(raw)) {
+        let n = parseFloat(raw);
+        const len = Math.floor(n).toString().length;
+        /*
+    最常见的是 10 位和 13 位
+    9999999999 - 10*9 - 1970-04-26
+    99999999999 - 11*9 - 1973
+    999999999999 - 12*9 - 2001
+     */ if (len <= 11) {
+            n *= 1000;
+        }
+        return new Date(n);
+    } else if (typeof raw === 'string') {
+        const date = new Date(raw);
+        if (!isNaN(+date)) {
+            return date;
+        }
+    }
+    throw new Error(`parseTimestamp: invalid "${raw}"`);
 }
 
-export { parseTimestamp };
-//# sourceMappingURL=parseTimestamp.js.map
+//# sourceMappingURL=parseTimestamp.js.map

package/lib/validations/parseTimestamp.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseTimestamp.js","sources":["../../src/validations/parseTimestamp.ts"],"sourcesContent":["export function parseTimestamp(raw?: string | number | Date): Date | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  if (raw instanceof Date) {\n    return raw;\n  }\n\n  if (typeof raw === 'string' && /^[0-9.]+$/.test(raw)) {\n    let n = parseFloat(raw);\n    const len = Math.floor(n).toString().length;\n    /*\n    最常见的是 10 位和 13 位\n    9999999999 - 10*9 - 1970-04-26\n    99999999999 - 11*9 - 1973\n    999999999999 - 12*9 - 2001\n     */\n    if (len <= 11) {\n      n *= 1000;\n    }\n    return new Date(n);\n  } else if (typeof raw === 'string') {\n    const date = new Date(raw);\n    if (!isNaN(+date)) {\n      return date;\n    }\n  }\n  throw new Error(`parseTimestamp: invalid \"${raw}\"`);\n}\n"],"names":[],"mappings":"AAAO,SAAS,eAAe,GAAgD,EAAA;AAC7E,EAAA,IAAI,CAAC,GAAK,EAAA;AACR,IAAO,OAAA,KAAA,CAAA,CAAA;AAAA,GACT;AACA,EAAA,IAAI,eAAe,IAAM,EAAA;AACvB,IAAO,OAAA,GAAA,CAAA;AAAA,GACT;AAEA,EAAA,IAAI,OAAO,GAAQ,KAAA,QAAA,IAAY,WAAY,CAAA,IAAA,CAAK,GAAG,CAAG,EAAA;AACpD,IAAI,IAAA,CAAA,GAAI,WAAW,GAAG,CAAA,CAAA;AACtB,IAAA,MAAM,MAAM,IAAK,CAAA,KAAA,CAAM,CAAC,CAAA,CAAE,UAAW,CAAA,MAAA,CAAA;AAOrC,IAAA,IAAI,OAAO,EAAI,EAAA;AACb,MAAK,CAAA,IAAA,GAAA,CAAA;AAAA,KACP;AACA,IAAO,OAAA,IAAI,KAAK,CAAC,CAAA,CAAA;AAAA,GACnB,MAAA,IAAW,OAAO,GAAA,KAAQ,QAAU,EAAA;AAClC,IAAM,MAAA,IAAA,GAAO,IAAI,IAAA,CAAK,GAAG,CAAA,CAAA;AACzB,IAAA,IAAI,CAAC,KAAA,CAAM,CAAC,IAAI,CAAG,EAAA;AACjB,MAAO,OAAA,IAAA,CAAA;AAAA,KACT;AAAA,GACF;AACA,EAAA,MAAM,IAAI,KAAA,CAAM,CAA4B,yBAAA,EAAA,GAAG,CAAG,CAAA,CAAA,CAAA,CAAA;AACpD;;;;"}
+{"version":3,"sources":["../../src/validations/parseTimestamp.ts"],"sourcesContent":["export function parseTimestamp(raw?: string | number | Date): Date | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  if (raw instanceof Date) {\n    return raw;\n  }\n\n  if (typeof raw === 'string' && /^[0-9.]+$/.test(raw)) {\n    let n = parseFloat(raw);\n    const len = Math.floor(n).toString().length;\n    /*\n    最常见的是 10 位和 13 位\n    9999999999 - 10*9 - 1970-04-26\n    99999999999 - 11*9 - 1973\n    999999999999 - 12*9 - 2001\n     */\n    if (len <= 11) {\n      n *= 1000;\n    }\n    return new Date(n);\n  } else if (typeof raw === 'string') {\n    const date = new Date(raw);\n    if (!isNaN(+date)) {\n      return date;\n    }\n  }\n  throw new Error(`parseTimestamp: invalid \"${raw}\"`);\n}\n"],"names":["parseTimestamp","raw","undefined","Date","test","n","parseFloat","len","Math","floor","toString","length","date","isNaN","Error"],"mappings":"AAAA,OAAO,SAASA,eAAeC,GAA4B;IACzD,IAAI,CAACA,KAAK;QACR,OAAOC;IACT;IACA,IAAID,eAAeE,MAAM;QACvB,OAAOF;IACT;IAEA,IAAI,OAAOA,QAAQ,YAAY,YAAYG,IAAI,CAACH,MAAM;QACpD,IAAII,IAAIC,WAAWL;QACnB,MAAMM,MAAMC,KAAKC,KAAK,CAACJ,GAAGK,QAAQ,GAAGC,MAAM;QAC3C;;;;;KAKC,GACD,IAAIJ,OAAO,IAAI;YACbF,KAAK;QACP;QACA,OAAO,IAAIF,KAAKE;IAClB,OAAO,IAAI,OAAOJ,QAAQ,UAAU;QAClC,MAAMW,OAAO,IAAIT,KAAKF;QACtB,IAAI,CAACY,MAAM,CAACD,OAAO;YACjB,OAAOA;QACT;IACF;IACA,MAAM,IAAIE,MAAM,CAAC,yBAAyB,EAAEb,IAAI,CAAC,CAAC;AACpD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wener/utils",
-  "version": "1.1.26",
+  "version": "1.1.29",
   "type": "module",
   "description": "Utils for daily use",
   "repository": {
@@ -30,6 +30,12 @@
     "template",
     "lodash"
   ],
+  "scripts": {
+    "build": "make prepublish",
+    "clean": "make clean",
+    "dev": "make dev",
+    "test": "make test"
+  },
   "peerDependencies": {
     "undici": "*"
   },
@@ -39,16 +45,56 @@
     }
   },
   "devDependencies": {
-    "@types/lodash": "^4.14.200",
-    "@types/ws": "^8.5.8",
+    "@sinclair/typebox": "^0.32.8",
+    "@types/lodash": "^4.14.202",
+    "@types/ws": "^8.5.10",
     "https-proxy-agent": "^7.0.2",
     "lodash": "^4.17.21",
     "node-fetch": "^3.3.2",
-    "undici": "^5.27.0"
+    "undici": "^6.3.0",
+    "zod": "^3.22.4"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
-    "access": "public"
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./src/index.ts",
+        "typescript": "./src/index.ts",
+        "system": "./dist/system/index.js",
+        "import": "./lib/index.js"
+      },
+      "./types": {
+        "types": "./types.d.ts"
+      },
+      "./server": {
+        "types": "./src/server.ts",
+        "typescript": "./src/server.ts",
+        "system": "./dist/system/server.js",
+        "import": "./lib/server.js"
+      },
+      "./server/node-fetch": {
+        "types": "./server/node-fetch.ts",
+        "default": "./lib/servers/node-fetch.js"
+      },
+      "./server/jsdom": {
+        "types": "./server/jsdom.ts",
+        "default": "./lib/servers/jsdom.js"
+      },
+      "./server/ws": {
+        "types": "./server/ws.ts",
+        "default": "./lib/servers/ws.js"
+      },
+      "./schema/typebox": {
+        "types": "./schema/typebox/index.ts",
+        "default": "./lib/schema/typebox/index.js"
+      },
+      "./schema/typebox/gen": {
+        "types": "./schema/typebox/gen/index.ts",
+        "default": "./lib/schema/typebox/gen/index.js"
+      },
+      "./package.json": "./package.json"
+    }
   },
   "sideEffects": false,
   "rollup": {
@@ -57,7 +103,9 @@
       "./src/server.ts",
       "./src/servers/ws.ts",
       "./src/servers/jsdom.ts",
-      "./src/servers/node-fetch.ts"
+      "./src/servers/node-fetch.ts",
+      "./src/schema/typebox/index.ts",
+      "./src/schema/typebox/gen/index.ts"
     ],
     "external": [
       "crypto",
@@ -65,43 +113,10 @@
       "node-fetch",
       "ws",
       "https-proxy-agent",
-      "undici"
+      "undici",
+      "zod",
+      "typescript",
+      "@sinclair/typebox"
     ]
-  },
-  "scripts": {
-    "build": "make prepublish",
-    "clean": "make clean",
-    "dev": "make dev",
-    "test": "make test"
-  },
-  "exports": {
-    ".": {
-      "types": "./src/index.ts",
-      "typescript": "./src/index.ts",
-      "system": "./dist/system/index.js",
-      "import": "./lib/index.js"
-    },
-    "./types": {
-      "types": "./types.d.ts"
-    },
-    "./server": {
-      "types": "./src/server.ts",
-      "typescript": "./src/server.ts",
-      "system": "./dist/system/server.js",
-      "import": "./lib/server.js"
-    },
-    "./server/node-fetch": {
-      "types": "./server/node-fetch.ts",
-      "default": "./lib/servers/node-fetch.js"
-    },
-    "./server/jsdom": {
-      "types": "./server/jsdom.ts",
-      "default": "./lib/servers/jsdom.js"
-    },
-    "./server/ws": {
-      "types": "./server/ws.ts",
-      "default": "./lib/servers/ws.js"
-    },
-    "./package.json": "./package.json"
   }
-}
+}

package/src/index.ts

@@ -32,6 +32,7 @@ export { isPromise } from './asyncs/isPromise';
 // langs
 export { shallowEqual } from './langs/shallowEqual';
 export { deepEqual } from './langs/deepEqual';
+export { deepFreeze } from './langs/deepFreeze';
 export { classOf } from './langs/classOf';
 export { shallowClone } from './langs/shallowClone';
 export { isClass } from './langs/isClass';
@@ -79,8 +80,6 @@ export { getFileFromDataTransfer } from './browsers/getFileFromDataTransfer';
 // polyfills
 export { getGlobalThis } from './isomorphics/getGlobalThis';
 export { structuredClone } from './isomorphics/structuredClone';
-// should not export as sideEffect
-// export { globalThis } from './isomorphics/globalThis';
 
 // crypto
 export { randomUUID } from './crypto/randomUUID';
@@ -91,8 +90,9 @@ export { hex } from './crypto/base';
 export { isULID, createULID, ulid, parseULID } from './crypto/ulid';
 export { PEM } from './crypto/pem/pem';
 
-// misc
+// math
 export { createRandom } from './maths/random';
+export { clamp } from './maths/clamp';
 
 // network
 export {

package/src/langs/deepFreeze.ts

@@ -0,0 +1,19 @@
+/**
+ * Freezes the given object and all its nested objects recursively.
+ *
+ * @param {T} obj - The object to freeze.
+ * @returns {T} - The frozen object.
+ */
+export function deepFreeze<T>(obj: T): T {
+  if (obj === null || typeof obj !== 'object') {
+    return obj;
+  }
+  const props = Object.getOwnPropertyNames(obj);
+  for (const prop of props) {
+    const value = (obj as any)[prop];
+    if (value && typeof value === 'object') {
+      deepFreeze(value);
+    }
+  }
+  return Object.freeze(obj);
+}

package/src/langs/hashCode.ignored.ts

@@ -0,0 +1,125 @@
+function sortObjectKeys(obj?: Record<string, any>) {
+  if (obj === null || obj === undefined) {
+    return obj;
+  }
+  if (typeof obj !== 'object') {
+    // it is a primitive: number/string (in an array)
+    return obj;
+  }
+  return Object.keys(obj)
+    .sort()
+    .reduce(
+      (acc, key) => {
+        if (Array.isArray(obj[key])) {
+          acc[key] = obj[key].map(sortObjectKeys);
+        } else if (typeof obj[key] === 'object') {
+          acc[key] = sortObjectKeys(obj[key]);
+        } else {
+          acc[key] = obj[key];
+        }
+        return acc;
+      },
+      {} as Record<string, any>,
+    );
+}
+
+function toDeterministicJson(o: any) {
+  // https://github.com/kikobeats/json-stringify-deterministic
+  // https://stackoverflow.com/a/54902696/1870054
+  // https://github.com/sinclairzx81/typebox#hash
+  // https://github.com/sinclairzx81/typebox/blob/master/src/value/hash.ts
+  // LCS longest common subsequence
+  // https://github.com/sinclairzx81/typebox/issues/272
+  let sorted: any = sortObjectKeys(o);
+  let out = JSON.stringify(sorted, function (_, v) {
+    return v === undefined ? 'undef' : v;
+  });
+
+  // Remove all whitespace
+  return out.replace(/\s+/g, '');
+}
+
+interface Visitor<C> {
+  array: (o: any[], ctx: C) => any;
+  object: (o: Record<string, any>, ctx: C) => any;
+  boolean: (o: boolean, ctx: C) => any;
+  number: (o: number, ctx: C) => any;
+  string: (o: string, ctx: C) => any;
+  symbol: (o: symbol, ctx: C) => any;
+  bigint: (o: bigint, ctx: C) => any;
+  date: (o: Date, ctx: C) => any;
+  buffer: (o: ArrayBuffer, ctx: C) => any;
+  null: (o: null, ctx: C) => any;
+  undefined: (o: undefined, ctx: C) => any;
+  unknown: (o: unknown, ctx: C) => any;
+  visit: (o: any, ctx: C) => any;
+}
+
+function visit<C>(o: any, _v: Partial<Visitor<C>>, ctx: C) {
+  const v = {
+    array: (o: any[], ctx: C): any => o.map((x) => v.visit(x, ctx)),
+    object: (o: Record<string, any>, ctx: C) => {
+      return Object.fromEntries(Object.entries(o).map(([k, v]) => [k, v.visit(v, ctx)]));
+    },
+    buffer: (o: ArrayBuffer) => {
+      return o;
+    },
+    boolean: (o: boolean) => o,
+    number: (o: number) => o,
+    string: (o: string) => o,
+    symbol: (o: symbol) => o,
+    bigint: (o: bigint) => o,
+    date: (o: Date) => o,
+    null: (o: null) => o,
+    undefined: (o: undefined) => o,
+    unknown: (o: unknown, ctx: C): any => {
+      if (o instanceof Map) {
+        return new Map([...o.entries()].map(([k, v]) => [k, v.visit(v, ctx)]));
+      }
+      if (o instanceof Set) {
+        return new Set([...o.values()].map((v) => v.visit(v, ctx)));
+      }
+      return o;
+    },
+    visit: (o: any, ctx: C): any => {
+      if (o === null) {
+        return v.null(o, ctx);
+      }
+      switch (typeof o) {
+        case 'object':
+          if (o instanceof ArrayBuffer) {
+            return v.buffer(o, ctx);
+          }
+          if (Array.isArray(o)) {
+            return v.array(o, ctx);
+          }
+          if (o instanceof Date) {
+            return v.date(o, ctx);
+          }
+          // plain object
+          if (o.constructor === Object) {
+            return v.object(o, ctx);
+          }
+          //
+          return v.unknown(o, ctx);
+        case 'boolean':
+          return v.boolean(o, ctx);
+        case 'number':
+          return v.number(o, ctx);
+        case 'string':
+          return v.string(o, ctx);
+        case 'symbol':
+          return v.symbol(o, ctx);
+        case 'bigint':
+          return v.bigint(o, ctx);
+        case 'undefined':
+          return v.undefined(o, ctx);
+        default:
+          return v.unknown(o, ctx);
+      }
+    },
+    ..._v,
+  };
+
+  return v.visit(o, ctx);
+}

package/src/libs/README.md

@@ -1 +1,3 @@
 - https://github.com/vercel/ms/blob/master/src/index.ts
+  - Apr 22, 2022
+  - dfd18036f359a3b80bf38d3d8c0bb850c0dc9b66

package/src/logging/slog.ts

@@ -98,3 +98,124 @@ createLogger.writer = (record: LogRecord) => {
   const { level } = record;
   console[level || 'info'](stringify(record));
 };
+
+// https://github.com/alexeyraspopov/picocolors/blob/main/picocolors.js
+/*
+MDN: Styling console output
+https://developer.mozilla.org/en-US/docs/Web/API/console#Usage
+
+Chrome: Console API Reference
+https://developers.google.com/web/tools/chrome-devtools/console/console-write#styling_console_output_with_css
+
+WebKit: Console Object API
+https://webkit.org/web-inspector/console-object-api/
+
+https://stackoverflow.com/questions/7505623
+
+console.log('\x1b[36m Hello \x1b[34m Colored \x1b[35m World!');
+console.log('\x1B[31mHello\x1B[34m World');
+console.log('\x1b[43mHighlighted');
+
+
+NestJS Formatter
+https://github.com/nestjs/nest/blob/d4bda940fc10238eb18f14ebf66d66b7ef8bff41/packages/common/services/console-logger.service.ts#L201-L227
+
+ */
+
+export type Formatter = (input: string | number | null | undefined) => string;
+
+export interface Colors {
+  isColorSupported: boolean;
+  reset: Formatter;
+  bold: Formatter;
+  dim: Formatter;
+  italic: Formatter;
+  underline: Formatter;
+  inverse: Formatter;
+  hidden: Formatter;
+  strikethrough: Formatter;
+  black: Formatter;
+  red: Formatter;
+  green: Formatter;
+  yellow: Formatter;
+  blue: Formatter;
+  magenta: Formatter;
+  cyan: Formatter;
+  white: Formatter;
+  gray: Formatter;
+  bgBlack: Formatter;
+  bgRed: Formatter;
+  bgGreen: Formatter;
+  bgYellow: Formatter;
+  bgBlue: Formatter;
+  bgMagenta: Formatter;
+  bgCyan: Formatter;
+  bgWhite: Formatter;
+}
+
+let formatter =
+  (open: string, close: string, replace: string = open) =>
+  (input: string) => {
+    let string = '' + input;
+    let index = string.indexOf(close, open.length);
+    return ~index ? open + replaceClose(string, close, replace, index) + close : open + string + close;
+  };
+
+let replaceClose = (string: string, close: string, replace: string, index: number): string => {
+  let start = string.substring(0, index) + replace;
+  let end = string.substring(index + close.length);
+  let nextIndex = end.indexOf(close);
+  return ~nextIndex ? start + replaceClose(end, close, replace, nextIndex) : start + end;
+};
+
+function getEnv(): Record<string, string | undefined> {
+  if (typeof process === 'object') {
+    return process.env;
+  }
+  return {};
+}
+
+function isColorSupported() {
+  if (typeof window === 'object') {
+    return true;
+  }
+  const env = getEnv();
+  if ('NO_COLOR' in env) {
+    return false;
+  }
+  if ('FORCE_COLOR' in env || 'CI' in env) {
+    return true;
+  }
+  return false;
+}
+
+export function createConsoleColors(enabled = isColorSupported()) {
+  return {
+    isColorSupported: enabled,
+    reset: enabled ? (s: string) => `\x1b[0m${s}\x1b[0m` : String,
+    bold: enabled ? formatter('\x1b[1m', '\x1b[22m', '\x1b[22m\x1b[1m') : String,
+    dim: enabled ? formatter('\x1b[2m', '\x1b[22m', '\x1b[22m\x1b[2m') : String,
+    italic: enabled ? formatter('\x1b[3m', '\x1b[23m') : String,
+    underline: enabled ? formatter('\x1b[4m', '\x1b[24m') : String,
+    inverse: enabled ? formatter('\x1b[7m', '\x1b[27m') : String,
+    hidden: enabled ? formatter('\x1b[8m', '\x1b[28m') : String,
+    strikethrough: enabled ? formatter('\x1b[9m', '\x1b[29m') : String,
+    black: enabled ? formatter('\x1b[30m', '\x1b[39m') : String,
+    red: enabled ? formatter('\x1b[31m', '\x1b[39m') : String,
+    green: enabled ? formatter('\x1b[32m', '\x1b[39m') : String,
+    yellow: enabled ? formatter('\x1b[33m', '\x1b[39m') : String,
+    blue: enabled ? formatter('\x1b[34m', '\x1b[39m') : String,
+    magenta: enabled ? formatter('\x1b[35m', '\x1b[39m') : String,
+    cyan: enabled ? formatter('\x1b[36m', '\x1b[39m') : String,
+    white: enabled ? formatter('\x1b[37m', '\x1b[39m') : String,
+    gray: enabled ? formatter('\x1b[90m', '\x1b[39m') : String,
+    bgBlack: enabled ? formatter('\x1b[40m', '\x1b[49m') : String,
+    bgRed: enabled ? formatter('\x1b[41m', '\x1b[49m') : String,
+    bgGreen: enabled ? formatter('\x1b[42m', '\x1b[49m') : String,
+    bgYellow: enabled ? formatter('\x1b[43m', '\x1b[49m') : String,
+    bgBlue: enabled ? formatter('\x1b[44m', '\x1b[49m') : String,
+    bgMagenta: enabled ? formatter('\x1b[45m', '\x1b[49m') : String,
+    bgCyan: enabled ? formatter('\x1b[46m', '\x1b[49m') : String,
+    bgWhite: enabled ? formatter('\x1b[47m', '\x1b[49m') : String,
+  };
+}

package/src/maths/clamp.test.ts

@@ -0,0 +1,19 @@
+import { expect, test } from 'vitest';
+import { clamp } from './clamp';
+
+test('clamp', () => {
+  for (const [a, b] of [
+    [[null, 0, 0], 0],
+    [[null, 1, 10], 1],
+    [[undefined, 1, 10], 1],
+    [[undefined, 1, 10, 5], 5],
+    [[2, 1, 10, 5], 2],
+    [[11, 1, 10, 5], 10],
+    [[11, { min: 1, max: 10 }], 10],
+    [[null, { min: 1, max: 10 }], 1],
+    [[null, { min: 1, max: 10, default: 5 }], 5],
+    [[2n, 1, 10, 5], 2n],
+  ]) {
+    expect(clamp.apply(null, a as any)).toBe(b);
+  }
+});

package/src/maths/clamp.ts

@@ -1 +1,23 @@
-export function clamp() {}
+// export function clamp<T>(value: T | null | undefined, o: { min: T; max: T; default?: T }): T;
+
+export function clamp<T>(value: T | null | undefined, min: T, max: T, def?: T): T;
+export function clamp<T>(value: T | null | undefined, ...o: any[]): T {
+  let min: T, max: T, def: T;
+  if (o.length === 1) {
+    ({ min, max, default: def = min! } = o[0]);
+  } else {
+    [min, max, def = min!] = o;
+  }
+  if (value === null || value === undefined) {
+    return def;
+  }
+  if (value < min) {
+    return min;
+  }
+  if (value > max) {
+    return max;
+  }
+  return value;
+}
+
+// type Comparable = number | string | Date | BigInt;

package/src/objects/get.ts

@@ -32,19 +32,19 @@ export type ResolveObjectPathType<
 > = Path extends keyof ObjectType
   ? ObjectType[Path]
   : Path extends `${infer LeftSide}.${infer RightSide}`
-  ? LeftSide extends keyof ObjectType
-    ? ResolveObjectPathType<ObjectType[LeftSide], RightSide, OrElse>
-    : Path extends `${infer LeftSide}[${number}].${infer RightSide}`
     ? LeftSide extends keyof ObjectType
-      ? ObjectType[LeftSide] extends Array<infer U>
-        ? ResolveObjectPathType<U, RightSide, OrElse>
+      ? ResolveObjectPathType<ObjectType[LeftSide], RightSide, OrElse>
+      : Path extends `${infer LeftSide}[${number}].${infer RightSide}`
+        ? LeftSide extends keyof ObjectType
+          ? ObjectType[LeftSide] extends Array<infer U>
+            ? ResolveObjectPathType<U, RightSide, OrElse>
+            : OrElse
+          : OrElse
         : OrElse
-      : OrElse
-    : OrElse
-  : Path extends `${infer LeftSide}[${number}]`
-  ? LeftSide extends keyof ObjectType
-    ? ObjectType[LeftSide] extends Array<infer U>
-      ? U
-      : OrElse
-    : OrElse
-  : OrElse;
+    : Path extends `${infer LeftSide}[${number}]`
+      ? LeftSide extends keyof ObjectType
+        ? ObjectType[LeftSide] extends Array<infer U>
+          ? U
+          : OrElse
+        : OrElse
+      : OrElse;

package/src/objects/set.ts

@@ -22,11 +22,11 @@ export function set<T extends object, V>(obj: T, key: ObjectKey | ObjectPath, va
           ? merge(current[k], val)
           : val
         : typeof (x = current[k]) === typeof path
-        ? x
-        : // @ts-expect-error hacky type check
-        path[i] * 0 !== 0 || !!~('' + path[i]).indexOf('.') // eslint-disable-line
-        ? {}
-        : [];
+          ? x
+          : // @ts-expect-error hacky type check
+            path[i] * 0 !== 0 || !!~('' + path[i]).indexOf('.') // eslint-disable-line
+            ? {}
+            : [];
   }
 }