@wener/utils 1.1.25 → 1.1.27

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
+            ? {}
+            : [];
   }
 }
 

package/src/schema/typebox/gen/codegen/common/encoder.ts

@@ -0,0 +1,99 @@
+/*--------------------------------------------------------------------------
+
+@sinclair/typebox-codegen
+
+The MIT License (MIT)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+---------------------------------------------------------------------------*/
+
+// --------------------------------------------------------------------------
+// Character
+// --------------------------------------------------------------------------
+namespace Character {
+  export function DollarSign(code: number) {
+    return code === 36;
+  }
+  export function IsUnderscore(code: number) {
+    return code === 95;
+  }
+  export function IsAlpha(code: number) {
+    return (code >= 64 && code <= 90) || (code >= 97 && code <= 122);
+  }
+  export function IsNumeric(code: number) {
+    return code >= 48 && code <= 57;
+  }
+}
+// --------------------------------------------------------------------------
+// MemberExpressionEncoder
+// --------------------------------------------------------------------------
+export namespace MemberExpressionEncoder {
+  function IsFirstCharacterNumeric(value: string) {
+    if (value.length === 0) return false;
+    return Character.IsNumeric(value.charCodeAt(0));
+  }
+  function IsAccessor(value: string) {
+    if (IsFirstCharacterNumeric(value)) return false;
+    for (let i = 0; i < value.length; i++) {
+      const code = value.charCodeAt(i);
+      const check =
+        Character.IsAlpha(code) ||
+        Character.IsNumeric(code) ||
+        Character.DollarSign(code) ||
+        Character.IsUnderscore(code);
+      if (!check) return false;
+    }
+    return true;
+  }
+  function EscapeHyphen(key: string) {
+    return key.replace(/'/g, "\\'");
+  }
+  export function Encode(object: string, key: string) {
+    return IsAccessor(key) ? `${object}.${key}` : `${object}['${EscapeHyphen(key)}']`;
+  }
+}
+// --------------------------------------------------------------------------
+// PropertyEncoder
+// --------------------------------------------------------------------------
+export namespace PropertyEncoder {
+  function IsFirstCharacterNumeric(value: string) {
+    if (value.length === 0) return false;
+    return Character.IsNumeric(value.charCodeAt(0));
+  }
+  function IsSafeProperty(value: string) {
+    if (IsFirstCharacterNumeric(value)) return false;
+    for (let i = 0; i < value.length; i++) {
+      const code = value.charCodeAt(i);
+      const check =
+        Character.IsAlpha(code) ||
+        Character.IsNumeric(code) ||
+        Character.DollarSign(code) ||
+        Character.IsUnderscore(code);
+      if (!check) return false;
+    }
+    return true;
+  }
+  function Quoted(value: string) {
+    return `'${value}'`;
+  }
+  export function Encode(value: string) {
+    return IsSafeProperty(value) ? value : Quoted(value);
+  }
+}

package/src/schema/typebox/gen/codegen/common/formatter.ts

@@ -0,0 +1,31 @@
+/*--------------------------------------------------------------------------
+
+@sinclair/typebox-codegen
+
+The MIT License (MIT)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+---------------------------------------------------------------------------*/
+
+export namespace Formatter {
+  export function Format(code: string): string {
+    return code;
+  }
+}

package/src/schema/typebox/gen/codegen/common/index.ts

@@ -0,0 +1,29 @@
+/*--------------------------------------------------------------------------
+
+@sinclair/typebox-codegen
+
+The MIT License (MIT)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+---------------------------------------------------------------------------*/
+
+export * from './encoder';
+export * from './formatter';
+export * from './jsdoc';

package/src/schema/typebox/gen/codegen/common/jsdoc.ts

@@ -0,0 +1,93 @@
+/*--------------------------------------------------------------------------
+
+@sinclair/typebox-codegen
+
+The MIT License (MIT)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+---------------------------------------------------------------------------*/
+
+/** JSDoc Property Parser */
+export namespace JsDoc {
+  // ----------------------------------------------------------------
+  // Quotes
+  // ----------------------------------------------------------------
+  function ConsumeQuote(content: string): [consumed: string, rest: string] {
+    if (!IsQuote(content)) return ['', content];
+    const quote = content[0];
+    for (let i = 1; i < content.length; i++) {
+      if (content[i] === quote) return [content.slice(1, i), content.slice(i)];
+      if (content[i] === '\n') return [content.slice(1, i), content.slice(i)];
+    }
+    return [content.slice(1), ''];
+  }
+  function IsQuote(content: string) {
+    return content[0] === '"' || content[0] === "'";
+  }
+  // ----------------------------------------------------------------
+  // Decode
+  // ----------------------------------------------------------------
+  function DecodeWithNonQuotedProperties(content: string): any {
+    const parseFunction = new Function(`return (${content});`);
+    return parseFunction();
+  }
+  function Decode(content: string) {
+    try {
+      return DecodeWithNonQuotedProperties(content);
+    } catch {
+      return content;
+    }
+  }
+  function* ParseValue(key: string, content: string): IterableIterator<[string, any]> {
+    if (IsQuote(content)) {
+      const [consumed, rest] = ConsumeQuote(content);
+      yield [key, Decode(consumed)];
+      return yield* ParseContent(rest);
+    }
+    for (let i = 0; i < content.length; i++) {
+      if (content[i] === '\n' || content[i] === '-') {
+        const value = content.slice(0, i).trim();
+        const rest = content.slice(i);
+        yield [key, Decode(value)];
+        return yield* ParseContent(rest);
+      }
+    }
+  }
+  function* ParseKey(content: string): IterableIterator<[string, any]> {
+    for (let i = 1; i < content.length; i++) {
+      if (content[i] === ' ') {
+        const key = content.slice(1, i);
+        const rest = content.slice(i).trimStart();
+        return yield* ParseValue(key, rest);
+      }
+    }
+  }
+  function* ParseContent(content: string): IterableIterator<[string, any]> {
+    for (let i = 0; i < content.length; i++) {
+      if (content[i] === '@') {
+        return yield* ParseKey(content.slice(i));
+      }
+    }
+  }
+  export function Parse(content: string): Record<string, any> {
+    const properties = [...ParseContent(content)];
+    return properties.reduce((acc, [key, value]) => ({ ...acc, [key]: value }), {});
+  }
+}