typia 5.0.4 → 5.0.5-dev.20230921

package/src/programmers/helpers/UnionPredicator.ts

@@ -1,81 +1,81 @@
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataObject } from "../../schemas/metadata/MetadataObject";
-import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
-
-import { ArrayUtil } from "../../utils/ArrayUtil";
-import { MapUtil } from "../../utils/MapUtil";
-
-export namespace UnionPredicator {
-    export interface ISpecialized {
-        index: number;
-        object: MetadataObject;
-        property: MetadataProperty;
-        neighbour: boolean;
-    }
-
-    export const object = (targets: MetadataObject[]): Array<ISpecialized> => {
-        // PROPERTY MATRIX
-        const matrix: Map<string, Array<MetadataProperty | null>> = new Map();
-        for (const obj of targets)
-            for (const prop of obj.properties) {
-                const key: string | null = prop.key.getSoleLiteral();
-                if (key !== null)
-                    MapUtil.take(matrix)(key, () =>
-                        ArrayUtil.repeat(targets.length, () => null),
-                    );
-            }
-        targets.forEach((obj, i) => {
-            for (const prop of obj.properties) {
-                const key: string | null = prop.key.getSoleLiteral();
-                if (key !== null) matrix.get(key)![i] = prop;
-            }
-        });
-
-        // EXPLORE SPECIALIZERS
-        const output: ISpecialized[] = [];
-        targets.forEach((obj, i) => {
-            const children: ISpecializedProperty[] = [];
-            obj.properties.forEach((prop) => {
-                // MUST BE REQUIRED
-                if (prop.value.isRequired() === false) return;
-                const key: string | null = prop.key.getSoleLiteral();
-                if (key === null) return;
-
-                // FIND NEIGHBORHOOD PROPERTIES
-                const neighbors: MetadataProperty[] = matrix
-                    .get(key)!
-                    .filter(
-                        (oppo, k) => i !== k && oppo !== null,
-                    ) as MetadataProperty[];
-
-                // NO NEIGHBORHOOD
-                const unique: boolean =
-                    neighbors.length === 0 ||
-                    neighbors.every(
-                        (n) => !Metadata.intersects(prop.value, n.value),
-                    );
-                if (unique === true)
-                    children.push({
-                        property: prop,
-                        neighbour: neighbors.length !== 0,
-                    });
-            });
-            if (children.length === 0) return;
-
-            const top: ISpecializedProperty =
-                children.find((child) => child.property.value.isConstant()) ||
-                children[0]!;
-            output.push({
-                index: i,
-                object: obj,
-                ...top,
-            });
-        });
-        return output;
-    };
-}
-
-interface ISpecializedProperty {
-    property: MetadataProperty;
-    neighbour: boolean;
-}
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataObject } from "../../schemas/metadata/MetadataObject";
+import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
+
+import { ArrayUtil } from "../../utils/ArrayUtil";
+import { MapUtil } from "../../utils/MapUtil";
+
+export namespace UnionPredicator {
+    export interface ISpecialized {
+        index: number;
+        object: MetadataObject;
+        property: MetadataProperty;
+        neighbour: boolean;
+    }
+
+    export const object = (targets: MetadataObject[]): Array<ISpecialized> => {
+        // PROPERTY MATRIX
+        const matrix: Map<string, Array<MetadataProperty | null>> = new Map();
+        for (const obj of targets)
+            for (const prop of obj.properties) {
+                const key: string | null = prop.key.getSoleLiteral();
+                if (key !== null)
+                    MapUtil.take(matrix)(key, () =>
+                        ArrayUtil.repeat(targets.length, () => null),
+                    );
+            }
+        targets.forEach((obj, i) => {
+            for (const prop of obj.properties) {
+                const key: string | null = prop.key.getSoleLiteral();
+                if (key !== null) matrix.get(key)![i] = prop;
+            }
+        });
+
+        // EXPLORE SPECIALIZERS
+        const output: ISpecialized[] = [];
+        targets.forEach((obj, i) => {
+            const children: ISpecializedProperty[] = [];
+            obj.properties.forEach((prop) => {
+                // MUST BE REQUIRED
+                if (prop.value.isRequired() === false) return;
+                const key: string | null = prop.key.getSoleLiteral();
+                if (key === null) return;
+
+                // FIND NEIGHBORHOOD PROPERTIES
+                const neighbors: MetadataProperty[] = matrix
+                    .get(key)!
+                    .filter(
+                        (oppo, k) => i !== k && oppo !== null,
+                    ) as MetadataProperty[];
+
+                // NO NEIGHBORHOOD
+                const unique: boolean =
+                    neighbors.length === 0 ||
+                    neighbors.every(
+                        (n) => !Metadata.intersects(prop.value, n.value),
+                    );
+                if (unique === true)
+                    children.push({
+                        property: prop,
+                        neighbour: neighbors.length !== 0,
+                    });
+            });
+            if (children.length === 0) return;
+
+            const top: ISpecializedProperty =
+                children.find((child) => child.property.value.isConstant()) ||
+                children[0]!;
+            output.push({
+                index: i,
+                object: obj,
+                ...top,
+            });
+        });
+        return output;
+    };
+}
+
+interface ISpecializedProperty {
+    property: MetadataProperty;
+    neighbour: boolean;
+}

package/src/programmers/helpers/disable_function_importer_declare.ts

@@ -1,32 +1,32 @@
-import ts from "typescript";
-
-import { FunctionImporter } from "./FunctionImporeter";
-
-export const disable_function_importer_declare = (
-    importer: FunctionImporter,
-): FunctionImporter => disable(importer) as FunctionImporter;
-
-const disable = (importer: FunctionImporter): MethodOnly<FunctionImporter> => ({
-    method: importer.method,
-    empty: (): boolean => importer.empty(),
-    use: (name: string): ts.Identifier => importer.use(name),
-    useLocal: (name: string): string => importer.useLocal(name),
-    hasLocal: (name: string): boolean => importer.hasLocal(name),
-    declare: (_modulo: ts.LeftHandSideExpression): ts.Statement[] => [],
-    declareUnions: (): ts.Statement[] => [],
-    increment: (): number => importer.increment(),
-    emplaceUnion: (
-        prefix: string,
-        name: string,
-        factory: () => ts.ArrowFunction,
-    ): string => importer.emplaceUnion(prefix, name, factory),
-    trace: (): void => importer.trace(),
-});
-
-type MethodOnly<T> = {
-    [P in keyof T]: T[P] extends Function
-        ? T[P]
-        : P extends "method"
-        ? T[P]
-        : never;
-};
+import ts from "typescript";
+
+import { FunctionImporter } from "./FunctionImporeter";
+
+export const disable_function_importer_declare = (
+    importer: FunctionImporter,
+): FunctionImporter => disable(importer) as FunctionImporter;
+
+const disable = (importer: FunctionImporter): MethodOnly<FunctionImporter> => ({
+    method: importer.method,
+    empty: (): boolean => importer.empty(),
+    use: (name: string): ts.Identifier => importer.use(name),
+    useLocal: (name: string): string => importer.useLocal(name),
+    hasLocal: (name: string): boolean => importer.hasLocal(name),
+    declare: (_modulo: ts.LeftHandSideExpression): ts.Statement[] => [],
+    declareUnions: (): ts.Statement[] => [],
+    increment: (): number => importer.increment(),
+    emplaceUnion: (
+        prefix: string,
+        name: string,
+        factory: () => ts.ArrowFunction,
+    ): string => importer.emplaceUnion(prefix, name, factory),
+    trace: (): void => importer.trace(),
+});
+
+type MethodOnly<T> = {
+    [P in keyof T]: T[P] extends Function
+        ? T[P]
+        : P extends "method"
+        ? T[P]
+        : never;
+};

package/src/programmers/internal/JSON_SCHEMA_PREFIX.ts

@@ -1 +1 @@
-export const JSON_COMPONENTS_PREFIX = "#/components";
+export const JSON_COMPONENTS_PREFIX = "#/components";

package/src/programmers/internal/application_alias.ts

@@ -1,65 +1,65 @@
-import { CommentFactory } from "../../factories/CommentFactory";
-
-import { IJsonComponents } from "../../schemas/json/IJsonComponents";
-import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
-import { MetadataAlias } from "../../schemas/metadata/MetadataAlias";
-
-import { IJsonSchema } from "../../module";
-import { JsonApplicationProgrammer } from "../json/JsonApplicationProgrammer";
-import { JSON_COMPONENTS_PREFIX } from "./JSON_SCHEMA_PREFIX";
-import { application_object } from "./application_object";
-import { application_schema } from "./application_schema";
-
-export const application_alias =
-    (options: JsonApplicationProgrammer.IOptions) =>
-    <BlockNever extends boolean>(blockNever: BlockNever) =>
-    (components: IJsonComponents) =>
-    (alias: MetadataAlias) =>
-    (nullable: boolean): IJsonSchema.IReference => {
-        if (alias.value.size() === 1 && alias.value.objects.length === 1)
-            return application_object(options)(components)(
-                alias.value.objects[0]!,
-            )(nullable);
-
-        const key: string =
-            options.purpose === "ajv"
-                ? alias.name
-                : `${alias.name}${nullable ? ".Nullable" : ""}`;
-        const $id: string = `${JSON_COMPONENTS_PREFIX}/schemas/${key}`;
-
-        // TEMPORARY ASSIGNMENT
-        if (components.schemas?.[key] === undefined) {
-            components.schemas ??= {};
-            components.schemas[key] = {
-                $id: key,
-            } as any;
-
-            // GENERATE SCHEM
-            const schema: IJsonSchema = application_schema(options)(blockNever)(
-                components,
-            )(alias.value)({
-                deprecated:
-                    alias.jsDocTags.some((tag) => tag.name === "deprecated") ||
-                    undefined,
-                title: (() => {
-                    const info: IJsDocTagInfo | undefined =
-                        alias.jsDocTags.find((tag) => tag.name === "title");
-                    return info?.text?.length
-                        ? CommentFactory.merge(info.text)
-                        : undefined;
-                })(),
-                description: alias.description ?? undefined,
-                "x-typia-jsDocTags": alias.jsDocTags.length
-                    ? alias.jsDocTags
-                    : undefined,
-            })!;
-            components.schemas ??= {};
-            components.schemas[key] = {
-                $id: options.purpose === "ajv" ? $id : undefined,
-                $recursiveAnchor:
-                    (options.purpose === "ajv" && alias.recursive) || undefined,
-                ...schema,
-            };
-        }
-        return { $ref: $id };
-    };
+import { CommentFactory } from "../../factories/CommentFactory";
+
+import { IJsonComponents } from "../../schemas/json/IJsonComponents";
+import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
+import { MetadataAlias } from "../../schemas/metadata/MetadataAlias";
+
+import { IJsonSchema } from "../../module";
+import { JsonApplicationProgrammer } from "../json/JsonApplicationProgrammer";
+import { JSON_COMPONENTS_PREFIX } from "./JSON_SCHEMA_PREFIX";
+import { application_object } from "./application_object";
+import { application_schema } from "./application_schema";
+
+export const application_alias =
+    (options: JsonApplicationProgrammer.IOptions) =>
+    <BlockNever extends boolean>(blockNever: BlockNever) =>
+    (components: IJsonComponents) =>
+    (alias: MetadataAlias) =>
+    (nullable: boolean): IJsonSchema.IReference => {
+        if (alias.value.size() === 1 && alias.value.objects.length === 1)
+            return application_object(options)(components)(
+                alias.value.objects[0]!,
+            )(nullable);
+
+        const key: string =
+            options.purpose === "ajv"
+                ? alias.name
+                : `${alias.name}${nullable ? ".Nullable" : ""}`;
+        const $id: string = `${JSON_COMPONENTS_PREFIX}/schemas/${key}`;
+
+        // TEMPORARY ASSIGNMENT
+        if (components.schemas?.[key] === undefined) {
+            components.schemas ??= {};
+            components.schemas[key] = {
+                $id: key,
+            } as any;
+
+            // GENERATE SCHEM
+            const schema: IJsonSchema = application_schema(options)(blockNever)(
+                components,
+            )(alias.value)({
+                deprecated:
+                    alias.jsDocTags.some((tag) => tag.name === "deprecated") ||
+                    undefined,
+                title: (() => {
+                    const info: IJsDocTagInfo | undefined =
+                        alias.jsDocTags.find((tag) => tag.name === "title");
+                    return info?.text?.length
+                        ? CommentFactory.merge(info.text)
+                        : undefined;
+                })(),
+                description: alias.description ?? undefined,
+                "x-typia-jsDocTags": alias.jsDocTags.length
+                    ? alias.jsDocTags
+                    : undefined,
+            })!;
+            components.schemas ??= {};
+            components.schemas[key] = {
+                $id: options.purpose === "ajv" ? $id : undefined,
+                $recursiveAnchor:
+                    (options.purpose === "ajv" && alias.recursive) || undefined,
+                ...schema,
+            };
+        }
+        return { $ref: $id };
+    };

package/src/programmers/internal/application_array.ts

@@ -1,53 +1,53 @@
-import { IJsonComponents } from "../../schemas/json/IJsonComponents";
-import { IJsonSchema } from "../../schemas/json/IJsonSchema";
-import { IMetadataTypeTag } from "../../schemas/metadata/IMetadataTypeTag";
-import { MetadataArray } from "../../schemas/metadata/MetadataArray";
-
-import { JsonApplicationProgrammer } from "../json/JsonApplicationProgrammer";
-import { application_schema } from "./application_schema";
-
-/**
- * @internal
- */
-export const application_array =
-    (options: JsonApplicationProgrammer.IOptions) =>
-    (components: IJsonComponents) =>
-    (array: MetadataArray) =>
-    (attribute: IJsonSchema.IAttribute): IJsonSchema.IArray[] => {
-        // BASE SCHEMA
-        const items: IJsonSchema = application_schema(options)(false)(
-            components,
-        )(array.type.value)(attribute);
-        const base: IJsonSchema.IArray = {
-            ...attribute,
-            type: "array",
-            items: null!,
-        };
-        const out = (schema: IJsonSchema.IArray) => {
-            schema.items = items;
-            return schema;
-        };
-        if (array.tags.length === 0) return [out(base)];
-
-        // CONSIDER TYPE TAGS
-        const union: IJsonSchema.IArray[] = array.tags.map(
-            (row) => application_array_tags({ ...base })(row)!,
-        );
-        const map: Map<string, IJsonSchema.IArray> = new Map(
-            union.map((u) => [JSON.stringify(u), u]),
-        );
-        return [...map.values()].map((s) => out(s));
-    };
-
-const application_array_tags =
-    (schema: IJsonSchema.IArray) =>
-    (row: IMetadataTypeTag[]): IJsonSchema.IArray => {
-        for (const tag of row
-            .slice()
-            .sort((a, b) => a.kind.localeCompare(b.kind)))
-            if (tag.kind === "minItems" && typeof tag.value === "number")
-                schema.minItems = tag.value;
-            else if (tag.kind === "maxItems" && typeof tag.value === "number")
-                schema.maxItems = tag.value;
-        return schema;
-    };
+import { IJsonComponents } from "../../schemas/json/IJsonComponents";
+import { IJsonSchema } from "../../schemas/json/IJsonSchema";
+import { IMetadataTypeTag } from "../../schemas/metadata/IMetadataTypeTag";
+import { MetadataArray } from "../../schemas/metadata/MetadataArray";
+
+import { JsonApplicationProgrammer } from "../json/JsonApplicationProgrammer";
+import { application_schema } from "./application_schema";
+
+/**
+ * @internal
+ */
+export const application_array =
+    (options: JsonApplicationProgrammer.IOptions) =>
+    (components: IJsonComponents) =>
+    (array: MetadataArray) =>
+    (attribute: IJsonSchema.IAttribute): IJsonSchema.IArray[] => {
+        // BASE SCHEMA
+        const items: IJsonSchema = application_schema(options)(false)(
+            components,
+        )(array.type.value)(attribute);
+        const base: IJsonSchema.IArray = {
+            ...attribute,
+            type: "array",
+            items: null!,
+        };
+        const out = (schema: IJsonSchema.IArray) => {
+            schema.items = items;
+            return schema;
+        };
+        if (array.tags.length === 0) return [out(base)];
+
+        // CONSIDER TYPE TAGS
+        const union: IJsonSchema.IArray[] = array.tags.map(
+            (row) => application_array_tags({ ...base })(row)!,
+        );
+        const map: Map<string, IJsonSchema.IArray> = new Map(
+            union.map((u) => [JSON.stringify(u), u]),
+        );
+        return [...map.values()].map((s) => out(s));
+    };
+
+const application_array_tags =
+    (schema: IJsonSchema.IArray) =>
+    (row: IMetadataTypeTag[]): IJsonSchema.IArray => {
+        for (const tag of row
+            .slice()
+            .sort((a, b) => a.kind.localeCompare(b.kind)))
+            if (tag.kind === "minItems" && typeof tag.value === "number")
+                schema.minItems = tag.value;
+            else if (tag.kind === "maxItems" && typeof tag.value === "number")
+                schema.maxItems = tag.value;
+        return schema;
+    };

package/src/programmers/internal/application_boolean.ts

@@ -1,15 +1,15 @@
-import { IJsonSchema } from "../../module";
-import { application_default } from "./application_default";
-
-/**
- * @internal
- */
-export const application_boolean = (
-    attribute: IJsonSchema.IAttribute,
-): IJsonSchema.IBoolean => ({
-    ...attribute,
-    default: application_default(attribute)(
-        (alias) => alias === "true" || alias === "false",
-    )((str) => Boolean(str)),
-    type: "boolean",
-});
+import { IJsonSchema } from "../../module";
+import { application_default } from "./application_default";
+
+/**
+ * @internal
+ */
+export const application_boolean = (
+    attribute: IJsonSchema.IAttribute,
+): IJsonSchema.IBoolean => ({
+    ...attribute,
+    default: application_default(attribute)(
+        (alias) => alias === "true" || alias === "false",
+    )((str) => Boolean(str)),
+    type: "boolean",
+});

package/src/programmers/internal/application_constant.ts

@@ -1,26 +1,26 @@
-import { IJsonSchema } from "../../schemas/json/IJsonSchema";
-import { MetadataConstant } from "../../schemas/metadata/MetadataConstant";
-
-import { application_default } from "./application_default";
-
-/**
- * @internal
- */
-export const application_constant =
-    (constant: MetadataConstant) =>
-    (attribute: IJsonSchema.IAttribute): IJsonSchema.IEnumeration<any> => ({
-        ...attribute,
-        type: constant.type,
-        enum: constant.values as any,
-        default: application_default(attribute)((alias) =>
-            constant.values.some((v) => v.toString() === alias),
-        )(
-            constant.type === "string"
-                ? (str) => str
-                : constant.type === "number"
-                ? (str) => Number(str)
-                : constant.type === "boolean"
-                ? (str) => Boolean(str)
-                : (str) => BigInt(str) as any,
-        ),
-    });
+import { IJsonSchema } from "../../schemas/json/IJsonSchema";
+import { MetadataConstant } from "../../schemas/metadata/MetadataConstant";
+
+import { application_default } from "./application_default";
+
+/**
+ * @internal
+ */
+export const application_constant =
+    (constant: MetadataConstant) =>
+    (attribute: IJsonSchema.IAttribute): IJsonSchema.IEnumeration<any> => ({
+        ...attribute,
+        type: constant.type,
+        enum: constant.values as any,
+        default: application_default(attribute)((alias) =>
+            constant.values.some((v) => v.toString() === alias),
+        )(
+            constant.type === "string"
+                ? (str) => str
+                : constant.type === "number"
+                ? (str) => Number(str)
+                : constant.type === "boolean"
+                ? (str) => Boolean(str)
+                : (str) => BigInt(str) as any,
+        ),
+    });

package/src/programmers/internal/application_default.ts

@@ -1,17 +1,17 @@
-import { IJsonSchema } from "../../schemas/json/IJsonSchema";
-
-/**
- * @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 alias of defaults)
-            if (alias.text?.length && pred(alias.text[0]!.text))
-                return caster(alias.text[0]!.text);
-        return undefined;
-    };
+import { IJsonSchema } from "../../schemas/json/IJsonSchema";
+
+/**
+ * @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 alias of defaults)
+            if (alias.text?.length && pred(alias.text[0]!.text))
+                return caster(alias.text[0]!.text);
+        return undefined;
+    };