typia 7.0.0-dev.20241011 → 7.0.0-dev.20241012

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({
-    schema: {
-      type: "number",
-    } satisfies Schema<Version>,
-    tags: 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({
+    schema: {
+      type: "number",
+    } satisfies Schema<Version>,
+    tags: 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>(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 { IMetadataTypeTag } from "../../schemas/metadata/IMetadataTypeTag";
+
+/**
+ * @internal
+ */
+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 [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/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({
-    schema: {
-      type: "string",
-    } satisfies Schema<Version>,
-    tags: 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({
+    schema: {
+      type: "string",
+    } satisfies Schema<Version>,
+    tags: 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,64 +1,64 @@
-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({
-        top: true,
-        metadata: Metadata.create({
-          ...Metadata.initialize(),
-          templates: pureTemplates,
-        }),
-      }),
-    });
-  for (const tpl of taggedTemplates)
-    output.push(
-      application_plugin({
-        schema: {
-          type: "string",
-          pattern: metadata_to_pattern({
-            top: false,
-            metadata: Metadata.create({
-              ...Metadata.initialize(),
-              templates: [tpl],
-            }),
-          }),
-        },
-        tags: 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({
+        top: true,
+        metadata: Metadata.create({
+          ...Metadata.initialize(),
+          templates: pureTemplates,
+        }),
+      }),
+    });
+  for (const tpl of taggedTemplates)
+    output.push(
+      application_plugin({
+        schema: {
+          type: "string",
+          pattern: metadata_to_pattern({
+            top: false,
+            metadata: Metadata.create({
+              ...Metadata.initialize(),
+              templates: [tpl],
+            }),
+          }),
+        },
+        tags: 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_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 = (
-  metadata: Metadata,
-): OpenApi.IJsonSchema.IOneOf.IDiscriminator | undefined => {
-  if (
-    metadata.size() === 0 ||
-    metadata.size() !== metadata.objects.length ||
-    metadata.objects.some((o) => o.isLiteral()) === true
-  )
-    return undefined;
-  const specialized: UnionPredicator.ISpecialized[] = UnionPredicator.object(
-    metadata.objects,
-  );
-  const meet: boolean =
-    specialized.length === metadata.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 = (
+  metadata: Metadata,
+): OpenApi.IJsonSchema.IOneOf.IDiscriminator | undefined => {
+  if (
+    metadata.size() === 0 ||
+    metadata.size() !== metadata.objects.length ||
+    metadata.objects.some((o) => o.type.isLiteral()) === true
+  )
+    return undefined;
+  const specialized: UnionPredicator.ISpecialized[] = UnionPredicator.object(
+    metadata.objects.map((o) => o.type),
+  );
+  const meet: boolean =
+    specialized.length === metadata.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,59 +1,59 @@
-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>(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 = `${props.alias.name}${props.nullable ? ".Nullable" : ""}`;
-  const $ref: string = `#/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: props.blockNever,
-      components: props.components,
-      attribute: {
-        deprecated:
-          props.alias.jsDocTags.some((tag) => tag.name === "deprecated") ||
-          undefined,
-        title: (() => {
-          const info: IJsDocTagInfo | undefined = props.alias.jsDocTags.find(
-            (tag) => tag.name === "title",
-          );
-          return info?.text?.length
-            ? CommentFactory.merge(info.text)
-            : undefined;
-        })(),
-        description: application_description(props.alias),
-      },
-      metadata: props.alias.value,
-    });
-    if (schema !== null) Object.assign(props.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>(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]!.type,
+      components: props.components,
+      nullable: props.nullable,
+    }) as OpenApiV3.IJsonSchema.IReference;
+
+  const key: string = `${props.alias.name}${props.nullable ? ".Nullable" : ""}`;
+  const $ref: string = `#/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: props.blockNever,
+      components: props.components,
+      attribute: {
+        deprecated:
+          props.alias.jsDocTags.some((tag) => tag.name === "deprecated") ||
+          undefined,
+        title: (() => {
+          const info: IJsDocTagInfo | undefined = props.alias.jsDocTags.find(
+            (tag) => tag.name === "title",
+          );
+          return info?.text?.length
+            ? CommentFactory.merge(info.text)
+            : undefined;
+        })(),
+        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

@@ -1,29 +1,29 @@
-import { OpenApiV3 } from "@samchon/openapi";
-
-/**
- * @internal
- */
-export const application_v30_native = (props: {
-  components: OpenApiV3.IComponents;
-  name: string;
-  nullable: boolean;
-}): OpenApiV3.IJsonSchema => {
-  if (props.name === "Blob" || props.name === "File")
-    return {
-      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}`,
-  };
-};
+import { OpenApiV3 } from "@samchon/openapi";
+
+/**
+ * @internal
+ */
+export const application_v30_native = (props: {
+  components: OpenApiV3.IComponents;
+  name: string;
+  nullable: boolean;
+}): OpenApiV3.IJsonSchema => {
+  if (props.name === "Blob" || props.name === "File")
+    return {
+      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}`,
+  };
+};