@wener/utils 1.1.26 → 1.1.27

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 }), {});
+  }
+}