typia 7.0.0-dev.20241005 → 7.0.0-dev.20241008

package/src/programmers/internal/application_escaped.ts

@@ -1,96 +1,96 @@
-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">(props: {
-  generator: (meta: Metadata) => Schema<Version>;
-  escaped: MetadataEscaped;
-}): Schema<Version>[] => {
-  const output: Schema<Version> | null = props.generator(props.escaped.returns);
-  if (output === null) return [];
-
-  if (
-    is_date({
-      visited: new Set(),
-      metadata: props.escaped.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 Schema<Version>[]) : [output];
-};
-
-/**
- * @internal
- */
-const is_string = <Version extends "3.0" | "3.1">(
-  schema: Schema<Version>,
-): schema is StringSchema<Version> =>
-  (schema as StringSchema<Version>).type === "string";
-
-/**
- * @internal
- */
-const is_one_of = <Version extends "3.0" | "3.1">(
-  schema: Schema<Version>,
-): schema is OneOfSchema<Version> =>
-  Array.isArray((schema as OneOfSchema<Version>).oneOf);
-
-/**
- * @internal
- */
-const is_date = (props: {
-  visited: Set<Metadata>;
-  metadata: Metadata;
-}): boolean => {
-  if (props.visited.has(props.metadata)) return false;
-  props.visited.add(props.metadata);
-
-  return (
-    props.metadata.natives.some((name) => name === "Date") ||
-    props.metadata.arrays.some((array) =>
-      is_date({
-        visited: props.visited,
-        metadata: array.type.value,
-      }),
-    ) ||
-    props.metadata.tuples.some((tuple) =>
-      tuple.type.elements.some((e) =>
-        is_date({
-          visited: props.visited,
-          metadata: e,
-        }),
-      ),
-    ) ||
-    props.metadata.aliases.some((alias) =>
-      is_date({
-        visited: props.visited,
-        metadata: 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">(props: {
+  generator: (meta: Metadata) => Schema<Version>;
+  escaped: MetadataEscaped;
+}): Schema<Version>[] => {
+  const output: Schema<Version> | null = props.generator(props.escaped.returns);
+  if (output === null) return [];
+
+  if (
+    is_date({
+      visited: new Set(),
+      metadata: props.escaped.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 Schema<Version>[]) : [output];
+};
+
+/**
+ * @internal
+ */
+const is_string = <Version extends "3.0" | "3.1">(
+  schema: Schema<Version>,
+): schema is StringSchema<Version> =>
+  (schema as StringSchema<Version>).type === "string";
+
+/**
+ * @internal
+ */
+const is_one_of = <Version extends "3.0" | "3.1">(
+  schema: Schema<Version>,
+): schema is OneOfSchema<Version> =>
+  Array.isArray((schema as OneOfSchema<Version>).oneOf);
+
+/**
+ * @internal
+ */
+const is_date = (props: {
+  visited: Set<Metadata>;
+  metadata: Metadata;
+}): boolean => {
+  if (props.visited.has(props.metadata)) return false;
+  props.visited.add(props.metadata);
+
+  return (
+    props.metadata.natives.some((name) => name === "Date") ||
+    props.metadata.arrays.some((array) =>
+      is_date({
+        visited: props.visited,
+        metadata: array.type.value,
+      }),
+    ) ||
+    props.metadata.tuples.some((tuple) =>
+      tuple.type.elements.some((e) =>
+        is_date({
+          visited: props.visited,
+          metadata: e,
+        }),
+      ),
+    ) ||
+    props.metadata.aliases.some((alias) =>
+      is_date({
+        visited: props.visited,
+        metadata: 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({
-    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}`,
+      ]),
+    ),
+  };
+};