typia 6.7.2 → 6.8.0-dev.20240811

package/src/factories/internal/metadata/iterate_metadata_union.ts

@@ -1,27 +1,27 @@
-import ts from "typescript";
-
-import { Metadata } from "../../../schemas/metadata/Metadata";
-
-import { MetadataCollection } from "../../MetadataCollection";
-import { MetadataFactory } from "../../MetadataFactory";
-import { iterate_metadata } from "./iterate_metadata";
-
-export const iterate_metadata_union =
-  (checker: ts.TypeChecker) =>
-  (options: MetadataFactory.IOptions) =>
-  (collection: MetadataCollection) =>
-  (errors: MetadataFactory.IError[]) =>
-  (
-    meta: Metadata,
-    type: ts.Type,
-    explore: MetadataFactory.IExplore,
-  ): boolean => {
-    if (!type.isUnion()) return false;
-    type.types.forEach((t) =>
-      iterate_metadata(checker)(options)(collection)(errors)(meta, t, {
-        ...explore,
-        aliased: false,
-      }),
-    );
-    return true;
-  };
+import ts from "typescript";
+
+import { Metadata } from "../../../schemas/metadata/Metadata";
+
+import { MetadataCollection } from "../../MetadataCollection";
+import { MetadataFactory } from "../../MetadataFactory";
+import { iterate_metadata } from "./iterate_metadata";
+
+export const iterate_metadata_union =
+  (checker: ts.TypeChecker) =>
+  (options: MetadataFactory.IOptions) =>
+  (collection: MetadataCollection) =>
+  (errors: MetadataFactory.IError[]) =>
+  (
+    meta: Metadata,
+    type: ts.Type,
+    explore: MetadataFactory.IExplore,
+  ): boolean => {
+    if (!type.isUnion()) return false;
+    type.types.forEach((t) =>
+      iterate_metadata(checker)(options)(collection)(errors)(meta, t, {
+        ...explore,
+        aliased: false,
+      }),
+    );
+    return true;
+  };

package/src/programmers/internal/application_bigint.ts

@@ -0,0 +1,25 @@
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
+
+import { application_plugin } from "./application_plugin";
+
+/**
+ * @internal
+ */
+export const application_bigint = <Version extends "3.0" | "3.1">(
+  atomic: MetadataAtomic,
+): Schema<Version>[] =>
+  application_plugin(
+    {
+      type: "integer",
+    } satisfies Schema<Version>,
+    atomic.tags,
+  );
+
+/**
+ * @internal
+ */
+type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema.IInteger
+  : OpenApi.IJsonSchema.IInteger;

package/src/programmers/internal/application_v30_alias.ts

@@ -1,52 +1,52 @@
-import { OpenApiV3 } from "@samchon/openapi";
-
-import { CommentFactory } from "../../factories/CommentFactory";
-
-import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
-import { MetadataAlias } from "../../schemas/metadata/MetadataAlias";
-
-import { application_description } from "./application_description";
-import { application_v30_object } from "./application_v30_object";
-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;
-
-    const key: string = `${alias.name}${nullable ? ".Nullable" : ""}`;
-    const $ref: string = `#/components/schemas/${key}`;
-
-    if (components.schemas?.[key] === undefined) {
-      // TEMPORARY ASSIGNMENT
-      components.schemas ??= {};
-      components.schemas[key] = {};
-
-      // GENERATE SCHEMA
-      const schema: OpenApiV3.IJsonSchema | null = application_v30_schema(
-        blockNever,
-      )(components)({
-        deprecated:
-          alias.jsDocTags.some((tag) => tag.name === "deprecated") || undefined,
-        title: (() => {
-          const info: IJsDocTagInfo | undefined = 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 };
-  };
+import { OpenApiV3 } from "@samchon/openapi";
+
+import { CommentFactory } from "../../factories/CommentFactory";
+
+import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
+import { MetadataAlias } from "../../schemas/metadata/MetadataAlias";
+
+import { application_description } from "./application_description";
+import { application_v30_object } from "./application_v30_object";
+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;
+
+    const key: string = `${alias.name}${nullable ? ".Nullable" : ""}`;
+    const $ref: string = `#/components/schemas/${key}`;
+
+    if (components.schemas?.[key] === undefined) {
+      // TEMPORARY ASSIGNMENT
+      components.schemas ??= {};
+      components.schemas[key] = {};
+
+      // GENERATE SCHEMA
+      const schema: OpenApiV3.IJsonSchema | null = application_v30_schema(
+        blockNever,
+      )(components)({
+        deprecated:
+          alias.jsDocTags.some((tag) => tag.name === "deprecated") || undefined,
+        title: (() => {
+          const info: IJsDocTagInfo | undefined = 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 };
+  };

package/src/programmers/internal/application_v30_object.ts

@@ -1,149 +1,149 @@
-import { 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_v30_schema } from "./application_v30_schema";
-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 };
-  };
-
-/**
- * @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.functional === true &&
-        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,
-      )({
-        deprecated:
-          property.jsDocTags.some((tag) => tag.name === "deprecated") ||
-          undefined,
-        title: (() => {
-          const info: IJsDocTagInfo | undefined = property.jsDocTags.find(
-            (tag) => tag.name === "title",
-          );
-          if (info?.text?.length) return CommentFactory.merge(info.text);
-          else if (!property.description?.length) return undefined;
-
-          const index: number = property.description.indexOf("\n");
-          const top: string = (
-            index === -1
-              ? property.description
-              : property.description.substring(0, index)
-          ).trim();
-          return top.endsWith(".")
-            ? top.substring(0, top.length - 1)
-            : 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];
-      }
-    }
-
-    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),
-    };
-  };
-
-/**
- * @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;
-  };
-
-/**
- * @internal
- */
-interface ISuperfluous {
-  additionalProperties?: undefined | [Metadata, OpenApiV3.IJsonSchema];
-  patternProperties: Record<string, [Metadata, OpenApiV3.IJsonSchema]>;
-}
+import { 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_v30_schema } from "./application_v30_schema";
+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 };
+  };
+
+/**
+ * @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.functional === true &&
+        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,
+      )({
+        deprecated:
+          property.jsDocTags.some((tag) => tag.name === "deprecated") ||
+          undefined,
+        title: (() => {
+          const info: IJsDocTagInfo | undefined = property.jsDocTags.find(
+            (tag) => tag.name === "title",
+          );
+          if (info?.text?.length) return CommentFactory.merge(info.text);
+          else if (!property.description?.length) return undefined;
+
+          const index: number = property.description.indexOf("\n");
+          const top: string = (
+            index === -1
+              ? property.description
+              : property.description.substring(0, index)
+          ).trim();
+          return top.endsWith(".")
+            ? top.substring(0, top.length - 1)
+            : 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];
+      }
+    }
+
+    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),
+    };
+  };
+
+/**
+ * @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;
+  };
+
+/**
+ * @internal
+ */
+interface ISuperfluous {
+  additionalProperties?: undefined | [Metadata, OpenApiV3.IJsonSchema];
+  patternProperties: Record<string, [Metadata, OpenApiV3.IJsonSchema]>;
+}