typia 5.0.0-dev.20230814 → 5.0.0-dev.20230818

package/src/functional/$ProtobufWriter.ts

@@ -0,0 +1,152 @@
+import { $ProtobufSizer } from "./$ProtobufSizer";
+import { IProtobufWriter } from "./IProtobufWriter";
+
+export class $ProtobufWriter implements IProtobufWriter {
+    /**
+     * Related sizer
+     */
+    private readonly sizer: $ProtobufSizer;
+
+    /**
+     * Current pointer.
+     */
+    private ptr: number;
+
+    /**
+     * Protobuf buffer.
+     */
+    private buf: Uint8Array;
+
+    /**
+     * DataView for buffer.
+     */
+    private view: DataView;
+
+    /**
+     * Index in varlen array from sizer.
+     */
+    private varlenidx: number;
+
+    constructor(sizer: $ProtobufSizer) {
+        this.sizer = sizer;
+        this.buf = new Uint8Array(sizer.len);
+        this.view = new DataView(this.buf.buffer);
+        this.ptr = 0;
+        this.varlenidx = 0;
+    }
+
+    buffer(): Uint8Array {
+        return this.buf;
+    }
+
+    bool(value: boolean): void {
+        this.byte(value ? 1 : 0);
+    }
+
+    byte(value: number): void {
+        this.buf[this.ptr++] = value & 255;
+    }
+
+    int32(value: number): void {
+        if (value < 0) this.int64(value);
+        else this.variant32(value >>> 0);
+    }
+
+    sint32(value: number): void {
+        this.variant32((value << 1) ^ (value >> 31));
+    }
+
+    uint32(value: number): void {
+        this.variant32(value);
+    }
+
+    sint64(value: number | bigint): void {
+        value = BigInt(value);
+        this.variant64((value << ND01) ^ (value >> ND63));
+    }
+
+    int64(value: number | bigint): void {
+        this.variant64(BigInt(value));
+    }
+
+    uint64(value: number | bigint): void {
+        this.variant64(BigInt(value));
+    }
+
+    float(val: number): void {
+        this.view.setFloat32(this.ptr, val, true);
+        this.ptr += 4;
+    }
+
+    double(val: number): void {
+        this.view.setFloat64(this.ptr, val, true);
+        this.ptr += 8;
+    }
+
+    bytes(value: Uint8Array): void {
+        this.fork();
+        this.uint32(value.byteLength);
+        for (let i = 0; i < value.byteLength; i++)
+            this.buf[this.ptr++] = value[i]!;
+    }
+
+    string(value: string): void {
+        const len: number = this.varlen(); // use precomputed length
+        this.uint32(len);
+
+        const binary: Uint8Array = utf8.encode(value);
+        for (let i = 0; i < binary.byteLength; i++)
+            this.buf[this.ptr++] = binary[i]!;
+    }
+
+    fork(): void {
+        this.uint32(this.varlen()); // use precomputed length
+    }
+
+    ldelim(): void {
+        // nothing to do - all dirty work done by sizer
+    }
+
+    finish(): Uint8Array {
+        return this.buf;
+    }
+
+    reset(): void {
+        this.buf = new Uint8Array(this.sizer.len);
+        this.view = new DataView(this.buf.buffer);
+        this.ptr = 0;
+        this.varlenidx = 0;
+    }
+
+    private variant32(val: number): void {
+        while (val > 0x7f) {
+            this.buf[this.ptr++] = (val & 0x7f) | 0x80;
+            val = val >>> 7;
+        }
+        this.buf[this.ptr++] = val;
+    }
+
+    private variant64(val: bigint): void {
+        val = BigInt.asUintN(64, val);
+        while (val > NX7F) {
+            this.buf[this.ptr++] = Number((val & NX7F) | NX80);
+            val = val >> ND07; // @todo
+            // (val / (128n) % 2n === 1n)
+        }
+        this.buf[this.ptr++] = Number(val);
+    }
+
+    private varlen(): number {
+        return this.varlenidx >= this.sizer.varlen.length
+            ? 0
+            : this.sizer.varlen[this.varlenidx++]!;
+    }
+}
+
+const utf8 = new TextEncoder();
+
+const ND01 = BigInt(1);
+const ND07 = BigInt(7);
+const ND63 = BigInt(63);
+const NX7F = BigInt(0x7f);
+const NX80 = BigInt(0x80);

package/src/functional/IProtobufWriter.ts

@@ -0,0 +1,18 @@
+export interface IProtobufWriter {
+    bool(value: boolean): void;
+    int32(value: number): void;
+    sint32(value: number): void;
+    uint32(value: number): void;
+
+    int64(value: bigint | number): void;
+    sint64(value: bigint | number): void;
+    uint64(value: bigint | number): void;
+
+    float(value: number): void;
+    double(value: number): void;
+    bytes(value: Uint8Array): void;
+    string(value: string): void;
+
+    fork(): void;
+    ldelim(): void;
+}

package/src/functional/Namespace.ts

@@ -1,9 +1,10 @@
-import { Writer } from "protobufjs";
-
 import { RandomGenerator } from "../utils/RandomGenerator";
 
 import { IValidation } from "../IValidation";
 import { TypeGuardError } from "../TypeGuardError";
+import { $ProtobufReader } from "./$ProtobufReader";
+import { $ProtobufSizer } from "./$ProtobufSizer";
+import { $ProtobufWriter } from "./$ProtobufWriter";
 import { $any } from "./$any";
 import { $every } from "./$every";
 import { $guard } from "./$guard";
@@ -101,14 +102,20 @@ export namespace Namespace {
             string: $string,
             tail: $tail,
             rest: $rest,
-            throws: $throws(method),
+            throws: $throws(`json.${method}`),
         });
     }
 
     export namespace protobuf {
+        export const decode = (method: string) => ({
+            Reader: $ProtobufReader,
+            throws: $throws(`protobuf.${method}`),
+        });
+
         export const encode = (method: string) => ({
-            Writer: Writer,
-            strl: $strlen,
+            Sizer: $ProtobufSizer,
+            Writer: $ProtobufWriter,
+            strlen: $strlen,
             throws: $throws(method),
         });
     }
@@ -116,13 +123,13 @@ export namespace Namespace {
     export namespace misc {
         export const clone = (method: string) => ({
             ...is(),
-            throws: $throws(method),
+            throws: $throws(`misc.${method}`),
             any: $any,
         });
 
         export const prune = (method: string) => ({
             ...is(),
-            throws: $throws(method),
+            throws: $throws(`misc.${method}`),
         });
     }
 

package/src/programmers/FeatureProgrammer.ts

@@ -278,9 +278,9 @@ export namespace FeatureProgrammer {
         (collection: MetadataCollection) =>
             collection
                 .objects()
-                .map((obj, i) =>
+                .map((obj) =>
                     StatementFactory.constant(
-                        `${config.prefix}o${i}`,
+                        `${config.prefix}o${obj.index}`,
                         ts.factory.createArrowFunction(
                             undefined,
                             undefined,

package/src/programmers/helpers/CloneJoiner.ts

@@ -32,7 +32,6 @@ export namespace CloneJoiner {
         if (dynamic.length === 0) return literal;
 
         const key = ts.factory.createIdentifier("key");
-        const value = ts.factory.createIdentifier("value");
         const output = ts.factory.createIdentifier("output");
 
         const statements: ts.Statement[] = dynamic.map((entry) =>
@@ -72,30 +71,7 @@ export namespace CloneJoiner {
             ),
             ts.factory.createForOfStatement(
                 undefined,
-                ts.factory.createVariableDeclarationList(
-                    [
-                        ts.factory.createVariableDeclaration(
-                            ts.factory.createArrayBindingPattern([
-                                ts.factory.createBindingElement(
-                                    undefined,
-                                    undefined,
-                                    key,
-                                    undefined,
-                                ),
-                                ts.factory.createBindingElement(
-                                    undefined,
-                                    undefined,
-                                    value,
-                                    undefined,
-                                ),
-                            ]),
-                            undefined,
-                            undefined,
-                            undefined,
-                        ),
-                    ],
-                    ts.NodeFlags.Const,
-                ),
+                StatementFactory.entry("key")("value"),
                 ts.factory.createCallExpression(
                     ts.factory.createIdentifier("Object.entries"),
                     undefined,

package/src/programmers/helpers/ProtobufWire.ts

@@ -1,28 +1,34 @@
 export const enum ProtobufWire {
     /**
-     * integers
-     * bool
-     * enum
+     * - integers
+     * - bool
+     * - enum
      */
-    VARINT = 0,
+    VARIANT = 0,
 
     /**
-     * fixed64
-     * sfixed64
-     * double
+     * - fixed64
+     * - sfixed64
+     * - double
      */
     I64 = 1,
 
     /**
-     * string
-     * bytes
-     * mebedded messages
-     * packed repeated fields
+     * - string
+     * - bytes
+     * - mebedded messages
+     * - packed repeated fields
      */
     LEN = 2,
 
+    START_GROUP = 3,
+
+    END_GROUP = 4,
+
     /**
-     * fixed, sfixed32, float
+     * - fixed
+     * - sfixed32
+     * - float
      */
     I32 = 5,
 }

package/src/programmers/helpers/RandomRanger.ts

@@ -26,7 +26,7 @@ export namespace RandomRanger {
 
             props.minimum ??= defs.minimum;
             props.maximum ??= defs.maximum;
-            if (props.maximum <= props.minimum)
+            if (props.maximum < props.minimum)
                 (props.maximum as number) += defs.gap;
 
             return ts.factory.createCallExpression(

package/src/programmers/json/JsonStringifyProgrammer.ts

@@ -937,6 +937,12 @@ export namespace JsonStringifyProgrammer {
                 validate: (meta) => {
                     if (meta.atomics.find((str) => str === "bigint"))
                         throw new Error(NO_BIGINT);
+                    else if (
+                        meta.arrays.some(
+                            (array) => array.value.isRequired() === false,
+                        )
+                    )
+                        throw new Error(NO_UNDEFINED_IN_ARRAY);
                 },
             })(collection)(type);
             return [collection, meta];
@@ -977,3 +983,5 @@ interface IUnion {
 
 const NO_BIGINT =
     "Error on typia.json.stringify(): does not allow bigint type.";
+const NO_UNDEFINED_IN_ARRAY =
+    "Error on typia.json.stringify(): does not allow undefined type in array.";