typia 5.0.0-dev.20230821 → 5.0.0-dev.20230822

package/src/programmers/internal/application_schema.ts

@@ -1,157 +1,157 @@
-import { IJsonComponents } from "../../schemas/json/IJsonComponents";
-import { IJsonSchema } from "../../schemas/json/IJsonSchema";
-import { Metadata } from "../../schemas/metadata/Metadata";
-
-import { AtomicPredicator } from "../helpers/AtomicPredicator";
-import { JsonApplicationProgrammer } from "../json/JsonApplicationProgrammer";
-import { application_alias } from "./application_alias";
-import { application_array } from "./application_array";
-import { application_boolean } from "./application_boolean";
-import { application_constant } from "./application_constant";
-import { application_native } from "./application_native";
-import { application_number } from "./application_number";
-import { application_object } from "./application_object";
-import { application_resolved } from "./application_resolved";
-import { application_string } from "./application_string";
-import { application_templates } from "./application_templates";
-import { application_tuple } from "./application_tuple";
-
-/**
- * @internal
- */
-export const application_schema =
-    (options: JsonApplicationProgrammer.IOptions) =>
-    <BlockNever extends boolean>(blockNever: BlockNever) =>
-    (components: IJsonComponents) =>
-    (meta: Metadata) =>
-    (
-        attribute: IJsonSchema.IAttribute,
-    ): BlockNever extends true ? IJsonSchema | null : IJsonSchema => {
-        // VULNERABLE CASE
-        if (meta.any === true)
-            return {
-                ...attribute,
-                type: undefined,
-            };
-        else if (meta.nullable && meta.empty())
-            return { type: "null", ...attribute };
-
-        //----
-        // GATHER UNION SCHEMAS
-        //----
-        const union: IJsonSchema[] = [];
-        if (meta.nullable && options.purpose !== "swagger")
-            union.push({
-                ...attribute,
-                type: "null",
-            });
-
-        const insert =
-            meta.nullable && options.purpose === "swagger"
-                ? (s: IJsonSchema) =>
-                      union.push({
-                          ...s,
-                          nullable: (s as IJsonSchema.ISignificant<any>).type
-                              ? true
-                              : undefined,
-                      } as IJsonSchema)
-                : (schema: IJsonSchema) => union.push(schema);
-
-        // toJSON() METHOD
-        if (meta.resolved !== null)
-            union.push(
-                ...application_resolved(options)(blockNever)(components)(
-                    meta.resolved,
-                )(attribute),
-            );
-
-        // ATOMIC TYPES
-        if (meta.templates.length && AtomicPredicator.template(meta))
-            insert(application_templates(meta)(attribute));
-        for (const constant of meta.constants)
-            if (constant.type === "bigint") throw new Error(NO_BIGINT);
-            else if (
-                (constant.type === "string" && meta.templates.length) ||
-                AtomicPredicator.constant(meta)(constant.type) === false
-            )
-                continue;
-            else insert(application_constant(constant)(attribute));
-        for (const type of meta.atomics)
-            if (type === "bigint") throw new Error(NO_BIGINT);
-            else if (AtomicPredicator.atomic(meta)(type) === false) continue;
-            else
-                insert(
-                    type === "string"
-                        ? application_string(meta)(attribute)
-                        : type === "boolean"
-                        ? application_boolean(attribute)
-                        : application_number(attribute),
-                );
-
-        // ARRAY
-        for (const array of meta.arrays)
-            insert(application_array(options)(components)(array)(attribute));
-
-        // TUPLE
-        for (const tuple of meta.tuples)
-            insert(application_tuple(options)(components)(tuple)(attribute));
-
-        // NATIVES
-        for (const native of meta.natives)
-            if (AtomicPredicator.native(native))
-                insert(
-                    native === "String"
-                        ? application_string(meta)(attribute)
-                        : native === "Boolean"
-                        ? application_boolean(attribute)
-                        : application_number(attribute),
-                );
-            else
-                insert(
-                    application_native(options)(components)(native)({
-                        nullable: meta.nullable,
-                        attribute,
-                    }),
-                );
-        if (meta.sets.length)
-            insert(
-                application_native(options)(components)(`Set`)({
-                    nullable: meta.nullable,
-                    attribute,
-                }),
-            );
-        if (meta.maps.length)
-            insert(
-                application_native(options)(components)(`Map`)({
-                    nullable: meta.nullable,
-                    attribute,
-                }),
-            );
-
-        // OBJECT
-        for (const obj of meta.objects)
-            insert(application_object(options)(components)(obj)(meta.nullable));
-
-        // ALIASES
-        for (const alias of meta.aliases)
-            insert(
-                application_alias(options)(blockNever)(components)(alias)(
-                    meta.nullable,
-                ),
-            );
-
-        //----
-        // RETURNS
-        //----
-        if (union.length === 0)
-            return blockNever === true
-                ? null!
-                : {
-                      ...attribute,
-                      type: undefined,
-                  };
-        else if (union.length === 1) return union[0]!;
-        return { oneOf: union, ...attribute };
-    };
-
-const NO_BIGINT = "Error on typia.application(): does not allow bigint type.";
+import { IJsonComponents } from "../../schemas/json/IJsonComponents";
+import { IJsonSchema } from "../../schemas/json/IJsonSchema";
+import { Metadata } from "../../schemas/metadata/Metadata";
+
+import { AtomicPredicator } from "../helpers/AtomicPredicator";
+import { JsonApplicationProgrammer } from "../json/JsonApplicationProgrammer";
+import { application_alias } from "./application_alias";
+import { application_array } from "./application_array";
+import { application_boolean } from "./application_boolean";
+import { application_constant } from "./application_constant";
+import { application_native } from "./application_native";
+import { application_number } from "./application_number";
+import { application_object } from "./application_object";
+import { application_resolved } from "./application_resolved";
+import { application_string } from "./application_string";
+import { application_templates } from "./application_templates";
+import { application_tuple } from "./application_tuple";
+
+/**
+ * @internal
+ */
+export const application_schema =
+    (options: JsonApplicationProgrammer.IOptions) =>
+    <BlockNever extends boolean>(blockNever: BlockNever) =>
+    (components: IJsonComponents) =>
+    (meta: Metadata) =>
+    (
+        attribute: IJsonSchema.IAttribute,
+    ): BlockNever extends true ? IJsonSchema | null : IJsonSchema => {
+        // VULNERABLE CASE
+        if (meta.any === true)
+            return {
+                ...attribute,
+                type: undefined,
+            };
+        else if (meta.nullable && meta.empty())
+            return { type: "null", ...attribute };
+
+        //----
+        // GATHER UNION SCHEMAS
+        //----
+        const union: IJsonSchema[] = [];
+        if (meta.nullable && options.purpose !== "swagger")
+            union.push({
+                ...attribute,
+                type: "null",
+            });
+
+        const insert =
+            meta.nullable && options.purpose === "swagger"
+                ? (s: IJsonSchema) =>
+                      union.push({
+                          ...s,
+                          nullable: (s as IJsonSchema.ISignificant<any>).type
+                              ? true
+                              : undefined,
+                      } as IJsonSchema)
+                : (schema: IJsonSchema) => union.push(schema);
+
+        // toJSON() METHOD
+        if (meta.resolved !== null)
+            union.push(
+                ...application_resolved(options)(blockNever)(components)(
+                    meta.resolved,
+                )(attribute),
+            );
+
+        // ATOMIC TYPES
+        if (meta.templates.length && AtomicPredicator.template(meta))
+            insert(application_templates(meta)(attribute));
+        for (const constant of meta.constants)
+            if (constant.type === "bigint") throw new Error(NO_BIGINT);
+            else if (
+                (constant.type === "string" && meta.templates.length) ||
+                AtomicPredicator.constant(meta)(constant.type) === false
+            )
+                continue;
+            else insert(application_constant(constant)(attribute));
+        for (const type of meta.atomics)
+            if (type === "bigint") throw new Error(NO_BIGINT);
+            else if (AtomicPredicator.atomic(meta)(type) === false) continue;
+            else
+                insert(
+                    type === "string"
+                        ? application_string(meta)(attribute)
+                        : type === "boolean"
+                        ? application_boolean(attribute)
+                        : application_number(attribute),
+                );
+
+        // ARRAY
+        for (const array of meta.arrays)
+            insert(application_array(options)(components)(array)(attribute));
+
+        // TUPLE
+        for (const tuple of meta.tuples)
+            insert(application_tuple(options)(components)(tuple)(attribute));
+
+        // NATIVES
+        for (const native of meta.natives)
+            if (AtomicPredicator.native(native))
+                insert(
+                    native === "String"
+                        ? application_string(meta)(attribute)
+                        : native === "Boolean"
+                        ? application_boolean(attribute)
+                        : application_number(attribute),
+                );
+            else
+                insert(
+                    application_native(options)(components)(native)({
+                        nullable: meta.nullable,
+                        attribute,
+                    }),
+                );
+        if (meta.sets.length)
+            insert(
+                application_native(options)(components)(`Set`)({
+                    nullable: meta.nullable,
+                    attribute,
+                }),
+            );
+        if (meta.maps.length)
+            insert(
+                application_native(options)(components)(`Map`)({
+                    nullable: meta.nullable,
+                    attribute,
+                }),
+            );
+
+        // OBJECT
+        for (const obj of meta.objects)
+            insert(application_object(options)(components)(obj)(meta.nullable));
+
+        // ALIASES
+        for (const alias of meta.aliases)
+            insert(
+                application_alias(options)(blockNever)(components)(alias)(
+                    meta.nullable,
+                ),
+            );
+
+        //----
+        // RETURNS
+        //----
+        if (union.length === 0)
+            return blockNever === true
+                ? null!
+                : {
+                      ...attribute,
+                      type: undefined,
+                  };
+        else if (union.length === 1) return union[0]!;
+        return { oneOf: union, ...attribute };
+    };
+
+const NO_BIGINT = "Error on typia.application(): does not allow bigint type.";

package/src/programmers/internal/application_string.ts

@@ -1,44 +1,44 @@
-import { IJsonSchema } from "../../schemas/json/IJsonSchema";
-import { IMetadataTag } from "../../schemas/metadata/IMetadataTag";
-import { Metadata } from "../../schemas/metadata/Metadata";
-
-import { application_default_string } from "./application_default_string";
-
-/**
- * @internal
- */
-export const application_string =
-    (meta: Metadata) =>
-    (attribute: IJsonSchema.IAttribute): IJsonSchema.IString => {
-        const output: IJsonSchema.IString = {
-            ...attribute,
-            type: "string",
-        };
-
-        // FORMAT TAG OF METADATA
-        const formatJsdocTag = attribute["x-typia-jsDocTags"]?.find(
-            (tag) => tag.name === "format",
-        );
-        if (formatJsdocTag?.text?.length)
-            output.format = formatJsdocTag?.text.map((t) => t.text).join(" ");
-
-        // REGULAR TAGS COMPATIBLE WITH JSON-SCHEMA
-        for (const tag of attribute["x-typia-metaTags"] ?? []) {
-            // RANGE
-            if (tag.kind === "minLength") output.minLength = tag.value;
-            else if (tag.kind === "maxLength") output.maxLength = tag.value;
-            // FORMAT AND PATTERN
-            else if (tag.kind === "format")
-                output.format = emendFormat(tag.value);
-            else if (tag.kind === "pattern") output.pattern = tag.value;
-        }
-
-        // DEFAULT CONFIGURATION
-        output.default = application_default_string(meta)(attribute)(output);
-
-        // RETURNS
-        return output;
-    };
-
-const emendFormat = (tag: IMetadataTag.IFormat["value"]) =>
-    tag === "datetime" ? "date-time" : tag;
+import { IJsonSchema } from "../../schemas/json/IJsonSchema";
+import { IMetadataTag } from "../../schemas/metadata/IMetadataTag";
+import { Metadata } from "../../schemas/metadata/Metadata";
+
+import { application_default_string } from "./application_default_string";
+
+/**
+ * @internal
+ */
+export const application_string =
+    (meta: Metadata) =>
+    (attribute: IJsonSchema.IAttribute): IJsonSchema.IString => {
+        const output: IJsonSchema.IString = {
+            ...attribute,
+            type: "string",
+        };
+
+        // FORMAT TAG OF METADATA
+        const formatJsdocTag = attribute["x-typia-jsDocTags"]?.find(
+            (tag) => tag.name === "format",
+        );
+        if (formatJsdocTag?.text?.length)
+            output.format = formatJsdocTag?.text.map((t) => t.text).join(" ");
+
+        // REGULAR TAGS COMPATIBLE WITH JSON-SCHEMA
+        for (const tag of attribute["x-typia-metaTags"] ?? []) {
+            // RANGE
+            if (tag.kind === "minLength") output.minLength = tag.value;
+            else if (tag.kind === "maxLength") output.maxLength = tag.value;
+            // FORMAT AND PATTERN
+            else if (tag.kind === "format")
+                output.format = emendFormat(tag.value);
+            else if (tag.kind === "pattern") output.pattern = tag.value;
+        }
+
+        // DEFAULT CONFIGURATION
+        output.default = application_default_string(meta)(attribute)(output);
+
+        // RETURNS
+        return output;
+    };
+
+const emendFormat = (tag: IMetadataTag.IFormat["value"]) =>
+    tag === "datetime" ? "date-time" : tag;

package/src/programmers/internal/application_templates.ts

@@ -1,25 +1,25 @@
-import { IJsonSchema } from "../../schemas/json/IJsonSchema";
-import { Metadata } from "../../schemas/metadata/Metadata";
-
-import { application_default_string } from "./application_default_string";
-import { metadata_to_pattern } from "./metadata_to_pattern";
-
-/**
- * @internal
- */
-export const application_templates =
-    (meta: Metadata) =>
-    (attribute: IJsonSchema.IAttribute): IJsonSchema.IString => {
-        // CONSTRUCT PATTERN
-        const output: IJsonSchema.IString = {
-            type: "string",
-            ...attribute,
-        };
-        output.pattern = metadata_to_pattern(true)(meta);
-
-        // DEFAULT VALUE
-        output.default = application_default_string(meta)(attribute)(output);
-
-        // RETURNS
-        return output;
-    };
+import { IJsonSchema } from "../../schemas/json/IJsonSchema";
+import { Metadata } from "../../schemas/metadata/Metadata";
+
+import { application_default_string } from "./application_default_string";
+import { metadata_to_pattern } from "./metadata_to_pattern";
+
+/**
+ * @internal
+ */
+export const application_templates =
+    (meta: Metadata) =>
+    (attribute: IJsonSchema.IAttribute): IJsonSchema.IString => {
+        // CONSTRUCT PATTERN
+        const output: IJsonSchema.IString = {
+            type: "string",
+            ...attribute,
+        };
+        output.pattern = metadata_to_pattern(true)(meta);
+
+        // DEFAULT VALUE
+        output.default = application_default_string(meta)(attribute)(output);
+
+        // RETURNS
+        return output;
+    };

package/src/programmers/internal/application_tuple.ts

@@ -1,57 +1,57 @@
-import { IJsonComponents } from "../../schemas/json/IJsonComponents";
-import { IJsonSchema } from "../../schemas/json/IJsonSchema";
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataTuple } from "../../schemas/metadata/MetadataTuple";
-
-import { JsonApplicationProgrammer } from "../json/JsonApplicationProgrammer";
-import { application_schema } from "./application_schema";
-
-/**
- * @internal
- */
-export const application_tuple =
-    (options: JsonApplicationProgrammer.IOptions) =>
-    (components: IJsonComponents) =>
-    (tuple: MetadataTuple) =>
-    (
-        attribute: IJsonSchema.IAttribute,
-    ): IJsonSchema.ITuple | IJsonSchema.IArray => {
-        const schema: IJsonSchema.ITuple = {
-            type: "array",
-            items: tuple.elements.map((meta, i) =>
-                application_schema(options)(false)(components)(
-                    meta.rest ?? meta,
-                )({
-                    ...attribute,
-                    "x-typia-rest":
-                        i === tuple.elements.length - 1 && meta.rest !== null,
-                    "x-typia-required": meta.required,
-                    "x-typia-optional": meta.optional,
-                }),
-            ),
-            ...attribute,
-            minItems: !!tuple.elements.at(-1)?.rest
-                ? tuple.elements.length - 1
-                : tuple.elements.filter((x) => !x.optional).length,
-            maxItems: !!tuple.elements.at(-1)?.rest
-                ? undefined
-                : tuple.elements.length,
-        };
-        if (options.purpose === "ajv")
-            if (tuple.elements.length === 0) return schema;
-            else if (!tuple.elements.at(-1)?.rest) return schema;
-
-        const wrapper: IJsonSchema.IArray = {
-            ...schema,
-            items: application_schema(options)(false)(components)(
-                tuple.elements.reduce(
-                    (x, y) => Metadata.merge(x.rest ?? x, y.rest ?? y),
-                    Metadata.initialize(),
-                ),
-            )(tuple.recursive ? {} : attribute),
-            "x-typia-tuple": schema,
-            minItems: schema.minItems,
-            maxItems: schema.maxItems,
-        };
-        return wrapper;
-    };
+import { IJsonComponents } from "../../schemas/json/IJsonComponents";
+import { IJsonSchema } from "../../schemas/json/IJsonSchema";
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataTuple } from "../../schemas/metadata/MetadataTuple";
+
+import { JsonApplicationProgrammer } from "../json/JsonApplicationProgrammer";
+import { application_schema } from "./application_schema";
+
+/**
+ * @internal
+ */
+export const application_tuple =
+    (options: JsonApplicationProgrammer.IOptions) =>
+    (components: IJsonComponents) =>
+    (tuple: MetadataTuple) =>
+    (
+        attribute: IJsonSchema.IAttribute,
+    ): IJsonSchema.ITuple | IJsonSchema.IArray => {
+        const schema: IJsonSchema.ITuple = {
+            type: "array",
+            items: tuple.elements.map((meta, i) =>
+                application_schema(options)(false)(components)(
+                    meta.rest ?? meta,
+                )({
+                    ...attribute,
+                    "x-typia-rest":
+                        i === tuple.elements.length - 1 && meta.rest !== null,
+                    "x-typia-required": meta.required,
+                    "x-typia-optional": meta.optional,
+                }),
+            ),
+            ...attribute,
+            minItems: !!tuple.elements.at(-1)?.rest
+                ? tuple.elements.length - 1
+                : tuple.elements.filter((x) => !x.optional).length,
+            maxItems: !!tuple.elements.at(-1)?.rest
+                ? undefined
+                : tuple.elements.length,
+        };
+        if (options.purpose === "ajv")
+            if (tuple.elements.length === 0) return schema;
+            else if (!tuple.elements.at(-1)?.rest) return schema;
+
+        const wrapper: IJsonSchema.IArray = {
+            ...schema,
+            items: application_schema(options)(false)(components)(
+                tuple.elements.reduce(
+                    (x, y) => Metadata.merge(x.rest ?? x, y.rest ?? y),
+                    Metadata.initialize(),
+                ),
+            )(tuple.recursive ? {} : attribute),
+            "x-typia-tuple": schema,
+            minItems: schema.minItems,
+            maxItems: schema.maxItems,
+        };
+        return wrapper;
+    };

package/src/programmers/internal/check_array.ts

@@ -1,30 +1,30 @@
-import ts from "typescript";
-
-import { ExpressionFactory } from "../../factories/ExpressionFactory";
-import { IdentifierFactory } from "../../factories/IdentifierFactory";
-
-import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
-import { IMetadataTag } from "../../schemas/metadata/IMetadataTag";
-
-import { FunctionImporter } from "../helpers/FunctionImporeter";
-import { ICheckEntry } from "../helpers/ICheckEntry";
-import { check_array_length } from "./check_array_length";
-import { check_custom } from "./check_custom";
-
-/**
- * @internal
- */
-export const check_array =
-    (importer: FunctionImporter) =>
-    (metaTags: IMetadataTag[]) =>
-    (jsDocTags: IJsDocTagInfo[]) =>
-    (input: ts.Expression): ICheckEntry => ({
-        expression: ExpressionFactory.isArray(input),
-        tags: [
-            ...check_array_length(metaTags)(
-                IdentifierFactory.access(input)("length"),
-            ),
-            ...check_custom("array", "Array")(importer)(jsDocTags)(input),
-            // check custom array for legacy (3.7.0)
-        ],
-    });
+import ts from "typescript";
+
+import { ExpressionFactory } from "../../factories/ExpressionFactory";
+import { IdentifierFactory } from "../../factories/IdentifierFactory";
+
+import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
+import { IMetadataTag } from "../../schemas/metadata/IMetadataTag";
+
+import { FunctionImporter } from "../helpers/FunctionImporeter";
+import { ICheckEntry } from "../helpers/ICheckEntry";
+import { check_array_length } from "./check_array_length";
+import { check_custom } from "./check_custom";
+
+/**
+ * @internal
+ */
+export const check_array =
+    (importer: FunctionImporter) =>
+    (metaTags: IMetadataTag[]) =>
+    (jsDocTags: IJsDocTagInfo[]) =>
+    (input: ts.Expression): ICheckEntry => ({
+        expression: ExpressionFactory.isArray(input),
+        tags: [
+            ...check_array_length(metaTags)(
+                IdentifierFactory.access(input)("length"),
+            ),
+            ...check_custom("array", "Array")(importer)(jsDocTags)(input),
+            // check custom array for legacy (3.7.0)
+        ],
+    });