typia 5.0.4 → 5.0.5-dev.20230921

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/$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",
+]);

package/src/functional/$number.ts

@@ -1,13 +1,13 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-export const $number = (value: number): number => {
-    if (isFinite(value) === false)
-        throw new TypeGuardError({
-            method: "typia.json.stringify",
-            expected: "number",
-            value,
-            message:
-                "Error on typia.json.stringify(): infinite or not a number.",
-        });
-    return value;
-};
+import { TypeGuardError } from "../TypeGuardError";
+
+export const $number = (value: number): number => {
+    if (isFinite(value) === false)
+        throw new TypeGuardError({
+            method: "typia.json.stringify",
+            expected: "number",
+            value,
+            message:
+                "Error on typia.json.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 const $rest = (str: string): string => {
-    return str.length === 2 ? "" : "," + str.substring(1, str.length - 1);
-};
+export const $rest = (str: string): string => {
+    return str.length === 2 ? "" : "," + str.substring(1, str.length - 1);
+};

package/src/functional/$string.ts

@@ -1,50 +1,50 @@
-/**
- * In the past, name of `typia` was `typescript-json`, and supported
- * JSON serialization by wrapping `fast-json-stringify. `typescript-json` was
- * a helper library of `fast-json-stringify`, which can skip manual JSON schema
- * definition just by putting pure TypeScript type.
- *
- * This `$string` function is a part of `fast-json-stringify` at that time, and
- * still being used in `typia` for the string serialization.
- *
- * @internal
- * @reference https://github.com/fastify/fast-json-stringify/blob/master/lib/serializer.js
- * @blog https://dev.to/samchon/good-bye-typescript-is-ancestor-of-typia-20000x-faster-validator-49fi
- */
-export const $string = (str: string): string => {
-    if (STR_ESCAPE.test(str) === false) return `"${str}"`;
-
-    const length: number = str.length;
-    if (length > 41) return JSON.stringify(str);
-
-    let result = "";
-    let last = -1;
-    let point = 255;
-
-    // eslint-disable-next-line
-    for (let i = 0; i < length; ++i) {
-        point = str.charCodeAt(i);
-        if (point < 32) {
-            return JSON.stringify(str);
-        }
-        if (point >= 0xd800 && point <= 0xdfff) {
-            // The current character is a surrogate.
-            return JSON.stringify(str);
-        }
-        if (
-            point === 0x22 || // '"'
-            point === 0x5c // '\'
-        ) {
-            last === -1 && (last = 0);
-            result += str.slice(last, i) + "\\";
-            last = i;
-        }
-    }
-
-    return (
-        (last === -1 && '"' + str + '"') || '"' + result + str.slice(last) + '"'
-    );
-};
-
-const STR_ESCAPE =
-    /[\u0000-\u001f\u0022\u005c\ud800-\udfff]|[\ud800-\udbff](?![\udc00-\udfff])|(?:[^\ud800-\udbff]|^)[\udc00-\udfff]/;
+/**
+ * In the past, name of `typia` was `typescript-json`, and supported
+ * JSON serialization by wrapping `fast-json-stringify. `typescript-json` was
+ * a helper library of `fast-json-stringify`, which can skip manual JSON schema
+ * definition just by putting pure TypeScript type.
+ *
+ * This `$string` function is a part of `fast-json-stringify` at that time, and
+ * still being used in `typia` for the string serialization.
+ *
+ * @internal
+ * @reference https://github.com/fastify/fast-json-stringify/blob/master/lib/serializer.js
+ * @blog https://dev.to/samchon/good-bye-typescript-is-ancestor-of-typia-20000x-faster-validator-49fi
+ */
+export const $string = (str: string): string => {
+    if (STR_ESCAPE.test(str) === false) return `"${str}"`;
+
+    const length: number = str.length;
+    if (length > 41) return JSON.stringify(str);
+
+    let result = "";
+    let last = -1;
+    let point = 255;
+
+    // eslint-disable-next-line
+    for (let i = 0; i < length; ++i) {
+        point = str.charCodeAt(i);
+        if (point < 32) {
+            return JSON.stringify(str);
+        }
+        if (point >= 0xd800 && point <= 0xdfff) {
+            // The current character is a surrogate.
+            return JSON.stringify(str);
+        }
+        if (
+            point === 0x22 || // '"'
+            point === 0x5c // '\'
+        ) {
+            last === -1 && (last = 0);
+            result += str.slice(last, i) + "\\";
+            last = i;
+        }
+    }
+
+    return (
+        (last === -1 && '"' + str + '"') || '"' + result + str.slice(last) + '"'
+    );
+};
+
+const STR_ESCAPE =
+    /[\u0000-\u001f\u0022\u005c\ud800-\udfff]|[\ud800-\udbff](?![\udc00-\udfff])|(?:[^\ud800-\udbff]|^)[\udc00-\udfff]/;

package/src/functional/$strlen.ts

@@ -1,7 +1,7 @@
-export const $strlen = (s: string): number => {
-    let b: number;
-    let i: number;
-    let c: number;
-    for (b = i = 0; (c = s.charCodeAt(i++)); b += c >> 11 ? 3 : c >> 7 ? 2 : 1);
-    return b;
-};
+export const $strlen = (s: string): number => {
+    let b: number;
+    let i: number;
+    let c: number;
+    for (b = i = 0; (c = s.charCodeAt(i++)); b += c >> 11 ? 3 : c >> 7 ? 2 : 1);
+    return b;
+};

package/src/functional/$tail.ts

@@ -1,5 +1,5 @@
-/**
- * @internal
- */
-export const $tail = (str: string): string =>
-    str[str.length - 1] === "," ? str.substring(0, str.length - 1) : str;
+/**
+ * @internal
+ */
+export const $tail = (str: string): string =>
+    str[str.length - 1] === "," ? str.substring(0, str.length - 1) : str;

package/src/functional/$varint.ts

@@ -1,130 +1,130 @@
-function EncodeVarNumber(
-    dst: Uint8Array,
-    offset: number,
-    value: number,
-): number {
-    value = (value | 0) >>> 0; // 32-bit integer
-
-    while (value > 127) {
-        dst[offset++] = (value & 0b01111111) | 0b10000000;
-        value >>>= 7;
-    }
-    dst[offset++] = value;
-
-    return offset;
-}
-
-function DecodeVarNumber(
-    buf: Uint8Array,
-    offset: number,
-): [value: number, offset: number] {
-    let value = 0;
-    let shift = 0;
-
-    while (true) {
-        const byte = buf[offset++]!;
-        value |= (byte & 0b01111111) << shift;
-        if (byte < 128) {
-            break;
-        }
-        shift += 7;
-    }
-
-    return [value | 0, offset];
-}
-
-function DecodeVarBigInt(
-    buf: Uint8Array,
-    offset: number,
-): [value: bigint, offset: number] {
-    let value = BigInt(0);
-    let shift = BigInt(0);
-
-    while (true) {
-        const byte = buf[offset++]!;
-        value |= BigInt(byte & 0b01111111) << shift;
-        if (byte < 128) {
-            break;
-        }
-        shift += BigInt(7);
-    }
-
-    return [BigInt.asIntN(64, value), offset];
-}
-
-export function $varint_decode_i32(
-    buf: Uint8Array,
-    offset: number,
-): [value: number, offset: number] {
-    const [v, o] = DecodeVarNumber(buf, offset);
-    return [v, o];
-}
-
-export function $varint_decode_u32(
-    buf: Uint8Array,
-    offset: number,
-): [value: number, offset: number] {
-    const [v, o] = DecodeVarNumber(buf, offset);
-    return [v >>> 0, o];
-}
-
-export function $varint_decode_i64(
-    buf: Uint8Array,
-    offset: number,
-): [value: bigint, offset: number] {
-    const [v, o] = DecodeVarBigInt(buf, offset);
-    return [v, o];
-}
-
-export function $varint_decode_u64(
-    buf: Uint8Array,
-    offset: number,
-): [value: bigint, offset: number] {
-    const [v, o] = DecodeVarBigInt(buf, offset);
-    return [BigInt.asUintN(64, v), o];
-}
-
-function EncodeVarBigInt(
-    dst: Uint8Array,
-    offset: number,
-    value: bigint,
-): number {
-    value = BigInt.asUintN(64, value);
-
-    while (value > BigInt(127)) {
-        dst[offset++] = Number(value & BigInt(0b01111111)) | 0b10000000;
-        value >>= BigInt(7);
-    }
-    dst[offset++] = Number(value);
-
-    return offset;
-}
-
-export function $varint_encode(
-    dst: Uint8Array,
-    offset: number,
-    value: number,
-): number;
-export function $varint_encode(
-    dst: Uint8Array,
-    offset: number,
-    value: bigint,
-): number;
-
-export function $varint_encode(
-    dst: Uint8Array,
-    offset: number,
-    value: number | bigint,
-): number {
-    if (typeof value === "bigint") {
-        offset = EncodeVarBigInt(dst, offset, value);
-    } else {
-        if (value < 0) {
-            // NOTE: Protocol Buffers signed varint encoding uses two's complement of 64-bit unsigned integers.
-            offset = EncodeVarBigInt(dst, offset, BigInt(value));
-        } else {
-            offset = EncodeVarNumber(dst, offset, value);
-        }
-    }
-    return offset;
-}
+function EncodeVarNumber(
+    dst: Uint8Array,
+    offset: number,
+    value: number,
+): number {
+    value = (value | 0) >>> 0; // 32-bit integer
+
+    while (value > 127) {
+        dst[offset++] = (value & 0b01111111) | 0b10000000;
+        value >>>= 7;
+    }
+    dst[offset++] = value;
+
+    return offset;
+}
+
+function DecodeVarNumber(
+    buf: Uint8Array,
+    offset: number,
+): [value: number, offset: number] {
+    let value = 0;
+    let shift = 0;
+
+    while (true) {
+        const byte = buf[offset++]!;
+        value |= (byte & 0b01111111) << shift;
+        if (byte < 128) {
+            break;
+        }
+        shift += 7;
+    }
+
+    return [value | 0, offset];
+}
+
+function DecodeVarBigInt(
+    buf: Uint8Array,
+    offset: number,
+): [value: bigint, offset: number] {
+    let value = BigInt(0);
+    let shift = BigInt(0);
+
+    while (true) {
+        const byte = buf[offset++]!;
+        value |= BigInt(byte & 0b01111111) << shift;
+        if (byte < 128) {
+            break;
+        }
+        shift += BigInt(7);
+    }
+
+    return [BigInt.asIntN(64, value), offset];
+}
+
+export function $varint_decode_i32(
+    buf: Uint8Array,
+    offset: number,
+): [value: number, offset: number] {
+    const [v, o] = DecodeVarNumber(buf, offset);
+    return [v, o];
+}
+
+export function $varint_decode_u32(
+    buf: Uint8Array,
+    offset: number,
+): [value: number, offset: number] {
+    const [v, o] = DecodeVarNumber(buf, offset);
+    return [v >>> 0, o];
+}
+
+export function $varint_decode_i64(
+    buf: Uint8Array,
+    offset: number,
+): [value: bigint, offset: number] {
+    const [v, o] = DecodeVarBigInt(buf, offset);
+    return [v, o];
+}
+
+export function $varint_decode_u64(
+    buf: Uint8Array,
+    offset: number,
+): [value: bigint, offset: number] {
+    const [v, o] = DecodeVarBigInt(buf, offset);
+    return [BigInt.asUintN(64, v), o];
+}
+
+function EncodeVarBigInt(
+    dst: Uint8Array,
+    offset: number,
+    value: bigint,
+): number {
+    value = BigInt.asUintN(64, value);
+
+    while (value > BigInt(127)) {
+        dst[offset++] = Number(value & BigInt(0b01111111)) | 0b10000000;
+        value >>= BigInt(7);
+    }
+    dst[offset++] = Number(value);
+
+    return offset;
+}
+
+export function $varint_encode(
+    dst: Uint8Array,
+    offset: number,
+    value: number,
+): number;
+export function $varint_encode(
+    dst: Uint8Array,
+    offset: number,
+    value: bigint,
+): number;
+
+export function $varint_encode(
+    dst: Uint8Array,
+    offset: number,
+    value: number | bigint,
+): number {
+    if (typeof value === "bigint") {
+        offset = EncodeVarBigInt(dst, offset, value);
+    } else {
+        if (value < 0) {
+            // NOTE: Protocol Buffers signed varint encoding uses two's complement of 64-bit unsigned integers.
+            offset = EncodeVarBigInt(dst, offset, BigInt(value));
+        } else {
+            offset = EncodeVarNumber(dst, offset, value);
+        }
+    }
+    return offset;
+}