typia 6.10.2 → 6.10.3-dev.20240925

package/src/functional/$clone.ts

@@ -1,48 +1,48 @@
-import { Resolved } from "../Resolved";
-
-export const $clone = <T>(value: T): Resolved<T> =>
-  $cloneMain(value) as Resolved<T>;
-
-const $cloneMain = (value: any): any => {
-  if (value === undefined) return undefined;
-  else if (typeof value === "object")
-    if (value === null) return null;
-    else if (Array.isArray(value)) return value.map($cloneMain);
-    else if (value instanceof Date) return new Date(value);
-    else if (value instanceof Uint8Array) return new Uint8Array(value);
-    else if (value instanceof Uint8ClampedArray)
-      return new Uint8ClampedArray(value);
-    else if (value instanceof Uint16Array) return new Uint16Array(value);
-    else if (value instanceof Uint32Array) return new Uint32Array(value);
-    else if (value instanceof BigUint64Array) return new BigUint64Array(value);
-    else if (value instanceof Int8Array) return new Int8Array(value);
-    else if (value instanceof Int16Array) return new Int16Array(value);
-    else if (value instanceof Int32Array) return new Int32Array(value);
-    else if (value instanceof BigInt64Array) return new BigInt64Array(value);
-    else if (value instanceof Float32Array) return new Float32Array(value);
-    else if (value instanceof Float64Array) return new Float64Array(value);
-    else if (value instanceof ArrayBuffer) return value.slice(0);
-    else if (value instanceof SharedArrayBuffer) return value.slice(0);
-    else if (value instanceof DataView)
-      return new DataView(value.buffer.slice(0));
-    else if (typeof File !== "undefined" && value instanceof File)
-      return new File([value], value.name, { type: value.type });
-    else if (typeof Blob !== "undefined" && value instanceof Blob)
-      return new Blob([value], { type: value.type });
-    else if (value instanceof Set) return new Set([...value].map($cloneMain));
-    else if (value instanceof Map)
-      return new Map(
-        [...value].map(([k, v]) => [$cloneMain(k), $cloneMain(v)]),
-      );
-    else if (value instanceof WeakSet || value instanceof WeakMap)
-      throw new Error("WeakSet and WeakMap are not supported");
-    else if (value.valueOf() !== value) return $cloneMain(value.valueOf());
-    else
-      return Object.fromEntries(
-        Object.entries(value)
-          .map(([k, v]) => [k, $cloneMain(v)])
-          .filter(([, v]) => v !== undefined),
-      );
-  else if (typeof value === "function") return undefined;
-  return value;
-};
+import { Resolved } from "../Resolved";
+
+export const $clone = <T>(value: T): Resolved<T> =>
+  $cloneMain(value) as Resolved<T>;
+
+const $cloneMain = (value: any): any => {
+  if (value === undefined) return undefined;
+  else if (typeof value === "object")
+    if (value === null) return null;
+    else if (Array.isArray(value)) return value.map($cloneMain);
+    else if (value instanceof Date) return new Date(value);
+    else if (value instanceof Uint8Array) return new Uint8Array(value);
+    else if (value instanceof Uint8ClampedArray)
+      return new Uint8ClampedArray(value);
+    else if (value instanceof Uint16Array) return new Uint16Array(value);
+    else if (value instanceof Uint32Array) return new Uint32Array(value);
+    else if (value instanceof BigUint64Array) return new BigUint64Array(value);
+    else if (value instanceof Int8Array) return new Int8Array(value);
+    else if (value instanceof Int16Array) return new Int16Array(value);
+    else if (value instanceof Int32Array) return new Int32Array(value);
+    else if (value instanceof BigInt64Array) return new BigInt64Array(value);
+    else if (value instanceof Float32Array) return new Float32Array(value);
+    else if (value instanceof Float64Array) return new Float64Array(value);
+    else if (value instanceof ArrayBuffer) return value.slice(0);
+    else if (value instanceof SharedArrayBuffer) return value.slice(0);
+    else if (value instanceof DataView)
+      return new DataView(value.buffer.slice(0));
+    else if (typeof File !== "undefined" && value instanceof File)
+      return new File([value], value.name, { type: value.type });
+    else if (typeof Blob !== "undefined" && value instanceof Blob)
+      return new Blob([value], { type: value.type });
+    else if (value instanceof Set) return new Set([...value].map($cloneMain));
+    else if (value instanceof Map)
+      return new Map(
+        [...value].map(([k, v]) => [$cloneMain(k), $cloneMain(v)]),
+      );
+    else if (value instanceof WeakSet || value instanceof WeakMap)
+      throw new Error("WeakSet and WeakMap are not supported");
+    else if (value.valueOf() !== value) return $cloneMain(value.valueOf());
+    else
+      return Object.fromEntries(
+        Object.entries(value)
+          .map(([k, v]) => [k, $cloneMain(v)])
+          .filter(([, v]) => v !== undefined),
+      );
+  else if (typeof value === "function") return undefined;
+  return value;
+};

package/src/functional/$convention.ts

@@ -1,37 +1,37 @@
-export const $convention = (rename: (str: string) => string) => {
-  const main = (input: any): any => {
-    if (typeof input === "object")
-      if (input === null) return null;
-      else if (Array.isArray(input)) return input.map(main);
-      else if (
-        input instanceof Boolean ||
-        input instanceof BigInt ||
-        input instanceof Number ||
-        input instanceof String
-      )
-        return input.valueOf();
-      else if (input instanceof Date) return new Date(input);
-      else if (
-        input instanceof Uint8Array ||
-        input instanceof Uint8ClampedArray ||
-        input instanceof Uint16Array ||
-        input instanceof Uint32Array ||
-        input instanceof BigUint64Array ||
-        input instanceof Int8Array ||
-        input instanceof Int16Array ||
-        input instanceof Int32Array ||
-        input instanceof BigInt64Array ||
-        input instanceof Float32Array ||
-        input instanceof Float64Array ||
-        input instanceof DataView
-      )
-        return input;
-      else return object(input);
-    return input;
-  };
-  const object = (input: Record<string, any>) =>
-    Object.fromEntries(
-      Object.entries(input).map(([key, value]) => [rename(key), main(value)]),
-    );
-  return main;
-};
+export const $convention = (rename: (str: string) => string) => {
+  const main = (input: any): any => {
+    if (typeof input === "object")
+      if (input === null) return null;
+      else if (Array.isArray(input)) return input.map(main);
+      else if (
+        input instanceof Boolean ||
+        input instanceof BigInt ||
+        input instanceof Number ||
+        input instanceof String
+      )
+        return input.valueOf();
+      else if (input instanceof Date) return new Date(input);
+      else if (
+        input instanceof Uint8Array ||
+        input instanceof Uint8ClampedArray ||
+        input instanceof Uint16Array ||
+        input instanceof Uint32Array ||
+        input instanceof BigUint64Array ||
+        input instanceof Int8Array ||
+        input instanceof Int16Array ||
+        input instanceof Int32Array ||
+        input instanceof BigInt64Array ||
+        input instanceof Float32Array ||
+        input instanceof Float64Array ||
+        input instanceof DataView
+      )
+        return input;
+      else return object(input);
+    return input;
+  };
+  const object = (input: Record<string, any>) =>
+    Object.fromEntries(
+      Object.entries(input).map(([key, value]) => [rename(key), main(value)]),
+    );
+  return main;
+};

package/src/functional/$dictionary.ts

@@ -1,22 +1,22 @@
-import { Customizable } from "../typings/Customizable";
-
-/**
- * @internal
- */
-const blackhole: any = {};
-
-export const $dictionary = (() => {
-  const glob: {
-    __typia_custom_validator: Map<
-      `${string}`,
-      Map<keyof Customizable, (tagText: string) => (value: any) => boolean>
-    >;
-  } =
-    typeof global === "object" &&
-    typeof global.process === "object" &&
-    typeof global.process.versions === "object" &&
-    typeof global.process.versions.node !== "undefined"
-      ? ((global ?? blackhole) as any)
-      : ((self ?? blackhole) as any);
-  return (glob.__typia_custom_validator ??= new Map());
-})();
+import { Customizable } from "../typings/Customizable";
+
+/**
+ * @internal
+ */
+const blackhole: any = {};
+
+export const $dictionary = (() => {
+  const glob: {
+    __typia_custom_validator: Map<
+      `${string}`,
+      Map<keyof Customizable, (tagText: string) => (value: any) => boolean>
+    >;
+  } =
+    typeof global === "object" &&
+    typeof global.process === "object" &&
+    typeof global.process.versions === "object" &&
+    typeof global.process.versions.node !== "undefined"
+      ? ((global ?? blackhole) as any)
+      : ((self ?? blackhole) as any);
+  return (glob.__typia_custom_validator ??= new Map());
+})();

package/src/functional/$every.ts

@@ -1,11 +1,11 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-export const $every = <T>(
-  array: T[],
-  pred: (value: T, i: number) => null | Omit<TypeGuardError.IProps, "method">,
-): null | Omit<TypeGuardError.IProps, "method"> => {
-  let error: null | Omit<TypeGuardError.IProps, "method"> = null;
-  for (let i: number = 0; i < array.length; ++i)
-    if (null !== (error = pred(array[i]!, i))) return error;
-  return null;
-};
+import { TypeGuardError } from "../TypeGuardError";
+
+export const $every = <T>(
+  array: T[],
+  pred: (value: T, i: number) => null | Omit<TypeGuardError.IProps, "method">,
+): null | Omit<TypeGuardError.IProps, "method"> => {
+  let error: null | Omit<TypeGuardError.IProps, "method"> = null;
+  for (let i: number = 0; i < array.length; ++i)
+    if (null !== (error = pred(array[i]!, i))) return error;
+  return null;
+};

package/src/functional/$guard.ts

@@ -1,21 +1,21 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-/**
- * @internal
- */
-export const $guard =
-  (method: string) =>
-  (
-    exceptionable: boolean,
-    props: Omit<TypeGuardError.IProps, "method">,
-    factory?: (props: TypeGuardError.IProps) => Error,
-  ): boolean => {
-    if (exceptionable === true)
-      throw (factory ?? ((props) => new TypeGuardError(props)))({
-        method,
-        path: props.path,
-        expected: props.expected,
-        value: props.value,
-      });
-    return false;
-  };
+import { TypeGuardError } from "../TypeGuardError";
+
+/**
+ * @internal
+ */
+export const $guard =
+  (method: string) =>
+  (
+    exceptionable: boolean,
+    props: Omit<TypeGuardError.IProps, "method">,
+    factory?: (props: TypeGuardError.IProps) => Error,
+  ): boolean => {
+    if (exceptionable === true)
+      throw (factory ?? ((props) => new TypeGuardError(props)))({
+        method,
+        path: props.path,
+        expected: props.expected,
+        value: props.value,
+      });
+    return false;
+  };

package/src/functional/$is_between.ts

@@ -1,2 +1,2 @@
-export const $is_between = (value: number, minimum: number, maximum: number) =>
-  minimum <= value && value <= maximum;
+export const $is_between = (value: number, minimum: number, maximum: number) =>
+  minimum <= value && value <= maximum;

package/src/functional/$join.ts

@@ -1,46 +1,46 @@
-export const $join = (str: string): string =>
-  variable(str) ? `.${str}` : `[${JSON.stringify(str)}]`;
-
-const variable = (str: string): boolean =>
-  reserved(str) === false && /^[a-zA-Z_$][a-zA-Z_$0-9]*$/g.test(str);
-
-const reserved = (str: string): boolean => RESERVED.has(str);
-
-const RESERVED: Set<string> = new Set([
-  "break",
-  "case",
-  "catch",
-  "class",
-  "const",
-  "continue",
-  "debugger",
-  "default",
-  "delete",
-  "do",
-  "else",
-  "enum",
-  "export",
-  "extends",
-  "false",
-  "finally",
-  "for",
-  "function",
-  "if",
-  "import",
-  "in",
-  "instanceof",
-  "new",
-  "null",
-  "return",
-  "super",
-  "switch",
-  "this",
-  "throw",
-  "true",
-  "try",
-  "typeof",
-  "var",
-  "void",
-  "while",
-  "with",
-]);
+export const $join = (str: string): string =>
+  variable(str) ? `.${str}` : `[${JSON.stringify(str)}]`;
+
+const variable = (str: string): boolean =>
+  reserved(str) === false && /^[a-zA-Z_$][a-zA-Z_$0-9]*$/g.test(str);
+
+const reserved = (str: string): boolean => RESERVED.has(str);
+
+const RESERVED: Set<string> = new Set([
+  "break",
+  "case",
+  "catch",
+  "class",
+  "const",
+  "continue",
+  "debugger",
+  "default",
+  "delete",
+  "do",
+  "else",
+  "enum",
+  "export",
+  "extends",
+  "false",
+  "finally",
+  "for",
+  "function",
+  "if",
+  "import",
+  "in",
+  "instanceof",
+  "new",
+  "null",
+  "return",
+  "super",
+  "switch",
+  "this",
+  "throw",
+  "true",
+  "try",
+  "typeof",
+  "var",
+  "void",
+  "while",
+  "with",
+]);

package/src/functional/$number.ts

@@ -1,12 +1,12 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-export const $number = (value: number): number => {
-  if (isFinite(value) === false)
-    throw new TypeGuardError({
-      method: "typia.json.stringify",
-      expected: "number",
-      value,
-      message: "Error on typia.json.stringify(): infinite or not a number.",
-    });
-  return value;
-};
+import { TypeGuardError } from "../TypeGuardError";
+
+export const $number = (value: number): number => {
+  if (isFinite(value) === false)
+    throw new TypeGuardError({
+      method: "typia.json.stringify",
+      expected: "number",
+      value,
+      message: "Error on typia.json.stringify(): infinite or not a number.",
+    });
+  return value;
+};

package/src/functional/$report.ts

@@ -1,13 +1,13 @@
-import { IValidation } from "../IValidation";
-
-export const $report = (array: IValidation.IError[]) => {
-  const reportable = (path: string): boolean => {
-    if (array.length === 0) return true;
-    const last: string = array[array.length - 1]!.path;
-    return path.length > last.length || last.substring(0, path.length) !== path;
-  };
-  return (exceptable: boolean, error: IValidation.IError): false => {
-    if (exceptable && reportable(error.path)) array.push(error);
-    return false;
-  };
-};
+import { IValidation } from "../IValidation";
+
+export const $report = (array: IValidation.IError[]) => {
+  const reportable = (path: string): boolean => {
+    if (array.length === 0) return true;
+    const last: string = array[array.length - 1]!.path;
+    return path.length > last.length || last.substring(0, path.length) !== path;
+  };
+  return (exceptable: boolean, error: IValidation.IError): false => {
+    if (exceptable && reportable(error.path)) array.push(error);
+    return false;
+  };
+};

package/src/functional/$rest.ts

@@ -1,3 +1,3 @@
-export const $rest = (str: string): string => {
-  return str.length === 2 ? "" : "," + str.substring(1, str.length - 1);
-};
+export const $rest = (str: string): string => {
+  return str.length === 2 ? "" : "," + str.substring(1, str.length - 1);
+};

package/src/functional/$stoll.ts

@@ -1,8 +1,8 @@
-export const $is_bigint_string = (str: string): boolean => {
-  try {
-    BigInt(str);
-    return true;
-  } catch {
-    return false;
-  }
-};
+export const $is_bigint_string = (str: string): boolean => {
+  try {
+    BigInt(str);
+    return true;
+  } catch {
+    return false;
+  }
+};

package/src/functional/$string.ts

@@ -1,43 +1,43 @@
-/**
- * In the past, name of `typia` was `typescript-json`, and supported
- * JSON serialization by wrapping `fast-json-stringify. `typescript-json` was
- * a helper library of `fast-json-stringify`, which can skip manual JSON schema
- * definition just by putting pure TypeScript type.
- *
- * This `$string` function is a part of `fast-json-stringify` at that time, and
- * still being used in `typia` for the string serialization.
- *
- * @internal
- * @reference https://github.com/fastify/fast-json-stringify/blob/master/lib/serializer.js
- * @blog https://dev.to/samchon/good-bye-typescript-is-ancestor-of-typia-20000x-faster-validator-49fi
- */
-export const $string = (str: string): string => {
-  const len = str.length;
-  let result = "";
-  let last = -1;
-  let point = 255;
-
-  // eslint-disable-next-line
-  for (var i = 0; i < len; i++) {
-    point = str.charCodeAt(i);
-    if (point < 32) {
-      return JSON.stringify(str);
-    }
-    if (point >= 0xd800 && point <= 0xdfff) {
-      // The current character is a surrogate.
-      return JSON.stringify(str);
-    }
-    if (
-      point === 0x22 || // '"'
-      point === 0x5c // '\'
-    ) {
-      last === -1 && (last = 0);
-      result += str.slice(last, i) + "\\";
-      last = i;
-    }
-  }
-
-  return (
-    (last === -1 && '"' + str + '"') || '"' + result + str.slice(last) + '"'
-  );
-};
+/**
+ * In the past, name of `typia` was `typescript-json`, and supported
+ * JSON serialization by wrapping `fast-json-stringify. `typescript-json` was
+ * a helper library of `fast-json-stringify`, which can skip manual JSON schema
+ * definition just by putting pure TypeScript type.
+ *
+ * This `$string` function is a part of `fast-json-stringify` at that time, and
+ * still being used in `typia` for the string serialization.
+ *
+ * @internal
+ * @reference https://github.com/fastify/fast-json-stringify/blob/master/lib/serializer.js
+ * @blog https://dev.to/samchon/good-bye-typescript-is-ancestor-of-typia-20000x-faster-validator-49fi
+ */
+export const $string = (str: string): string => {
+  const len = str.length;
+  let result = "";
+  let last = -1;
+  let point = 255;
+
+  // eslint-disable-next-line
+  for (var i = 0; i < len; i++) {
+    point = str.charCodeAt(i);
+    if (point < 32) {
+      return JSON.stringify(str);
+    }
+    if (point >= 0xd800 && point <= 0xdfff) {
+      // The current character is a surrogate.
+      return JSON.stringify(str);
+    }
+    if (
+      point === 0x22 || // '"'
+      point === 0x5c // '\'
+    ) {
+      last === -1 && (last = 0);
+      result += str.slice(last, i) + "\\";
+      last = i;
+    }
+  }
+
+  return (
+    (last === -1 && '"' + str + '"') || '"' + result + str.slice(last) + '"'
+  );
+};

package/src/functional/$strlen.ts

@@ -1,7 +1,7 @@
-export const $strlen = (s: string): number => {
-  let b: number;
-  let i: number;
-  let c: number;
-  for (b = i = 0; (c = s.charCodeAt(i++)); b += c >> 11 ? 3 : c >> 7 ? 2 : 1);
-  return b;
-};
+export const $strlen = (s: string): number => {
+  let b: number;
+  let i: number;
+  let c: number;
+  for (b = i = 0; (c = s.charCodeAt(i++)); b += c >> 11 ? 3 : c >> 7 ? 2 : 1);
+  return b;
+};

package/src/functional/$tail.ts

@@ -1,5 +1,5 @@
-/**
- * @internal
- */
-export const $tail = (str: string): string =>
-  str[str.length - 1] === "," ? str.substring(0, str.length - 1) : str;
+/**
+ * @internal
+ */
+export const $tail = (str: string): string =>
+  str[str.length - 1] === "," ? str.substring(0, str.length - 1) : str;

package/src/functional/$throws.ts

@@ -1,10 +1,10 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-export const $throws =
-  (method: string) =>
-  (props: Pick<TypeGuardError.IProps, "expected" | "value">) => {
-    throw new TypeGuardError({
-      ...props,
-      method: `typia.${method}`,
-    });
-  };
+import { TypeGuardError } from "../TypeGuardError";
+
+export const $throws =
+  (method: string) =>
+  (props: Pick<TypeGuardError.IProps, "expected" | "value">) => {
+    throw new TypeGuardError({
+      ...props,
+      method: `typia.${method}`,
+    });
+  };