typia 3.5.0-dev.20221222 → 3.5.0-dev.20230124

package/src/factories/TypeFactory.ts

@@ -1,101 +1,101 @@
-import ts from "typescript";
-
-export namespace TypeFactory {
-    export function resolve(
-        checker: ts.TypeChecker,
-        type: ts.Type,
-    ): ts.Type | null {
-        return getReturnType(checker, type, "toJSON");
-    }
-
-    export function isFunction(type: ts.Type): boolean {
-        return getFunction(type) !== null;
-    }
-    function getFunction(type: ts.Type) {
-        const node = type.symbol?.declarations?.[0];
-        if (node === undefined) return null;
-
-        return ts.isFunctionLike(node)
-            ? node
-            : ts.isPropertyAssignment(node) || ts.isPropertyDeclaration(node)
-            ? ts.isFunctionLike(node.initializer)
-                ? node.initializer
-                : null
-            : null;
-    }
-
-    export function getReturnType(
-        checker: ts.TypeChecker,
-        type: ts.Type,
-        name: string,
-    ): ts.Type | null {
-        // FIND TO-JSON METHOD
-        const symbol: ts.Symbol | undefined = type.getProperty(name);
-        if (!symbol) return null;
-        else if (!symbol.valueDeclaration) return null;
-
-        // GET FUNCTION DECLARATION
-        const functor: ts.Type = checker.getTypeOfSymbolAtLocation(
-            symbol,
-            symbol.valueDeclaration,
-        );
-
-        // RETURNS THE RETURN-TYPE
-        const signature: ts.Signature | undefined = checker.getSignaturesOfType(
-            functor,
-            ts.SignatureKind.Call,
-        )[0];
-        return signature ? signature.getReturnType() : null;
-    }
-
-    export function getFullName(
-        checker: ts.TypeChecker,
-        type: ts.Type,
-        symbol?: ts.Symbol,
-    ): string {
-        // PRIMITIVE
-        symbol ||= type.aliasSymbol || type.getSymbol();
-        if (symbol === undefined) return checker.typeToString(type);
-
-        // UNION OR INTERSECT
-        if (type.aliasSymbol === undefined && type.isUnionOrIntersection()) {
-            const joiner: string = type.isIntersection() ? " & " : " | ";
-            return type.types
-                .map((child) => getFullName(checker, child))
-                .join(joiner);
-        }
-
-        //----
-        // SPECIALIZATION
-        //----
-        const name: string = get_name(symbol);
-
-        // CHECK GENERIC
-        const generic: readonly ts.Type[] = type.aliasSymbol
-            ? type.aliasTypeArguments || []
-            : checker.getTypeArguments(type as ts.TypeReference);
-        return generic.length
-            ? name === "Promise"
-                ? getFullName(checker, generic[0]!)
-                : `${name}<${generic
-                      .map((child) => getFullName(checker, child))
-                      .join(", ")}>`
-            : name;
-    }
-
-    function explore_name(name: string, decl: ts.Node): string {
-        return ts.isModuleBlock(decl)
-            ? explore_name(
-                  `${decl.parent.name.getText()}.${name}`,
-                  decl.parent.parent,
-              )
-            : name;
-    }
-
-    function get_name(symbol: ts.Symbol): string {
-        const parent = symbol.getDeclarations()?.[0]?.parent;
-        return parent
-            ? explore_name(symbol.escapedName.toString(), parent)
-            : "__type";
-    }
-}
+import ts from "typescript";
+
+export namespace TypeFactory {
+    export function resolve(
+        checker: ts.TypeChecker,
+        type: ts.Type,
+    ): ts.Type | null {
+        return getReturnType(checker, type, "toJSON");
+    }
+
+    export function isFunction(type: ts.Type): boolean {
+        return getFunction(type) !== null;
+    }
+    function getFunction(type: ts.Type) {
+        const node = type.symbol?.declarations?.[0];
+        if (node === undefined) return null;
+
+        return ts.isFunctionLike(node)
+            ? node
+            : ts.isPropertyAssignment(node) || ts.isPropertyDeclaration(node)
+            ? ts.isFunctionLike(node.initializer)
+                ? node.initializer
+                : null
+            : null;
+    }
+
+    export function getReturnType(
+        checker: ts.TypeChecker,
+        type: ts.Type,
+        name: string,
+    ): ts.Type | null {
+        // FIND TO-JSON METHOD
+        const symbol: ts.Symbol | undefined = type.getProperty(name);
+        if (!symbol) return null;
+        else if (!symbol.valueDeclaration) return null;
+
+        // GET FUNCTION DECLARATION
+        const functor: ts.Type = checker.getTypeOfSymbolAtLocation(
+            symbol,
+            symbol.valueDeclaration,
+        );
+
+        // RETURNS THE RETURN-TYPE
+        const signature: ts.Signature | undefined = checker.getSignaturesOfType(
+            functor,
+            ts.SignatureKind.Call,
+        )[0];
+        return signature ? signature.getReturnType() : null;
+    }
+
+    export function getFullName(
+        checker: ts.TypeChecker,
+        type: ts.Type,
+        symbol?: ts.Symbol,
+    ): string {
+        // PRIMITIVE
+        symbol ||= type.aliasSymbol || type.getSymbol();
+        if (symbol === undefined) return checker.typeToString(type);
+
+        // UNION OR INTERSECT
+        if (type.aliasSymbol === undefined && type.isUnionOrIntersection()) {
+            const joiner: string = type.isIntersection() ? " & " : " | ";
+            return type.types
+                .map((child) => getFullName(checker, child))
+                .join(joiner);
+        }
+
+        //----
+        // SPECIALIZATION
+        //----
+        const name: string = get_name(symbol);
+
+        // CHECK GENERIC
+        const generic: readonly ts.Type[] = type.aliasSymbol
+            ? type.aliasTypeArguments || []
+            : checker.getTypeArguments(type as ts.TypeReference);
+        return generic.length
+            ? name === "Promise"
+                ? getFullName(checker, generic[0]!)
+                : `${name}<${generic
+                      .map((child) => getFullName(checker, child))
+                      .join(", ")}>`
+            : name;
+    }
+
+    function explore_name(name: string, decl: ts.Node): string {
+        return ts.isModuleBlock(decl)
+            ? explore_name(
+                  `${decl.parent.name.getText()}.${name}`,
+                  decl.parent.parent,
+              )
+            : name;
+    }
+
+    function get_name(symbol: ts.Symbol): string {
+        const parent = symbol.getDeclarations()?.[0]?.parent;
+        return parent
+            ? explore_name(symbol.escapedName.toString(), parent)
+            : "__type";
+    }
+}

package/src/factories/ValueFactory.ts

@@ -1,12 +1,12 @@
-import ts from "typescript";
-
-export namespace ValueFactory {
-    export const NULL = () => ts.factory.createNull();
-    export const UNDEFINED = () => ts.factory.createIdentifier("undefined");
-    export const BOOLEAN = (value: boolean) =>
-        value ? ts.factory.createTrue() : ts.factory.createFalse();
-    export const INPUT = (str: string = "input") =>
-        ts.factory.createIdentifier(str);
-    export const TYPEOF = (input: ts.Expression) =>
-        ts.factory.createTypeOfExpression(input);
-}
+import ts from "typescript";
+
+export namespace ValueFactory {
+    export const NULL = () => ts.factory.createNull();
+    export const UNDEFINED = () => ts.factory.createIdentifier("undefined");
+    export const BOOLEAN = (value: boolean) =>
+        value ? ts.factory.createTrue() : ts.factory.createFalse();
+    export const INPUT = (str: string = "input") =>
+        ts.factory.createIdentifier(str);
+    export const TYPEOF = (input: ts.Expression) =>
+        ts.factory.createTypeOfExpression(input);
+}

package/src/factories/internal/protocols/ProtocolMetadataUtil.ts

@@ -78,4 +78,24 @@ export namespace ProtocolMetadataUtil {
             jsDocTags: [],
         });
     }
+
+    export function array(meta: Metadata): Metadata {
+        return Metadata.create({
+            any: false,
+            required: true,
+            nullable: false,
+            functional: false,
+            resolved: null,
+            atomics: [],
+            constants: [],
+            templates: [],
+            rest: null,
+            arrays: [meta],
+            tuples: [],
+            objects: [],
+            natives: [],
+            sets: [],
+            maps: [],
+        });
+    }
 }

package/src/factories/internal/protocols/iterate_protocol_map.ts

@@ -1,18 +1,23 @@
 import { Metadata } from "../../../metadata/Metadata";
 import { MetadataObject } from "../../../metadata/MetadataObject";
 
+import { IProtocolMap } from "../../../messages/IProtocolMap";
 import { IProtocolMessage } from "../../../messages/IProtocolMessage";
 import { ProtocolMetadataUtil } from "./ProtocolMetadataUtil";
 import { emplace_protocol_object } from "./emplace_protocol_object";
 import { iterate_protocol_atomic } from "./iterate_protocol_atomic";
 import { iterate_protocol_constant } from "./iterate_protocol_constant";
+import { iterate_protocol_metadata } from "./iterate_protocol_metadata";
 
 export const iterate_protocol_map =
     (container: "Object" | "Map") =>
     (dict: Map<string, IProtocolMessage>) =>
     (key: Metadata) =>
-    (value: Metadata) =>
-        `map<${getKeyName(key)}, ${getValueName(container)(dict)(value)}>`;
+    (value: Metadata): IProtocolMap => ({
+        type: "map",
+        key: getKeyName(key),
+        value: getValueName(container)(dict)(value),
+    });
 
 const getKeyName = (meta: Metadata) => {
     for (const atomic of meta.atomics)
@@ -26,7 +31,8 @@ const getValueName =
     (container: "Object" | "Map") =>
     (dict: Map<string, IProtocolMessage>) =>
     (meta: Metadata) => {
-        if (ProtocolMetadataUtil.standalone(meta)) return meta.getName();
+        if (ProtocolMetadataUtil.standalone(meta))
+            return iterate_protocol_metadata(dict)(meta)([]).oneOf[0]!.type;
 
         const obj: MetadataObject = ProtocolMetadataUtil.object(
             `${container}.Value<${meta.getName()}>`,

package/src/factories/internal/protocols/iterate_protocol_metadata.ts

@@ -1,6 +1,7 @@
 import { IMetadataTag } from "../../../metadata/IMetadataTag";
 import { Metadata } from "../../../metadata/Metadata";
 
+import { IProtocolMap } from "../../../messages/IProtocolMap";
 import { IProtocolMessage } from "../../../messages/IProtocolMessage";
 import { IProtocolProperty } from "../../../messages/IProtocolProperty";
 import { iterate_protocol_atomic } from "./iterate_protocol_atomic";
@@ -18,7 +19,7 @@ export const iterate_protocol_metadata =
         const required: boolean = meta.required && !meta.nullable;
         const oneOf: IProtocolProperty.IOneOf[] = [];
 
-        const add = (type: string) => {
+        const add = (type: string | IProtocolMap) => {
             if (oneOf.some((one) => one.type === type)) return;
             oneOf.push({
                 type,
@@ -31,7 +32,11 @@ export const iterate_protocol_metadata =
                 meta.arrays.length === 1
                     ? (["Array", meta.arrays[0]!] as const)
                     : (["Set", meta.sets[0]!] as const);
-            add(iterate_protocol_repeated(container)(true)(dict)(child)(tags));
+            add(
+                iterate_protocol_repeated(container)(true, true)(dict)(child)(
+                    tags,
+                ),
+            );
             return {
                 required,
                 oneOf,
@@ -61,9 +66,17 @@ export const iterate_protocol_metadata =
         for (const tuple of meta.tuples)
             add(iterate_protocol_tuple(dict)(tuple));
         for (const array of meta.arrays)
-            add(iterate_protocol_repeated("Array")(false)(dict)(array)(tags));
+            add(
+                iterate_protocol_repeated("Array")(false, meta.bucket() === 1)(
+                    dict,
+                )(array)(tags),
+            );
         for (const set of meta.sets)
-            add(iterate_protocol_repeated("Set")(false)(dict)(set)(tags));
+            add(
+                iterate_protocol_repeated("Set")(false, meta.bucket() === 1)(
+                    dict,
+                )(set)(tags),
+            );
         for (const map of meta.maps)
             add(iterate_protocol_map("Map")(dict)(map.key)(map.value));
 

package/src/factories/internal/protocols/iterate_protocol_repeated.ts

@@ -2,24 +2,33 @@ import { IMetadataTag } from "../../../metadata/IMetadataTag";
 import { Metadata } from "../../../metadata/Metadata";
 import { MetadataObject } from "../../../metadata/MetadataObject";
 
+import { IProtocolMap } from "../../../messages/IProtocolMap";
 import { IProtocolMessage } from "../../../messages/IProtocolMessage";
 import { ProtocolMetadataUtil } from "./ProtocolMetadataUtil";
 import { emplace_protocol_object } from "./emplace_protocol_object";
+import { iterate_protocol_metadata } from "./iterate_protocol_metadata";
 
 export const iterate_protocol_repeated =
     (container: "Array" | "Set") =>
-    (sole: boolean) =>
+    (sole: boolean, bucket: boolean) =>
     (dict: Map<string, IProtocolMessage>) =>
     (meta: Metadata) =>
-    (tags: IMetadataTag[]): string => {
+    (tags: IMetadataTag[]): string | IProtocolMap => {
         sole &&= ProtocolMetadataUtil.standalone(meta);
-        if (sole === true) return meta.getName();
+        if (sole === true)
+            return iterate_protocol_metadata(dict)(meta)(tags).oneOf[0]!.type;
 
         const obj: MetadataObject = ProtocolMetadataUtil.object(
-            `${container}.Element<${meta.getName()}>`,
+            `${container}.${bucket ? "Element" : "Wrapper"}<${meta.getName()}>`,
             dict.size,
         );
-        obj.properties.push(ProtocolMetadataUtil.property("value", meta, tags));
+        obj.properties.push(
+            ProtocolMetadataUtil.property(
+                "value",
+                bucket ? meta : ProtocolMetadataUtil.array(meta),
+                tags,
+            ),
+        );
         emplace_protocol_object(dict)(obj);
         return obj.name;
     };

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_email.ts

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

package/src/functional/$is_ipv4.ts

@@ -1,5 +1,5 @@
-export function $is_ipv4(str: string): boolean {
-    return 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 function $is_ipv4(str: string): boolean {
+    return 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,5 +1,5 @@
-export function $is_ipv6(str: string): boolean {
-    return 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 function $is_ipv6(str: string): boolean {
+    return 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,5 +1,5 @@
-export function $is_url(str: string): boolean {
-    return 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 function $is_url(str: string): boolean {
+    return 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,5 +1,5 @@
-export function $is_uuid(str: string): boolean {
-    return REGEX.test(str);
-}
-const REGEX =
-    /[0-9A-F]{8}-[0-9A-F]{4}-[4][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i;
+export function $is_uuid(str: string): boolean {
+    return REGEX.test(str);
+}
+const REGEX =
+    /[0-9A-F]{8}-[0-9A-F]{4}-[4][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i;

package/src/functional/$join.ts

@@ -1,50 +1,50 @@
-export function $join(str: string): string {
-    return variable(str) ? `.${str}` : `[${JSON.stringify(str)}]`;
-}
-
-function variable(str: string): boolean {
-    return reserved(str) === false && /^[a-zA-Z_$][a-zA-Z_$0-9]*$/g.test(str);
-}
-
-function reserved(str: string): boolean {
-    return 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 function $join(str: string): string {
+    return variable(str) ? `.${str}` : `[${JSON.stringify(str)}]`;
+}
+
+function variable(str: string): boolean {
+    return reserved(str) === false && /^[a-zA-Z_$][a-zA-Z_$0-9]*$/g.test(str);
+}
+
+function reserved(str: string): boolean {
+    return 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",
+]);