typia 3.6.10 → 3.7.0-dev.20230331

package/src/functional/$is_custom.ts

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

package/src/functional/$is_date.ts

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

package/src/functional/$is_datetime.ts

@@ -1,3 +1,3 @@
-export function $is_datetime(value: string): boolean {
-    return !isNaN(new Date(value).getTime());
-}
+export function $is_datetime(value: string): boolean {
+    return !isNaN(new Date(value).getTime());
+}

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}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000)$/i;
+export function $is_uuid(str: string): boolean {
+    return 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,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",
+]);

package/src/functional/$number.ts

@@ -1,12 +1,12 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-export function $number(value: number): number {
-    if (isFinite(value) === false)
-        throw new TypeGuardError({
-            method: "typia.stringify",
-            expected: "number",
-            value,
-            message: "Error on typia.stringify(): infinite or not a number.",
-        });
-    return value;
-}
+import { TypeGuardError } from "../TypeGuardError";
+
+export function $number(value: number): number {
+    if (isFinite(value) === false)
+        throw new TypeGuardError({
+            method: "typia.stringify",
+            expected: "number",
+            value,
+            message: "Error on typia.stringify(): infinite or not a number.",
+        });
+    return value;
+}

package/src/functional/$report.ts

@@ -1,15 +1,15 @@
-import { IValidation } from "../IValidation";
-
-export const $report = (array: IValidation.IError[]) => {
-    const reportable = (path: string): boolean => {
-        if (array.length === 0) return true;
-        const last: string = array[array.length - 1]!.path;
-        return (
-            path.length > last.length || last.substring(0, path.length) !== path
-        );
-    };
-    return (exceptable: boolean, error: IValidation.IError): false => {
-        if (exceptable && reportable(error.path)) array.push(error);
-        return false;
-    };
-};
+import { IValidation } from "../IValidation";
+
+export const $report = (array: IValidation.IError[]) => {
+    const reportable = (path: string): boolean => {
+        if (array.length === 0) return true;
+        const last: string = array[array.length - 1]!.path;
+        return (
+            path.length > last.length || last.substring(0, path.length) !== path
+        );
+    };
+    return (exceptable: boolean, error: IValidation.IError): false => {
+        if (exceptable && reportable(error.path)) array.push(error);
+        return false;
+    };
+};

package/src/functional/$rest.ts

@@ -1,3 +1,3 @@
-export function $rest(str: string): string {
-    return str.length === 2 ? "" : "," + str.substring(1, str.length - 1);
-}
+export function $rest(str: string): string {
+    return str.length === 2 ? "" : "," + str.substring(1, str.length - 1);
+}

package/src/functional/$string.ts

@@ -1,37 +1,37 @@
-/**
- * @internal
- */
-export function $string(str: string): string {
-    if (str.length > 41) return JSON.stringify(str);
-
-    const length = str.length;
-    let result = "";
-    let last = 0;
-    let found = false;
-    let surrogateFound = false;
-    let point = 255;
-
-    // eslint-disable-next-line
-    for (let i = 0; i < length && point >= 32; i++) {
-        point = str.charCodeAt(i);
-        if (0xd800 <= point && point <= 0xdfff) {
-            // The current character is a surrogate.
-            surrogateFound = true;
-            break;
-        }
-        if (point === 34 || point === 92) {
-            result += str.slice(last, i) + "\\";
-            last = i;
-            found = true;
-        }
-    }
-
-    if (!found) {
-        result = str;
-    } else {
-        result += str.slice(last);
-    }
-    return point < 32 || surrogateFound === true
-        ? JSON.stringify(str)
-        : `"${result}"`;
-}
+/**
+ * @internal
+ */
+export function $string(str: string): string {
+    if (str.length > 41) return JSON.stringify(str);
+
+    const length = str.length;
+    let result = "";
+    let last = 0;
+    let found = false;
+    let surrogateFound = false;
+    let point = 255;
+
+    // eslint-disable-next-line
+    for (let i = 0; i < length && point >= 32; i++) {
+        point = str.charCodeAt(i);
+        if (0xd800 <= point && point <= 0xdfff) {
+            // The current character is a surrogate.
+            surrogateFound = true;
+            break;
+        }
+        if (point === 34 || point === 92) {
+            result += str.slice(last, i) + "\\";
+            last = i;
+            found = true;
+        }
+    }
+
+    if (!found) {
+        result = str;
+    } else {
+        result += str.slice(last);
+    }
+    return point < 32 || surrogateFound === true
+        ? JSON.stringify(str)
+        : `"${result}"`;
+}

package/src/functional/$tail.ts

@@ -1,6 +1,6 @@
-/**
- * @internal
- */
-export function $tail(str: string): string {
-    return str[str.length - 1] === "," ? str.substring(0, str.length - 1) : str;
-}
+/**
+ * @internal
+ */
+export function $tail(str: string): string {
+    return str[str.length - 1] === "," ? str.substring(0, str.length - 1) : str;
+}

package/src/functional/Namespace.ts

@@ -1,125 +1,127 @@
-import { RandomGenerator } from "../utils/RandomGenerator";
-
-import { IValidation } from "../IValidation";
-import { TypeGuardError } from "../TypeGuardError";
-import { $any } from "./$any";
-import { $every } from "./$every";
-import { $guard } from "./$guard";
-import { $is_between } from "./$is_between";
-import { $is_date } from "./$is_date";
-import { $is_datetime } from "./$is_datetime";
-import { $is_email } from "./$is_email";
-import { $is_ipv4 } from "./$is_ipv4";
-import { $is_ipv6 } from "./$is_ipv6";
-import { $is_url } from "./$is_url";
-import { $is_uuid } from "./$is_uuid";
-import { $join } from "./$join";
-import { $number } from "./$number";
-import { $report } from "./$report";
-import { $rest } from "./$rest";
-import { $string } from "./$string";
-import { $tail } from "./$tail";
-
-/**
- * @internal
- */
-export namespace Namespace {
-    export const is = () => ({
-        is_uuid: $is_uuid,
-        is_email: $is_email,
-        is_url: $is_url,
-        is_ipv4: $is_ipv4,
-        is_ipv6: $is_ipv6,
-        is_between: $is_between,
-        is_date: $is_date,
-        is_datetime: $is_datetime,
-    });
-
-    export const assert = (method: string) => ({
-        ...is(),
-        join: $join,
-        every: $every,
-        guard: $guard(`typia.${method}`),
-        predicate: (
-            matched: boolean,
-            exceptionable: boolean,
-            closure: () => Omit<TypeGuardError.IProps, "method">,
-        ): boolean => {
-            if (matched === false && exceptionable === true)
-                throw new TypeGuardError({
-                    ...closure(),
-                    method: `typia.${method}`,
-                });
-            return matched;
-        },
-    });
-
-    export const validate = () => ({
-        ...is(),
-        join: $join,
-        report: $report,
-        predicate:
-            (res: IValidation) =>
-            (
-                matched: boolean,
-                exceptionable: boolean,
-                closure: () => IValidation.IError,
-            ) => {
-                // CHECK FAILURE
-                if (matched === false && exceptionable === true)
-                    (() => {
-                        res.success &&= false;
-                        const errorList = (res as IValidation.IFailure).errors;
-
-                        // TRACE ERROR
-                        const error = closure();
-                        if (errorList.length) {
-                            const last = errorList[errorList.length - 1]!.path;
-                            if (
-                                last.length >= error.path.length &&
-                                last.substring(0, error.path.length) ===
-                                    error.path
-                            )
-                                return;
-                        }
-                        errorList.push(error);
-                        return;
-                    })();
-                return matched;
-            },
-    });
-
-    export const stringify = (method: string) => ({
-        ...is(),
-        number: $number,
-        string: $string,
-        tail: $tail,
-        rest: $rest,
-        throws: $throws(method),
-    });
-
-    export const clone = (method: string) => ({
-        ...is(),
-        throws: $throws(method),
-        any: $any,
-    });
-
-    export const prune = (method: string) => ({
-        ...is(),
-        throws: $throws(method),
-    });
-
-    export const random = () => ({
-        generator: RandomGenerator,
-        pick: RandomGenerator.pick,
-    });
-
-    const $throws =
-        (method: string) =>
-        (props: Pick<TypeGuardError.IProps, "expected" | "value">) => {
-            throw new TypeGuardError({
-                ...props,
-                method: `typia.${method}`,
-            });
-        };
-}
+import { RandomGenerator } from "../utils/RandomGenerator";
+
+import { IValidation } from "../IValidation";
+import { TypeGuardError } from "../TypeGuardError";
+import { $any } from "./$any";
+import { $every } from "./$every";
+import { $guard } from "./$guard";
+import { $is_between } from "./$is_between";
+import { $is_custom } from "./$is_custom";
+import { $is_date } from "./$is_date";
+import { $is_datetime } from "./$is_datetime";
+import { $is_email } from "./$is_email";
+import { $is_ipv4 } from "./$is_ipv4";
+import { $is_ipv6 } from "./$is_ipv6";
+import { $is_url } from "./$is_url";
+import { $is_uuid } from "./$is_uuid";
+import { $join } from "./$join";
+import { $number } from "./$number";
+import { $report } from "./$report";
+import { $rest } from "./$rest";
+import { $string } from "./$string";
+import { $tail } from "./$tail";
+
+/**
+ * @internal
+ */
+export namespace Namespace {
+    export const is = () => ({
+        is_uuid: $is_uuid,
+        is_email: $is_email,
+        is_url: $is_url,
+        is_ipv4: $is_ipv4,
+        is_ipv6: $is_ipv6,
+        is_between: $is_between,
+        is_date: $is_date,
+        is_datetime: $is_datetime,
+        is_custom: $is_custom,
+    });
+
+    export const assert = (method: string) => ({
+        ...is(),
+        join: $join,
+        every: $every,
+        guard: $guard(`typia.${method}`),
+        predicate: (
+            matched: boolean,
+            exceptionable: boolean,
+            closure: () => Omit<TypeGuardError.IProps, "method">,
+        ): boolean => {
+            if (matched === false && exceptionable === true)
+                throw new TypeGuardError({
+                    ...closure(),
+                    method: `typia.${method}`,
+                });
+            return matched;
+        },
+    });
+
+    export const validate = () => ({
+        ...is(),
+        join: $join,
+        report: $report,
+        predicate:
+            (res: IValidation) =>
+            (
+                matched: boolean,
+                exceptionable: boolean,
+                closure: () => IValidation.IError,
+            ) => {
+                // CHECK FAILURE
+                if (matched === false && exceptionable === true)
+                    (() => {
+                        res.success &&= false;
+                        const errorList = (res as IValidation.IFailure).errors;
+
+                        // TRACE ERROR
+                        const error = closure();
+                        if (errorList.length) {
+                            const last = errorList[errorList.length - 1]!.path;
+                            if (
+                                last.length >= error.path.length &&
+                                last.substring(0, error.path.length) ===
+                                    error.path
+                            )
+                                return;
+                        }
+                        errorList.push(error);
+                        return;
+                    })();
+                return matched;
+            },
+    });
+
+    export const stringify = (method: string) => ({
+        ...is(),
+        number: $number,
+        string: $string,
+        tail: $tail,
+        rest: $rest,
+        throws: $throws(method),
+    });
+
+    export const clone = (method: string) => ({
+        ...is(),
+        throws: $throws(method),
+        any: $any,
+    });
+
+    export const prune = (method: string) => ({
+        ...is(),
+        throws: $throws(method),
+    });
+
+    export const random = () => ({
+        generator: RandomGenerator,
+        pick: RandomGenerator.pick,
+    });
+
+    const $throws =
+        (method: string) =>
+        (props: Pick<TypeGuardError.IProps, "expected" | "value">) => {
+            throw new TypeGuardError({
+                ...props,
+                method: `typia.${method}`,
+            });
+        };
+}

package/src/index.ts

@@ -1,4 +1,4 @@
-import * as typia from "./module";
-
-export default typia;
-export * from "./module";
+import * as typia from "./module";
+
+export default typia;
+export * from "./module";

package/src/metadata/IJsDocTagInfo.ts

@@ -1,10 +1,10 @@
-export interface IJsDocTagInfo {
-    name: string;
-    text?: IJsDocTagInfo.IText[];
-}
-export namespace IJsDocTagInfo {
-    export interface IText {
-        text: string;
-        kind: string;
-    }
-}
+export interface IJsDocTagInfo {
+    name: string;
+    text?: IJsDocTagInfo.IText[];
+}
+export namespace IJsDocTagInfo {
+    export interface IText {
+        text: string;
+        kind: string;
+    }
+}