typia 7.0.0-dev.20241003 → 7.0.0-dev.20241005

package/src/programmers/internal/application_array.ts

@@ -1,56 +1,56 @@
-import { OpenApi, OpenApiV3 } from "@samchon/openapi";
-
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataArray } from "../../schemas/metadata/MetadataArray";
-
-import { application_plugin } from "./application_plugin";
-
-/**
- * @internal
- */
-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();
-
-    props.components.schemas ??= {};
-    props.components.schemas[$ref] ??= {};
-
-    const oneOf: ArraySchema<Version>[] = factory();
-    Object.assign(
-      props.components.schemas[$ref]!,
-      oneOf.length === 1 ? oneOf[0] : { oneOf },
-    );
-    return out();
-  }
-  return factory();
-};
-
-/**
- * @internal
- */
-type ArraySchema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema.IArray
-  : OpenApi.IJsonSchema.IArray;
-
-/**
- * @internal
- */
-type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema
-  : OpenApi.IJsonSchema;
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataArray } from "../../schemas/metadata/MetadataArray";
+
+import { application_plugin } from "./application_plugin";
+
+/**
+ * @internal
+ */
+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();
+
+    props.components.schemas ??= {};
+    props.components.schemas[$ref] ??= {};
+
+    const oneOf: ArraySchema<Version>[] = factory();
+    Object.assign(
+      props.components.schemas[$ref]!,
+      oneOf.length === 1 ? oneOf[0] : { oneOf },
+    );
+    return out();
+  }
+  return factory();
+};
+
+/**
+ * @internal
+ */
+type ArraySchema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema.IArray
+  : OpenApi.IJsonSchema.IArray;
+
+/**
+ * @internal
+ */
+type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema
+  : OpenApi.IJsonSchema;

package/src/programmers/internal/application_boolean.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_boolean = <Version extends "3.0" | "3.1">(
-  atomic: MetadataAtomic,
-): Schema<Version>[] =>
-  application_plugin({
-    schema: {
-      type: "boolean",
-    } satisfies Schema<Version>,
-    tags: atomic.tags,
-  });
-
-/**
- * @internal
- */
-type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema.IBoolean
-  : OpenApi.IJsonSchema.IBoolean;
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
+
+import { application_plugin } from "./application_plugin";
+
+/**
+ * @internal
+ */
+export const application_boolean = <Version extends "3.0" | "3.1">(
+  atomic: MetadataAtomic,
+): Schema<Version>[] =>
+  application_plugin({
+    schema: {
+      type: "boolean",
+    } satisfies Schema<Version>,
+    tags: atomic.tags,
+  });
+
+/**
+ * @internal
+ */
+type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema.IBoolean
+  : OpenApi.IJsonSchema.IBoolean;

package/src/programmers/internal/application_description.ts

@@ -1,12 +1,12 @@
-import { IJsDocTagInfo } from "../../module";
-
-export const application_description = (props: {
-  description?: string | null | undefined;
-  jsDocTags?: IJsDocTagInfo[];
-}): string | undefined =>
-  props.jsDocTags
-    ?.find((tag) => tag.name === "description")
-    ?.text?.[0]?.text?.split("\r\n")
-    .join("\n") ??
-  props.description ??
-  undefined;
+import { IJsDocTagInfo } from "../../module";
+
+export const application_description = (props: {
+  description?: string | null | undefined;
+  jsDocTags?: IJsDocTagInfo[];
+}): string | undefined =>
+  props.jsDocTags
+    ?.find((tag) => tag.name === "description")
+    ?.text?.[0]?.text?.split("\r\n")
+    .join("\n") ??
+  props.description ??
+  undefined;

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_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 = (
-  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.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}`,
+      ]),
+    ),
+  };
+};

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