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

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

@@ -1,88 +1,88 @@
-import ts from "typescript";
-
-import { FunctionalGeneralProgrammer } from "../../../programmers/functional/internal/FunctionalGeneralProgrammer";
-
-import { Metadata } from "../../../schemas/metadata/Metadata";
-import { MetadataFunction } from "../../../schemas/metadata/MetadataFunction";
-import { MetadataParameter } from "../../../schemas/metadata/MetadataParameter";
-
-import { CommentFactory } from "../../CommentFactory";
-import { TypeFactory } from "../../TypeFactory";
-import { IMetadataIteratorProps } from "./IMetadataIteratorProps";
-import { explore_metadata } from "./explore_metadata";
-
-export const iterate_metadata_function = (
-  props: IMetadataIteratorProps,
-): boolean => {
-  const declaration: ts.SignatureDeclaration | null = TypeFactory.getFunction(
-    props.type,
-  );
-  if (declaration === null) return false;
-  else if (!props.options.functional) {
-    if (props.metadata.functions.length === 0)
-      props.metadata.functions.push(
-        MetadataFunction.create({
-          parameters: [],
-          output: Metadata.initialize(),
-          async: false,
-        }),
-      );
-  } else {
-    const [signature] = props.type.getCallSignatures();
-    if (signature === undefined || signature.declaration === undefined)
-      props.metadata.functions.push(
-        MetadataFunction.create({
-          parameters: [],
-          output: Metadata.initialize(),
-          async: false,
-        }),
-      );
-    else {
-      const { async }: FunctionalGeneralProgrammer.IOutput =
-        FunctionalGeneralProgrammer.getReturnType({
-          checker: props.checker,
-          declaration,
-        });
-      props.metadata.functions.push(
-        MetadataFunction.create({
-          parameters: signature.parameters.map((p) =>
-            MetadataParameter.create({
-              name: p.name,
-              type: explore_metadata({
-                ...props,
-                type: props.checker.getTypeOfSymbol(p),
-                explore: {
-                  ...props.explore,
-                  top: false,
-                  parameter: p.name,
-                },
-              }),
-              description: CommentFactory.description(p) ?? null,
-              jsDocTags: p?.getJsDocTags() ?? [],
-            }),
-          ),
-          async,
-          output: explore_metadata({
-            ...props,
-            options: {
-              ...props.options,
-              functional: false,
-            },
-            type: async
-              ? (props.checker.getTypeArguments(
-                  signature.getReturnType() as ts.TypeReference,
-                )?.[0] ??
-                props.checker.getTypeFromTypeNode(TypeFactory.keyword("any")))
-              : signature.getReturnType(),
-            explore: {
-              ...props.explore,
-              top: false,
-              output: true,
-            },
-          }),
-        }),
-      );
-    }
-  }
-  return true;
-};
+import ts from "typescript";
+
+import { FunctionalGeneralProgrammer } from "../../../programmers/functional/internal/FunctionalGeneralProgrammer";
+
+import { Metadata } from "../../../schemas/metadata/Metadata";
+import { MetadataFunction } from "../../../schemas/metadata/MetadataFunction";
+import { MetadataParameter } from "../../../schemas/metadata/MetadataParameter";
+
+import { CommentFactory } from "../../CommentFactory";
+import { TypeFactory } from "../../TypeFactory";
+import { IMetadataIteratorProps } from "./IMetadataIteratorProps";
+import { explore_metadata } from "./explore_metadata";
+
+export const iterate_metadata_function = (
+  props: IMetadataIteratorProps,
+): boolean => {
+  const declaration: ts.SignatureDeclaration | null = TypeFactory.getFunction(
+    props.type,
+  );
+  if (declaration === null) return false;
+  else if (!props.options.functional) {
+    if (props.metadata.functions.length === 0)
+      props.metadata.functions.push(
+        MetadataFunction.create({
+          parameters: [],
+          output: Metadata.initialize(),
+          async: false,
+        }),
+      );
+  } else {
+    const [signature] = props.type.getCallSignatures();
+    if (signature === undefined || signature.declaration === undefined)
+      props.metadata.functions.push(
+        MetadataFunction.create({
+          parameters: [],
+          output: Metadata.initialize(),
+          async: false,
+        }),
+      );
+    else {
+      const { async }: FunctionalGeneralProgrammer.IOutput =
+        FunctionalGeneralProgrammer.getReturnType({
+          checker: props.checker,
+          declaration,
+        });
+      props.metadata.functions.push(
+        MetadataFunction.create({
+          parameters: signature.parameters.map((p) =>
+            MetadataParameter.create({
+              name: p.name,
+              type: explore_metadata({
+                ...props,
+                type: props.checker.getTypeOfSymbol(p),
+                explore: {
+                  ...props.explore,
+                  top: false,
+                  parameter: p.name,
+                },
+              }),
+              description: CommentFactory.description(p) ?? null,
+              jsDocTags: p?.getJsDocTags() ?? [],
+            }),
+          ),
+          async,
+          output: explore_metadata({
+            ...props,
+            options: {
+              ...props.options,
+              functional: false,
+            },
+            type: async
+              ? (props.checker.getTypeArguments(
+                  signature.getReturnType() as ts.TypeReference,
+                )?.[0] ??
+                props.checker.getTypeFromTypeNode(TypeFactory.keyword("any")))
+              : signature.getReturnType(),
+            explore: {
+              ...props.explore,
+              top: false,
+              output: true,
+            },
+          }),
+        }),
+      );
+    }
+  }
+  return true;
+};

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

@@ -1,216 +1,216 @@
-import ts from "typescript";
-
-import { IMetadataTypeTag } from "../../../schemas/metadata/IMetadataTypeTag";
-import { Metadata } from "../../../schemas/metadata/Metadata";
-import { MetadataAtomic } from "../../../schemas/metadata/MetadataAtomic";
-import { MetadataConstant } from "../../../schemas/metadata/MetadataConstant";
-import { MetadataConstantValue } from "../../../schemas/metadata/MetadataConstantValue";
-import { MetadataTemplate } from "../../../schemas/metadata/MetadataTemplate";
-
-import { ArrayUtil } from "../../../utils/ArrayUtil";
-
-import { MetadataCollection } from "../../MetadataCollection";
-import { MetadataFactory } from "../../MetadataFactory";
-import { MetadataTypeTagFactory } from "../../MetadataTypeTagFactory";
-import { IMetadataIteratorProps } from "./IMetadataIteratorProps";
-import { explore_metadata } from "./explore_metadata";
-import { iterate_metadata } from "./iterate_metadata";
-import { iterate_metadata_array } from "./iterate_metadata_array";
-
-export const iterate_metadata_intersection = (
-  props: IMetadataIteratorProps,
-): boolean => {
-  if (!props.type.isIntersection()) return false;
-  if (
-    // ONLY OBJECT TYPED INTERSECTION
-    props.type.types.every(
-      (child) =>
-        (child.getFlags() & ts.TypeFlags.Object) !== 0 &&
-        !props.checker.isArrayType(child) &&
-        !props.checker.isTupleType(child),
-    )
-  )
-    return false;
-
-  // COSTRUCT FAKE METADATA LIST
-  const fakeCollection: MetadataCollection = props.collection.clone();
-  const fakeErrors: MetadataFactory.IError[] = [];
-  const children: Metadata[] = [
-    ...new Map(
-      props.type.types.map((t) => {
-        const m: Metadata = explore_metadata({
-          ...props,
-          options: {
-            ...props.options,
-            absorb: true,
-          },
-          collection: fakeCollection,
-          errors: fakeErrors,
-          type: t,
-          explore: {
-            ...props.explore,
-            aliased: false,
-          },
-        });
-        return [m.getName(), m] as const;
-      }),
-    ).values(),
-  ];
-  if (fakeErrors.length) {
-    props.errors.push(...fakeErrors);
-    return true;
-  }
-
-  // ONLY ONE CHILD AFTER REMOVING DUPLICATES
-  if (children.length === 1) {
-    iterate_metadata({
-      ...props,
-      type: props.type.types[0]!,
-    });
-    return true;
-  } else if (children.every((c) => c.objects.length === c.size()))
-    // ONLY OBJECT TYPED INTERSECTION (DETAILED)
-    return false;
-
-  // VALIDATE EACH TYPES
-  const nonsensible = () => {
-    props.errors.push({
-      name: children.map((c) => c.getName()).join(" & "),
-      explore: { ...props.explore },
-      messages: ["nonsensible intersection"],
-    });
-    return true;
-  };
-  const individuals: (readonly [Metadata, number])[] = children
-    .map((child, i) => [child, i] as const)
-    .filter(
-      ([c]) =>
-        (c.size() === 1 &&
-          (c.atomics.length === 1 ||
-            (c.constants.length === 1 && c.constants[0]!.values.length === 1) ||
-            c.arrays.length === 1)) ||
-        c.templates.length === 1,
-    );
-  if (individuals.length !== 1) return nonsensible();
-
-  const objects: Metadata[] = children.filter(
-    (c) =>
-      c.nullable === false &&
-      c.isRequired() === true &&
-      c.objects.length &&
-      c.objects.length === c.size() &&
-      c.objects.every((o) => o.properties.every((p) => p.value.optional)),
-  );
-  const arrays: Set<string> = new Set(
-    individuals.map(([c]) => c.arrays.map((a) => a.type.name)).flat(),
-  );
-  const atomics: Set<"boolean" | "bigint" | "number" | "string"> = new Set(
-    individuals.map(([c]) => [...c.atomics.map((a) => a.type)]).flat(),
-  );
-  const constants: Metadata[] = individuals
-    .filter((i) => i[0].constants.length === 1)
-    .map(([m]) => m);
-  const templates: Metadata[] = individuals
-    .filter((i) => i[0].templates.length === 1)
-    .map(([m]) => m);
-
-  // ESCAPE WHEN ONLY CONSTANT TYPES EXIST
-  if (
-    atomics.size + constants.length + arrays.size + templates.length > 1 ||
-    individuals.length + objects.length !== children.length
-  )
-    return nonsensible();
-
-  // RE-GENERATE TYPE
-  const target: "boolean" | "bigint" | "number" | "string" | "array" =
-    arrays.size
-      ? "array"
-      : atomics.size
-        ? atomics.values().next().value!
-        : constants.length
-          ? constants[0]!.constants[0]!.type
-          : "string";
-  if (target === "array") {
-    const name: string = arrays.values().next().value!;
-    if (!props.metadata.arrays.some((a) => a.type.name === name)) {
-      iterate_metadata_array({
-        ...props,
-        type: props.type.types[
-          individuals.find((i) => i[0].arrays.length === 1)![1]
-        ]!,
-        explore: {
-          ...props.explore,
-          aliased: false,
-          escaped: false,
-        },
-      });
-    }
-  } else if (atomics.size)
-    ArrayUtil.add(
-      props.metadata.atomics,
-      MetadataAtomic.create({
-        type: atomics.values().next().value as "string",
-        tags: [],
-      }),
-      (a, b) => a.type === b.type,
-    );
-  else if (constants.length)
-    ArrayUtil.take(
-      ArrayUtil.take(
-        props.metadata.constants,
-        (o) => o.type === target,
-        () =>
-          MetadataConstant.create({
-            type: target,
-            values: [],
-          }),
-      ).values,
-      (o) => o.value === constants[0]!.constants[0]!.values[0]!.value,
-      () =>
-        MetadataConstantValue.create({
-          value: constants[0]!.constants[0]!.values[0]!.value,
-          tags: [],
-        }),
-    );
-  else if (templates.length)
-    ArrayUtil.take(
-      props.metadata.templates,
-      (o) => o.getBaseName() === templates[0]!.templates[0]!.getBaseName(),
-      () =>
-        MetadataTemplate.create({
-          row: templates[0]!.templates[0]!.row,
-          tags: [],
-        }),
-    );
-
-  // ASSIGN TAGS
-  if (objects.length) {
-    const tags: IMetadataTypeTag[] = MetadataTypeTagFactory.analyze({
-      errors: props.errors,
-      type: target,
-      objects: objects.map((om) => om.objects).flat(),
-      explore: props.explore,
-    });
-    if (tags.length)
-      if (target === "array") props.metadata.arrays.at(-1)!.tags.push(tags);
-      else if (atomics.size)
-        props.metadata.atomics.find((a) => a.type === target)!.tags.push(tags);
-      else if (constants.length) {
-        const constant: MetadataConstant = props.metadata.constants.find(
-          (c) => c.type === target,
-        )!;
-        const value: MetadataConstantValue = constant.values.find(
-          (v) => v.value === constants[0]!.constants[0]!.values[0]!.value,
-        )!;
-        value.tags ??= [];
-        value.tags.push(tags);
-      } else if (templates.length) {
-        const template: MetadataTemplate = props.metadata.templates.find(
-          (t) => t.getBaseName() === templates[0]!.templates[0]!.getBaseName(),
-        )!;
-        template.tags ??= [];
-        template.tags.push(tags);
-      }
-  }
-  return true;
-};
+import ts from "typescript";
+
+import { IMetadataTypeTag } from "../../../schemas/metadata/IMetadataTypeTag";
+import { Metadata } from "../../../schemas/metadata/Metadata";
+import { MetadataAtomic } from "../../../schemas/metadata/MetadataAtomic";
+import { MetadataConstant } from "../../../schemas/metadata/MetadataConstant";
+import { MetadataConstantValue } from "../../../schemas/metadata/MetadataConstantValue";
+import { MetadataTemplate } from "../../../schemas/metadata/MetadataTemplate";
+
+import { ArrayUtil } from "../../../utils/ArrayUtil";
+
+import { MetadataCollection } from "../../MetadataCollection";
+import { MetadataFactory } from "../../MetadataFactory";
+import { MetadataTypeTagFactory } from "../../MetadataTypeTagFactory";
+import { IMetadataIteratorProps } from "./IMetadataIteratorProps";
+import { explore_metadata } from "./explore_metadata";
+import { iterate_metadata } from "./iterate_metadata";
+import { iterate_metadata_array } from "./iterate_metadata_array";
+
+export const iterate_metadata_intersection = (
+  props: IMetadataIteratorProps,
+): boolean => {
+  if (!props.type.isIntersection()) return false;
+  if (
+    // ONLY OBJECT TYPED INTERSECTION
+    props.type.types.every(
+      (child) =>
+        (child.getFlags() & ts.TypeFlags.Object) !== 0 &&
+        !props.checker.isArrayType(child) &&
+        !props.checker.isTupleType(child),
+    )
+  )
+    return false;
+
+  // COSTRUCT FAKE METADATA LIST
+  const fakeCollection: MetadataCollection = props.collection.clone();
+  const fakeErrors: MetadataFactory.IError[] = [];
+  const children: Metadata[] = [
+    ...new Map(
+      props.type.types.map((t) => {
+        const m: Metadata = explore_metadata({
+          ...props,
+          options: {
+            ...props.options,
+            absorb: true,
+          },
+          collection: fakeCollection,
+          errors: fakeErrors,
+          type: t,
+          explore: {
+            ...props.explore,
+            aliased: false,
+          },
+        });
+        return [m.getName(), m] as const;
+      }),
+    ).values(),
+  ];
+  if (fakeErrors.length) {
+    props.errors.push(...fakeErrors);
+    return true;
+  }
+
+  // ONLY ONE CHILD AFTER REMOVING DUPLICATES
+  if (children.length === 1) {
+    iterate_metadata({
+      ...props,
+      type: props.type.types[0]!,
+    });
+    return true;
+  } else if (children.every((c) => c.objects.length === c.size()))
+    // ONLY OBJECT TYPED INTERSECTION (DETAILED)
+    return false;
+
+  // VALIDATE EACH TYPES
+  const nonsensible = () => {
+    props.errors.push({
+      name: children.map((c) => c.getName()).join(" & "),
+      explore: { ...props.explore },
+      messages: ["nonsensible intersection"],
+    });
+    return true;
+  };
+  const individuals: (readonly [Metadata, number])[] = children
+    .map((child, i) => [child, i] as const)
+    .filter(
+      ([c]) =>
+        (c.size() === 1 &&
+          (c.atomics.length === 1 ||
+            (c.constants.length === 1 && c.constants[0]!.values.length === 1) ||
+            c.arrays.length === 1)) ||
+        c.templates.length === 1,
+    );
+  if (individuals.length !== 1) return nonsensible();
+
+  const objects: Metadata[] = children.filter(
+    (c) =>
+      c.nullable === false &&
+      c.isRequired() === true &&
+      c.objects.length &&
+      c.objects.length === c.size() &&
+      c.objects.every((o) => o.properties.every((p) => p.value.optional)),
+  );
+  const arrays: Set<string> = new Set(
+    individuals.map(([c]) => c.arrays.map((a) => a.type.name)).flat(),
+  );
+  const atomics: Set<"boolean" | "bigint" | "number" | "string"> = new Set(
+    individuals.map(([c]) => [...c.atomics.map((a) => a.type)]).flat(),
+  );
+  const constants: Metadata[] = individuals
+    .filter((i) => i[0].constants.length === 1)
+    .map(([m]) => m);
+  const templates: Metadata[] = individuals
+    .filter((i) => i[0].templates.length === 1)
+    .map(([m]) => m);
+
+  // ESCAPE WHEN ONLY CONSTANT TYPES EXIST
+  if (
+    atomics.size + constants.length + arrays.size + templates.length > 1 ||
+    individuals.length + objects.length !== children.length
+  )
+    return nonsensible();
+
+  // RE-GENERATE TYPE
+  const target: "boolean" | "bigint" | "number" | "string" | "array" =
+    arrays.size
+      ? "array"
+      : atomics.size
+        ? atomics.values().next().value!
+        : constants.length
+          ? constants[0]!.constants[0]!.type
+          : "string";
+  if (target === "array") {
+    const name: string = arrays.values().next().value!;
+    if (!props.metadata.arrays.some((a) => a.type.name === name)) {
+      iterate_metadata_array({
+        ...props,
+        type: props.type.types[
+          individuals.find((i) => i[0].arrays.length === 1)![1]
+        ]!,
+        explore: {
+          ...props.explore,
+          aliased: false,
+          escaped: false,
+        },
+      });
+    }
+  } else if (atomics.size)
+    ArrayUtil.add(
+      props.metadata.atomics,
+      MetadataAtomic.create({
+        type: atomics.values().next().value as "string",
+        tags: [],
+      }),
+      (a, b) => a.type === b.type,
+    );
+  else if (constants.length)
+    ArrayUtil.take(
+      ArrayUtil.take(
+        props.metadata.constants,
+        (o) => o.type === target,
+        () =>
+          MetadataConstant.create({
+            type: target,
+            values: [],
+          }),
+      ).values,
+      (o) => o.value === constants[0]!.constants[0]!.values[0]!.value,
+      () =>
+        MetadataConstantValue.create({
+          value: constants[0]!.constants[0]!.values[0]!.value,
+          tags: [],
+        }),
+    );
+  else if (templates.length)
+    ArrayUtil.take(
+      props.metadata.templates,
+      (o) => o.getBaseName() === templates[0]!.templates[0]!.getBaseName(),
+      () =>
+        MetadataTemplate.create({
+          row: templates[0]!.templates[0]!.row,
+          tags: [],
+        }),
+    );
+
+  // ASSIGN TAGS
+  if (objects.length) {
+    const tags: IMetadataTypeTag[] = MetadataTypeTagFactory.analyze({
+      errors: props.errors,
+      type: target,
+      objects: objects.map((om) => om.objects).flat(),
+      explore: props.explore,
+    });
+    if (tags.length)
+      if (target === "array") props.metadata.arrays.at(-1)!.tags.push(tags);
+      else if (atomics.size)
+        props.metadata.atomics.find((a) => a.type === target)!.tags.push(tags);
+      else if (constants.length) {
+        const constant: MetadataConstant = props.metadata.constants.find(
+          (c) => c.type === target,
+        )!;
+        const value: MetadataConstantValue = constant.values.find(
+          (v) => v.value === constants[0]!.constants[0]!.values[0]!.value,
+        )!;
+        value.tags ??= [];
+        value.tags.push(tags);
+      } else if (templates.length) {
+        const template: MetadataTemplate = props.metadata.templates.find(
+          (t) => t.getBaseName() === templates[0]!.templates[0]!.getBaseName(),
+        )!;
+        template.tags ??= [];
+        template.tags.push(tags);
+      }
+  }
+  return true;
+};