typia 6.10.2-dev.20240920 → 6.10.2

package/src/programmers/internal/application_v31_object.ts

@@ -1,130 +1,130 @@
-import { OpenApi, OpenApiV3 } from "@samchon/openapi";
-
-import { CommentFactory } from "../../factories/CommentFactory";
-
-import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataObject } from "../../schemas/metadata/MetadataObject";
-
-import { PatternUtil } from "../../utils/PatternUtil";
-
-import { application_description } from "./application_description";
-import { application_title } from "./application_title";
-import { application_v31_schema } from "./application_v31_schema";
-import { metadata_to_pattern } from "./metadata_to_pattern";
-
-/**
- * @internal
- */
-export const application_v31_object =
-  (components: OpenApi.IComponents) =>
-  (
-    obj: MetadataObject,
-  ): OpenApi.IJsonSchema.IReference | OpenApi.IJsonSchema.IObject => {
-    if (obj.isLiteral() === true) return create_object_schema(components)(obj);
-
-    const key: string = obj.name;
-    const $ref: string = `#/components/schemas/${key}`;
-    if (components.schemas?.[key] !== undefined) return { $ref };
-
-    const object: OpenApiV3.IJsonSchema = {};
-    components.schemas ??= {};
-    components.schemas[key] = object;
-    Object.assign(object, create_object_schema(components)(obj));
-    return { $ref };
-  };
-
-/**
- * @internal
- */
-const create_object_schema =
-  (components: OpenApi.IComponents) =>
-  (obj: MetadataObject): OpenApi.IJsonSchema.IObject => {
-    // ITERATE PROPERTIES
-    const properties: Record<string, any> = {};
-    const extraMeta: ISuperfluous = {
-      patternProperties: {},
-      additionalProperties: undefined,
-    };
-    const required: string[] = [];
-
-    for (const property of obj.properties) {
-      if (
-        // FUNCTIONAL TYPE
-        property.value.functions.length &&
-        property.value.nullable === false &&
-        property.value.isRequired() === true &&
-        property.value.size() === 0
-      )
-        continue;
-      else if (property.jsDocTags.find((tag) => tag.name === "hidden"))
-        continue; // THE HIDDEN TAG
-
-      const key: string | null = property.key.getSoleLiteral();
-      const schema: OpenApi.IJsonSchema | null = application_v31_schema(true)(
-        components,
-      )({
-        deprecated:
-          property.jsDocTags.some((tag) => tag.name === "deprecated") ||
-          undefined,
-        title: application_title(property),
-        description: application_description(property),
-      })(property.value);
-
-      if (schema === null) continue;
-      if (key !== null) {
-        properties[key] = schema;
-        if (property.value.isRequired() === true) required.push(key);
-      } else {
-        const pattern: string = metadata_to_pattern(true)(property.key);
-        if (pattern === PatternUtil.STRING)
-          extraMeta.additionalProperties = [property.value, schema];
-        else extraMeta.patternProperties[pattern] = [property.value, schema];
-      }
-    }
-
-    return {
-      type: "object",
-      properties,
-      required: required.length ? required : undefined,
-      title: (() => {
-        const info: IJsDocTagInfo | undefined = obj.jsDocTags.find(
-          (tag) => tag.name === "title",
-        );
-        return info?.text?.length ? CommentFactory.merge(info.text) : undefined;
-      })(),
-      description: application_description(obj),
-      additionalProperties: join(components)(extraMeta),
-    };
-  };
-
-/**
- * @internal
- */
-const join =
-  (components: OpenApi.IComponents) =>
-  (extra: ISuperfluous): OpenApi.IJsonSchema | undefined => {
-    // LIST UP METADATA
-    const elements: [Metadata, OpenApi.IJsonSchema][] = Object.values(
-      extra.patternProperties || {},
-    );
-    if (extra.additionalProperties) elements.push(extra.additionalProperties);
-
-    // SHORT RETURN
-    if (elements.length === 0) return undefined;
-    else if (elements.length === 1) return elements[0]![1]!;
-
-    // MERGE METADATA AND GENERATE VULNERABLE SCHEMA
-    const meta: Metadata = elements
-      .map((tuple) => tuple[0])
-      .reduce((x, y) => Metadata.merge(x, y));
-    return application_v31_schema(true)(components)({})(meta) ?? undefined;
-  };
-
-/**
- * @internal
- */
-interface ISuperfluous {
-  additionalProperties?: undefined | [Metadata, OpenApi.IJsonSchema];
-  patternProperties: Record<string, [Metadata, OpenApi.IJsonSchema]>;
-}
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+import { CommentFactory } from "../../factories/CommentFactory";
+
+import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataObject } from "../../schemas/metadata/MetadataObject";
+
+import { PatternUtil } from "../../utils/PatternUtil";
+
+import { application_description } from "./application_description";
+import { application_title } from "./application_title";
+import { application_v31_schema } from "./application_v31_schema";
+import { metadata_to_pattern } from "./metadata_to_pattern";
+
+/**
+ * @internal
+ */
+export const application_v31_object =
+  (components: OpenApi.IComponents) =>
+  (
+    obj: MetadataObject,
+  ): OpenApi.IJsonSchema.IReference | OpenApi.IJsonSchema.IObject => {
+    if (obj.isLiteral() === true) return create_object_schema(components)(obj);
+
+    const key: string = obj.name;
+    const $ref: string = `#/components/schemas/${key}`;
+    if (components.schemas?.[key] !== undefined) return { $ref };
+
+    const object: OpenApiV3.IJsonSchema = {};
+    components.schemas ??= {};
+    components.schemas[key] = object;
+    Object.assign(object, create_object_schema(components)(obj));
+    return { $ref };
+  };
+
+/**
+ * @internal
+ */
+const create_object_schema =
+  (components: OpenApi.IComponents) =>
+  (obj: MetadataObject): OpenApi.IJsonSchema.IObject => {
+    // ITERATE PROPERTIES
+    const properties: Record<string, any> = {};
+    const extraMeta: ISuperfluous = {
+      patternProperties: {},
+      additionalProperties: undefined,
+    };
+    const required: string[] = [];
+
+    for (const property of obj.properties) {
+      if (
+        // FUNCTIONAL TYPE
+        property.value.functions.length &&
+        property.value.nullable === false &&
+        property.value.isRequired() === true &&
+        property.value.size() === 0
+      )
+        continue;
+      else if (property.jsDocTags.find((tag) => tag.name === "hidden"))
+        continue; // THE HIDDEN TAG
+
+      const key: string | null = property.key.getSoleLiteral();
+      const schema: OpenApi.IJsonSchema | null = application_v31_schema(true)(
+        components,
+      )({
+        deprecated:
+          property.jsDocTags.some((tag) => tag.name === "deprecated") ||
+          undefined,
+        title: application_title(property),
+        description: application_description(property),
+      })(property.value);
+
+      if (schema === null) continue;
+      if (key !== null) {
+        properties[key] = schema;
+        if (property.value.isRequired() === true) required.push(key);
+      } else {
+        const pattern: string = metadata_to_pattern(true)(property.key);
+        if (pattern === PatternUtil.STRING)
+          extraMeta.additionalProperties = [property.value, schema];
+        else extraMeta.patternProperties[pattern] = [property.value, schema];
+      }
+    }
+
+    return {
+      type: "object",
+      properties,
+      required: required.length ? required : undefined,
+      title: (() => {
+        const info: IJsDocTagInfo | undefined = obj.jsDocTags.find(
+          (tag) => tag.name === "title",
+        );
+        return info?.text?.length ? CommentFactory.merge(info.text) : undefined;
+      })(),
+      description: application_description(obj),
+      additionalProperties: join(components)(extraMeta),
+    };
+  };
+
+/**
+ * @internal
+ */
+const join =
+  (components: OpenApi.IComponents) =>
+  (extra: ISuperfluous): OpenApi.IJsonSchema | undefined => {
+    // LIST UP METADATA
+    const elements: [Metadata, OpenApi.IJsonSchema][] = Object.values(
+      extra.patternProperties || {},
+    );
+    if (extra.additionalProperties) elements.push(extra.additionalProperties);
+
+    // SHORT RETURN
+    if (elements.length === 0) return undefined;
+    else if (elements.length === 1) return elements[0]![1]!;
+
+    // MERGE METADATA AND GENERATE VULNERABLE SCHEMA
+    const meta: Metadata = elements
+      .map((tuple) => tuple[0])
+      .reduce((x, y) => Metadata.merge(x, y));
+    return application_v31_schema(true)(components)({})(meta) ?? undefined;
+  };
+
+/**
+ * @internal
+ */
+interface ISuperfluous {
+  additionalProperties?: undefined | [Metadata, OpenApi.IJsonSchema];
+  patternProperties: Record<string, [Metadata, OpenApi.IJsonSchema]>;
+}

package/src/programmers/internal/application_v31_schema.ts

@@ -1,159 +1,159 @@
-import { OpenApi } 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_v31_alias } from "./application_v31_alias";
-import { application_v31_constant } from "./application_v31_constant";
-import { application_v31_native } from "./application_v31_native";
-import { application_v31_object } from "./application_v31_object";
-import { application_v31_tuple } from "./application_v31_tuple";
-
-/**
- * @internal
- */
-export const application_v31_schema =
-  <BlockNever extends boolean>(blockNever: BlockNever) =>
-  (components: OpenApi.IComponents) =>
-  (attribute: OpenApi.IJsonSchema.__IAttribute) =>
-  (
-    meta: Metadata,
-  ): BlockNever extends true
-    ? OpenApi.IJsonSchema | null
-    : OpenApi.IJsonSchema => {
-    if (meta.any === true)
-      return {
-        ...attribute,
-        type: undefined,
-      };
-
-    //----
-    // GATHER UNION SCHEMAS
-    //----
-    const union: OpenApi.IJsonSchema[] = [];
-    const insert = (schema: OpenApi.IJsonSchema) => union.push(schema);
-
-    // NULLABLE
-    if (meta.nullable === true)
-      insert({
-        type: "null",
-      });
-
-    // toJSON() METHOD
-    if (meta.escaped !== null)
-      application_escaped(application_v31_schema(false)(components)({}))(
-        meta.escaped,
-      ).forEach(insert as any);
-
-    // ATOMIC TYPES
-    if (meta.templates.length && AtomicPredicator.template(meta))
-      application_templates(meta).map(insert as any);
-    for (const constant of meta.constants)
-      if (AtomicPredicator.constant(meta)(constant.type) === false) continue;
-      else application_v31_constant(constant).map(insert);
-    for (const a of meta.atomics)
-      if (a.type === "boolean") application_boolean(a).forEach(insert as any);
-      else if (a.type === "bigint")
-        application_bigint(a).forEach(insert as any);
-      else if (a.type === "number")
-        application_number(a).forEach(insert as any);
-      else if (a.type === "string")
-        application_string(a).forEach(insert as any);
-
-    // ARRAY
-    for (const array of meta.arrays)
-      application_array(application_v31_schema(false)(components)({}))(
-        components,
-      )(array).forEach(insert as any);
-
-    // TUPLE
-    for (const tuple of meta.tuples)
-      insert(
-        application_v31_tuple(application_v31_schema(false)(components)({}))(
-          tuple,
-        ),
-      );
-
-    // 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]! as any,
-          );
-        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]! as any,
-          );
-        else if (type === "string")
-          insert(
-            application_string(
-              MetadataAtomic.create({
-                type: "string",
-                tags: [],
-              }),
-            )[0]! as any,
-          );
-      } else insert(application_v31_native(components)(native));
-    if (meta.sets.length) insert(application_v31_native(components)(`Set`));
-    if (meta.maps.length) insert(application_v31_native(components)(`Map`));
-
-    // OBJECT
-    for (const obj of meta.objects)
-      insert(application_v31_object(components)(obj));
-
-    // ALIASES
-    for (const alias of meta.aliases)
-      insert(application_v31_alias(blockNever)(components)(alias));
-
-    //----
-    // RETURNS
-    //----
-    if (union.length === 0 && blockNever === true) return null!;
-    const schema: OpenApi.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 { OpenApi } 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_v31_alias } from "./application_v31_alias";
+import { application_v31_constant } from "./application_v31_constant";
+import { application_v31_native } from "./application_v31_native";
+import { application_v31_object } from "./application_v31_object";
+import { application_v31_tuple } from "./application_v31_tuple";
+
+/**
+ * @internal
+ */
+export const application_v31_schema =
+  <BlockNever extends boolean>(blockNever: BlockNever) =>
+  (components: OpenApi.IComponents) =>
+  (attribute: OpenApi.IJsonSchema.__IAttribute) =>
+  (
+    meta: Metadata,
+  ): BlockNever extends true
+    ? OpenApi.IJsonSchema | null
+    : OpenApi.IJsonSchema => {
+    if (meta.any === true)
+      return {
+        ...attribute,
+        type: undefined,
+      };
+
+    //----
+    // GATHER UNION SCHEMAS
+    //----
+    const union: OpenApi.IJsonSchema[] = [];
+    const insert = (schema: OpenApi.IJsonSchema) => union.push(schema);
+
+    // NULLABLE
+    if (meta.nullable === true)
+      insert({
+        type: "null",
+      });
+
+    // toJSON() METHOD
+    if (meta.escaped !== null)
+      application_escaped(application_v31_schema(false)(components)({}))(
+        meta.escaped,
+      ).forEach(insert as any);
+
+    // ATOMIC TYPES
+    if (meta.templates.length && AtomicPredicator.template(meta))
+      application_templates(meta).map(insert as any);
+    for (const constant of meta.constants)
+      if (AtomicPredicator.constant(meta)(constant.type) === false) continue;
+      else application_v31_constant(constant).map(insert);
+    for (const a of meta.atomics)
+      if (a.type === "boolean") application_boolean(a).forEach(insert as any);
+      else if (a.type === "bigint")
+        application_bigint(a).forEach(insert as any);
+      else if (a.type === "number")
+        application_number(a).forEach(insert as any);
+      else if (a.type === "string")
+        application_string(a).forEach(insert as any);
+
+    // ARRAY
+    for (const array of meta.arrays)
+      application_array(application_v31_schema(false)(components)({}))(
+        components,
+      )(array).forEach(insert as any);
+
+    // TUPLE
+    for (const tuple of meta.tuples)
+      insert(
+        application_v31_tuple(application_v31_schema(false)(components)({}))(
+          tuple,
+        ),
+      );
+
+    // 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]! as any,
+          );
+        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]! as any,
+          );
+        else if (type === "string")
+          insert(
+            application_string(
+              MetadataAtomic.create({
+                type: "string",
+                tags: [],
+              }),
+            )[0]! as any,
+          );
+      } else insert(application_v31_native(components)(native));
+    if (meta.sets.length) insert(application_v31_native(components)(`Set`));
+    if (meta.maps.length) insert(application_v31_native(components)(`Map`));
+
+    // OBJECT
+    for (const obj of meta.objects)
+      insert(application_v31_object(components)(obj));
+
+    // ALIASES
+    for (const alias of meta.aliases)
+      insert(application_v31_alias(blockNever)(components)(alias));
+
+    //----
+    // RETURNS
+    //----
+    if (union.length === 0 && blockNever === true) return null!;
+    const schema: OpenApi.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_v31_tuple.ts

@@ -1,21 +1,21 @@
-import { OpenApi } from "@samchon/openapi";
-
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataTuple } from "../../schemas/metadata/MetadataTuple";
-
-/**
- * @internal
- */
-export const application_v31_tuple =
-  (generator: (meta: Metadata) => OpenApi.IJsonSchema) =>
-  (tuple: MetadataTuple): OpenApi.IJsonSchema.ITuple => {
-    const tail: Metadata | null = tuple.type.elements.at(-1)?.rest ?? null;
-    const prefixItems: Metadata[] = tuple.type.isRest()
-      ? tuple.type.elements.slice(0, -1)
-      : tuple.type.elements;
-    return {
-      type: "array",
-      prefixItems: prefixItems.map(generator),
-      additionalItems: tail ? generator(tail) : false,
-    };
-  };
+import { OpenApi } from "@samchon/openapi";
+
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataTuple } from "../../schemas/metadata/MetadataTuple";
+
+/**
+ * @internal
+ */
+export const application_v31_tuple =
+  (generator: (meta: Metadata) => OpenApi.IJsonSchema) =>
+  (tuple: MetadataTuple): OpenApi.IJsonSchema.ITuple => {
+    const tail: Metadata | null = tuple.type.elements.at(-1)?.rest ?? null;
+    const prefixItems: Metadata[] = tuple.type.isRest()
+      ? tuple.type.elements.slice(0, -1)
+      : tuple.type.elements;
+    return {
+      type: "array",
+      prefixItems: prefixItems.map(generator),
+      additionalItems: tail ? generator(tail) : false,
+    };
+  };