t2-demo-parser 2.1.0 → 3.0.0

package/dist/BitWriter.js

@@ -0,0 +1,76 @@
+import { huffProcessor } from "./HuffmanProcessor.js";
+/**
+ * LSB-first bit packer producing buffers that BitStream reads back
+ * bit-for-bit. Mirrors the write side of the engine's BitStream for the
+ * primitives the parser consumes; intended for building test vectors and
+ * synthetic packets.
+ */
+export class BitWriter {
+    bytes = [];
+    bitNum = 0;
+    getCurPos() {
+        return this.bitNum;
+    }
+    writeFlag(value) {
+        return this.writeInt(value ? 1 : 0, 1);
+    }
+    /** Write the low `bitCount` bits of `value` (up to 32), LSB first. */
+    writeInt(value, bitCount) {
+        if (!(bitCount >= 0 && bitCount <= 32)) {
+            throw new RangeError(`writeInt bitCount out of range: ${bitCount}`);
+        }
+        for (let i = 0; i < bitCount; i++) {
+            const byteIndex = this.bitNum >> 3;
+            this.bytes[byteIndex] ??= 0;
+            // Use arithmetic on the float64 value so bit 31 works for values
+            // above 2^31 - 1.
+            const bit = Math.floor(value / 2 ** i) % 2 !== 0 ? 1 : 0;
+            this.bytes[byteIndex] |= bit << (this.bitNum & 7);
+            this.bitNum++;
+        }
+        return this;
+    }
+    writeSignedInt(value, bitCount) {
+        this.writeFlag(value < 0);
+        return this.writeInt(Math.abs(value), bitCount - 1);
+    }
+    writeU8(value) {
+        return this.writeInt(value & 0xff, 8);
+    }
+    writeU32(value) {
+        return this.writeInt(value >>> 0, 32);
+    }
+    writeS32(value) {
+        return this.writeInt(value >>> 0, 32);
+    }
+    writeF32(value) {
+        const view = new DataView(new ArrayBuffer(4));
+        view.setFloat32(0, value, true);
+        return this.writeInt(view.getUint32(0, true), 32);
+    }
+    /** Write a float in [0, 1] quantized to `bitCount` bits. */
+    writeFloat(value, bitCount) {
+        return this.writeInt(Math.round(value * (2 ** bitCount - 1)), bitCount);
+    }
+    writeBytes(bytes) {
+        for (let i = 0; i < bytes.length; i++)
+            this.writeU8(bytes[i]);
+        return this;
+    }
+    /** Write a Huffman string exactly as the engine's writeString does
+     *  (no string-buffer prefix optimization). */
+    writeString(value) {
+        huffProcessor.writeHuffBuffer(this, value);
+        return this;
+    }
+    /** Pad to a byte boundary (plus optional extra zero bytes) and return
+     *  the packed buffer. */
+    finish(padBytes = 0) {
+        const total = ((this.bitNum + 7) >> 3) + padBytes;
+        const out = new Uint8Array(total);
+        for (let i = 0; i < this.bytes.length; i++)
+            out[i] = this.bytes[i];
+        return out;
+    }
+}
+//# sourceMappingURL=BitWriter.js.map

package/dist/BitWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitWriter.js","sourceRoot":"","sources":["../src/BitWriter.ts"],"names":[],"mappings":"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","sourcesContent":["import { huffProcessor } from \"./HuffmanProcessor.js\";\n\n/**\n * LSB-first bit packer producing buffers that BitStream reads back\n * bit-for-bit. Mirrors the write side of the engine's BitStream for the\n * primitives the parser consumes; intended for building test vectors and\n * synthetic packets.\n */\nexport class BitWriter {\n  private bytes: number[] = [];\n  private bitNum = 0;\n\n  getCurPos(): number {\n    return this.bitNum;\n  }\n\n  writeFlag(value: boolean): this {\n    return this.writeInt(value ? 1 : 0, 1);\n  }\n\n  /** Write the low `bitCount` bits of `value` (up to 32), LSB first. */\n  writeInt(value: number, bitCount: number): this {\n    if (!(bitCount >= 0 && bitCount <= 32)) {\n      throw new RangeError(`writeInt bitCount out of range: ${bitCount}`);\n    }\n    for (let i = 0; i < bitCount; i++) {\n      const byteIndex = this.bitNum >> 3;\n      this.bytes[byteIndex] ??= 0;\n      // Use arithmetic on the float64 value so bit 31 works for values\n      // above 2^31 - 1.\n      const bit = Math.floor(value / 2 ** i) % 2 !== 0 ? 1 : 0;\n      this.bytes[byteIndex] |= bit << (this.bitNum & 7);\n      this.bitNum++;\n    }\n    return this;\n  }\n\n  writeSignedInt(value: number, bitCount: number): this {\n    this.writeFlag(value < 0);\n    return this.writeInt(Math.abs(value), bitCount - 1);\n  }\n\n  writeU8(value: number): this {\n    return this.writeInt(value & 0xff, 8);\n  }\n\n  writeU32(value: number): this {\n    return this.writeInt(value >>> 0, 32);\n  }\n\n  writeS32(value: number): this {\n    return this.writeInt(value >>> 0, 32);\n  }\n\n  writeF32(value: number): this {\n    const view = new DataView(new ArrayBuffer(4));\n    view.setFloat32(0, value, true);\n    return this.writeInt(view.getUint32(0, true), 32);\n  }\n\n  /** Write a float in [0, 1] quantized to `bitCount` bits. */\n  writeFloat(value: number, bitCount: number): this {\n    return this.writeInt(Math.round(value * (2 ** bitCount - 1)), bitCount);\n  }\n\n  writeBytes(bytes: ArrayLike<number>): this {\n    for (let i = 0; i < bytes.length; i++) this.writeU8(bytes[i]);\n    return this;\n  }\n\n  /** Write a Huffman string exactly as the engine's writeString does\n   *  (no string-buffer prefix optimization). */\n  writeString(value: string): this {\n    huffProcessor.writeHuffBuffer(this, value);\n    return this;\n  }\n\n  /** Pad to a byte boundary (plus optional extra zero bytes) and return\n   *  the packed buffer. */\n  finish(padBytes = 0): Uint8Array {\n    const total = ((this.bitNum + 7) >> 3) + padBytes;\n    const out = new Uint8Array(total);\n    for (let i = 0; i < this.bytes.length; i++) out[i] = this.bytes[i];\n    return out;\n  }\n}\n"]}

package/dist/ClassRegistry.d.ts

@@ -22,8 +22,6 @@ export interface ConnectionContext {
     getDataBlockParser?: (classId: number) => DataBlockParserEntry | undefined;
     getDataBlockData?: (objectId: number) => ParsedData | undefined;
     getGhostParser?: (classId: number) => GhostParserEntry | undefined;
-    /** Ghost index of the ghost currently being parsed (set per-ghost in readGhosts). */
-    currentGhostIndex?: number;
 }
 /** Minimal interface for ghost tracker used by parsers. */
 export interface GhostTrackerInterface {
@@ -32,7 +30,6 @@ export interface GhostTrackerInterface {
 export interface GhostEntry {
     classId: number;
     className: string;
-    state: ParsedData;
 }
 export interface GhostParserEntry {
     name: string;
@@ -54,38 +51,30 @@ export interface DataBlockParserEntry {
  * via bindDeterministicGhosts/Events/DataBlocks.
  */
 export declare class ClassRegistry {
-    private eventParsers;
-    private ghostParsers;
-    private dataBlockParsers;
-    private eventCatalog;
-    private ghostCatalog;
-    private dataBlockCatalog;
-    catalogEvent(entry: EventParserEntry): void;
-    catalogGhost(entry: GhostParserEntry): void;
-    catalogDataBlock(entry: DataBlockParserEntry): void;
-    /**
-     * Bind all DataBlock parsers deterministically using the known class name
-     * mapping. For each class name in the sorted list, if we have a parser
-     * in the catalog, bind it to classId = DataBlockClassFirst + index.
-     */
+    private events;
+    private ghosts;
+    private dataBlocks;
+    catalogEvent<T extends EventData>(entry: {
+        name: string;
+        unpack: (bs: BitStream, conn: ConnectionContext) => T;
+    }): void;
+    catalogGhost<T extends object, P extends object = ParsedData>(entry: {
+        name: string;
+        unpackUpdate: (bs: BitStream, isInitial: boolean, conn: ConnectionContext) => T;
+        readPacketData?: (bs: BitStream, conn: ConnectionContext) => P;
+    }): void;
+    catalogDataBlock<T extends object>(entry: {
+        name: string;
+        unpackData: (bs: BitStream) => T;
+    }): void;
     bindDeterministicDataBlocks(classNames: readonly string[], classFirst: number): {
         bound: number;
         missing: string[];
     };
-    /**
-     * Bind all event (NetEvent) parsers deterministically using the known
-     * class name mapping. For each class name in the sorted list, if we have
-     * a parser in the catalog, bind it to classId = classFirst + index.
-     */
     bindDeterministicEvents(classNames: readonly string[], classFirst: number): {
         bound: number;
         missing: string[];
     };
-    /**
-     * Bind all ghost (NetObject) parsers deterministically using the known
-     * class name mapping. For each class name in the sorted list, if we have
-     * a parser in the catalog, bind it to classId = classFirst + index.
-     */
     bindDeterministicGhosts(classNames: readonly string[], classFirst: number): {
         bound: number;
         missing: string[];
@@ -93,8 +82,14 @@ export declare class ClassRegistry {
     getEventParser(classId: number): EventParserEntry | undefined;
     getGhostParser(classId: number): GhostParserEntry | undefined;
     getDataBlockParser(classId: number): DataBlockParserEntry | undefined;
-    getGhostCatalog(): Map<string, GhostParserEntry>;
+    getEventClassId(name: string): number | undefined;
+    getGhostClassId(name: string): number | undefined;
+    getDataBlockClassId(name: string): number | undefined;
+    getEventCatalog(): ReadonlyMap<string, EventParserEntry>;
+    getGhostCatalog(): ReadonlyMap<string, GhostParserEntry>;
+    getDataBlockCatalog(): ReadonlyMap<string, DataBlockParserEntry>;
     getEventBindings(): Map<number, string>;
     getGhostBindings(): Map<number, string>;
+    getDataBlockBindings(): Map<number, string>;
 }
 //# sourceMappingURL=ClassRegistry.d.ts.map

package/dist/ClassRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClassRegistry.d.ts","sourceRoot":"","sources":["../src/ClassRegistry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ClassRegistry.d.ts","sourceRoot":"","sources":["../src/ClassRegistry.ts"],"names":[],"mappings":"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"}

package/dist/ClassRegistry.js

@@ -1,3 +1,34 @@
+function newCatalog() {
+    return { byName: new Map(), byClassId: new Map(), classIdByName: new Map() };
+}
+/**
+ * Bind every cataloged parser whose name appears in `classNames` to
+ * classId = classFirst + index. Names without a parser are reported.
+ */
+function bindCatalog(catalog, classNames, classFirst) {
+    let bound = 0;
+    const missing = [];
+    for (let i = 0; i < classNames.length; i++) {
+        const name = classNames[i];
+        const entry = catalog.byName.get(name);
+        if (entry) {
+            catalog.byClassId.set(classFirst + i, entry);
+            catalog.classIdByName.set(name, classFirst + i);
+            bound++;
+        }
+        else {
+            missing.push(name);
+        }
+    }
+    return { bound, missing };
+}
+function bindingsOf(catalog) {
+    const bindings = new Map();
+    for (const [id, entry] of catalog.byClassId) {
+        bindings.set(id, entry.name);
+    }
+    return bindings;
+}
 /**
  * Registry mapping classIds to parser functions.
  * ClassIds are assigned deterministically by alphabetical sort (C strcmp)
@@ -5,114 +36,74 @@
  * via bindDeterministicGhosts/Events/DataBlocks.
  */
 export class ClassRegistry {
-    eventParsers = new Map();
-    ghostParsers = new Map();
-    dataBlockParsers = new Map();
-    // Named parser catalog (classId-independent)
-    eventCatalog = new Map();
-    ghostCatalog = new Map();
-    dataBlockCatalog = new Map();
+    events = newCatalog();
+    ghosts = newCatalog();
+    dataBlocks = newCatalog();
     // --- Catalog registration (name → parser, no classId yet) ---
+    //
+    // Parsers return precisely typed objects (PlayerGhostData, ...), which
+    // are stored behind the generic ParsedData shape. The generic signatures
+    // let each parser keep its own return type — so a misspelled field is a
+    // compile error inside the parser — while the registry erases it.
     catalogEvent(entry) {
-        this.eventCatalog.set(entry.name, entry);
+        this.events.byName.set(entry.name, entry);
     }
     catalogGhost(entry) {
-        this.ghostCatalog.set(entry.name, entry);
+        this.ghosts.byName.set(entry.name, entry);
     }
     catalogDataBlock(entry) {
-        this.dataBlockCatalog.set(entry.name, entry);
+        this.dataBlocks.byName.set(entry.name, entry);
     }
-    /**
-     * Bind all DataBlock parsers deterministically using the known class name
-     * mapping. For each class name in the sorted list, if we have a parser
-     * in the catalog, bind it to classId = DataBlockClassFirst + index.
-     */
+    // --- Deterministic binding (classId = classFirst + index in the sorted
+    //     class name list) ---
     bindDeterministicDataBlocks(classNames, classFirst) {
-        let bound = 0;
-        const missing = [];
-        for (let i = 0; i < classNames.length; i++) {
-            const name = classNames[i];
-            const entry = this.dataBlockCatalog.get(name);
-            if (entry) {
-                this.dataBlockParsers.set(classFirst + i, entry);
-                bound++;
-            }
-            else {
-                missing.push(name);
-            }
-        }
-        return { bound, missing };
+        return bindCatalog(this.dataBlocks, classNames, classFirst);
     }
-    /**
-     * Bind all event (NetEvent) parsers deterministically using the known
-     * class name mapping. For each class name in the sorted list, if we have
-     * a parser in the catalog, bind it to classId = classFirst + index.
-     */
     bindDeterministicEvents(classNames, classFirst) {
-        let bound = 0;
-        const missing = [];
-        for (let i = 0; i < classNames.length; i++) {
-            const name = classNames[i];
-            const entry = this.eventCatalog.get(name);
-            if (entry) {
-                this.eventParsers.set(classFirst + i, entry);
-                bound++;
-            }
-            else {
-                missing.push(name);
-            }
-        }
-        return { bound, missing };
+        return bindCatalog(this.events, classNames, classFirst);
     }
-    /**
-     * Bind all ghost (NetObject) parsers deterministically using the known
-     * class name mapping. For each class name in the sorted list, if we have
-     * a parser in the catalog, bind it to classId = classFirst + index.
-     */
     bindDeterministicGhosts(classNames, classFirst) {
-        let bound = 0;
-        const missing = [];
-        for (let i = 0; i < classNames.length; i++) {
-            const name = classNames[i];
-            const entry = this.ghostCatalog.get(name);
-            if (entry) {
-                this.ghostParsers.set(classFirst + i, entry);
-                bound++;
-            }
-            else {
-                missing.push(name);
-            }
-        }
-        return { bound, missing };
+        return bindCatalog(this.ghosts, classNames, classFirst);
     }
-    // --- Lookup ---
+    // --- Lookup by classId ---
     getEventParser(classId) {
-        return this.eventParsers.get(classId);
+        return this.events.byClassId.get(classId);
     }
     getGhostParser(classId) {
-        return this.ghostParsers.get(classId);
+        return this.ghosts.byClassId.get(classId);
     }
     getDataBlockParser(classId) {
-        return this.dataBlockParsers.get(classId);
+        return this.dataBlocks.byClassId.get(classId);
+    }
+    // --- Lookup by class name (bound classId) ---
+    getEventClassId(name) {
+        return this.events.classIdByName.get(name);
+    }
+    getGhostClassId(name) {
+        return this.ghosts.classIdByName.get(name);
+    }
+    getDataBlockClassId(name) {
+        return this.dataBlocks.classIdByName.get(name);
+    }
+    // --- Catalog access (name → parser, independent of binding) ---
+    getEventCatalog() {
+        return this.events.byName;
     }
-    // --- Catalog access ---
     getGhostCatalog() {
-        return this.ghostCatalog;
+        return this.ghosts.byName;
+    }
+    getDataBlockCatalog() {
+        return this.dataBlocks.byName;
     }
-    // --- Debug ---
+    // --- Debug: classId → parser name ---
     getEventBindings() {
-        const bindings = new Map();
-        for (const [id, entry] of this.eventParsers) {
-            bindings.set(id, entry.name);
-        }
-        return bindings;
+        return bindingsOf(this.events);
     }
     getGhostBindings() {
-        const bindings = new Map();
-        for (const [id, entry] of this.ghostParsers) {
-            bindings.set(id, entry.name);
-        }
-        return bindings;
+        return bindingsOf(this.ghosts);
+    }
+    getDataBlockBindings() {
+        return bindingsOf(this.dataBlocks);
     }
 }
 //# sourceMappingURL=ClassRegistry.js.map

package/dist/ClassRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"ClassRegistry.js","sourceRoot":"","sources":["../src/ClassRegistry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BitStream } from \"./BitStream.js\";\nimport type { EventData } from \"./eventDataTypes.js\";\n\n/**\n * Base type for all parsed data objects. Individual parsers return more\n * specific interfaces, but the registry stores them generically.\n */\nexport type ParsedData = { [key: string]: unknown };\n\n// --- Parser function signatures ---\n\nexport type EventParser = (\n  bs: BitStream,\n  conn: ConnectionContext\n) => EventData;\n\nexport type GhostUpdateParser = (\n  bs: BitStream,\n  isInitial: boolean,\n  conn: ConnectionContext\n) => ParsedData;\n\nexport type GhostPacketDataParser = (\n  bs: BitStream,\n  conn: ConnectionContext\n) => ParsedData;\n\nexport type DataBlockParser = (\n  bs: BitStream\n) => ParsedData;\n\n/** Shared context passed to parsers from the connection state. */\nexport interface ConnectionContext {\n  compressionPoint: { x: number; y: number; z: number };\n  ghostTracker: GhostTrackerInterface;\n  getDataBlockParser?: (classId: number) => DataBlockParserEntry | undefined;\n  getDataBlockData?: (objectId: number) => ParsedData | undefined;\n  getGhostParser?: (classId: number) => GhostParserEntry | undefined;\n  /** Ghost index of the ghost currently being parsed (set per-ghost in readGhosts). */\n  currentGhostIndex?: number;\n}\n\n/** Minimal interface for ghost tracker used by parsers. */\nexport interface GhostTrackerInterface {\n  getGhost(index: number): GhostEntry | undefined;\n}\n\nexport interface GhostEntry {\n  classId: number;\n  className: string;\n  state: ParsedData;\n}\n\nexport interface GhostParserEntry {\n  name: string;\n  unpackUpdate: GhostUpdateParser;\n  readPacketData?: GhostPacketDataParser;\n}\n\nexport interface EventParserEntry {\n  name: string;\n  unpack: EventParser;\n}\n\nexport interface DataBlockParserEntry {\n  name: string;\n  unpackData: DataBlockParser;\n}\n\n/**\n * Registry mapping classIds to parser functions.\n * ClassIds are assigned deterministically by alphabetical sort (C strcmp)\n * at engine link time. Parsers are cataloged by name and bound to classIds\n * via bindDeterministicGhosts/Events/DataBlocks.\n */\nexport class ClassRegistry {\n  private eventParsers = new Map<number, EventParserEntry>();\n  private ghostParsers = new Map<number, GhostParserEntry>();\n  private dataBlockParsers = new Map<number, DataBlockParserEntry>();\n\n  // Named parser catalog (classId-independent)\n  private eventCatalog = new Map<string, EventParserEntry>();\n  private ghostCatalog = new Map<string, GhostParserEntry>();\n  private dataBlockCatalog = new Map<string, DataBlockParserEntry>();\n\n  // --- Catalog registration (name → parser, no classId yet) ---\n\n  catalogEvent(entry: EventParserEntry): void {\n    this.eventCatalog.set(entry.name, entry);\n  }\n\n  catalogGhost(entry: GhostParserEntry): void {\n    this.ghostCatalog.set(entry.name, entry);\n  }\n\n  catalogDataBlock(entry: DataBlockParserEntry): void {\n    this.dataBlockCatalog.set(entry.name, entry);\n  }\n\n  /**\n   * Bind all DataBlock parsers deterministically using the known class name\n   * mapping. For each class name in the sorted list, if we have a parser\n   * in the catalog, bind it to classId = DataBlockClassFirst + index.\n   */\n  bindDeterministicDataBlocks(\n    classNames: readonly string[],\n    classFirst: number\n  ): { bound: number; missing: string[] } {\n    let bound = 0;\n    const missing: string[] = [];\n    for (let i = 0; i < classNames.length; i++) {\n      const name = classNames[i];\n      const entry = this.dataBlockCatalog.get(name);\n      if (entry) {\n        this.dataBlockParsers.set(classFirst + i, entry);\n        bound++;\n      } else {\n        missing.push(name);\n      }\n    }\n    return { bound, missing };\n  }\n\n  /**\n   * Bind all event (NetEvent) parsers deterministically using the known\n   * class name mapping. For each class name in the sorted list, if we have\n   * a parser in the catalog, bind it to classId = classFirst + index.\n   */\n  bindDeterministicEvents(\n    classNames: readonly string[],\n    classFirst: number\n  ): { bound: number; missing: string[] } {\n    let bound = 0;\n    const missing: string[] = [];\n    for (let i = 0; i < classNames.length; i++) {\n      const name = classNames[i];\n      const entry = this.eventCatalog.get(name);\n      if (entry) {\n        this.eventParsers.set(classFirst + i, entry);\n        bound++;\n      } else {\n        missing.push(name);\n      }\n    }\n    return { bound, missing };\n  }\n\n  /**\n   * Bind all ghost (NetObject) parsers deterministically using the known\n   * class name mapping. For each class name in the sorted list, if we have\n   * a parser in the catalog, bind it to classId = classFirst + index.\n   */\n  bindDeterministicGhosts(\n    classNames: readonly string[],\n    classFirst: number\n  ): { bound: number; missing: string[] } {\n    let bound = 0;\n    const missing: string[] = [];\n    for (let i = 0; i < classNames.length; i++) {\n      const name = classNames[i];\n      const entry = this.ghostCatalog.get(name);\n      if (entry) {\n        this.ghostParsers.set(classFirst + i, entry);\n        bound++;\n      } else {\n        missing.push(name);\n      }\n    }\n    return { bound, missing };\n  }\n\n  // --- Lookup ---\n\n  getEventParser(classId: number): EventParserEntry | undefined {\n    return this.eventParsers.get(classId);\n  }\n\n  getGhostParser(classId: number): GhostParserEntry | undefined {\n    return this.ghostParsers.get(classId);\n  }\n\n  getDataBlockParser(classId: number): DataBlockParserEntry | undefined {\n    return this.dataBlockParsers.get(classId);\n  }\n\n  // --- Catalog access ---\n\n  getGhostCatalog(): Map<string, GhostParserEntry> {\n    return this.ghostCatalog;\n  }\n\n  // --- Debug ---\n\n  getEventBindings(): Map<number, string> {\n    const bindings = new Map<number, string>();\n    for (const [id, entry] of this.eventParsers) {\n      bindings.set(id, entry.name);\n    }\n    return bindings;\n  }\n\n  getGhostBindings(): Map<number, string> {\n    const bindings = new Map<number, string>();\n    for (const [id, entry] of this.ghostParsers) {\n      bindings.set(id, entry.name);\n    }\n    return bindings;\n  }\n}\n"]}
+{"version":3,"file":"ClassRegistry.js","sourceRoot":"","sources":["../src/ClassRegistry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BitStream } from \"./BitStream.js\";\nimport type { EventData } from \"./eventDataTypes.js\";\n\n/**\n * Base type for all parsed data objects. Individual parsers return more\n * specific interfaces, but the registry stores them generically.\n */\nexport type ParsedData = { [key: string]: unknown };\n\n// --- Parser function signatures ---\n\nexport type EventParser = (\n  bs: BitStream,\n  conn: ConnectionContext\n) => EventData;\n\nexport type GhostUpdateParser = (\n  bs: BitStream,\n  isInitial: boolean,\n  conn: ConnectionContext\n) => ParsedData;\n\nexport type GhostPacketDataParser = (\n  bs: BitStream,\n  conn: ConnectionContext\n) => ParsedData;\n\nexport type DataBlockParser = (\n  bs: BitStream\n) => ParsedData;\n\n/** Shared context passed to parsers from the connection state. */\nexport interface ConnectionContext {\n  compressionPoint: { x: number; y: number; z: number };\n  ghostTracker: GhostTrackerInterface;\n  getDataBlockParser?: (classId: number) => DataBlockParserEntry | undefined;\n  getDataBlockData?: (objectId: number) => ParsedData | undefined;\n  getGhostParser?: (classId: number) => GhostParserEntry | undefined;\n}\n\n/** Minimal interface for ghost tracker used by parsers. */\nexport interface GhostTrackerInterface {\n  getGhost(index: number): GhostEntry | undefined;\n}\n\nexport interface GhostEntry {\n  classId: number;\n  className: string;\n}\n\nexport interface GhostParserEntry {\n  name: string;\n  unpackUpdate: GhostUpdateParser;\n  readPacketData?: GhostPacketDataParser;\n}\n\nexport interface EventParserEntry {\n  name: string;\n  unpack: EventParser;\n}\n\nexport interface DataBlockParserEntry {\n  name: string;\n  unpackData: DataBlockParser;\n}\n\ninterface Catalog<T extends { name: string }> {\n  byName: Map<string, T>;\n  byClassId: Map<number, T>;\n  classIdByName: Map<string, number>;\n}\n\nfunction newCatalog<T extends { name: string }>(): Catalog<T> {\n  return { byName: new Map(), byClassId: new Map(), classIdByName: new Map() };\n}\n\n/**\n * Bind every cataloged parser whose name appears in `classNames` to\n * classId = classFirst + index. Names without a parser are reported.\n */\nfunction bindCatalog<T extends { name: string }>(\n  catalog: Catalog<T>,\n  classNames: readonly string[],\n  classFirst: number,\n): { bound: number; missing: string[] } {\n  let bound = 0;\n  const missing: string[] = [];\n  for (let i = 0; i < classNames.length; i++) {\n    const name = classNames[i];\n    const entry = catalog.byName.get(name);\n    if (entry) {\n      catalog.byClassId.set(classFirst + i, entry);\n      catalog.classIdByName.set(name, classFirst + i);\n      bound++;\n    } else {\n      missing.push(name);\n    }\n  }\n  return { bound, missing };\n}\n\nfunction bindingsOf<T extends { name: string }>(\n  catalog: Catalog<T>,\n): Map<number, string> {\n  const bindings = new Map<number, string>();\n  for (const [id, entry] of catalog.byClassId) {\n    bindings.set(id, entry.name);\n  }\n  return bindings;\n}\n\n/**\n * Registry mapping classIds to parser functions.\n * ClassIds are assigned deterministically by alphabetical sort (C strcmp)\n * at engine link time. Parsers are cataloged by name and bound to classIds\n * via bindDeterministicGhosts/Events/DataBlocks.\n */\nexport class ClassRegistry {\n  private events = newCatalog<EventParserEntry>();\n  private ghosts = newCatalog<GhostParserEntry>();\n  private dataBlocks = newCatalog<DataBlockParserEntry>();\n\n  // --- Catalog registration (name → parser, no classId yet) ---\n  //\n  // Parsers return precisely typed objects (PlayerGhostData, ...), which\n  // are stored behind the generic ParsedData shape. The generic signatures\n  // let each parser keep its own return type — so a misspelled field is a\n  // compile error inside the parser — while the registry erases it.\n\n  catalogEvent<T extends EventData>(entry: {\n    name: string;\n    unpack: (bs: BitStream, conn: ConnectionContext) => T;\n  }): void {\n    this.events.byName.set(entry.name, entry);\n  }\n\n  catalogGhost<T extends object, P extends object = ParsedData>(entry: {\n    name: string;\n    unpackUpdate: (bs: BitStream, isInitial: boolean, conn: ConnectionContext) => T;\n    readPacketData?: (bs: BitStream, conn: ConnectionContext) => P;\n  }): void {\n    this.ghosts.byName.set(entry.name, entry as unknown as GhostParserEntry);\n  }\n\n  catalogDataBlock<T extends object>(entry: {\n    name: string;\n    unpackData: (bs: BitStream) => T;\n  }): void {\n    this.dataBlocks.byName.set(\n      entry.name,\n      entry as unknown as DataBlockParserEntry,\n    );\n  }\n\n  // --- Deterministic binding (classId = classFirst + index in the sorted\n  //     class name list) ---\n\n  bindDeterministicDataBlocks(\n    classNames: readonly string[],\n    classFirst: number,\n  ): { bound: number; missing: string[] } {\n    return bindCatalog(this.dataBlocks, classNames, classFirst);\n  }\n\n  bindDeterministicEvents(\n    classNames: readonly string[],\n    classFirst: number,\n  ): { bound: number; missing: string[] } {\n    return bindCatalog(this.events, classNames, classFirst);\n  }\n\n  bindDeterministicGhosts(\n    classNames: readonly string[],\n    classFirst: number,\n  ): { bound: number; missing: string[] } {\n    return bindCatalog(this.ghosts, classNames, classFirst);\n  }\n\n  // --- Lookup by classId ---\n\n  getEventParser(classId: number): EventParserEntry | undefined {\n    return this.events.byClassId.get(classId);\n  }\n\n  getGhostParser(classId: number): GhostParserEntry | undefined {\n    return this.ghosts.byClassId.get(classId);\n  }\n\n  getDataBlockParser(classId: number): DataBlockParserEntry | undefined {\n    return this.dataBlocks.byClassId.get(classId);\n  }\n\n  // --- Lookup by class name (bound classId) ---\n\n  getEventClassId(name: string): number | undefined {\n    return this.events.classIdByName.get(name);\n  }\n\n  getGhostClassId(name: string): number | undefined {\n    return this.ghosts.classIdByName.get(name);\n  }\n\n  getDataBlockClassId(name: string): number | undefined {\n    return this.dataBlocks.classIdByName.get(name);\n  }\n\n  // --- Catalog access (name → parser, independent of binding) ---\n\n  getEventCatalog(): ReadonlyMap<string, EventParserEntry> {\n    return this.events.byName;\n  }\n\n  getGhostCatalog(): ReadonlyMap<string, GhostParserEntry> {\n    return this.ghosts.byName;\n  }\n\n  getDataBlockCatalog(): ReadonlyMap<string, DataBlockParserEntry> {\n    return this.dataBlocks.byName;\n  }\n\n  // --- Debug: classId → parser name ---\n\n  getEventBindings(): Map<number, string> {\n    return bindingsOf(this.events);\n  }\n\n  getGhostBindings(): Map<number, string> {\n    return bindingsOf(this.ghosts);\n  }\n\n  getDataBlockBindings(): Map<number, string> {\n    return bindingsOf(this.dataBlocks);\n  }\n}\n"]}

package/dist/DataBlockParsers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataBlockParsers.d.ts","sourceRoot":"","sources":["../src/DataBlockParsers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAqxExD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CA0OtE"}
+{"version":3,"file":"DataBlockParsers.d.ts","sourceRoot":"","sources":["../src/DataBlockParsers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAuwExD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CA0OtE"}