typia 7.0.0-dev.20240918 → 7.0.0-dev.20240919

package/src/programmers/internal/application_array.ts

@@ -8,43 +8,38 @@ import { application_plugin } from "./application_plugin";
 /**
  * @internal
  */
-export const application_array =
-  <Version extends "3.0" | "3.1">(
-    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>>(
-        {
-          type: "array",
-          items: generator(array.type.value),
-        } as ArraySchema<Version>,
-        array.tags,
-      );
-    if (array.type.recursive === true) {
-      const out = () => [{ $ref }];
-      const $ref: string = `#/components/schemas/${array.type.name}`;
-      if (components.schemas?.[$ref] !== undefined) return out();
+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();
 
-      components.schemas ??= {};
-      components.schemas[$ref] ??= {};
+    props.components.schemas ??= {};
+    props.components.schemas[$ref] ??= {};
 
-      const oneOf: ArraySchema<Version>[] = factory();
-      Object.assign(
-        components.schemas[$ref]!,
-        oneOf.length === 1 ? oneOf[0] : { oneOf },
-      );
-      return out();
-    }
-    return factory();
-  };
+    const oneOf: ArraySchema<Version>[] = factory();
+    Object.assign(
+      props.components.schemas[$ref]!,
+      oneOf.length === 1 ? oneOf[0] : { oneOf },
+    );
+    return out();
+  }
+  return factory();
+};
 
 /**
  * @internal

package/src/programmers/internal/application_bigint.ts

@@ -10,12 +10,12 @@ import { application_plugin } from "./application_plugin";
 export const application_bigint = <Version extends "3.0" | "3.1">(
   atomic: MetadataAtomic,
 ): Schema<Version>[] =>
-  application_plugin(
-    {
+  application_plugin({
+    schema: {
       type: "integer",
     } satisfies Schema<Version>,
-    atomic.tags,
-  );
+    tags: atomic.tags,
+  });
 
 /**
  * @internal

package/src/programmers/internal/application_boolean.ts

@@ -10,12 +10,12 @@ import { application_plugin } from "./application_plugin";
 export const application_boolean = <Version extends "3.0" | "3.1">(
   atomic: MetadataAtomic,
 ): Schema<Version>[] =>
-  application_plugin(
-    {
+  application_plugin({
+    schema: {
       type: "boolean",
     } satisfies Schema<Version>,
-    atomic.tags,
-  );
+    tags: atomic.tags,
+  });
 
 /**
  * @internal

package/src/programmers/internal/application_escaped.ts

@@ -6,29 +6,33 @@ import { MetadataEscaped } from "../../schemas/metadata/MetadataEscaped";
 /**
  * @internal
  */
-export const application_escaped =
-  <Version extends "3.0" | "3.1">(
-    generator: (meta: Metadata) => Schema<Version>,
-  ) =>
-  (escaped: MetadataEscaped): Schema<Version>[] => {
-    const output: Schema<Version> | null = generator(escaped.returns);
-    if (output === null) return [];
+export const application_escaped = <Version extends "3.0" | "3.1">(props: {
+  generator: (meta: Metadata) => Schema<Version>;
+  escaped: MetadataEscaped;
+}): Schema<Version>[] => {
+  const output: Schema<Version> | null = props.generator(props.escaped.returns);
+  if (output === null) return [];
 
-    if (is_date(new Set())(escaped.original)) {
-      const string: StringSchema<Version> | undefined = is_string(output)
-        ? output
-        : is_one_of(output)
-          ? (output.oneOf.find(is_string) as StringSchema<Version>)
-          : undefined;
-      if (
-        string !== undefined &&
-        string.format !== "date" &&
-        string.format !== "date-time"
-      )
-        string.format = "date-time";
-    }
-    return is_one_of(output) ? (output.oneOf as Schema<Version>[]) : [output];
-  };
+  if (
+    is_date({
+      visited: new Set(),
+      metadata: props.escaped.original,
+    })
+  ) {
+    const string: StringSchema<Version> | undefined = is_string(output)
+      ? output
+      : is_one_of(output)
+        ? (output.oneOf.find(is_string) as StringSchema<Version>)
+        : undefined;
+    if (
+      string !== undefined &&
+      string.format !== "date" &&
+      string.format !== "date-time"
+    )
+      string.format = "date-time";
+  }
+  return is_one_of(output) ? (output.oneOf as Schema<Version>[]) : [output];
+};
 
 /**
  * @internal
@@ -49,19 +53,37 @@ const is_one_of = <Version extends "3.0" | "3.1">(
 /**
  * @internal
  */
-const is_date =
-  (visited: Set<Metadata>) =>
-  (meta: Metadata): boolean => {
-    if (visited.has(meta)) return false;
-    visited.add(meta);
+const is_date = (props: {
+  visited: Set<Metadata>;
+  metadata: Metadata;
+}): boolean => {
+  if (props.visited.has(props.metadata)) return false;
+  props.visited.add(props.metadata);
 
-    return (
-      meta.natives.some((name) => name === "Date") ||
-      meta.arrays.some((array) => is_date(visited)(array.type.value)) ||
-      meta.tuples.some((tuple) => tuple.type.elements.some(is_date(visited))) ||
-      meta.aliases.some((alias) => is_date(visited)(alias.value))
-    );
-  };
+  return (
+    props.metadata.natives.some((name) => name === "Date") ||
+    props.metadata.arrays.some((array) =>
+      is_date({
+        visited: props.visited,
+        metadata: array.type.value,
+      }),
+    ) ||
+    props.metadata.tuples.some((tuple) =>
+      tuple.type.elements.some((e) =>
+        is_date({
+          visited: props.visited,
+          metadata: e,
+        }),
+      ),
+    ) ||
+    props.metadata.aliases.some((alias) =>
+      is_date({
+        visited: props.visited,
+        metadata: alias.value,
+      }),
+    )
+  );
+};
 
 type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
   ? OpenApiV3.IJsonSchema

package/src/programmers/internal/application_number.ts

@@ -10,12 +10,12 @@ import { application_plugin } from "./application_plugin";
 export const application_number = <Version extends "3.0" | "3.1">(
   atomic: MetadataAtomic,
 ): Schema<Version>[] =>
-  application_plugin(
-    {
+  application_plugin({
+    schema: {
       type: "number",
     } satisfies Schema<Version>,
-    atomic.tags,
-  );
+    tags: atomic.tags,
+  });
 
 /**
  * @internal

package/src/programmers/internal/application_plugin.ts

@@ -3,16 +3,16 @@ import { IMetadataTypeTag } from "../../schemas/metadata/IMetadataTypeTag";
 /**
  * @internal
  */
-export const application_plugin = <Schema extends object>(
-  schema: Schema,
-  tags: IMetadataTypeTag[][],
-): Schema[] => {
-  const plugins: IMetadataTypeTag[][] = tags
+export const application_plugin = <Schema extends object>(props: {
+  schema: Schema;
+  tags: IMetadataTypeTag[][];
+}): Schema[] => {
+  const plugins: IMetadataTypeTag[][] = props.tags
     .map((row) => row.filter((t) => t.schema !== undefined))
     .filter((row) => row.length !== 0);
-  if (plugins.length === 0) return [schema];
+  if (plugins.length === 0) return [props.schema];
   return plugins.map((row) => {
-    const base: Schema = { ...schema };
+    const base: Schema = { ...props.schema };
     for (const tag of row) Object.assign(base, tag.schema);
     return base;
   });

package/src/programmers/internal/application_string.ts

@@ -10,12 +10,12 @@ import { application_plugin } from "./application_plugin";
 export const application_string = <Version extends "3.0" | "3.1">(
   atomic: MetadataAtomic,
 ): Schema<Version>[] =>
-  application_plugin(
-    {
+  application_plugin({
+    schema: {
       type: "string",
     } satisfies Schema<Version>,
-    atomic.tags,
-  );
+    tags: atomic.tags,
+  });
 
 /**
  * @internal

package/src/programmers/internal/application_templates.ts

@@ -33,8 +33,8 @@ export const application_templates = <Version extends "3.0" | "3.1">(
     });
   for (const tpl of taggedTemplates)
     output.push(
-      application_plugin(
-        {
+      application_plugin({
+        schema: {
           type: "string",
           pattern: metadata_to_pattern(false)(
             Metadata.create({
@@ -43,8 +43,8 @@ export const application_templates = <Version extends "3.0" | "3.1">(
             }),
           ),
         },
-        tpl.tags ?? [],
-      ) as any,
+        tags: tpl.tags ?? [],
+      }) as any,
     );
   return output;
 };

package/src/programmers/internal/application_v30_alias.ts

@@ -12,41 +12,48 @@ import { application_v30_schema } from "./application_v30_schema";
 /**
  * @internal
  */
-export const application_v30_alias =
-  <BlockNever extends boolean>(blockNever: BlockNever) =>
-  (components: OpenApiV3.IComponents) =>
-  (alias: MetadataAlias) =>
-  (nullable: boolean): OpenApiV3.IJsonSchema.IReference => {
-    if (alias.value.size() === 1 && alias.value.objects.length === 1)
-      return application_v30_object(components)(alias.value.objects[0]!)(
-        nullable,
-      ) as OpenApiV3.IJsonSchema.IReference;
+export const application_v30_alias = <BlockNever extends boolean>(props: {
+  blockNever: BlockNever;
+  components: OpenApiV3.IComponents;
+  alias: MetadataAlias;
+  nullable: boolean;
+}): OpenApiV3.IJsonSchema.IReference => {
+  if (props.alias.value.size() === 1 && props.alias.value.objects.length === 1)
+    return application_v30_object({
+      object: props.alias.value.objects[0]!,
+      components: props.components,
+      nullable: props.nullable,
+    }) as OpenApiV3.IJsonSchema.IReference;
 
-    const key: string = `${alias.name}${nullable ? ".Nullable" : ""}`;
-    const $ref: string = `#/components/schemas/${key}`;
+  const key: string = `${props.alias.name}${props.nullable ? ".Nullable" : ""}`;
+  const $ref: string = `#/components/schemas/${key}`;
 
-    if (components.schemas?.[key] === undefined) {
-      // TEMPORARY ASSIGNMENT
-      components.schemas ??= {};
-      components.schemas[key] = {};
+  if (props.components.schemas?.[key] === undefined) {
+    // TEMPORARY ASSIGNMENT
+    props.components.schemas ??= {};
+    props.components.schemas[key] = {};
 
-      // GENERATE SCHEMA
-      const schema: OpenApiV3.IJsonSchema | null = application_v30_schema(
-        blockNever,
-      )(components)({
+    // GENERATE SCHEMA
+    const schema: OpenApiV3.IJsonSchema | null = application_v30_schema({
+      blockNever: props.blockNever,
+      components: props.components,
+      attribute: {
         deprecated:
-          alias.jsDocTags.some((tag) => tag.name === "deprecated") || undefined,
+          props.alias.jsDocTags.some((tag) => tag.name === "deprecated") ||
+          undefined,
         title: (() => {
-          const info: IJsDocTagInfo | undefined = alias.jsDocTags.find(
+          const info: IJsDocTagInfo | undefined = props.alias.jsDocTags.find(
             (tag) => tag.name === "title",
           );
           return info?.text?.length
             ? CommentFactory.merge(info.text)
             : undefined;
         })(),
-        description: application_description(alias),
-      })(alias.value);
-      if (schema !== null) Object.assign(components.schemas[key]!, schema);
-    }
-    return { $ref };
-  };
+        description: application_description(props.alias),
+      },
+      metadata: props.alias.value,
+    });
+    if (schema !== null) Object.assign(props.components.schemas[key]!, schema);
+  }
+  return { $ref };
+};

package/src/programmers/internal/application_v30_native.ts

@@ -3,26 +3,27 @@ import { OpenApiV3 } from "@samchon/openapi";
 /**
  * @internal
  */
-export const application_v30_native =
-  (components: OpenApiV3.IComponents) =>
-  (name: string) =>
-  (nullable: boolean): OpenApiV3.IJsonSchema => {
-    if (name === "Blob" || name === "File")
-      return {
-        type: "string",
-        format: "binary",
-        nullable,
-      };
-    const key: string = `${name}${nullable ? ".Nullable" : ""}`;
-    if (components.schemas?.[key] === undefined) {
-      components.schemas ??= {};
-      components.schemas[key] ??= {
-        type: "object",
-        properties: {},
-        nullable,
-      };
-    }
+export const application_v30_native = (props: {
+  components: OpenApiV3.IComponents;
+  name: string;
+  nullable: boolean;
+}): OpenApiV3.IJsonSchema => {
+  if (props.name === "Blob" || props.name === "File")
     return {
-      $ref: `#/components/schemas/${key}`,
+      type: "string",
+      format: "binary",
+      nullable: props.nullable,
     };
+  const key: string = `${props.name}${props.nullable ? ".Nullable" : ""}`;
+  if (props.components.schemas?.[key] === undefined) {
+    props.components.schemas ??= {};
+    props.components.schemas[key] ??= {
+      type: "object",
+      properties: {},
+      nullable: props.nullable,
+    };
+  }
+  return {
+    $ref: `#/components/schemas/${key}`,
   };
+};

package/src/programmers/internal/application_v30_object.ts

@@ -15,57 +15,56 @@ import { metadata_to_pattern } from "./metadata_to_pattern";
 /**
  * @internal
  */
-export const application_v30_object =
-  (components: OpenApiV3.IComponents) =>
-  (obj: MetadataObject) =>
-  (
-    nullable: boolean,
-  ): OpenApiV3.IJsonSchema.IReference | OpenApiV3.IJsonSchema.IObject => {
-    if (obj.isLiteral() === true)
-      return create_object_schema(components)(obj)(nullable);
-
-    const key: string = `${obj.name}${nullable ? ".Nullable" : ""}`;
-    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)(nullable));
-    return { $ref };
-  };
+export const application_v30_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);
+
+  const key: string = `${props.object.name}${props.nullable ? ".Nullable" : ""}`;
+  const $ref: string = `#/components/schemas/${key}`;
+  if (props.components.schemas?.[key] !== undefined) return { $ref };
+
+  const object: OpenApiV3.IJsonSchema = {};
+  props.components.schemas ??= {};
+  props.components.schemas[key] = object;
+  Object.assign(object, create_object_schema(props));
+  return { $ref };
+};
 
 /**
  * @internal
  */
-const create_object_schema =
-  (components: OpenApiV3.IComponents) =>
-  (obj: MetadataObject) =>
-  (nullable: boolean): OpenApiV3.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: OpenApiV3.IJsonSchema | null = application_v30_schema(true)(
-        components,
-      )({
+const create_object_schema = (props: {
+  components: OpenApiV3.IComponents;
+  object: MetadataObject;
+  nullable: boolean;
+}): OpenApiV3.IJsonSchema.IObject => {
+  // ITERATE PROPERTIES
+  const properties: Record<string, any> = {};
+  const extraMeta: ISuperfluous = {
+    patternProperties: {},
+    additionalProperties: undefined,
+  };
+  const required: string[] = [];
+
+  for (const property of props.object.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: OpenApiV3.IJsonSchema | null = application_v30_schema({
+      blockNever: true,
+      components: props.components,
+      attribute: {
         deprecated:
           property.jsDocTags.some((tag) => tag.name === "deprecated") ||
           undefined,
@@ -87,58 +86,72 @@ const create_object_schema =
             : undefined;
         })(),
         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];
-      }
+      },
+      metadata: 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,
-      nullable,
-      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),
-    };
+  }
+
+  return {
+    type: "object",
+    properties,
+    nullable: props.nullable,
+    required: required.length ? required : undefined,
+    title: (() => {
+      const info: IJsDocTagInfo | undefined = props.object.jsDocTags.find(
+        (tag) => tag.name === "title",
+      );
+      return info?.text?.length ? CommentFactory.merge(info.text) : undefined;
+    })(),
+    description: application_description(props.object),
+    additionalProperties: join({
+      components: props.components,
+      extra: extraMeta,
+    }),
   };
+};
 
 /**
  * @internal
  */
-const join =
-  (components: OpenApiV3.IComponents) =>
-  (extra: ISuperfluous): OpenApiV3.IJsonSchema | undefined => {
-    // LIST UP METADATA
-    const elements: [Metadata, OpenApiV3.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_v30_schema(true)(components)({})(meta) ?? undefined;
-  };
+const join = (props: {
+  components: OpenApiV3.IComponents;
+  extra: ISuperfluous;
+}): OpenApiV3.IJsonSchema | undefined => {
+  // LIST UP METADATA
+  const elements: [Metadata, OpenApiV3.IJsonSchema][] = Object.values(
+    props.extra.patternProperties || {},
+  );
+  if (props.extra.additionalProperties)
+    elements.push(props.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_v30_schema({
+      blockNever: true,
+      components: props.components,
+      attribute: {},
+      metadata: meta,
+    }) ?? undefined
+  );
+};
 
 /**
  * @internal