typia 3.4.4 → 3.4.6

package/src/programmers/internal/application_array.ts

@@ -1,45 +1,45 @@
-import { Metadata } from "../../metadata/Metadata";
-import { IJsonComponents } from "../../schemas/IJsonComponents";
-import { IJsonSchema } from "../../schemas/IJsonSchema";
-
-import { ApplicationProgrammer } from "../ApplicationProgrammer";
-import { application_schema } from "./application_schema";
-
-/**
- * @internal
- */
-export const application_array =
-    (options: ApplicationProgrammer.IOptions) =>
-    (components: IJsonComponents) =>
-    (
-        metadata: Metadata,
-        nullable: boolean,
-        attribute: IJsonSchema.IAttribute,
-    ): IJsonSchema.IArray => {
-        // SCHEMA
-        const output: IJsonSchema.IArray = {
-            type: "array",
-            items: application_schema(options)(components)(false)(
-                metadata,
-                attribute,
-            ),
-            nullable,
-            ...attribute,
-        };
-
-        // RANGE
-        for (const tag of attribute["x-typia-metaTags"] || [])
-            if (tag.kind === "minItems") output.minItems = tag.value;
-            else if (tag.kind === "maxItems") output.maxItems = tag.value;
-            else if (tag.kind === "items") {
-                if (tag.minimum !== undefined)
-                    output.minItems =
-                        tag.minimum.value +
-                        (tag.minimum.include === true ? 0 : 1);
-                if (tag.maximum !== undefined)
-                    output.maxItems =
-                        tag.maximum.value -
-                        (tag.maximum.include === true ? 0 : 1);
-            }
-        return output;
-    };
+import { Metadata } from "../../metadata/Metadata";
+import { IJsonComponents } from "../../schemas/IJsonComponents";
+import { IJsonSchema } from "../../schemas/IJsonSchema";
+
+import { ApplicationProgrammer } from "../ApplicationProgrammer";
+import { application_schema } from "./application_schema";
+
+/**
+ * @internal
+ */
+export const application_array =
+    (options: ApplicationProgrammer.IOptions) =>
+    (components: IJsonComponents) =>
+    (
+        metadata: Metadata,
+        nullable: boolean,
+        attribute: IJsonSchema.IAttribute,
+    ): IJsonSchema.IArray => {
+        // SCHEMA
+        const output: IJsonSchema.IArray = {
+            type: "array",
+            items: application_schema(options)(components)(false)(
+                metadata,
+                attribute,
+            ),
+            nullable,
+            ...attribute,
+        };
+
+        // RANGE
+        for (const tag of attribute["x-typia-metaTags"] || [])
+            if (tag.kind === "minItems") output.minItems = tag.value;
+            else if (tag.kind === "maxItems") output.maxItems = tag.value;
+            else if (tag.kind === "items") {
+                if (tag.minimum !== undefined)
+                    output.minItems =
+                        tag.minimum.value +
+                        (tag.minimum.include === true ? 0 : 1);
+                if (tag.maximum !== undefined)
+                    output.maxItems =
+                        tag.maximum.value -
+                        (tag.maximum.include === true ? 0 : 1);
+            }
+        return output;
+    };

package/src/programmers/internal/application_default.ts

@@ -1,17 +1,17 @@
-import { IJsonSchema } from "../../module";
-
-/**
- * @internal
- */
-export const application_default =
-    (attribute: IJsonSchema.IAttribute) =>
-    (pred: (value: string) => boolean) =>
-    <T>(caster: (str: string) => T): T | undefined => {
-        const defaults = (attribute["x-typia-jsDocTags"] || []).filter(
-            (tag) => tag.name === "default",
-        );
-        for (const def of defaults)
-            if (def.text?.length && pred(def.text[0]!.text))
-                return caster(def.text[0]!.text);
-        return undefined;
-    };
+import { IJsonSchema } from "../../module";
+
+/**
+ * @internal
+ */
+export const application_default =
+    (attribute: IJsonSchema.IAttribute) =>
+    (pred: (value: string) => boolean) =>
+    <T>(caster: (str: string) => T): T | undefined => {
+        const defaults = (attribute["x-typia-jsDocTags"] || []).filter(
+            (tag) => tag.name === "default",
+        );
+        for (const def of defaults)
+            if (def.text?.length && pred(def.text[0]!.text))
+                return caster(def.text[0]!.text);
+        return undefined;
+    };

package/src/programmers/internal/application_number.ts

@@ -1,76 +1,76 @@
-import { IJsonSchema } from "../../module";
-import { application_default } from "./application_default";
-
-/**
- * @internal
- */
-export const application_number = (
-    nullable: boolean,
-    attribute: IJsonSchema.IAttribute,
-): IJsonSchema.INumber => {
-    const output: IJsonSchema.INumber = {
-        type: "number",
-        nullable,
-        ...attribute,
-    };
-    for (const tag of attribute["x-typia-metaTags"] || []) {
-        // CHECK TYPE
-        if (
-            tag.kind === "type" &&
-            (tag.value === "int" || tag.value === "uint")
-        )
-            output.type = "integer";
-        // RANGE TAG
-        else if (tag.kind === "minimum") output.minimum = tag.value;
-        else if (tag.kind === "maximum") output.maximum = tag.value;
-        else if (tag.kind === "range") {
-            if (tag.minimum !== undefined)
-                if (tag.minimum.include === true)
-                    output.minimum = tag.minimum.value;
-                else output.exclusiveMinimum = tag.minimum.value;
-            if (tag.maximum !== undefined)
-                if (tag.maximum.include === true)
-                    output.maximum = tag.maximum.value;
-                else output.exclusiveMaximum = tag.maximum.value;
-        }
-        // MULTIPLE-OF
-        else if (tag.kind === "multipleOf") output.multipleOf = tag.value;
-    }
-
-    // WHEN UNSIGNED INT
-    if (
-        output.type === "integer" &&
-        (attribute["x-typia-metaTags"] || []).find(
-            (tag) => tag.kind === "type" && tag.value === "uint",
-        )
-    )
-        if (output.minimum === undefined || output.minimum < 0)
-            output.minimum = 0;
-        else if (
-            output.exclusiveMinimum === undefined ||
-            output.exclusiveMinimum < 0
-        ) {
-            delete output.exclusiveMinimum;
-            output.maximum = 0;
-        }
-
-    // DEFAULT CONFIGURATION
-    output.default = application_default(attribute)((str) => {
-        const value: number = Number(str);
-        const conditions: boolean[] = [!Number.isNaN(value)];
-        if (output.minimum !== undefined)
-            conditions.push(value >= output.minimum);
-        if (output.maximum !== undefined)
-            conditions.push(value <= output.maximum);
-        if (output.exclusiveMinimum !== undefined)
-            conditions.push(value > output.exclusiveMinimum);
-        if (output.exclusiveMaximum !== undefined)
-            conditions.push(value < output.exclusiveMaximum);
-        if (output.multipleOf !== undefined)
-            conditions.push(value % output.multipleOf === 0);
-        return conditions.every((cond) => cond);
-    })((str) => Number(str));
-
-    // RETURNS
-    return output;
-};
+import { IJsonSchema } from "../../module";
+import { application_default } from "./application_default";
+
+/**
+ * @internal
+ */
+export const application_number = (
+    nullable: boolean,
+    attribute: IJsonSchema.IAttribute,
+): IJsonSchema.INumber => {
+    const output: IJsonSchema.INumber = {
+        type: "number",
+        nullable,
+        ...attribute,
+    };
+    for (const tag of attribute["x-typia-metaTags"] || []) {
+        // CHECK TYPE
+        if (
+            tag.kind === "type" &&
+            (tag.value === "int" || tag.value === "uint")
+        )
+            output.type = "integer";
+        // RANGE TAG
+        else if (tag.kind === "minimum") output.minimum = tag.value;
+        else if (tag.kind === "maximum") output.maximum = tag.value;
+        else if (tag.kind === "range") {
+            if (tag.minimum !== undefined)
+                if (tag.minimum.include === true)
+                    output.minimum = tag.minimum.value;
+                else output.exclusiveMinimum = tag.minimum.value;
+            if (tag.maximum !== undefined)
+                if (tag.maximum.include === true)
+                    output.maximum = tag.maximum.value;
+                else output.exclusiveMaximum = tag.maximum.value;
+        }
+        // MULTIPLE-OF
+        else if (tag.kind === "multipleOf") output.multipleOf = tag.value;
+    }
+
+    // WHEN UNSIGNED INT
+    if (
+        output.type === "integer" &&
+        (attribute["x-typia-metaTags"] || []).find(
+            (tag) => tag.kind === "type" && tag.value === "uint",
+        )
+    )
+        if (output.minimum === undefined || output.minimum < 0)
+            output.minimum = 0;
+        else if (
+            output.exclusiveMinimum === undefined ||
+            output.exclusiveMinimum < 0
+        ) {
+            delete output.exclusiveMinimum;
+            output.maximum = 0;
+        }
+
+    // DEFAULT CONFIGURATION
+    output.default = application_default(attribute)((str) => {
+        const value: number = Number(str);
+        const conditions: boolean[] = [!Number.isNaN(value)];
+        if (output.minimum !== undefined)
+            conditions.push(value >= output.minimum);
+        if (output.maximum !== undefined)
+            conditions.push(value <= output.maximum);
+        if (output.exclusiveMinimum !== undefined)
+            conditions.push(value > output.exclusiveMinimum);
+        if (output.exclusiveMaximum !== undefined)
+            conditions.push(value < output.exclusiveMaximum);
+        if (output.multipleOf !== undefined)
+            conditions.push(value % output.multipleOf === 0);
+        return conditions.every((cond) => cond);
+    })((str) => Number(str));
+
+    // RETURNS
+    return output;
+};

package/src/programmers/internal/application_object.ts

@@ -1,103 +1,103 @@
-import { CommentFactory } from "../../factories/CommentFactory";
-
-import { IJsDocTagInfo } from "../../metadata/IJsDocTagInfo";
-import { MetadataObject } from "../../metadata/MetadataObject";
-import { IJsonComponents } from "../../schemas/IJsonComponents";
-
-import { PatternUtil } from "../../utils/PatternUtil";
-
-import { IJsonSchema } from "../../module";
-import { ApplicationProgrammer } from "../ApplicationProgrammer";
-import { application_schema } from "./application_schema";
-import { metadata_to_pattern } from "./metadata_to_pattern";
-
-/**
- * @internal
- */
-export const application_object =
-    (options: ApplicationProgrammer.IOptions) =>
-    (components: IJsonComponents) =>
-    (key: string, obj: MetadataObject, nullable: boolean): void => {
-        // TEMPORARY ASSIGNMENT
-        if (components.schemas[key] !== undefined) return;
-        components.schemas[key] = {} as any;
-
-        // ITERATE PROPERTIES
-        const properties: Record<string, any> = {};
-        const patternProperties: Record<string, any> = {};
-        const additionalProperties: IJsonSchema[] = [];
-        const required: string[] = [];
-
-        for (const property of obj.properties) {
-            if (
-                property.value.functional === true &&
-                property.value.nullable === false &&
-                property.value.required === true &&
-                property.value.size() === 0
-            )
-                continue;
-
-            const key: string | null = property.key.getSoleLiteral();
-            const value: IJsonSchema | null = application_schema(options)(
-                components,
-            )(true)(property.value, {
-                deprecated:
-                    !!property.jsDocTags.find(
-                        (tag) => tag.name === "deprecated",
-                    ) || undefined,
-                title: (() => {
-                    const info: IJsDocTagInfo | undefined =
-                        property.jsDocTags.find((tag) => tag.name === "title");
-                    return info?.text?.length
-                        ? CommentFactory.generate(info.text)
-                        : undefined;
-                })(),
-                description: property.description,
-                "x-typia-metaTags": property.tags.length
-                    ? property.tags
-                    : undefined,
-                "x-typia-jsDocTags": property.jsDocTags.length
-                    ? property.jsDocTags
-                    : undefined,
-                "x-typia-required": property.value.required,
-            });
-
-            if (value === null) continue;
-            else if (key !== null) {
-                properties[key] = value;
-                if (property.value.required === true) required.push(key);
-            } else {
-                const pattern: string = metadata_to_pattern(true)(property.key);
-                if (
-                    options.purpose === "swagger" ||
-                    pattern === PatternUtil.STRING
-                )
-                    additionalProperties.push(value);
-                else patternProperties[pattern] = value;
-            }
-        }
-
-        const schema: IJsonComponents.IObject = {
-            $id:
-                options.purpose === "ajv"
-                    ? options.prefix + "/" + key
-                    : undefined,
-            $recursiveAnchor:
-                (options.purpose === "ajv" && obj.recursive) || undefined,
-            type: "object",
-            properties,
-            patternProperties: Object.keys(patternProperties).length
-                ? patternProperties
-                : undefined,
-            additionalProperties: additionalProperties.length
-                ? additionalProperties.length === 1
-                    ? additionalProperties[0]
-                    : { oneOf: additionalProperties }
-                : undefined,
-            nullable,
-            required: required.length ? required : undefined,
-            description: obj.description,
-            "x-typia_jsDocTags": obj.jsDocTags,
-        };
-        components.schemas[key] = schema;
-    };
+import { CommentFactory } from "../../factories/CommentFactory";
+
+import { IJsDocTagInfo } from "../../metadata/IJsDocTagInfo";
+import { MetadataObject } from "../../metadata/MetadataObject";
+import { IJsonComponents } from "../../schemas/IJsonComponents";
+
+import { PatternUtil } from "../../utils/PatternUtil";
+
+import { IJsonSchema } from "../../module";
+import { ApplicationProgrammer } from "../ApplicationProgrammer";
+import { application_schema } from "./application_schema";
+import { metadata_to_pattern } from "./metadata_to_pattern";
+
+/**
+ * @internal
+ */
+export const application_object =
+    (options: ApplicationProgrammer.IOptions) =>
+    (components: IJsonComponents) =>
+    (key: string, obj: MetadataObject, nullable: boolean): void => {
+        // TEMPORARY ASSIGNMENT
+        if (components.schemas[key] !== undefined) return;
+        components.schemas[key] = {} as any;
+
+        // ITERATE PROPERTIES
+        const properties: Record<string, any> = {};
+        const patternProperties: Record<string, any> = {};
+        const additionalProperties: IJsonSchema[] = [];
+        const required: string[] = [];
+
+        for (const property of obj.properties) {
+            if (
+                property.value.functional === true &&
+                property.value.nullable === false &&
+                property.value.required === true &&
+                property.value.size() === 0
+            )
+                continue;
+
+            const key: string | null = property.key.getSoleLiteral();
+            const value: IJsonSchema | null = application_schema(options)(
+                components,
+            )(true)(property.value, {
+                deprecated:
+                    !!property.jsDocTags.find(
+                        (tag) => tag.name === "deprecated",
+                    ) || undefined,
+                title: (() => {
+                    const info: IJsDocTagInfo | undefined =
+                        property.jsDocTags.find((tag) => tag.name === "title");
+                    return info?.text?.length
+                        ? CommentFactory.generate(info.text)
+                        : undefined;
+                })(),
+                description: property.description,
+                "x-typia-metaTags": property.tags.length
+                    ? property.tags
+                    : undefined,
+                "x-typia-jsDocTags": property.jsDocTags.length
+                    ? property.jsDocTags
+                    : undefined,
+                "x-typia-required": property.value.required,
+            });
+
+            if (value === null) continue;
+            else if (key !== null) {
+                properties[key] = value;
+                if (property.value.required === true) required.push(key);
+            } else {
+                const pattern: string = metadata_to_pattern(true)(property.key);
+                if (
+                    options.purpose === "swagger" ||
+                    pattern === PatternUtil.STRING
+                )
+                    additionalProperties.push(value);
+                else patternProperties[pattern] = value;
+            }
+        }
+
+        const schema: IJsonComponents.IObject = {
+            $id:
+                options.purpose === "ajv"
+                    ? options.prefix + "/" + key
+                    : undefined,
+            $recursiveAnchor:
+                (options.purpose === "ajv" && obj.recursive) || undefined,
+            type: "object",
+            properties,
+            patternProperties: Object.keys(patternProperties).length
+                ? patternProperties
+                : undefined,
+            additionalProperties: additionalProperties.length
+                ? additionalProperties.length === 1
+                    ? additionalProperties[0]
+                    : { oneOf: additionalProperties }
+                : undefined,
+            nullable,
+            required: required.length ? required : undefined,
+            description: obj.description,
+            "x-typia_jsDocTags": obj.jsDocTags,
+        };
+        components.schemas[key] = schema;
+    };

package/src/programmers/internal/application_string.ts

@@ -1,49 +1,49 @@
-import { Metadata } from "../../metadata/Metadata";
-import { IJsonSchema } from "../../schemas/IJsonSchema";
-
-import { application_default_string } from "./application_default_string";
-
-/**
- * @internal
- */
-export const application_string = (
-    meta: Metadata,
-    attribute: IJsonSchema.IAttribute,
-): IJsonSchema.IString => {
-    const output: IJsonSchema.IString = {
-        type: "string",
-        nullable: meta.nullable,
-        ...attribute,
-    };
-
-    // 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;
-        else if (tag.kind === "length") {
-            if (tag.minimum !== undefined)
-                output.minLength =
-                    tag.minimum.value + (tag.minimum.include ? 0 : 1);
-            if (tag.maximum !== undefined)
-                output.maxLength =
-                    tag.maximum.value - (tag.maximum.include ? 0 : 1);
-        }
-        // FORMAT AND PATTERN
-        else if (tag.kind === "format") output.format = tag.value;
-        else if (tag.kind === "pattern") output.pattern = tag.value;
-    }
-
-    // DEFAULT CONFIGURATION
-    output.default = application_default_string(meta, attribute)(output);
-
-    // RETURNS
-    return output;
-};
+import { Metadata } from "../../metadata/Metadata";
+import { IJsonSchema } from "../../schemas/IJsonSchema";
+
+import { application_default_string } from "./application_default_string";
+
+/**
+ * @internal
+ */
+export const application_string = (
+    meta: Metadata,
+    attribute: IJsonSchema.IAttribute,
+): IJsonSchema.IString => {
+    const output: IJsonSchema.IString = {
+        type: "string",
+        nullable: meta.nullable,
+        ...attribute,
+    };
+
+    // 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;
+        else if (tag.kind === "length") {
+            if (tag.minimum !== undefined)
+                output.minLength =
+                    tag.minimum.value + (tag.minimum.include ? 0 : 1);
+            if (tag.maximum !== undefined)
+                output.maxLength =
+                    tag.maximum.value - (tag.maximum.include ? 0 : 1);
+        }
+        // FORMAT AND PATTERN
+        else if (tag.kind === "format") output.format = tag.value;
+        else if (tag.kind === "pattern") output.pattern = tag.value;
+    }
+
+    // DEFAULT CONFIGURATION
+    output.default = application_default_string(meta, attribute)(output);
+
+    // RETURNS
+    return output;
+};

package/src/schemas/IJsonComponents.ts

@@ -1,24 +1,24 @@
-import { IJsDocTagInfo } from "../metadata/IJsDocTagInfo";
-
-import { IJsonSchema } from "./IJsonSchema";
-
-export interface IJsonComponents {
-    schemas: Record<string, IJsonComponents.IObject>;
-}
-export namespace IJsonComponents {
-    export interface IObject {
-        $id?: string;
-        type: "object";
-        nullable: boolean;
-
-        properties: Record<string, IJsonSchema>;
-        patternProperties?: Record<string, IJsonSchema>;
-        additionalProperties?: IJsonSchema;
-
-        required?: string[];
-        description?: string;
-        "x-typia_jsDocTags"?: IJsDocTagInfo[];
-
-        $recursiveAnchor?: boolean;
-    }
-}
+import { IJsDocTagInfo } from "../metadata/IJsDocTagInfo";
+
+import { IJsonSchema } from "./IJsonSchema";
+
+export interface IJsonComponents {
+    schemas: Record<string, IJsonComponents.IObject>;
+}
+export namespace IJsonComponents {
+    export interface IObject {
+        $id?: string;
+        type: "object";
+        nullable: boolean;
+
+        properties: Record<string, IJsonSchema>;
+        patternProperties?: Record<string, IJsonSchema>;
+        additionalProperties?: IJsonSchema;
+
+        required?: string[];
+        description?: string;
+        "x-typia_jsDocTags"?: IJsDocTagInfo[];
+
+        $recursiveAnchor?: boolean;
+    }
+}