@carbonenginejs/runtime 0.1.0-alpha.0 → 0.1.0-alpha.1

package/dist/resource/format/CjsByteReader.js

@@ -1,49 +1,54 @@
 import { CjsReader } from './CjsReader.js';
-import { CjsFormatReadError } from './CjsFormatError.js';
+import { CjsFormatRangeError } from './CjsFormatError.js';
 import { asUint8Array } from '#utils/bytes';
 
 const textDecoder = new TextDecoder("utf-8", {
   fatal: false
 });
 
-/**
- * Little-endian cursor over resource bytes, with optional string-table arena
- * resolution.
- *
- * This is the shared implementation behind `HlslReader`, `WebglReader`, and
- * the Carbon-effect reader. Specialized readers only
- * replace the error class and the end-of-data message:
- *
- * ```js
- * class MyReader extends CjsByteReader
- * {
- *     static ReadError = MyReadError;
- *     static endOfDataMessage = "Unexpected end of my data";
- * }
- * ```
- *
- * The arena primitives (`ReadString`, `ReadStringAt`, `ReadStringOptional`,
- * `ReadTableBlob`, `ReadTableBlobOptional`) model Carbon's string table, where a
- * single `uint32` offset resolves either to a NUL-terminated string or to a
- * sized blob inside the same arena (`trinity/shadercompiler/StringTable.cpp`).
+/**
+ * Little-endian cursor over resource bytes, with optional string-table arena
+ * resolution.
+ *
+ * This is the shared implementation behind `HlslReader`, `WebglReader`, and
+ * the Carbon-effect reader. Specialized readers only
+ * replace the error class and the end-of-data message:
+ *
+ * ```js
+ * class MyReader extends CjsByteReader
+ * {
+ *     static ReadError = MyReadError;
+ *     static endOfDataMessage = "Unexpected end of my data";
+ * }
+ * ```
+ *
+ * The arena primitives (`ReadString`, `ReadStringAt`, `ReadStringOptional`,
+ * `ReadTableBlob`, `ReadTableBlobOptional`) model Carbon's string table, where a
+ * single `uint32` offset resolves either to a NUL-terminated string or to a
+ * sized blob inside the same arena (`trinity/shadercompiler/StringTable.cpp`).
  */
 class CjsByteReader extends CjsReader {
-  /** Error class raised for out-of-bounds and arena failures. */
-  static ReadError = CjsFormatReadError;
+  /**
+   * Error class raised for out-of-bounds and arena failures.
+   *
+   * A `RangeError` lineage, because that is what running off the end of a
+   * buffer is. See `CjsFormatRangeError`.
+   */
+  static ReadError = CjsFormatRangeError;
 
   /** Message used when a read would run past the configured end. */
   static endOfDataMessage = "Unexpected end of data";
 
-  /**
-   * Creates a reader over a byte payload and optional shared string table.
-   *
-   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Source payload.
-   * @param {object} [options] Reader bounds and metadata.
-   * @param {number} [options.offset] Initial byte offset.
-   * @param {number} [options.end] Exclusive end offset.
-   * @param {string} [options.source] Source name used in error details.
-   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} [options.stringTable] Arena bytes.
-   * @param {number} [options.stringTableSize] Valid arena byte count.
+  /**
+   * Creates a reader over a byte payload and optional shared string table.
+   *
+   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Source payload.
+   * @param {object} [options] Reader bounds and metadata.
+   * @param {number} [options.offset] Initial byte offset.
+   * @param {number} [options.end] Exclusive end offset.
+   * @param {string} [options.source] Source name used in error details.
+   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} [options.stringTable] Arena bytes.
+   * @param {number} [options.stringTableSize] Valid arena byte count.
    */
   constructor(bytes, options = {}) {
     super(options);
@@ -56,41 +61,41 @@ class CjsByteReader extends CjsReader {
     this.stringTableSize = Number.isInteger(options.stringTableSize) ? options.stringTableSize : this.stringTable ? this.stringTable.length : 0;
   }
 
-  /**
-   * Attaches or replaces the string-table arena used by string and blob reads.
-   *
-   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Arena bytes.
-   * @param {number|null} [size] Valid arena byte count.
+  /**
+   * Attaches or replaces the string-table arena used by string and blob reads.
+   *
+   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Arena bytes.
+   * @param {number|null} [size] Valid arena byte count.
    */
   SetStringTable(bytes, size = null) {
     this.stringTable = asUint8Array(bytes);
     this.stringTableSize = Number.isInteger(size) ? size : this.stringTable.length;
   }
 
-  /**
-   * Returns the unread byte count inside the configured reader bounds.
-   *
-   * @returns {number} Remaining bytes.
+  /**
+   * Returns the unread byte count inside the configured reader bounds.
+   *
+   * @returns {number} Remaining bytes.
    */
   get remaining() {
     return this.end - this.offset;
   }
 
-  /**
-   * Advances the reader by a fixed number of bytes.
-   *
-   * @param {number} size Byte count to skip.
+  /**
+   * Advances the reader by a fixed number of bytes.
+   *
+   * @param {number} size Byte count to skip.
    */
   Skip(size) {
     this._require(size);
     this.offset += size;
   }
 
-  /**
-   * Reads a byte range from the main payload.
-   *
-   * @param {number} size Byte count to read.
-   * @returns {Uint8Array} View over the read bytes.
+  /**
+   * Reads a byte range from the main payload.
+   *
+   * @param {number} size Byte count to read.
+   * @returns {Uint8Array} View over the read bytes.
    */
   ReadRaw(size) {
     this._require(size);
@@ -99,10 +104,10 @@ class CjsByteReader extends CjsReader {
     return this.bytes.subarray(start, start + size);
   }
 
-  /**
-   * Reads an unsigned 8-bit integer.
-   *
-   * @returns {number} Integer value.
+  /**
+   * Reads an unsigned 8-bit integer.
+   *
+   * @returns {number} Integer value.
    */
   ReadUint8() {
     this._require(1);
@@ -111,10 +116,10 @@ class CjsByteReader extends CjsReader {
     return value;
   }
 
-  /**
-   * Reads a little-endian unsigned 16-bit integer.
-   *
-   * @returns {number} Integer value.
+  /**
+   * Reads a little-endian unsigned 16-bit integer.
+   *
+   * @returns {number} Integer value.
    */
   ReadUint16() {
     this._require(2);
@@ -123,10 +128,10 @@ class CjsByteReader extends CjsReader {
     return value;
   }
 
-  /**
-   * Reads a little-endian unsigned 32-bit integer.
-   *
-   * @returns {number} Integer value.
+  /**
+   * Reads a little-endian unsigned 32-bit integer.
+   *
+   * @returns {number} Integer value.
    */
   ReadUint32() {
     this._require(4);
@@ -135,10 +140,10 @@ class CjsByteReader extends CjsReader {
     return value;
   }
 
-  /**
-   * Reads a little-endian signed 32-bit integer.
-   *
-   * @returns {number} Integer value.
+  /**
+   * Reads a little-endian signed 32-bit integer.
+   *
+   * @returns {number} Integer value.
    */
   ReadInt32() {
     this._require(4);
@@ -147,10 +152,10 @@ class CjsByteReader extends CjsReader {
     return value;
   }
 
-  /**
-   * Reads a little-endian 32-bit float.
-   *
-   * @returns {number} Float value.
+  /**
+   * Reads a little-endian 32-bit float.
+   *
+   * @returns {number} Float value.
    */
   ReadFloat32() {
     this._require(4);
@@ -159,36 +164,36 @@ class CjsByteReader extends CjsReader {
     return value;
   }
 
-  /**
-   * Reads Carbon's byte-sized boolean encoding.
-   *
-   * @returns {boolean} Boolean value.
+  /**
+   * Reads Carbon's byte-sized boolean encoding.
+   *
+   * @returns {boolean} Boolean value.
    */
   ReadBool() {
     return this.ReadUint8() !== 0;
   }
 
-  /**
-   * Reads a string-table offset and resolves it to a UTF-8 string.
-   *
-   * @param {number} [sizeHint] Optional maximum byte span for bounds checking.
-   * @returns {string} Decoded string.
+  /**
+   * Reads a string-table offset and resolves it to a UTF-8 string.
+   *
+   * @param {number} [sizeHint] Optional maximum byte span for bounds checking.
+   * @returns {string} Decoded string.
    */
   ReadString(sizeHint = 0) {
     const offset = this.ReadUint32();
     return this.ReadStringAt(offset, sizeHint);
   }
 
-  /**
-   * Reads an optional string-table offset, returning null for zero-length fields.
-   *
-   * Carbon consumes the offset word regardless of the length and only
-   * dereferences it when the length is non-zero, which is the single site
-   * where the `0xffffffff` null reference is legal
-   * (`Tr2EffectDescription.cpp:80-91`).
-   *
-   * @param {number} length Source field length.
-   * @returns {string|null} Decoded string or null.
+  /**
+   * Reads an optional string-table offset, returning null for zero-length fields.
+   *
+   * Carbon consumes the offset word regardless of the length and only
+   * dereferences it when the length is non-zero, which is the single site
+   * where the `0xffffffff` null reference is legal
+   * (`Tr2EffectDescription.cpp:80-91`).
+   *
+   * @param {number} length Source field length.
+   * @returns {string|null} Decoded string or null.
    */
   ReadStringOptional(length) {
     const offset = this.ReadUint32();
@@ -198,11 +203,11 @@ class CjsByteReader extends CjsReader {
     return this.ReadStringAt(offset, length);
   }
 
-  /**
-   * Reads a string-table blob offset and returns the referenced byte range.
-   *
-   * @param {number} size Blob byte count.
-   * @returns {{offset:number,bytes:Uint8Array}} Blob location and bytes.
+  /**
+   * Reads a string-table blob offset and returns the referenced byte range.
+   *
+   * @param {number} size Blob byte count.
+   * @returns {{offset:number,bytes:Uint8Array}} Blob location and bytes.
    */
   ReadTableBlob(size) {
     const offset = this.ReadUint32();
@@ -213,11 +218,11 @@ class CjsByteReader extends CjsReader {
     };
   }
 
-  /**
-   * Reads a possibly empty string-table blob reference.
-   *
-   * @param {number} size Blob byte count.
-   * @returns {{offset:number,bytes:Uint8Array}} Blob location and bytes.
+  /**
+   * Reads a possibly empty string-table blob reference.
+   *
+   * @param {number} size Blob byte count.
+   * @returns {{offset:number,bytes:Uint8Array}} Blob location and bytes.
    */
   ReadTableBlobOptional(size) {
     const offset = this.ReadUint32();
@@ -234,12 +239,12 @@ class CjsByteReader extends CjsReader {
     };
   }
 
-  /**
-   * Resolves a string table offset to a null-terminated UTF-8 string.
-   *
-   * @param {number} offset String-table byte offset.
-   * @param {number} [sizeHint] Optional maximum byte span for bounds checking.
-   * @returns {string} Decoded string.
+  /**
+   * Resolves a string table offset to a null-terminated UTF-8 string.
+   *
+   * @param {number} offset String-table byte offset.
+   * @param {number} [sizeHint] Optional maximum byte span for bounds checking.
+   * @returns {string} Decoded string.
    */
   ReadStringAt(offset, sizeHint = 0) {
     this._requireStringTable(offset, sizeHint);
@@ -250,27 +255,27 @@ class CjsByteReader extends CjsReader {
     return textDecoder.decode(this.stringTable.subarray(offset, end));
   }
 
-  /**
-   * Creates this reader's error type with shared reader-state details.
-   *
-   * @param {string} message Human-readable failure reason.
-   * @param {object} [details] Extra reader state.
-   * @returns {Error} Reader-specific error instance.
-   * @protected
+  /**
+   * Creates this reader's error type with shared reader-state details.
+   *
+   * @param {string} message Human-readable failure reason.
+   * @param {object} [details] Extra reader state.
+   * @returns {Error} Reader-specific error instance.
+   * @protected
    */
   _error(message, details = {}) {
-    const ReadError = this.constructor.ReadError ?? CjsFormatReadError;
+    const ReadError = this.constructor.ReadError ?? CjsFormatRangeError;
     return new ReadError(message, {
       source: this.source,
       ...details
     });
   }
 
-  /**
-   * Ensures the requested read fits inside the configured payload bounds.
-   *
-   * @param {number} size Requested byte count.
-   * @private
+  /**
+   * Ensures the requested read fits inside the configured payload bounds.
+   *
+   * @param {number} size Requested byte count.
+   * @private
    */
   _require(size) {
     if (!Number.isInteger(size) || size < 0 || this.offset + size > this.end) {
@@ -282,12 +287,12 @@ class CjsByteReader extends CjsReader {
     }
   }
 
-  /**
-   * Ensures a string-table offset and optional span are valid.
-   *
-   * @param {number} offset String-table byte offset.
-   * @param {number} [sizeHint] Optional byte span for bounds checking.
-   * @private
+  /**
+   * Ensures a string-table offset and optional span are valid.
+   *
+   * @param {number} offset String-table byte offset.
+   * @param {number} [sizeHint] Optional byte span for bounds checking.
+   * @private
    */
   _requireStringTable(offset, sizeHint = 0) {
     const size = Number(sizeHint) || 0;

package/dist/resource/format/CjsByteReader.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsByteReader.js","sources":["../../../../src/resource/format/CjsByteReader.js"],"sourcesContent":["import { CjsReader } from \"./CjsReader.js\";\r\nimport { CjsFormatReadError } from \"./CjsFormatError.js\";\r\nimport { asUint8Array } from \"#utils/bytes\";\r\n\r\nconst textDecoder = new TextDecoder(\"utf-8\", { fatal: false });\r\n\r\n/**\r\n * Little-endian cursor over resource bytes, with optional string-table arena\r\n * resolution.\r\n *\r\n * This is the shared implementation behind `HlslReader`, `WebglReader`, and\r\n * the Carbon-effect reader. Specialized readers only\r\n * replace the error class and the end-of-data message:\r\n *\r\n * ```js\r\n * class MyReader extends CjsByteReader\r\n * {\r\n *     static ReadError = MyReadError;\r\n *     static endOfDataMessage = \"Unexpected end of my data\";\r\n * }\r\n * ```\r\n *\r\n * The arena primitives (`ReadString`, `ReadStringAt`, `ReadStringOptional`,\r\n * `ReadTableBlob`, `ReadTableBlobOptional`) model Carbon's string table, where a\r\n * single `uint32` offset resolves either to a NUL-terminated string or to a\r\n * sized blob inside the same arena (`trinity/shadercompiler/StringTable.cpp`).\r\n */\r\nexport class CjsByteReader extends CjsReader\r\n{\r\n    /** Error class raised for out-of-bounds and arena failures. */\r\n    static ReadError = CjsFormatReadError;\r\n\r\n    /** Message used when a read would run past the configured end. */\r\n    static endOfDataMessage = \"Unexpected end of data\";\r\n\r\n    /**\r\n     * Creates a reader over a byte payload and optional shared string table.\r\n     *\r\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Source payload.\r\n     * @param {object} [options] Reader bounds and metadata.\r\n     * @param {number} [options.offset] Initial byte offset.\r\n     * @param {number} [options.end] Exclusive end offset.\r\n     * @param {string} [options.source] Source name used in error details.\r\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} [options.stringTable] Arena bytes.\r\n     * @param {number} [options.stringTableSize] Valid arena byte count.\r\n     */\r\n    constructor(bytes, options = {})\r\n    {\r\n        super(options);\r\n        this.bytes = asUint8Array(bytes);\r\n        this.view = new DataView(this.bytes.buffer, this.bytes.byteOffset, this.bytes.byteLength);\r\n        this.offset = Number(options.offset) || 0;\r\n        this.end = Number.isInteger(options.end) ? options.end : this.bytes.length;\r\n        this.source = options.source || \"memory\";\r\n        this.stringTable = options.stringTable ? asUint8Array(options.stringTable) : null;\r\n        this.stringTableSize = Number.isInteger(options.stringTableSize)\r\n            ? options.stringTableSize\r\n            : (this.stringTable ? this.stringTable.length : 0);\r\n    }\r\n\r\n    /**\r\n     * Attaches or replaces the string-table arena used by string and blob reads.\r\n     *\r\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Arena bytes.\r\n     * @param {number|null} [size] Valid arena byte count.\r\n     */\r\n    SetStringTable(bytes, size = null)\r\n    {\r\n        this.stringTable = asUint8Array(bytes);\r\n        this.stringTableSize = Number.isInteger(size) ? size : this.stringTable.length;\r\n    }\r\n\r\n    /**\r\n     * Returns the unread byte count inside the configured reader bounds.\r\n     *\r\n     * @returns {number} Remaining bytes.\r\n     */\r\n    get remaining()\r\n    {\r\n        return this.end - this.offset;\r\n    }\r\n\r\n    /**\r\n     * Advances the reader by a fixed number of bytes.\r\n     *\r\n     * @param {number} size Byte count to skip.\r\n     */\r\n    Skip(size)\r\n    {\r\n        this._require(size);\r\n        this.offset += size;\r\n    }\r\n\r\n    /**\r\n     * Reads a byte range from the main payload.\r\n     *\r\n     * @param {number} size Byte count to read.\r\n     * @returns {Uint8Array} View over the read bytes.\r\n     */\r\n    ReadRaw(size)\r\n    {\r\n        this._require(size);\r\n        const start = this.offset;\r\n        this.offset += size;\r\n        return this.bytes.subarray(start, start + size);\r\n    }\r\n\r\n    /**\r\n     * Reads an unsigned 8-bit integer.\r\n     *\r\n     * @returns {number} Integer value.\r\n     */\r\n    ReadUint8()\r\n    {\r\n        this._require(1);\r\n        const value = this.view.getUint8(this.offset);\r\n        this.offset += 1;\r\n        return value;\r\n    }\r\n\r\n    /**\r\n     * Reads a little-endian unsigned 16-bit integer.\r\n     *\r\n     * @returns {number} Integer value.\r\n     */\r\n    ReadUint16()\r\n    {\r\n        this._require(2);\r\n        const value = this.view.getUint16(this.offset, true);\r\n        this.offset += 2;\r\n        return value;\r\n    }\r\n\r\n    /**\r\n     * Reads a little-endian unsigned 32-bit integer.\r\n     *\r\n     * @returns {number} Integer value.\r\n     */\r\n    ReadUint32()\r\n    {\r\n        this._require(4);\r\n        const value = this.view.getUint32(this.offset, true);\r\n        this.offset += 4;\r\n        return value;\r\n    }\r\n\r\n    /**\r\n     * Reads a little-endian signed 32-bit integer.\r\n     *\r\n     * @returns {number} Integer value.\r\n     */\r\n    ReadInt32()\r\n    {\r\n        this._require(4);\r\n        const value = this.view.getInt32(this.offset, true);\r\n        this.offset += 4;\r\n        return value;\r\n    }\r\n\r\n    /**\r\n     * Reads a little-endian 32-bit float.\r\n     *\r\n     * @returns {number} Float value.\r\n     */\r\n    ReadFloat32()\r\n    {\r\n        this._require(4);\r\n        const value = this.view.getFloat32(this.offset, true);\r\n        this.offset += 4;\r\n        return value;\r\n    }\r\n\r\n    /**\r\n     * Reads Carbon's byte-sized boolean encoding.\r\n     *\r\n     * @returns {boolean} Boolean value.\r\n     */\r\n    ReadBool()\r\n    {\r\n        return this.ReadUint8() !== 0;\r\n    }\r\n\r\n    /**\r\n     * Reads a string-table offset and resolves it to a UTF-8 string.\r\n     *\r\n     * @param {number} [sizeHint] Optional maximum byte span for bounds checking.\r\n     * @returns {string} Decoded string.\r\n     */\r\n    ReadString(sizeHint = 0)\r\n    {\r\n        const offset = this.ReadUint32();\r\n        return this.ReadStringAt(offset, sizeHint);\r\n    }\r\n\r\n    /**\r\n     * Reads an optional string-table offset, returning null for zero-length fields.\r\n     *\r\n     * Carbon consumes the offset word regardless of the length and only\r\n     * dereferences it when the length is non-zero, which is the single site\r\n     * where the `0xffffffff` null reference is legal\r\n     * (`Tr2EffectDescription.cpp:80-91`).\r\n     *\r\n     * @param {number} length Source field length.\r\n     * @returns {string|null} Decoded string or null.\r\n     */\r\n    ReadStringOptional(length)\r\n    {\r\n        const offset = this.ReadUint32();\r\n        if (length === 0)\r\n        {\r\n            return null;\r\n        }\r\n        return this.ReadStringAt(offset, length);\r\n    }\r\n\r\n    /**\r\n     * Reads a string-table blob offset and returns the referenced byte range.\r\n     *\r\n     * @param {number} size Blob byte count.\r\n     * @returns {{offset:number,bytes:Uint8Array}} Blob location and bytes.\r\n     */\r\n    ReadTableBlob(size)\r\n    {\r\n        const offset = this.ReadUint32();\r\n        this._requireStringTable(offset, size);\r\n        return {\r\n            offset,\r\n            bytes: this.stringTable.subarray(offset, offset + size)\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Reads a possibly empty string-table blob reference.\r\n     *\r\n     * @param {number} size Blob byte count.\r\n     * @returns {{offset:number,bytes:Uint8Array}} Blob location and bytes.\r\n     */\r\n    ReadTableBlobOptional(size)\r\n    {\r\n        const offset = this.ReadUint32();\r\n        if (size === 0)\r\n        {\r\n            return {\r\n                offset,\r\n                bytes: new Uint8Array(0)\r\n            };\r\n        }\r\n        this._requireStringTable(offset, size);\r\n        return {\r\n            offset,\r\n            bytes: this.stringTable.subarray(offset, offset + size)\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Resolves a string table offset to a null-terminated UTF-8 string.\r\n     *\r\n     * @param {number} offset String-table byte offset.\r\n     * @param {number} [sizeHint] Optional maximum byte span for bounds checking.\r\n     * @returns {string} Decoded string.\r\n     */\r\n    ReadStringAt(offset, sizeHint = 0)\r\n    {\r\n        this._requireStringTable(offset, sizeHint);\r\n        let end = offset;\r\n        while (end < this.stringTableSize && this.stringTable[end] !== 0)\r\n        {\r\n            end += 1;\r\n        }\r\n        return textDecoder.decode(this.stringTable.subarray(offset, end));\r\n    }\r\n\r\n    /**\r\n     * Creates this reader's error type with shared reader-state details.\r\n     *\r\n     * @param {string} message Human-readable failure reason.\r\n     * @param {object} [details] Extra reader state.\r\n     * @returns {Error} Reader-specific error instance.\r\n     * @protected\r\n     */\r\n    _error(message, details = {})\r\n    {\r\n        const ReadError = this.constructor.ReadError ?? CjsFormatReadError;\r\n        return new ReadError(message, { source: this.source, ...details });\r\n    }\r\n\r\n    /**\r\n     * Ensures the requested read fits inside the configured payload bounds.\r\n     *\r\n     * @param {number} size Requested byte count.\r\n     * @private\r\n     */\r\n    _require(size)\r\n    {\r\n        if (!Number.isInteger(size) || size < 0 || this.offset + size > this.end)\r\n        {\r\n            throw this._error(this.constructor.endOfDataMessage, {\r\n                offset: this.offset,\r\n                requested: size,\r\n                end: this.end\r\n            });\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Ensures a string-table offset and optional span are valid.\r\n     *\r\n     * @param {number} offset String-table byte offset.\r\n     * @param {number} [sizeHint] Optional byte span for bounds checking.\r\n     * @private\r\n     */\r\n    _requireStringTable(offset, sizeHint = 0)\r\n    {\r\n        const size = Number(sizeHint) || 0;\r\n        if (!this.stringTable)\r\n        {\r\n            throw this._error(\"Missing effect string table\", { offset });\r\n        }\r\n        if (!Number.isInteger(offset) || offset < 0 || offset >= this.stringTableSize || offset + size > this.stringTableSize)\r\n        {\r\n            throw this._error(\"Invalid string-table offset\", {\r\n                offset,\r\n                sizeHint: size,\r\n                stringTableSize: this.stringTableSize\r\n            });\r\n        }\r\n    }\r\n}\r\n\r\nexport default CjsByteReader;\r\n"],"names":["textDecoder","TextDecoder","fatal","CjsByteReader","CjsReader","ReadError","CjsFormatReadError","endOfDataMessage","constructor","bytes","options","asUint8Array","view","DataView","buffer","byteOffset","byteLength","offset","Number","end","isInteger","length","source","stringTable","stringTableSize","SetStringTable","size","remaining","Skip","_require","ReadRaw","start","subarray","ReadUint8","value","getUint8","ReadUint16","getUint16","ReadUint32","getUint32","ReadInt32","getInt32","ReadFloat32","getFloat32","ReadBool","ReadString","sizeHint","ReadStringAt","ReadStringOptional","ReadTableBlob","_requireStringTable","ReadTableBlobOptional","Uint8Array","decode","_error","message","details","requested"],"mappings":"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"}
+{"version":3,"file":"CjsByteReader.js","sources":["../../../../src/resource/format/CjsByteReader.js"],"sourcesContent":["import { CjsReader } from \"./CjsReader.js\";\nimport { CjsFormatRangeError } from \"./CjsFormatError.js\";\nimport { asUint8Array } from \"#utils/bytes\";\n\nconst textDecoder = new TextDecoder(\"utf-8\", { fatal: false });\n\n/**\n * Little-endian cursor over resource bytes, with optional string-table arena\n * resolution.\n *\n * This is the shared implementation behind `HlslReader`, `WebglReader`, and\n * the Carbon-effect reader. Specialized readers only\n * replace the error class and the end-of-data message:\n *\n * ```js\n * class MyReader extends CjsByteReader\n * {\n *     static ReadError = MyReadError;\n *     static endOfDataMessage = \"Unexpected end of my data\";\n * }\n * ```\n *\n * The arena primitives (`ReadString`, `ReadStringAt`, `ReadStringOptional`,\n * `ReadTableBlob`, `ReadTableBlobOptional`) model Carbon's string table, where a\n * single `uint32` offset resolves either to a NUL-terminated string or to a\n * sized blob inside the same arena (`trinity/shadercompiler/StringTable.cpp`).\n */\nexport class CjsByteReader extends CjsReader\n{\n    /**\n     * Error class raised for out-of-bounds and arena failures.\n     *\n     * A `RangeError` lineage, because that is what running off the end of a\n     * buffer is. See `CjsFormatRangeError`.\n     */\n    static ReadError = CjsFormatRangeError;\n\n    /** Message used when a read would run past the configured end. */\n    static endOfDataMessage = \"Unexpected end of data\";\n\n    /**\n     * Creates a reader over a byte payload and optional shared string table.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Source payload.\n     * @param {object} [options] Reader bounds and metadata.\n     * @param {number} [options.offset] Initial byte offset.\n     * @param {number} [options.end] Exclusive end offset.\n     * @param {string} [options.source] Source name used in error details.\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} [options.stringTable] Arena bytes.\n     * @param {number} [options.stringTableSize] Valid arena byte count.\n     */\n    constructor(bytes, options = {})\n    {\n        super(options);\n        this.bytes = asUint8Array(bytes);\n        this.view = new DataView(this.bytes.buffer, this.bytes.byteOffset, this.bytes.byteLength);\n        this.offset = Number(options.offset) || 0;\n        this.end = Number.isInteger(options.end) ? options.end : this.bytes.length;\n        this.source = options.source || \"memory\";\n        this.stringTable = options.stringTable ? asUint8Array(options.stringTable) : null;\n        this.stringTableSize = Number.isInteger(options.stringTableSize)\n            ? options.stringTableSize\n            : (this.stringTable ? this.stringTable.length : 0);\n    }\n\n    /**\n     * Attaches or replaces the string-table arena used by string and blob reads.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Arena bytes.\n     * @param {number|null} [size] Valid arena byte count.\n     */\n    SetStringTable(bytes, size = null)\n    {\n        this.stringTable = asUint8Array(bytes);\n        this.stringTableSize = Number.isInteger(size) ? size : this.stringTable.length;\n    }\n\n    /**\n     * Returns the unread byte count inside the configured reader bounds.\n     *\n     * @returns {number} Remaining bytes.\n     */\n    get remaining()\n    {\n        return this.end - this.offset;\n    }\n\n    /**\n     * Advances the reader by a fixed number of bytes.\n     *\n     * @param {number} size Byte count to skip.\n     */\n    Skip(size)\n    {\n        this._require(size);\n        this.offset += size;\n    }\n\n    /**\n     * Reads a byte range from the main payload.\n     *\n     * @param {number} size Byte count to read.\n     * @returns {Uint8Array} View over the read bytes.\n     */\n    ReadRaw(size)\n    {\n        this._require(size);\n        const start = this.offset;\n        this.offset += size;\n        return this.bytes.subarray(start, start + size);\n    }\n\n    /**\n     * Reads an unsigned 8-bit integer.\n     *\n     * @returns {number} Integer value.\n     */\n    ReadUint8()\n    {\n        this._require(1);\n        const value = this.view.getUint8(this.offset);\n        this.offset += 1;\n        return value;\n    }\n\n    /**\n     * Reads a little-endian unsigned 16-bit integer.\n     *\n     * @returns {number} Integer value.\n     */\n    ReadUint16()\n    {\n        this._require(2);\n        const value = this.view.getUint16(this.offset, true);\n        this.offset += 2;\n        return value;\n    }\n\n    /**\n     * Reads a little-endian unsigned 32-bit integer.\n     *\n     * @returns {number} Integer value.\n     */\n    ReadUint32()\n    {\n        this._require(4);\n        const value = this.view.getUint32(this.offset, true);\n        this.offset += 4;\n        return value;\n    }\n\n    /**\n     * Reads a little-endian signed 32-bit integer.\n     *\n     * @returns {number} Integer value.\n     */\n    ReadInt32()\n    {\n        this._require(4);\n        const value = this.view.getInt32(this.offset, true);\n        this.offset += 4;\n        return value;\n    }\n\n    /**\n     * Reads a little-endian 32-bit float.\n     *\n     * @returns {number} Float value.\n     */\n    ReadFloat32()\n    {\n        this._require(4);\n        const value = this.view.getFloat32(this.offset, true);\n        this.offset += 4;\n        return value;\n    }\n\n    /**\n     * Reads Carbon's byte-sized boolean encoding.\n     *\n     * @returns {boolean} Boolean value.\n     */\n    ReadBool()\n    {\n        return this.ReadUint8() !== 0;\n    }\n\n    /**\n     * Reads a string-table offset and resolves it to a UTF-8 string.\n     *\n     * @param {number} [sizeHint] Optional maximum byte span for bounds checking.\n     * @returns {string} Decoded string.\n     */\n    ReadString(sizeHint = 0)\n    {\n        const offset = this.ReadUint32();\n        return this.ReadStringAt(offset, sizeHint);\n    }\n\n    /**\n     * Reads an optional string-table offset, returning null for zero-length fields.\n     *\n     * Carbon consumes the offset word regardless of the length and only\n     * dereferences it when the length is non-zero, which is the single site\n     * where the `0xffffffff` null reference is legal\n     * (`Tr2EffectDescription.cpp:80-91`).\n     *\n     * @param {number} length Source field length.\n     * @returns {string|null} Decoded string or null.\n     */\n    ReadStringOptional(length)\n    {\n        const offset = this.ReadUint32();\n        if (length === 0)\n        {\n            return null;\n        }\n        return this.ReadStringAt(offset, length);\n    }\n\n    /**\n     * Reads a string-table blob offset and returns the referenced byte range.\n     *\n     * @param {number} size Blob byte count.\n     * @returns {{offset:number,bytes:Uint8Array}} Blob location and bytes.\n     */\n    ReadTableBlob(size)\n    {\n        const offset = this.ReadUint32();\n        this._requireStringTable(offset, size);\n        return {\n            offset,\n            bytes: this.stringTable.subarray(offset, offset + size)\n        };\n    }\n\n    /**\n     * Reads a possibly empty string-table blob reference.\n     *\n     * @param {number} size Blob byte count.\n     * @returns {{offset:number,bytes:Uint8Array}} Blob location and bytes.\n     */\n    ReadTableBlobOptional(size)\n    {\n        const offset = this.ReadUint32();\n        if (size === 0)\n        {\n            return {\n                offset,\n                bytes: new Uint8Array(0)\n            };\n        }\n        this._requireStringTable(offset, size);\n        return {\n            offset,\n            bytes: this.stringTable.subarray(offset, offset + size)\n        };\n    }\n\n    /**\n     * Resolves a string table offset to a null-terminated UTF-8 string.\n     *\n     * @param {number} offset String-table byte offset.\n     * @param {number} [sizeHint] Optional maximum byte span for bounds checking.\n     * @returns {string} Decoded string.\n     */\n    ReadStringAt(offset, sizeHint = 0)\n    {\n        this._requireStringTable(offset, sizeHint);\n        let end = offset;\n        while (end < this.stringTableSize && this.stringTable[end] !== 0)\n        {\n            end += 1;\n        }\n        return textDecoder.decode(this.stringTable.subarray(offset, end));\n    }\n\n    /**\n     * Creates this reader's error type with shared reader-state details.\n     *\n     * @param {string} message Human-readable failure reason.\n     * @param {object} [details] Extra reader state.\n     * @returns {Error} Reader-specific error instance.\n     * @protected\n     */\n    _error(message, details = {})\n    {\n        const ReadError = this.constructor.ReadError ?? CjsFormatRangeError;\n        return new ReadError(message, { source: this.source, ...details });\n    }\n\n    /**\n     * Ensures the requested read fits inside the configured payload bounds.\n     *\n     * @param {number} size Requested byte count.\n     * @private\n     */\n    _require(size)\n    {\n        if (!Number.isInteger(size) || size < 0 || this.offset + size > this.end)\n        {\n            throw this._error(this.constructor.endOfDataMessage, {\n                offset: this.offset,\n                requested: size,\n                end: this.end\n            });\n        }\n    }\n\n    /**\n     * Ensures a string-table offset and optional span are valid.\n     *\n     * @param {number} offset String-table byte offset.\n     * @param {number} [sizeHint] Optional byte span for bounds checking.\n     * @private\n     */\n    _requireStringTable(offset, sizeHint = 0)\n    {\n        const size = Number(sizeHint) || 0;\n        if (!this.stringTable)\n        {\n            throw this._error(\"Missing effect string table\", { offset });\n        }\n        if (!Number.isInteger(offset) || offset < 0 || offset >= this.stringTableSize || offset + size > this.stringTableSize)\n        {\n            throw this._error(\"Invalid string-table offset\", {\n                offset,\n                sizeHint: size,\n                stringTableSize: this.stringTableSize\n            });\n        }\n    }\n}\n\nexport default CjsByteReader;\n"],"names":["textDecoder","TextDecoder","fatal","CjsByteReader","CjsReader","ReadError","CjsFormatRangeError","endOfDataMessage","constructor","bytes","options","asUint8Array","view","DataView","buffer","byteOffset","byteLength","offset","Number","end","isInteger","length","source","stringTable","stringTableSize","SetStringTable","size","remaining","Skip","_require","ReadRaw","start","subarray","ReadUint8","value","getUint8","ReadUint16","getUint16","ReadUint32","getUint32","ReadInt32","getInt32","ReadFloat32","getFloat32","ReadBool","ReadString","sizeHint","ReadStringAt","ReadStringOptional","ReadTableBlob","_requireStringTable","ReadTableBlobOptional","Uint8Array","decode","_error","message","details","requested"],"mappings":";;;;AAIA,MAAMA,WAAW,GAAG,IAAIC,WAAW,CAAC,OAAO,EAAE;AAAEC,EAAAA,KAAK,EAAE;AAAM,CAAC,CAAC;;AAE9D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,aAAa,SAASC,SAAS,CAC5C;AACI;AACJ;AACA;AACA;AACA;AACA;EACI,OAAOC,SAAS,GAAGC,mBAAmB;;AAEtC;EACA,OAAOC,gBAAgB,GAAG,wBAAwB;;AAElD;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACIC,EAAAA,WAAWA,CAACC,KAAK,EAAEC,OAAO,GAAG,EAAE,EAC/B;IACI,KAAK,CAACA,OAAO,CAAC;AACd,IAAA,IAAI,CAACD,KAAK,GAAGE,YAAY,CAACF,KAAK,CAAC;IAChC,IAAI,CAACG,IAAI,GAAG,IAAIC,QAAQ,CAAC,IAAI,CAACJ,KAAK,CAACK,MAAM,EAAE,IAAI,CAACL,KAAK,CAACM,UAAU,EAAE,IAAI,CAACN,KAAK,CAACO,UAAU,CAAC;IACzF,IAAI,CAACC,MAAM,GAAGC,MAAM,CAACR,OAAO,CAACO,MAAM,CAAC,IAAI,CAAC;IACzC,IAAI,CAACE,GAAG,GAAGD,MAAM,CAACE,SAAS,CAACV,OAAO,CAACS,GAAG,CAAC,GAAGT,OAAO,CAACS,GAAG,GAAG,IAAI,CAACV,KAAK,CAACY,MAAM;AAC1E,IAAA,IAAI,CAACC,MAAM,GAAGZ,OAAO,CAACY,MAAM,IAAI,QAAQ;AACxC,IAAA,IAAI,CAACC,WAAW,GAAGb,OAAO,CAACa,WAAW,GAAGZ,YAAY,CAACD,OAAO,CAACa,WAAW,CAAC,GAAG,IAAI;IACjF,IAAI,CAACC,eAAe,GAAGN,MAAM,CAACE,SAAS,CAACV,OAAO,CAACc,eAAe,CAAC,GAC1Dd,OAAO,CAACc,eAAe,GACtB,IAAI,CAACD,WAAW,GAAG,IAAI,CAACA,WAAW,CAACF,MAAM,GAAG,CAAE;AAC1D,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACII,EAAAA,cAAcA,CAAChB,KAAK,EAAEiB,IAAI,GAAG,IAAI,EACjC;AACI,IAAA,IAAI,CAACH,WAAW,GAAGZ,YAAY,CAACF,KAAK,CAAC;AACtC,IAAA,IAAI,CAACe,eAAe,GAAGN,MAAM,CAACE,SAAS,CAACM,IAAI,CAAC,GAAGA,IAAI,GAAG,IAAI,CAACH,WAAW,CAACF,MAAM;AAClF,EAAA;;AAEA;AACJ;AACA;AACA;AACA;EACI,IAAIM,SAASA,GACb;AACI,IAAA,OAAO,IAAI,CAACR,GAAG,GAAG,IAAI,CAACF,MAAM;AACjC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;EACIW,IAAIA,CAACF,IAAI,EACT;AACI,IAAA,IAAI,CAACG,QAAQ,CAACH,IAAI,CAAC;IACnB,IAAI,CAACT,MAAM,IAAIS,IAAI;AACvB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACII,OAAOA,CAACJ,IAAI,EACZ;AACI,IAAA,IAAI,CAACG,QAAQ,CAACH,IAAI,CAAC;AACnB,IAAA,MAAMK,KAAK,GAAG,IAAI,CAACd,MAAM;IACzB,IAAI,CAACA,MAAM,IAAIS,IAAI;IACnB,OAAO,IAAI,CAACjB,KAAK,CAACuB,QAAQ,CAACD,KAAK,EAAEA,KAAK,GAAGL,IAAI,CAAC;AACnD,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACIO,EAAAA,SAASA,GACT;AACI,IAAA,IAAI,CAACJ,QAAQ,CAAC,CAAC,CAAC;IAChB,MAAMK,KAAK,GAAG,IAAI,CAACtB,IAAI,CAACuB,QAAQ,CAAC,IAAI,CAAClB,MAAM,CAAC;IAC7C,IAAI,CAACA,MAAM,IAAI,CAAC;AAChB,IAAA,OAAOiB,KAAK;AAChB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACIE,EAAAA,UAAUA,GACV;AACI,IAAA,IAAI,CAACP,QAAQ,CAAC,CAAC,CAAC;AAChB,IAAA,MAAMK,KAAK,GAAG,IAAI,CAACtB,IAAI,CAACyB,SAAS,CAAC,IAAI,CAACpB,MAAM,EAAE,IAAI,CAAC;IACpD,IAAI,CAACA,MAAM,IAAI,CAAC;AAChB,IAAA,OAAOiB,KAAK;AAChB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACII,EAAAA,UAAUA,GACV;AACI,IAAA,IAAI,CAACT,QAAQ,CAAC,CAAC,CAAC;AAChB,IAAA,MAAMK,KAAK,GAAG,IAAI,CAACtB,IAAI,CAAC2B,SAAS,CAAC,IAAI,CAACtB,MAAM,EAAE,IAAI,CAAC;IACpD,IAAI,CAACA,MAAM,IAAI,CAAC;AAChB,IAAA,OAAOiB,KAAK;AAChB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACIM,EAAAA,SAASA,GACT;AACI,IAAA,IAAI,CAACX,QAAQ,CAAC,CAAC,CAAC;AAChB,IAAA,MAAMK,KAAK,GAAG,IAAI,CAACtB,IAAI,CAAC6B,QAAQ,CAAC,IAAI,CAACxB,MAAM,EAAE,IAAI,CAAC;IACnD,IAAI,CAACA,MAAM,IAAI,CAAC;AAChB,IAAA,OAAOiB,KAAK;AAChB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACIQ,EAAAA,WAAWA,GACX;AACI,IAAA,IAAI,CAACb,QAAQ,CAAC,CAAC,CAAC;AAChB,IAAA,MAAMK,KAAK,GAAG,IAAI,CAACtB,IAAI,CAAC+B,UAAU,CAAC,IAAI,CAAC1B,MAAM,EAAE,IAAI,CAAC;IACrD,IAAI,CAACA,MAAM,IAAI,CAAC;AAChB,IAAA,OAAOiB,KAAK;AAChB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACIU,EAAAA,QAAQA,GACR;AACI,IAAA,OAAO,IAAI,CAACX,SAAS,EAAE,KAAK,CAAC;AACjC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIY,EAAAA,UAAUA,CAACC,QAAQ,GAAG,CAAC,EACvB;AACI,IAAA,MAAM7B,MAAM,GAAG,IAAI,CAACqB,UAAU,EAAE;AAChC,IAAA,OAAO,IAAI,CAACS,YAAY,CAAC9B,MAAM,EAAE6B,QAAQ,CAAC;AAC9C,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACIE,kBAAkBA,CAAC3B,MAAM,EACzB;AACI,IAAA,MAAMJ,MAAM,GAAG,IAAI,CAACqB,UAAU,EAAE;IAChC,IAAIjB,MAAM,KAAK,CAAC,EAChB;AACI,MAAA,OAAO,IAAI;AACf,IAAA;AACA,IAAA,OAAO,IAAI,CAAC0B,YAAY,CAAC9B,MAAM,EAAEI,MAAM,CAAC;AAC5C,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI4B,aAAaA,CAACvB,IAAI,EAClB;AACI,IAAA,MAAMT,MAAM,GAAG,IAAI,CAACqB,UAAU,EAAE;AAChC,IAAA,IAAI,CAACY,mBAAmB,CAACjC,MAAM,EAAES,IAAI,CAAC;IACtC,OAAO;MACHT,MAAM;MACNR,KAAK,EAAE,IAAI,CAACc,WAAW,CAACS,QAAQ,CAACf,MAAM,EAAEA,MAAM,GAAGS,IAAI;KACzD;AACL,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIyB,qBAAqBA,CAACzB,IAAI,EAC1B;AACI,IAAA,MAAMT,MAAM,GAAG,IAAI,CAACqB,UAAU,EAAE;IAChC,IAAIZ,IAAI,KAAK,CAAC,EACd;MACI,OAAO;QACHT,MAAM;AACNR,QAAAA,KAAK,EAAE,IAAI2C,UAAU,CAAC,CAAC;OAC1B;AACL,IAAA;AACA,IAAA,IAAI,CAACF,mBAAmB,CAACjC,MAAM,EAAES,IAAI,CAAC;IACtC,OAAO;MACHT,MAAM;MACNR,KAAK,EAAE,IAAI,CAACc,WAAW,CAACS,QAAQ,CAACf,MAAM,EAAEA,MAAM,GAAGS,IAAI;KACzD;AACL,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIqB,EAAAA,YAAYA,CAAC9B,MAAM,EAAE6B,QAAQ,GAAG,CAAC,EACjC;AACI,IAAA,IAAI,CAACI,mBAAmB,CAACjC,MAAM,EAAE6B,QAAQ,CAAC;IAC1C,IAAI3B,GAAG,GAAGF,MAAM;AAChB,IAAA,OAAOE,GAAG,GAAG,IAAI,CAACK,eAAe,IAAI,IAAI,CAACD,WAAW,CAACJ,GAAG,CAAC,KAAK,CAAC,EAChE;AACIA,MAAAA,GAAG,IAAI,CAAC;AACZ,IAAA;AACA,IAAA,OAAOnB,WAAW,CAACqD,MAAM,CAAC,IAAI,CAAC9B,WAAW,CAACS,QAAQ,CAACf,MAAM,EAAEE,GAAG,CAAC,CAAC;AACrE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACImC,EAAAA,MAAMA,CAACC,OAAO,EAAEC,OAAO,GAAG,EAAE,EAC5B;IACI,MAAMnD,SAAS,GAAG,IAAI,CAACG,WAAW,CAACH,SAAS,IAAIC,mBAAmB;AACnE,IAAA,OAAO,IAAID,SAAS,CAACkD,OAAO,EAAE;MAAEjC,MAAM,EAAE,IAAI,CAACA,MAAM;MAAE,GAAGkC;AAAQ,KAAC,CAAC;AACtE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI3B,QAAQA,CAACH,IAAI,EACb;IACI,IAAI,CAACR,MAAM,CAACE,SAAS,CAACM,IAAI,CAAC,IAAIA,IAAI,GAAG,CAAC,IAAI,IAAI,CAACT,MAAM,GAAGS,IAAI,GAAG,IAAI,CAACP,GAAG,EACxE;MACI,MAAM,IAAI,CAACmC,MAAM,CAAC,IAAI,CAAC9C,WAAW,CAACD,gBAAgB,EAAE;QACjDU,MAAM,EAAE,IAAI,CAACA,MAAM;AACnBwC,QAAAA,SAAS,EAAE/B,IAAI;QACfP,GAAG,EAAE,IAAI,CAACA;AACd,OAAC,CAAC;AACN,IAAA;AACJ,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACI+B,EAAAA,mBAAmBA,CAACjC,MAAM,EAAE6B,QAAQ,GAAG,CAAC,EACxC;AACI,IAAA,MAAMpB,IAAI,GAAGR,MAAM,CAAC4B,QAAQ,CAAC,IAAI,CAAC;AAClC,IAAA,IAAI,CAAC,IAAI,CAACvB,WAAW,EACrB;AACI,MAAA,MAAM,IAAI,CAAC+B,MAAM,CAAC,6BAA6B,EAAE;AAAErC,QAAAA;AAAO,OAAC,CAAC;AAChE,IAAA;IACA,IAAI,CAACC,MAAM,CAACE,SAAS,CAACH,MAAM,CAAC,IAAIA,MAAM,GAAG,CAAC,IAAIA,MAAM,IAAI,IAAI,CAACO,eAAe,IAAIP,MAAM,GAAGS,IAAI,GAAG,IAAI,CAACF,eAAe,EACrH;AACI,MAAA,MAAM,IAAI,CAAC8B,MAAM,CAAC,6BAA6B,EAAE;QAC7CrC,MAAM;AACN6B,QAAAA,QAAQ,EAAEpB,IAAI;QACdF,eAAe,EAAE,IAAI,CAACA;AAC1B,OAAC,CAAC;AACN,IAAA;AACJ,EAAA;AACJ;;;;"}

package/dist/resource/format/CjsFormat.js

@@ -56,19 +56,19 @@ class CjsFormat {
 
   /** Inspect with the instance's normalized options when available. */
   Inspect(input, options = null) {
-    const values = typeof this.GetValues === "function" ? this.GetValues(options || {}) : options || {};
+    const values = this.GetValues(options || {});
     return this.constructor.inspect(input, values);
   }
 
   /** Return the cheap, unverified support report for this instance profile. */
   GetSupport(input, options = null) {
-    const values = typeof this.GetValues === "function" ? this.GetValues(options || {}) : options || {};
+    const values = this.GetValues(options || {});
     return this.constructor.getSupport(input, values);
   }
 
   /** Exercise one exact output through the real asynchronous read path. */
   VerifySupport(input, options = null) {
-    const values = typeof this.GetValues === "function" ? this.GetValues(options || {}) : options || {};
+    const values = this.GetValues(options || {});
     return this.constructor.verifySupport(input, values);
   }
 
@@ -438,7 +438,14 @@ function normalizeSupportReport(Format, rawReport, options) {
     };
   });
   const selected = capability ? outputs.find(entry => entry.output === capability.output) || null : null;
-  const preferredOutput = resolvePreferredOutput(raw.preferredOutput, outputs) || outputs.find(entry => entry.supported && entry.role === OUTPUT_ROLE_RUNTIME)?.output || outputs.find(entry => entry.supported)?.output || "";
+  // The declared default is consulted BEFORE falling back to declaration
+  // order. `default: true` is the format stating which output it wants asked
+  // for, so ignoring it here meant a probe had to repeat that choice by hand as
+  // `preferredOutput` — and a format whose outputs are all `role: "debug"`
+  // (webp, gif) otherwise resolved to whichever happened to be declared first.
+  // An explicit `raw.preferredOutput` still wins, because that is the probe
+  // reporting a per-input decision rather than a standing preference.
+  const preferredOutput = resolvePreferredOutput(raw.preferredOutput, outputs) || outputs.find(entry => entry.supported && entry.role === OUTPUT_ROLE_RUNTIME)?.output || outputs.find(entry => entry.supported && entry.default)?.output || outputs.find(entry => entry.supported)?.output || "";
   return {
     format: Format.id || raw.format || Format.name,
     source: raw.source || options.source || "buffer",