typia 6.6.2 → 6.7.0-dev.20240802

package/src/programmers/internal/application_escaped.ts

@@ -1,76 +1,76 @@
-import { OpenApi, OpenApiV3 } from "@samchon/openapi";
-
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataEscaped } from "../../schemas/metadata/MetadataEscaped";
-
-/**
- * @internal
- */
-export const application_escaped =
-  <Version extends "3.0" | "3.1">(
-    generator: (meta: Metadata) => Schema<Version>,
-  ) =>
-  (resolved: MetadataEscaped): Schema<Version>[] => {
-    const output: Schema<Version> | null = generator(resolved.returns);
-    if (output === null) return [];
-
-    if (is_date(new Set())(resolved.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 OneOfSchema<Version>[])
-      : [output];
-  };
-
-/**
- * @internal
- */
-const is_string = <Version extends "3.0" | "3.1">(
-  elem: Schema<Version>,
-): elem is StringSchema<Version> =>
-  (elem as StringSchema<Version>).type === "string";
-
-/**
- * @internal
- */
-const is_one_of = <Version extends "3.0" | "3.1">(
-  elem: Schema<Version>,
-): elem is OneOfSchema<Version> =>
-  Array.isArray((elem as OneOfSchema<Version>).oneOf);
-
-/**
- * @internal
- */
-const is_date =
-  (visited: Set<Metadata>) =>
-  (meta: Metadata): boolean => {
-    if (visited.has(meta)) return false;
-    visited.add(meta);
-
-    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))
-    );
-  };
-
-type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema
-  : OpenApi.IJsonSchema;
-type StringSchema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema.IString
-  : OpenApi.IJsonSchema.IString;
-type OneOfSchema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema.IOneOf
-  : OpenApi.IJsonSchema.IOneOf;
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataEscaped } from "../../schemas/metadata/MetadataEscaped";
+
+/**
+ * @internal
+ */
+export const application_escaped =
+  <Version extends "3.0" | "3.1">(
+    generator: (meta: Metadata) => Schema<Version>,
+  ) =>
+  (resolved: MetadataEscaped): Schema<Version>[] => {
+    const output: Schema<Version> | null = generator(resolved.returns);
+    if (output === null) return [];
+
+    if (is_date(new Set())(resolved.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 OneOfSchema<Version>[])
+      : [output];
+  };
+
+/**
+ * @internal
+ */
+const is_string = <Version extends "3.0" | "3.1">(
+  elem: Schema<Version>,
+): elem is StringSchema<Version> =>
+  (elem as StringSchema<Version>).type === "string";
+
+/**
+ * @internal
+ */
+const is_one_of = <Version extends "3.0" | "3.1">(
+  elem: Schema<Version>,
+): elem is OneOfSchema<Version> =>
+  Array.isArray((elem as OneOfSchema<Version>).oneOf);
+
+/**
+ * @internal
+ */
+const is_date =
+  (visited: Set<Metadata>) =>
+  (meta: Metadata): boolean => {
+    if (visited.has(meta)) return false;
+    visited.add(meta);
+
+    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))
+    );
+  };
+
+type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema
+  : OpenApi.IJsonSchema;
+type StringSchema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema.IString
+  : OpenApi.IJsonSchema.IString;
+type OneOfSchema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema.IOneOf
+  : OpenApi.IJsonSchema.IOneOf;

package/src/programmers/internal/application_number.ts

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

package/src/programmers/internal/application_plugin.ts

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

package/src/programmers/internal/application_string.ts

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

package/src/programmers/internal/application_templates.ts

@@ -1,62 +1,62 @@
-import { OpenApi, OpenApiV3 } from "@samchon/openapi";
-
-import { IMetadataTypeTag } from "../../schemas/metadata/IMetadataTypeTag";
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataTemplate } from "../../schemas/metadata/MetadataTemplate";
-
-import { application_plugin } from "./application_plugin";
-import { metadata_to_pattern } from "./metadata_to_pattern";
-
-/**
- * @internal
- */
-export const application_templates = <Version extends "3.0" | "3.1">(
-  meta: Metadata,
-): Schema<Version>[] => {
-  const pureTemplates: MetadataTemplate[] = meta.templates.filter(
-    (t) => isPure(t.tags ?? []) === true,
-  );
-  const taggedTemplates: MetadataTemplate[] = meta.templates.filter(
-    (t) => isPure(t.tags ?? []) === false,
-  );
-
-  const output: Schema<Version>[] = [];
-  if (pureTemplates.length)
-    output.push({
-      type: "string",
-      pattern: metadata_to_pattern(true)(
-        Metadata.create({
-          ...Metadata.initialize(),
-          templates: pureTemplates,
-        }),
-      ),
-    });
-  for (const tpl of taggedTemplates)
-    output.push(
-      application_plugin(
-        {
-          type: "string",
-          pattern: metadata_to_pattern(false)(
-            Metadata.create({
-              ...Metadata.initialize(),
-              templates: [tpl],
-            }),
-          ),
-        },
-        tpl.tags ?? [],
-      ) as any,
-    );
-  return output;
-};
-
-const isPure = (matrix: IMetadataTypeTag[][]) =>
-  matrix.every((tags) => filter(tags).length === 0);
-const filter = (tags: IMetadataTypeTag[]) =>
-  tags.filter((t) => t.schema !== undefined);
-
-/**
- * @internal
- */
-type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema.IString
-  : OpenApi.IJsonSchema.IString;
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+import { IMetadataTypeTag } from "../../schemas/metadata/IMetadataTypeTag";
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataTemplate } from "../../schemas/metadata/MetadataTemplate";
+
+import { application_plugin } from "./application_plugin";
+import { metadata_to_pattern } from "./metadata_to_pattern";
+
+/**
+ * @internal
+ */
+export const application_templates = <Version extends "3.0" | "3.1">(
+  meta: Metadata,
+): Schema<Version>[] => {
+  const pureTemplates: MetadataTemplate[] = meta.templates.filter(
+    (t) => isPure(t.tags ?? []) === true,
+  );
+  const taggedTemplates: MetadataTemplate[] = meta.templates.filter(
+    (t) => isPure(t.tags ?? []) === false,
+  );
+
+  const output: Schema<Version>[] = [];
+  if (pureTemplates.length)
+    output.push({
+      type: "string",
+      pattern: metadata_to_pattern(true)(
+        Metadata.create({
+          ...Metadata.initialize(),
+          templates: pureTemplates,
+        }),
+      ),
+    });
+  for (const tpl of taggedTemplates)
+    output.push(
+      application_plugin(
+        {
+          type: "string",
+          pattern: metadata_to_pattern(false)(
+            Metadata.create({
+              ...Metadata.initialize(),
+              templates: [tpl],
+            }),
+          ),
+        },
+        tpl.tags ?? [],
+      ) as any,
+    );
+  return output;
+};
+
+const isPure = (matrix: IMetadataTypeTag[][]) =>
+  matrix.every((tags) => filter(tags).length === 0);
+const filter = (tags: IMetadataTypeTag[]) =>
+  tags.filter((t) => t.schema !== undefined);
+
+/**
+ * @internal
+ */
+type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema.IString
+  : OpenApi.IJsonSchema.IString;

package/src/programmers/internal/application_title.ts

@@ -1,20 +1,20 @@
-import { CommentFactory } from "../../factories/CommentFactory";
-
-import { IJsDocTagInfo } from "../../module";
-
-export const application_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 "../../module";
+
+export const application_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/application_union_discriminator.ts

@@ -1,35 +1,35 @@
-import { OpenApi } from "@samchon/openapi";
-
-import { Metadata } from "../../schemas/metadata/Metadata";
-
-import { UnionPredicator } from "../helpers/UnionPredicator";
-
-export const application_union_discriminator = (
-  meta: Metadata,
-): OpenApi.IJsonSchema.IOneOf.IDiscriminator | undefined => {
-  if (
-    meta.size() === 0 ||
-    meta.size() !== meta.objects.length ||
-    meta.objects.some((o) => o.isLiteral()) === true
-  )
-    return undefined;
-  const specialized: UnionPredicator.ISpecialized[] = UnionPredicator.object(
-    meta.objects,
-  );
-  const meet: boolean =
-    specialized.length === meta.objects.length &&
-    specialized.every(
-      (s) => s.property.key.isSoleLiteral() && s.property.value.isSoleLiteral(),
-    ) &&
-    new Set(specialized.map((s) => s.property.key.getSoleLiteral())).size === 1;
-  if (meet === false) return undefined;
-  return {
-    propertyName: specialized[0]!.property.key.getSoleLiteral()!,
-    mapping: Object.fromEntries(
-      specialized.map((s) => [
-        s.property.value.getSoleLiteral()!,
-        `#/components/schemas/${s.object.name}`,
-      ]),
-    ),
-  };
-};
+import { OpenApi } from "@samchon/openapi";
+
+import { Metadata } from "../../schemas/metadata/Metadata";
+
+import { UnionPredicator } from "../helpers/UnionPredicator";
+
+export const application_union_discriminator = (
+  meta: Metadata,
+): OpenApi.IJsonSchema.IOneOf.IDiscriminator | undefined => {
+  if (
+    meta.size() === 0 ||
+    meta.size() !== meta.objects.length ||
+    meta.objects.some((o) => o.isLiteral()) === true
+  )
+    return undefined;
+  const specialized: UnionPredicator.ISpecialized[] = UnionPredicator.object(
+    meta.objects,
+  );
+  const meet: boolean =
+    specialized.length === meta.objects.length &&
+    specialized.every(
+      (s) => s.property.key.isSoleLiteral() && s.property.value.isSoleLiteral(),
+    ) &&
+    new Set(specialized.map((s) => s.property.key.getSoleLiteral())).size === 1;
+  if (meet === false) return undefined;
+  return {
+    propertyName: specialized[0]!.property.key.getSoleLiteral()!,
+    mapping: Object.fromEntries(
+      specialized.map((s) => [
+        s.property.value.getSoleLiteral()!,
+        `#/components/schemas/${s.object.name}`,
+      ]),
+    ),
+  };
+};

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 };
+  };