npm - @kikuchan/binary-reader - Versions diffs - 0.1.0-alpha.2 → 0.1.0-alpha.4 - Mend

@kikuchan/binary-reader 0.1.0-alpha.2 → 0.1.0-alpha.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/index.cjs +1 -0
package/index.d.cts +55 -0
package/index.d.ts +55 -0
package/index.js +1 -0
package/package.json +12 -4
package/LICENSE +0 -21
package/src/index.ts +0 -268
package/tests/binary-reader.spec.ts +0 -461
package/tsconfig.json +0 -1

package/index.cjs ADDED Viewed

@@ -0,0 +1 @@

+ Object.defineProperty(exports,`__esModule`,{value:!0});var e=class{#e;#t;#n;#r={};constructor(e,t){ArrayBuffer.isView(e)?this.#e=new DataView(e.buffer,e.byteOffset,e.byteLength):this.#e=new DataView(e),this.#t=0,this.#n=t?.littleEndian}get position(){return this.#t}get size(){return this.#e.byteLength}get remain(){return this.size-this.position}eof(){return this.remain<=0}seek(e){if(typeof e==`string`){let t=this.#r[e];if(t===void 0)throw Error(`seek: no such bookmark`);e=t}return typeof e==`number`&&(this.#t=Math.min(Math.max(e,0),this.size)),this}bookmark(e){return this.#r[e]=this.#t,this}rewind(){return this.seek(0)}skip(e){return this.seek(this.#t+(e??1))}align(e){if(!(e>0))throw RangeError(`align(n): n must be > 0`);return this.position%e?this.skip(e-this.position%e):this}peekBytes(e){e===void 0&&(e=this.remain);let t=this.#e.byteOffset+this.position;return new Uint8Array(this.#e.buffer.slice(t,t+e))}readUint8(){let e=this.#e.getUint8(this.position);return this.skip(1),e}readUint16(e){let t=this.#e.getUint16(this.position,e??this.#n);return this.skip(2),t}readUint16le(){return this.readUint16(!0)}readUint16be(){return this.readUint16(!1)}readUint32(e){let t=this.#e.getUint32(this.position,e??this.#n);return this.skip(4),t}readUint32le(){return this.readUint32(!0)}readUint32be(){return this.readUint32(!1)}readUint64(e){let t=this.#e.getBigUint64(this.position,e??this.#n);return this.skip(8),t}readUint64le(){return this.readUint64(!0)}readUint64be(){return this.readUint64(!1)}readInt8(){let e=this.#e.getInt8(this.position);return this.skip(1),e}readInt16(e){let t=this.#e.getInt16(this.position,e??this.#n);return this.skip(2),t}readInt16le(){return this.readInt16(!0)}readInt16be(){return this.readInt16(!1)}readInt32(e){let t=this.#e.getInt32(this.position,e??this.#n);return this.skip(4),t}readInt32le(){return this.readInt32(!0)}readInt32be(){return this.readInt32(!1)}readInt64(e){let t=this.#e.getBigInt64(this.position,e??this.#n);return this.skip(8),t}readInt64le(){return this.readInt64(!0)}readInt64be(){return this.readInt64(!1)}readFloat16(e){let t=this.#e.getFloat16(this.position,e??this.#n);return this.skip(2),t}readFloat16le(){return this.readFloat16(!0)}readFloat16be(){return this.readFloat16(!1)}readFloat32(e){let t=this.#e.getFloat32(this.position,e??this.#n);return this.skip(4),t}readFloat32le(){return this.readFloat32(!0)}readFloat32be(){return this.readFloat32(!1)}readFloat64(e){let t=this.#e.getFloat64(this.position,e??this.#n);return this.skip(8),t}readFloat64le(){return this.readFloat64(!0)}readFloat64be(){return this.readFloat64(!1)}#i(){let e=this.remain;for(let t=0;t<e;t++)if(this.#e.getUint8(this.position+t)===0)return t}readBytes(e){let t=this.peekBytes(e);return t&&this.skip(t.byteLength),t}readString(e,t){let n=this.remain,r=0;if(e===void 0&&(e=this.#i(),r=1),e===void 0||n<e)return;let i=this.peekBytes(e);try{if(typeof t==`function`){let n=t(i);return this.skip(e+r),n}else{let n=new TextDecoder(t??`utf-8`,{fatal:!0}).decode(i);return this.skip(e+r),n}}catch{return}}},t=e;exports.BinaryReader=e,exports.default=t;

package/index.d.cts ADDED Viewed

@@ -0,0 +1,55 @@
+//#region src/index.d.ts
+type BinaryLike = Uint8Array | Uint8ClampedArray | ArrayBufferLike | DataView;
+type Options = {
+  littleEndian?: boolean;
+};
+declare class BinaryReader {
+  #private;
+  constructor(u8: BinaryLike, opts?: Options);
+  get position(): number;
+  get size(): number;
+  get remain(): number;
+  eof(): boolean;
+  seek(n: number | string): this;
+  bookmark(s: string): this;
+  rewind(): this;
+  skip(n?: number): this;
+  align(n: number): this;
+  peekBytes(n?: number): Uint8Array<ArrayBuffer | SharedArrayBuffer>;
+  readUint8(): number;
+  readUint16(littleEndian?: boolean): number;
+  readUint16le(): number;
+  readUint16be(): number;
+  readUint32(littleEndian?: boolean): number;
+  readUint32le(): number;
+  readUint32be(): number;
+  readUint64(littleEndian?: boolean): bigint;
+  readUint64le(): bigint;
+  readUint64be(): bigint;
+  readInt8(): number;
+  readInt16(littleEndian?: boolean): number;
+  readInt16le(): number;
+  readInt16be(): number;
+  readInt32(littleEndian?: boolean): number;
+  readInt32le(): number;
+  readInt32be(): number;
+  readInt64(littleEndian?: boolean): bigint;
+  readInt64le(): bigint;
+  readInt64be(): bigint;
+  readFloat16(littleEndian?: boolean): number;
+  readFloat16le(): number;
+  readFloat16be(): number;
+  readFloat32(littleEndian?: boolean): number;
+  readFloat32le(): number;
+  readFloat32be(): number;
+  readFloat64(littleEndian?: boolean): number;
+  readFloat64le(): number;
+  readFloat64be(): number;
+  readBytes(n?: number): Uint8Array<ArrayBuffer | SharedArrayBuffer>;
+  /**
+   * @returns string. undefined on oversize or EOF.
+   */
+  readString(len?: number, encoding?: string | ((u8: Uint8Array) => string)): string | undefined;
+}
+//#endregion
+export { BinaryLike, BinaryReader, BinaryReader as default };

package/index.d.ts ADDED Viewed

@@ -0,0 +1,55 @@
+//#region src/index.d.ts
+type BinaryLike = Uint8Array | Uint8ClampedArray | ArrayBufferLike | DataView;
+type Options = {
+  littleEndian?: boolean;
+};
+declare class BinaryReader {
+  #private;
+  constructor(u8: BinaryLike, opts?: Options);
+  get position(): number;
+  get size(): number;
+  get remain(): number;
+  eof(): boolean;
+  seek(n: number | string): this;
+  bookmark(s: string): this;
+  rewind(): this;
+  skip(n?: number): this;
+  align(n: number): this;
+  peekBytes(n?: number): Uint8Array<ArrayBuffer | SharedArrayBuffer>;
+  readUint8(): number;
+  readUint16(littleEndian?: boolean): number;
+  readUint16le(): number;
+  readUint16be(): number;
+  readUint32(littleEndian?: boolean): number;
+  readUint32le(): number;
+  readUint32be(): number;
+  readUint64(littleEndian?: boolean): bigint;
+  readUint64le(): bigint;
+  readUint64be(): bigint;
+  readInt8(): number;
+  readInt16(littleEndian?: boolean): number;
+  readInt16le(): number;
+  readInt16be(): number;
+  readInt32(littleEndian?: boolean): number;
+  readInt32le(): number;
+  readInt32be(): number;
+  readInt64(littleEndian?: boolean): bigint;
+  readInt64le(): bigint;
+  readInt64be(): bigint;
+  readFloat16(littleEndian?: boolean): number;
+  readFloat16le(): number;
+  readFloat16be(): number;
+  readFloat32(littleEndian?: boolean): number;
+  readFloat32le(): number;
+  readFloat32be(): number;
+  readFloat64(littleEndian?: boolean): number;
+  readFloat64le(): number;
+  readFloat64be(): number;
+  readBytes(n?: number): Uint8Array<ArrayBuffer | SharedArrayBuffer>;
+  /**
+   * @returns string. undefined on oversize or EOF.
+   */
+  readString(len?: number, encoding?: string | ((u8: Uint8Array) => string)): string | undefined;
+}
+//#endregion
+export { BinaryLike, BinaryReader, BinaryReader as default };

package/index.js ADDED Viewed

@@ -0,0 +1 @@

+ var e=class{#e;#t;#n;#r={};constructor(e,t){ArrayBuffer.isView(e)?this.#e=new DataView(e.buffer,e.byteOffset,e.byteLength):this.#e=new DataView(e),this.#t=0,this.#n=t?.littleEndian}get position(){return this.#t}get size(){return this.#e.byteLength}get remain(){return this.size-this.position}eof(){return this.remain<=0}seek(e){if(typeof e==`string`){let t=this.#r[e];if(t===void 0)throw Error(`seek: no such bookmark`);e=t}return typeof e==`number`&&(this.#t=Math.min(Math.max(e,0),this.size)),this}bookmark(e){return this.#r[e]=this.#t,this}rewind(){return this.seek(0)}skip(e){return this.seek(this.#t+(e??1))}align(e){if(!(e>0))throw RangeError(`align(n): n must be > 0`);return this.position%e?this.skip(e-this.position%e):this}peekBytes(e){e===void 0&&(e=this.remain);let t=this.#e.byteOffset+this.position;return new Uint8Array(this.#e.buffer.slice(t,t+e))}readUint8(){let e=this.#e.getUint8(this.position);return this.skip(1),e}readUint16(e){let t=this.#e.getUint16(this.position,e??this.#n);return this.skip(2),t}readUint16le(){return this.readUint16(!0)}readUint16be(){return this.readUint16(!1)}readUint32(e){let t=this.#e.getUint32(this.position,e??this.#n);return this.skip(4),t}readUint32le(){return this.readUint32(!0)}readUint32be(){return this.readUint32(!1)}readUint64(e){let t=this.#e.getBigUint64(this.position,e??this.#n);return this.skip(8),t}readUint64le(){return this.readUint64(!0)}readUint64be(){return this.readUint64(!1)}readInt8(){let e=this.#e.getInt8(this.position);return this.skip(1),e}readInt16(e){let t=this.#e.getInt16(this.position,e??this.#n);return this.skip(2),t}readInt16le(){return this.readInt16(!0)}readInt16be(){return this.readInt16(!1)}readInt32(e){let t=this.#e.getInt32(this.position,e??this.#n);return this.skip(4),t}readInt32le(){return this.readInt32(!0)}readInt32be(){return this.readInt32(!1)}readInt64(e){let t=this.#e.getBigInt64(this.position,e??this.#n);return this.skip(8),t}readInt64le(){return this.readInt64(!0)}readInt64be(){return this.readInt64(!1)}readFloat16(e){let t=this.#e.getFloat16(this.position,e??this.#n);return this.skip(2),t}readFloat16le(){return this.readFloat16(!0)}readFloat16be(){return this.readFloat16(!1)}readFloat32(e){let t=this.#e.getFloat32(this.position,e??this.#n);return this.skip(4),t}readFloat32le(){return this.readFloat32(!0)}readFloat32be(){return this.readFloat32(!1)}readFloat64(e){let t=this.#e.getFloat64(this.position,e??this.#n);return this.skip(8),t}readFloat64le(){return this.readFloat64(!0)}readFloat64be(){return this.readFloat64(!1)}#i(){let e=this.remain;for(let t=0;t<e;t++)if(this.#e.getUint8(this.position+t)===0)return t}readBytes(e){let t=this.peekBytes(e);return t&&this.skip(t.byteLength),t}readString(e,t){let n=this.remain,r=0;if(e===void 0&&(e=this.#i(),r=1),e===void 0||n<e)return;let i=this.peekBytes(e);try{if(typeof t==`function`){let n=t(i);return this.skip(e+r),n}else{let n=new TextDecoder(t??`utf-8`,{fatal:!0}).decode(i);return this.skip(e+r),n}}catch{return}}},t=e;export{e as BinaryReader,t as default};

package/package.json CHANGED Viewed

@@ -4,13 +4,21 @@
   "keywords": [
     "binary-reader"
   ],
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.4",
   "type": "module",
-  "main": "./src/index.ts",
+  "main": "./index.js",
   "author": "kikuchan <kikuchan98@gmail.com>",
   "homepage": "https://github.com/kikuchan/utils-on-npm#readme",
   "license": "MIT",
-  "scripts": {
-    "build": "tsdown"
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "require": "./index.cjs"
+    }
+  },
+  "repository": {
+    "url": "https://github.com/kikuchan/utils-on-npm"
   }
 }

package/LICENSE DELETED Viewed

@@ -1,21 +0,0 @@
-MIT License
-Copyright (c) 2025 kikuchan
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/src/index.ts DELETED Viewed

@@ -1,268 +0,0 @@
-export type BinaryLike = Uint8Array | Uint8ClampedArray | ArrayBufferLike | DataView;
-type Options = {
-  littleEndian?: boolean;
-};
-export class BinaryReader {
-  #view: DataView;
-  #pos: number;
-  #littleEndian: boolean | undefined;
-  #bookmarks: Record<string, number> = {};
-  constructor(u8: BinaryLike, opts?: Options) {
-    if (!ArrayBuffer.isView(u8)) {
-      this.#view = new DataView(u8);
-    } else {
-      this.#view = new DataView(u8.buffer, u8.byteOffset, u8.byteLength);
-    }
-    this.#pos = 0;
-    this.#littleEndian = opts?.littleEndian;
-  }
-  get position() {
-    return this.#pos;
-  }
-  get size() {
-    return this.#view.byteLength;
-  }
-  get remain() {
-    return this.size - this.position;
-  }
-  eof() {
-    return this.remain <= 0;
-  }
-  seek(n: number | string) {
-    if (typeof n === 'string') {
-      const b = this.#bookmarks[n];
-      if (typeof b === 'undefined') throw new Error('seek: no such bookmark');
-      n = b;
-    }
-    if (typeof n === 'number') {
-      this.#pos = Math.min(Math.max(n, 0), this.size);
-    }
-    return this;
-  }
-  bookmark(s: string) {
-    this.#bookmarks[s] = this.#pos;
-    return this;
-  }
-  rewind() {
-    return this.seek(0);
-  }
-  skip(n?: number) {
-    return this.seek(this.#pos + (n ?? 1));
-  }
-  align(n: number) {
-    if (!(n > 0)) throw new RangeError('align(n): n must be > 0');
-    if (this.position % n) {
-      return this.skip(n - (this.position % n));
-    }
-    return this;
-  }
-  peekBytes(n?: number) {
-    if (n === undefined) n = this.remain;
-    const pos = this.#view.byteOffset + this.position;
-    return new Uint8Array(this.#view.buffer.slice(pos, pos + n));
-  }
-  readUint8() {
-    const r = this.#view.getUint8(this.position);
-    this.skip(1);
-    return r;
-  }
-  readUint16(littleEndian?: boolean) {
-    const r = this.#view.getUint16(this.position, littleEndian ?? this.#littleEndian);
-    this.skip(2);
-    return r;
-  }
-  readUint16le() {
-    return this.readUint16(true);
-  }
-  readUint16be() {
-    return this.readUint16(false);
-  }
-  readUint32(littleEndian?: boolean) {
-    const r = this.#view.getUint32(this.position, littleEndian ?? this.#littleEndian);
-    this.skip(4);
-    return r;
-  }
-  readUint32le() {
-    return this.readUint32(true);
-  }
-  readUint32be() {
-    return this.readUint32(false);
-  }
-  readUint64(littleEndian?: boolean) {
-    const r = this.#view.getBigUint64(this.position, littleEndian ?? this.#littleEndian);
-    this.skip(8);
-    return r;
-  }
-  readUint64le() {
-    return this.readUint64(true);
-  }
-  readUint64be() {
-    return this.readUint64(false);
-  }
-  readInt8() {
-    const r = this.#view.getInt8(this.position);
-    this.skip(1);
-    return r;
-  }
-  readInt16(littleEndian?: boolean) {
-    const r = this.#view.getInt16(this.position, littleEndian ?? this.#littleEndian);
-    this.skip(2);
-    return r;
-  }
-  readInt16le() {
-    return this.readInt16(true);
-  }
-  readInt16be() {
-    return this.readInt16(false);
-  }
-  readInt32(littleEndian?: boolean) {
-    const r = this.#view.getInt32(this.position, littleEndian ?? this.#littleEndian);
-    this.skip(4);
-    return r;
-  }
-  readInt32le() {
-    return this.readInt32(true);
-  }
-  readInt32be() {
-    return this.readInt32(false);
-  }
-  readInt64(littleEndian?: boolean) {
-    const r = this.#view.getBigInt64(this.position, littleEndian ?? this.#littleEndian);
-    this.skip(8);
-    return r;
-  }
-  readInt64le() {
-    return this.readInt64(true);
-  }
-  readInt64be() {
-    return this.readInt64(false);
-  }
-  readFloat16(littleEndian?: boolean) {
-    const r = this.#view.getFloat16(this.position, littleEndian ?? this.#littleEndian);
-    this.skip(2);
-    return r;
-  }
-  readFloat16le() {
-    return this.readFloat16(true);
-  }
-  readFloat16be() {
-    return this.readFloat16(false);
-  }
-  readFloat32(littleEndian?: boolean) {
-    const r = this.#view.getFloat32(this.position, littleEndian ?? this.#littleEndian);
-    this.skip(4);
-    return r;
-  }
-  readFloat32le() {
-    return this.readFloat32(true);
-  }
-  readFloat32be() {
-    return this.readFloat32(false);
-  }
-  readFloat64(littleEndian?: boolean) {
-    const r = this.#view.getFloat64(this.position, littleEndian ?? this.#littleEndian);
-    this.skip(8);
-    return r;
-  }
-  readFloat64le() {
-    return this.readFloat64(true);
-  }
-  readFloat64be() {
-    return this.readFloat64(false);
-  }
-  #strlen() {
-    const remain = this.remain;
-    for (let i = 0; i < remain; i++) {
-      if (this.#view.getUint8(this.position + i) === 0) {
-        return i;
-      }
-    }
-    return undefined; // No termination
-  }
-  readBytes(n?: number) {
-    const buffer = this.peekBytes(n);
-    if (buffer) this.skip(buffer.byteLength);
-    return buffer;
-  }
-  /**
-   * @returns string. undefined on oversize or EOF.
-   */
-  readString(len?: number, encoding?: string | ((u8: Uint8Array) => string)) {
-    const remain = this.remain;
-    let extraLength = 0;
-    if (len === undefined) {
-      // C String Mode
-      len = this.#strlen();
-      extraLength = 1;
-    }
-    if (len === undefined || remain < len) return undefined; // EOF
-    const buffer = this.peekBytes(len);
-    try {
-      if (typeof encoding === 'function') {
-        const string = encoding(buffer);
-        this.skip(len + extraLength);
-        return string;
-      } else {
-        // XXX: encoding
-        const string = new TextDecoder((encoding ?? 'utf-8') as 'utf-8', {
-          fatal: true,
-        }).decode(buffer);
-        this.skip(len + extraLength);
-        return string;
-      }
-    } catch {
-      return undefined;
-    }
-  }
-}
-export default BinaryReader;

package/tests/binary-reader.spec.ts DELETED Viewed

@@ -1,461 +0,0 @@
-import { BinaryReader } from '@kikuchan/binary-reader';
-import { describe, expect, it } from 'vitest';
-describe('Core State', () => {
-  it('positions, sizes, and computes eof', () => {
-    const u8 = new Uint8Array([1, 2, 3, 4]);
-    const br = new BinaryReader(u8);
-    expect(br.position).toBe(0);
-    expect(br.size).toBe(4);
-    expect(br.remain).toBe(4);
-    expect(br.eof()).toBe(false);
-    br.skip(4);
-    expect(br.position).toBe(4);
-    expect(br.remain).toBe(0);
-    expect(br.eof()).toBe(true);
-  });
-  it('seeks, bookmarks, and rewinds', () => {
-    const u8 = new Uint8Array([0, 1, 2, 3, 4, 5]);
-    const br = new BinaryReader(u8);
-    br.skip(2);
-    expect(br.bookmark('here')).toBe(br);
-    br.skip(3);
-    expect(br.position).toBe(5);
-    br.seek('here');
-    expect(br.position).toBe(2);
-    expect(br.rewind()).toBe(br);
-    expect(br.position).toBe(0);
-  });
-  it('skips within bounds and aligns', () => {
-    const u8 = new Uint8Array(10);
-    const br = new BinaryReader(u8);
-    br.seek(3);
-    br.align(4);
-    expect(br.position).toBe(4);
-    br.align(4);
-    expect(br.position).toBe(4);
-    br.seek(9);
-    br.skip(5); // should clamp at end
-    expect(br.position).toBe(10);
-  });
-});
-describe('Buffer Access', () => {
-  it('peeks and reads byte ranges', () => {
-    const u8 = new Uint8Array([10, 20, 30, 40]);
-    const br = new BinaryReader(u8);
-    const peek2 = br.peekBytes(2)!;
-    expect(peek2.byteLength).toBe(2);
-    expect(Array.from(new Uint8Array(peek2))).toEqual([10, 20]);
-    expect(br.position).toBe(0);
-    const read2 = br.readBytes(2)!;
-    expect(read2.byteLength).toBe(2);
-    expect(Array.from(new Uint8Array(read2))).toEqual([10, 20]);
-    expect(br.position).toBe(2);
-    const readRemain = br.readBytes();
-    expect(readRemain).toBeDefined();
-    expect(readRemain!.byteLength).toBe(2);
-    expect(Array.from(new Uint8Array(readRemain!))).toEqual([30, 40]);
-    expect(br.position).toBe(4);
-  });
-});
-describe('Construction', () => {
-  it('handles views with offsets', () => {
-    const base = new Uint8Array([99, 1, 2, 3, 4, 100]);
-    const view = base.subarray(1, 5); // [1,2,3,4]
-    const br = new BinaryReader(view);
-    expect(br.size).toBe(4);
-    expect(br.readUint8()).toBe(1);
-    expect(br.readUint8()).toBe(2);
-    expect(br.readUint8()).toBe(3);
-    expect(br.readUint8()).toBe(4);
-    expect(br.eof()).toBe(true);
-  });
-});
-describe('Unsigned Integers', () => {
-  it('reads big-endian by default', () => {
-    const bytes = new Uint8Array([
-      0xab, // u8
-      0x12,
-      0x34, // u16 BE = 0x1234
-      0x89,
-      0xab,
-      0xcd,
-      0xef, // u32 BE = 0x89ABCDEF
-      0x01,
-      0x02,
-      0x03,
-      0x04,
-      0x05,
-      0x06,
-      0x07,
-      0x08, // u64 BE = 0x0102030405060708n
-    ]);
-    const br = new BinaryReader(bytes);
-    expect(br.readUint8()).toBe(0xab);
-    expect(br.readUint16be()).toBe(0x1234);
-    expect(br.readUint32be()).toBe(0x89abcdef);
-    expect(br.readUint64be()).toBe(0x0102030405060708n);
-    // Default endianness (no explicit arg, no option) should be big-endian.
-    const be16 = new BinaryReader(new Uint8Array([0x12, 0x34]));
-    expect(be16.readUint16()).toBe(0x1234);
-    const be32 = new BinaryReader(new Uint8Array([0x89, 0xab, 0xcd, 0xef]));
-    expect(be32.readUint32()).toBe(0x89abcdef);
-    const be64 = new BinaryReader(new Uint8Array([0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08]));
-    expect(be64.readUint64()).toBe(0x0102030405060708n);
-  });
-  it('reads little-endian when defaulted via options', () => {
-    const bytesLE = new Uint8Array([
-      0x34,
-      0x12, // 0x1234
-      0xef,
-      0xcd,
-      0xab,
-      0x89, // 0x89ABCDEF
-      0x08,
-      0x07,
-      0x06,
-      0x05,
-      0x04,
-      0x03,
-      0x02,
-      0x01, // 0x0102030405060708n
-    ]);
-    const br = new BinaryReader(bytesLE, { littleEndian: true });
-    expect(br.readUint16()).toBe(0x1234);
-    expect(br.readUint32()).toBe(0x89abcdef);
-    expect(br.readUint64()).toBe(0x0102030405060708n);
-  });
-  it('overrides default endianness explicitly', () => {
-    const bytes = new Uint8Array([0x34, 0x12]);
-    const br = new BinaryReader(bytes, { littleEndian: true });
-    expect(br.readUint16(false)).toBe(0x3412); // force BE
-  });
-});
-describe('Signed Integers', () => {
-  it('reads signed 8/16/32/64', () => {
-    // For signed tests, craft BE values
-    const bytes = new Uint8Array([
-      0xfe, // int8 = -2
-      0xff,
-      0xfe, // int16 = -2
-      0xff,
-      0xff,
-      0xff,
-      0xfe, // int32 = -2
-      0xff,
-      0xff,
-      0xff,
-      0xff,
-      0xff,
-      0xff,
-      0xff,
-      0xfe, // int64 = -2n
-    ]);
-    const br = new BinaryReader(bytes);
-    expect(br.readInt8()).toBe(-2);
-    expect(br.readInt16()).toBe(-2);
-    expect(br.readInt32()).toBe(-2);
-    expect(br.readInt64()).toBe(-2n);
-  });
-  it('reads signed via LE/BE methods', () => {
-    // int16le(-2) bytes: 0xFE 0xFF
-    const br16 = new BinaryReader(new Uint8Array([0xfe, 0xff]));
-    expect(br16.readInt16le()).toBe(-2);
-    // int32be(-2) bytes: 0xFF 0xFF 0xFF 0xFE
-    const br32 = new BinaryReader(new Uint8Array([0xff, 0xff, 0xff, 0xfe]));
-    expect(br32.readInt32be()).toBe(-2);
-    // int64le(-2n) bytes: 0xFE 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF
-    const br64 = new BinaryReader(new Uint8Array([0xfe, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff]));
-    expect(br64.readInt64le()).toBe(-2n);
-  });
-});
-describe('Floating Point', () => {
-  it('reads float32/float64', () => {
-    // BE: float32(1.0) = 0x3F800000, float64(1.5) = 0x3FF8000000000000
-    const bytes = new Uint8Array([0x3f, 0x80, 0x00, 0x00, 0x3f, 0xf8, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00]);
-    const br = new BinaryReader(bytes);
-    expect(br.readFloat32()).toBeCloseTo(1.0);
-    expect(br.readFloat64()).toBeCloseTo(1.5);
-  });
-  it('reads float32/64 via LE/BE methods', () => {
-    // float32(1.0) LE = 00 00 80 3F
-    const br32le = new BinaryReader(new Uint8Array([0x00, 0x00, 0x80, 0x3f]));
-    expect(br32le.readFloat32le()).toBeCloseTo(1.0);
-    // float64(1.5) BE = 3F F8 00 00 00 00 00 00
-    const br64be = new BinaryReader(new Uint8Array([0x3f, 0xf8, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00]));
-    expect(br64be.readFloat64be()).toBeCloseTo(1.5);
-  });
-});
-describe('Strings', () => {
-  it('reads fixed-length strings', () => {
-    const bytes = new TextEncoder().encode('Hi!');
-    const br = new BinaryReader(bytes);
-    const s = br.readString(2);
-    expect(s).toBe('Hi');
-    expect(br.position).toBe(2);
-  });
-  it('reads a C-string and consumes NUL', () => {
-    const bytes = new Uint8Array([...new TextEncoder().encode('Hi'), 0x00, 0x41]);
-    const br = new BinaryReader(bytes);
-    const s = br.readString();
-    expect(s).toBe('Hi');
-    // should consume terminating null as well
-    expect(br.position).toBe(3);
-    // Next byte should be 'A'
-    expect(br.readUint8()).toBe(0x41);
-  });
-  it('returns undefined and does not advance when C-string has no terminator', () => {
-    const bytes = new TextEncoder().encode('NoTerminator');
-    const br = new BinaryReader(bytes);
-    const s = br.readString();
-    expect(s).toBeUndefined();
-    expect(br.position).toBe(0);
-  });
-  it('returns undefined and does not advance when oversize', () => {
-    const bytes = new TextEncoder().encode('Hi');
-    const br = new BinaryReader(bytes);
-    const s = br.readString(5);
-    expect(s).toBeUndefined();
-    expect(br.position).toBe(0);
-  });
-});
-describe('Construction - more', () => {
-  it('reads from ArrayBuffer', () => {
-    const buf = new Uint8Array([1, 2, 3, 4]).buffer;
-    const br = new BinaryReader(buf);
-    expect(br.readUint8()).toBe(1);
-    expect(br.readUint8()).toBe(2);
-    expect(br.readUint8()).toBe(3);
-    expect(br.readUint8()).toBe(4);
-    expect(br.eof()).toBe(true);
-  });
-  it('reads from Uint8ClampedArray', () => {
-    const clamped = new Uint8ClampedArray([5, 6, 7, 8]);
-    const br = new BinaryReader(clamped);
-    expect(br.size).toBe(4);
-    expect(br.readUint8()).toBe(5);
-    expect(br.readUint8()).toBe(6);
-    expect(br.readUint8()).toBe(7);
-    expect(br.readUint8()).toBe(8);
-    expect(br.eof()).toBe(true);
-  });
-  it('reads from DataView', () => {
-    const u8 = new Uint8Array([9, 10, 11, 12]);
-    const view = new DataView(u8.buffer);
-    const br = new BinaryReader(view);
-    expect(br.readUint8()).toBe(9);
-    expect(br.readUint8()).toBe(10);
-    expect(br.readUint8()).toBe(11);
-    expect(br.readUint8()).toBe(12);
-  });
-});
-describe('Unsigned Integers - more', () => {
-  it('reads uint16/32/64 via little-endian methods', () => {
-    const br16 = new BinaryReader(new Uint8Array([0x34, 0x12]));
-    expect(br16.readUint16le()).toBe(0x1234);
-    const br32 = new BinaryReader(new Uint8Array([0xef, 0xcd, 0xab, 0x89]));
-    expect(br32.readUint32le()).toBe(0x89abcdef);
-    const br64 = new BinaryReader(new Uint8Array([0x08, 0x07, 0x06, 0x05, 0x04, 0x03, 0x02, 0x01]));
-    expect(br64.readUint64le()).toBe(0x0102030405060708n);
-  });
-});
-describe('Buffer Access - more', () => {
-  it('returns remain when peekBytes length omitted', () => {
-    const u8 = new Uint8Array([1, 2, 3, 4, 5]);
-    const br = new BinaryReader(u8);
-    br.seek(2);
-    const buf = br.peekBytes();
-    expect(buf.byteLength).toBe(3);
-    expect(Array.from(new Uint8Array(buf))).toEqual([3, 4, 5]);
-    expect(br.position).toBe(2);
-  });
-  it('clamps oversize readBytes to remain and advances to end', () => {
-    const u8 = new Uint8Array([1, 2, 3, 4, 5]);
-    const br = new BinaryReader(u8);
-    br.seek(1);
-    const buf = br.readBytes(999)!;
-    expect(buf.byteLength).toBe(4);
-    expect(Array.from(new Uint8Array(buf))).toEqual([2, 3, 4, 5]);
-    expect(br.position).toBe(5);
-  });
-});
-describe('Floating Point - float16', () => {
-  if ('getFloat16' in DataView.prototype) {
-    it('reads float16 (if supported)', () => {
-      // 1.0 in IEEE 754 half precision = 0x3C00
-      const bytes = new Uint8Array([0x3c, 0x00]);
-      const br = new BinaryReader(bytes);
-      expect(br.readFloat16()).toBeCloseTo(1.0);
-    });
-    it('reads float16 via LE/BE methods (if supported)', () => {
-      // 1.0 in IEEE 754 half precision = 0x3C00
-      const brLE = new BinaryReader(new Uint8Array([0x00, 0x3c]));
-      expect(brLE.readFloat16le()).toBeCloseTo(1.0);
-      const brBE = new BinaryReader(new Uint8Array([0x3c, 0x00]));
-      expect(brBE.readFloat16be()).toBeCloseTo(1.0);
-    });
-  } else {
-    it.skip('float16 (not supported in this runtime)', () => {});
-  }
-});
-describe('Strings - more', () => {
-  it('returns empty and does not advance with len=0', () => {
-    const bytes = new TextEncoder().encode('Hi');
-    const br = new BinaryReader(bytes);
-    const s = br.readString(0);
-    expect(s).toBe('');
-    expect(br.position).toBe(0);
-  });
-  it('consumes NUL when C-string is empty at start', () => {
-    const bytes = new Uint8Array([0x00, 0x41]);
-    const br = new BinaryReader(bytes);
-    const s = br.readString();
-    expect(s).toBe('');
-    expect(br.position).toBe(1);
-    expect(br.readUint8()).toBe(0x41);
-  });
-  it('returns undefined and does not advance on partial UTF-8', () => {
-    const bytes = new TextEncoder().encode('あ'); // 3 bytes in UTF-8
-    const br = new BinaryReader(bytes);
-    const s = br.readString(2);
-    expect(s).toBeUndefined();
-    expect(br.position).toBe(0);
-  });
-  it('decodes multibyte when length matches exactly', () => {
-    const bytes = new TextEncoder().encode('あ');
-    const br = new BinaryReader(bytes);
-    const s = br.readString(3);
-    expect(s).toBe('あ');
-    expect(br.position).toBe(3);
-  });
-  it('decodes utf-16le when supported by TextDecoder', () => {
-    // 'A' in UTF-16LE is [0x41, 0x00]
-    const bytes = new Uint8Array([0x41, 0x00]);
-    const br = new BinaryReader(bytes);
-    const s = br.readString(2, 'utf-16le');
-    // Some runtimes may not support utf-16le and return undefined
-    if (s !== undefined) {
-      expect(s).toBe('A');
-      expect(br.position).toBe(2);
-    } else {
-      expect(br.position).toBe(0);
-    }
-  });
-});
-describe('Bounds and Errors', () => {
-  it('throws on read beyond end (Uint16)', () => {
-    const br = new BinaryReader(new Uint8Array([0x01]));
-    expect(() => br.readUint16()).toThrow(RangeError);
-  });
-  it('throws on read beyond end (Float64)', () => {
-    const br = new BinaryReader(new Uint8Array([0x00, 0x00, 0x00]));
-    expect(() => br.readFloat64()).toThrow(RangeError);
-  });
-  it('throws on seek to unknown bookmark and leaves position unchanged', () => {
-    const br = new BinaryReader(new Uint8Array([1, 2, 3]));
-    br.seek(2);
-    expect(() => br.seek('nope')).toThrow(Error);
-    expect(br.position).toBe(2);
-  });
-  it('clamps negative seek to 0', () => {
-    const br = new BinaryReader(new Uint8Array([1, 2, 3]));
-    br.seek(-1 as unknown as number);
-    expect(br.position).toBe(0);
-    expect(br.readUint8()).toBe(1);
-  });
-  it('advances by 1 on default skip and stays at end', () => {
-    const br = new BinaryReader(new Uint8Array([1]));
-    expect(br.position).toBe(0);
-    br.skip();
-    expect(br.position).toBe(1);
-    br.skip(); // already at end
-    expect(br.position).toBe(1);
-  });
-});
-describe('Alignment', () => {
-  it('throws on non-positive alignment (0)', () => {
-    const br = new BinaryReader(new Uint8Array([1, 2, 3]));
-    // @ts-expect-error runtime should throw RangeError
-    expect(() => br.align(0)).toThrow(RangeError);
-  });
-  it('throws on non-positive alignment (negative)', () => {
-    const br = new BinaryReader(new Uint8Array([1, 2, 3]));
-    // @ts-expect-error runtime should throw RangeError
-    expect(() => br.align(-4)).toThrow(RangeError);
-  });
-});
-describe('Specific endianness methods', () => {
-  it('reads int16be as expected', () => {
-    const br = new BinaryReader(new Uint8Array([0xff, 0xfe])); // -2
-    expect(br.readInt16be()).toBe(-2);
-  });
-  it('reads int32le as expected', () => {
-    // -2 in LE: fe ff ff ff
-    const br = new BinaryReader(new Uint8Array([0xfe, 0xff, 0xff, 0xff]));
-    expect(br.readInt32le()).toBe(-2);
-  });
-  it('reads int64be as expected', () => {
-    // -2n in BE
-    const br = new BinaryReader(new Uint8Array([0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xfe]));
-    expect(br.readInt64be()).toBe(-2n);
-  });
-  it('reads float32be as expected', () => {
-    // 1.0 BE: 3f 80 00 00
-    const br = new BinaryReader(new Uint8Array([0x3f, 0x80, 0x00, 0x00]));
-    expect(br.readFloat32be()).toBeCloseTo(1.0);
-  });
-  it('reads float64le as expected', () => {
-    // 1.5 LE: 00 00 00 00 00 00 f8 3f
-    const br = new BinaryReader(new Uint8Array([0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xf8, 0x3f]));
-    expect(br.readFloat64le()).toBeCloseTo(1.5);
-  });
-});

package/tsconfig.json DELETED Viewed

	@@ -1 +0,0 @@
1	- { "extends": "../../tsconfig.common.json" }