typia 4.1.0 → 4.1.1-dev.20230621

package/lib/factories/internal/metadata/iterate_metadata_array.js

@@ -7,7 +7,7 @@ var iterate_metadata_array = function (checker) {
     return function (options) {
         return function (collection) {
             return function (meta, type) {
-                if (!checker.isArrayType(type) && !checker.isArrayLikeType(type))
+                if (!checker.isArrayType(type))
                     return false;
                 var array = (0, emplace_metadata_array_1.emplace_metadata_array)(checker)(options)(collection)(type, meta.nullable);
                 ArrayUtil_1.ArrayUtil.add(meta.arrays, array, function (elem) { return elem.name === array.name; });

package/lib/factories/internal/metadata/iterate_metadata_array.js.map

@@ -1 +1 @@
-{"version":3,"file":"iterate_metadata_array.js","sourceRoot":"","sources":["../../../../src/factories/internal/metadata/iterate_metadata_array.ts"],"names":[],"mappings":";;;AAKA,sDAAqD;AAIrD,mEAAkE;AAE3D,IAAM,sBAAsB,GAC/B,UAAC,OAAuB;IACxB,OAAA,UAAC,OAAiC;QAClC,OAAA,UAAC,UAA8B;YAC/B,OAAA,UAAC,IAAc,EAAE,IAAa;gBAC1B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC;oBAC5D,OAAO,KAAK,CAAC;gBAEjB,IAAM,KAAK,GAAkB,IAAA,+CAAsB,EAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CACjE,UAAU,CACb,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvB,qBAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,UAAC,IAAI,IAAK,OAAA,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAxB,CAAwB,CAAC,CAAC;gBACtE,OAAO,IAAI,CAAC;YAChB,CAAC;QATD,CASC;IAVD,CAUC;AAXD,CAWC,CAAC;AAbO,QAAA,sBAAsB,0BAa7B"}
+{"version":3,"file":"iterate_metadata_array.js","sourceRoot":"","sources":["../../../../src/factories/internal/metadata/iterate_metadata_array.ts"],"names":[],"mappings":";;;AAKA,sDAAqD;AAIrD,mEAAkE;AAE3D,IAAM,sBAAsB,GAC/B,UAAC,OAAuB;IACxB,OAAA,UAAC,OAAiC;QAClC,OAAA,UAAC,UAA8B;YAC/B,OAAA,UAAC,IAAc,EAAE,IAAa;gBAC1B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;oBAAE,OAAO,KAAK,CAAC;gBAE7C,IAAM,KAAK,GAAkB,IAAA,+CAAsB,EAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CACjE,UAAU,CACb,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvB,qBAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,UAAC,IAAI,IAAK,OAAA,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAxB,CAAwB,CAAC,CAAC;gBACtE,OAAO,IAAI,CAAC;YAChB,CAAC;QARD,CAQC;IATD,CASC;AAVD,CAUC,CAAC;AAZO,QAAA,sBAAsB,0BAY7B"}

package/lib/module.d.ts

@@ -723,7 +723,7 @@ export declare function random<T>(generator?: Partial<IRandomGenerator>): Primit
  * Converts a union literal type to an array of its members.
  *
  * ```typescript
- * literals<"A" | "B" | 1>; // [1, 2, 3] as const
+ * literals<"A" | "B" | 1>; // ["A", "B", 1]
  * ```
  *
  * @template T Union literal type
@@ -738,7 +738,7 @@ export declare function literals(): never;
  * Converts a union literal type to an array of its members.
  *
  * ```typescript
- * literals<"A" | "B" | 1>; // [1, 2, 3] as const
+ * literals<"A" | "B" | 1>; // ["A", "B", 1]
  * ```
  *
  * @template T Union literal type

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typia",
-  "version": "4.1.0",
+  "version": "4.1.1-dev.20230621",
   "description": "Superfast runtime validators with only one line",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -74,7 +74,8 @@
     "commander": "^10.0.0",
     "comment-json": "^4.2.3",
     "inquirer": "^8.2.5",
-    "randexp": "^0.5.3"
+    "randexp": "^0.5.3",
+    "raw-loader": "^4.0.2"
   },
   "peerDependencies": {
     "typescript": ">= 4.7.4"

package/src/factories/CommentFactory.ts

@@ -1,64 +1,64 @@
-import ts from "typescript";
-
-export namespace CommentFactory {
-    export const description = (symbol: ts.Symbol): string | undefined => {
-        const node = symbol.declarations?.[0];
-        if (!node) return undefined;
-
-        const range = ts.getCommentRange(node);
-        const text: string = node
-            .getSourceFile()
-            .text.substring(range.pos, range.end);
-        const output: string = transform(text).join("\n");
-        return output.length ? output : undefined;
-    };
-
-    export const merge = (comments: ts.SymbolDisplayPart[]): string =>
-        comments
-            .map((part) => part.text)
-            .map((str) => str.split("\r\n").join("\n"))
-            .join("");
-}
-
-const transform = (text: string): string[] => {
-    const elements: string[] = text.split("\r\n").join("\n").split("\n");
-    const first: number = lastIndexOf(elements)((elem) =>
-        elem.trim().startsWith("/**"),
-    );
-    const last: number = lastIndexOf(elements)((elem) =>
-        elem.trim().endsWith("*/"),
-    );
-
-    const cut: string[] = elements.slice(first, last + 1);
-    return cut
-        .map((elem, i) => {
-            if (i === 0) elem = elem.substring(elem.lastIndexOf("/**") + 3);
-            if (i === cut.length - 1)
-                elem = elem.substring(0, elem.lastIndexOf("*/"));
-            return trim(elem);
-        })
-        .filter(
-            (str, i, array) =>
-                (i !== 0 && i !== array.length - 1) || !!str.length,
-        );
-};
-
-const lastIndexOf =
-    <T>(array: T[]) =>
-    (pred: (elem: T) => boolean) => {
-        for (let i = array.length - 1; i >= 0; i--)
-            if (pred(array[i]!)) return i;
-        return -1;
-    };
-
-const trim = (str: string): string => {
-    const vulnerable = (ch: string) =>
-        ch === " " || ch === "\n" || ch === "\t" || ch === "*";
-    let start: number;
-    let end: number;
-    for (start = 0; start < str.length; ++start)
-        if (!vulnerable(str.charAt(start))) break;
-    for (end = str.length - 1; end >= 0; --end)
-        if (!vulnerable(str.charAt(end))) break;
-    return start > end ? "" : str.substring(start, end + 1).trim();
-};
+import ts from "typescript";
+
+export namespace CommentFactory {
+    export const description = (symbol: ts.Symbol): string | undefined => {
+        const node = symbol.declarations?.[0];
+        if (!node) return undefined;
+
+        const range = ts.getCommentRange(node);
+        const text: string = node
+            .getSourceFile()
+            .text.substring(range.pos, range.end);
+        const output: string = transform(text).join("\n");
+        return output.length ? output : undefined;
+    };
+
+    export const merge = (comments: ts.SymbolDisplayPart[]): string =>
+        comments
+            .map((part) => part.text)
+            .map((str) => str.split("\r\n").join("\n"))
+            .join("");
+}
+
+const transform = (text: string): string[] => {
+    const elements: string[] = text.split("\r\n").join("\n").split("\n");
+    const first: number = lastIndexOf(elements)((elem) =>
+        elem.trim().startsWith("/**"),
+    );
+    const last: number = lastIndexOf(elements)((elem) =>
+        elem.trim().endsWith("*/"),
+    );
+
+    const cut: string[] = elements.slice(first, last + 1);
+    return cut
+        .map((elem, i) => {
+            if (i === 0) elem = elem.substring(elem.lastIndexOf("/**") + 3);
+            if (i === cut.length - 1)
+                elem = elem.substring(0, elem.lastIndexOf("*/"));
+            return trim(elem);
+        })
+        .filter(
+            (str, i, array) =>
+                (i !== 0 && i !== array.length - 1) || !!str.length,
+        );
+};
+
+const lastIndexOf =
+    <T>(array: T[]) =>
+    (pred: (elem: T) => boolean) => {
+        for (let i = array.length - 1; i >= 0; i--)
+            if (pred(array[i]!)) return i;
+        return -1;
+    };
+
+const trim = (str: string): string => {
+    const vulnerable = (ch: string) =>
+        ch === " " || ch === "\n" || ch === "\t" || ch === "*";
+    let start: number;
+    let end: number;
+    for (start = 0; start < str.length; ++start)
+        if (!vulnerable(str.charAt(start))) break;
+    for (end = str.length - 1; end >= 0; --end)
+        if (!vulnerable(str.charAt(end))) break;
+    return start > end ? "" : str.substring(start, end + 1).trim();
+};

package/src/factories/IdentifierFactory.ts

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

package/src/factories/MetadataFactory.ts

@@ -1,30 +1,30 @@
-import ts from "typescript";
-
-import { Metadata } from "../metadata/Metadata";
-import { explore_metadata } from "./internal/metadata/explore_metadata";
-import { iterate_metadata_collection } from "./internal/metadata/iterate_metadata_collection";
-import { iterate_metadata_sort } from "./internal/metadata/iterate_metadata_sort";
-
-import { MetadataCollection } from "./MetadataCollection";
-
-export namespace MetadataFactory {
-    export interface IOptions {
-        resolve: boolean;
-        constant: boolean;
-        absorb: boolean;
-        validate?: (meta: Metadata) => void;
-    }
-
-    export const analyze =
-        (checker: ts.TypeChecker) =>
-        (options: IOptions) =>
-        (collection: MetadataCollection) =>
-        (type: ts.Type | null): Metadata => {
-            const meta: Metadata = explore_metadata(checker)(options)(
-                collection,
-            )(type, false);
-            iterate_metadata_collection(collection);
-            iterate_metadata_sort(collection)(meta);
-            return meta;
-        };
-}
+import ts from "typescript";
+
+import { Metadata } from "../metadata/Metadata";
+import { explore_metadata } from "./internal/metadata/explore_metadata";
+import { iterate_metadata_collection } from "./internal/metadata/iterate_metadata_collection";
+import { iterate_metadata_sort } from "./internal/metadata/iterate_metadata_sort";
+
+import { MetadataCollection } from "./MetadataCollection";
+
+export namespace MetadataFactory {
+    export interface IOptions {
+        resolve: boolean;
+        constant: boolean;
+        absorb: boolean;
+        validate?: (meta: Metadata) => void;
+    }
+
+    export const analyze =
+        (checker: ts.TypeChecker) =>
+        (options: IOptions) =>
+        (collection: MetadataCollection) =>
+        (type: ts.Type | null): Metadata => {
+            const meta: Metadata = explore_metadata(checker)(options)(
+                collection,
+            )(type, false);
+            iterate_metadata_collection(collection);
+            iterate_metadata_sort(collection)(meta);
+            return meta;
+        };
+}

package/src/factories/internal/metadata/iterate_metadata_array.ts

@@ -14,8 +14,7 @@ export const iterate_metadata_array =
     (options: MetadataFactory.IOptions) =>
     (collection: MetadataCollection) =>
     (meta: Metadata, type: ts.Type): boolean => {
-        if (!checker.isArrayType(type) && !checker.isArrayLikeType(type))
-            return false;
+        if (!checker.isArrayType(type)) return false;
 
         const array: MetadataArray = emplace_metadata_array(checker)(options)(
             collection,

package/src/metadata/MetadataObject.ts

@@ -1,118 +1,118 @@
-import { ClassProperties } from "../typings/ClassProperties";
-
-import { IJsDocTagInfo } from "./IJsDocTagInfo";
-import { IMetadataObject } from "./IMetadataObject";
-import { MetadataProperty } from "./MetadataProperty";
-
-export class MetadataObject {
-    public readonly name: string;
-    public readonly properties: Array<MetadataProperty>;
-    public readonly description: string | undefined;
-    public readonly jsDocTags: IJsDocTagInfo[];
-
-    public readonly index: number;
-    public validated: boolean;
-    public recursive: boolean;
-    public nullables: boolean[] = [];
-
-    /* -----------------------------------------------------------
-        CONSTRUCTORS
-    ----------------------------------------------------------- */
-    /**
-     * @hidden
-     */
-    private constructor(props: ClassProperties<MetadataObject>) {
-        this.name = props.name;
-        this.properties = props.properties;
-        this.description = props.description;
-        this.jsDocTags = props.jsDocTags;
-
-        this.index = props.index;
-        this.validated = props.validated;
-        this.recursive = props.recursive;
-        this.nullables = [];
-    }
-
-    /**
-     * @internal
-     */
-    public static create(props: ClassProperties<MetadataObject>) {
-        return new MetadataObject(props);
-    }
-
-    /**
-     * @internal
-     */
-    public static _From_without_properties(
-        obj: IMetadataObject,
-    ): MetadataObject {
-        return this.create({
-            name: obj.name,
-            properties: [],
-            description: obj.description,
-            jsDocTags: obj.jsDocTags,
-
-            index: obj.index,
-            validated: obj.validated,
-            recursive: obj.recursive,
-            nullables: obj.nullables.slice(),
-        });
-    }
-
-    /**
-     * @internal
-     */
-    public _Is_simple(level: number = 0): boolean {
-        return (
-            this.recursive === false &&
-            this.properties.length < 10 &&
-            this.properties.every(
-                (property) =>
-                    property.key.isSoleLiteral() &&
-                    property.value.size() === 1 &&
-                    property.value.required === true &&
-                    property.value.nullable === false &&
-                    (property.value.atomics.length === 1 ||
-                        (level < 1 &&
-                            property.value.objects.length === 1 &&
-                            property.value.objects[0]!._Is_simple(level + 1))),
-            )
-        );
-    }
-
-    public toJSON(): IMetadataObject {
-        return {
-            name: this.name,
-            properties: this.properties.map((property) => property.toJSON()),
-            description: this.description,
-            jsDocTags: this.jsDocTags,
-
-            index: this.index,
-            validated: this.validated,
-            recursive: this.recursive,
-            nullables: this.nullables.slice(),
-        };
-    }
-}
-
-/**
- * @internal
- */
-export namespace MetadataObject {
-    export const intersects = (x: MetadataObject, y: MetadataObject): boolean =>
-        x.properties.some(
-            (prop) =>
-                y.properties.find(
-                    (oppo) => prop.key.getName() === oppo.key.getName(),
-                ) !== undefined,
-        );
-
-    export const covers = (x: MetadataObject, y: MetadataObject): boolean =>
-        x.properties.length >= y.properties.length &&
-        x.properties.every(
-            (prop) =>
-                y.properties.find(
-                    (oppo) => prop.key.getName() === oppo.key.getName(),
-                ) !== undefined,
-        );
-}
+import { ClassProperties } from "../typings/ClassProperties";
+
+import { IJsDocTagInfo } from "./IJsDocTagInfo";
+import { IMetadataObject } from "./IMetadataObject";
+import { MetadataProperty } from "./MetadataProperty";
+
+export class MetadataObject {
+    public readonly name: string;
+    public readonly properties: Array<MetadataProperty>;
+    public readonly description: string | undefined;
+    public readonly jsDocTags: IJsDocTagInfo[];
+
+    public readonly index: number;
+    public validated: boolean;
+    public recursive: boolean;
+    public nullables: boolean[] = [];
+
+    /* -----------------------------------------------------------
+        CONSTRUCTORS
+    ----------------------------------------------------------- */
+    /**
+     * @hidden
+     */
+    private constructor(props: ClassProperties<MetadataObject>) {
+        this.name = props.name;
+        this.properties = props.properties;
+        this.description = props.description;
+        this.jsDocTags = props.jsDocTags;
+
+        this.index = props.index;
+        this.validated = props.validated;
+        this.recursive = props.recursive;
+        this.nullables = [];
+    }
+
+    /**
+     * @internal
+     */
+    public static create(props: ClassProperties<MetadataObject>) {
+        return new MetadataObject(props);
+    }
+
+    /**
+     * @internal
+     */
+    public static _From_without_properties(
+        obj: IMetadataObject,
+    ): MetadataObject {
+        return this.create({
+            name: obj.name,
+            properties: [],
+            description: obj.description,
+            jsDocTags: obj.jsDocTags,
+
+            index: obj.index,
+            validated: obj.validated,
+            recursive: obj.recursive,
+            nullables: obj.nullables.slice(),
+        });
+    }
+
+    /**
+     * @internal
+     */
+    public _Is_simple(level: number = 0): boolean {
+        return (
+            this.recursive === false &&
+            this.properties.length < 10 &&
+            this.properties.every(
+                (property) =>
+                    property.key.isSoleLiteral() &&
+                    property.value.size() === 1 &&
+                    property.value.required === true &&
+                    property.value.nullable === false &&
+                    (property.value.atomics.length === 1 ||
+                        (level < 1 &&
+                            property.value.objects.length === 1 &&
+                            property.value.objects[0]!._Is_simple(level + 1))),
+            )
+        );
+    }
+
+    public toJSON(): IMetadataObject {
+        return {
+            name: this.name,
+            properties: this.properties.map((property) => property.toJSON()),
+            description: this.description,
+            jsDocTags: this.jsDocTags,
+
+            index: this.index,
+            validated: this.validated,
+            recursive: this.recursive,
+            nullables: this.nullables.slice(),
+        };
+    }
+}
+
+/**
+ * @internal
+ */
+export namespace MetadataObject {
+    export const intersects = (x: MetadataObject, y: MetadataObject): boolean =>
+        x.properties.some(
+            (prop) =>
+                y.properties.find(
+                    (oppo) => prop.key.getName() === oppo.key.getName(),
+                ) !== undefined,
+        );
+
+    export const covers = (x: MetadataObject, y: MetadataObject): boolean =>
+        x.properties.length >= y.properties.length &&
+        x.properties.every(
+            (prop) =>
+                y.properties.find(
+                    (oppo) => prop.key.getName() === oppo.key.getName(),
+                ) !== undefined,
+        );
+}