typia 7.0.0-dev.20241012 → 7.0.0-dev.20241018

package/src/programmers/internal/application_escaped.ts

@@ -61,7 +61,7 @@ const is_date = (props: {
   props.visited.add(props.metadata);
 
   return (
-    props.metadata.natives.some((name) => name === "Date") ||
+    props.metadata.natives.some((native) => native.name === "Date") ||
     props.metadata.arrays.some((array) =>
       is_date({
         visited: props.visited,
@@ -79,7 +79,7 @@ const is_date = (props: {
     props.metadata.aliases.some((alias) =>
       is_date({
         visited: props.visited,
-        metadata: alias.value,
+        metadata: alias.type.value,
       }),
     )
   );

package/src/programmers/internal/application_v30_alias.ts

@@ -6,6 +6,7 @@ import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
 import { MetadataAlias } from "../../schemas/metadata/MetadataAlias";
 
 import { application_description } from "./application_description";
+import { application_plugin } from "./application_plugin";
 import { application_v30_object } from "./application_v30_object";
 import { application_v30_schema } from "./application_v30_schema";
 
@@ -17,15 +18,18 @@ export const application_v30_alias = <BlockNever extends boolean>(props: {
   components: OpenApiV3.IComponents;
   alias: MetadataAlias;
   nullable: boolean;
-}): OpenApiV3.IJsonSchema.IReference => {
-  if (props.alias.value.size() === 1 && props.alias.value.objects.length === 1)
+}): OpenApiV3.IJsonSchema.IReference[] => {
+  if (
+    props.alias.type.value.size() === 1 &&
+    props.alias.type.value.objects.length === 1
+  )
     return application_v30_object({
-      object: props.alias.value.objects[0]!.type,
+      object: props.alias.type.value.objects[0]!,
       components: props.components,
       nullable: props.nullable,
-    }) as OpenApiV3.IJsonSchema.IReference;
+    }) as OpenApiV3.IJsonSchema.IReference[];
 
-  const key: string = `${props.alias.name}${props.nullable ? ".Nullable" : ""}`;
+  const key: string = `${props.alias.type.name}${props.nullable ? ".Nullable" : ""}`;
   const $ref: string = `#/components/schemas/${key}`;
 
   if (props.components.schemas?.[key] === undefined) {
@@ -39,21 +43,23 @@ export const application_v30_alias = <BlockNever extends boolean>(props: {
       components: props.components,
       attribute: {
         deprecated:
-          props.alias.jsDocTags.some((tag) => tag.name === "deprecated") ||
+          props.alias.type.jsDocTags.some((tag) => tag.name === "deprecated") ||
           undefined,
         title: (() => {
-          const info: IJsDocTagInfo | undefined = props.alias.jsDocTags.find(
-            (tag) => tag.name === "title",
-          );
+          const info: IJsDocTagInfo | undefined =
+            props.alias.type.jsDocTags.find((tag) => tag.name === "title");
           return info?.text?.length
             ? CommentFactory.merge(info.text)
             : undefined;
         })(),
-        description: application_description(props.alias),
+        description: application_description(props.alias.type),
       },
-      metadata: props.alias.value,
+      metadata: props.alias.type.value,
     });
     if (schema !== null) Object.assign(props.components.schemas[key]!, schema);
   }
-  return { $ref };
+  return application_plugin({
+    schema: { $ref },
+    tags: props.alias.tags,
+  });
 };

package/src/programmers/internal/application_v30_native.ts

@@ -1,20 +1,27 @@
 import { OpenApiV3 } from "@samchon/openapi";
 
+import { MetadataNative } from "../../schemas/metadata/MetadataNative";
+
+import { application_plugin } from "./application_plugin";
+
 /**
  * @internal
  */
 export const application_v30_native = (props: {
   components: OpenApiV3.IComponents;
-  name: string;
+  native: MetadataNative;
   nullable: boolean;
-}): OpenApiV3.IJsonSchema => {
-  if (props.name === "Blob" || props.name === "File")
-    return {
-      type: "string",
-      format: "binary",
-      nullable: props.nullable,
-    };
-  const key: string = `${props.name}${props.nullable ? ".Nullable" : ""}`;
+}): OpenApiV3.IJsonSchema[] => {
+  if (props.native.name === "Blob" || props.native.name === "File")
+    return application_plugin({
+      schema: {
+        type: "string",
+        format: "binary",
+        nullable: props.nullable,
+      },
+      tags: props.native.tags,
+    });
+  const key: string = `${props.native.name}${props.nullable ? ".Nullable" : ""}`;
   if (props.components.schemas?.[key] === undefined) {
     props.components.schemas ??= {};
     props.components.schemas[key] ??= {
@@ -23,7 +30,10 @@ export const application_v30_native = (props: {
       nullable: props.nullable,
     };
   }
-  return {
-    $ref: `#/components/schemas/${key}`,
-  };
+  return application_plugin({
+    schema: {
+      $ref: `#/components/schemas/${key}`,
+    },
+    tags: props.native.tags,
+  });
 };

package/src/programmers/internal/application_v30_object.ts

@@ -4,11 +4,12 @@ import { CommentFactory } from "../../factories/CommentFactory";
 
 import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
 import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
+import { MetadataObject } from "../../schemas/metadata/MetadataObject";
 
 import { PatternUtil } from "../../utils/PatternUtil";
 
 import { application_description } from "./application_description";
+import { application_plugin } from "./application_plugin";
 import { application_v30_schema } from "./application_v30_schema";
 import { metadata_to_pattern } from "./metadata_to_pattern";
 
@@ -17,12 +18,26 @@ import { metadata_to_pattern } from "./metadata_to_pattern";
  */
 export const application_v30_object = (props: {
   components: OpenApiV3.IComponents;
-  object: MetadataObjectType;
+  object: MetadataObject;
+  nullable: boolean;
+}): Array<OpenApiV3.IJsonSchema.IReference | OpenApiV3.IJsonSchema.IObject> =>
+  application_plugin({
+    schema: emplace_object(props),
+    tags: props.object.tags,
+  });
+
+/**
+ * @internal
+ */
+const emplace_object = (props: {
+  components: OpenApiV3.IComponents;
+  object: MetadataObject;
   nullable: boolean;
 }): OpenApiV3.IJsonSchema.IReference | OpenApiV3.IJsonSchema.IObject => {
-  if (props.object.isLiteral() === true) return create_object_schema(props);
+  if (props.object.type.isLiteral() === true)
+    return create_object_schema(props);
 
-  const key: string = `${props.object.name}${props.nullable ? ".Nullable" : ""}`;
+  const key: string = `${props.object.type.name}${props.nullable ? ".Nullable" : ""}`;
   const $ref: string = `#/components/schemas/${key}`;
   if (props.components.schemas?.[key] !== undefined) return { $ref };
 
@@ -38,7 +53,7 @@ export const application_v30_object = (props: {
  */
 const create_object_schema = (props: {
   components: OpenApiV3.IComponents;
-  object: MetadataObjectType;
+  object: MetadataObject;
   nullable: boolean;
 }): OpenApiV3.IJsonSchema.IObject => {
   // ITERATE PROPERTIES
@@ -49,7 +64,7 @@ const create_object_schema = (props: {
   };
   const required: string[] = [];
 
-  for (const property of props.object.properties) {
+  for (const property of props.object.type.properties) {
     if (
       // FUNCTIONAL TYPE
       property.value.functions.length &&
@@ -111,12 +126,12 @@ const create_object_schema = (props: {
     nullable: props.nullable,
     required: required.length ? required : undefined,
     title: (() => {
-      const info: IJsDocTagInfo | undefined = props.object.jsDocTags.find(
+      const info: IJsDocTagInfo | undefined = props.object.type.jsDocTags.find(
         (tag) => tag.name === "title",
       );
       return info?.text?.length ? CommentFactory.merge(info.text) : undefined;
     })(),
-    description: application_description(props.object),
+    description: application_description(props.object.type),
     additionalProperties: join({
       components: props.components,
       extra: extraMeta,

package/src/programmers/internal/application_v30_schema.ts

@@ -2,6 +2,7 @@ import { OpenApiV3 } from "@samchon/openapi";
 
 import { Metadata } from "../../schemas/metadata/Metadata";
 import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
+import { MetadataNative } from "../../schemas/metadata/MetadataNative";
 
 import { AtomicPredicator } from "../helpers/AtomicPredicator";
 import { application_array } from "./application_array";
@@ -70,7 +71,7 @@ export const application_v30_schema = <BlockNever extends boolean>(props: {
     props.metadata.templates.length &&
     AtomicPredicator.template(props.metadata)
   )
-    application_templates(props.metadata).map(insert);
+    application_templates(props.metadata).forEach(insert);
   for (const constant of props.metadata.constants)
     if (
       AtomicPredicator.constant({
@@ -112,8 +113,8 @@ export const application_v30_schema = <BlockNever extends boolean>(props: {
 
   // NATIVES
   for (const native of props.metadata.natives)
-    if (AtomicPredicator.native(native)) {
-      const type: string = native.toLowerCase();
+    if (AtomicPredicator.native(native.name)) {
+      const type: string = native.name.toLowerCase();
       if (props.metadata.atomics.some((a) => a.type === type)) continue;
       else if (type === "boolean")
         insert(
@@ -152,50 +153,46 @@ export const application_v30_schema = <BlockNever extends boolean>(props: {
           )[0]!,
         );
     } else
-      insert(
-        application_v30_native({
-          name: native,
-          components: props.components,
-          nullable: props.metadata.nullable,
-        }),
-      );
-  if (props.metadata.sets.length)
-    insert(
       application_v30_native({
-        name: "Set",
+        native,
         components: props.components,
         nullable: props.metadata.nullable,
+      }).forEach(insert);
+  if (props.metadata.sets.length)
+    application_v30_native({
+      native: MetadataNative.create({
+        name: "Set",
+        tags: [],
       }),
-    );
+      components: props.components,
+      nullable: props.metadata.nullable,
+    }).forEach(insert);
   if (props.metadata.maps.length)
-    insert(
-      application_v30_native({
+    application_v30_native({
+      native: MetadataNative.create({
         name: "Map",
-        components: props.components,
-        nullable: props.metadata.nullable,
+        tags: [],
       }),
-    );
+      components: props.components,
+      nullable: props.metadata.nullable,
+    }).forEach(insert);
 
   // OBJECT
   for (const object of props.metadata.objects)
-    insert(
-      application_v30_object({
-        object: object.type,
-        components: props.components,
-        nullable: props.metadata.nullable,
-      }),
-    );
+    application_v30_object({
+      object,
+      components: props.components,
+      nullable: props.metadata.nullable,
+    }).forEach(insert);
 
   // ALIASES
   for (const alias of props.metadata.aliases)
-    insert(
-      application_v30_alias({
-        alias,
-        blockNever: props.blockNever,
-        components: props.components,
-        nullable: props.metadata.nullable,
-      }),
-    );
+    application_v30_alias({
+      alias,
+      blockNever: props.blockNever,
+      components: props.components,
+      nullable: props.metadata.nullable,
+    }).forEach(insert);
 
   //----
   // RETURNS

package/src/programmers/internal/application_v31_alias.ts

@@ -14,18 +14,21 @@ export const application_v31_alias = <BlockNever extends boolean>(props: {
   blockNever: BlockNever;
   components: OpenApi.IComponents;
   alias: MetadataAlias;
-}): OpenApi.IJsonSchema.IReference => {
-  if (props.alias.value.size() === 1 && props.alias.value.objects.length === 1)
+}): OpenApi.IJsonSchema.IReference[] => {
+  if (
+    props.alias.type.value.size() === 1 &&
+    props.alias.type.value.objects.length === 1
+  )
     return application_v31_object({
       components: props.components,
-      object: props.alias.value.objects[0]!.type,
-    }) as OpenApi.IJsonSchema.IReference;
+      object: props.alias.type.value.objects[0]!,
+    }) as OpenApi.IJsonSchema.IReference[];
 
-  const $ref: string = `#/components/schemas/${props.alias.name}`;
-  if (props.components.schemas?.[props.alias.name] === undefined) {
+  const $ref: string = `#/components/schemas/${props.alias.type.name}`;
+  if (props.components.schemas?.[props.alias.type.name] === undefined) {
     // TEMPORARY ASSIGNMENT
     props.components.schemas ??= {};
-    props.components.schemas[props.alias.name] = {};
+    props.components.schemas[props.alias.type.name] = {};
 
     // GENERATE SCHEMA
     const schema: OpenApi.IJsonSchema | null = application_v31_schema({
@@ -33,15 +36,15 @@ export const application_v31_alias = <BlockNever extends boolean>(props: {
       components: props.components,
       attribute: {
         deprecated:
-          props.alias.jsDocTags.some((tag) => tag.name === "deprecated") ||
+          props.alias.type.jsDocTags.some((tag) => tag.name === "deprecated") ||
           undefined,
-        title: application_title(props.alias),
-        description: application_description(props.alias),
+        title: application_title(props.alias.type),
+        description: application_description(props.alias.type),
       },
-      metadata: props.alias.value,
+      metadata: props.alias.type.value,
     });
     if (schema !== null)
-      Object.assign(props.components.schemas[props.alias.name]!, schema);
+      Object.assign(props.components.schemas[props.alias.type.name]!, schema);
   }
-  return { $ref };
+  return [{ $ref }];
 };

package/src/programmers/internal/application_v31_native.ts

@@ -1,25 +1,35 @@
 import { OpenApi } from "@samchon/openapi";
 
+import { MetadataNative } from "../../schemas/metadata/MetadataNative";
+
+import { application_plugin } from "./application_plugin";
+
 /**
  * @internal
  */
 export const application_v31_native = (props: {
   components: OpenApi.IComponents;
-  name: string;
-}): OpenApi.IJsonSchema => {
-  if (props.name === "Blob" || props.name === "File")
-    return {
-      type: "string",
-      format: "binary",
-    };
-  if (props.components.schemas?.[props.name] === undefined) {
+  native: MetadataNative;
+}): OpenApi.IJsonSchema[] => {
+  if (props.native.name === "Blob" || props.native.name === "File")
+    return application_plugin({
+      schema: {
+        type: "string",
+        format: "binary",
+      },
+      tags: props.native.tags,
+    });
+  if (props.components.schemas?.[props.native.name] === undefined) {
     props.components.schemas ??= {};
-    props.components.schemas[props.name] ??= {
+    props.components.schemas[props.native.name] ??= {
       type: "object",
       properties: {},
     };
   }
-  return {
-    $ref: `#/components/schemas/${props.name}`,
-  };
+  return application_plugin({
+    schema: {
+      $ref: `#/components/schemas/${props.native.name}`,
+    },
+    tags: props.native.tags,
+  });
 };

package/src/programmers/internal/application_v31_object.ts

@@ -4,11 +4,12 @@ import { CommentFactory } from "../../factories/CommentFactory";
 
 import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
 import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
+import { MetadataObject } from "../../schemas/metadata/MetadataObject";
 
 import { PatternUtil } from "../../utils/PatternUtil";
 
 import { application_description } from "./application_description";
+import { application_plugin } from "./application_plugin";
 import { application_title } from "./application_title";
 import { application_v31_schema } from "./application_v31_schema";
 import { metadata_to_pattern } from "./metadata_to_pattern";
@@ -18,11 +19,21 @@ import { metadata_to_pattern } from "./metadata_to_pattern";
  */
 export const application_v31_object = (props: {
   components: OpenApi.IComponents;
-  object: MetadataObjectType;
+  object: MetadataObject;
+}): Array<OpenApi.IJsonSchema.IReference | OpenApi.IJsonSchema.IObject> =>
+  application_plugin({
+    schema: emplace_object(props),
+    tags: props.object.tags,
+  });
+
+const emplace_object = (props: {
+  components: OpenApi.IComponents;
+  object: MetadataObject;
 }): OpenApi.IJsonSchema.IReference | OpenApi.IJsonSchema.IObject => {
-  if (props.object.isLiteral() === true) return create_object_schema(props);
+  if (props.object.type.isLiteral() === true)
+    return create_object_schema(props);
 
-  const key: string = props.object.name;
+  const key: string = props.object.type.name;
   const $ref: string = `#/components/schemas/${key}`;
   if (props.components.schemas?.[key] !== undefined) return { $ref };
 
@@ -38,7 +49,7 @@ export const application_v31_object = (props: {
  */
 const create_object_schema = (props: {
   components: OpenApi.IComponents;
-  object: MetadataObjectType;
+  object: MetadataObject;
 }): OpenApi.IJsonSchema.IObject => {
   // ITERATE PROPERTIES
   const properties: Record<string, any> = {};
@@ -48,7 +59,7 @@ const create_object_schema = (props: {
   };
   const required: string[] = [];
 
-  for (const property of props.object.properties) {
+  for (const property of props.object.type.properties) {
     if (
       // FUNCTIONAL TYPE
       property.value.functions.length &&
@@ -93,12 +104,12 @@ const create_object_schema = (props: {
     properties,
     required: required.length ? required : undefined,
     title: (() => {
-      const info: IJsDocTagInfo | undefined = props.object.jsDocTags.find(
+      const info: IJsDocTagInfo | undefined = props.object.type.jsDocTags.find(
         (tag) => tag.name === "title",
       );
       return info?.text?.length ? CommentFactory.merge(info.text) : undefined;
     })(),
-    description: application_description(props.object),
+    description: application_description(props.object.type),
     additionalProperties: join({
       components: props.components,
       extra: extraMeta,

package/src/programmers/internal/application_v31_schema.ts

@@ -2,6 +2,7 @@ import { OpenApi } from "@samchon/openapi";
 
 import { Metadata } from "../../schemas/metadata/Metadata";
 import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
+import { MetadataNative } from "../../schemas/metadata/MetadataNative";
 
 import { AtomicPredicator } from "../helpers/AtomicPredicator";
 import { application_array } from "./application_array";
@@ -112,8 +113,8 @@ export const application_v31_schema = <BlockNever extends boolean>(props: {
 
   // NATIVES
   for (const native of props.metadata.natives)
-    if (AtomicPredicator.native(native)) {
-      const type: string = native.toLowerCase();
+    if (AtomicPredicator.native(native.name)) {
+      const type: string = native.name.toLowerCase();
       if (props.metadata.atomics.some((a) => a.type === type)) continue;
       else if (type === "boolean")
         insert(
@@ -152,45 +153,41 @@ export const application_v31_schema = <BlockNever extends boolean>(props: {
           )[0]! as any,
         );
     } else
-      insert(
-        application_v31_native({
-          components: props.components,
-          name: native,
-        }),
-      );
-  if (props.metadata.sets.length)
-    insert(
       application_v31_native({
-        name: "Set",
         components: props.components,
+        native,
+      }).forEach(insert);
+  if (props.metadata.sets.length)
+    application_v31_native({
+      native: MetadataNative.create({
+        name: "Set",
+        tags: [],
       }),
-    );
+      components: props.components,
+    }).forEach(insert);
   if (props.metadata.maps.length)
-    insert(
-      application_v31_native({
+    application_v31_native({
+      native: MetadataNative.create({
         name: "Map",
-        components: props.components,
+        tags: [],
       }),
-    );
+      components: props.components,
+    }).forEach(insert);
 
   // OBJECT
   for (const object of props.metadata.objects)
-    insert(
-      application_v31_object({
-        components: props.components,
-        object: object.type,
-      }),
-    );
+    application_v31_object({
+      components: props.components,
+      object,
+    }).forEach(insert);
 
   // ALIASES
   for (const alias of props.metadata.aliases)
-    insert(
-      application_v31_alias({
-        alias,
-        blockNever: props.blockNever,
-        components: props.components,
-      }),
-    );
+    application_v31_alias({
+      alias,
+      blockNever: props.blockNever,
+      components: props.components,
+    }).forEach(insert);
 
   //----
   // RETURNS

package/src/programmers/internal/check_dynamic_key.ts

@@ -28,7 +28,7 @@ export const check_dynamic_key = (props: {
             .length === 0,
       )) ||
     (props.metadata.natives.length !== 0 &&
-      props.metadata.natives.some((type) => type === "String"))
+      props.metadata.natives.some((native) => native.name === "String"))
   )
     return ts.factory.createTrue();
 
@@ -135,7 +135,7 @@ export const check_dynamic_key = (props: {
 
   // NATIVES
   for (const native of props.metadata.natives)
-    if (native === "Boolean")
+    if (native.name === "Boolean")
       conditions.push(
         ts.factory.createLogicalOr(
           ts.factory.createStrictEquality(
@@ -148,7 +148,7 @@ export const check_dynamic_key = (props: {
           ),
         ),
       );
-    else if (native === "BigInt")
+    else if (native.name === "BigInt")
       conditions.push(
         ts.factory.createCallExpression(
           props.context.importer.internal("isBigintString"),
@@ -156,7 +156,7 @@ export const check_dynamic_key = (props: {
           [props.input],
         ),
       );
-    else if (native === "Number")
+    else if (native.name === "Number")
       conditions.push(
         ts.factory.createStrictEquality(
           ts.factory.createFalse(),

package/src/programmers/internal/check_native.ts

@@ -6,14 +6,14 @@ import { ExpressionFactory } from "../../factories/ExpressionFactory";
  * @internal
  */
 export const check_native = (props: {
-  type: string;
+  name: string;
   input: ts.Expression;
 }): ts.Expression => {
-  const instanceOf = ExpressionFactory.isInstanceOf(props.type, props.input);
-  return ATOMIC_LIKE.has(props.type)
+  const instanceOf = ExpressionFactory.isInstanceOf(props.name, props.input);
+  return ATOMIC_LIKE.has(props.name)
     ? ts.factory.createLogicalOr(
         ts.factory.createStrictEquality(
-          ts.factory.createStringLiteral(props.type.toLowerCase()),
+          ts.factory.createStringLiteral(props.name.toLowerCase()),
           ts.factory.createTypeOfExpression(props.input),
         ),
         instanceOf,

package/src/programmers/internal/check_union_array_like.ts

@@ -8,6 +8,7 @@ import { TypeFactory } from "../../factories/TypeFactory";
 import { Metadata } from "../../schemas/metadata/Metadata";
 import { MetadataArray } from "../../schemas/metadata/MetadataArray";
 import { MetadataArrayType } from "../../schemas/metadata/MetadataArrayType";
+import { MetadataMap } from "../../schemas/metadata/MetadataMap";
 import { MetadataTuple } from "../../schemas/metadata/MetadataTuple";
 
 import { CheckerProgrammer } from "../CheckerProgrammer";
@@ -18,7 +19,7 @@ import { UnionExplorer } from "../helpers/UnionExplorer";
  * @internal
  */
 export const check_union_array_like = <
-  Origin extends Metadata | MetadataArray | MetadataTuple | Metadata.Entry,
+  Origin extends Metadata | MetadataArray | MetadataTuple | MetadataMap,
   Category extends MetadataArray | MetadataTuple,
   Element,
 >(props: {

package/src/programmers/internal/llm_schema_escaped.ts

@@ -59,7 +59,7 @@ const is_date = (props: {
   props.visited.add(props.metadata);
 
   return (
-    props.metadata.natives.some((name) => name === "Date") ||
+    props.metadata.natives.some((native) => native.name === "Date") ||
     props.metadata.arrays.some((array) =>
       is_date({
         visited: props.visited,
@@ -77,7 +77,7 @@ const is_date = (props: {
     props.metadata.aliases.some((alias) =>
       is_date({
         visited: props.visited,
-        metadata: alias.value,
+        metadata: alias.type.value,
       }),
     )
   );