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

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

@@ -1,40 +1,40 @@
-import type ts from "typescript/lib/tsclibrary";
-
-import { Metadata } from "../../../metadata/Metadata";
-
-import { IProject } from "../../../transformers/IProject";
-
-import { MetadataCollection } from "../../MetadataCollection";
-import { MetadataFactory } from "../../MetadataFactory";
-import { MetadataHelper } from "./MetadataHelper";
-import { explore_metadata } from "./explore_metadata";
-
-export const iterate_metadata_template =
-    ({ tsc, checker }: IProject.IModule) =>
-    (options: MetadataFactory.IOptions) =>
-    (collection: MetadataCollection) =>
-    (meta: Metadata) =>
-    (type: ts.Type): boolean => {
-        const filter = (flag: ts.TypeFlags) => (type.flags & flag) !== 0;
-        if (!filter(tsc.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({ tsc, checker })(options)(collection)(
-                        false,
-                    )(binded),
-                );
-        });
-        meta.templates.push(row);
-
-        return true;
-    };
+import type ts from "typescript/lib/tsclibrary";
+
+import { Metadata } from "../../../metadata/Metadata";
+
+import { IProject } from "../../../transformers/IProject";
+
+import { MetadataCollection } from "../../MetadataCollection";
+import { MetadataFactory } from "../../MetadataFactory";
+import { MetadataHelper } from "./MetadataHelper";
+import { explore_metadata } from "./explore_metadata";
+
+export const iterate_metadata_template =
+    ({ tsc, checker }: IProject.IModule) =>
+    (options: MetadataFactory.IOptions) =>
+    (collection: MetadataCollection) =>
+    (meta: Metadata) =>
+    (type: ts.Type): boolean => {
+        const filter = (flag: ts.TypeFlags) => (type.flags & flag) !== 0;
+        if (!filter(tsc.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({ tsc, checker })(options)(collection)(
+                        false,
+                    )(binded),
+                );
+        });
+        meta.templates.push(row);
+
+        return true;
+    };

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

@@ -1,51 +1,51 @@
-import type ts from "typescript/lib/tsclibrary";
-
-import { Metadata } from "../../../metadata/Metadata";
-
-import { IProject } from "../../../transformers/IProject";
-
-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 =
-    ({ tsc, checker }: IProject.IModule) =>
-    (options: MetadataFactory.IOptions) =>
-    (collection: MetadataCollection) =>
-    (meta: Metadata) =>
-    (type: ts.TupleType): boolean => {
-        if (!checker.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({ tsc, checker })(
-                    options,
-                )(collection)(false)(elem);
-
-                // CHECK OPTIONAL
-                const flag: ts.ElementFlags | undefined = elementFlags[i];
-                if (flag === tsc.ElementFlags.Optional)
-                    Writable(child).optional = true;
-
-                // REST TYPE
-                if (flag !== tsc.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;
-    };
-
-const join_tuple_names = (metas: Metadata[]): string =>
-    `[${metas.map((m) => m.getName).join(", ")}]`;
+import type ts from "typescript/lib/tsclibrary";
+
+import { Metadata } from "../../../metadata/Metadata";
+
+import { IProject } from "../../../transformers/IProject";
+
+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 =
+    ({ tsc, checker }: IProject.IModule) =>
+    (options: MetadataFactory.IOptions) =>
+    (collection: MetadataCollection) =>
+    (meta: Metadata) =>
+    (type: ts.TupleType): boolean => {
+        if (!checker.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({ tsc, checker })(
+                    options,
+                )(collection)(false)(elem);
+
+                // CHECK OPTIONAL
+                const flag: ts.ElementFlags | undefined = elementFlags[i];
+                if (flag === tsc.ElementFlags.Optional)
+                    Writable(child).optional = true;
+
+                // REST TYPE
+                if (flag !== tsc.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;
+    };
+
+const join_tuple_names = (metas: Metadata[]): string =>
+    `[${metas.map((m) => m.getName).join(", ")}]`;

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

@@ -1,59 +1,59 @@
-import type ts from "typescript/lib/tsclibrary";
-
-import { Metadata } from "../../../metadata/Metadata";
-
-import { IProject } from "../../../transformers/IProject";
-
-import { Writable } from "../../../typings/Writable";
-
-import { TsTypeUtil } from "../../../utils/TsTypeUtil";
-
-import { MetadataCollection } from "../../MetadataCollection";
-import { MetadataFactory } from "../../MetadataFactory";
-import { TypeFactory } from "../../TypeFactory";
-import { iterate_metadata } from "./iterate_metadata";
-
-export const iterate_metadata_union =
-    (p: IProject.IModule) =>
-    (options: MetadataFactory.IOptions) =>
-    (collection: MetadataCollection) =>
-    (parentResolved: boolean) =>
-    (meta: Metadata) =>
-    (type: ts.Type): boolean => {
-        if (!TsTypeUtil.isUnion(p.tsc)(type)) return false;
-        else if (options.resolve === false || parentResolved === true) {
-            type.types.forEach((t) =>
-                iterate_metadata(p)(options)(collection)(false)(meta)(t),
-            );
-            return true;
-        }
-
-        const filter = (flag: ts.TypeFlags, t: ts.Type) =>
-            (t.flags & flag) !== 0;
-        const normals: ts.Type[] = [];
-        const toJsons: ts.Type[] = [];
-
-        for (const individual of type.types) {
-            if (filter(p.tsc.TypeFlags.Object, individual)) {
-                const resolved: ts.Type | null =
-                    TypeFactory.resolve(p)(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(p)(options)(collection)(true)(meta)(t),
-                );
-                if (union.objects.length > 1)
-                    union.union_index = collection.getUnionIndex(union);
-                return union;
-            })();
-        }
-        normals.forEach((t) =>
-            iterate_metadata(p)(options)(collection)(false)(meta)(t),
-        );
-        return true;
-    };
+import type ts from "typescript/lib/tsclibrary";
+
+import { Metadata } from "../../../metadata/Metadata";
+
+import { IProject } from "../../../transformers/IProject";
+
+import { Writable } from "../../../typings/Writable";
+
+import { TsTypeUtil } from "../../../utils/TsTypeUtil";
+
+import { MetadataCollection } from "../../MetadataCollection";
+import { MetadataFactory } from "../../MetadataFactory";
+import { TypeFactory } from "../../TypeFactory";
+import { iterate_metadata } from "./iterate_metadata";
+
+export const iterate_metadata_union =
+    (p: IProject.IModule) =>
+    (options: MetadataFactory.IOptions) =>
+    (collection: MetadataCollection) =>
+    (parentResolved: boolean) =>
+    (meta: Metadata) =>
+    (type: ts.Type): boolean => {
+        if (!TsTypeUtil.isUnion(p.tsc)(type)) return false;
+        else if (options.resolve === false || parentResolved === true) {
+            type.types.forEach((t) =>
+                iterate_metadata(p)(options)(collection)(false)(meta)(t),
+            );
+            return true;
+        }
+
+        const filter = (flag: ts.TypeFlags, t: ts.Type) =>
+            (t.flags & flag) !== 0;
+        const normals: ts.Type[] = [];
+        const toJsons: ts.Type[] = [];
+
+        for (const individual of type.types) {
+            if (filter(p.tsc.TypeFlags.Object, individual)) {
+                const resolved: ts.Type | null =
+                    TypeFactory.resolve(p)(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(p)(options)(collection)(true)(meta)(t),
+                );
+                if (union.objects.length > 1)
+                    union.union_index = collection.getUnionIndex(union);
+                return union;
+            })();
+        }
+        normals.forEach((t) =>
+            iterate_metadata(p)(options)(collection)(false)(meta)(t),
+        );
+        return true;
+    };

package/src/functional/$any.ts

@@ -1,2 +1,2 @@
-export const $any = (val: any): any =>
-    val !== undefined ? JSON.parse(JSON.stringify(val)) : undefined;
+export const $any = (val: any): any =>
+    val !== undefined ? JSON.parse(JSON.stringify(val)) : undefined;

package/src/functional/$dictionary.ts

@@ -1,25 +1,25 @@
-import { Customizable } from "../typings/Customizable";
-
-/**
- * @internal
- */
-const blackhole: any = {};
-
-export const $dictionary = (() => {
-    const glob: {
-        __typia_custom_validator: Map<
-            `${string}`,
-            Map<
-                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 ?? blackhole) as any)
-            : ((self ?? blackhole) as any);
-    return (glob.__typia_custom_validator ??= new Map());
-})();
+import { Customizable } from "../typings/Customizable";
+
+/**
+ * @internal
+ */
+const blackhole: any = {};
+
+export const $dictionary = (() => {
+    const glob: {
+        __typia_custom_validator: Map<
+            `${string}`,
+            Map<
+                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 ?? blackhole) as any)
+            : ((self ?? blackhole) 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,2 +1,2 @@
-export const $is_between = (value: number, minimum: number, maximum: number) =>
-    minimum <= value && value <= maximum;
+export const $is_between = (value: number, minimum: number, maximum: number) =>
+    minimum <= value && value <= maximum;

package/src/functional/$is_custom.ts

@@ -1,14 +1,14 @@
-import { Customizable } from "../typings/Customizable";
-
-import { $dictionary } from "./$dictionary";
-
-export const $is_custom = <Type extends keyof Customizable>(
-    name: string,
-    type: Type,
-    text: string,
-    value: Customizable[Type],
-): boolean => {
-    const validator = $dictionary.get(name)?.get(type);
-    if (validator === undefined) return true;
-    return validator(text)(value);
-};
+import { Customizable } from "../typings/Customizable";
+
+import { $dictionary } from "./$dictionary";
+
+export const $is_custom = <Type extends keyof Customizable>(
+    name: string,
+    type: Type,
+    text: string,
+    value: Customizable[Type],
+): boolean => {
+    const validator = $dictionary.get(name)?.get(type);
+    if (validator === undefined) return true;
+    return validator(text)(value);
+};

package/src/functional/$is_date.ts

@@ -1,3 +1,3 @@
-export const $is_date = (value: string): boolean => REGEX.test(value);
-
-const REGEX = /^(\d{4})-(\d{2})-(\d{2})$/;
+export const $is_date = (value: string): boolean => REGEX.test(value);
+
+const REGEX = /^(\d{4})-(\d{2})-(\d{2})$/;

package/src/functional/$is_datetime.ts

@@ -1,2 +1,2 @@
-export const $is_datetime = (value: string): boolean =>
-    !isNaN(new Date(value).getTime());
+export const $is_datetime = (value: string): boolean =>
+    !isNaN(new Date(value).getTime());

package/src/functional/$is_email.ts

@@ -1,4 +1,4 @@
-export const $is_email = (str: string): boolean => REGEX.test(str);
-
-const REGEX =
-    /^(([^<>()[\]\.,;:\s@\"]+(\.[^<>()[\]\.,;:\s@\"]+)*)|(\".+\"))@(([^<>()[\]\.,;:\s@\"]+\.)+[^<>()[\]\.,;:\s@\"]{2,})$/i;
+export const $is_email = (str: string): boolean => REGEX.test(str);
+
+const REGEX =
+    /^(([^<>()[\]\.,;:\s@\"]+(\.[^<>()[\]\.,;:\s@\"]+)*)|(\".+\"))@(([^<>()[\]\.,;:\s@\"]+\.)+[^<>()[\]\.,;:\s@\"]{2,})$/i;

package/src/functional/$is_ipv4.ts

@@ -1,4 +1,4 @@
-export const $is_ipv4 = (str: string): boolean => REGEX.test(str);
-
-const REGEX =
-    /^(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
+export const $is_ipv4 = (str: string): boolean => REGEX.test(str);
+
+const REGEX =
+    /^(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;

package/src/functional/$is_ipv6.ts

@@ -1,4 +1,4 @@
-export const $is_ipv6 = (str: string): boolean => REGEX.test(str);
-
-const REGEX =
-    /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/;
+export const $is_ipv6 = (str: string): boolean => REGEX.test(str);
+
+const REGEX =
+    /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/;

package/src/functional/$is_url.ts

@@ -1,4 +1,4 @@
-export const $is_url = (str: string): boolean => REGEX.test(str);
-
-const REGEX =
-    /^[a-zA-Z0-9]+:\/\/(?:www.)?[-a-zA-Z0-9@:%._+~#=]{1,256}.[a-zA-Z0-9()]{1,6}\b(?:[-a-zA-Z0-9()@:%_+.~#?&/=]*)$/;
+export const $is_url = (str: string): boolean => REGEX.test(str);
+
+const REGEX =
+    /^[a-zA-Z0-9]+:\/\/(?:www.)?[-a-zA-Z0-9@:%._+~#=]{1,256}.[a-zA-Z0-9()]{1,6}\b(?:[-a-zA-Z0-9()@:%_+.~#?&/=]*)$/;

package/src/functional/$is_uuid.ts

@@ -1,4 +1,4 @@
-export const $is_uuid = (str: string): boolean => REGEX.test(str);
-
-const REGEX =
-    /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000)$/i;
+export const $is_uuid = (str: string): boolean => REGEX.test(str);
+
+const REGEX =
+    /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000)$/i;

package/src/functional/$join.ts

@@ -1,46 +1,46 @@
-export const $join = (str: string): string =>
-    variable(str) ? `.${str}` : `[${JSON.stringify(str)}]`;
-
-const variable = (str: string): boolean =>
-    reserved(str) === false && /^[a-zA-Z_$][a-zA-Z_$0-9]*$/g.test(str);
-
-const reserved = (str: string): boolean => RESERVED.has(str);
-
-const RESERVED: Set<string> = new Set([
-    "break",
-    "case",
-    "catch",
-    "class",
-    "const",
-    "continue",
-    "debugger",
-    "default",
-    "delete",
-    "do",
-    "else",
-    "enum",
-    "export",
-    "extends",
-    "false",
-    "finally",
-    "for",
-    "function",
-    "if",
-    "import",
-    "in",
-    "instanceof",
-    "new",
-    "null",
-    "return",
-    "super",
-    "switch",
-    "this",
-    "throw",
-    "true",
-    "try",
-    "typeof",
-    "var",
-    "void",
-    "while",
-    "with",
-]);
+export const $join = (str: string): string =>
+    variable(str) ? `.${str}` : `[${JSON.stringify(str)}]`;
+
+const variable = (str: string): boolean =>
+    reserved(str) === false && /^[a-zA-Z_$][a-zA-Z_$0-9]*$/g.test(str);
+
+const reserved = (str: string): boolean => RESERVED.has(str);
+
+const RESERVED: Set<string> = new Set([
+    "break",
+    "case",
+    "catch",
+    "class",
+    "const",
+    "continue",
+    "debugger",
+    "default",
+    "delete",
+    "do",
+    "else",
+    "enum",
+    "export",
+    "extends",
+    "false",
+    "finally",
+    "for",
+    "function",
+    "if",
+    "import",
+    "in",
+    "instanceof",
+    "new",
+    "null",
+    "return",
+    "super",
+    "switch",
+    "this",
+    "throw",
+    "true",
+    "try",
+    "typeof",
+    "var",
+    "void",
+    "while",
+    "with",
+]);