typia 6.10.2-dev.20240920 → 6.10.2

package/src/programmers/internal/application_v30_schema.ts

@@ -1,161 +1,161 @@
-import { OpenApiV3 } from "@samchon/openapi";
-
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
-
-import { AtomicPredicator } from "../helpers/AtomicPredicator";
-import { application_array } from "./application_array";
-import { application_bigint } from "./application_bigint";
-import { application_boolean } from "./application_boolean";
-import { application_escaped } from "./application_escaped";
-import { application_number } from "./application_number";
-import { application_string } from "./application_string";
-import { application_templates } from "./application_templates";
-import { application_union_discriminator } from "./application_union_discriminator";
-import { application_v30_alias } from "./application_v30_alias";
-import { application_v30_constant } from "./application_v30_constant";
-import { application_v30_native } from "./application_v30_native";
-import { application_v30_object } from "./application_v30_object";
-import { application_v30_tuple } from "./application_v30_tuple";
-
-/**
- * @internal
- */
-export const application_v30_schema =
-  <BlockNever extends boolean>(blockNever: BlockNever) =>
-  (components: OpenApiV3.IComponents) =>
-  (attribute: OpenApiV3.IJsonSchema.__IAttribute) =>
-  (
-    meta: Metadata,
-  ): BlockNever extends true
-    ? OpenApiV3.IJsonSchema | null
-    : OpenApiV3.IJsonSchema => {
-    // VULNERABLE CASE
-    if (meta.any === true)
-      return {
-        ...attribute,
-        type: undefined,
-      };
-    else if (meta.nullable && meta.empty())
-      return { type: "null", ...attribute };
-
-    //----
-    // GATHER UNION SCHEMAS
-    //----
-    const union: OpenApiV3.IJsonSchema[] = [];
-    const insert = meta.nullable
-      ? (schema: OpenApiV3.IJsonSchema) =>
-          union.push({
-            ...schema,
-            nullable: (schema as OpenApiV3.IJsonSchema.__ISignificant<any>).type
-              ? true
-              : undefined,
-          } as OpenApiV3.IJsonSchema)
-      : (schema: OpenApiV3.IJsonSchema) => union.push(schema);
-
-    // toJSON() METHOD
-    if (meta.escaped !== null)
-      application_escaped<"3.0">(application_v30_schema(false)(components)({}))(
-        meta.escaped,
-      ).forEach(insert);
-
-    // ATOMIC TYPES
-    if (meta.templates.length && AtomicPredicator.template(meta))
-      application_templates(meta).map(insert);
-    for (const constant of meta.constants)
-      if (AtomicPredicator.constant(meta)(constant.type) === false) continue;
-      else insert(application_v30_constant(constant));
-    for (const a of meta.atomics)
-      if (a.type === "boolean") application_boolean(a).forEach(insert);
-      else if (a.type === "bigint") application_bigint(a).forEach(insert);
-      else if (a.type === "number") application_number(a).forEach(insert);
-      else if (a.type === "string") application_string(a).forEach(insert);
-
-    // ARRAY
-    for (const array of meta.arrays)
-      application_array<"3.0">(application_v30_schema(false)(components)({}))(
-        components,
-      )(array).forEach(insert);
-
-    // TUPLE
-    for (const tuple of meta.tuples)
-      insert(application_v30_tuple(components)(tuple)(attribute));
-
-    // NATIVES
-    for (const native of meta.natives)
-      if (AtomicPredicator.native(native)) {
-        const type: string = native.toLowerCase();
-        if (meta.atomics.some((a) => a.type === type)) continue;
-        else if (type === "boolean")
-          insert(
-            application_boolean(
-              MetadataAtomic.create({
-                type: "boolean",
-                tags: [],
-              }),
-            )[0]!,
-          );
-        else if (type === "bigint")
-          insert(
-            application_bigint(
-              MetadataAtomic.create({
-                type: "bigint",
-                tags: [],
-              }),
-            )[0]! as any,
-          );
-        else if (type === "number")
-          insert(
-            application_number(
-              MetadataAtomic.create({
-                type: "number",
-                tags: [],
-              }),
-            )[0]!,
-          );
-        else if (type === "string")
-          insert(
-            application_string(
-              MetadataAtomic.create({
-                type: "string",
-                tags: [],
-              }),
-            )[0]!,
-          );
-      } else insert(application_v30_native(components)(native)(meta.nullable));
-    if (meta.sets.length)
-      insert(application_v30_native(components)(`Set`)(meta.nullable));
-    if (meta.maps.length)
-      insert(application_v30_native(components)(`Map`)(meta.nullable));
-
-    // OBJECT
-    for (const obj of meta.objects)
-      insert(application_v30_object(components)(obj)(meta.nullable));
-
-    // ALIASES
-    for (const alias of meta.aliases)
-      insert(
-        application_v30_alias(blockNever)(components)(alias)(meta.nullable),
-      );
-
-    //----
-    // RETURNS
-    //----
-    if (union.length === 0 && blockNever === true) return null!;
-    const schema: OpenApiV3.IJsonSchema =
-      union.length === 0
-        ? { type: undefined }
-        : union.length === 1
-          ? union[0]!
-          : {
-              oneOf: union,
-              discriminator: application_union_discriminator(meta),
-            };
-    return {
-      ...schema,
-      ...attribute,
-      title: attribute.title ?? schema.title,
-      description: attribute.description ?? schema.description,
-      deprecated: attribute.deprecated ?? schema.deprecated,
-    };
-  };
+import { OpenApiV3 } from "@samchon/openapi";
+
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
+
+import { AtomicPredicator } from "../helpers/AtomicPredicator";
+import { application_array } from "./application_array";
+import { application_bigint } from "./application_bigint";
+import { application_boolean } from "./application_boolean";
+import { application_escaped } from "./application_escaped";
+import { application_number } from "./application_number";
+import { application_string } from "./application_string";
+import { application_templates } from "./application_templates";
+import { application_union_discriminator } from "./application_union_discriminator";
+import { application_v30_alias } from "./application_v30_alias";
+import { application_v30_constant } from "./application_v30_constant";
+import { application_v30_native } from "./application_v30_native";
+import { application_v30_object } from "./application_v30_object";
+import { application_v30_tuple } from "./application_v30_tuple";
+
+/**
+ * @internal
+ */
+export const application_v30_schema =
+  <BlockNever extends boolean>(blockNever: BlockNever) =>
+  (components: OpenApiV3.IComponents) =>
+  (attribute: OpenApiV3.IJsonSchema.__IAttribute) =>
+  (
+    meta: Metadata,
+  ): BlockNever extends true
+    ? OpenApiV3.IJsonSchema | null
+    : OpenApiV3.IJsonSchema => {
+    // VULNERABLE CASE
+    if (meta.any === true)
+      return {
+        ...attribute,
+        type: undefined,
+      };
+    else if (meta.nullable && meta.empty())
+      return { type: "null", ...attribute };
+
+    //----
+    // GATHER UNION SCHEMAS
+    //----
+    const union: OpenApiV3.IJsonSchema[] = [];
+    const insert = meta.nullable
+      ? (schema: OpenApiV3.IJsonSchema) =>
+          union.push({
+            ...schema,
+            nullable: (schema as OpenApiV3.IJsonSchema.__ISignificant<any>).type
+              ? true
+              : undefined,
+          } as OpenApiV3.IJsonSchema)
+      : (schema: OpenApiV3.IJsonSchema) => union.push(schema);
+
+    // toJSON() METHOD
+    if (meta.escaped !== null)
+      application_escaped<"3.0">(application_v30_schema(false)(components)({}))(
+        meta.escaped,
+      ).forEach(insert);
+
+    // ATOMIC TYPES
+    if (meta.templates.length && AtomicPredicator.template(meta))
+      application_templates(meta).map(insert);
+    for (const constant of meta.constants)
+      if (AtomicPredicator.constant(meta)(constant.type) === false) continue;
+      else insert(application_v30_constant(constant));
+    for (const a of meta.atomics)
+      if (a.type === "boolean") application_boolean(a).forEach(insert);
+      else if (a.type === "bigint") application_bigint(a).forEach(insert);
+      else if (a.type === "number") application_number(a).forEach(insert);
+      else if (a.type === "string") application_string(a).forEach(insert);
+
+    // ARRAY
+    for (const array of meta.arrays)
+      application_array<"3.0">(application_v30_schema(false)(components)({}))(
+        components,
+      )(array).forEach(insert);
+
+    // TUPLE
+    for (const tuple of meta.tuples)
+      insert(application_v30_tuple(components)(tuple)(attribute));
+
+    // NATIVES
+    for (const native of meta.natives)
+      if (AtomicPredicator.native(native)) {
+        const type: string = native.toLowerCase();
+        if (meta.atomics.some((a) => a.type === type)) continue;
+        else if (type === "boolean")
+          insert(
+            application_boolean(
+              MetadataAtomic.create({
+                type: "boolean",
+                tags: [],
+              }),
+            )[0]!,
+          );
+        else if (type === "bigint")
+          insert(
+            application_bigint(
+              MetadataAtomic.create({
+                type: "bigint",
+                tags: [],
+              }),
+            )[0]! as any,
+          );
+        else if (type === "number")
+          insert(
+            application_number(
+              MetadataAtomic.create({
+                type: "number",
+                tags: [],
+              }),
+            )[0]!,
+          );
+        else if (type === "string")
+          insert(
+            application_string(
+              MetadataAtomic.create({
+                type: "string",
+                tags: [],
+              }),
+            )[0]!,
+          );
+      } else insert(application_v30_native(components)(native)(meta.nullable));
+    if (meta.sets.length)
+      insert(application_v30_native(components)(`Set`)(meta.nullable));
+    if (meta.maps.length)
+      insert(application_v30_native(components)(`Map`)(meta.nullable));
+
+    // OBJECT
+    for (const obj of meta.objects)
+      insert(application_v30_object(components)(obj)(meta.nullable));
+
+    // ALIASES
+    for (const alias of meta.aliases)
+      insert(
+        application_v30_alias(blockNever)(components)(alias)(meta.nullable),
+      );
+
+    //----
+    // RETURNS
+    //----
+    if (union.length === 0 && blockNever === true) return null!;
+    const schema: OpenApiV3.IJsonSchema =
+      union.length === 0
+        ? { type: undefined }
+        : union.length === 1
+          ? union[0]!
+          : {
+              oneOf: union,
+              discriminator: application_union_discriminator(meta),
+            };
+    return {
+      ...schema,
+      ...attribute,
+      title: attribute.title ?? schema.title,
+      description: attribute.description ?? schema.description,
+      deprecated: attribute.deprecated ?? schema.deprecated,
+    };
+  };

package/src/programmers/internal/application_v30_tuple.ts

@@ -1,33 +1,33 @@
-import { OpenApiV3 } from "@samchon/openapi";
-
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataTuple } from "../../schemas/metadata/MetadataTuple";
-
-import { application_v30_schema } from "./application_v30_schema";
-
-/**
- * @internal
- */
-export const application_v30_tuple =
-  (components: OpenApiV3.IComponents) =>
-  (tuple: MetadataTuple) =>
-  (
-    attribute: OpenApiV3.IJsonSchema.__IAttribute,
-  ): OpenApiV3.IJsonSchema.IArray => ({
-    ...attribute,
-    type: "array",
-    items: application_v30_schema(false)(components)(
-      tuple.type.recursive ? {} : attribute,
-    )(
-      tuple.type.elements.reduce(
-        (x, y) => Metadata.merge(x.rest ?? x, y.rest ?? y),
-        Metadata.initialize(),
-      ),
-    ),
-    minItems: !!tuple.type.elements.at(-1)?.rest
-      ? tuple.type.elements.length - 1
-      : tuple.type.elements.filter((x) => !x.optional).length,
-    maxItems: !!tuple.type.elements.at(-1)?.rest
-      ? undefined!
-      : tuple.type.elements.length,
-  });
+import { OpenApiV3 } from "@samchon/openapi";
+
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataTuple } from "../../schemas/metadata/MetadataTuple";
+
+import { application_v30_schema } from "./application_v30_schema";
+
+/**
+ * @internal
+ */
+export const application_v30_tuple =
+  (components: OpenApiV3.IComponents) =>
+  (tuple: MetadataTuple) =>
+  (
+    attribute: OpenApiV3.IJsonSchema.__IAttribute,
+  ): OpenApiV3.IJsonSchema.IArray => ({
+    ...attribute,
+    type: "array",
+    items: application_v30_schema(false)(components)(
+      tuple.type.recursive ? {} : attribute,
+    )(
+      tuple.type.elements.reduce(
+        (x, y) => Metadata.merge(x.rest ?? x, y.rest ?? y),
+        Metadata.initialize(),
+      ),
+    ),
+    minItems: !!tuple.type.elements.at(-1)?.rest
+      ? tuple.type.elements.length - 1
+      : tuple.type.elements.filter((x) => !x.optional).length,
+    maxItems: !!tuple.type.elements.at(-1)?.rest
+      ? undefined!
+      : tuple.type.elements.length,
+  });

package/src/programmers/internal/application_v31_alias.ts

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

package/src/programmers/internal/application_v31_constant.ts

@@ -1,29 +1,29 @@
-import { OpenApi } from "@samchon/openapi";
-
-import { MetadataConstant } from "../../schemas/metadata/MetadataConstant";
-
-import { application_description } from "./application_description";
-import { application_plugin } from "./application_plugin";
-import { application_title } from "./application_title";
-
-/**
- * @internal
- */
-export const application_v31_constant = (
-  constant: MetadataConstant,
-): OpenApi.IJsonSchema.IConstant[] =>
-  constant.values
-    .map((value) =>
-      application_plugin(
-        {
-          const:
-            typeof value.value === "bigint"
-              ? Number(value.value)
-              : (value.value as boolean | number | string),
-          title: application_title(value),
-          description: application_description(value),
-        } satisfies OpenApi.IJsonSchema.IConstant,
-        value.tags ?? [],
-      ),
-    )
-    .flat();
+import { OpenApi } from "@samchon/openapi";
+
+import { MetadataConstant } from "../../schemas/metadata/MetadataConstant";
+
+import { application_description } from "./application_description";
+import { application_plugin } from "./application_plugin";
+import { application_title } from "./application_title";
+
+/**
+ * @internal
+ */
+export const application_v31_constant = (
+  constant: MetadataConstant,
+): OpenApi.IJsonSchema.IConstant[] =>
+  constant.values
+    .map((value) =>
+      application_plugin(
+        {
+          const:
+            typeof value.value === "bigint"
+              ? Number(value.value)
+              : (value.value as boolean | number | string),
+          title: application_title(value),
+          description: application_description(value),
+        } satisfies OpenApi.IJsonSchema.IConstant,
+        value.tags ?? [],
+      ),
+    )
+    .flat();

package/src/programmers/internal/application_v31_native.ts

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