typia 7.0.0-dev.20241005 → 7.0.0-dev.20241007

package/src/factories/internal/metadata/iterate_metadata_set.ts

@@ -1,39 +1,39 @@
-import ts from "typescript";
-
-import { ArrayUtil } from "../../../utils/ArrayUtil";
-
-import { TypeFactory } from "../../TypeFactory";
-import { IMetadataIteratorProps } from "./IMetadataIteratorProps";
-import { explore_metadata } from "./explore_metadata";
-
-export const iterate_metadata_set = (
-  props: IMetadataIteratorProps,
-): boolean => {
-  const type: ts.Type = props.checker.getApparentType(props.type);
-
-  const name = TypeFactory.getFullName({
-    checker: props.checker,
-    type: type,
-    symbol: type.getSymbol(),
-  });
-  const generic = type.aliasSymbol
-    ? type.aliasTypeArguments
-    : props.checker.getTypeArguments(type as ts.TypeReference);
-  if (name.substring(0, 4) !== "Set<" || generic?.length !== 1) return false;
-
-  const key: ts.Type = generic[0]!;
-  ArrayUtil.set(
-    props.metadata.sets,
-    explore_metadata({
-      ...props,
-      type: key,
-      explore: {
-        ...props.explore,
-        escaped: false,
-        aliased: false,
-      },
-    }),
-    (elem) => elem.getName(),
-  );
-  return true;
-};
+import ts from "typescript";
+
+import { ArrayUtil } from "../../../utils/ArrayUtil";
+
+import { TypeFactory } from "../../TypeFactory";
+import { IMetadataIteratorProps } from "./IMetadataIteratorProps";
+import { explore_metadata } from "./explore_metadata";
+
+export const iterate_metadata_set = (
+  props: IMetadataIteratorProps,
+): boolean => {
+  const type: ts.Type = props.checker.getApparentType(props.type);
+
+  const name = TypeFactory.getFullName({
+    checker: props.checker,
+    type: type,
+    symbol: type.getSymbol(),
+  });
+  const generic = type.aliasSymbol
+    ? type.aliasTypeArguments
+    : props.checker.getTypeArguments(type as ts.TypeReference);
+  if (name.substring(0, 4) !== "Set<" || generic?.length !== 1) return false;
+
+  const key: ts.Type = generic[0]!;
+  ArrayUtil.set(
+    props.metadata.sets,
+    explore_metadata({
+      ...props,
+      type: key,
+      explore: {
+        ...props.explore,
+        escaped: false,
+        aliased: false,
+      },
+    }),
+    (elem) => elem.getName(),
+  );
+  return true;
+};

package/src/factories/internal/metadata/iterate_metadata_sort.ts

@@ -1,83 +1,83 @@
-import { Metadata } from "../../../schemas/metadata/Metadata";
-import { MetadataObject } from "../../../schemas/metadata/MetadataObject";
-
-import { MetadataCollection } from "../../MetadataCollection";
-
-export const iterate_metadata_sort = (props: {
-  collection: MetadataCollection;
-  metadata: Metadata;
-}) => {
-  const visited: Set<Metadata> = new Set();
-  const next = (metadata: Metadata) =>
-    iterate({
-      visited,
-      collection: props.collection,
-      metadata,
-    });
-  for (const array of props.collection.arrays()) next(array.value);
-  for (const tuple of props.collection.tuples())
-    for (const element of tuple.elements) next(element);
-  for (const object of props.collection.objects())
-    for (const property of object.properties) next(property.value);
-  next(props.metadata);
-};
-
-const iterate = (props: {
-  visited: Set<Metadata>;
-  collection: MetadataCollection;
-  metadata: Metadata;
-}) => {
-  if (props.visited.has(props.metadata)) return;
-  props.visited.add(props.metadata);
-
-  const next = (metadata: Metadata) =>
-    iterate({
-      ...props,
-      metadata,
-    });
-
-  // ITERATE CHILDREN
-  for (const map of props.metadata.maps) next(map.value);
-  for (const set of props.metadata.sets) next(set);
-  if (props.metadata.escaped !== null) next(props.metadata.escaped.returns);
-  if (props.metadata.rest !== null) next(props.metadata.rest);
-
-  // SORT OBJECTS
-  if (props.metadata.objects.length > 1) {
-    props.metadata.objects.sort((x, y) =>
-      MetadataObject.covers(x, y) ? -1 : MetadataObject.covers(y, x) ? 1 : 0,
-    );
-    props.metadata.union_index = props.collection.getUnionIndex(props.metadata);
-  }
-
-  // SORT ARRAYS AND TUPLES
-  if (props.metadata.arrays.length > 1)
-    props.metadata.arrays.sort((x, y) =>
-      Metadata.covers(x.type.value, y.type.value)
-        ? -1
-        : Metadata.covers(y.type.value, x.type.value)
-          ? 1
-          : 0,
-    );
-  if (props.metadata.tuples.length > 1)
-    props.metadata.tuples.sort((x, y) => {
-      const xt = Metadata.initialize();
-      const yt = Metadata.initialize();
-
-      xt.tuples.push(x);
-      yt.tuples.push(y);
-
-      return Metadata.covers(xt, yt) ? -1 : Metadata.covers(yt, xt) ? 1 : 0;
-    });
-
-  // SORT CONSTANT VALUES
-  for (const constant of props.metadata.constants)
-    if (constant.type === "string") constant.values.sort();
-    else if (constant.type === "number")
-      constant.values.sort((a, b) => (a.value as number) - (b.value as number));
-    else if (constant.type === "bigint")
-      constant.values.sort((a, b) =>
-        (a.value as bigint) < (b.value as bigint) ? -1 : 1,
-      );
-    else constant.values.sort((a, _b) => (a.value === false ? -1 : 1));
-};
+import { Metadata } from "../../../schemas/metadata/Metadata";
+import { MetadataObject } from "../../../schemas/metadata/MetadataObject";
+
+import { MetadataCollection } from "../../MetadataCollection";
+
+export const iterate_metadata_sort = (props: {
+  collection: MetadataCollection;
+  metadata: Metadata;
+}) => {
+  const visited: Set<Metadata> = new Set();
+  const next = (metadata: Metadata) =>
+    iterate({
+      visited,
+      collection: props.collection,
+      metadata,
+    });
+  for (const array of props.collection.arrays()) next(array.value);
+  for (const tuple of props.collection.tuples())
+    for (const element of tuple.elements) next(element);
+  for (const object of props.collection.objects())
+    for (const property of object.properties) next(property.value);
+  next(props.metadata);
+};
+
+const iterate = (props: {
+  visited: Set<Metadata>;
+  collection: MetadataCollection;
+  metadata: Metadata;
+}) => {
+  if (props.visited.has(props.metadata)) return;
+  props.visited.add(props.metadata);
+
+  const next = (metadata: Metadata) =>
+    iterate({
+      ...props,
+      metadata,
+    });
+
+  // ITERATE CHILDREN
+  for (const map of props.metadata.maps) next(map.value);
+  for (const set of props.metadata.sets) next(set);
+  if (props.metadata.escaped !== null) next(props.metadata.escaped.returns);
+  if (props.metadata.rest !== null) next(props.metadata.rest);
+
+  // SORT OBJECTS
+  if (props.metadata.objects.length > 1) {
+    props.metadata.objects.sort((x, y) =>
+      MetadataObject.covers(x, y) ? -1 : MetadataObject.covers(y, x) ? 1 : 0,
+    );
+    props.metadata.union_index = props.collection.getUnionIndex(props.metadata);
+  }
+
+  // SORT ARRAYS AND TUPLES
+  if (props.metadata.arrays.length > 1)
+    props.metadata.arrays.sort((x, y) =>
+      Metadata.covers(x.type.value, y.type.value)
+        ? -1
+        : Metadata.covers(y.type.value, x.type.value)
+          ? 1
+          : 0,
+    );
+  if (props.metadata.tuples.length > 1)
+    props.metadata.tuples.sort((x, y) => {
+      const xt = Metadata.initialize();
+      const yt = Metadata.initialize();
+
+      xt.tuples.push(x);
+      yt.tuples.push(y);
+
+      return Metadata.covers(xt, yt) ? -1 : Metadata.covers(yt, xt) ? 1 : 0;
+    });
+
+  // SORT CONSTANT VALUES
+  for (const constant of props.metadata.constants)
+    if (constant.type === "string") constant.values.sort();
+    else if (constant.type === "number")
+      constant.values.sort((a, b) => (a.value as number) - (b.value as number));
+    else if (constant.type === "bigint")
+      constant.values.sort((a, b) =>
+        (a.value as bigint) < (b.value as bigint) ? -1 : 1,
+      );
+    else constant.values.sort((a, _b) => (a.value === false ? -1 : 1));
+};

package/src/factories/internal/metadata/iterate_metadata_template.ts

@@ -1,42 +1,42 @@
-import ts from "typescript";
-
-import { Metadata } from "../../../schemas/metadata/Metadata";
-import { MetadataTemplate } from "../../../schemas/metadata/MetadataTemplate";
-
-import { IMetadataIteratorProps } from "./IMetadataIteratorProps";
-import { MetadataHelper } from "./MetadataHelper";
-import { explore_metadata } from "./explore_metadata";
-
-export const iterate_metadata_template = (
-  props: IMetadataIteratorProps,
-): boolean => {
-  const filter = (flag: ts.TypeFlags) => (props.type.getFlags() & flag) !== 0;
-  if (!filter(ts.TypeFlags.TemplateLiteral)) return false;
-
-  const template: ts.TemplateLiteralType = props.type as ts.TemplateLiteralType;
-  const row: Metadata[] = [];
-
-  template.texts.forEach((text, i) => {
-    // TEXT LITERAL TYPE
-    if (text !== "") row.push(MetadataHelper.literal_to_metadata(text));
-
-    // BINDED TEMPLATE TYPE
-    const binded: ts.Type | undefined = template.types[i];
-    if (binded)
-      row.push(
-        explore_metadata({
-          ...props,
-          type: binded,
-          explore: {
-            ...props.explore,
-            escaped: false,
-            aliased: false,
-          },
-        }),
-      );
-  });
-  props.metadata.templates.push(
-    MetadataTemplate.create({ row, tags: undefined }),
-  );
-  return true;
-};
+import ts from "typescript";
+
+import { Metadata } from "../../../schemas/metadata/Metadata";
+import { MetadataTemplate } from "../../../schemas/metadata/MetadataTemplate";
+
+import { IMetadataIteratorProps } from "./IMetadataIteratorProps";
+import { MetadataHelper } from "./MetadataHelper";
+import { explore_metadata } from "./explore_metadata";
+
+export const iterate_metadata_template = (
+  props: IMetadataIteratorProps,
+): boolean => {
+  const filter = (flag: ts.TypeFlags) => (props.type.getFlags() & flag) !== 0;
+  if (!filter(ts.TypeFlags.TemplateLiteral)) return false;
+
+  const template: ts.TemplateLiteralType = props.type as ts.TemplateLiteralType;
+  const row: Metadata[] = [];
+
+  template.texts.forEach((text, i) => {
+    // TEXT LITERAL TYPE
+    if (text !== "") row.push(MetadataHelper.literal_to_metadata(text));
+
+    // BINDED TEMPLATE TYPE
+    const binded: ts.Type | undefined = template.types[i];
+    if (binded)
+      row.push(
+        explore_metadata({
+          ...props,
+          type: binded,
+          explore: {
+            ...props.explore,
+            escaped: false,
+            aliased: false,
+          },
+        }),
+      );
+  });
+  props.metadata.templates.push(
+    MetadataTemplate.create({ row, tags: undefined }),
+  );
+  return true;
+};

package/src/factories/internal/metadata/iterate_metadata_tuple.ts

@@ -1,26 +1,26 @@
-import ts from "typescript";
-
-import { MetadataTuple } from "../../../schemas/metadata/MetadataTuple";
-import { MetadataTupleType } from "../../../schemas/metadata/MetadataTupleType";
-
-import { ArrayUtil } from "../../../utils/ArrayUtil";
-
-import { IMetadataIteratorProps } from "./IMetadataIteratorProps";
-import { emplace_metadata_tuple } from "./emplace_metadata_tuple";
-
-export const iterate_metadata_tuple = (
-  props: IMetadataIteratorProps<ts.TupleType>,
-): boolean => {
-  if (!props.checker.isTupleType(props.type)) return false;
-
-  const tupleType: MetadataTupleType = emplace_metadata_tuple(props);
-  ArrayUtil.add(
-    props.metadata.tuples,
-    MetadataTuple.create({
-      type: tupleType,
-      tags: [],
-    }),
-    (elem) => elem.type.name === tupleType.name,
-  );
-  return true;
-};
+import ts from "typescript";
+
+import { MetadataTuple } from "../../../schemas/metadata/MetadataTuple";
+import { MetadataTupleType } from "../../../schemas/metadata/MetadataTupleType";
+
+import { ArrayUtil } from "../../../utils/ArrayUtil";
+
+import { IMetadataIteratorProps } from "./IMetadataIteratorProps";
+import { emplace_metadata_tuple } from "./emplace_metadata_tuple";
+
+export const iterate_metadata_tuple = (
+  props: IMetadataIteratorProps<ts.TupleType>,
+): boolean => {
+  if (!props.checker.isTupleType(props.type)) return false;
+
+  const tupleType: MetadataTupleType = emplace_metadata_tuple(props);
+  ArrayUtil.add(
+    props.metadata.tuples,
+    MetadataTuple.create({
+      type: tupleType,
+      tags: [],
+    }),
+    (elem) => elem.type.name === tupleType.name,
+  );
+  return true;
+};

package/src/factories/internal/metadata/iterate_metadata_union.ts

@@ -1,19 +1,19 @@
-import { IMetadataIteratorProps } from "./IMetadataIteratorProps";
-import { iterate_metadata } from "./iterate_metadata";
-
-export const iterate_metadata_union = (
-  props: IMetadataIteratorProps,
-): boolean => {
-  if (!props.type.isUnion()) return false;
-  props.type.types.forEach((t) =>
-    iterate_metadata({
-      ...props,
-      type: t,
-      explore: {
-        ...props.explore,
-        aliased: false,
-      },
-    }),
-  );
-  return true;
-};
+import { IMetadataIteratorProps } from "./IMetadataIteratorProps";
+import { iterate_metadata } from "./iterate_metadata";
+
+export const iterate_metadata_union = (
+  props: IMetadataIteratorProps,
+): boolean => {
+  if (!props.type.isUnion()) return false;
+  props.type.types.forEach((t) =>
+    iterate_metadata({
+      ...props,
+      type: t,
+      explore: {
+        ...props.explore,
+        aliased: false,
+      },
+    }),
+  );
+  return true;
+};

package/src/internal/$accessExpressionAsString.ts

@@ -1,46 +1,46 @@
-export const $accessExpressionAsString = (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 $accessExpressionAsString = (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/internal/$assertGuard.ts

@@ -1,13 +1,13 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-export const $assertGuard = (
-  exceptionable: boolean,
-  props: TypeGuardError.IProps,
-  factory?: (props: TypeGuardError.IProps) => Error,
-): false => {
-  if (exceptionable === true) {
-    if (factory) throw factory(props);
-    else throw new TypeGuardError(props);
-  }
-  return false;
-};
+import { TypeGuardError } from "../TypeGuardError";
+
+export const $assertGuard = (
+  exceptionable: boolean,
+  props: TypeGuardError.IProps,
+  factory?: (props: TypeGuardError.IProps) => Error,
+): false => {
+  if (exceptionable === true) {
+    if (factory) throw factory(props);
+    else throw new TypeGuardError(props);
+  }
+  return false;
+};

package/src/internal/$functionalTypeGuardErrorFactory.ts

@@ -1,4 +1,4 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-export const $functionalTypeGuardErrorFactory = (p: TypeGuardError.IProps) =>
-  new TypeGuardError(p);
+import { TypeGuardError } from "../TypeGuardError";
+
+export const $functionalTypeGuardErrorFactory = (p: TypeGuardError.IProps) =>
+  new TypeGuardError(p);

package/src/internal/$httpFormDataReadArray.ts

@@ -1,4 +1,4 @@
-export const $httpFormDataReadArray = (
-  input: any[],
-  alternative: null | undefined,
-) => (input.length ? input : alternative);
+export const $httpFormDataReadArray = (
+  input: any[],
+  alternative: null | undefined,
+) => (input.length ? input : alternative);

package/src/internal/$httpFormDataReadBigint.ts

@@ -1,18 +1,18 @@
-export const $httpFormDataReadBigint = (
-  input: string | File | null,
-): bigint | null | undefined =>
-  input instanceof File
-    ? (input as any)
-    : !!input?.length
-      ? input === "null"
-        ? null
-        : (toBigint(input) as any)
-      : undefined;
-
-const toBigint = (str: string): bigint | string => {
-  try {
-    return BigInt(str);
-  } catch {
-    return str;
-  }
-};
+export const $httpFormDataReadBigint = (
+  input: string | File | null,
+): bigint | null | undefined =>
+  input instanceof File
+    ? (input as any)
+    : !!input?.length
+      ? input === "null"
+        ? null
+        : (toBigint(input) as any)
+      : undefined;
+
+const toBigint = (str: string): bigint | string => {
+  try {
+    return BigInt(str);
+  } catch {
+    return str;
+  }
+};

package/src/internal/$httpFormDataReadBlob.ts

@@ -1,10 +1,10 @@
-export const $httpFormDataReadBlob = (
-  input: string | Blob | null,
-): Blob | null | undefined =>
-  input instanceof Blob
-    ? input
-    : input === null
-      ? undefined
-      : input === "null"
-        ? null
-        : (input as any);
+export const $httpFormDataReadBlob = (
+  input: string | Blob | null,
+): Blob | null | undefined =>
+  input instanceof Blob
+    ? input
+    : input === null
+      ? undefined
+      : input === "null"
+        ? null
+        : (input as any);

package/src/internal/$httpFormDataReadBoolean.ts

@@ -1,16 +1,16 @@
-export const $httpFormDataReadBoolean = (
-  input: string | File | null,
-): boolean | null | undefined =>
-  input instanceof File
-    ? (input as any)
-    : input === null
-      ? undefined
-      : input === "null"
-        ? null
-        : input.length === 0
-          ? true
-          : input === "true" || input === "1"
-            ? true
-            : input === "false" || input === "0"
-              ? false
-              : (input as any); // wrong type
+export const $httpFormDataReadBoolean = (
+  input: string | File | null,
+): boolean | null | undefined =>
+  input instanceof File
+    ? (input as any)
+    : input === null
+      ? undefined
+      : input === "null"
+        ? null
+        : input.length === 0
+          ? true
+          : input === "true" || input === "1"
+            ? true
+            : input === "false" || input === "0"
+              ? false
+              : (input as any); // wrong type