typia 7.2.1 → 7.3.0-dev.20241213

package/src/programmers/internal/json_schema_plugin.ts

@@ -1,18 +1,18 @@
-import { OpenApi } from "@samchon/openapi";
-
-import { IMetadataTypeTag } from "../../schemas/metadata/IMetadataTypeTag";
-
-export const json_schema_plugin = <Schema extends OpenApi.IJsonSchema>(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 [props.schema];
-  return plugins.map((row) => {
-    const base: Schema = { ...props.schema };
-    for (const tag of row) Object.assign(base, tag.schema);
-    return base;
-  });
-};
+import { OpenApi } from "@samchon/openapi";
+
+import { IMetadataTypeTag } from "../../schemas/metadata/IMetadataTypeTag";
+
+export const json_schema_plugin = <Schema extends OpenApi.IJsonSchema>(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 [props.schema];
+  return plugins.map((row) => {
+    const base: Schema = { ...props.schema };
+    for (const tag of row) Object.assign(base, tag.schema);
+    return base;
+  });
+};

package/src/programmers/internal/json_schema_station.ts

@@ -1,182 +1,182 @@
-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 { json_schema_alias } from "./json_schema_alias";
-import { json_schema_array } from "./json_schema_array";
-import { json_schema_bigint } from "./json_schema_bigint";
-import { json_schema_boolean } from "./json_schema_boolean";
-import { json_schema_constant } from "./json_schema_constant";
-import { json_schema_discriminator } from "./json_schema_discriminator";
-import { json_schema_escaped } from "./json_schema_escaped";
-import { json_schema_native } from "./json_schema_native";
-import { json_schema_number } from "./json_schema_number";
-import { json_schema_object } from "./json_schema_object";
-import { json_schema_string } from "./json_schema_string";
-import { json_schema_templates } from "./json_schema_template";
-import { json_schema_tuple } from "./json_schema_tuple";
-
-export const json_schema_station = <BlockNever extends boolean>(props: {
-  blockNever: BlockNever;
-  components: OpenApi.IComponents;
-  attribute: OpenApi.IJsonSchema.__IAttribute;
-  metadata: Metadata;
-}): BlockNever extends true
-  ? OpenApi.IJsonSchema | null
-  : OpenApi.IJsonSchema => {
-  if (props.metadata.any === true)
-    return {
-      ...props.attribute,
-      type: undefined,
-    };
-
-  //----
-  // GATHER UNION SCHEMAS
-  //----
-  const union: OpenApi.IJsonSchema[] = [];
-  const insert = (schema: OpenApi.IJsonSchema) => union.push(schema);
-
-  // NULLABLE
-  if (props.metadata.nullable === true)
-    insert({
-      type: "null",
-    });
-
-  // toJSON() METHOD
-  if (props.metadata.escaped !== null)
-    json_schema_escaped({
-      components: props.components,
-      escaped: props.metadata.escaped,
-    }).forEach(insert);
-
-  // ATOMIC TYPES
-  if (
-    props.metadata.templates.length &&
-    AtomicPredicator.template(props.metadata)
-  )
-    json_schema_templates(props.metadata).forEach(insert);
-  for (const constant of props.metadata.constants)
-    if (
-      AtomicPredicator.constant({
-        metadata: props.metadata,
-        name: constant.type,
-      }) === false
-    )
-      continue;
-    else json_schema_constant(constant).forEach(insert);
-  for (const a of props.metadata.atomics)
-    if (a.type === "boolean") json_schema_boolean(a).forEach(insert);
-    else if (a.type === "bigint") json_schema_bigint(a).forEach(insert);
-    else if (a.type === "number") json_schema_number(a).forEach(insert);
-    else if (a.type === "string") json_schema_string(a).forEach(insert);
-
-  // ARRAY
-  for (const array of props.metadata.arrays)
-    json_schema_array({
-      components: props.components,
-      array,
-    }).forEach(insert);
-
-  // TUPLE
-  for (const tuple of props.metadata.tuples)
-    insert(
-      json_schema_tuple({
-        components: props.components,
-        tuple,
-      }),
-    );
-
-  // NATIVES
-  for (const native of props.metadata.natives)
-    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")
-        json_schema_boolean(
-          MetadataAtomic.create({
-            type: "boolean",
-            tags: [],
-          }),
-        ).map(insert);
-      else if (type === "bigint")
-        json_schema_bigint(
-          MetadataAtomic.create({
-            type: "bigint",
-            tags: [],
-          }),
-        ).map(insert);
-      else if (type === "number")
-        json_schema_number(
-          MetadataAtomic.create({
-            type: "number",
-            tags: [],
-          }),
-        ).map(insert);
-      else if (type === "string")
-        json_schema_string(
-          MetadataAtomic.create({
-            type: "string",
-            tags: [],
-          }),
-        ).map(insert);
-    } else
-      json_schema_native({
-        components: props.components,
-        native,
-      }).forEach(insert);
-  if (props.metadata.sets.length)
-    json_schema_native({
-      native: MetadataNative.create({
-        name: "Set",
-        tags: [],
-      }),
-      components: props.components,
-    }).forEach(insert);
-  if (props.metadata.maps.length)
-    json_schema_native({
-      native: MetadataNative.create({
-        name: "Map",
-        tags: [],
-      }),
-      components: props.components,
-    }).forEach(insert);
-
-  // OBJECT
-  for (const object of props.metadata.objects)
-    json_schema_object({
-      components: props.components,
-      object,
-    }).forEach(insert);
-
-  // ALIASES
-  for (const alias of props.metadata.aliases)
-    json_schema_alias({
-      alias,
-      blockNever: props.blockNever,
-      components: props.components,
-    }).forEach(insert);
-
-  //----
-  // RETURNS
-  //----
-  if (union.length === 0 && props.blockNever === true) return null!;
-  const schema: OpenApi.IJsonSchema =
-    union.length === 0
-      ? { type: undefined }
-      : union.length === 1
-        ? union[0]!
-        : {
-            oneOf: union,
-            discriminator: json_schema_discriminator(props.metadata),
-          };
-  return {
-    ...schema,
-    ...props.attribute,
-    title: props.attribute.title ?? schema.title,
-    description: props.attribute.description ?? schema.description,
-    deprecated: props.attribute.deprecated ?? schema.deprecated,
-  };
-};
+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 { json_schema_alias } from "./json_schema_alias";
+import { json_schema_array } from "./json_schema_array";
+import { json_schema_bigint } from "./json_schema_bigint";
+import { json_schema_boolean } from "./json_schema_boolean";
+import { json_schema_constant } from "./json_schema_constant";
+import { json_schema_discriminator } from "./json_schema_discriminator";
+import { json_schema_escaped } from "./json_schema_escaped";
+import { json_schema_native } from "./json_schema_native";
+import { json_schema_number } from "./json_schema_number";
+import { json_schema_object } from "./json_schema_object";
+import { json_schema_string } from "./json_schema_string";
+import { json_schema_templates } from "./json_schema_template";
+import { json_schema_tuple } from "./json_schema_tuple";
+
+export const json_schema_station = <BlockNever extends boolean>(props: {
+  blockNever: BlockNever;
+  components: OpenApi.IComponents;
+  attribute: OpenApi.IJsonSchema.__IAttribute;
+  metadata: Metadata;
+}): BlockNever extends true
+  ? OpenApi.IJsonSchema | null
+  : OpenApi.IJsonSchema => {
+  if (props.metadata.any === true)
+    return {
+      ...props.attribute,
+      type: undefined,
+    };
+
+  //----
+  // GATHER UNION SCHEMAS
+  //----
+  const union: OpenApi.IJsonSchema[] = [];
+  const insert = (schema: OpenApi.IJsonSchema) => union.push(schema);
+
+  // NULLABLE
+  if (props.metadata.nullable === true)
+    insert({
+      type: "null",
+    });
+
+  // toJSON() METHOD
+  if (props.metadata.escaped !== null)
+    json_schema_escaped({
+      components: props.components,
+      escaped: props.metadata.escaped,
+    }).forEach(insert);
+
+  // ATOMIC TYPES
+  if (
+    props.metadata.templates.length &&
+    AtomicPredicator.template(props.metadata)
+  )
+    json_schema_templates(props.metadata).forEach(insert);
+  for (const constant of props.metadata.constants)
+    if (
+      AtomicPredicator.constant({
+        metadata: props.metadata,
+        name: constant.type,
+      }) === false
+    )
+      continue;
+    else json_schema_constant(constant).forEach(insert);
+  for (const a of props.metadata.atomics)
+    if (a.type === "boolean") json_schema_boolean(a).forEach(insert);
+    else if (a.type === "bigint") json_schema_bigint(a).forEach(insert);
+    else if (a.type === "number") json_schema_number(a).forEach(insert);
+    else if (a.type === "string") json_schema_string(a).forEach(insert);
+
+  // ARRAY
+  for (const array of props.metadata.arrays)
+    json_schema_array({
+      components: props.components,
+      array,
+    }).forEach(insert);
+
+  // TUPLE
+  for (const tuple of props.metadata.tuples)
+    insert(
+      json_schema_tuple({
+        components: props.components,
+        tuple,
+      }),
+    );
+
+  // NATIVES
+  for (const native of props.metadata.natives)
+    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")
+        json_schema_boolean(
+          MetadataAtomic.create({
+            type: "boolean",
+            tags: [],
+          }),
+        ).map(insert);
+      else if (type === "bigint")
+        json_schema_bigint(
+          MetadataAtomic.create({
+            type: "bigint",
+            tags: [],
+          }),
+        ).map(insert);
+      else if (type === "number")
+        json_schema_number(
+          MetadataAtomic.create({
+            type: "number",
+            tags: [],
+          }),
+        ).map(insert);
+      else if (type === "string")
+        json_schema_string(
+          MetadataAtomic.create({
+            type: "string",
+            tags: [],
+          }),
+        ).map(insert);
+    } else
+      json_schema_native({
+        components: props.components,
+        native,
+      }).forEach(insert);
+  if (props.metadata.sets.length)
+    json_schema_native({
+      native: MetadataNative.create({
+        name: "Set",
+        tags: [],
+      }),
+      components: props.components,
+    }).forEach(insert);
+  if (props.metadata.maps.length)
+    json_schema_native({
+      native: MetadataNative.create({
+        name: "Map",
+        tags: [],
+      }),
+      components: props.components,
+    }).forEach(insert);
+
+  // OBJECT
+  for (const object of props.metadata.objects)
+    json_schema_object({
+      components: props.components,
+      object,
+    }).forEach(insert);
+
+  // ALIASES
+  for (const alias of props.metadata.aliases)
+    json_schema_alias({
+      alias,
+      blockNever: props.blockNever,
+      components: props.components,
+    }).forEach(insert);
+
+  //----
+  // RETURNS
+  //----
+  if (union.length === 0 && props.blockNever === true) return null!;
+  const schema: OpenApi.IJsonSchema =
+    union.length === 0
+      ? { type: undefined }
+      : union.length === 1
+        ? union[0]!
+        : {
+            oneOf: union,
+            discriminator: json_schema_discriminator(props.metadata),
+          };
+  return {
+    ...schema,
+    ...props.attribute,
+    title: props.attribute.title ?? schema.title,
+    description: props.attribute.description ?? schema.description,
+    deprecated: props.attribute.deprecated ?? schema.deprecated,
+  };
+};

package/src/programmers/internal/json_schema_string.ts

@@ -1,15 +1,15 @@
-import { OpenApi } from "@samchon/openapi";
-
-import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
-
-import { json_schema_plugin } from "./json_schema_plugin";
-
-export const json_schema_string = (
-  atomic: MetadataAtomic,
-): OpenApi.IJsonSchema[] =>
-  json_schema_plugin({
-    schema: {
-      type: "string",
-    } satisfies OpenApi.IJsonSchema,
-    tags: atomic.tags,
-  });
+import { OpenApi } from "@samchon/openapi";
+
+import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
+
+import { json_schema_plugin } from "./json_schema_plugin";
+
+export const json_schema_string = (
+  atomic: MetadataAtomic,
+): OpenApi.IJsonSchema[] =>
+  json_schema_plugin({
+    schema: {
+      type: "string",
+    } satisfies OpenApi.IJsonSchema,
+    tags: atomic.tags,
+  });

package/src/programmers/internal/json_schema_template.ts

@@ -1,55 +1,55 @@
-import { OpenApi } from "@samchon/openapi";
-
-import { IMetadataTypeTag } from "../../schemas/metadata/IMetadataTypeTag";
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataTemplate } from "../../schemas/metadata/MetadataTemplate";
-
-import { json_schema_plugin } from "./json_schema_plugin";
-import { metadata_to_pattern } from "./metadata_to_pattern";
-
-export const json_schema_templates = (
-  metadata: Metadata,
-): OpenApi.IJsonSchema[] => {
-  const pureTemplates: MetadataTemplate[] = metadata.templates.filter(
-    (t) => isPure(t.tags ?? []) === true,
-  );
-  const taggedTemplates: MetadataTemplate[] = metadata.templates.filter(
-    (t) => isPure(t.tags ?? []) === false,
-  );
-
-  const output: OpenApi.IJsonSchema[] = [];
-  if (pureTemplates.length)
-    output.push({
-      type: "string",
-      pattern: metadata_to_pattern({
-        top: true,
-        metadata: Metadata.create({
-          ...Metadata.initialize(),
-          templates: pureTemplates,
-        }),
-      }),
-    });
-  for (const tpl of taggedTemplates)
-    output.push(
-      ...json_schema_plugin({
-        schema: {
-          type: "string",
-          pattern: metadata_to_pattern({
-            top: false,
-            metadata: Metadata.create({
-              ...Metadata.initialize(),
-              templates: [tpl],
-            }),
-          }),
-        },
-        tags: tpl.tags ?? [],
-      }),
-    );
-  return output;
-};
-
-const isPure = (matrix: IMetadataTypeTag[][]) =>
-  matrix.every((tags) => filter(tags).length === 0);
-
-const filter = (tags: IMetadataTypeTag[]) =>
-  tags.filter((t) => t.schema !== undefined);
+import { OpenApi } from "@samchon/openapi";
+
+import { IMetadataTypeTag } from "../../schemas/metadata/IMetadataTypeTag";
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataTemplate } from "../../schemas/metadata/MetadataTemplate";
+
+import { json_schema_plugin } from "./json_schema_plugin";
+import { metadata_to_pattern } from "./metadata_to_pattern";
+
+export const json_schema_templates = (
+  metadata: Metadata,
+): OpenApi.IJsonSchema[] => {
+  const pureTemplates: MetadataTemplate[] = metadata.templates.filter(
+    (t) => isPure(t.tags ?? []) === true,
+  );
+  const taggedTemplates: MetadataTemplate[] = metadata.templates.filter(
+    (t) => isPure(t.tags ?? []) === false,
+  );
+
+  const output: OpenApi.IJsonSchema[] = [];
+  if (pureTemplates.length)
+    output.push({
+      type: "string",
+      pattern: metadata_to_pattern({
+        top: true,
+        metadata: Metadata.create({
+          ...Metadata.initialize(),
+          templates: pureTemplates,
+        }),
+      }),
+    });
+  for (const tpl of taggedTemplates)
+    output.push(
+      ...json_schema_plugin({
+        schema: {
+          type: "string",
+          pattern: metadata_to_pattern({
+            top: false,
+            metadata: Metadata.create({
+              ...Metadata.initialize(),
+              templates: [tpl],
+            }),
+          }),
+        },
+        tags: tpl.tags ?? [],
+      }),
+    );
+  return output;
+};
+
+const isPure = (matrix: IMetadataTypeTag[][]) =>
+  matrix.every((tags) => filter(tags).length === 0);
+
+const filter = (tags: IMetadataTypeTag[]) =>
+  tags.filter((t) => t.schema !== undefined);

package/src/programmers/internal/json_schema_title.ts

@@ -1,20 +1,20 @@
-import { CommentFactory } from "../../factories/CommentFactory";
-
-import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
-
-export const json_schema_title = (schema: {
-  description?: string | null | undefined;
-  jsDocTags?: IJsDocTagInfo[] | undefined;
-}): string | undefined => {
-  const info: IJsDocTagInfo | undefined = schema.jsDocTags?.find(
-    (tag) => tag.name === "title",
-  );
-  if (info?.text?.length) return CommentFactory.merge(info.text);
-  else if (!schema.description?.length) return undefined;
-
-  const index: number = schema.description.indexOf("\n");
-  const top: string = (
-    index === -1 ? schema.description : schema.description.substring(0, index)
-  ).trim();
-  return top.endsWith(".") ? top.substring(0, top.length - 1) : undefined;
-};
+import { CommentFactory } from "../../factories/CommentFactory";
+
+import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
+
+export const json_schema_title = (schema: {
+  description?: string | null | undefined;
+  jsDocTags?: IJsDocTagInfo[] | undefined;
+}): string | undefined => {
+  const info: IJsDocTagInfo | undefined = schema.jsDocTags?.find(
+    (tag) => tag.name === "title",
+  );
+  if (info?.text?.length) return CommentFactory.merge(info.text);
+  else if (!schema.description?.length) return undefined;
+
+  const index: number = schema.description.indexOf("\n");
+  const top: string = (
+    index === -1 ? schema.description : schema.description.substring(0, index)
+  ).trim();
+  return top.endsWith(".") ? top.substring(0, top.length - 1) : undefined;
+};

package/src/programmers/internal/json_schema_tuple.ts

@@ -1,35 +1,35 @@
-import { OpenApi } from "@samchon/openapi";
-
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataTuple } from "../../schemas/metadata/MetadataTuple";
-
-import { json_schema_station } from "./json_schema_station";
-
-export const json_schema_tuple = (props: {
-  components: OpenApi.IComponents;
-  tuple: MetadataTuple;
-}): OpenApi.IJsonSchema.ITuple => {
-  const tail: Metadata | null = props.tuple.type.elements.at(-1)?.rest ?? null;
-  const prefixItems: Metadata[] = props.tuple.type.isRest()
-    ? props.tuple.type.elements.slice(0, -1)
-    : props.tuple.type.elements;
-  return {
-    type: "array",
-    prefixItems: prefixItems.map((metadata) =>
-      json_schema_station({
-        blockNever: false,
-        components: props.components,
-        metadata,
-        attribute: {},
-      }),
-    ),
-    additionalItems: tail
-      ? json_schema_station({
-          blockNever: false,
-          components: props.components,
-          metadata: tail,
-          attribute: {},
-        })
-      : false,
-  };
-};
+import { OpenApi } from "@samchon/openapi";
+
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataTuple } from "../../schemas/metadata/MetadataTuple";
+
+import { json_schema_station } from "./json_schema_station";
+
+export const json_schema_tuple = (props: {
+  components: OpenApi.IComponents;
+  tuple: MetadataTuple;
+}): OpenApi.IJsonSchema.ITuple => {
+  const tail: Metadata | null = props.tuple.type.elements.at(-1)?.rest ?? null;
+  const prefixItems: Metadata[] = props.tuple.type.isRest()
+    ? props.tuple.type.elements.slice(0, -1)
+    : props.tuple.type.elements;
+  return {
+    type: "array",
+    prefixItems: prefixItems.map((metadata) =>
+      json_schema_station({
+        blockNever: false,
+        components: props.components,
+        metadata,
+        attribute: {},
+      }),
+    ),
+    additionalItems: tail
+      ? json_schema_station({
+          blockNever: false,
+          components: props.components,
+          metadata: tail,
+          attribute: {},
+        })
+      : false,
+  };
+};