typia 6.10.2-dev.20240920 → 6.10.2

package/src/factories/MetadataTypeTagFactory.ts

@@ -1,336 +1,336 @@
-import { IMetadataTypeTag } from "../schemas/metadata/IMetadataTypeTag";
-import { Metadata } from "../schemas/metadata/Metadata";
-import { MetadataObject } from "../schemas/metadata/MetadataObject";
-import { MetadataProperty } from "../schemas/metadata/MetadataProperty";
-
-import { MetadataFactory } from "./MetadataFactory";
-import { MetadataTypeTagSchemaFactory } from "./MetadataTypeTagSchemaFactory";
-
-export namespace MetadataTypeTagFactory {
-  export const analyze =
-    (errors: MetadataFactory.IError[]) =>
-    (type: "boolean" | "bigint" | "number" | "string" | "array") =>
-    (
-      objects: MetadataObject[],
-      explore: MetadataFactory.IExplore,
-    ): IMetadataTypeTag[] => {
-      const messages: string[] = [];
-      const report =
-        (property: string | null) =>
-        (msg: string): false => {
-          messages.push(
-            `the property ${
-              property === null ? `["typia.tag"]` : `["typia.tag.${property}"]`
-            } ${msg}.`,
-          );
-          return false;
-        };
-
-      //----
-      // VALIDATION PROCESS
-      //----
-      const filtered: MetadataObject[] = objects.filter((obj) => {
-        // ONLY ONE PROPERTY
-        if (obj.properties.length !== 1) return false;
-
-        // THE TAG.TYPE PROPERTY MUST BE
-        const top: MetadataProperty = obj.properties[0]!;
-        if (
-          top.key.getSoleLiteral() !== "typia.tag" ||
-          top.value.size() !== 1 ||
-          top.value.objects.length !== 1
-        )
-          return false;
-        else if (top.value.optional === false)
-          return report(null)("must be optional object");
-
-        // CHECK LIST OF PROPERTIES
-        const tag: MetadataObject = top.value.objects[0]!;
-        const statics: string[] = tag.properties
-          .map((p) => p.key.getSoleLiteral()!)
-          .filter((str) => str !== null);
-        if (ESSENTIAL_FIELDS.some((f) => !statics.includes(f)))
-          return report(null)(
-            `must have at least three properties - ${ESSENTIAL_FIELDS.map(
-              (str) => `'${str}'`,
-            ).join(", ")}`,
-          );
-
-        const each: boolean[] = tag.properties.map((p) => {
-          const key: string | null = p.key.getSoleLiteral();
-          if (key === null) return true;
-          else if (FIELDS.includes(key) === false) return true;
-          return validate_property(report)(key, p.value);
-        });
-        return each.every((v) => v === true);
-      });
-      if (filtered.length === 0) return [];
-
-      //----
-      // CONSTRUCT TYPE TAGS
-      //----
-      // CREATE 1ST
-      const tagList: Array<ITypeTag | null> = filtered.map(
-        create_metadata_type_tag(report),
-      );
-
-      const output: IMetadataTypeTag[] = [];
-      for (const tag of tagList)
-        if (tag !== null)
-          output.push({
-            target: tag.target.some((str) => str === type) ? type : null!,
-            name: tag.name,
-            kind: tag.kind,
-            value: tag.value,
-            validate: tag.validate[type]!,
-            exclusive: tag.exclusive,
-            schema: tag.schema,
-          });
-      validate(report)(type)(output);
-
-      if (messages.length > 0) {
-        errors.push({
-          name: [type, ...objects.map((o) => o.name)].join(" & "),
-          explore,
-          messages,
-        });
-        return [];
-      }
-      return output;
-    };
-
-  export const validate =
-    (report: (property: string | null) => (msg: string) => false) =>
-    (type: "boolean" | "bigint" | "number" | "string" | "array") =>
-    (tagList: IMetadataTypeTag[]): boolean => {
-      let success: boolean = true;
-      for (const tag of tagList)
-        if (tag.target !== type) {
-          success &&= report(null)(`target must constains ${type} type`);
-        }
-
-      tagList.forEach((tag, i) => {
-        if (tag.exclusive === false) return;
-        else if (tag.exclusive === true) {
-          const some: boolean = tagList.some(
-            (opposite, j) => i !== j && opposite.kind === tag.kind,
-          );
-          if (some === true)
-            success &&= report(null)(`kind '${tag.kind}' can't be duplicated`);
-        } else if (Array.isArray(tag.exclusive)) {
-          const some: IMetadataTypeTag | undefined = tagList.find(
-            (opposite, j) =>
-              i !== j &&
-              opposite.kind === tag.kind &&
-              (tag.exclusive as string[]).includes(opposite.name),
-          );
-          if (some !== undefined)
-            success ??= report(null)(
-              `kind '${tag.kind}' can't be used with '${some.name}'`,
-            );
-        }
-      });
-      return success;
-    };
-
-  const validate_property =
-    (report: (property: string | null) => (msg: string) => false) =>
-    (key: string, value: Metadata): boolean => {
-      if (
-        // TARGET
-        key === "target" &&
-        (value.constants.length !== 1 ||
-          value.constants[0]!.values.length !== value.size() ||
-          value.constants[0]!.values.some(
-            (v) =>
-              v.value !== "boolean" &&
-              v.value !== "bigint" &&
-              v.value !== "number" &&
-              v.value !== "string" &&
-              v.value !== "array",
-          ))
-      )
-        return report(key)(
-          `must be one of 'boolean', 'bigint', 'number', 'string', 'array'`,
-        );
-      else if (
-        // KIND
-        key === "kind" &&
-        (value.size() !== 1 ||
-          value.constants.length !== 1 ||
-          value.constants[0]!.type !== "string" ||
-          value.constants[0]!.values.length !== 1)
-      )
-        return report(key)("must be a string literal type");
-      else if (
-        // VALUE
-        key === "value" &&
-        (value.size() > 1 ||
-          (value.size() !== 0 &&
-            (value.constants.length !== 1 ||
-              value.constants[0]!.values.length !== 1)))
-      )
-        return report(key)(
-          "must be a constant literal type or undefined value",
-        );
-      else if (key === "exclusive")
-        return get_exclusive(report)(key)(value) !== null;
-      else if (key === "validate") {
-        //----
-        // VALIDATE
-        //----
-        // UNDEFINED CASE
-        if (
-          value.size() === 0 &&
-          value.isRequired() === false &&
-          value.nullable === false
-        )
-          return true;
-
-        // STRING CASE
-        if (
-          value.size() === 1 &&
-          value.constants.length === 1 &&
-          value.constants[0]!.type === "string" &&
-          (value.constants[0]!.values.length === 1) === true
-        )
-          return true;
-
-        // RECORD<TARGET, STRING>
-        const target: string[] | undefined = value.objects[0]?.properties
-          .map((p) => p.key.getSoleLiteral()!)
-          .filter((str) => str !== null) as string[] | undefined;
-        if (target === undefined)
-          return report("target")(
-            `must be one of 'boolean', 'bigint', 'number', 'string', 'array'`,
-          );
-        const variadic: boolean =
-          value.size() === 1 &&
-          value.objects.length === 1 &&
-          value.objects[0]!.properties.every(
-            (vp) =>
-              vp.value.size() === 1 &&
-              vp.value.isRequired() &&
-              vp.value.nullable === false &&
-              vp.value.constants.length === 1 &&
-              vp.value.constants[0]!.type === "string" &&
-              vp.value.constants[0]!.values.length === 1 &&
-              target.includes(vp.key.getSoleLiteral()!),
-          );
-        if (variadic === false)
-          return report(key)(
-            `must be a string literal type or Record<Target, string> type.`,
-          );
-      }
-      return true;
-    };
-
-  const create_metadata_type_tag =
-    (report: (property: string | null) => (msg: string) => false) =>
-    (obj: MetadataObject): ITypeTag | null => {
-      const find = (key: string): MetadataProperty | undefined =>
-        obj.properties[0]?.value.objects[0]?.properties.find(
-          (p) => p.key.getSoleLiteral() === key,
-        );
-
-      const target = find("target")!.value.constants[0]!.values.map(
-        (v) => v.value,
-      ) as ITypeTag["target"];
-      const kind: string = find("kind")!.value.constants[0]!.values[0]!
-        .value as string;
-      const value: boolean | bigint | number | string | undefined =
-        find("value")?.value.constants[0]?.values[0]!.value;
-      const exclusive: string[] | boolean | null = get_exclusive(report)(
-        "exclusive",
-      )(find("exclusive")?.value);
-      if (exclusive === null) return null;
-
-      const validate: Record<string, string> = (() => {
-        const validate = find("validate")?.value;
-        if (!validate || validate.size() === 0) return {};
-        else if (validate.constants.length)
-          return Object.fromEntries(
-            target.map((t) => [
-              t,
-              validate.constants[0]!.values[0]!.value as string,
-            ]),
-          );
-        return Object.fromEntries(
-          validate.objects[0]!.properties.map((p) => [
-            p.key.getSoleLiteral()!,
-            p.value.constants[0]!.values[0]!.value as string,
-          ]),
-        );
-      })();
-      const schema: object | undefined = (() => {
-        const p: Metadata | undefined = find("schema")?.value;
-        if (p === undefined) return undefined;
-        else if (p.size() === 0 && p.isRequired() === false) return undefined;
-        else if (
-          p.size() === 1 &&
-          p.nullable === false &&
-          p.isRequired() === true &&
-          p.any === false
-        )
-          return MetadataTypeTagSchemaFactory.object((msg) =>
-            report("schema")(msg),
-          )(p.objects[0]!);
-        report("schema")("must be an object type");
-        return undefined;
-      })();
-      return {
-        name: obj.name,
-        target,
-        kind,
-        value,
-        validate,
-        exclusive: exclusive ?? false,
-        schema,
-      };
-    };
-
-  const get_exclusive =
-    (report: (property: string | null) => (msg: string) => false) =>
-    (key: string) =>
-    (value: Metadata | undefined): boolean | string[] | null => {
-      if (value === undefined) return false;
-      else if (
-        value.size() === 1 &&
-        value.constants.length === 1 &&
-        value.constants[0]!.type === "boolean" &&
-        value.constants[0]!.values.length === 1
-      )
-        return value.constants[0]!.values[0]!.value as boolean;
-      else if (
-        value.size() === 1 &&
-        value.tuples.length === 1 &&
-        value.tuples[0]!.type.elements.every(
-          (elem) =>
-            elem.size() === 1 &&
-            elem.constants.length === 1 &&
-            elem.constants[0]!.type === "string" &&
-            elem.constants[0]!.values.length === 1,
-        )
-      )
-        return value.tuples[0]!.type.elements.map(
-          (elem) => elem.constants[0]!.values[0]!.value as string,
-        );
-      report(key)(
-        "must a boolean literal type or a tuple of string literal types.",
-      );
-      return null;
-    };
-}
-
-interface ITypeTag {
-  name: string;
-  target: Array<"bigint" | "number" | "string" | "array">;
-  kind: string;
-  value?: undefined | boolean | bigint | number | string;
-  validate: Record<string, string>;
-  exclusive: boolean | string[];
-  schema?: undefined | any;
-}
-
-const ESSENTIAL_FIELDS = ["target", "kind", "value"];
-const FIELDS = [...ESSENTIAL_FIELDS, "validate", "exclusive"];
+import { IMetadataTypeTag } from "../schemas/metadata/IMetadataTypeTag";
+import { Metadata } from "../schemas/metadata/Metadata";
+import { MetadataObject } from "../schemas/metadata/MetadataObject";
+import { MetadataProperty } from "../schemas/metadata/MetadataProperty";
+
+import { MetadataFactory } from "./MetadataFactory";
+import { MetadataTypeTagSchemaFactory } from "./MetadataTypeTagSchemaFactory";
+
+export namespace MetadataTypeTagFactory {
+  export const analyze =
+    (errors: MetadataFactory.IError[]) =>
+    (type: "boolean" | "bigint" | "number" | "string" | "array") =>
+    (
+      objects: MetadataObject[],
+      explore: MetadataFactory.IExplore,
+    ): IMetadataTypeTag[] => {
+      const messages: string[] = [];
+      const report =
+        (property: string | null) =>
+        (msg: string): false => {
+          messages.push(
+            `the property ${
+              property === null ? `["typia.tag"]` : `["typia.tag.${property}"]`
+            } ${msg}.`,
+          );
+          return false;
+        };
+
+      //----
+      // VALIDATION PROCESS
+      //----
+      const filtered: MetadataObject[] = objects.filter((obj) => {
+        // ONLY ONE PROPERTY
+        if (obj.properties.length !== 1) return false;
+
+        // THE TAG.TYPE PROPERTY MUST BE
+        const top: MetadataProperty = obj.properties[0]!;
+        if (
+          top.key.getSoleLiteral() !== "typia.tag" ||
+          top.value.size() !== 1 ||
+          top.value.objects.length !== 1
+        )
+          return false;
+        else if (top.value.optional === false)
+          return report(null)("must be optional object");
+
+        // CHECK LIST OF PROPERTIES
+        const tag: MetadataObject = top.value.objects[0]!;
+        const statics: string[] = tag.properties
+          .map((p) => p.key.getSoleLiteral()!)
+          .filter((str) => str !== null);
+        if (ESSENTIAL_FIELDS.some((f) => !statics.includes(f)))
+          return report(null)(
+            `must have at least three properties - ${ESSENTIAL_FIELDS.map(
+              (str) => `'${str}'`,
+            ).join(", ")}`,
+          );
+
+        const each: boolean[] = tag.properties.map((p) => {
+          const key: string | null = p.key.getSoleLiteral();
+          if (key === null) return true;
+          else if (FIELDS.includes(key) === false) return true;
+          return validate_property(report)(key, p.value);
+        });
+        return each.every((v) => v === true);
+      });
+      if (filtered.length === 0) return [];
+
+      //----
+      // CONSTRUCT TYPE TAGS
+      //----
+      // CREATE 1ST
+      const tagList: Array<ITypeTag | null> = filtered.map(
+        create_metadata_type_tag(report),
+      );
+
+      const output: IMetadataTypeTag[] = [];
+      for (const tag of tagList)
+        if (tag !== null)
+          output.push({
+            target: tag.target.some((str) => str === type) ? type : null!,
+            name: tag.name,
+            kind: tag.kind,
+            value: tag.value,
+            validate: tag.validate[type]!,
+            exclusive: tag.exclusive,
+            schema: tag.schema,
+          });
+      validate(report)(type)(output);
+
+      if (messages.length > 0) {
+        errors.push({
+          name: [type, ...objects.map((o) => o.name)].join(" & "),
+          explore,
+          messages,
+        });
+        return [];
+      }
+      return output;
+    };
+
+  export const validate =
+    (report: (property: string | null) => (msg: string) => false) =>
+    (type: "boolean" | "bigint" | "number" | "string" | "array") =>
+    (tagList: IMetadataTypeTag[]): boolean => {
+      let success: boolean = true;
+      for (const tag of tagList)
+        if (tag.target !== type) {
+          success &&= report(null)(`target must constains ${type} type`);
+        }
+
+      tagList.forEach((tag, i) => {
+        if (tag.exclusive === false) return;
+        else if (tag.exclusive === true) {
+          const some: boolean = tagList.some(
+            (opposite, j) => i !== j && opposite.kind === tag.kind,
+          );
+          if (some === true)
+            success &&= report(null)(`kind '${tag.kind}' can't be duplicated`);
+        } else if (Array.isArray(tag.exclusive)) {
+          const some: IMetadataTypeTag | undefined = tagList.find(
+            (opposite, j) =>
+              i !== j &&
+              opposite.kind === tag.kind &&
+              (tag.exclusive as string[]).includes(opposite.name),
+          );
+          if (some !== undefined)
+            success ??= report(null)(
+              `kind '${tag.kind}' can't be used with '${some.name}'`,
+            );
+        }
+      });
+      return success;
+    };
+
+  const validate_property =
+    (report: (property: string | null) => (msg: string) => false) =>
+    (key: string, value: Metadata): boolean => {
+      if (
+        // TARGET
+        key === "target" &&
+        (value.constants.length !== 1 ||
+          value.constants[0]!.values.length !== value.size() ||
+          value.constants[0]!.values.some(
+            (v) =>
+              v.value !== "boolean" &&
+              v.value !== "bigint" &&
+              v.value !== "number" &&
+              v.value !== "string" &&
+              v.value !== "array",
+          ))
+      )
+        return report(key)(
+          `must be one of 'boolean', 'bigint', 'number', 'string', 'array'`,
+        );
+      else if (
+        // KIND
+        key === "kind" &&
+        (value.size() !== 1 ||
+          value.constants.length !== 1 ||
+          value.constants[0]!.type !== "string" ||
+          value.constants[0]!.values.length !== 1)
+      )
+        return report(key)("must be a string literal type");
+      else if (
+        // VALUE
+        key === "value" &&
+        (value.size() > 1 ||
+          (value.size() !== 0 &&
+            (value.constants.length !== 1 ||
+              value.constants[0]!.values.length !== 1)))
+      )
+        return report(key)(
+          "must be a constant literal type or undefined value",
+        );
+      else if (key === "exclusive")
+        return get_exclusive(report)(key)(value) !== null;
+      else if (key === "validate") {
+        //----
+        // VALIDATE
+        //----
+        // UNDEFINED CASE
+        if (
+          value.size() === 0 &&
+          value.isRequired() === false &&
+          value.nullable === false
+        )
+          return true;
+
+        // STRING CASE
+        if (
+          value.size() === 1 &&
+          value.constants.length === 1 &&
+          value.constants[0]!.type === "string" &&
+          (value.constants[0]!.values.length === 1) === true
+        )
+          return true;
+
+        // RECORD<TARGET, STRING>
+        const target: string[] | undefined = value.objects[0]?.properties
+          .map((p) => p.key.getSoleLiteral()!)
+          .filter((str) => str !== null) as string[] | undefined;
+        if (target === undefined)
+          return report("target")(
+            `must be one of 'boolean', 'bigint', 'number', 'string', 'array'`,
+          );
+        const variadic: boolean =
+          value.size() === 1 &&
+          value.objects.length === 1 &&
+          value.objects[0]!.properties.every(
+            (vp) =>
+              vp.value.size() === 1 &&
+              vp.value.isRequired() &&
+              vp.value.nullable === false &&
+              vp.value.constants.length === 1 &&
+              vp.value.constants[0]!.type === "string" &&
+              vp.value.constants[0]!.values.length === 1 &&
+              target.includes(vp.key.getSoleLiteral()!),
+          );
+        if (variadic === false)
+          return report(key)(
+            `must be a string literal type or Record<Target, string> type.`,
+          );
+      }
+      return true;
+    };
+
+  const create_metadata_type_tag =
+    (report: (property: string | null) => (msg: string) => false) =>
+    (obj: MetadataObject): ITypeTag | null => {
+      const find = (key: string): MetadataProperty | undefined =>
+        obj.properties[0]?.value.objects[0]?.properties.find(
+          (p) => p.key.getSoleLiteral() === key,
+        );
+
+      const target = find("target")!.value.constants[0]!.values.map(
+        (v) => v.value,
+      ) as ITypeTag["target"];
+      const kind: string = find("kind")!.value.constants[0]!.values[0]!
+        .value as string;
+      const value: boolean | bigint | number | string | undefined =
+        find("value")?.value.constants[0]?.values[0]!.value;
+      const exclusive: string[] | boolean | null = get_exclusive(report)(
+        "exclusive",
+      )(find("exclusive")?.value);
+      if (exclusive === null) return null;
+
+      const validate: Record<string, string> = (() => {
+        const validate = find("validate")?.value;
+        if (!validate || validate.size() === 0) return {};
+        else if (validate.constants.length)
+          return Object.fromEntries(
+            target.map((t) => [
+              t,
+              validate.constants[0]!.values[0]!.value as string,
+            ]),
+          );
+        return Object.fromEntries(
+          validate.objects[0]!.properties.map((p) => [
+            p.key.getSoleLiteral()!,
+            p.value.constants[0]!.values[0]!.value as string,
+          ]),
+        );
+      })();
+      const schema: object | undefined = (() => {
+        const p: Metadata | undefined = find("schema")?.value;
+        if (p === undefined) return undefined;
+        else if (p.size() === 0 && p.isRequired() === false) return undefined;
+        else if (
+          p.size() === 1 &&
+          p.nullable === false &&
+          p.isRequired() === true &&
+          p.any === false
+        )
+          return MetadataTypeTagSchemaFactory.object((msg) =>
+            report("schema")(msg),
+          )(p.objects[0]!);
+        report("schema")("must be an object type");
+        return undefined;
+      })();
+      return {
+        name: obj.name,
+        target,
+        kind,
+        value,
+        validate,
+        exclusive: exclusive ?? false,
+        schema,
+      };
+    };
+
+  const get_exclusive =
+    (report: (property: string | null) => (msg: string) => false) =>
+    (key: string) =>
+    (value: Metadata | undefined): boolean | string[] | null => {
+      if (value === undefined) return false;
+      else if (
+        value.size() === 1 &&
+        value.constants.length === 1 &&
+        value.constants[0]!.type === "boolean" &&
+        value.constants[0]!.values.length === 1
+      )
+        return value.constants[0]!.values[0]!.value as boolean;
+      else if (
+        value.size() === 1 &&
+        value.tuples.length === 1 &&
+        value.tuples[0]!.type.elements.every(
+          (elem) =>
+            elem.size() === 1 &&
+            elem.constants.length === 1 &&
+            elem.constants[0]!.type === "string" &&
+            elem.constants[0]!.values.length === 1,
+        )
+      )
+        return value.tuples[0]!.type.elements.map(
+          (elem) => elem.constants[0]!.values[0]!.value as string,
+        );
+      report(key)(
+        "must a boolean literal type or a tuple of string literal types.",
+      );
+      return null;
+    };
+}
+
+interface ITypeTag {
+  name: string;
+  target: Array<"bigint" | "number" | "string" | "array">;
+  kind: string;
+  value?: undefined | boolean | bigint | number | string;
+  validate: Record<string, string>;
+  exclusive: boolean | string[];
+  schema?: undefined | any;
+}
+
+const ESSENTIAL_FIELDS = ["target", "kind", "value"];
+const FIELDS = [...ESSENTIAL_FIELDS, "validate", "exclusive"];