typia 7.0.0-dev.20241005 → 7.0.0-dev.20241008

package/src/programmers/helpers/UnionPredicator.ts

@@ -1,77 +1,77 @@
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataObject } from "../../schemas/metadata/MetadataObject";
-import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
-
-import { ArrayUtil } from "../../utils/ArrayUtil";
-import { MapUtil } from "../../utils/MapUtil";
-
-export namespace UnionPredicator {
-  export interface ISpecialized {
-    index: number;
-    object: MetadataObject;
-    property: MetadataProperty;
-    neighbour: boolean;
-  }
-
-  export const object = (objects: MetadataObject[]): Array<ISpecialized> => {
-    // PROPERTY MATRIX
-    const matrix: Map<string, Array<MetadataProperty | null>> = new Map();
-    for (const obj of objects)
-      for (const prop of obj.properties) {
-        const key: string | null = prop.key.getSoleLiteral();
-        if (key !== null)
-          MapUtil.take(matrix, key, () =>
-            ArrayUtil.repeat(objects.length, () => null),
-          );
-      }
-    objects.forEach((obj, i) => {
-      for (const prop of obj.properties) {
-        const key: string | null = prop.key.getSoleLiteral();
-        if (key !== null) matrix.get(key)![i] = prop;
-      }
-    });
-
-    // EXPLORE SPECIALIZERS
-    const output: ISpecialized[] = [];
-    objects.forEach((obj, i) => {
-      const children: ISpecializedProperty[] = [];
-      obj.properties.forEach((prop) => {
-        // MUST BE REQUIRED
-        if (prop.value.isRequired() === false) return;
-        const key: string | null = prop.key.getSoleLiteral();
-        if (key === null) return;
-
-        // FIND NEIGHBORHOOD PROPERTIES
-        const neighbors: MetadataProperty[] = matrix
-          .get(key)!
-          .filter((oppo, k) => i !== k && oppo !== null) as MetadataProperty[];
-
-        // NO NEIGHBORHOOD
-        const unique: boolean =
-          neighbors.length === 0 ||
-          neighbors.every((n) => !Metadata.intersects(prop.value, n.value));
-        if (unique === true)
-          children.push({
-            property: prop,
-            neighbour: neighbors.length !== 0,
-          });
-      });
-      if (children.length === 0) return;
-
-      const top: ISpecializedProperty =
-        children.find((child) => child.property.value.isConstant()) ||
-        children[0]!;
-      output.push({
-        index: i,
-        object: obj,
-        ...top,
-      });
-    });
-    return output;
-  };
-}
-
-interface ISpecializedProperty {
-  property: MetadataProperty;
-  neighbour: boolean;
-}
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataObject } from "../../schemas/metadata/MetadataObject";
+import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
+
+import { ArrayUtil } from "../../utils/ArrayUtil";
+import { MapUtil } from "../../utils/MapUtil";
+
+export namespace UnionPredicator {
+  export interface ISpecialized {
+    index: number;
+    object: MetadataObject;
+    property: MetadataProperty;
+    neighbour: boolean;
+  }
+
+  export const object = (objects: MetadataObject[]): Array<ISpecialized> => {
+    // PROPERTY MATRIX
+    const matrix: Map<string, Array<MetadataProperty | null>> = new Map();
+    for (const obj of objects)
+      for (const prop of obj.properties) {
+        const key: string | null = prop.key.getSoleLiteral();
+        if (key !== null)
+          MapUtil.take(matrix, key, () =>
+            ArrayUtil.repeat(objects.length, () => null),
+          );
+      }
+    objects.forEach((obj, i) => {
+      for (const prop of obj.properties) {
+        const key: string | null = prop.key.getSoleLiteral();
+        if (key !== null) matrix.get(key)![i] = prop;
+      }
+    });
+
+    // EXPLORE SPECIALIZERS
+    const output: ISpecialized[] = [];
+    objects.forEach((obj, i) => {
+      const children: ISpecializedProperty[] = [];
+      obj.properties.forEach((prop) => {
+        // MUST BE REQUIRED
+        if (prop.value.isRequired() === false) return;
+        const key: string | null = prop.key.getSoleLiteral();
+        if (key === null) return;
+
+        // FIND NEIGHBORHOOD PROPERTIES
+        const neighbors: MetadataProperty[] = matrix
+          .get(key)!
+          .filter((oppo, k) => i !== k && oppo !== null) as MetadataProperty[];
+
+        // NO NEIGHBORHOOD
+        const unique: boolean =
+          neighbors.length === 0 ||
+          neighbors.every((n) => !Metadata.intersects(prop.value, n.value));
+        if (unique === true)
+          children.push({
+            property: prop,
+            neighbour: neighbors.length !== 0,
+          });
+      });
+      if (children.length === 0) return;
+
+      const top: ISpecializedProperty =
+        children.find((child) => child.property.value.isConstant()) ||
+        children[0]!;
+      output.push({
+        index: i,
+        object: obj,
+        ...top,
+      });
+    });
+    return output;
+  };
+}
+
+interface ISpecializedProperty {
+  property: MetadataProperty;
+  neighbour: boolean;
+}

package/src/programmers/helpers/disable_function_programmer_declare.ts

@@ -10,11 +10,9 @@ const disable = (
   functor: FunctionProgrammer,
 ): MethodOnly<FunctionProgrammer> => ({
   method: functor.method,
-  empty: (): boolean => functor.empty(),
-  use: (name: string): ts.Identifier => functor.use(name),
   useLocal: (name: string): string => functor.useLocal(name),
   hasLocal: (name: string): boolean => functor.hasLocal(name),
-  declare: (_modulo: ts.LeftHandSideExpression): ts.Statement[] => [],
+  declare: (): ts.Statement[] => [],
   declareUnions: (): ts.Statement[] => [],
   increment: (): number => functor.increment(),
   emplaceUnion: (
@@ -23,7 +21,6 @@ const disable = (
     factory: () => ts.ArrowFunction,
   ): string => functor.emplaceUnion(prefix, name, factory),
   emplaceVariable: (key, value) => functor.emplaceVariable(key, value),
-  trace: (): void => functor.trace(),
 });
 
 type MethodOnly<T> = {

package/src/programmers/http/HttpAssertFormDataProgrammer.ts

@@ -59,7 +59,10 @@ export namespace HttpAssertFormDataProgrammer {
         undefined,
         [
           IdentifierFactory.parameter("input", TypeFactory.keyword("any")),
-          AssertProgrammer.Guardian.parameter(props.init),
+          AssertProgrammer.Guardian.parameter({
+            context: props.context,
+            init: props.init,
+          }),
         ],
         decode.arrow.type,
         undefined,

package/src/programmers/http/HttpAssertHeadersProgrammer.ts

@@ -59,7 +59,10 @@ export namespace HttpAssertHeadersProgrammer {
         undefined,
         [
           IdentifierFactory.parameter("input", TypeFactory.keyword("any")),
-          AssertProgrammer.Guardian.parameter(props.init),
+          AssertProgrammer.Guardian.parameter({
+            context: props.context,
+            init: props.init,
+          }),
         ],
         decode.arrow.type,
         undefined,

package/src/programmers/http/HttpAssertQueryProgrammer.ts

@@ -64,7 +64,10 @@ export namespace HttpAssertQueryProgrammer {
         undefined,
         [
           IdentifierFactory.parameter("input", TypeFactory.keyword("any")),
-          AssertProgrammer.Guardian.parameter(props.init),
+          AssertProgrammer.Guardian.parameter({
+            context: props.context,
+            init: props.init,
+          }),
         ],
         decode.arrow.type,
         undefined,

package/src/programmers/http/HttpFormDataProgrammer.ts

@@ -69,13 +69,10 @@ export namespace HttpFormDataProgrammer {
             ts.factory.createTypeReferenceNode("FormData"),
           ),
         ],
-        ts.factory.createImportTypeNode(
-          ts.factory.createLiteralTypeNode(
-            ts.factory.createStringLiteral("typia"),
-          ),
-          undefined,
-          ts.factory.createIdentifier("Resolved"),
-          [
+        props.context.importer.type({
+          file: "typia",
+          name: "Resolved",
+          arguments: [
             ts.factory.createTypeReferenceNode(
               props.name ??
                 TypeFactory.getFullName({
@@ -84,8 +81,7 @@ export namespace HttpFormDataProgrammer {
                 }),
             ),
           ],
-          false,
-        ),
+        }),
         undefined,
         ts.factory.createBlock(statements, true),
       ),

package/src/programmers/http/HttpHeadersProgrammer.ts

@@ -73,13 +73,10 @@ export namespace HttpHeadersProgrammer {
             ts.factory.createTypeReferenceNode(INPUT_TYPE),
           ),
         ],
-        ts.factory.createImportTypeNode(
-          ts.factory.createLiteralTypeNode(
-            ts.factory.createStringLiteral("typia"),
-          ),
-          undefined,
-          ts.factory.createIdentifier("Resolved"),
-          [
+        props.context.importer.type({
+          file: "typia",
+          name: "Resolved",
+          arguments: [
             ts.factory.createTypeReferenceNode(
               props.name ??
                 TypeFactory.getFullName({
@@ -88,8 +85,7 @@ export namespace HttpHeadersProgrammer {
                 }),
             ),
           ],
-          false,
-        ),
+        }),
         undefined,
         ts.factory.createBlock(statements, true),
       ),

package/src/programmers/http/HttpQueryProgrammer.ts

@@ -77,13 +77,10 @@ export namespace HttpQueryProgrammer {
             ts.factory.createTypeReferenceNode(INPUT_TYPE),
           ),
         ],
-        ts.factory.createImportTypeNode(
-          ts.factory.createLiteralTypeNode(
-            ts.factory.createStringLiteral("typia"),
-          ),
-          undefined,
-          ts.factory.createIdentifier("Resolved"),
-          [
+        props.context.importer.type({
+          file: "typia",
+          name: "Resolved",
+          arguments: [
             ts.factory.createTypeReferenceNode(
               props.name ??
                 TypeFactory.getFullName({
@@ -92,8 +89,7 @@ export namespace HttpQueryProgrammer {
                 }),
             ),
           ],
-          false,
-        ),
+        }),
         undefined,
         ts.factory.createBlock(statements, true),
       ),

package/src/programmers/http/HttpValidateFormDataProgrammer.ts

@@ -54,9 +54,11 @@ export namespace HttpValidateFormDataProgrammer {
         undefined,
         undefined,
         decode.arrow.parameters,
-        ts.factory.createTypeReferenceNode("typia.IValidation", [
-          decode.arrow.type ?? TypeFactory.keyword("any"),
-        ]),
+        props.context.importer.type({
+          file: "typia",
+          name: "IValidation",
+          arguments: [decode.arrow.type ?? TypeFactory.keyword("any")],
+        }),
         undefined,
         ts.factory.createCallExpression(
           ts.factory.createIdentifier("__validate"),

package/src/programmers/http/HttpValidateHeadersProgrammer.ts

@@ -54,9 +54,11 @@ export namespace HttpValidateHeadersProgrammer {
         undefined,
         undefined,
         decode.arrow.parameters,
-        ts.factory.createTypeReferenceNode("typia.IValidation", [
-          decode.arrow.type ?? TypeFactory.keyword("any"),
-        ]),
+        props.context.importer.type({
+          file: "typia",
+          name: "IValidation",
+          arguments: [decode.arrow.type ?? TypeFactory.keyword("any")],
+        }),
         undefined,
         ts.factory.createCallExpression(
           ts.factory.createIdentifier("__validate"),

package/src/programmers/http/HttpValidateQueryProgrammer.ts

@@ -59,9 +59,11 @@ export namespace HttpValidateQueryProgrammer {
         undefined,
         undefined,
         decode.arrow.parameters,
-        ts.factory.createTypeReferenceNode("typia.IValidation", [
-          decode.arrow.type ?? TypeFactory.keyword("any"),
-        ]),
+        props.context.importer.type({
+          file: "typia",
+          name: "IValidation",
+          arguments: [decode.arrow.type ?? TypeFactory.keyword("any")],
+        }),
         undefined,
         ts.factory.createCallExpression(
           ts.factory.createIdentifier("__validate"),

package/src/programmers/internal/application_array.ts

@@ -1,56 +1,56 @@
-import { OpenApi, OpenApiV3 } from "@samchon/openapi";
-
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataArray } from "../../schemas/metadata/MetadataArray";
-
-import { application_plugin } from "./application_plugin";
-
-/**
- * @internal
- */
-export const application_array = <Version extends "3.0" | "3.1">(props: {
-  generator: (value: Metadata) => Schema<Version>;
-  components: Version extends "3.0"
-    ? OpenApiV3.IComponents
-    : OpenApi.IComponents;
-  array: MetadataArray;
-}): Array<ArraySchema<Version> | OpenApiV3.IJsonSchema.IReference> => {
-  const factory = (): ArraySchema<Version>[] =>
-    application_plugin<ArraySchema<Version>>({
-      schema: {
-        type: "array",
-        items: props.generator(props.array.type.value),
-      } as ArraySchema<Version>,
-      tags: props.array.tags,
-    });
-  if (props.array.type.recursive === true) {
-    const out = () => [{ $ref }];
-    const $ref: string = `#/components/schemas/${props.array.type.name}`;
-    if (props.components.schemas?.[$ref] !== undefined) return out();
-
-    props.components.schemas ??= {};
-    props.components.schemas[$ref] ??= {};
-
-    const oneOf: ArraySchema<Version>[] = factory();
-    Object.assign(
-      props.components.schemas[$ref]!,
-      oneOf.length === 1 ? oneOf[0] : { oneOf },
-    );
-    return out();
-  }
-  return factory();
-};
-
-/**
- * @internal
- */
-type ArraySchema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema.IArray
-  : OpenApi.IJsonSchema.IArray;
-
-/**
- * @internal
- */
-type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema
-  : OpenApi.IJsonSchema;
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataArray } from "../../schemas/metadata/MetadataArray";
+
+import { application_plugin } from "./application_plugin";
+
+/**
+ * @internal
+ */
+export const application_array = <Version extends "3.0" | "3.1">(props: {
+  generator: (value: Metadata) => Schema<Version>;
+  components: Version extends "3.0"
+    ? OpenApiV3.IComponents
+    : OpenApi.IComponents;
+  array: MetadataArray;
+}): Array<ArraySchema<Version> | OpenApiV3.IJsonSchema.IReference> => {
+  const factory = (): ArraySchema<Version>[] =>
+    application_plugin<ArraySchema<Version>>({
+      schema: {
+        type: "array",
+        items: props.generator(props.array.type.value),
+      } as ArraySchema<Version>,
+      tags: props.array.tags,
+    });
+  if (props.array.type.recursive === true) {
+    const out = () => [{ $ref }];
+    const $ref: string = `#/components/schemas/${props.array.type.name}`;
+    if (props.components.schemas?.[$ref] !== undefined) return out();
+
+    props.components.schemas ??= {};
+    props.components.schemas[$ref] ??= {};
+
+    const oneOf: ArraySchema<Version>[] = factory();
+    Object.assign(
+      props.components.schemas[$ref]!,
+      oneOf.length === 1 ? oneOf[0] : { oneOf },
+    );
+    return out();
+  }
+  return factory();
+};
+
+/**
+ * @internal
+ */
+type ArraySchema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema.IArray
+  : OpenApi.IJsonSchema.IArray;
+
+/**
+ * @internal
+ */
+type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema
+  : OpenApi.IJsonSchema;

package/src/programmers/internal/application_bigint.ts

@@ -1,25 +1,25 @@
-import { OpenApi, OpenApiV3 } from "@samchon/openapi";
-
-import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
-
-import { application_plugin } from "./application_plugin";
-
-/**
- * @internal
- */
-export const application_bigint = <Version extends "3.0" | "3.1">(
-  atomic: MetadataAtomic,
-): Schema<Version>[] =>
-  application_plugin({
-    schema: {
-      type: "integer",
-    } satisfies Schema<Version>,
-    tags: atomic.tags,
-  });
-
-/**
- * @internal
- */
-type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema.IInteger
-  : OpenApi.IJsonSchema.IInteger;
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
+
+import { application_plugin } from "./application_plugin";
+
+/**
+ * @internal
+ */
+export const application_bigint = <Version extends "3.0" | "3.1">(
+  atomic: MetadataAtomic,
+): Schema<Version>[] =>
+  application_plugin({
+    schema: {
+      type: "integer",
+    } satisfies Schema<Version>,
+    tags: atomic.tags,
+  });
+
+/**
+ * @internal
+ */
+type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema.IInteger
+  : OpenApi.IJsonSchema.IInteger;

package/src/programmers/internal/application_boolean.ts

@@ -1,25 +1,25 @@
-import { OpenApi, OpenApiV3 } from "@samchon/openapi";
-
-import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
-
-import { application_plugin } from "./application_plugin";
-
-/**
- * @internal
- */
-export const application_boolean = <Version extends "3.0" | "3.1">(
-  atomic: MetadataAtomic,
-): Schema<Version>[] =>
-  application_plugin({
-    schema: {
-      type: "boolean",
-    } satisfies Schema<Version>,
-    tags: atomic.tags,
-  });
-
-/**
- * @internal
- */
-type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema.IBoolean
-  : OpenApi.IJsonSchema.IBoolean;
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
+
+import { application_plugin } from "./application_plugin";
+
+/**
+ * @internal
+ */
+export const application_boolean = <Version extends "3.0" | "3.1">(
+  atomic: MetadataAtomic,
+): Schema<Version>[] =>
+  application_plugin({
+    schema: {
+      type: "boolean",
+    } satisfies Schema<Version>,
+    tags: atomic.tags,
+  });
+
+/**
+ * @internal
+ */
+type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema.IBoolean
+  : OpenApi.IJsonSchema.IBoolean;

package/src/programmers/internal/application_description.ts

@@ -1,12 +1,12 @@
-import { IJsDocTagInfo } from "../../module";
-
-export const application_description = (props: {
-  description?: string | null | undefined;
-  jsDocTags?: IJsDocTagInfo[];
-}): string | undefined =>
-  props.jsDocTags
-    ?.find((tag) => tag.name === "description")
-    ?.text?.[0]?.text?.split("\r\n")
-    .join("\n") ??
-  props.description ??
-  undefined;
+import { IJsDocTagInfo } from "../../module";
+
+export const application_description = (props: {
+  description?: string | null | undefined;
+  jsDocTags?: IJsDocTagInfo[];
+}): string | undefined =>
+  props.jsDocTags
+    ?.find((tag) => tag.name === "description")
+    ?.text?.[0]?.text?.split("\r\n")
+    .join("\n") ??
+  props.description ??
+  undefined;