typia 4.0.0-dev.20230520 → 4.0.0-dev.20230527

package/src/factories/IdentifierFactory.ts

@@ -1,62 +1,62 @@
-import type ts from "typescript/lib/tsclibrary";
-
-import { Escaper } from "../utils/Escaper";
-
-export namespace IdentifierFactory {
-    export const identifier = (tsc: typeof ts) => (name: string) =>
-        Escaper.variable(name)
-            ? tsc.factory.createIdentifier(name)
-            : tsc.factory.createStringLiteral(name);
-
-    export const access =
-        (tsc: typeof ts) => (target: ts.Expression) => (property: string) => {
-            const postfix = identifier(tsc)(property);
-            return tsc.isStringLiteral(postfix)
-                ? tsc.factory.createElementAccessExpression(target, postfix)
-                : tsc.factory.createPropertyAccessExpression(target, postfix);
-        };
-
-    export const postfix = (str: string): string =>
-        Escaper.variable(str)
-            ? `".${str}"`
-            : `"[${JSON.stringify(str).split('"').join('\\"')}]"`;
-
-    export const parameter =
-        (tsc: typeof ts) =>
-        (
-            name: string | ts.BindingName,
-            type?: ts.TypeNode,
-            init?:
-                | ts.Expression
-                | ts.PunctuationToken<ts.SyntaxKind.QuestionToken>,
-        ) => {
-            // instead of ts.version >= "4.8"
-            if (tsc.getDecorators !== undefined)
-                return tsc.factory.createParameterDeclaration(
-                    undefined,
-                    undefined,
-                    name,
-                    init?.kind === tsc.SyntaxKind.QuestionToken
-                        ? tsc.factory.createToken(tsc.SyntaxKind.QuestionToken)
-                        : undefined,
-                    type,
-                    init && init.kind !== tsc.SyntaxKind.QuestionToken
-                        ? init
-                        : undefined,
-                );
-            // eslint-disable-next-line
-            return (tsc.factory.createParameterDeclaration as any)(
-                undefined,
-                undefined,
-                undefined,
-                name,
-                init?.kind === tsc.SyntaxKind.QuestionToken
-                    ? tsc.factory.createToken(tsc.SyntaxKind.QuestionToken)
-                    : undefined,
-                type,
-                init && init.kind !== tsc.SyntaxKind.QuestionToken
-                    ? init
-                    : undefined,
-            );
-        };
-}
+import type ts from "typescript/lib/tsclibrary";
+
+import { Escaper } from "../utils/Escaper";
+
+export namespace IdentifierFactory {
+    export const identifier = (tsc: typeof ts) => (name: string) =>
+        Escaper.variable(name)
+            ? tsc.factory.createIdentifier(name)
+            : tsc.factory.createStringLiteral(name);
+
+    export const access =
+        (tsc: typeof ts) => (target: ts.Expression) => (property: string) => {
+            const postfix = identifier(tsc)(property);
+            return tsc.isStringLiteral(postfix)
+                ? tsc.factory.createElementAccessExpression(target, postfix)
+                : tsc.factory.createPropertyAccessExpression(target, postfix);
+        };
+
+    export const postfix = (str: string): string =>
+        Escaper.variable(str)
+            ? `".${str}"`
+            : `"[${JSON.stringify(str).split('"').join('\\"')}]"`;
+
+    export const parameter =
+        (tsc: typeof ts) =>
+        (
+            name: string | ts.BindingName,
+            type?: ts.TypeNode,
+            init?:
+                | ts.Expression
+                | ts.PunctuationToken<ts.SyntaxKind.QuestionToken>,
+        ) => {
+            // instead of ts.version >= "4.8"
+            if (tsc.getDecorators !== undefined)
+                return tsc.factory.createParameterDeclaration(
+                    undefined,
+                    undefined,
+                    name,
+                    init?.kind === tsc.SyntaxKind.QuestionToken
+                        ? tsc.factory.createToken(tsc.SyntaxKind.QuestionToken)
+                        : undefined,
+                    type,
+                    init && init.kind !== tsc.SyntaxKind.QuestionToken
+                        ? init
+                        : undefined,
+                );
+            // eslint-disable-next-line
+            return (tsc.factory.createParameterDeclaration as any)(
+                undefined,
+                undefined,
+                undefined,
+                name,
+                init?.kind === tsc.SyntaxKind.QuestionToken
+                    ? tsc.factory.createToken(tsc.SyntaxKind.QuestionToken)
+                    : undefined,
+                type,
+                init && init.kind !== tsc.SyntaxKind.QuestionToken
+                    ? init
+                    : undefined,
+            );
+        };
+}

package/src/factories/LiteralFactory.ts

@@ -1,57 +1,57 @@
-import type ts from "typescript/lib/tsclibrary";
-
-import { IdentifierFactory } from "./IdentifierFactory";
-
-export namespace LiteralFactory {
-    export const generate =
-        (tsc: typeof ts) =>
-        (input: any): ts.Expression => {
-            if (input === null) return tsc.factory.createNull();
-            else if (tsc.isIdentifier(input)) return input;
-            else if (input instanceof Array) return generate_array(tsc)(input);
-            else if (typeof input === "object")
-                return generate_object(tsc)(input);
-            else if (typeof input === "string")
-                return generate_string(tsc)(input);
-            else if (typeof input === "boolean")
-                return generate_value(tsc)(input);
-            else if (typeof input === "number")
-                return generate_value(tsc)(input);
-            else if (typeof input === "bigint")
-                return generate_value(tsc)(input);
-            else throw new Error("Unknown type.");
-        };
-
-    const generate_object =
-        (tsc: typeof ts) =>
-        (obj: object): ts.ObjectLiteralExpression =>
-            tsc.factory.createObjectLiteralExpression(
-                Object.entries(obj)
-                    .filter((tuple) => tuple[1] !== undefined)
-                    .map(([key, value]) =>
-                        tsc.factory.createPropertyAssignment(
-                            IdentifierFactory.identifier(tsc)(key),
-                            generate(tsc)(value),
-                        ),
-                    ),
-                true,
-            );
-
-    const generate_array =
-        (tsc: typeof ts) =>
-        (array: any[]): ts.ArrayLiteralExpression =>
-            tsc.factory.createArrayLiteralExpression(
-                array.map(generate(tsc)),
-                true,
-            );
-
-    const generate_value =
-        (tsc: typeof ts) =>
-        (value: number | boolean | bigint): ts.Identifier =>
-            tsc.factory.createIdentifier(value.toString());
-
-    const generate_string =
-        (tsc: typeof ts) =>
-        (value: string): ts.StringLiteral =>
-            tsc.factory.createStringLiteral(value);
-}
+import type ts from "typescript/lib/tsclibrary";
+
+import { IdentifierFactory } from "./IdentifierFactory";
+
+export namespace LiteralFactory {
+    export const generate =
+        (tsc: typeof ts) =>
+        (input: any): ts.Expression => {
+            if (input === null) return tsc.factory.createNull();
+            else if (tsc.isIdentifier(input)) return input;
+            else if (input instanceof Array) return generate_array(tsc)(input);
+            else if (typeof input === "object")
+                return generate_object(tsc)(input);
+            else if (typeof input === "string")
+                return generate_string(tsc)(input);
+            else if (typeof input === "boolean")
+                return generate_value(tsc)(input);
+            else if (typeof input === "number")
+                return generate_value(tsc)(input);
+            else if (typeof input === "bigint")
+                return generate_value(tsc)(input);
+            else throw new Error("Unknown type.");
+        };
+
+    const generate_object =
+        (tsc: typeof ts) =>
+        (obj: object): ts.ObjectLiteralExpression =>
+            tsc.factory.createObjectLiteralExpression(
+                Object.entries(obj)
+                    .filter((tuple) => tuple[1] !== undefined)
+                    .map(([key, value]) =>
+                        tsc.factory.createPropertyAssignment(
+                            IdentifierFactory.identifier(tsc)(key),
+                            generate(tsc)(value),
+                        ),
+                    ),
+                true,
+            );
+
+    const generate_array =
+        (tsc: typeof ts) =>
+        (array: any[]): ts.ArrayLiteralExpression =>
+            tsc.factory.createArrayLiteralExpression(
+                array.map(generate(tsc)),
+                true,
+            );
+
+    const generate_value =
+        (tsc: typeof ts) =>
+        (value: number | boolean | bigint): ts.Identifier =>
+            tsc.factory.createIdentifier(value.toString());
+
+    const generate_string =
+        (tsc: typeof ts) =>
+        (value: string): ts.StringLiteral =>
+            tsc.factory.createStringLiteral(value);
+}

package/src/factories/MetadataCollection.ts

@@ -1,123 +1,123 @@
-import type ts from "typescript/lib/tsclibrary";
-
-import { Metadata } from "../metadata/Metadata";
-import { MetadataObject } from "../metadata/MetadataObject";
-
-import { IProject } from "../transformers/IProject";
-
-import { MapUtil } from "../utils/MapUtil";
-import { TsSymbolUtil } from "../utils/TsSymbolUtil";
-
-import { TypeFactory } from "./TypeFactory";
-
-export class MetadataCollection {
-    private readonly dict_: Map<ts.Type, MetadataObject>;
-    private readonly names_: Map<string, Map<ts.Type, string>>;
-    private readonly unions_: Map<string, MetadataObject[]>;
-    private index_: number;
-
-    public constructor(
-        private readonly options?: Partial<MetadataCollection.IOptions>,
-    ) {
-        this.dict_ = new Map();
-        this.names_ = new Map();
-        this.unions_ = new Map();
-        this.index_ = 0;
-    }
-
-    public objects(): MetadataObject[] {
-        return [...this.dict_.values()];
-    }
-    public unions(): MetadataObject[][] {
-        return [...this.unions_.values()];
-    }
-
-    public emplace(
-        p: IProject.IModule,
-        type: ts.Type,
-    ): [MetadataObject, boolean] {
-        const oldbie = this.dict_.get(type);
-        if (oldbie !== undefined) return [oldbie, false];
-
-        const $id: string = this.get_name(p, type);
-        const obj: MetadataObject = MetadataObject.create({
-            name: $id,
-            properties: [],
-            description: type.symbol
-                ? TsSymbolUtil.comments(p.tsc)(type.symbol)
-                : undefined,
-            jsDocTags:
-                (type.symbol
-                    ? TsSymbolUtil.getCommentTags(p.tsc)(type.symbol)
-                    : undefined) ?? [],
-            validated: false,
-            index: this.index_++,
-            recursive: false,
-            nullables: [],
-        });
-        this.dict_.set(type, obj);
-        return [obj, true];
-    }
-
-    /**
-     * @internal
-     */
-    public getUnionIndex(meta: Metadata): number {
-        const key: string = meta.objects.map((obj) => obj.name).join(" | ");
-        MapUtil.take(this.unions_)(key, () => meta.objects);
-        return [...this.unions_.keys()].indexOf(key);
-    }
-
-    private get_name(p: IProject.IModule, type: ts.Type): string {
-        const name: string = (() => {
-            const str: string = TypeFactory.getFullName(p)(type);
-            return this.options?.replace ? this.options.replace(str) : str;
-        })();
-
-        const duplicates: Map<ts.Type, string> = MapUtil.take(this.names_)(
-            name,
-            () => new Map(),
-        );
-        const oldbie: string | undefined = duplicates.get(type);
-        if (oldbie !== undefined) return oldbie;
-
-        const addicted: string = duplicates.size
-            ? `${name}.o${duplicates.size}`
-            : name;
-        duplicates.set(type, addicted);
-        return addicted;
-    }
-}
-export namespace MetadataCollection {
-    export interface IOptions {
-        replace?(str: string): string;
-    }
-
-    export const replace = (str: string): string => {
-        for (const [before, after] of REPLACERS)
-            str = str.split(before).join(after);
-        return str;
-    };
-
-    export const escape = (str: string): string => {
-        for (const [before, after] of REPLACERS)
-            if (after !== "") str = str.split(after).join(before);
-        return str;
-    };
-}
-const REPLACERS: [string, string][] = [
-    ["$", "_dollar_"],
-    ["&", "_and_"],
-    ["|", "_or_"],
-    ["{", "_blt_"],
-    ["}", "_bgt_"],
-    ["<", "_lt_"],
-    [">", "_gt_"],
-    ["[", "_alt_"],
-    ["]", "_agt_"],
-    [",", "_comma_"],
-    ["`", "_backquote_"],
-    ["'", "_singlequote_"],
-    ['"', "_doublequote_"],
-    [" ", "_space_"],
-];
+import type ts from "typescript/lib/tsclibrary";
+
+import { Metadata } from "../metadata/Metadata";
+import { MetadataObject } from "../metadata/MetadataObject";
+
+import { IProject } from "../transformers/IProject";
+
+import { MapUtil } from "../utils/MapUtil";
+import { TsSymbolUtil } from "../utils/TsSymbolUtil";
+
+import { TypeFactory } from "./TypeFactory";
+
+export class MetadataCollection {
+    private readonly dict_: Map<ts.Type, MetadataObject>;
+    private readonly names_: Map<string, Map<ts.Type, string>>;
+    private readonly unions_: Map<string, MetadataObject[]>;
+    private index_: number;
+
+    public constructor(
+        private readonly options?: Partial<MetadataCollection.IOptions>,
+    ) {
+        this.dict_ = new Map();
+        this.names_ = new Map();
+        this.unions_ = new Map();
+        this.index_ = 0;
+    }
+
+    public objects(): MetadataObject[] {
+        return [...this.dict_.values()];
+    }
+    public unions(): MetadataObject[][] {
+        return [...this.unions_.values()];
+    }
+
+    public emplace(
+        p: IProject.IModule,
+        type: ts.Type,
+    ): [MetadataObject, boolean] {
+        const oldbie = this.dict_.get(type);
+        if (oldbie !== undefined) return [oldbie, false];
+
+        const $id: string = this.get_name(p, type);
+        const obj: MetadataObject = MetadataObject.create({
+            name: $id,
+            properties: [],
+            description: type.symbol
+                ? TsSymbolUtil.comments(p.tsc)(type.symbol)
+                : undefined,
+            jsDocTags:
+                (type.symbol
+                    ? TsSymbolUtil.getCommentTags(p.tsc)(type.symbol)
+                    : undefined) ?? [],
+            validated: false,
+            index: this.index_++,
+            recursive: false,
+            nullables: [],
+        });
+        this.dict_.set(type, obj);
+        return [obj, true];
+    }
+
+    /**
+     * @internal
+     */
+    public getUnionIndex(meta: Metadata): number {
+        const key: string = meta.objects.map((obj) => obj.name).join(" | ");
+        MapUtil.take(this.unions_)(key, () => meta.objects);
+        return [...this.unions_.keys()].indexOf(key);
+    }
+
+    private get_name(p: IProject.IModule, type: ts.Type): string {
+        const name: string = (() => {
+            const str: string = TypeFactory.getFullName(p)(type);
+            return this.options?.replace ? this.options.replace(str) : str;
+        })();
+
+        const duplicates: Map<ts.Type, string> = MapUtil.take(this.names_)(
+            name,
+            () => new Map(),
+        );
+        const oldbie: string | undefined = duplicates.get(type);
+        if (oldbie !== undefined) return oldbie;
+
+        const addicted: string = duplicates.size
+            ? `${name}.o${duplicates.size}`
+            : name;
+        duplicates.set(type, addicted);
+        return addicted;
+    }
+}
+export namespace MetadataCollection {
+    export interface IOptions {
+        replace?(str: string): string;
+    }
+
+    export const replace = (str: string): string => {
+        for (const [before, after] of REPLACERS)
+            str = str.split(before).join(after);
+        return str;
+    };
+
+    export const escape = (str: string): string => {
+        for (const [before, after] of REPLACERS)
+            if (after !== "") str = str.split(after).join(before);
+        return str;
+    };
+}
+const REPLACERS: [string, string][] = [
+    ["$", "_dollar_"],
+    ["&", "_and_"],
+    ["|", "_or_"],
+    ["{", "_blt_"],
+    ["}", "_bgt_"],
+    ["<", "_lt_"],
+    [">", "_gt_"],
+    ["[", "_alt_"],
+    ["]", "_agt_"],
+    [",", "_comma_"],
+    ["`", "_backquote_"],
+    ["'", "_singlequote_"],
+    ['"', "_doublequote_"],
+    [" ", "_space_"],
+];

package/src/factories/MetadataFactory.ts

@@ -1,53 +1,53 @@
-import type ts from "typescript/lib/tsclibrary";
-
-import { Metadata } from "../metadata/Metadata";
-import { explore_metadata } from "./internal/metadata/explore_metadata";
-
-import { IProject } from "../transformers/IProject";
-
-import { MetadataCollection } from "./MetadataCollection";
-
-export namespace MetadataFactory {
-    export interface IOptions {
-        resolve: boolean;
-        constant: boolean;
-        validate?: (meta: Metadata) => void;
-    }
-
-    export const analyze =
-        (project: IProject.IModule) =>
-        (options: IOptions) =>
-        (collection: MetadataCollection) =>
-        (type: ts.Type | null): Metadata => {
-            // CONSTRUCT SCHEMA WITH OBJECTS
-            const metadata: Metadata =
-                explore_metadata(project)(options)(collection)(false)(type);
-
-            // FIND RECURSIVE OBJECTS
-            for (const object of collection.objects())
-                object.recursive = object.properties.some((prop) =>
-                    isRecursive(object.name)(prop.value),
-                );
-
-            // RETURNS
-            return metadata;
-        };
-
-    const isRecursive =
-        (name: string) =>
-        (meta: Metadata): boolean => {
-            const similar = (str: string) =>
-                name === str ||
-                name.indexOf(`<${str},`) !== -1 ||
-                name.indexOf(`, ${str}>`) !== -1 ||
-                name.indexOf(`, ${str},`) !== -1;
-            return (
-                meta.objects.some((obj) => similar(obj.name)) ||
-                meta.arrays.some((arr) => isRecursive(name)(arr)) ||
-                meta.tuples.some((tuple) =>
-                    tuple.some((m) => isRecursive(name)(m.rest ?? m)),
-                ) ||
-                meta.maps.some((map) => isRecursive(name)(map.value))
-            );
-        };
-}
+import type ts from "typescript/lib/tsclibrary";
+
+import { Metadata } from "../metadata/Metadata";
+import { explore_metadata } from "./internal/metadata/explore_metadata";
+
+import { IProject } from "../transformers/IProject";
+
+import { MetadataCollection } from "./MetadataCollection";
+
+export namespace MetadataFactory {
+    export interface IOptions {
+        resolve: boolean;
+        constant: boolean;
+        validate?: (meta: Metadata) => void;
+    }
+
+    export const analyze =
+        (project: IProject.IModule) =>
+        (options: IOptions) =>
+        (collection: MetadataCollection) =>
+        (type: ts.Type | null): Metadata => {
+            // CONSTRUCT SCHEMA WITH OBJECTS
+            const metadata: Metadata =
+                explore_metadata(project)(options)(collection)(false)(type);
+
+            // FIND RECURSIVE OBJECTS
+            for (const object of collection.objects())
+                object.recursive = object.properties.some((prop) =>
+                    isRecursive(object.name)(prop.value),
+                );
+
+            // RETURNS
+            return metadata;
+        };
+
+    const isRecursive =
+        (name: string) =>
+        (meta: Metadata): boolean => {
+            const similar = (str: string) =>
+                name === str ||
+                name.indexOf(`<${str},`) !== -1 ||
+                name.indexOf(`, ${str}>`) !== -1 ||
+                name.indexOf(`, ${str},`) !== -1;
+            return (
+                meta.objects.some((obj) => similar(obj.name)) ||
+                meta.arrays.some((arr) => isRecursive(name)(arr)) ||
+                meta.tuples.some((tuple) =>
+                    tuple.some((m) => isRecursive(name)(m.rest ?? m)),
+                ) ||
+                meta.maps.some((map) => isRecursive(name)(map.value))
+            );
+        };
+}