typia 5.3.12-dev.20240118 → 6.0.0-dev.20240118

package/src/functional/$ProtobufReader.ts

@@ -1,6 +1,9 @@
 import { ProtobufWire } from "../programmers/helpers/ProtobufWire";
 
-/// @reference https://github.com/piotr-oles/as-proto/blob/main/packages/as-proto/assembly/internal/FixedReader.ts
+/**
+ * @reference https://github.com/piotr-oles/as-proto/blob/main/packages/as-proto/assembly/internal/FixedReader.ts
+ * @internal
+ */
 export class $ProtobufReader {
   /**
    * Read buffer
@@ -189,7 +192,18 @@ export class $ProtobufReader {
   }
 }
 
-const utf8 = /** @__PURE__ */ new TextDecoder();
-const N01 = /** @__PURE__ */ BigInt(0x01);
-const N7F = /** @__PURE__ */ BigInt(0x7f);
-const N80 = /** @__PURE__ */ BigInt(0x80);
+/**
+ * @internal
+ */
+const utf8 = new TextDecoder();
+
+/**
+ * @internal
+ */
+const N01 = BigInt(0x01);
+
+/**
+ * @internal
+ */
+const N7F = BigInt(0x7f);
+const N80 = BigInt(0x80);

package/src/functional/$ProtobufSizer.ts

@@ -1,7 +1,10 @@
 import { $strlen } from "./$strlen";
 import { IProtobufWriter } from "./IProtobufWriter";
 
-/// @reference https://github.com/piotr-oles/as-proto/blob/main/packages/as-proto/assembly/internal/FixedSizer.ts
+/**
+ * @reference https://github.com/piotr-oles/as-proto/blob/main/packages/as-proto/assembly/internal/FixedSizer.ts
+ * @internal
+ */
 export class $ProtobufSizer implements IProtobufWriter {
   /**
    * Total length.
@@ -123,14 +126,14 @@ export class $ProtobufSizer implements IProtobufWriter {
       value < 0
         ? 10 // 10 bits with leading 1's
         : value < 0x80
-          ? 1
-          : value < 0x4000
-            ? 2
-            : value < 0x200000
-              ? 3
-              : value < 0x10000000
-                ? 4
-                : 5;
+        ? 1
+        : value < 0x4000
+        ? 2
+        : value < 0x200000
+        ? 3
+        : value < 0x10000000
+        ? 4
+        : 5;
   }
 
   private varint64(val: bigint): void {
@@ -143,5 +146,12 @@ export class $ProtobufSizer implements IProtobufWriter {
   }
 }
 
-const ND07 = /** @__PURE__ */ BigInt(7);
-const NX7F = /** @__PURE__ */ BigInt(0x7f);
+/**
+ * @internal
+ */
+const ND07 = BigInt(7);
+
+/**
+ * @internal
+ */
+const NX7F = BigInt(0x7f);

package/src/functional/$ProtobufWriter.ts

@@ -1,7 +1,10 @@
 import { $ProtobufSizer } from "./$ProtobufSizer";
 import { IProtobufWriter } from "./IProtobufWriter";
 
-/// @reference https://github.com/piotr-oles/as-proto/blob/main/packages/as-proto/assembly/internal/FixedWriter.ts
+/**
+ * @reference https://github.com/piotr-oles/as-proto/blob/main/packages/as-proto/assembly/internal/FixedWriter.ts
+ * @internal
+ */
 export class $ProtobufWriter implements IProtobufWriter {
   /**
    * Related sizer
@@ -141,10 +144,32 @@ export class $ProtobufWriter implements IProtobufWriter {
   }
 }
 
-const utf8 = /** @__PURE__ */ new TextEncoder();
-
-const ND01 = /** @__PURE__ */ BigInt(1);
-const ND07 = /** @__PURE__ */ BigInt(7);
-const ND63 = /** @__PURE__ */ BigInt(63);
-const NX7F = /** @__PURE__ */ BigInt(0x7f);
-const NX80 = /** @__PURE__ */ BigInt(0x80);
+/**
+ * @internal
+ */
+const utf8 = new TextEncoder();
+
+/**
+ * @internal
+ */
+const ND01 = BigInt(1);
+
+/**
+ * @internal
+ */
+const ND07 = BigInt(7);
+
+/**
+ * @internal
+ */
+const ND63 = BigInt(63);
+
+/**
+ * @internal
+ */
+const NX7F = BigInt(0x7f);
+
+/**
+ * @internal
+ */
+const NX80 = BigInt(0x80);

package/src/functional/$QueryReader.ts

@@ -0,0 +1,65 @@
+/**
+ * @internal
+ */
+export namespace $QueryReader {
+  export const boolean = (str: string | null): boolean | null | undefined =>
+    str === null
+      ? undefined
+      : str === "null"
+      ? null
+      : str.length === 0
+      ? true
+      : str === "true" || str === "1"
+      ? true
+      : str === "false" || str === "0"
+      ? false
+      : (str as any); // wrong type
+
+  export const number = (str: string | null): number | null | undefined =>
+    !!str?.length
+      ? str === "null"
+        ? null
+        : (toNumber(str) as any)
+      : undefined;
+
+  export const bigint = (str: string | null): bigint | null | undefined =>
+    !!str?.length
+      ? str === "null"
+        ? null
+        : (toBigint(str) as any)
+      : undefined;
+
+  export const string = (str: string | null): string | null | undefined =>
+    str === null ? undefined : str === "null" ? null : str;
+
+  export const params = (input: string | URLSearchParams) => {
+    if (typeof input === "string") {
+      const index: number = input.indexOf("?");
+      input = index === -1 ? "" : input.substring(index + 1);
+      return new URLSearchParams(input);
+    }
+    return input;
+  };
+
+  export const array = (input: any[], alternative: null | undefined) =>
+    input.length ? input : alternative;
+}
+
+/**
+ * @internal
+ */
+const toNumber = (str: string): number | string => {
+  const value: number = Number(str);
+  return isNaN(value) ? str : value;
+};
+
+/**
+ * @internal
+ */
+const toBigint = (str: string): bigint | string => {
+  try {
+    return BigInt(str);
+  } catch {
+    return str;
+  }
+};

package/src/functional/$camel.ts

@@ -0,0 +1,8 @@
+import { NamingConvention } from "../utils/NamingConvention";
+
+import { $convention } from "./$convention";
+
+/**
+ * @internal
+ */
+export const $camel = $convention(NamingConvention.camel);

package/src/functional/$clone.ts

@@ -1,4 +1,7 @@
 import { Primitive } from "../Primitive";
 
+/**
+ * @internal
+ */
 export const $clone = <T>(value: T): Primitive<T> =>
-  JSON.parse(JSON.stringify(value));
+  value !== undefined ? JSON.parse(JSON.stringify(value)) : undefined;

package/src/functional/$convention.ts

@@ -1,3 +1,6 @@
+/**
+ * @internal
+ */
 export const $convention = (rename: (str: string) => string) => {
   const main = (input: any): any => {
     if (typeof input === "object")

package/src/functional/$generator.ts

@@ -0,0 +1,6 @@
+import { RandomGenerator } from "../utils/RandomGenerator";
+
+/**
+ * @internal
+ */
+export const $generator = RandomGenerator;

package/src/functional/$is_between.ts

@@ -1,2 +1,5 @@
+/**
+ * @internal
+ */
 export const $is_between = (value: number, minimum: number, maximum: number) =>
   minimum <= value && value <= maximum;

package/src/functional/$join.ts

@@ -1,11 +1,23 @@
+/**
+ * @internal
+ */
 export const $join = (str: string): string =>
   variable(str) ? `.${str}` : `[${JSON.stringify(str)}]`;
 
+/**
+ * @internal
+ */
 const variable = (str: string): boolean =>
   reserved(str) === false && /^[a-zA-Z_$][a-zA-Z_$0-9]*$/g.test(str);
 
+/**
+ * @internal
+ */
 const reserved = (str: string): boolean => RESERVED.has(str);
 
+/**
+ * @internal
+ */
 const RESERVED: Set<string> = new Set([
   "break",
   "case",

package/src/functional/$number.ts

@@ -1,5 +1,8 @@
 import { TypeGuardError } from "../TypeGuardError";
 
+/**
+ * @internal
+ */
 export const $number = (value: number): number => {
   if (isFinite(value) === false)
     throw new TypeGuardError({

package/src/functional/$pascal.ts

@@ -0,0 +1,8 @@
+import { NamingConvention } from "../utils/NamingConvention";
+
+import { $convention } from "./$convention";
+
+/**
+ * @internal
+ */
+export const $pascal = $convention(NamingConvention.pascal);

package/src/functional/$report.ts

@@ -1,5 +1,8 @@
 import { IValidation } from "../IValidation";
 
+/**
+ * @internal
+ */
 export const $report = (array: IValidation.IError[]) => {
   const reportable = (path: string): boolean => {
     if (array.length === 0) return true;

package/src/functional/$rest.ts

@@ -1,3 +1,6 @@
+/**
+ * @internal
+ */
 export const $rest = (str: string): string => {
   return str.length === 2 ? "" : "," + str.substring(1, str.length - 1);
 };

package/src/functional/$snake.ts

@@ -0,0 +1,8 @@
+import { NamingConvention } from "../utils/NamingConvention";
+
+import { $convention } from "./$convention";
+
+/**
+ * @internal
+ */
+export const $snake = $convention(NamingConvention.snake);

package/src/functional/$stoll.ts

@@ -1,3 +1,6 @@
+/**
+ * @internal
+ */
 export const $is_bigint_string = (str: string): boolean => {
   try {
     BigInt(str);

package/src/functional/$string.ts

@@ -7,9 +7,9 @@
  * 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
+ * @internal
  */
 export const $string = (str: string): string => {
   if (STR_ESCAPE.test(str) === false) return `"${str}"`;

package/src/functional/$strlen.ts

@@ -1,3 +1,6 @@
+/**
+ * @internal
+ */
 export const $strlen = (s: string): number => {
   let b: number;
   let i: number;

package/src/functional/$throws.ts

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

package/src/functional/IProtobufWriter.ts

@@ -1,3 +1,6 @@
+/**
+ * @internal
+ */
 export interface IProtobufWriter {
   bool(value: boolean): void;
   int32(value: number): void;