typia 5.3.11 → 5.3.12-dev.20240119

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,12 +1,12 @@
-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,13 +1,13 @@
-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/$stoll.ts

@@ -1,8 +1,8 @@
-export const $is_bigint_string = (str: string): boolean => {
-  try {
-    BigInt(str);
-    return true;
-  } catch {
-    return false;
-  }
-};
+export const $is_bigint_string = (str: string): boolean => {
+  try {
+    BigInt(str);
+    return true;
+  } catch {
+    return false;
+  }
+};

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/$throws.ts

@@ -0,0 +1,10 @@
+import { TypeGuardError } from "../TypeGuardError";
+
+export const $throws =
+  (method: string) =>
+  (props: Pick<TypeGuardError.IProps, "expected" | "value">) => {
+    throw new TypeGuardError({
+      ...props,
+      method: `typia.${method}`,
+    });
+  };

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;
+}

package/src/functional/$zigzag.ts

@@ -1,39 +1,39 @@
-export function $zigzag_encode(value: number): number;
-export function $zigzag_encode(value: bigint): bigint;
-export function $zigzag_encode(value: number | bigint): any {
-  // TODO: optimize (branchless solution exists)
-
-  if (typeof value === "bigint") {
-    if (value < BigInt(0)) {
-      value = -value;
-      return value * BigInt(2) - BigInt(1);
-    }
-    return value * BigInt(2);
-  }
-
-  if (value < 0) {
-    value = -value;
-    return value * 2 - 1;
-  }
-  return value * 2;
-}
-
-export function $zigzag_decode(value: number): number;
-export function $zigzag_decode(value: bigint): bigint;
-export function $zigzag_decode(value: number | bigint): any {
-  // TODO: optimize (branchless solution exists)
-
-  if (typeof value === "bigint") {
-    value = BigInt.asUintN(64, value);
-    if (value & BigInt(1)) {
-      return -(value + BigInt(1)) / BigInt(2);
-    }
-    return value / BigInt(2);
-  }
-
-  value = value >>> 0;
-  if (value & 1) {
-    return -(value + 1) / 2;
-  }
-  return value / 2;
-}
+export function $zigzag_encode(value: number): number;
+export function $zigzag_encode(value: bigint): bigint;
+export function $zigzag_encode(value: number | bigint): any {
+  // TODO: optimize (branchless solution exists)
+
+  if (typeof value === "bigint") {
+    if (value < BigInt(0)) {
+      value = -value;
+      return value * BigInt(2) - BigInt(1);
+    }
+    return value * BigInt(2);
+  }
+
+  if (value < 0) {
+    value = -value;
+    return value * 2 - 1;
+  }
+  return value * 2;
+}
+
+export function $zigzag_decode(value: number): number;
+export function $zigzag_decode(value: bigint): bigint;
+export function $zigzag_decode(value: number | bigint): any {
+  // TODO: optimize (branchless solution exists)
+
+  if (typeof value === "bigint") {
+    value = BigInt.asUintN(64, value);
+    if (value & BigInt(1)) {
+      return -(value + BigInt(1)) / BigInt(2);
+    }
+    return value / BigInt(2);
+  }
+
+  value = value >>> 0;
+  if (value & 1) {
+    return -(value + 1) / 2;
+  }
+  return value / 2;
+}