typia 3.6.10 → 3.7.0-dev.20230331

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

@@ -1,48 +1,48 @@
-import ts from "typescript";
-
-import { Metadata } from "../../../metadata/Metadata";
-import { MetadataObject } from "../../../metadata/MetadataObject";
-
-import { ArrayUtil } from "../../../utils/ArrayUtil";
-
-import { MetadataCollection } from "../../MetadataCollection";
-import { MetadataFactory } from "../../MetadataFactory";
-import { emplace_metadata_object } from "./emplace_metadata_object";
-import { iterate_metadata } from "./iterate_metadata";
-
-export const iterate_metadata_object =
-    (checker: ts.TypeChecker) =>
-    (options: MetadataFactory.IOptions) =>
-    (collection: MetadataCollection) =>
-    (meta: Metadata, type: ts.Type, parentResolved: boolean): boolean => {
-        const filter = (flag: ts.TypeFlags) => (type.getFlags() & flag) !== 0;
-        if (
-            !filter(ts.TypeFlags.Object) &&
-            !type.isIntersection() &&
-            (type as any).intrinsicName !== "object"
-        )
-            return false;
-        else if (type.isIntersection()) {
-            const fakeCollection = new MetadataCollection();
-            const fakeSchema: Metadata = Metadata.initialize();
-
-            type.types.forEach((t) =>
-                iterate_metadata(checker)(options)(fakeCollection)(
-                    fakeSchema,
-                    t,
-                    parentResolved,
-                ),
-            );
-            if (
-                fakeSchema.objects.length === 0 ||
-                fakeSchema.objects.length !== fakeSchema.size()
-            )
-                return true;
-        }
-
-        const obj: MetadataObject = emplace_metadata_object(checker)(options)(
-            collection,
-        )(type, meta.nullable);
-        ArrayUtil.add(meta.objects, obj, (elem) => elem.name === obj.name);
-        return true;
-    };
+import ts from "typescript";
+
+import { Metadata } from "../../../metadata/Metadata";
+import { MetadataObject } from "../../../metadata/MetadataObject";
+
+import { ArrayUtil } from "../../../utils/ArrayUtil";
+
+import { MetadataCollection } from "../../MetadataCollection";
+import { MetadataFactory } from "../../MetadataFactory";
+import { emplace_metadata_object } from "./emplace_metadata_object";
+import { iterate_metadata } from "./iterate_metadata";
+
+export const iterate_metadata_object =
+    (checker: ts.TypeChecker) =>
+    (options: MetadataFactory.IOptions) =>
+    (collection: MetadataCollection) =>
+    (meta: Metadata, type: ts.Type, parentResolved: boolean): boolean => {
+        const filter = (flag: ts.TypeFlags) => (type.getFlags() & flag) !== 0;
+        if (
+            !filter(ts.TypeFlags.Object) &&
+            !type.isIntersection() &&
+            (type as any).intrinsicName !== "object"
+        )
+            return false;
+        else if (type.isIntersection()) {
+            const fakeCollection = new MetadataCollection();
+            const fakeSchema: Metadata = Metadata.initialize();
+
+            type.types.forEach((t) =>
+                iterate_metadata(checker)(options)(fakeCollection)(
+                    fakeSchema,
+                    t,
+                    parentResolved,
+                ),
+            );
+            if (
+                fakeSchema.objects.length === 0 ||
+                fakeSchema.objects.length !== fakeSchema.size()
+            )
+                return true;
+        }
+
+        const obj: MetadataObject = emplace_metadata_object(checker)(options)(
+            collection,
+        )(type, meta.nullable);
+        ArrayUtil.add(meta.objects, obj, (elem) => elem.name === obj.name);
+        return true;
+    };

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

@@ -1,27 +1,27 @@
-import ts from "typescript";
-
-import { Metadata } from "../../../metadata/Metadata";
-
-import { Writable } from "../../../typings/Writable";
-
-import { MetadataCollection } from "../../MetadataCollection";
-import { MetadataFactory } from "../../MetadataFactory";
-import { TypeFactory } from "../../TypeFactory";
-import { explore_metadata } from "./explore_metadata";
-
-export const iterate_metadata_resolve =
-    (checker: ts.TypeChecker) =>
-    (options: MetadataFactory.IOptions) =>
-    (collection: MetadataCollection) =>
-    (meta: Metadata, type: ts.Type, parentResolved: boolean): boolean => {
-        if (options.resolve === true && parentResolved === false) {
-            const resolved: ts.Type | null = TypeFactory.resolve(checker, type);
-            if (resolved !== null) {
-                Writable(meta).resolved = explore_metadata(checker)(options)(
-                    collection,
-                )(resolved, true);
-                return true;
-            }
-        }
-        return false;
-    };
+import ts from "typescript";
+
+import { Metadata } from "../../../metadata/Metadata";
+
+import { Writable } from "../../../typings/Writable";
+
+import { MetadataCollection } from "../../MetadataCollection";
+import { MetadataFactory } from "../../MetadataFactory";
+import { TypeFactory } from "../../TypeFactory";
+import { explore_metadata } from "./explore_metadata";
+
+export const iterate_metadata_resolve =
+    (checker: ts.TypeChecker) =>
+    (options: MetadataFactory.IOptions) =>
+    (collection: MetadataCollection) =>
+    (meta: Metadata, type: ts.Type, parentResolved: boolean): boolean => {
+        if (options.resolve === true && parentResolved === false) {
+            const resolved: ts.Type | null = TypeFactory.resolve(checker, type);
+            if (resolved !== null) {
+                Writable(meta).resolved = explore_metadata(checker)(options)(
+                    collection,
+                )(resolved, true);
+                return true;
+            }
+        }
+        return false;
+    };

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

@@ -1,33 +1,33 @@
-import ts from "typescript";
-
-import { Metadata } from "../../../metadata/Metadata";
-
-import { ArrayUtil } from "../../../utils/ArrayUtil";
-
-import { MetadataCollection } from "../../MetadataCollection";
-import { MetadataFactory } from "../../MetadataFactory";
-import { TypeFactory } from "../../TypeFactory";
-import { explore_metadata } from "./explore_metadata";
-
-export const iterate_metadata_set =
-    (checker: ts.TypeChecker) =>
-    (options: MetadataFactory.IOptions) =>
-    (collection: MetadataCollection) =>
-    (meta: Metadata, type: ts.Type): boolean => {
-        type = checker.getApparentType(type);
-
-        const name = TypeFactory.getFullName(checker, type, type.getSymbol());
-        const generic = type.aliasSymbol
-            ? type.aliasTypeArguments
-            : checker.getTypeArguments(type as ts.TypeReference);
-        if (name.substring(0, 4) !== "Set<" || generic?.length !== 1)
-            return false;
-
-        const key: ts.Type = generic[0]!;
-        ArrayUtil.set(
-            meta.sets,
-            explore_metadata(checker)(options)(collection)(key, false),
-            (elem) => elem.getName(),
-        );
-        return true;
-    };
+import ts from "typescript";
+
+import { Metadata } from "../../../metadata/Metadata";
+
+import { ArrayUtil } from "../../../utils/ArrayUtil";
+
+import { MetadataCollection } from "../../MetadataCollection";
+import { MetadataFactory } from "../../MetadataFactory";
+import { TypeFactory } from "../../TypeFactory";
+import { explore_metadata } from "./explore_metadata";
+
+export const iterate_metadata_set =
+    (checker: ts.TypeChecker) =>
+    (options: MetadataFactory.IOptions) =>
+    (collection: MetadataCollection) =>
+    (meta: Metadata, type: ts.Type): boolean => {
+        type = checker.getApparentType(type);
+
+        const name = TypeFactory.getFullName(checker, type, type.getSymbol());
+        const generic = type.aliasSymbol
+            ? type.aliasTypeArguments
+            : checker.getTypeArguments(type as ts.TypeReference);
+        if (name.substring(0, 4) !== "Set<" || generic?.length !== 1)
+            return false;
+
+        const key: ts.Type = generic[0]!;
+        ArrayUtil.set(
+            meta.sets,
+            explore_metadata(checker)(options)(collection)(key, false),
+            (elem) => elem.getName(),
+        );
+        return true;
+    };

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

@@ -1,38 +1,38 @@
-import ts from "typescript";
-
-import { Metadata } from "../../../metadata/Metadata";
-
-import { MetadataCollection } from "../../MetadataCollection";
-import { MetadataFactory } from "../../MetadataFactory";
-import { MetadataHelper } from "./MetadataHelper";
-import { explore_metadata } from "./explore_metadata";
-
-export const iterate_metadata_template =
-    (checker: ts.TypeChecker) =>
-    (options: MetadataFactory.IOptions) =>
-    (collection: MetadataCollection) =>
-    (meta: Metadata, type: ts.Type): boolean => {
-        const filter = (flag: ts.TypeFlags) => (type.getFlags() & flag) !== 0;
-        if (!filter(ts.TypeFlags.TemplateLiteral)) return false;
-
-        const template: ts.TemplateLiteralType = type as ts.TemplateLiteralType;
-        const row: Metadata[] = [];
-
-        template.texts.forEach((text, i) => {
-            // TEXT LITERAL TYPE
-            if (text !== "") row.push(MetadataHelper.literal_to_metadata(text));
-
-            // BINDED TEMPLATE TYPE
-            const binded: ts.Type | undefined = template.types[i];
-            if (binded)
-                row.push(
-                    explore_metadata(checker)(options)(collection)(
-                        binded,
-                        false,
-                    ),
-                );
-        });
-        meta.templates.push(row);
-
-        return true;
-    };
+import ts from "typescript";
+
+import { Metadata } from "../../../metadata/Metadata";
+
+import { MetadataCollection } from "../../MetadataCollection";
+import { MetadataFactory } from "../../MetadataFactory";
+import { MetadataHelper } from "./MetadataHelper";
+import { explore_metadata } from "./explore_metadata";
+
+export const iterate_metadata_template =
+    (checker: ts.TypeChecker) =>
+    (options: MetadataFactory.IOptions) =>
+    (collection: MetadataCollection) =>
+    (meta: Metadata, type: ts.Type): boolean => {
+        const filter = (flag: ts.TypeFlags) => (type.getFlags() & flag) !== 0;
+        if (!filter(ts.TypeFlags.TemplateLiteral)) return false;
+
+        const template: ts.TemplateLiteralType = type as ts.TemplateLiteralType;
+        const row: Metadata[] = [];
+
+        template.texts.forEach((text, i) => {
+            // TEXT LITERAL TYPE
+            if (text !== "") row.push(MetadataHelper.literal_to_metadata(text));
+
+            // BINDED TEMPLATE TYPE
+            const binded: ts.Type | undefined = template.types[i];
+            if (binded)
+                row.push(
+                    explore_metadata(checker)(options)(collection)(
+                        binded,
+                        false,
+                    ),
+                );
+        });
+        meta.templates.push(row);
+
+        return true;
+    };

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

@@ -1,45 +1,45 @@
-import ts from "typescript";
-
-import { Metadata } from "../../../metadata/Metadata";
-
-import { Writable } from "../../../typings/Writable";
-
-import { ArrayUtil } from "../../../utils/ArrayUtil";
-
-import { MetadataCollection } from "../../MetadataCollection";
-import { MetadataFactory } from "../../MetadataFactory";
-import { explore_metadata } from "./explore_metadata";
-
-export const iterate_metadata_tuple =
-    (checker: ts.TypeChecker) =>
-    (options: MetadataFactory.IOptions) =>
-    (collection: MetadataCollection) =>
-    (meta: Metadata, type: ts.TupleType): boolean => {
-        if (!(checker as any).isTupleType(type)) return false;
-
-        const elementFlags: readonly ts.ElementFlags[] =
-            type.elementFlags ??
-            (type.target as ts.TupleType)?.elementFlags ??
-            [];
-
-        const children: Metadata[] = checker
-            .getTypeArguments(type as ts.TypeReference)
-            .map((elem, i) => {
-                const child: Metadata = explore_metadata(checker)(options)(
-                    collection,
-                )(elem, false);
-
-                const flag: ts.ElementFlags | undefined = elementFlags[i];
-                if (flag !== ts.ElementFlags.Rest) return child;
-
-                const wrapper: Metadata = Metadata.initialize();
-                Writable(wrapper).rest = child;
-                return wrapper;
-            });
-        ArrayUtil.set(meta.tuples, children, join_tuple_names);
-        return true;
-    };
-
-function join_tuple_names(metas: Metadata[]): string {
-    return `[${metas.map((m) => m.getName).join(", ")}]`;
-}
+import ts from "typescript";
+
+import { Metadata } from "../../../metadata/Metadata";
+
+import { Writable } from "../../../typings/Writable";
+
+import { ArrayUtil } from "../../../utils/ArrayUtil";
+
+import { MetadataCollection } from "../../MetadataCollection";
+import { MetadataFactory } from "../../MetadataFactory";
+import { explore_metadata } from "./explore_metadata";
+
+export const iterate_metadata_tuple =
+    (checker: ts.TypeChecker) =>
+    (options: MetadataFactory.IOptions) =>
+    (collection: MetadataCollection) =>
+    (meta: Metadata, type: ts.TupleType): boolean => {
+        if (!(checker as any).isTupleType(type)) return false;
+
+        const elementFlags: readonly ts.ElementFlags[] =
+            type.elementFlags ??
+            (type.target as ts.TupleType)?.elementFlags ??
+            [];
+
+        const children: Metadata[] = checker
+            .getTypeArguments(type as ts.TypeReference)
+            .map((elem, i) => {
+                const child: Metadata = explore_metadata(checker)(options)(
+                    collection,
+                )(elem, false);
+
+                const flag: ts.ElementFlags | undefined = elementFlags[i];
+                if (flag !== ts.ElementFlags.Rest) return child;
+
+                const wrapper: Metadata = Metadata.initialize();
+                Writable(wrapper).rest = child;
+                return wrapper;
+            });
+        ArrayUtil.set(meta.tuples, children, join_tuple_names);
+        return true;
+    };
+
+function join_tuple_names(metas: Metadata[]): string {
+    return `[${metas.map((m) => m.getName).join(", ")}]`;
+}

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

@@ -1,59 +1,59 @@
-import ts from "typescript";
-
-import { Metadata } from "../../../metadata/Metadata";
-
-import { Writable } from "../../../typings/Writable";
-
-import { MetadataCollection } from "../../MetadataCollection";
-import { MetadataFactory } from "../../MetadataFactory";
-import { TypeFactory } from "../../TypeFactory";
-import { iterate_metadata } from "./iterate_metadata";
-
-export const iterate_metadata_union =
-    (checker: ts.TypeChecker) =>
-    (options: MetadataFactory.IOptions) =>
-    (collection: MetadataCollection) =>
-    (meta: Metadata, type: ts.Type, parentResolved: boolean): boolean => {
-        if (!type.isUnion()) return false;
-        else if (options.resolve === false || parentResolved === true) {
-            type.types.forEach((t) =>
-                iterate_metadata(checker)(options)(collection)(meta, t, false),
-            );
-            return true;
-        }
-
-        const filter = (flag: ts.TypeFlags, t: ts.Type) =>
-            (t.getFlags() & flag) !== 0;
-        const normals: ts.Type[] = [];
-        const toJsons: ts.Type[] = [];
-
-        for (const individual of type.types) {
-            if (filter(ts.TypeFlags.Object, individual)) {
-                const resolved: ts.Type | null = TypeFactory.resolve(
-                    checker,
-                    individual,
-                );
-                if (resolved !== null) toJsons.push(resolved);
-                else normals.push(individual);
-            } else normals.push(individual);
-        }
-        if (toJsons.length !== 0) {
-            Writable(meta).resolved = (() => {
-                const union: Metadata = Metadata.initialize();
-                toJsons.forEach((t) =>
-                    iterate_metadata(checker)(options)(collection)(
-                        meta,
-                        t,
-                        true,
-                    ),
-                );
-                if (union.objects.length > 1)
-                    union.union_index = collection.getUnionIndex(union);
-                return union;
-            })();
-        }
-        normals.forEach((t) =>
-            iterate_metadata(checker)(options)(collection)(meta, t, false),
-        );
-        return true;
-    };
+import ts from "typescript";
+
+import { Metadata } from "../../../metadata/Metadata";
+
+import { Writable } from "../../../typings/Writable";
+
+import { MetadataCollection } from "../../MetadataCollection";
+import { MetadataFactory } from "../../MetadataFactory";
+import { TypeFactory } from "../../TypeFactory";
+import { iterate_metadata } from "./iterate_metadata";
+
+export const iterate_metadata_union =
+    (checker: ts.TypeChecker) =>
+    (options: MetadataFactory.IOptions) =>
+    (collection: MetadataCollection) =>
+    (meta: Metadata, type: ts.Type, parentResolved: boolean): boolean => {
+        if (!type.isUnion()) return false;
+        else if (options.resolve === false || parentResolved === true) {
+            type.types.forEach((t) =>
+                iterate_metadata(checker)(options)(collection)(meta, t, false),
+            );
+            return true;
+        }
+
+        const filter = (flag: ts.TypeFlags, t: ts.Type) =>
+            (t.getFlags() & flag) !== 0;
+        const normals: ts.Type[] = [];
+        const toJsons: ts.Type[] = [];
+
+        for (const individual of type.types) {
+            if (filter(ts.TypeFlags.Object, individual)) {
+                const resolved: ts.Type | null = TypeFactory.resolve(
+                    checker,
+                    individual,
+                );
+                if (resolved !== null) toJsons.push(resolved);
+                else normals.push(individual);
+            } else normals.push(individual);
+        }
+        if (toJsons.length !== 0) {
+            Writable(meta).resolved = (() => {
+                const union: Metadata = Metadata.initialize();
+                toJsons.forEach((t) =>
+                    iterate_metadata(checker)(options)(collection)(
+                        meta,
+                        t,
+                        true,
+                    ),
+                );
+                if (union.objects.length > 1)
+                    union.union_index = collection.getUnionIndex(union);
+                return union;
+            })();
+        }
+        normals.forEach((t) =>
+            iterate_metadata(checker)(options)(collection)(meta, t, false),
+        );
+        return true;
+    };

package/src/functional/$any.ts

@@ -1,3 +1,3 @@
-export function $any(val: any): any {
-    return val !== undefined ? JSON.parse(JSON.stringify(val)) : undefined;
-}
+export function $any(val: any): any {
+    return val !== undefined ? JSON.parse(JSON.stringify(val)) : undefined;
+}

package/src/functional/$dictionary.ts

@@ -0,0 +1,17 @@
+import { Customizable } from "../typings/Customizable";
+
+export const $dictionary = (() => {
+    const glob: {
+        __typia_custom_validator: Map<
+            `${string}:${keyof Customizable}`,
+            (tagText: string) => (value: any) => boolean
+        >;
+    } =
+        typeof global === "object" &&
+        typeof global.process === "object" &&
+        typeof global.process.versions === "object" &&
+        typeof global.process.versions.node !== "undefined"
+            ? (global as any)
+            : (window as any);
+    return (glob.__typia_custom_validator ??= new Map());
+})();

package/src/functional/$every.ts

@@ -1,11 +1,11 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-export const $every = <T>(
-    array: T[],
-    pred: (value: T, i: number) => null | Omit<TypeGuardError.IProps, "method">,
-): null | Omit<TypeGuardError.IProps, "method"> => {
-    let error: null | Omit<TypeGuardError.IProps, "method"> = null;
-    for (let i: number = 0; i < array.length; ++i)
-        if (null !== (error = pred(array[i]!, i))) return error;
-    return null;
-};
+import { TypeGuardError } from "../TypeGuardError";
+
+export const $every = <T>(
+    array: T[],
+    pred: (value: T, i: number) => null | Omit<TypeGuardError.IProps, "method">,
+): null | Omit<TypeGuardError.IProps, "method"> => {
+    let error: null | Omit<TypeGuardError.IProps, "method"> = null;
+    for (let i: number = 0; i < array.length; ++i)
+        if (null !== (error = pred(array[i]!, i))) return error;
+    return null;
+};

package/src/functional/$guard.ts

@@ -1,35 +1,35 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-/* -----------------------------------------------------------
-    ASSERT V2 -> USE (NULL OR ERROR) CONDITION
------------------------------------------------------------ */
-// /**
-//  * @internal
-//  */
-// export const $guardV2 =
-//     (method: string) => (props: Omit<TypeGuardError.IProps, "method">) =>
-//         new TypeGuardError({
-//             method,
-//             path: props.path,
-//             expected: props.expected,
-//             value: props.value,
-//         });
-
-/* -----------------------------------------------------------
-    ASSERT V3 -> (CONDITION OR THROW(exceptable): FALSE)
------------------------------------------------------------ */
-/**
- * @internal
- */
-export const $guard =
-    (method: string) =>
-    (exceptionable: boolean, props: Omit<TypeGuardError.IProps, "method">) => {
-        if (exceptionable === true)
-            throw new TypeGuardError({
-                method,
-                path: props.path,
-                expected: props.expected,
-                value: props.value,
-            });
-        return false;
-    };
+import { TypeGuardError } from "../TypeGuardError";
+
+/* -----------------------------------------------------------
+    ASSERT V2 -> USE (NULL OR ERROR) CONDITION
+----------------------------------------------------------- */
+// /**
+//  * @internal
+//  */
+// export const $guardV2 =
+//     (method: string) => (props: Omit<TypeGuardError.IProps, "method">) =>
+//         new TypeGuardError({
+//             method,
+//             path: props.path,
+//             expected: props.expected,
+//             value: props.value,
+//         });
+
+/* -----------------------------------------------------------
+    ASSERT V3 -> (CONDITION OR THROW(exceptable): FALSE)
+----------------------------------------------------------- */
+/**
+ * @internal
+ */
+export const $guard =
+    (method: string) =>
+    (exceptionable: boolean, props: Omit<TypeGuardError.IProps, "method">) => {
+        if (exceptionable === true)
+            throw new TypeGuardError({
+                method,
+                path: props.path,
+                expected: props.expected,
+                value: props.value,
+            });
+        return false;
+    };

package/src/functional/$is_between.ts

@@ -1,7 +1,7 @@
-export function $is_between(
-    value: number,
-    minimum: number,
-    maximum: number,
-): boolean {
-    return minimum <= value && value <= maximum;
-}
+export function $is_between(
+    value: number,
+    minimum: number,
+    maximum: number,
+): boolean {
+    return minimum <= value && value <= maximum;
+}