typia 5.3.5 → 5.3.6-dev.20231229

package/src/functional/$QueryReader.ts

@@ -1,56 +1,56 @@
-export namespace $QueryReader {
-  export const boolean = (str: string | null): boolean | null | undefined =>
-    str === null
-      ? undefined
-      : str === "null"
-      ? null
-      : str.length === 0
-      ? true
-      : str === "true" || str === "1"
-      ? true
-      : str === "false" || str === "0"
-      ? false
-      : (str as any); // wrong type
-
-  export const number = (str: string | null): number | null | undefined =>
-    !!str?.length
-      ? str === "null"
-        ? null
-        : (toNumber(str) as any)
-      : undefined;
-
-  export const bigint = (str: string | null): bigint | null | undefined =>
-    !!str?.length
-      ? str === "null"
-        ? null
-        : (toBigint(str) as any)
-      : undefined;
-
-  export const string = (str: string | null): string | null | undefined =>
-    str === null ? undefined : str === "null" ? null : str;
-
-  export const params = (input: string | URLSearchParams) => {
-    if (typeof input === "string") {
-      const index: number = input.indexOf("?");
-      input = index === -1 ? "" : input.substring(index + 1);
-      return new URLSearchParams(input);
-    }
-    return input;
-  };
-
-  export const array = (input: any[], alternative: null | undefined) =>
-    input.length ? input : alternative;
-}
-
-const toNumber = (str: string): number | string => {
-  const value: number = Number(str);
-  return isNaN(value) ? str : value;
-};
-
-const toBigint = (str: string): bigint | string => {
-  try {
-    return BigInt(str);
-  } catch {
-    return str;
-  }
-};
+export namespace $QueryReader {
+  export const boolean = (str: string | null): boolean | null | undefined =>
+    str === null
+      ? undefined
+      : str === "null"
+      ? null
+      : str.length === 0
+      ? true
+      : str === "true" || str === "1"
+      ? true
+      : str === "false" || str === "0"
+      ? false
+      : (str as any); // wrong type
+
+  export const number = (str: string | null): number | null | undefined =>
+    !!str?.length
+      ? str === "null"
+        ? null
+        : (toNumber(str) as any)
+      : undefined;
+
+  export const bigint = (str: string | null): bigint | null | undefined =>
+    !!str?.length
+      ? str === "null"
+        ? null
+        : (toBigint(str) as any)
+      : undefined;
+
+  export const string = (str: string | null): string | null | undefined =>
+    str === null ? undefined : str === "null" ? null : str;
+
+  export const params = (input: string | URLSearchParams) => {
+    if (typeof input === "string") {
+      const index: number = input.indexOf("?");
+      input = index === -1 ? "" : input.substring(index + 1);
+      return new URLSearchParams(input);
+    }
+    return input;
+  };
+
+  export const array = (input: any[], alternative: null | undefined) =>
+    input.length ? input : alternative;
+}
+
+const toNumber = (str: string): number | string => {
+  const value: number = Number(str);
+  return isNaN(value) ? str : value;
+};
+
+const toBigint = (str: string): bigint | string => {
+  try {
+    return BigInt(str);
+  } catch {
+    return str;
+  }
+};

package/src/functional/$any.ts

@@ -1,4 +1,4 @@
-import { $clone } from "./$clone";
-
-export const $any = (val: any): any =>
-  val !== undefined ? $clone(val) : undefined;
+import { $clone } from "./$clone";
+
+export const $any = (val: any): any =>
+  val !== undefined ? $clone(val) : undefined;

package/src/functional/$clone.ts

@@ -1,4 +1,4 @@
-import { Primitive } from "../Primitive";
-
-export const $clone = <T>(value: T): Primitive<T> =>
-  JSON.parse(JSON.stringify(value));
+import { Primitive } from "../Primitive";
+
+export const $clone = <T>(value: T): Primitive<T> =>
+  JSON.parse(JSON.stringify(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/$from.ts

@@ -1,5 +1,5 @@
-import { IMetadataApplication } from "../schemas/metadata/IMetadataApplication";
-import { MetadataApplication } from "../schemas/metadata/MetadataApplication";
-
-export const $from = (json: IMetadataApplication): MetadataApplication =>
-  MetadataApplication.from(json);
+import { IMetadataApplication } from "../schemas/metadata/IMetadataApplication";
+import { MetadataApplication } from "../schemas/metadata/MetadataApplication";
+
+export const $from = (json: IMetadataApplication): MetadataApplication =>
+  MetadataApplication.from(json);

package/src/functional/$guard.ts

@@ -1,35 +1,35 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-/* -----------------------------------------------------------
-    ASSERT V2 -> USE (NULL OR ERROR) CONDITION
------------------------------------------------------------ */
-// /**
-//  * @internal
-//  */
-// export const $guardV2 =
-//     (method: string) => (props: Omit<TypeGuardError.IProps, "method">) =>
-//         new TypeGuardError({
-//             method,
-//             path: props.path,
-//             expected: props.expected,
-//             value: props.value,
-//         });
-
-/* -----------------------------------------------------------
-    ASSERT V3 -> (CONDITION OR THROW(exceptable): FALSE)
------------------------------------------------------------ */
-/**
- * @internal
- */
-export const $guard =
-  (method: string) =>
-  (exceptionable: boolean, props: Omit<TypeGuardError.IProps, "method">) => {
-    if (exceptionable === true)
-      throw new TypeGuardError({
-        method,
-        path: props.path,
-        expected: props.expected,
-        value: props.value,
-      });
-    return false;
-  };
+import { TypeGuardError } from "../TypeGuardError";
+
+/* -----------------------------------------------------------
+    ASSERT V2 -> USE (NULL OR ERROR) CONDITION
+----------------------------------------------------------- */
+// /**
+//  * @internal
+//  */
+// export const $guardV2 =
+//     (method: string) => (props: Omit<TypeGuardError.IProps, "method">) =>
+//         new TypeGuardError({
+//             method,
+//             path: props.path,
+//             expected: props.expected,
+//             value: props.value,
+//         });
+
+/* -----------------------------------------------------------
+    ASSERT V3 -> (CONDITION OR THROW(exceptable): FALSE)
+----------------------------------------------------------- */
+/**
+ * @internal
+ */
+export const $guard =
+  (method: string) =>
+  (exceptionable: boolean, props: Omit<TypeGuardError.IProps, "method">) => {
+    if (exceptionable === true)
+      throw new TypeGuardError({
+        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,50 +1,50 @@
-/**
- * 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 => {
-  if (STR_ESCAPE.test(str) === false) return `"${str}"`;
-
-  const length: number = str.length;
-  if (length > 41) return JSON.stringify(str);
-
-  let result = "";
-  let last = -1;
-  let point = 255;
-
-  // eslint-disable-next-line
-  for (let i = 0; i < length; ++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) + '"'
-  );
-};
-
-const STR_ESCAPE =
-  /[\u0000-\u001f\u0022\u005c\ud800-\udfff]|[\ud800-\udbff](?![\udc00-\udfff])|(?:[^\ud800-\udbff]|^)[\udc00-\udfff]/;
+/**
+ * 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 => {
+  if (STR_ESCAPE.test(str) === false) return `"${str}"`;
+
+  const length: number = str.length;
+  if (length > 41) return JSON.stringify(str);
+
+  let result = "";
+  let last = -1;
+  let point = 255;
+
+  // eslint-disable-next-line
+  for (let i = 0; i < length; ++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) + '"'
+  );
+};
+
+const STR_ESCAPE =
+  /[\u0000-\u001f\u0022\u005c\ud800-\udfff]|[\ud800-\udbff](?![\udc00-\udfff])|(?:[^\ud800-\udbff]|^)[\udc00-\udfff]/;

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;
+};