typia 7.0.0-dev.20240916 → 7.0.0-dev.20240919

package/src/programmers/misc/MiscLiteralsProgrammer.ts

@@ -1,74 +1,77 @@
-import ts from "typescript";
-
-import { ExpressionFactory } from "../../factories/ExpressionFactory";
-import { MetadataCollection } from "../../factories/MetadataCollection";
-import { MetadataFactory } from "../../factories/MetadataFactory";
-
-import { Metadata } from "../../schemas/metadata/Metadata";
-
-import { ITypiaContext } from "../../transformers/ITypiaContext";
-import { TransformerError } from "../../transformers/TransformerError";
-
-import { Atomic } from "../../typings/Atomic";
-
-export namespace MiscLiteralsProgrammer {
-  export interface IProps {
-    context: ITypiaContext;
-    type: ts.Type;
-  }
-  export const write = (props: IProps) => {
-    const result = MetadataFactory.analyze(
-      props.context.checker,
-      props.context.transformer,
-    )({
-      escape: true,
-      constant: true,
-      absorb: true,
-      validate: (meta) => {
-        const length: number =
-          meta.constants
-            .map((c) => c.values.length)
-            .reduce((a, b) => a + b, 0) +
-          meta.atomics.filter((a) => a.type === "boolean").length;
-        if (0 === length) return [ErrorMessages.NO];
-        else if (meta.size() !== length) return [ErrorMessages.ONLY];
-        return [];
-      },
-    })(new MetadataCollection())(props.type);
-    if (result.success === false)
-      throw TransformerError.from(`typia.misc.literals`)(result.errors);
-
-    const meta: Metadata = result.data;
-    const values: Set<Atomic.Type | null> = new Set([
-      ...meta.constants.map((c) => c.values.map((v) => v.value)).flat(),
-      ...(meta.atomics.filter((a) => a.type === "boolean").length
-        ? [true, false]
-        : []),
-      ...(meta.nullable ? [null] : []),
-    ]);
-    return ts.factory.createAsExpression(
-      ts.factory.createArrayLiteralExpression(
-        [...values].map((v) =>
-          v === null
-            ? ts.factory.createNull()
-            : typeof v === "boolean"
-              ? v
-                ? ts.factory.createTrue()
-                : ts.factory.createFalse()
-              : typeof v === "number"
-                ? ExpressionFactory.number(v)
-                : typeof v === "bigint"
-                  ? ExpressionFactory.bigint(Number(v))
-                  : ts.factory.createStringLiteral(v),
-        ),
-        true,
-      ),
-      ts.factory.createTypeReferenceNode("const"),
-    );
-  };
-}
-
-enum ErrorMessages {
-  NO = "no constant literal type found.",
-  ONLY = "only constant literal types are allowed.",
-}
+import ts from "typescript";
+
+import { ExpressionFactory } from "../../factories/ExpressionFactory";
+import { MetadataCollection } from "../../factories/MetadataCollection";
+import { MetadataFactory } from "../../factories/MetadataFactory";
+
+import { Metadata } from "../../schemas/metadata/Metadata";
+
+import { ITypiaContext } from "../../transformers/ITypiaContext";
+import { TransformerError } from "../../transformers/TransformerError";
+
+import { Atomic } from "../../typings/Atomic";
+
+export namespace MiscLiteralsProgrammer {
+  export interface IProps {
+    context: ITypiaContext;
+    type: ts.Type;
+  }
+  export const write = (props: IProps) => {
+    const result = MetadataFactory.analyze({
+      checker: props.context.checker,
+      transformer: props.context.transformer,
+      options: {
+        escape: true,
+        constant: true,
+        absorb: true,
+        validate: (meta) => {
+          const length: number =
+            meta.constants
+              .map((c) => c.values.length)
+              .reduce((a, b) => a + b, 0) +
+            meta.atomics.filter((a) => a.type === "boolean").length;
+          if (0 === length) return [ErrorMessages.NO];
+          else if (meta.size() !== length) return [ErrorMessages.ONLY];
+          return [];
+        },
+      },
+      collection: new MetadataCollection(),
+      type: props.type,
+    });
+    if (result.success === false)
+      throw TransformerError.from(`typia.misc.literals`)(result.errors);
+
+    const meta: Metadata = result.data;
+    const values: Set<Atomic.Type | null> = new Set([
+      ...meta.constants.map((c) => c.values.map((v) => v.value)).flat(),
+      ...(meta.atomics.filter((a) => a.type === "boolean").length
+        ? [true, false]
+        : []),
+      ...(meta.nullable ? [null] : []),
+    ]);
+    return ts.factory.createAsExpression(
+      ts.factory.createArrayLiteralExpression(
+        [...values].map((v) =>
+          v === null
+            ? ts.factory.createNull()
+            : typeof v === "boolean"
+              ? v
+                ? ts.factory.createTrue()
+                : ts.factory.createFalse()
+              : typeof v === "number"
+                ? ExpressionFactory.number(v)
+                : typeof v === "bigint"
+                  ? ExpressionFactory.bigint(Number(v))
+                  : ts.factory.createStringLiteral(v),
+        ),
+        true,
+      ),
+      ts.factory.createTypeReferenceNode("const"),
+    );
+  };
+}
+
+enum ErrorMessages {
+  NO = "no constant literal type found.",
+  ONLY = "only constant literal types are allowed.",
+}

package/src/programmers/misc/MiscPruneProgrammer.ts

@@ -326,7 +326,7 @@ export namespace MiscPruneProgrammer {
       tuple: MetadataTupleType,
       explore: FeatureProgrammer.IExplore,
     ): ts.Block => {
-      const children: ts.ConciseBody[] = tuple.elements
+      const elements: ts.ConciseBody[] = tuple.elements
         .map((elem, index) => [elem, index] as const)
         .filter(([elem]) => filter(elem) && elem.rest === null)
         .map(([elem, index]) =>
@@ -362,7 +362,10 @@ export namespace MiscPruneProgrammer {
           },
         );
       })();
-      return PruneJoiner.tuple(children, rest);
+      return PruneJoiner.tuple({
+        elements,
+        rest,
+      });
     };
 
   /* -----------------------------------------------------------
@@ -518,14 +521,17 @@ export namespace MiscPruneProgrammer {
   const initializer: FeatureProgrammer.IConfig["initializer"] =
     (project) => (importer) => (type) => {
       const collection = new MetadataCollection();
-      const result = MetadataFactory.analyze(
-        project.checker,
-        project.transformer,
-      )({
-        escape: false,
-        constant: true,
-        absorb: true,
-      })(collection)(type);
+      const result = MetadataFactory.analyze({
+        checker: project.checker,
+        transformer: project.transformer,
+        options: {
+          escape: false,
+          constant: true,
+          absorb: true,
+        },
+        collection,
+        type,
+      });
       if (result.success === false)
         throw TransformerError.from(`typia.misc.${importer.method}`)(
           result.errors,

package/src/programmers/notations/NotationGeneralProgrammer.ts

@@ -393,7 +393,7 @@ export namespace NotationGeneralProgrammer {
       tuple: MetadataTupleType,
       explore: FeatureProgrammer.IExplore,
     ): ts.Expression => {
-      const children: ts.Expression[] = tuple.elements
+      const elements: ts.Expression[] = tuple.elements
         .filter((m) => m.rest === null)
         .map((elem, index) =>
           decode(project)(config)(importer)(
@@ -428,7 +428,10 @@ export namespace NotationGeneralProgrammer {
           },
         );
       })();
-      return NotationJoiner.tuple(children, rest);
+      return NotationJoiner.tuple({
+        elements,
+        rest,
+      });
     };
 
   /* -----------------------------------------------------------
@@ -665,14 +668,17 @@ export namespace NotationGeneralProgrammer {
   const initializer: FeatureProgrammer.IConfig["initializer"] =
     (project) => (importer) => (type) => {
       const collection = new MetadataCollection();
-      const result = MetadataFactory.analyze(
-        project.checker,
-        project.transformer,
-      )({
-        escape: false,
-        constant: true,
-        absorb: true,
-      })(collection)(type);
+      const result = MetadataFactory.analyze({
+        checker: project.checker,
+        transformer: project.transformer,
+        options: {
+          escape: false,
+          constant: true,
+          absorb: true,
+        },
+        collection,
+        type,
+      });
       if (result.success === false)
         throw TransformerError.from(`typia.misc.${importer.method}`)(
           result.errors,

package/src/programmers/protobuf/ProtobufDecodeProgrammer.ts

@@ -32,10 +32,13 @@ export namespace ProtobufDecodeProgrammer {
     name: string | undefined;
   }): FeatureProgrammer.IDecomposed => {
     const collection: MetadataCollection = new MetadataCollection();
-    const meta: Metadata = ProtobufFactory.metadata(props.modulo.getText())(
-      props.context.checker,
-      props.context.transformer,
-    )(collection)(props.type);
+    const meta: Metadata = ProtobufFactory.metadata({
+      method: props.modulo.getText(),
+      checker: props.context.checker,
+      transformer: props.context.transformer,
+      collection,
+      type: props.type,
+    });
     return {
       functions: Object.fromEntries(
         collection

package/src/programmers/protobuf/ProtobufEncodeProgrammer.ts

@@ -36,10 +36,13 @@ export namespace ProtobufEncodeProgrammer {
     name: string | undefined;
   }): FeatureProgrammer.IDecomposed => {
     const collection: MetadataCollection = new MetadataCollection();
-    const meta: Metadata = ProtobufFactory.metadata(props.modulo.getText())(
-      props.context.checker,
-      props.context.transformer,
-    )(collection)(props.type);
+    const meta: Metadata = ProtobufFactory.metadata({
+      method: props.modulo.getText(),
+      checker: props.context.checker,
+      transformer: props.context.transformer,
+      collection,
+      type: props.type,
+    });
 
     const callEncoder = (writer: string) => (factory: ts.NewExpression) =>
       StatementFactory.constant(

package/src/programmers/protobuf/ProtobufMessageProgrammer.ts

@@ -1,165 +1,168 @@
-import ts from "typescript";
-
-import { MetadataCollection } from "../../factories/MetadataCollection";
-import { ProtobufFactory } from "../../factories/ProtobufFactory";
-
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
-import { MetadataObject } from "../../schemas/metadata/MetadataObject";
-import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
-
-import { ITypiaContext } from "../../transformers/ITypiaContext";
-
-import { MapUtil } from "../../utils/MapUtil";
-import { NameEncoder } from "../../utils/NameEncoder";
-
-import { ProtobufUtil } from "../helpers/ProtobufUtil";
-
-export namespace ProtobufMessageProgrammer {
-  export interface IProps {
-    context: ITypiaContext;
-    type: ts.Type;
-  }
-  export const write = (props: IProps) => {
-    // PARSE TARGET TYPE
-    const collection: MetadataCollection = new MetadataCollection();
-    ProtobufFactory.metadata("message")(
-      props.context.checker,
-      props.context.transformer,
-    )(collection)(props.type);
-
-    // STRINGIFY
-    const hierarchies: Map<string, Hierarchy> = new Map();
-    for (const obj of collection.objects())
-      if (is_dynamic_object(obj) === false) emplace(hierarchies)(obj);
-
-    const content: string =
-      `syntax = "proto3";\n\n` +
-      [...hierarchies.values()]
-        .map((hier) => write_hierarchy(hier))
-        .join("\n\n");
-
-    // RETURNS
-    return ts.factory.createStringLiteral(content);
-  };
-
-  const emplace = (dict: Map<string, Hierarchy>) => (obj: MetadataObject) => {
-    const accessors: string[] = obj.name.split(".");
-    accessors.forEach((access, i) => {
-      const hierarchy: Hierarchy = MapUtil.take(dict)(access, () => ({
-        key: access,
-        object: null!,
-        children: new Map(),
-      }));
-      dict = hierarchy.children;
-      if (i === accessors.length - 1) hierarchy.object = obj;
-    });
-  };
-
-  const is_dynamic_object = (obj: MetadataObject): boolean =>
-    obj.properties.length === 1 &&
-    obj.properties[0]!.key.isSoleLiteral() === false;
-
-  const write_hierarchy = (hierarchy: Hierarchy): string => {
-    const elements: string[] = [
-      `message ${NameEncoder.encode(hierarchy.key)} {`,
-    ];
-    if (hierarchy.object !== null) {
-      const text: string = write_object(hierarchy.object);
-      elements.push(...text.split("\n").map((str) => `${TAB}${str}`));
-    }
-    if (hierarchy.children.size)
-      elements.push(
-        [...hierarchy.children.values()]
-          .map((child) => write_hierarchy(child))
-          .map((body) =>
-            body
-              .split("\n")
-              .map((line) => `${TAB}${line}`)
-              .join("\n"),
-          )
-          .join("\n\n"),
-      );
-    elements.push("}");
-    return elements.join("\n");
-  };
-
-  const write_object = (obj: MetadataObject): string => {
-    const ptr: IPointer<number> = { value: 0 };
-    return obj.properties
-      .map((prop) => {
-        const key: string = prop.key.getSoleLiteral()!;
-        const type: string = decode(ptr)(prop.value);
-        return type.indexOf("${name}") !== -1
-          ? type.replace("${name}", key)
-          : `${
-              prop.value.arrays.length || type.startsWith("map<")
-                ? ""
-                : !prop.value.isRequired() || prop.value.nullable
-                  ? "optional "
-                  : "required "
-            }${type} ${key} = ${++ptr.value};`;
-      })
-      .join("\n");
-  };
-
-  /* -----------------------------------------------------------
-        DECODERS
-    ----------------------------------------------------------- */
-  const decode =
-    (ptr: IPointer<number>) =>
-    (meta: Metadata): string => {
-      const elements: Set<string> = new Set();
-      if (meta.natives.length) elements.add("bytes");
-      for (const atomic of ProtobufUtil.getAtomics(meta)) elements.add(atomic);
-      for (const array of meta.arrays)
-        elements.add(`repeated ${decode(ptr)(array.type.value)}`);
-      for (const obj of meta.objects)
-        elements.add(
-          is_dynamic_object(obj)
-            ? decode_map(ptr)(
-                MetadataProperty.create({
-                  ...obj.properties[0]!,
-                  key: (() => {
-                    const key: Metadata = Metadata.initialize();
-                    key.atomics.push(
-                      MetadataAtomic.create({
-                        type: "string",
-                        tags: [],
-                      }),
-                    );
-                    return key;
-                  })(),
-                }),
-              )
-            : NameEncoder.encode(obj.name),
-        );
-      for (const map of meta.maps) elements.add(decode_map(ptr)(map));
-      return elements.size === 1
-        ? [...elements][0]!
-        : [
-            "oneof ${name} {",
-            ...[...elements].map(
-              (str) => `${TAB}${str} v${ptr.value + 1} = ${++ptr.value};`,
-            ),
-            "}",
-          ].join("\n");
-    };
-
-  const decode_map =
-    (ptr: IPointer<number>) =>
-    (prop: Metadata.Entry): string =>
-      `map<${decode(ptr)(prop.key)}, ${decode(ptr)(prop.value)}>`;
-}
-
-interface Hierarchy {
-  key: string;
-  object: MetadataObject | null;
-  children: Map<string, Hierarchy>;
-}
-
-interface IPointer<T> {
-  value: T;
-}
-
-const TAB = " ".repeat(2);
+import ts from "typescript";
+
+import { MetadataCollection } from "../../factories/MetadataCollection";
+import { ProtobufFactory } from "../../factories/ProtobufFactory";
+
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
+import { MetadataObject } from "../../schemas/metadata/MetadataObject";
+import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
+
+import { ITypiaContext } from "../../transformers/ITypiaContext";
+
+import { MapUtil } from "../../utils/MapUtil";
+import { NameEncoder } from "../../utils/NameEncoder";
+
+import { ProtobufUtil } from "../helpers/ProtobufUtil";
+
+export namespace ProtobufMessageProgrammer {
+  export interface IProps {
+    context: ITypiaContext;
+    type: ts.Type;
+  }
+  export const write = (props: IProps) => {
+    // PARSE TARGET TYPE
+    const collection: MetadataCollection = new MetadataCollection();
+    ProtobufFactory.metadata({
+      method: "message",
+      checker: props.context.checker,
+      transformer: props.context.transformer,
+      collection,
+      type: props.type,
+    });
+
+    // STRINGIFY
+    const hierarchies: Map<string, Hierarchy> = new Map();
+    for (const obj of collection.objects())
+      if (is_dynamic_object(obj) === false) emplace(hierarchies)(obj);
+
+    const content: string =
+      `syntax = "proto3";\n\n` +
+      [...hierarchies.values()]
+        .map((hier) => write_hierarchy(hier))
+        .join("\n\n");
+
+    // RETURNS
+    return ts.factory.createStringLiteral(content);
+  };
+
+  const emplace = (dict: Map<string, Hierarchy>) => (obj: MetadataObject) => {
+    const accessors: string[] = obj.name.split(".");
+    accessors.forEach((access, i) => {
+      const hierarchy: Hierarchy = MapUtil.take(dict)(access, () => ({
+        key: access,
+        object: null!,
+        children: new Map(),
+      }));
+      dict = hierarchy.children;
+      if (i === accessors.length - 1) hierarchy.object = obj;
+    });
+  };
+
+  const is_dynamic_object = (obj: MetadataObject): boolean =>
+    obj.properties.length === 1 &&
+    obj.properties[0]!.key.isSoleLiteral() === false;
+
+  const write_hierarchy = (hierarchy: Hierarchy): string => {
+    const elements: string[] = [
+      `message ${NameEncoder.encode(hierarchy.key)} {`,
+    ];
+    if (hierarchy.object !== null) {
+      const text: string = write_object(hierarchy.object);
+      elements.push(...text.split("\n").map((str) => `${TAB}${str}`));
+    }
+    if (hierarchy.children.size)
+      elements.push(
+        [...hierarchy.children.values()]
+          .map((child) => write_hierarchy(child))
+          .map((body) =>
+            body
+              .split("\n")
+              .map((line) => `${TAB}${line}`)
+              .join("\n"),
+          )
+          .join("\n\n"),
+      );
+    elements.push("}");
+    return elements.join("\n");
+  };
+
+  const write_object = (obj: MetadataObject): string => {
+    const ptr: IPointer<number> = { value: 0 };
+    return obj.properties
+      .map((prop) => {
+        const key: string = prop.key.getSoleLiteral()!;
+        const type: string = decode(ptr)(prop.value);
+        return type.indexOf("${name}") !== -1
+          ? type.replace("${name}", key)
+          : `${
+              prop.value.arrays.length || type.startsWith("map<")
+                ? ""
+                : !prop.value.isRequired() || prop.value.nullable
+                  ? "optional "
+                  : "required "
+            }${type} ${key} = ${++ptr.value};`;
+      })
+      .join("\n");
+  };
+
+  /* -----------------------------------------------------------
+        DECODERS
+    ----------------------------------------------------------- */
+  const decode =
+    (ptr: IPointer<number>) =>
+    (meta: Metadata): string => {
+      const elements: Set<string> = new Set();
+      if (meta.natives.length) elements.add("bytes");
+      for (const atomic of ProtobufUtil.getAtomics(meta)) elements.add(atomic);
+      for (const array of meta.arrays)
+        elements.add(`repeated ${decode(ptr)(array.type.value)}`);
+      for (const obj of meta.objects)
+        elements.add(
+          is_dynamic_object(obj)
+            ? decode_map(ptr)(
+                MetadataProperty.create({
+                  ...obj.properties[0]!,
+                  key: (() => {
+                    const key: Metadata = Metadata.initialize();
+                    key.atomics.push(
+                      MetadataAtomic.create({
+                        type: "string",
+                        tags: [],
+                      }),
+                    );
+                    return key;
+                  })(),
+                }),
+              )
+            : NameEncoder.encode(obj.name),
+        );
+      for (const map of meta.maps) elements.add(decode_map(ptr)(map));
+      return elements.size === 1
+        ? [...elements][0]!
+        : [
+            "oneof ${name} {",
+            ...[...elements].map(
+              (str) => `${TAB}${str} v${ptr.value + 1} = ${++ptr.value};`,
+            ),
+            "}",
+          ].join("\n");
+    };
+
+  const decode_map =
+    (ptr: IPointer<number>) =>
+    (prop: Metadata.Entry): string =>
+      `map<${decode(ptr)(prop.key)}, ${decode(ptr)(prop.value)}>`;
+}
+
+interface Hierarchy {
+  key: string;
+  object: MetadataObject | null;
+  children: Map<string, Hierarchy>;
+}
+
+interface IPointer<T> {
+  value: T;
+}
+
+const TAB = " ".repeat(2);