@yume-chan/struct 0.0.9 → 0.0.13

package/esm/types/buffer/index.js

@@ -0,0 +1,4 @@
+export * from "./base.js";
+export * from "./fixed-length.js";
+export * from "./variable-length.js";
+//# sourceMappingURL=index.js.map

package/esm/types/buffer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/buffer/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC"}

package/esm/types/buffer/variable-length.d.ts

@@ -0,0 +1,43 @@
+import { StructFieldValue, type StructFieldDefinition, type StructOptions, type StructValue } from '../../basic/index.js';
+import type { KeysOfType } from '../../utils.js';
+import { BufferLikeFieldDefinition, BufferLikeFieldValue, type BufferFieldSubType } from './base.js';
+export declare type LengthField<TFields> = KeysOfType<TFields, number | string>;
+export interface VariableLengthBufferLikeFieldOptions<TFields = object, TLengthField extends LengthField<TFields> = any> {
+    /**
+     * The name of the field that contains the length of the buffer.
+     *
+     * This field must be a `number` or `string` (can't be `bigint`) field.
+     */
+    lengthField: TLengthField;
+    /**
+     * If the `lengthField` refers to a string field,
+     * what radix to use when converting the string to a number.
+     *
+     * @default 10
+     */
+    lengthFieldRadix?: number;
+}
+export declare class VariableLengthBufferLikeFieldDefinition<TType extends BufferFieldSubType = BufferFieldSubType, TOptions extends VariableLengthBufferLikeFieldOptions = VariableLengthBufferLikeFieldOptions> extends BufferLikeFieldDefinition<TType, TOptions, TOptions['lengthField']> {
+    getSize(): number;
+    protected getDeserializeSize(struct: StructValue): number;
+    create(options: Readonly<StructOptions>, struct: StructValue, value: TType['TTypeScriptType'], array?: Uint8Array): VariableLengthBufferLikeStructFieldValue<this>;
+}
+export declare class VariableLengthBufferLikeStructFieldValue<TDefinition extends VariableLengthBufferLikeFieldDefinition = VariableLengthBufferLikeFieldDefinition> extends BufferLikeFieldValue<TDefinition> {
+    protected length: number | undefined;
+    protected lengthFieldValue: VariableLengthBufferLikeFieldLengthValue;
+    constructor(definition: TDefinition, options: Readonly<StructOptions>, struct: StructValue, value: TDefinition['TValue'], array?: Uint8Array);
+    getSize(): number;
+    set(value: unknown): void;
+}
+declare type VariableLengthBufferLikeFieldValueLike = StructFieldValue<StructFieldDefinition<VariableLengthBufferLikeFieldOptions, any, any>>;
+export declare class VariableLengthBufferLikeFieldLengthValue extends StructFieldValue {
+    protected originalField: StructFieldValue;
+    protected bufferField: VariableLengthBufferLikeFieldValueLike;
+    constructor(originalField: StructFieldValue, arrayBufferField: VariableLengthBufferLikeFieldValueLike);
+    getSize(): number;
+    get(): string | number;
+    set(): void;
+    serialize(dataView: DataView, offset: number): void;
+}
+export {};
+//# sourceMappingURL=variable-length.d.ts.map

package/esm/types/buffer/variable-length.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-length.d.ts","sourceRoot":"","sources":["../../../src/types/buffer/variable-length.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC1H,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAErG,oBAAY,WAAW,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAExE,MAAM,WAAW,oCAAoC,CACjD,OAAO,GAAG,MAAM,EAChB,YAAY,SAAS,WAAW,CAAC,OAAO,CAAC,GAAG,GAAG;IAE/C;;;;OAIG;IACH,WAAW,EAAE,YAAY,CAAC;IAE1B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,uCAAuC,CAChD,KAAK,SAAS,kBAAkB,GAAG,kBAAkB,EACrD,QAAQ,SAAS,oCAAoC,GAAG,oCAAoC,CAC1F,SAAQ,yBAAyB,CACnC,KAAK,EACL,QAAQ,EACR,QAAQ,CAAC,aAAa,CAAC,CACtB;IACM,OAAO,IAAI,MAAM;cAIL,kBAAkB,CAAC,MAAM,EAAE,WAAW;IAQzC,MAAM,CAClB,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,EAChC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,KAAK,CAAC,iBAAiB,CAAC,EAC/B,KAAK,CAAC,EAAE,UAAU,GACnB,wCAAwC,CAAC,IAAI,CAAC;CASpD;AAED,qBAAa,wCAAwC,CACjD,WAAW,SAAS,uCAAuC,GAAG,uCAAuC,CACnG,SAAQ,oBAAoB,CAAC,WAAW,CAAC;IAC3C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAErC,SAAS,CAAC,gBAAgB,EAAE,wCAAwC,CAAC;gBAGjE,UAAU,EAAE,WAAW,EACvB,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,EAChC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,EAC5B,KAAK,CAAC,EAAE,UAAU;IAmBN,OAAO;IAYP,GAAG,CAAC,KAAK,EAAE,OAAO;CAKrC;AAGD,aAAK,sCAAsC,GACvC,gBAAgB,CAAC,qBAAqB,CAAC,oCAAoC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE5F,qBAAa,wCACT,SAAQ,gBAAgB;IACxB,SAAS,CAAC,aAAa,EAAE,gBAAgB,CAAC;IAE1C,SAAS,CAAC,WAAW,EAAE,sCAAsC,CAAC;gBAG1D,aAAa,EAAE,gBAAgB,EAC/B,gBAAgB,EAAE,sCAAsC;IAO5C,OAAO;IAIP,GAAG;IAWH,GAAG;IAKnB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;CAI/C"}

package/esm/types/buffer/variable-length.js

@@ -0,0 +1,76 @@
+import { StructFieldValue } from '../../basic/index.js';
+import { BufferLikeFieldDefinition, BufferLikeFieldValue } from './base.js';
+export class VariableLengthBufferLikeFieldDefinition extends BufferLikeFieldDefinition {
+    getSize() {
+        return 0;
+    }
+    getDeserializeSize(struct) {
+        let value = struct.value[this.options.lengthField];
+        if (typeof value === 'string') {
+            value = Number.parseInt(value, this.options.lengthFieldRadix ?? 10);
+        }
+        return value;
+    }
+    create(options, struct, value, array) {
+        return new VariableLengthBufferLikeStructFieldValue(this, options, struct, value, array);
+    }
+}
+export class VariableLengthBufferLikeStructFieldValue extends BufferLikeFieldValue {
+    length;
+    lengthFieldValue;
+    constructor(definition, options, struct, value, array) {
+        super(definition, options, struct, value, array);
+        if (array) {
+            this.length = array.byteLength;
+        }
+        // Patch the associated length field.
+        const lengthField = this.definition.options.lengthField;
+        const originalValue = struct.get(lengthField);
+        this.lengthFieldValue = new VariableLengthBufferLikeFieldLengthValue(originalValue, this);
+        struct.set(lengthField, this.lengthFieldValue);
+    }
+    getSize() {
+        if (this.length === undefined) {
+            this.length = this.definition.type.getSize(this.value);
+            if (this.length === -1) {
+                this.array = this.definition.type.toBuffer(this.value);
+                this.length = this.array.byteLength;
+            }
+        }
+        return this.length;
+    }
+    set(value) {
+        super.set(value);
+        this.array = undefined;
+        this.length = undefined;
+    }
+}
+export class VariableLengthBufferLikeFieldLengthValue extends StructFieldValue {
+    originalField;
+    bufferField;
+    constructor(originalField, arrayBufferField) {
+        super(originalField.definition, originalField.options, originalField.struct, 0);
+        this.originalField = originalField;
+        this.bufferField = arrayBufferField;
+    }
+    getSize() {
+        return this.originalField.getSize();
+    }
+    get() {
+        let value = this.bufferField.getSize();
+        const originalValue = this.originalField.get();
+        if (typeof originalValue === 'string') {
+            value = value.toString(this.bufferField.definition.options.lengthFieldRadix ?? 10);
+        }
+        return value;
+    }
+    set() {
+        // Ignore setting
+        // It will always be in sync with the buffer size
+    }
+    serialize(dataView, offset) {
+        this.originalField.set(this.get());
+        this.originalField.serialize(dataView, offset);
+    }
+}
+//# sourceMappingURL=variable-length.js.map

package/esm/types/buffer/variable-length.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-length.js","sourceRoot":"","sources":["../../../src/types/buffer/variable-length.ts"],"names":[],"mappings":"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"}

package/esm/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./bigint.js";
+export * from "./buffer/index.js";
+export * from "./number.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}

package/esm/types/index.js

@@ -1,5 +1,4 @@
-export * from './array-buffer';
-export * from './fixed-length-array-buffer';
-export * from './number';
-export * from './variable-length-array-buffer';
+export * from "./bigint.js";
+export * from "./buffer/index.js";
+export * from "./number.js";
 //# sourceMappingURL=index.js.map

package/esm/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}

package/esm/types/number.d.ts

@@ -0,0 +1,32 @@
+import { StructFieldDefinition, StructFieldValue, StructValue, type StructAsyncDeserializeStream, type StructDeserializeStream, type StructOptions } from '../basic/index.js';
+export declare type DataViewGetters = {
+    [TKey in keyof DataView]: TKey extends `get${string}` ? TKey : never;
+}[keyof DataView];
+export declare type DataViewSetters = {
+    [TKey in keyof DataView]: TKey extends `set${string}` ? TKey : never;
+}[keyof DataView];
+export declare class NumberFieldType {
+    readonly TTypeScriptType: number;
+    readonly size: number;
+    readonly dataViewGetter: DataViewGetters;
+    readonly dataViewSetter: DataViewSetters;
+    constructor(size: number, dataViewGetter: DataViewGetters, dataViewSetter: DataViewSetters);
+    static readonly Int8: NumberFieldType;
+    static readonly Uint8: NumberFieldType;
+    static readonly Int16: NumberFieldType;
+    static readonly Uint16: NumberFieldType;
+    static readonly Int32: NumberFieldType;
+    static readonly Uint32: NumberFieldType;
+}
+export declare class NumberFieldDefinition<TType extends NumberFieldType = NumberFieldType, TTypeScriptType = TType["TTypeScriptType"]> extends StructFieldDefinition<void, TTypeScriptType> {
+    readonly type: TType;
+    constructor(type: TType, _typescriptType?: TTypeScriptType);
+    getSize(): number;
+    create(options: Readonly<StructOptions>, struct: StructValue, value: TTypeScriptType): NumberFieldValue<this>;
+    deserialize(options: Readonly<StructOptions>, stream: StructDeserializeStream, struct: StructValue): NumberFieldValue<this>;
+    deserialize(options: Readonly<StructOptions>, stream: StructAsyncDeserializeStream, struct: StructValue): Promise<NumberFieldValue<this>>;
+}
+export declare class NumberFieldValue<TDefinition extends NumberFieldDefinition<NumberFieldType, any>> extends StructFieldValue<TDefinition> {
+    serialize(dataView: DataView, offset: number): void;
+}
+//# sourceMappingURL=number.d.ts.map

package/esm/types/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../src/types/number.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,WAAW,EAAE,KAAK,4BAA4B,EAAE,KAAK,uBAAuB,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAI9K,oBAAY,eAAe,GACvB;KAAG,IAAI,IAAI,MAAM,QAAQ,GAAG,IAAI,SAAS,MAAM,MAAM,EAAE,GAAG,IAAI,GAAG,KAAK;CAAE,CAAC,MAAM,QAAQ,CAAC,CAAC;AAE7F,oBAAY,eAAe,GACvB;KAAG,IAAI,IAAI,MAAM,QAAQ,GAAG,IAAI,SAAS,MAAM,MAAM,EAAE,GAAG,IAAI,GAAG,KAAK;CAAE,CAAC,MAAM,QAAQ,CAAC,CAAC;AAE7F,qBAAa,eAAe;IACxB,SAAgB,eAAe,EAAG,MAAM,CAAC;IAEzC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,SAAgB,cAAc,EAAE,eAAe,CAAC;IAEhD,SAAgB,cAAc,EAAE,eAAe,CAAC;gBAG5C,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,eAAe,EAC/B,cAAc,EAAE,eAAe;IAOnC,gBAAuB,IAAI,kBAAgD;IAE3E,gBAAuB,KAAK,kBAAkD;IAE9E,gBAAuB,KAAK,kBAAkD;IAE9E,gBAAuB,MAAM,kBAAoD;IAEjF,gBAAuB,KAAK,kBAAkD;IAE9E,gBAAuB,MAAM,kBAAoD;CACpF;AAED,qBAAa,qBAAqB,CAC9B,KAAK,SAAS,eAAe,GAAG,eAAe,EAC/C,eAAe,GAAG,KAAK,CAAC,iBAAiB,CAAC,CACxC,SAAQ,qBAAqB,CAC/B,IAAI,EACJ,eAAe,CACd;IACD,SAAgB,IAAI,EAAE,KAAK,CAAC;gBAET,IAAI,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,eAAe;IAK1D,OAAO,IAAI,MAAM;IAIjB,MAAM,CACT,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,EAChC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,eAAe,GACvB,gBAAgB,CAAC,IAAI,CAAC;IAIT,WAAW,CACvB,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,EAChC,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,WAAW,GACpB,gBAAgB,CAAC,IAAI,CAAC;IACT,WAAW,CACvB,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,EAChC,MAAM,EAAE,4BAA4B,EACpC,MAAM,EAAE,WAAW,GACpB,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;CAoBrC;AAED,qBAAa,gBAAgB,CACzB,WAAW,SAAS,qBAAqB,CAAC,eAAe,EAAE,GAAG,CAAC,CAC7D,SAAQ,gBAAgB,CAAC,WAAW,CAAC;IAChC,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAU7D"}

package/esm/types/number.js

@@ -1,21 +1,25 @@
-import { __awaiter } from "tslib";
-import { StructFieldDefinition, StructFieldValue } from '../basic';
+// cspell: ignore syncbird
+import { StructFieldDefinition, StructFieldValue } from '../basic/index.js';
+import { Syncbird } from "../syncbird.js";
 export class NumberFieldType {
+    TTypeScriptType;
+    size;
+    dataViewGetter;
+    dataViewSetter;
     constructor(size, dataViewGetter, dataViewSetter) {
         this.size = size;
         this.dataViewGetter = dataViewGetter;
         this.dataViewSetter = dataViewSetter;
     }
+    static Int8 = new NumberFieldType(1, 'getInt8', 'setInt8');
+    static Uint8 = new NumberFieldType(1, 'getUint8', 'setUint8');
+    static Int16 = new NumberFieldType(2, 'getInt16', 'setInt16');
+    static Uint16 = new NumberFieldType(2, 'getUint16', 'setUint16');
+    static Int32 = new NumberFieldType(4, 'getInt32', 'setInt32');
+    static Uint32 = new NumberFieldType(4, 'getUint32', 'setUint32');
 }
-NumberFieldType.Int8 = new NumberFieldType(1, 'getInt8', 'setInt8');
-NumberFieldType.Uint8 = new NumberFieldType(1, 'getUint8', 'setUint8');
-NumberFieldType.Int16 = new NumberFieldType(2, 'getInt16', 'setInt16');
-NumberFieldType.Uint16 = new NumberFieldType(2, 'getUint16', 'setUint16');
-NumberFieldType.Int32 = new NumberFieldType(4, 'getInt32', 'setInt32');
-NumberFieldType.Uint32 = new NumberFieldType(4, 'getUint32', 'setUint32');
-NumberFieldType.Int64 = new NumberFieldType(8, 'getBigInt64', 'setBigInt64');
-NumberFieldType.Uint64 = new NumberFieldType(8, 'getBigUint64', 'setBigUint64');
 export class NumberFieldDefinition extends StructFieldDefinition {
+    type;
     constructor(type, _typescriptType) {
         super();
         this.type = type;
@@ -23,16 +27,20 @@ export class NumberFieldDefinition extends StructFieldDefinition {
     getSize() {
         return this.type.size;
     }
-    create(options, context, struct, value) {
-        return new NumberFieldValue(this, options, context, struct, value);
+    create(options, struct, value) {
+        return new NumberFieldValue(this, options, struct, value);
     }
-    deserialize(options, context, struct) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const buffer = yield context.read(this.getSize());
-            const view = new DataView(buffer);
+    deserialize(options, stream, struct) {
+        return Syncbird
+            .try(() => {
+            return stream.read(this.getSize());
+        })
+            .then(array => {
+            const view = new DataView(array.buffer, array.byteOffset, array.byteLength);
             const value = view[this.type.dataViewGetter](0, options.littleEndian);
-            return this.create(options, context, struct, value);
-        });
+            return this.create(options, struct, value);
+        })
+            .valueOrPromise();
     }
 }
 export class NumberFieldValue extends StructFieldValue {

package/esm/types/number.js.map

@@ -1 +1 @@
-{"version":3,"file":"number.js","sourceRoot":"","sources":["../../src/types/number.ts"],"names":[],"mappings":";AAAA,OAAO,EAAgC,qBAAqB,EAAE,gBAAgB,EAA0D,MAAM,UAAU,CAAC;AAQzJ,MAAM,OAAO,eAAe;IASxB,YACI,IAAY,EACZ,cAA+B,EAC/B,cAA+B;QAE/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACzC,CAAC;;AAEsB,oBAAI,GAAG,IAAI,eAAe,CAAS,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAE5D,qBAAK,GAAG,IAAI,eAAe,CAAS,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAE/D,qBAAK,GAAG,IAAI,eAAe,CAAS,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAE/D,sBAAM,GAAG,IAAI,eAAe,CAAS,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AAElE,qBAAK,GAAG,IAAI,eAAe,CAAS,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAE/D,sBAAM,GAAG,IAAI,eAAe,CAAS,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AAElE,qBAAK,GAAG,IAAI,eAAe,CAAS,CAAC,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;AAErE,sBAAM,GAAG,IAAI,eAAe,CAAS,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;AAGnG,MAAM,OAAO,qBAGP,SAAQ,qBAGT;IAGD,YAAmB,IAAW,EAAE,eAAiC;QAC7D,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAEM,OAAO;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAC1B,CAAC;IAEM,MAAM,CACT,OAAgC,EAChC,OAAmC,EACnC,MAAmB,EACnB,KAAsB;QAEtB,OAAO,IAAI,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IAEY,WAAW,CACpB,OAAgC,EAChC,OAAqC,EACrC,MAAmB;;YAEnB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CACxC,CAAC,EACD,OAAO,CAAC,YAAY,CAChB,CAAC;YACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;KAAA;CACJ;AAED,MAAM,OAAO,gBAEP,SAAQ,gBAA6B;IAChC,SAAS,CAAC,QAAkB,EAAE,MAAc;QAC/C,kEAAkE;QAClE,4DAA4D;QAC5D,uBAAuB;QACtB,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,CAAS,CAClD,MAAM,EACN,IAAI,CAAC,KAAM,EACX,IAAI,CAAC,OAAO,CAAC,YAAY,CAC5B,CAAC;IACN,CAAC;CACJ"}
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../src/types/number.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAE1B,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAoG,MAAM,mBAAmB,CAAC;AAC9K,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAS1C,MAAM,OAAO,eAAe;IACR,eAAe,CAAU;IAEzB,IAAI,CAAS;IAEb,cAAc,CAAkB;IAEhC,cAAc,CAAkB;IAEhD,YACI,IAAY,EACZ,cAA+B,EAC/B,cAA+B;QAE/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACzC,CAAC;IAEM,MAAM,CAAU,IAAI,GAAG,IAAI,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAEpE,MAAM,CAAU,KAAK,GAAG,IAAI,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAEvE,MAAM,CAAU,KAAK,GAAG,IAAI,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAEvE,MAAM,CAAU,MAAM,GAAG,IAAI,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IAE1E,MAAM,CAAU,KAAK,GAAG,IAAI,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAEvE,MAAM,CAAU,MAAM,GAAG,IAAI,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;;AAGrF,MAAM,OAAO,qBAGP,SAAQ,qBAGT;IACe,IAAI,CAAQ;IAE5B,YAAmB,IAAW,EAAE,eAAiC;QAC7D,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAEM,OAAO;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAC1B,CAAC;IAEM,MAAM,CACT,OAAgC,EAChC,MAAmB,EACnB,KAAsB;QAEtB,OAAO,IAAI,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9D,CAAC;IAYe,WAAW,CACvB,OAAgC,EAChC,MAA8D,EAC9D,MAAmB;QAEnB,OAAO,QAAQ;aACV,GAAG,CAAC,GAAG,EAAE;YACN,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACvC,CAAC,CAAC;aACD,IAAI,CAAC,KAAK,CAAC,EAAE;YACV,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CACxC,CAAC,EACD,OAAO,CAAC,YAAY,CACvB,CAAC;YACF,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAY,CAAC,CAAC;QACtD,CAAC,CAAC;aACD,cAAc,EAAE,CAAC;IAC1B,CAAC;CACJ;AAED,MAAM,OAAO,gBAEP,SAAQ,gBAA6B;IAChC,SAAS,CAAC,QAAkB,EAAE,MAAc;QAC/C,kEAAkE;QAClE,4DAA4D;QAC5D,uBAAuB;QACtB,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,CAAS,CAClD,MAAM,EACN,IAAI,CAAC,KAAM,EACX,IAAI,CAAC,OAAO,CAAC,YAAY,CAC5B,CAAC;IACN,CAAC;CACJ"}

package/{dts → esm}/utils.d.ts

@@ -38,10 +38,11 @@ export declare type OmitNever<T> = Pick<T, {
 export declare type KeysOfType<T, TValue> = {
     [TKey in keyof T]: T[TKey] extends TValue ? TKey : never;
 }[keyof T];
-export declare type ValueOrPromise<T> = T | Promise<T>;
-export declare type Awaited<T> = T extends Promise<infer R> ? Awaited<R> : T;
+export declare type ValueOrPromise<T> = T | PromiseLike<T>;
 /**
  * Returns a (fake) value of the given type.
  */
 export declare function placeholder<T>(): T;
+export declare function encodeUtf8(input: string): Uint8Array;
+export declare function decodeUtf8(buffer: ArrayBufferView | ArrayBuffer): string;
 //# sourceMappingURL=utils.d.ts.map

package/{dts → esm}/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,oBAAY,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC;AAE5B;;GAEG;AACH,oBAAY,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,GAAG;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,KAAK,CAAC;AAE/E;;GAEG;AACH,oBAAY,SAAS,CAAC,KAAK,SAAS,MAAM,EAAE,IAAI,SAAS,MAAM,IAC3D,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAE7C;;GAEG;AACH,oBAAY,SAAS,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAEpG;;GAEG;AACH,oBAAY,UAAU,CAAC,CAAC,EAAE,MAAM,IAC5B;KAAG,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,KAAK;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AAE1E,oBAAY,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE/C,oBAAY,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAErE;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,KAAK,CAAC,CAElC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,oBAAY,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC;AAE5B;;GAEG;AACH,oBAAY,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,GAAG;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,KAAK,CAAC;AAE/E;;GAEG;AACH,oBAAY,SAAS,CAAC,KAAK,SAAS,MAAM,EAAE,IAAI,SAAS,MAAM,IAC3D,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAE7C;;GAEG;AACH,oBAAY,SAAS,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAEpG;;GAEG;AACH,oBAAY,UAAU,CAAC,CAAC,EAAE,MAAM,IAC5B;KAAG,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,KAAK;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AAE1E,oBAAY,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAEnD;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,KAAK,CAAC,CAElC;AAeD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAEpD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,GAAG,MAAM,CAExE"}

package/esm/utils.js

@@ -4,4 +4,20 @@
 export function placeholder() {
     return undefined;
 }
+// This library can't use `@types/node` or `lib: dom`
+// because they will pollute the global scope
+// So `TextEncoder` and `TextDecoder` are not available
+// Node.js 8.3 ships `TextEncoder` and `TextDecoder` in `util` module.
+// But using top level await to load them requires Node.js 14.1.
+// So there is no point to do that. Let's just assume they exist in global.
+// @ts-expect-error
+const Utf8Encoder = new TextEncoder();
+// @ts-expect-error
+const Utf8Decoder = new TextDecoder();
+export function encodeUtf8(input) {
+    return Utf8Encoder.encode(input);
+}
+export function decodeUtf8(buffer) {
+    return Utf8Decoder.decode(buffer);
+}
 //# sourceMappingURL=utils.js.map

package/esm/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AA6CA;;GAEG;AACH,MAAM,UAAU,WAAW;IACvB,OAAO,SAAyB,CAAC;AACrC,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AA2CA;;GAEG;AACH,MAAM,UAAU,WAAW;IACvB,OAAO,SAAyB,CAAC;AACrC,CAAC;AAED,qDAAqD;AACrD,6CAA6C;AAC7C,uDAAuD;AAEvD,sEAAsE;AACtE,gEAAgE;AAChE,2EAA2E;AAE3E,mBAAmB;AACnB,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AACtC,mBAAmB;AACnB,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAEtC,MAAM,UAAU,UAAU,CAAC,KAAa;IACpC,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAqC;IAC5D,OAAO,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/package.json

@@ -1,50 +1,47 @@
 {
-    "name": "@yume-chan/struct",
-    "version": "0.0.9",
-    "description": "C-style structure serializer and deserializer.",
-    "keywords": [
-        "structure",
-        "serialization",
-        "deserialization",
-        "typescript"
-    ],
-    "license": "MIT",
-    "author": {
-        "name": "Simon Chan",
-        "email": "cnsimonchan@live.com",
-        "url": "https://chensi.moe/blog"
-    },
-    "homepage": "https://github.com/yume-chan/ya-webadb/tree/master/packages/struct#readme",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/yume-chan/ya-webadb.git",
-        "directory": "packages/struct"
-    },
-    "bugs": {
-        "url": "https://github.com/yume-chan/ya-webadb/issues"
-    },
-    "main": "cjs/index.js",
-    "module": "esm/index.js",
-    "types": "dts/index.d.ts",
-    "scripts": {
-        "build": "rimraf {cjs,esm,dts,*.tsbuildinfo} && tsc -b tsconfig.esm.json tsconfig.cjs.json",
-        "build:watch": "tsc -b -w tsconfig.esm.json tsconfig.cjs.json",
-        "test": "jest",
-        "coverage": "jest --coverage",
-        "prepublishOnly": "npm run build"
-    },
-    "dependencies": {
-        "tslib": "2.1.0"
-    },
-    "devDependencies": {
-        "@types/jest": "26.0.19",
-        "jest": "26.6.3",
-        "rimraf": "3.0.2",
-        "ts-jest": "26.4.4",
-        "typescript": "4.2.3"
-    },
-    "publishConfig": {
-        "access": "public"
-    },
-    "gitHead": "09c9764aa84fe0098342283a61758354ba2613b6"
-}
+  "name": "@yume-chan/struct",
+  "version": "0.0.13",
+  "description": "C-style structure serializer and deserializer.",
+  "keywords": [
+    "structure",
+    "serialization",
+    "deserialization",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Simon Chan",
+    "email": "cnsimonchan@live.com",
+    "url": "https://chensi.moe/blog"
+  },
+  "homepage": "https://github.com/yume-chan/ya-webadb/tree/master/packages/struct#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yume-chan/ya-webadb.git",
+    "directory": "packages/struct"
+  },
+  "bugs": {
+    "url": "https://github.com/yume-chan/ya-webadb/issues"
+  },
+  "type": "module",
+  "main": "esm/index.js",
+  "types": "esm/index.d.ts",
+  "dependencies": {
+    "@yume-chan/dataview-bigint-polyfill": "^0.0.13",
+    "bluebird": "^3.7.2",
+    "tslib": "^2.3.1"
+  },
+  "devDependencies": {
+    "jest": "^27.5.1",
+    "typescript": "4.7.0-beta",
+    "@yume-chan/ts-package-builder": "^1.0.0",
+    "@types/jest": "^27.4.1",
+    "@types/bluebird": "^3.5.36"
+  },
+  "scripts": {
+    "build": "build-ts-package",
+    "build:watch": "build-ts-package --incremental",
+    "test": "jest --coverage"
+  },
+  "readme": "# @yume-chan/struct\r\n\r\n<!--\r\ncspell: ignore Codecov\r\ncspell: ignore uint8arraystring\r\n-->\r\n\r\n![license](https://img.shields.io/npm/l/@yume-chan/struct)\r\n![npm type definitions](https://img.shields.io/npm/types/@yume-chan/struct)\r\n[![npm version](https://img.shields.io/npm/v/@yume-chan/struct)](https://www.npmjs.com/package/@yume-chan/struct)\r\n![npm bundle size](https://img.shields.io/bundlephobia/min/@yume-chan/struct)\r\n![Codecov](https://img.shields.io/codecov/c/github/yume-chan/ya-webadb?flag=struct&token=2fU3Cx2Edq)\r\n\r\nA C-style structure serializer and deserializer. Written in TypeScript and highly takes advantage of its type system.\r\n\r\n**WARNING:** The public API is UNSTABLE. If you have any questions, please open an issue.\r\n\r\n## Installation\r\n\r\n```sh\r\n$ npm i @yume-chan/struct\r\n```\r\n\r\n## Quick Start\r\n\r\n```ts\r\nimport Struct from '@yume-chan/struct';\r\n\r\nconst MyStruct =\r\n    new Struct({ littleEndian: true })\r\n        .int8('foo')\r\n        .int64('bar')\r\n        .int32('bazLength')\r\n        .string('baz', { lengthField: 'bazLength' });\r\n\r\nconst value = await MyStruct.deserialize(stream);\r\nvalue.foo // number\r\nvalue.bar // bigint\r\nvalue.bazLength // number\r\nvalue.baz // string\r\n\r\nconst buffer = MyStruct.serialize({\r\n    foo: 42,\r\n    bar: 42n,\r\n    // `bazLength` automatically set to `baz`'s byte length\r\n    baz: 'Hello, World!',\r\n});\r\n```\r\n\r\n<!-- cspell: disable -->\r\n\r\n- [Installation](#installation)\r\n- [Quick Start](#quick-start)\r\n- [Compatibility](#compatibility)\r\n  - [Basic usage](#basic-usage)\r\n  - [`int64`/`uint64`](#int64uint64)\r\n  - [`string`](#string)\r\n- [API](#api)\r\n  - [`placeholder`](#placeholder)\r\n  - [`Struct`](#struct)\r\n    - [`int8`/`uint8`/`int16`/`uint16`/`int32`/`uint32`](#int8uint8int16uint16int32uint32)\r\n    - [`int64`/`uint64`](#int64uint64-1)\r\n    - [`uint8Array`/`string`](#uint8arraystring)\r\n    - [`fields`](#fields)\r\n    - [`extra`](#extra)\r\n    - [`postDeserialize`](#postdeserialize)\r\n    - [`deserialize`](#deserialize)\r\n    - [`serialize`](#serialize)\r\n- [Custom field type](#custom-field-type)\r\n  - [`Struct#field`](#structfield)\r\n  - [Relationship between types](#relationship-between-types)\r\n  - [`StructFieldDefinition`](#structfielddefinition)\r\n    - [`TValue`/`TOmitInitKey`](#tvaluetomitinitkey)\r\n    - [`getSize`](#getsize)\r\n    - [`create`](#create)\r\n    - [`deserialize`](#deserialize-1)\r\n  - [`StructFieldValue`](#structfieldvalue)\r\n    - [`getSize`](#getsize-1)\r\n    - [`get`/`set`](#getset)\r\n    - [`serialize`](#serialize-1)\r\n\r\n<!-- cspell: enable -->\r\n\r\n## Compatibility\r\n\r\nHere is a list of features, their used APIs, and their compatibilities. If an optional feature is not actually used, its requirements can be ignored.\r\n\r\nSome features can be polyfilled to support older runtimes, but this library doesn't ship with any polyfills.\r\n\r\n### Basic usage\r\n\r\n| API                              | Chrome | Edge | Firefox | Internet Explorer | Safari | Node.js |\r\n| -------------------------------- | ------ | ---- | ------- | ----------------- | ------ | ------- |\r\n| [`Promise`][MDN_Promise]         | 32     | 12   | 29      | No                | 8      | 0.12    |\r\n| [`ArrayBuffer`][MDN_ArrayBuffer] | 7      | 12   | 4       | 10                | 5.1    | 0.10    |\r\n| [`Uint8Array`][MDN_Uint8Array]   | 7      | 12   | 4       | 10                | 5.1    | 0.10    |\r\n| [`DataView`][MDN_DataView]       | 9      | 12   | 15      | 10                | 5.1    | 0.10    |\r\n| *Overall*                        | 32     | 12   | 29      | No                | 8      | 0.12    |\r\n\r\n### [`int64`/`uint64`](#int64uint64-1)\r\n\r\n| API                                | Chrome | Edge | Firefox | Internet Explorer | Safari | Node.js |\r\n| ---------------------------------- | ------ | ---- | ------- | ----------------- | ------ | ------- |\r\n| [`BigInt`][MDN_BigInt]<sup>1</sup> | 67     | 79   | 68      | No                | 14     | 10.4    |\r\n\r\n<sup>1</sup> Can't be polyfilled\r\n\r\n### [`string`](#uint8arraystring)\r\n\r\n| API                              | Chrome | Edge | Firefox | Internet Explorer | Safari | Node.js             |\r\n| -------------------------------- | ------ | ---- | ------- | ----------------- | ------ | ------------------- |\r\n| [`TextEncoder`][MDN_TextEncoder] | 38     | 79   | 19      | No                | 10.1   | 8.3<sup>1</sup>, 11 |\r\n\r\n<sup>1</sup> `TextEncoder` and `TextDecoder` are only available in `util` module. Need to be assigned to `globalThis`.\r\n\r\n[MDN_Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise\r\n[MDN_ArrayBuffer]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer\r\n[MDN_Uint8Array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array\r\n[MDN_DataView]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView\r\n[MDN_BigInt]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt\r\n[MDN_DataView]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView\r\n[MDN_TextEncoder]: https://developer.mozilla.org/en-US/docs/Web/API/TextEncoder\r\n\r\n## API\r\n\r\n### `placeholder`\r\n\r\n```ts\r\nfunction placeholder<T>(): T {\r\n    return undefined as unknown as T;\r\n}\r\n```\r\n\r\nReturns a (fake) value of the given type. It's only useful in TypeScript, if you are using JavaScript, you shouldn't care about it.\r\n\r\nMany methods in this library have multiple generic parameters, but TypeScript only allows users to specify none (let TypeScript inference all of them from arguments), or all generic arguments. ([Microsoft/TypeScript#26242](https://github.com/microsoft/TypeScript/issues/26242))\r\n\r\n<details>\r\n<summary>Detail explanation (click to expand)</summary>\r\n\r\nWhen you have a generic method, where half generic parameters can be inferred.\r\n\r\n```ts\r\ndeclare function fn<A, B>(a: A): [A, B];\r\nfn(42); // Expected 2 type arguments, but got 1. ts(2558)\r\n```\r\n\r\nRather than force users repeat the type `A`, I declare a parameter for `B`.\r\n\r\n```ts\r\ndeclare function fn2<A, B>(a: A, b: B): [A, B];\r\n```\r\n\r\nI don't really need a value of type `B`, I only require its type information\r\n\r\n```ts\r\nfn2(42, placeholder<boolean>()) // fn2<number, boolean>\r\n```\r\n</details>\r\n\r\nTo workaround this issue, these methods have an extra `_typescriptType` parameter, to let you specify a generic parameter, without passing all other generic arguments manually. The actual value of `_typescriptType` argument is never used, so you can pass any value, as long as it has the correct type, including values produced by this `placeholder` method.\r\n\r\n**With that said, I don't expect you to specify any generic arguments manually when using this library.**\r\n\r\n### `Struct`\r\n\r\n```ts\r\nclass Struct<\r\n    TFields extends object = {},\r\n    TOmitInitKey extends string | number | symbol = never,\r\n    TExtra extends object = {},\r\n    TPostDeserialized = undefined\r\n> {\r\n    public constructor(options: Partial<StructOptions> = StructDefaultOptions);\r\n}\r\n```\r\n\r\nCreates a new structure definition.\r\n\r\n<details>\r\n<summary>Generic parameters (click to expand)</summary>\r\n\r\nThis information was added to help you understand how does it work. These are considered as \"internal state\" so don't specify them manually.\r\n\r\n1. `TFields`: Type of the Struct value. Modified when new fields are added.\r\n2. `TOmitInitKey`: When serializing a structure containing variable length buffers, the length field can be calculate from the buffer field, so they doesn't need to be provided explicitly.\r\n3. `TExtra`: Type of extra fields. Modified when `extra` is called.\r\n4. `TPostDeserialized`: State of the `postDeserialize` function. Modified when `postDeserialize` is called. Affects return type of `deserialize`\r\n</details>\r\n\r\n**Parameters**\r\n\r\n1. `options`:\r\n   * `littleEndian:boolean = false`: Whether all multi-byte fields in this struct are [little-endian encoded][Wikipeida_Endianess].\r\n\r\n[Wikipeida_Endianess]: https://en.wikipedia.org/wiki/Endianness\r\n\r\n#### `int8`/`uint8`/`int16`/`uint16`/`int32`/`uint32`\r\n\r\n```ts\r\nint32<\r\n    TName extends string | number | symbol,\r\n    TTypeScriptType = number\r\n>(\r\n    name: TName,\r\n    _typescriptType?: TTypeScriptType\r\n): Struct<\r\n    TFields & Record<TName, TTypeScriptType>,\r\n    TOmitInitKey,\r\n    TExtra,\r\n    TPostDeserialized\r\n>;\r\n```\r\n\r\nAppends an `int8`/`uint8`/`int16`/`uint16`/`int32`/`uint32` field to the `Struct`.\r\n\r\n<details>\r\n<summary>Generic parameters (click to expand)</summary>\r\n\r\n1. `TName`: Literal type of the field's name.\r\n2. `TTypeScriptType = number`: Type of the field in the result object. For example you can declare it as a number literal type, or some enum type.\r\n</details>\r\n\r\n**Parameters**\r\n\r\n1. `name`: (Required) Field name. Must be a string literal.\r\n2. `_typescriptType`: Set field's type. See examples below.\r\n\r\n**Note**\r\n\r\nThere is no generic constraints on the `TTypeScriptType`, because TypeScript doesn't allow casting enum types to `number`.\r\n\r\nSo it's technically possible to pass in an incompatible type (e.g. `string`). But obviously, it's a bad idea.\r\n\r\n**Examples**\r\n\r\n1. Append an `int32` field named `foo`\r\n\r\n    ```ts\r\n    const struct = new Struct()\r\n        .int32('foo');\r\n\r\n    const value = await struct.deserialize(stream);\r\n    value.foo; // number\r\n\r\n    struct.serialize({ }) // error: 'foo' is required\r\n    struct.serialize({ foo: 'bar' }) // error: 'foo' must be a number\r\n    struct.serialize({ foo: 42 }) // ok\r\n    ```\r\n\r\n2. Set fields' type (can be used with [`placeholder` method](#placeholder))\r\n\r\n    ```ts\r\n    enum MyEnum {\r\n        a,\r\n        b,\r\n    }\r\n\r\n    const struct = new Struct()\r\n        .int32('foo', placeholder<MyEnum>())\r\n        .int32('bar', MyEnum.a as const);\r\n\r\n    const value = await struct.deserialize(stream);\r\n    value.foo; // MyEnum\r\n    value.bar; // MyEnum.a\r\n\r\n    struct.serialize({ foo: 42, bar: MyEnum.a }); // error: 'foo' must be of type `MyEnum`\r\n    struct.serialize({ foo: MyEnum.a, bar: MyEnum.b }); // error: 'bar' must be of type `MyEnum.a`\r\n    struct.serialize({ foo: MyEnum.a, bar: MyEnum.b }); // ok\r\n    ```\r\n\r\n#### `int64`/`uint64`\r\n\r\n```ts\r\nint64<\r\n    TName extends string | number | symbol,\r\n    TTypeScriptType = bigint\r\n>(\r\n    name: TName,\r\n    _typescriptType?: TTypeScriptType\r\n): Struct<\r\n    TFields & Record<TName, TTypeScriptType>,\r\n    TOmitInitKey,\r\n    TExtra,\r\n    TPostDeserialized\r\n>;\r\n```\r\n\r\nAppends an `int64`/`uint64` field to the `Struct`. The usage is same as `uint32`/`uint32`.\r\n\r\nRequires native support for `BigInt`. Check [compatibility table](#compatibility) for more information.\r\n\r\n#### `uint8Array`/`string`\r\n\r\n```ts\r\nuint8Array<\r\n    TName extends string | number | symbol,\r\n    TTypeScriptType = ArrayBuffer\r\n>(\r\n    name: TName,\r\n    options: FixedLengthBufferLikeFieldOptions,\r\n    _typescriptType?: TTypeScriptType,\r\n): Struct<\r\n    TFields & Record<TName, TTypeScriptType>,\r\n    TOmitInitKey,\r\n    TExtra,\r\n    TPostDeserialized\r\n>;\r\n\r\nuint8Array<\r\n    TName extends string | number | symbol,\r\n    TLengthField extends LengthField<TFields>,\r\n    TOptions extends VariableLengthBufferLikeFieldOptions<TFields, TLengthField>,\r\n    TTypeScriptType = ArrayBuffer,\r\n>(\r\n    name: TName,\r\n    options: TOptions,\r\n    _typescriptType?: TTypeScriptType,\r\n): Struct<\r\n    TFields & Record<TName, TTypeScriptType>,\r\n    TOmitInitKey | TLengthField,\r\n    TExtra,\r\n    TPostDeserialized\r\n>;\r\n```\r\n\r\nAppends an `uint8Array`/`string` field to the `Struct`.\r\n\r\nThe `options` parameter defines its length, it can be in two formats:\r\n\r\n* `{ length: number }`: Presence of the `length` option indicates that it's a fixed length array.\r\n* `{ lengthField: string; lengthFieldRadix?: number }`: Presence of the `lengthField` option indicates it's a variable length array. The `lengthField` options must refers to a `number` or `string` (can't be `bigint`) typed field that's already defined in this `Struct`. If the length field is a `string`, the optional `lengthFieldRadix` option (defaults to `10`) defines the radix when converting the string to a number. When deserializing, it will use that field's value as its length. When serializing, it will write its length to that field.\r\n\r\n#### `fields`\r\n\r\n```ts\r\nfields<\r\n    TOther extends Struct<any, any, any, any>\r\n>(\r\n    other: TOther\r\n): Struct<\r\n    TFields & TOther['fieldsType'],\r\n    TOmitInitKey | TOther['omitInitType'],\r\n    TExtra & TOther['extraType'],\r\n    TPostDeserialized\r\n>;\r\n```\r\n\r\nMerges (flats) another `Struct`'s fields and extra fields into the current one.\r\n\r\n**Examples**\r\n\r\n1. Extending another `Struct`\r\n\r\n    ```ts\r\n    const MyStructV1 =\r\n        new Struct()\r\n            .int32('field1');\r\n\r\n    const MyStructV2 =\r\n        new Struct()\r\n            .fields(MyStructV1)\r\n            .int32('field2');\r\n\r\n    const structV2 = await MyStructV2.deserialize(stream);\r\n    structV2.field1; // number\r\n    structV2.field2; // number\r\n    // Fields are flatten\r\n    ```\r\n\r\n2. Also possible in any order\r\n\r\n    ```ts\r\n    const MyStructV1 =\r\n        new Struct()\r\n            .int32('field1');\r\n\r\n    const MyStructV2 =\r\n        new Struct()\r\n            .int32('field2')\r\n            .fields(MyStructV1);\r\n\r\n    const structV2 = await MyStructV2.deserialize(stream);\r\n    structV2.field1; // number\r\n    structV2.field2; // number\r\n    // Same result as above, but serialize/deserialize order is reversed\r\n    ```\r\n\r\n#### `extra`\r\n\r\n```ts\r\nextra<\r\n    T extends Record<\r\n        Exclude<\r\n            keyof T,\r\n            Exclude<\r\n                keyof T,\r\n                keyof TFields\r\n            >\r\n        >,\r\n        never\r\n    >\r\n>(\r\n    value: T & ThisType<Overwrite<Overwrite<TExtra, T>, TFields>>\r\n): Struct<\r\n    TFields,\r\n    TInit,\r\n    Overwrite<TExtra, T>,\r\n    TPostDeserialized\r\n>;\r\n```\r\n\r\nAdds extra fields into the `Struct`. Extra fields will be defined on prototype of each Struct values, so they don't affect serialize and deserialize process, and deserialized fields will overwrite extra fields.\r\n\r\nMultiple calls merge all extra fields together.\r\n\r\n**Generic Parameters**\r\n\r\n1. `T`: Type of the extra fields. The scary looking generic constraint is used to forbid overwriting any already existed fields.\r\n\r\n**Parameters**\r\n\r\n1. `value`: An object containing anything you want to add to Struct values. Accessors and methods are also allowed.\r\n\r\n**Examples**\r\n\r\n1. Add an extra field\r\n\r\n    ```ts\r\n    const struct = new Struct()\r\n        .int32('foo')\r\n        .extra({\r\n            bar: 'hello',\r\n        });\r\n\r\n    const value = await struct.deserialize(stream);\r\n    value.foo; // number\r\n    value.bar; // 'hello'\r\n\r\n    struct.serialize({ foo: 42 }); // ok\r\n    struct.serialize({ foo: 42, bar: 'hello' }); // error: 'bar' is redundant\r\n    ```\r\n\r\n2. Add getters and methods. `this` in functions refers to the result object.\r\n\r\n    ```ts\r\n    const struct = new Struct()\r\n        .int32('foo')\r\n        .extra({\r\n            get bar() {\r\n                // `this` is the result Struct value\r\n                return this.foo + 1;\r\n            },\r\n            logBar() {\r\n                // `this` also contains other extra fields\r\n                console.log(this.bar);\r\n            },\r\n        });\r\n\r\n    const value = await struct.deserialize(stream);\r\n    value.foo; // number\r\n    value.bar; // number\r\n    value.logBar();\r\n    ```\r\n\r\n#### `postDeserialize`\r\n\r\n```ts\r\npostDeserialize(): Struct<TFields, TOmitInitKey, TExtra, undefined>;\r\n```\r\n\r\nRemove any registered post-deserialization callback.\r\n\r\n```ts\r\npostDeserialize(\r\n    callback: (this: TFields, object: TFields) => never\r\n): Struct<TFields, TOmitInitKey, TExtra, never>;\r\npostDeserialize(\r\n    callback: (this: TFields, object: TFields) => void\r\n): Struct<TFields, TOmitInitKey, TExtra, undefined>;\r\n```\r\n\r\nRegisters (or replaces) a custom callback to be run after deserialized.\r\n\r\n`this` in `callback`, along with the first parameter `object` will both be the deserialized Struct value.\r\n\r\nA callback returning `never` (always throws errors) will change the return type of `deserialize` to `never`.\r\n\r\nA callback returning `void` means it modify the result object in-place (or doesn't modify it at all), so `deserialize` will still return the result object.\r\n\r\n```ts\r\npostDeserialize<TPostSerialize>(\r\n    callback: (this: TFields, object: TFields) => TPostSerialize\r\n): Struct<TFields, TOmitInitKey, TExtra, TPostSerialize>;\r\n```\r\n\r\nRegisters (or replaces) a custom callback to be run after deserialized.\r\n\r\nA callback returning anything other than `undefined` will cause `deserialize` to return that value instead.\r\n\r\n**Generic Parameters**\r\n\r\n1. `TPostSerialize`: Type of the new result.\r\n\r\n**Parameters**\r\n\r\n1. `callback`: An function contains the custom logic to be run, optionally returns a new result. Or `undefined`, to remove any previously set `postDeserialize` callback.\r\n\r\n**Examples**\r\n\r\n1. Handle an \"error\" packet\r\n\r\n    ```ts\r\n    // Say your protocol have an error packet,\r\n    // You want to throw a JavaScript Error when received such a packet,\r\n    // But you don't want to modify all receiving path\r\n\r\n    const struct = new Struct()\r\n        .int32('messageLength')\r\n        .string('message', { lengthField: 'messageLength' })\r\n        .postDeserialize(value => {\r\n            throw new Error(value.message);\r\n        });\r\n    ```\r\n\r\n2. Do anything you want\r\n\r\n    ```ts\r\n    // I think this one doesn't need any code example\r\n    ```\r\n\r\n3. Replace result object\r\n\r\n    ```ts\r\n    const struct1 = new Struct()\r\n        .int32('foo')\r\n        .postDeserialize(value => {\r\n            return {\r\n                bar: value.foo,\r\n            };\r\n        });\r\n\r\n    const value = await struct.deserialize(stream);\r\n    value.foo // error: not exist\r\n    value.bar; // number\r\n    ```\r\n\r\n#### `deserialize`\r\n\r\n```ts\r\ninterface StructDeserializeStream {\r\n    /**\r\n     * Read data from the underlying data source.\r\n     *\r\n     * The stream must return exactly `length` bytes or data. If that's not possible\r\n     * (due to end of file or other error condition), it must throw an error.\r\n     */\r\n    read(length: number): Uint8Array;\r\n}\r\n\r\ninterface StructAsyncDeserializeStream {\r\n    /**\r\n     * Read data from the underlying data source.\r\n     *\r\n     * The stream must return exactly `length` bytes or data. If that's not possible\r\n     * (due to end of file or other error condition), it must throw an error.\r\n     */\r\n    read(length: number): Promise<Uint8Array>;\r\n}\r\n\r\ndeserialize(\r\n    stream: StructDeserializeStream,\r\n): TPostDeserialized extends undefined\r\n    ? Overwrite<TExtra, TValue>\r\n    : TPostDeserialized\r\n>;\r\ndeserialize(\r\n    stream: StructAsyncDeserializeStream,\r\n): Promise<\r\n    TPostDeserialized extends undefined\r\n        ? Overwrite<TExtra, TValue>\r\n        : TPostDeserialized\r\n    >\r\n>;\r\n```\r\n\r\nDeserialize a struct value from `stream`.\r\n\r\nIt will be synchronous (returns a value) or asynchronous (returns a `Promise`) depending on the type of `stream`.\r\n\r\nAs the signature shows, if the `postDeserialize` callback returns any value, `deserialize` will return that value instead.\r\n\r\nThe `read` method of `stream`, when being called, should returns exactly `length` bytes of data (or throw an `Error` if it can't).\r\n\r\n#### `serialize`\r\n\r\n```ts\r\nserialize(init: Evaluate<Omit<TFields, TOmitInitKey>>): Uint8Array;\r\nserialize(init: Evaluate<Omit<TFields, TOmitInitKey>>, output: Uint8Array): number;\r\n```\r\n\r\nSerialize a struct value into an `Uint8Array`.\r\n\r\nIf an `output` is given, it will serialize the struct into it, and returns the number of bytes written.\r\n\r\n## Custom field type\r\n\r\nIt's also possible to create your own field types.\r\n\r\n### `Struct#field`\r\n\r\n```ts\r\nfield<\r\n    TName extends string | number | symbol,\r\n    TDefinition extends StructFieldDefinition<any, any, any>\r\n>(\r\n    name: TName,\r\n    definition: TDefinition\r\n): Struct<\r\n    TFields & Record<TName, TDefinition['TValue']>,\r\n    TOmitInitKey | TDefinition['TOmitInitKey'],\r\n    TExtra,\r\n    TPostDeserialized\r\n>;\r\n```\r\n\r\nAppends a `StructFieldDefinition` to the `Struct`.\r\n\r\nAll built-in field type methods are actually aliases to it. For example, calling\r\n\r\n```ts\r\nstruct.int8('foo')\r\n```\r\n\r\nis same as\r\n\r\n```ts\r\nstruct.field(\r\n    'foo',\r\n    new NumberFieldDefinition(\r\n        NumberFieldType.Int8\r\n    )\r\n)\r\n```\r\n\r\n### Relationship between types\r\n\r\nA `Struct` is a map between keys and `StructFieldDefinition`s.\r\n\r\nA `StructValue` is a map between keys and `StructFieldValue`s.\r\n\r\nA `Struct` can create (deserialize) multiple `StructValue`s with same field definitions.\r\n\r\nEach time a `Struct` deserialize, each `StructFieldDefinition` in it creates exactly one `StructFieldValue` to be put into the `StructValue`.\r\n\r\n### `StructFieldDefinition`\r\n\r\n```ts\r\nabstract class StructFieldDefinition<\r\n    TOptions = void,\r\n    TValue = unknown,\r\n    TOmitInitKey extends PropertyKey = never,\r\n> {\r\n    public readonly options: TOptions;\r\n\r\n    public constructor(options: TOptions);\r\n}\r\n```\r\n\r\nA field definition defines how to deserialize a field.\r\n\r\nIt's an `abstract` class, means it can't be constructed (`new`ed) directly. It's only used as a base class for other field types.\r\n\r\n#### `TValue`/`TOmitInitKey`\r\n\r\nThese two fields provide type information to TypeScript compiler. Their values will always be `undefined`, but having correct types is enough. You don't need to touch them.\r\n\r\n#### `getSize`\r\n\r\n```ts\r\nabstract getSize(): number;\r\n```\r\n\r\nDerived classes must implement this method to return size (or minimal size if it's dynamic) of this field.\r\n\r\nActual size should be returned from `StructFieldValue#getSize`\r\n\r\n#### `create`\r\n\r\n```ts\r\nabstract create(\r\n    options: Readonly<StructOptions>,\r\n    struct: StructValue,\r\n    value: TValue,\r\n): StructFieldValue<this>;\r\n```\r\n\r\nDerived classes must implement this method to create its own field value instance for the current definition.\r\n\r\n`Struct#serialize` will call this method, then call `StructFieldValue#serialize` to serialize one field value.\r\n\r\n#### `deserialize`\r\n\r\n```ts\r\nabstract deserialize(\r\n    options: Readonly<StructOptions>,\r\n    stream: StructDeserializeStream,\r\n    struct: StructValue,\r\n): StructFieldValue<this>;\r\nabstract deserialize(\r\n    options: Readonly<StructOptions>,\r\n    stream: StructAsyncDeserializeStream,\r\n    struct: StructValue,\r\n): Promise<StructFieldValue<this>>;\r\n```\r\n\r\nDerived classes must implement this method to define how to deserialize a value from `stream`.\r\n\r\nIt must be synchronous (returns a value) or asynchronous (returns a `Promise`) depending on the type of `stream`.\r\n\r\nUsually implementations should be:\r\n\r\n1. Read required bytes from `stream`\r\n2. Parse it to your type\r\n3. Pass the value into your own `create` method\r\n\r\nSometimes, extra metadata is present when deserializing, but need to be calculated when serializing, for example a UTF-8 encoded string may have different length between itself (character count) and serialized form (byte length). So `deserialize` can save those metadata on the `StructFieldValue` instance for later use.\r\n\r\n### `StructFieldValue`\r\n\r\n```ts\r\nabstract class StructFieldValue<\r\n    TDefinition extends StructFieldDefinition<any, any, any>\r\n>\r\n```\r\n\r\nA field value defines how to serialize a field.\r\n\r\n#### `getSize`\r\n\r\n```ts\r\ngetSize(): number;\r\n```\r\n\r\nGets size of this field. By default, it returns its `definition`'s size.\r\n\r\nIf this field's size can change based on some criteria, one must override `getSize` to return its actual size.\r\n\r\n#### `get`/`set`\r\n\r\n```ts\r\nget(): TDefinition['TValue'];\r\nset(value: TDefinition['TValue']): void;\r\n```\r\n\r\nDefines how to get or set this field's value. By default, it reads/writes its `value` field.\r\n\r\nIf one needs to manipulate other states when getting/setting values, they can override these methods.\r\n\r\n#### `serialize`\r\n\r\n```ts\r\nabstract serialize(\r\n    dataView: DataView,\r\n    offset: number\r\n): void;\r\n```\r\n\r\nDerived classes must implement this method to serialize current value into `dataView`, from `offset`. It must not write more bytes than what its `getSize` returned.\r\n"
+}