@carbonenginejs/runtime 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/resource/Tr2LightProfileRes.js

@@ -1,6 +1,8 @@
 import { CjsSchema } from '#schema';
 import { CjsResource } from './CjsResource.js';
 import { assertResourcePayloadObject } from './resourceBoundary.js';
+import { HostBitmap } from '#imageio';
+import { PixelFormat } from '#consts/render-context';
 import { ResourceRequirement } from './ResourceRequirement.js';
 
 // Source: trinity/trinity/Resources/Tr2LightProfileRes.h
@@ -21,6 +23,12 @@ class Tr2LightProfileRes extends CjsResource {
   // only GetElementIndex/Release, never the array class.
   #element = null;
 
+  /**
+   * m_bitmap: the baked profile, a 1024x1 `PIXEL_FORMAT_R16_FLOAT` strip with a
+   * full mip chain (Tr2LightProfileRes.cpp:13-15, 198-215). Invalid until loaded.
+   */
+  bitmap = new HostBitmap();
+
   /** Updates payload in the current resource payload lifecycle. */
   SetPayload(payload = null) {
     if (payload === null) {
@@ -31,14 +39,43 @@ class Tr2LightProfileRes extends CjsResource {
         this.#element.Release();
         this.#element = null;
       }
+      this.bitmap = new HostBitmap();
       super.SetPayload(null);
       return this;
     }
     assertResourcePayloadObject("Tr2LightProfileRes", payload);
+    this.bitmap = Tr2LightProfileRes.bitmapFromBake(payload);
     super.SetPayload(payload);
     return this;
   }
 
+  /**
+   * Carbon's `m_bitmap`, which it hands to the light-profile array
+   * (Tr2LightProfileRes.cpp:95-99).
+   *
+   * @returns {HostBitmap} The baked profile; invalid until loaded.
+   */
+  GetBitmap() {
+    return this.bitmap;
+  }
+
+  /**
+   * The baked profile as Carbon's bitmap. The IES bake already writes Carbon's
+   * bytes - half floats, one mip after another - which is exactly a 1024x1
+   * R16_FLOAT HostBitmap's memory, so this is a copy, not a conversion.
+   *
+   * @param {{width: number, samples: Uint16Array}} bake The IES reader's lightProfile output.
+   * @returns {HostBitmap} The bitmap; invalid when the bake has no samples.
+   */
+  static bitmapFromBake(bake) {
+    const bitmap = new HostBitmap();
+    if (!(bake.samples instanceof Uint16Array)) return bitmap;
+    if (!bitmap.Create(bake.width, 1, 0, PixelFormat.PIXEL_FORMAT_R16_FLOAT)) return bitmap;
+    const raw = bitmap.GetRawData();
+    raw.set(new Uint8Array(bake.samples.buffer, bake.samples.byteOffset, Math.min(bake.samples.byteLength, raw.byteLength)));
+    return bitmap;
+  }
+
   /**
    * Accepts the profile array slice handle from the trinity seam.
    *

package/dist/resource/Tr2LightProfileRes.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2LightProfileRes.js","sources":["../../../src/resource/Tr2LightProfileRes.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Tr2LightProfileRes.h\nimport { CjsSchema } from \"#schema\";\nimport { CjsResource } from \"./CjsResource.js\";\nimport { assertResourcePayloadObject } from \"./resourceBoundary.js\";\nimport { ResourceRequirement } from \"./ResourceRequirement.js\";\n\n/**\n * Runtime-owned light-profile resource.\n *\n * The attached plain payload may be richer than the data retained by the\n * resource or active engine adapter.\n */\nexport class Tr2LightProfileRes extends CjsResource\n{\n  // The light-profile array slice this resource occupies, or null before\n  // registration. Carbon's DoPrepare acquires it (Tr2LightProfileRes.cpp:\n  // 95-99: GetLightProfileArray().AddElement(m_bitmap)), but here the\n  // resource layer cannot import trinity, so TRINITY registers the element\n  // at first pack (Tr2LightManager.#ProfileSlot) and hands the handle in\n  // through RegisterProfileElement. Duck-typed on purpose: this class knows\n  // only GetElementIndex/Release, never the array class.\n  #element = null;\n\n  /** Updates payload in the current resource payload lifecycle. */\n  SetPayload(payload = null)\n  {\n    if (payload === null)\n    {\n      // Losing the payload releases the slice - Carbon's element handle\n      // frees its slot when the resource lets go (Tr2TextureArray.cpp:\n      // 233-236); with no destructors the unload path is the release site.\n      if (this.#element)\n      {\n        this.#element.Release();\n        this.#element = null;\n      }\n      super.SetPayload(null);\n      return this;\n    }\n    assertResourcePayloadObject(\"Tr2LightProfileRes\", payload);\n    super.SetPayload(payload);\n    return this;\n  }\n\n  /**\n   * Accepts the profile array slice handle from the trinity seam.\n   *\n   * @param {{GetElementIndex: Function, Release: Function}} element\n   * @returns {Tr2LightProfileRes} this\n   */\n  RegisterProfileElement(element)\n  {\n    if (this.#element && this.#element !== element)\n    {\n      this.#element.Release();\n    }\n    this.#element = element ?? null;\n    return this;\n  }\n\n  /**\n   * The texture-array slice this profile occupies, or -1 when unregistered.\n   *\n   * Carbon returns the raw element index and an INVALID handle reports 0\n   * (Tr2TextureArrayElement, cpp:216-219) - indistinguishable from slot 0,\n   * with the +1 bias left to consumers. The -1 sentinel here is deliberate\n   * (matching the proven ccpwgl port): the consumer maps negative to the\n   * biased 0, and an unloaded profile can never alias slot 0.\n   *\n   * @returns {number} Slice index, or -1.\n   */\n  GetTextureIndex()\n  {\n    return this.#element ? this.#element.GetElementIndex() : -1;\n  }\n\n  static payload = ResourceRequirement.LIGHT_PROFILE;\n}\n\nCjsSchema.define(Tr2LightProfileRes, {\n  className: \"Tr2LightProfileRes\",\n  family: \"resources\"\n});\n"],"names":["Tr2LightProfileRes","CjsResource","SetPayload","payload","Release","assertResourcePayloadObject","RegisterProfileElement","element","GetTextureIndex","GetElementIndex","ResourceRequirement","LIGHT_PROFILE","CjsSchema","define","className","family"],"mappings":";;;;;AAAA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,kBAAkB,SAASC,WAAW,CACnD;AACE;AACA;AACA;AACA;AACA;AACA;AACA;EACA,QAAQ,GAAG,IAAI;;AAEf;AACAC,EAAAA,UAAUA,CAACC,OAAO,GAAG,IAAI,EACzB;IACE,IAAIA,OAAO,KAAK,IAAI,EACpB;AACE;AACA;AACA;AACA,MAAA,IAAI,IAAI,CAAC,QAAQ,EACjB;AACE,QAAA,IAAI,CAAC,QAAQ,CAACC,OAAO,EAAE;AACvB,QAAA,IAAI,CAAC,QAAQ,GAAG,IAAI;AACtB,MAAA;AACA,MAAA,KAAK,CAACF,UAAU,CAAC,IAAI,CAAC;AACtB,MAAA,OAAO,IAAI;AACb,IAAA;AACAG,IAAAA,2BAA2B,CAAC,oBAAoB,EAAEF,OAAO,CAAC;AAC1D,IAAA,KAAK,CAACD,UAAU,CAACC,OAAO,CAAC;AACzB,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACEG,sBAAsBA,CAACC,OAAO,EAC9B;IACE,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAKA,OAAO,EAC9C;AACE,MAAA,IAAI,CAAC,QAAQ,CAACH,OAAO,EAAE;AACzB,IAAA;AACA,IAAA,IAAI,CAAC,QAAQ,GAAGG,OAAO,IAAI,IAAI;AAC/B,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,eAAeA,GACf;AACE,IAAA,OAAO,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAACC,eAAe,EAAE,GAAG,EAAE;AAC7D,EAAA;AAEA,EAAA,OAAON,OAAO,GAAGO,mBAAmB,CAACC,aAAa;AACpD;AAEAC,SAAS,CAACC,MAAM,CAACb,kBAAkB,EAAE;AACnCc,EAAAA,SAAS,EAAE,oBAAoB;AAC/BC,EAAAA,MAAM,EAAE;AACV,CAAC,CAAC;;;;"}
+{"version":3,"file":"Tr2LightProfileRes.js","sources":["../../../src/resource/Tr2LightProfileRes.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Tr2LightProfileRes.h\nimport { CjsSchema } from \"#schema\";\nimport { CjsResource } from \"./CjsResource.js\";\nimport { assertResourcePayloadObject } from \"./resourceBoundary.js\";\nimport { HostBitmap } from \"#imageio\";\nimport { PixelFormat } from \"#consts/render-context\";\nimport { ResourceRequirement } from \"./ResourceRequirement.js\";\n\n/**\n * Runtime-owned light-profile resource.\n *\n * The attached plain payload may be richer than the data retained by the\n * resource or active engine adapter.\n */\nexport class Tr2LightProfileRes extends CjsResource\n{\n  // The light-profile array slice this resource occupies, or null before\n  // registration. Carbon's DoPrepare acquires it (Tr2LightProfileRes.cpp:\n  // 95-99: GetLightProfileArray().AddElement(m_bitmap)), but here the\n  // resource layer cannot import trinity, so TRINITY registers the element\n  // at first pack (Tr2LightManager.#ProfileSlot) and hands the handle in\n  // through RegisterProfileElement. Duck-typed on purpose: this class knows\n  // only GetElementIndex/Release, never the array class.\n  #element = null;\n\n  /**\n   * m_bitmap: the baked profile, a 1024x1 `PIXEL_FORMAT_R16_FLOAT` strip with a\n   * full mip chain (Tr2LightProfileRes.cpp:13-15, 198-215). Invalid until loaded.\n   */\n  bitmap = new HostBitmap();\n\n  /** Updates payload in the current resource payload lifecycle. */\n  SetPayload(payload = null)\n  {\n    if (payload === null)\n    {\n      // Losing the payload releases the slice - Carbon's element handle\n      // frees its slot when the resource lets go (Tr2TextureArray.cpp:\n      // 233-236); with no destructors the unload path is the release site.\n      if (this.#element)\n      {\n        this.#element.Release();\n        this.#element = null;\n      }\n      this.bitmap = new HostBitmap();\n      super.SetPayload(null);\n      return this;\n    }\n    assertResourcePayloadObject(\"Tr2LightProfileRes\", payload);\n    this.bitmap = Tr2LightProfileRes.bitmapFromBake(payload);\n    super.SetPayload(payload);\n    return this;\n  }\n\n  /**\n   * Carbon's `m_bitmap`, which it hands to the light-profile array\n   * (Tr2LightProfileRes.cpp:95-99).\n   *\n   * @returns {HostBitmap} The baked profile; invalid until loaded.\n   */\n  GetBitmap()\n  {\n    return this.bitmap;\n  }\n\n  /**\n   * The baked profile as Carbon's bitmap. The IES bake already writes Carbon's\n   * bytes - half floats, one mip after another - which is exactly a 1024x1\n   * R16_FLOAT HostBitmap's memory, so this is a copy, not a conversion.\n   *\n   * @param {{width: number, samples: Uint16Array}} bake The IES reader's lightProfile output.\n   * @returns {HostBitmap} The bitmap; invalid when the bake has no samples.\n   */\n  static bitmapFromBake(bake)\n  {\n    const bitmap = new HostBitmap();\n\n    if (!(bake.samples instanceof Uint16Array)) return bitmap;\n    if (!bitmap.Create(bake.width, 1, 0, PixelFormat.PIXEL_FORMAT_R16_FLOAT)) return bitmap;\n\n    const raw = bitmap.GetRawData();\n    raw.set(new Uint8Array(bake.samples.buffer, bake.samples.byteOffset, Math.min(bake.samples.byteLength, raw.byteLength)));\n    return bitmap;\n  }\n\n  /**\n   * Accepts the profile array slice handle from the trinity seam.\n   *\n   * @param {{GetElementIndex: Function, Release: Function}} element\n   * @returns {Tr2LightProfileRes} this\n   */\n  RegisterProfileElement(element)\n  {\n    if (this.#element && this.#element !== element)\n    {\n      this.#element.Release();\n    }\n    this.#element = element ?? null;\n    return this;\n  }\n\n  /**\n   * The texture-array slice this profile occupies, or -1 when unregistered.\n   *\n   * Carbon returns the raw element index and an INVALID handle reports 0\n   * (Tr2TextureArrayElement, cpp:216-219) - indistinguishable from slot 0,\n   * with the +1 bias left to consumers. The -1 sentinel here is deliberate\n   * (matching the proven ccpwgl port): the consumer maps negative to the\n   * biased 0, and an unloaded profile can never alias slot 0.\n   *\n   * @returns {number} Slice index, or -1.\n   */\n  GetTextureIndex()\n  {\n    return this.#element ? this.#element.GetElementIndex() : -1;\n  }\n\n  static payload = ResourceRequirement.LIGHT_PROFILE;\n}\n\nCjsSchema.define(Tr2LightProfileRes, {\n  className: \"Tr2LightProfileRes\",\n  family: \"resources\"\n});\n"],"names":["Tr2LightProfileRes","CjsResource","bitmap","HostBitmap","SetPayload","payload","Release","assertResourcePayloadObject","bitmapFromBake","GetBitmap","bake","samples","Uint16Array","Create","width","PixelFormat","PIXEL_FORMAT_R16_FLOAT","raw","GetRawData","set","Uint8Array","buffer","byteOffset","Math","min","byteLength","RegisterProfileElement","element","GetTextureIndex","GetElementIndex","ResourceRequirement","LIGHT_PROFILE","CjsSchema","define","className","family"],"mappings":";;;;;;;AAAA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,kBAAkB,SAASC,WAAW,CACnD;AACE;AACA;AACA;AACA;AACA;AACA;AACA;EACA,QAAQ,GAAG,IAAI;;AAEf;AACF;AACA;AACA;AACEC,EAAAA,MAAM,GAAG,IAAIC,UAAU,EAAE;;AAEzB;AACAC,EAAAA,UAAUA,CAACC,OAAO,GAAG,IAAI,EACzB;IACE,IAAIA,OAAO,KAAK,IAAI,EACpB;AACE;AACA;AACA;AACA,MAAA,IAAI,IAAI,CAAC,QAAQ,EACjB;AACE,QAAA,IAAI,CAAC,QAAQ,CAACC,OAAO,EAAE;AACvB,QAAA,IAAI,CAAC,QAAQ,GAAG,IAAI;AACtB,MAAA;AACA,MAAA,IAAI,CAACJ,MAAM,GAAG,IAAIC,UAAU,EAAE;AAC9B,MAAA,KAAK,CAACC,UAAU,CAAC,IAAI,CAAC;AACtB,MAAA,OAAO,IAAI;AACb,IAAA;AACAG,IAAAA,2BAA2B,CAAC,oBAAoB,EAAEF,OAAO,CAAC;IAC1D,IAAI,CAACH,MAAM,GAAGF,kBAAkB,CAACQ,cAAc,CAACH,OAAO,CAAC;AACxD,IAAA,KAAK,CAACD,UAAU,CAACC,OAAO,CAAC;AACzB,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACEI,EAAAA,SAASA,GACT;IACE,OAAO,IAAI,CAACP,MAAM;AACpB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACE,OAAOM,cAAcA,CAACE,IAAI,EAC1B;AACE,IAAA,MAAMR,MAAM,GAAG,IAAIC,UAAU,EAAE;IAE/B,IAAI,EAAEO,IAAI,CAACC,OAAO,YAAYC,WAAW,CAAC,EAAE,OAAOV,MAAM;AACzD,IAAA,IAAI,CAACA,MAAM,CAACW,MAAM,CAACH,IAAI,CAACI,KAAK,EAAE,CAAC,EAAE,CAAC,EAAEC,WAAW,CAACC,sBAAsB,CAAC,EAAE,OAAOd,MAAM;AAEvF,IAAA,MAAMe,GAAG,GAAGf,MAAM,CAACgB,UAAU,EAAE;AAC/BD,IAAAA,GAAG,CAACE,GAAG,CAAC,IAAIC,UAAU,CAACV,IAAI,CAACC,OAAO,CAACU,MAAM,EAAEX,IAAI,CAACC,OAAO,CAACW,UAAU,EAAEC,IAAI,CAACC,GAAG,CAACd,IAAI,CAACC,OAAO,CAACc,UAAU,EAAER,GAAG,CAACQ,UAAU,CAAC,CAAC,CAAC;AACxH,IAAA,OAAOvB,MAAM;AACf,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACEwB,sBAAsBA,CAACC,OAAO,EAC9B;IACE,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAKA,OAAO,EAC9C;AACE,MAAA,IAAI,CAAC,QAAQ,CAACrB,OAAO,EAAE;AACzB,IAAA;AACA,IAAA,IAAI,CAAC,QAAQ,GAAGqB,OAAO,IAAI,IAAI;AAC/B,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,eAAeA,GACf;AACE,IAAA,OAAO,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAACC,eAAe,EAAE,GAAG,EAAE;AAC7D,EAAA;AAEA,EAAA,OAAOxB,OAAO,GAAGyB,mBAAmB,CAACC,aAAa;AACpD;AAEAC,SAAS,CAACC,MAAM,CAACjC,kBAAkB,EAAE;AACnCkC,EAAAA,SAAS,EAAE,oBAAoB;AAC/BC,EAAAA,MAAM,EAAE;AACV,CAAC,CAAC;;;;"}

package/dist/resource/format/CjsByteWriter.js

@@ -16,9 +16,9 @@ const textEncoder = new TextEncoder();
  * just "keep the offset an append returned".
  */
 class CjsByteWriter {
-  #bytes;
-  #view;
-  #length = 0;
+  _bytes;
+  _view;
+  _length = 0;
 
   /**
    * Creates an empty writer with an initial capacity.
@@ -27,8 +27,8 @@ class CjsByteWriter {
    */
   constructor(initialCapacity = 1024) {
     const capacity = Number.isInteger(initialCapacity) && initialCapacity > 0 ? initialCapacity : 1024;
-    this.#bytes = new Uint8Array(capacity);
-    this.#view = new DataView(this.#bytes.buffer);
+    this._bytes = new Uint8Array(capacity);
+    this._view = new DataView(this._bytes.buffer);
   }
 
   /**
@@ -37,7 +37,7 @@ class CjsByteWriter {
    * @returns {number} Written byte count.
    */
   get length() {
-    return this.#length;
+    return this._length;
   }
 
   /**
@@ -47,8 +47,8 @@ class CjsByteWriter {
    * @returns {number} Offset the value was written at.
    */
   u8(value) {
-    const offset = this.#advance(1);
-    this.#view.setUint8(offset, value & 0xff);
+    const offset = this._advance(1);
+    this._view.setUint8(offset, value & 0xff);
     return offset;
   }
 
@@ -59,8 +59,8 @@ class CjsByteWriter {
    * @returns {number} Offset the value was written at.
    */
   u16(value) {
-    const offset = this.#advance(2);
-    this.#view.setUint16(offset, value & 0xffff, true);
+    const offset = this._advance(2);
+    this._view.setUint16(offset, value & 0xffff, true);
     return offset;
   }
 
@@ -71,8 +71,8 @@ class CjsByteWriter {
    * @returns {number} Offset the value was written at.
    */
   i16(value) {
-    const offset = this.#advance(2);
-    this.#view.setInt16(offset, value | 0, true);
+    const offset = this._advance(2);
+    this._view.setInt16(offset, value | 0, true);
     return offset;
   }
 
@@ -83,8 +83,8 @@ class CjsByteWriter {
    * @returns {number} Offset the value was written at.
    */
   u32(value) {
-    const offset = this.#advance(4);
-    this.#view.setUint32(offset, value >>> 0, true);
+    const offset = this._advance(4);
+    this._view.setUint32(offset, value >>> 0, true);
     return offset;
   }
 
@@ -95,8 +95,8 @@ class CjsByteWriter {
    * @returns {number} Offset the value was written at.
    */
   i32(value) {
-    const offset = this.#advance(4);
-    this.#view.setInt32(offset, value | 0, true);
+    const offset = this._advance(4);
+    this._view.setInt32(offset, value | 0, true);
     return offset;
   }
 
@@ -107,8 +107,8 @@ class CjsByteWriter {
    * @returns {number} Offset the value was written at.
    */
   i64(value) {
-    const offset = this.#advance(8);
-    this.#view.setBigInt64(offset, BigInt(value), true);
+    const offset = this._advance(8);
+    this._view.setBigInt64(offset, BigInt(value), true);
     return offset;
   }
 
@@ -119,8 +119,8 @@ class CjsByteWriter {
    * @returns {number} Offset the value was written at.
    */
   f32(value) {
-    const offset = this.#advance(4);
-    this.#view.setFloat32(offset, Number(value) || 0, true);
+    const offset = this._advance(4);
+    this._view.setFloat32(offset, Number(value) || 0, true);
     return offset;
   }
 
@@ -131,8 +131,8 @@ class CjsByteWriter {
    * @returns {number} Offset the value was written at.
    */
   f64(value) {
-    const offset = this.#advance(8);
-    this.#view.setFloat64(offset, Number(value) || 0, true);
+    const offset = this._advance(8);
+    this._view.setFloat64(offset, Number(value) || 0, true);
     return offset;
   }
 
@@ -154,8 +154,8 @@ class CjsByteWriter {
    */
   bytes(value) {
     const source = value instanceof Uint8Array ? value : new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
-    const offset = this.#advance(source.byteLength);
-    this.#bytes.set(source, offset);
+    const offset = this._advance(source.byteLength);
+    this._bytes.set(source, offset);
     return offset;
   }
 
@@ -181,8 +181,8 @@ class CjsByteWriter {
         count
       });
     }
-    const offset = this.#advance(count);
-    this.#bytes.fill(0, offset, offset + count);
+    const offset = this._advance(count);
+    this._bytes.fill(0, offset, offset + count);
     return offset;
   }
 
@@ -193,8 +193,8 @@ class CjsByteWriter {
    * @param {number} value Integer value.
    */
   patchU8(offset, value) {
-    this.#requireWritten(offset, 1);
-    this.#view.setUint8(offset, value & 0xff);
+    this._requireWritten(offset, 1);
+    this._view.setUint8(offset, value & 0xff);
   }
 
   /**
@@ -204,8 +204,8 @@ class CjsByteWriter {
    * @param {number} value Integer value.
    */
   patchU32(offset, value) {
-    this.#requireWritten(offset, 4);
-    this.#view.setUint32(offset, value >>> 0, true);
+    this._requireWritten(offset, 4);
+    this._view.setUint32(offset, value >>> 0, true);
   }
 
   /**
@@ -216,8 +216,8 @@ class CjsByteWriter {
    */
   patchBytes(offset, value) {
     const source = value instanceof Uint8Array ? value : new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
-    this.#requireWritten(offset, source.byteLength);
-    this.#bytes.set(source, offset);
+    this._requireWritten(offset, source.byteLength);
+    this._bytes.set(source, offset);
   }
 
   /**
@@ -226,7 +226,7 @@ class CjsByteWriter {
    * @returns {Uint8Array} Written payload.
    */
   toBytes() {
-    return this.#bytes.slice(0, this.#length);
+    return this._bytes.slice(0, this._length);
   }
 
   /**
@@ -234,14 +234,14 @@ class CjsByteWriter {
    *
    * @param {number} capacity Required total capacity.
    */
-  #ensure(capacity) {
-    if (capacity <= this.#bytes.length) return;
-    let next = this.#bytes.length * 2;
+  _ensure(capacity) {
+    if (capacity <= this._bytes.length) return;
+    let next = this._bytes.length * 2;
     while (next < capacity) next *= 2;
     const grown = new Uint8Array(next);
-    grown.set(this.#bytes.subarray(0, this.#length));
-    this.#bytes = grown;
-    this.#view = new DataView(grown.buffer);
+    grown.set(this._bytes.subarray(0, this._length));
+    this._bytes = grown;
+    this._view = new DataView(grown.buffer);
   }
 
   /**
@@ -250,10 +250,10 @@ class CjsByteWriter {
    * @param {number} size Byte count for this append.
    * @returns {number} Offset of the appended run.
    */
-  #advance(size) {
-    const offset = this.#length;
-    this.#ensure(offset + size);
-    this.#length = offset + size;
+  _advance(size) {
+    const offset = this._length;
+    this._ensure(offset + size);
+    this._length = offset + size;
     return offset;
   }
 
@@ -263,12 +263,12 @@ class CjsByteWriter {
    * @param {number} offset Target offset.
    * @param {number} size Patch byte count.
    */
-  #requireWritten(offset, size) {
-    if (!Number.isInteger(offset) || offset < 0 || offset + size > this.#length) {
+  _requireWritten(offset, size) {
+    if (!Number.isInteger(offset) || offset < 0 || offset + size > this._length) {
       throw new CjsFormatWriteError("Patch target is outside the written range", {
         offset,
         size,
-        length: this.#length
+        length: this._length
       });
     }
   }

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

@@ -1 +1 @@
-{"version":3,"file":"CjsByteWriter.js","sources":["../../../../src/resource/format/CjsByteWriter.js"],"sourcesContent":["import { CjsFormatWriteError } from \"./CjsFormatError.js\";\r\n\r\nconst textEncoder = new TextEncoder();\r\n\r\n/**\r\n * Growable little-endian append cursor with reserve-and-patch support.\r\n *\r\n * `formats/cmf/core/writer.js` already has a growable buffer, but it is\r\n * patch-style throughout: every write takes an explicit offset produced by a\r\n * prior `reserve`. Container assembly wants the opposite default — append in\r\n * field order — with patching kept for the one case that needs it, an offset\r\n * table whose values are only known after the payload it points at has been\r\n * measured.\r\n *\r\n * Every append returns the offset it wrote at, so the reserve-and-patch case is\r\n * just \"keep the offset an append returned\".\r\n */\r\nexport class CjsByteWriter\r\n{\r\n    #bytes;\r\n    #view;\r\n    #length = 0;\r\n\r\n    /**\r\n     * Creates an empty writer with an initial capacity.\r\n     *\r\n     * @param {number} [initialCapacity] Starting buffer size in bytes.\r\n     */\r\n    constructor(initialCapacity = 1024)\r\n    {\r\n        const capacity = Number.isInteger(initialCapacity) && initialCapacity > 0 ? initialCapacity : 1024;\r\n        this.#bytes = new Uint8Array(capacity);\r\n        this.#view = new DataView(this.#bytes.buffer);\r\n    }\r\n\r\n    /**\r\n     * Returns the number of bytes written so far.\r\n     *\r\n     * @returns {number} Written byte count.\r\n     */\r\n    get length()\r\n    {\r\n        return this.#length;\r\n    }\r\n\r\n    /**\r\n     * Appends an unsigned 8-bit integer.\r\n     *\r\n     * @param {number} value Integer value.\r\n     * @returns {number} Offset the value was written at.\r\n     */\r\n    u8(value)\r\n    {\r\n        const offset = this.#advance(1);\r\n        this.#view.setUint8(offset, value & 0xff);\r\n        return offset;\r\n    }\r\n\r\n    /**\r\n     * Appends a little-endian unsigned 16-bit integer.\r\n     *\r\n     * @param {number} value Integer value.\r\n     * @returns {number} Offset the value was written at.\r\n     */\r\n    u16(value)\n    {\r\n        const offset = this.#advance(2);\r\n        this.#view.setUint16(offset, value & 0xffff, true);\r\n        return offset;\n    }\n\n    /**\n     * Appends a little-endian signed 16-bit integer.\n     *\n     * @param {number} value Integer value.\n     * @returns {number} Offset the value was written at.\n     */\n    i16(value)\n    {\n        const offset = this.#advance(2);\n        this.#view.setInt16(offset, value | 0, true);\n        return offset;\n    }\n\r\n    /**\r\n     * Appends a little-endian unsigned 32-bit integer.\r\n     *\r\n     * @param {number} value Integer value.\r\n     * @returns {number} Offset the value was written at.\r\n     */\r\n    u32(value)\r\n    {\r\n        const offset = this.#advance(4);\r\n        this.#view.setUint32(offset, value >>> 0, true);\r\n        return offset;\r\n    }\r\n\r\n    /**\r\n     * Appends a little-endian signed 32-bit integer.\r\n     *\r\n     * @param {number} value Integer value.\r\n     * @returns {number} Offset the value was written at.\r\n     */\r\n    i32(value)\n    {\r\n        const offset = this.#advance(4);\r\n        this.#view.setInt32(offset, value | 0, true);\r\n        return offset;\n    }\n\n    /**\n     * Appends a little-endian signed 64-bit integer.\n     *\n     * @param {bigint|number} value Integer value.\n     * @returns {number} Offset the value was written at.\n     */\n    i64(value)\n    {\n        const offset = this.#advance(8);\n        this.#view.setBigInt64(offset, BigInt(value), true);\n        return offset;\n    }\n\r\n    /**\r\n     * Appends a little-endian 32-bit float.\r\n     *\r\n     * @param {number} value Float value.\r\n     * @returns {number} Offset the value was written at.\r\n     */\r\n    f32(value)\n    {\r\n        const offset = this.#advance(4);\r\n        this.#view.setFloat32(offset, Number(value) || 0, true);\r\n        return offset;\n    }\n\n    /**\n     * Appends a little-endian 64-bit float.\n     *\n     * @param {number} value Float value.\n     * @returns {number} Offset the value was written at.\n     */\n    f64(value)\n    {\n        const offset = this.#advance(8);\n        this.#view.setFloat64(offset, Number(value) || 0, true);\n        return offset;\n    }\n\r\n    /**\r\n     * Appends Carbon's byte-sized boolean encoding.\r\n     *\r\n     * @param {boolean} value Boolean value.\r\n     * @returns {number} Offset the value was written at.\r\n     */\r\n    bool(value)\r\n    {\r\n        return this.u8(value ? 1 : 0);\r\n    }\r\n\r\n    /**\r\n     * Appends raw bytes.\r\n     *\r\n     * @param {ArrayBufferView|Uint8Array} value Bytes to append.\r\n     * @returns {number} Offset the bytes were written at.\r\n     */\r\n    bytes(value)\r\n    {\r\n        const source = value instanceof Uint8Array\r\n            ? value\r\n            : new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\r\n        const offset = this.#advance(source.byteLength);\r\n        this.#bytes.set(source, offset);\r\n        return offset;\r\n    }\r\n\r\n    /**\r\n     * Appends UTF-8 text without a terminator.\r\n     *\r\n     * @param {string} value Text to append.\r\n     * @returns {number} Offset the text was written at.\r\n     */\r\n    utf8(value)\r\n    {\r\n        return this.bytes(textEncoder.encode(String(value)));\r\n    }\r\n\r\n    /**\r\n     * Appends a run of zero bytes and returns its offset, for later patching.\r\n     *\r\n     * @param {number} count Byte count to reserve.\r\n     * @returns {number} Offset of the reserved run.\r\n     */\r\n    reserve(count)\r\n    {\r\n        if (!Number.isInteger(count) || count < 0)\r\n        {\r\n            throw new CjsFormatWriteError(\"Reserve count must be a non-negative integer\", { count });\r\n        }\r\n        const offset = this.#advance(count);\r\n        this.#bytes.fill(0, offset, offset + count);\r\n        return offset;\r\n    }\r\n\r\n    /**\r\n     * Overwrites a previously written unsigned 8-bit integer.\r\n     *\r\n     * @param {number} offset Target offset.\r\n     * @param {number} value Integer value.\r\n     */\r\n    patchU8(offset, value)\r\n    {\r\n        this.#requireWritten(offset, 1);\r\n        this.#view.setUint8(offset, value & 0xff);\r\n    }\r\n\r\n    /**\r\n     * Overwrites a previously written little-endian unsigned 32-bit integer.\r\n     *\r\n     * @param {number} offset Target offset.\r\n     * @param {number} value Integer value.\r\n     */\r\n    patchU32(offset, value)\r\n    {\r\n        this.#requireWritten(offset, 4);\r\n        this.#view.setUint32(offset, value >>> 0, true);\r\n    }\r\n\r\n    /**\r\n     * Overwrites a previously written byte range.\r\n     *\r\n     * @param {number} offset Target offset.\r\n     * @param {ArrayBufferView|Uint8Array} value Replacement bytes.\r\n     */\r\n    patchBytes(offset, value)\r\n    {\r\n        const source = value instanceof Uint8Array\r\n            ? value\r\n            : new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\r\n        this.#requireWritten(offset, source.byteLength);\r\n        this.#bytes.set(source, offset);\r\n    }\r\n\r\n    /**\r\n     * Returns an owned copy of the written bytes.\r\n     *\r\n     * @returns {Uint8Array} Written payload.\r\n     */\r\n    toBytes()\r\n    {\r\n        return this.#bytes.slice(0, this.#length);\r\n    }\r\n\r\n    /**\r\n     * Grows the buffer when a write would exceed capacity.\r\n     *\r\n     * @param {number} capacity Required total capacity.\r\n     */\r\n    #ensure(capacity)\r\n    {\r\n        if (capacity <= this.#bytes.length) return;\r\n        let next = this.#bytes.length * 2;\r\n        while (next < capacity) next *= 2;\r\n        const grown = new Uint8Array(next);\r\n        grown.set(this.#bytes.subarray(0, this.#length));\r\n        this.#bytes = grown;\r\n        this.#view = new DataView(grown.buffer);\r\n    }\r\n\r\n    /**\r\n     * Reserves space for one append and returns the offset it starts at.\r\n     *\r\n     * @param {number} size Byte count for this append.\r\n     * @returns {number} Offset of the appended run.\r\n     */\r\n    #advance(size)\r\n    {\r\n        const offset = this.#length;\r\n        this.#ensure(offset + size);\r\n        this.#length = offset + size;\r\n        return offset;\r\n    }\r\n\r\n    /**\r\n     * Rejects a patch that falls outside the bytes already written.\r\n     *\r\n     * @param {number} offset Target offset.\r\n     * @param {number} size Patch byte count.\r\n     */\r\n    #requireWritten(offset, size)\r\n    {\r\n        if (!Number.isInteger(offset) || offset < 0 || offset + size > this.#length)\r\n        {\r\n            throw new CjsFormatWriteError(\"Patch target is outside the written range\", {\r\n                offset,\r\n                size,\r\n                length: this.#length\r\n            });\r\n        }\r\n    }\r\n}\r\n\r\nexport default CjsByteWriter;\r\n"],"names":["textEncoder","TextEncoder","CjsByteWriter","constructor","initialCapacity","capacity","Number","isInteger","Uint8Array","DataView","buffer","length","u8","value","offset","setUint8","u16","setUint16","i16","setInt16","u32","setUint32","i32","setInt32","i64","setBigInt64","BigInt","f32","setFloat32","f64","setFloat64","bool","bytes","source","byteOffset","byteLength","set","utf8","encode","String","reserve","count","CjsFormatWriteError","fill","patchU8","patchU32","patchBytes","toBytes","slice","#ensure","next","grown","subarray","#advance","size","#requireWritten"],"mappings":"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"}
+{"version":3,"file":"CjsByteWriter.js","sources":["../../../../src/resource/format/CjsByteWriter.js"],"sourcesContent":["import { CjsFormatWriteError } from \"./CjsFormatError.js\";\r\n\r\nconst textEncoder = new TextEncoder();\r\n\r\n/**\r\n * Growable little-endian append cursor with reserve-and-patch support.\r\n *\r\n * `formats/cmf/core/writer.js` already has a growable buffer, but it is\r\n * patch-style throughout: every write takes an explicit offset produced by a\r\n * prior `reserve`. Container assembly wants the opposite default — append in\r\n * field order — with patching kept for the one case that needs it, an offset\r\n * table whose values are only known after the payload it points at has been\r\n * measured.\r\n *\r\n * Every append returns the offset it wrote at, so the reserve-and-patch case is\r\n * just \"keep the offset an append returned\".\r\n */\r\nexport class CjsByteWriter\r\n{\r\n    _bytes;\r\n    _view;\r\n    _length = 0;\r\n\r\n    /**\r\n     * Creates an empty writer with an initial capacity.\r\n     *\r\n     * @param {number} [initialCapacity] Starting buffer size in bytes.\r\n     */\r\n    constructor(initialCapacity = 1024)\r\n    {\r\n        const capacity = Number.isInteger(initialCapacity) && initialCapacity > 0 ? initialCapacity : 1024;\r\n        this._bytes = new Uint8Array(capacity);\r\n        this._view = new DataView(this._bytes.buffer);\r\n    }\r\n\r\n    /**\r\n     * Returns the number of bytes written so far.\r\n     *\r\n     * @returns {number} Written byte count.\r\n     */\r\n    get length()\r\n    {\r\n        return this._length;\r\n    }\r\n\r\n    /**\r\n     * Appends an unsigned 8-bit integer.\r\n     *\r\n     * @param {number} value Integer value.\r\n     * @returns {number} Offset the value was written at.\r\n     */\r\n    u8(value)\r\n    {\r\n        const offset = this._advance(1);\r\n        this._view.setUint8(offset, value & 0xff);\r\n        return offset;\r\n    }\r\n\r\n    /**\r\n     * Appends a little-endian unsigned 16-bit integer.\r\n     *\r\n     * @param {number} value Integer value.\r\n     * @returns {number} Offset the value was written at.\r\n     */\r\n    u16(value)\n    {\r\n        const offset = this._advance(2);\r\n        this._view.setUint16(offset, value & 0xffff, true);\r\n        return offset;\n    }\n\n    /**\n     * Appends a little-endian signed 16-bit integer.\n     *\n     * @param {number} value Integer value.\n     * @returns {number} Offset the value was written at.\n     */\n    i16(value)\n    {\n        const offset = this._advance(2);\n        this._view.setInt16(offset, value | 0, true);\n        return offset;\n    }\n\r\n    /**\r\n     * Appends a little-endian unsigned 32-bit integer.\r\n     *\r\n     * @param {number} value Integer value.\r\n     * @returns {number} Offset the value was written at.\r\n     */\r\n    u32(value)\r\n    {\r\n        const offset = this._advance(4);\r\n        this._view.setUint32(offset, value >>> 0, true);\r\n        return offset;\r\n    }\r\n\r\n    /**\r\n     * Appends a little-endian signed 32-bit integer.\r\n     *\r\n     * @param {number} value Integer value.\r\n     * @returns {number} Offset the value was written at.\r\n     */\r\n    i32(value)\n    {\r\n        const offset = this._advance(4);\r\n        this._view.setInt32(offset, value | 0, true);\r\n        return offset;\n    }\n\n    /**\n     * Appends a little-endian signed 64-bit integer.\n     *\n     * @param {bigint|number} value Integer value.\n     * @returns {number} Offset the value was written at.\n     */\n    i64(value)\n    {\n        const offset = this._advance(8);\n        this._view.setBigInt64(offset, BigInt(value), true);\n        return offset;\n    }\n\r\n    /**\r\n     * Appends a little-endian 32-bit float.\r\n     *\r\n     * @param {number} value Float value.\r\n     * @returns {number} Offset the value was written at.\r\n     */\r\n    f32(value)\n    {\r\n        const offset = this._advance(4);\r\n        this._view.setFloat32(offset, Number(value) || 0, true);\r\n        return offset;\n    }\n\n    /**\n     * Appends a little-endian 64-bit float.\n     *\n     * @param {number} value Float value.\n     * @returns {number} Offset the value was written at.\n     */\n    f64(value)\n    {\n        const offset = this._advance(8);\n        this._view.setFloat64(offset, Number(value) || 0, true);\n        return offset;\n    }\n\r\n    /**\r\n     * Appends Carbon's byte-sized boolean encoding.\r\n     *\r\n     * @param {boolean} value Boolean value.\r\n     * @returns {number} Offset the value was written at.\r\n     */\r\n    bool(value)\r\n    {\r\n        return this.u8(value ? 1 : 0);\r\n    }\r\n\r\n    /**\r\n     * Appends raw bytes.\r\n     *\r\n     * @param {ArrayBufferView|Uint8Array} value Bytes to append.\r\n     * @returns {number} Offset the bytes were written at.\r\n     */\r\n    bytes(value)\r\n    {\r\n        const source = value instanceof Uint8Array\r\n            ? value\r\n            : new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\r\n        const offset = this._advance(source.byteLength);\r\n        this._bytes.set(source, offset);\r\n        return offset;\r\n    }\r\n\r\n    /**\r\n     * Appends UTF-8 text without a terminator.\r\n     *\r\n     * @param {string} value Text to append.\r\n     * @returns {number} Offset the text was written at.\r\n     */\r\n    utf8(value)\r\n    {\r\n        return this.bytes(textEncoder.encode(String(value)));\r\n    }\r\n\r\n    /**\r\n     * Appends a run of zero bytes and returns its offset, for later patching.\r\n     *\r\n     * @param {number} count Byte count to reserve.\r\n     * @returns {number} Offset of the reserved run.\r\n     */\r\n    reserve(count)\r\n    {\r\n        if (!Number.isInteger(count) || count < 0)\r\n        {\r\n            throw new CjsFormatWriteError(\"Reserve count must be a non-negative integer\", { count });\r\n        }\r\n        const offset = this._advance(count);\r\n        this._bytes.fill(0, offset, offset + count);\r\n        return offset;\r\n    }\r\n\r\n    /**\r\n     * Overwrites a previously written unsigned 8-bit integer.\r\n     *\r\n     * @param {number} offset Target offset.\r\n     * @param {number} value Integer value.\r\n     */\r\n    patchU8(offset, value)\r\n    {\r\n        this._requireWritten(offset, 1);\r\n        this._view.setUint8(offset, value & 0xff);\r\n    }\r\n\r\n    /**\r\n     * Overwrites a previously written little-endian unsigned 32-bit integer.\r\n     *\r\n     * @param {number} offset Target offset.\r\n     * @param {number} value Integer value.\r\n     */\r\n    patchU32(offset, value)\r\n    {\r\n        this._requireWritten(offset, 4);\r\n        this._view.setUint32(offset, value >>> 0, true);\r\n    }\r\n\r\n    /**\r\n     * Overwrites a previously written byte range.\r\n     *\r\n     * @param {number} offset Target offset.\r\n     * @param {ArrayBufferView|Uint8Array} value Replacement bytes.\r\n     */\r\n    patchBytes(offset, value)\r\n    {\r\n        const source = value instanceof Uint8Array\r\n            ? value\r\n            : new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\r\n        this._requireWritten(offset, source.byteLength);\r\n        this._bytes.set(source, offset);\r\n    }\r\n\r\n    /**\r\n     * Returns an owned copy of the written bytes.\r\n     *\r\n     * @returns {Uint8Array} Written payload.\r\n     */\r\n    toBytes()\r\n    {\r\n        return this._bytes.slice(0, this._length);\r\n    }\r\n\r\n    /**\r\n     * Grows the buffer when a write would exceed capacity.\r\n     *\r\n     * @param {number} capacity Required total capacity.\r\n     */\r\n    _ensure(capacity)\r\n    {\r\n        if (capacity <= this._bytes.length) return;\r\n        let next = this._bytes.length * 2;\r\n        while (next < capacity) next *= 2;\r\n        const grown = new Uint8Array(next);\r\n        grown.set(this._bytes.subarray(0, this._length));\r\n        this._bytes = grown;\r\n        this._view = new DataView(grown.buffer);\r\n    }\r\n\r\n    /**\r\n     * Reserves space for one append and returns the offset it starts at.\r\n     *\r\n     * @param {number} size Byte count for this append.\r\n     * @returns {number} Offset of the appended run.\r\n     */\r\n    _advance(size)\r\n    {\r\n        const offset = this._length;\r\n        this._ensure(offset + size);\r\n        this._length = offset + size;\r\n        return offset;\r\n    }\r\n\r\n    /**\r\n     * Rejects a patch that falls outside the bytes already written.\r\n     *\r\n     * @param {number} offset Target offset.\r\n     * @param {number} size Patch byte count.\r\n     */\r\n    _requireWritten(offset, size)\r\n    {\r\n        if (!Number.isInteger(offset) || offset < 0 || offset + size > this._length)\r\n        {\r\n            throw new CjsFormatWriteError(\"Patch target is outside the written range\", {\r\n                offset,\r\n                size,\r\n                length: this._length\r\n            });\r\n        }\r\n    }\r\n}\r\n\r\nexport default CjsByteWriter;\r\n"],"names":["textEncoder","TextEncoder","CjsByteWriter","_bytes","_view","_length","constructor","initialCapacity","capacity","Number","isInteger","Uint8Array","DataView","buffer","length","u8","value","offset","_advance","setUint8","u16","setUint16","i16","setInt16","u32","setUint32","i32","setInt32","i64","setBigInt64","BigInt","f32","setFloat32","f64","setFloat64","bool","bytes","source","byteOffset","byteLength","set","utf8","encode","String","reserve","count","CjsFormatWriteError","fill","patchU8","_requireWritten","patchU32","patchBytes","toBytes","slice","_ensure","next","grown","subarray","size"],"mappings":"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"}

package/dist/resource/format/CjsFormat.js

@@ -9,9 +9,8 @@ const READ_MODE_ASYNC = "async";
  * Decorator-free base for every concrete format facade.
  *
  * The format subpaths must remain directly importable from authored source, so
- * this base deliberately does not import the decorated CjsResourceProbe model.
- * Formats return plain support reports; CjsResourceProbe.from() is the optional
- * resource-layer normalization boundary.
+ * this base carries no decorators. Formats return plain support reports;
+ * CjsResourceProbe.from() is the optional resource-layer normalization.
  */
 class CjsFormat {
   options = {};
@@ -274,7 +273,7 @@ class CjsFormat {
     if (Object.keys(inputs).length > 0 && defaults !== 1) {
       throw new TypeError("A format with inputs must declare exactly one default input.");
     }
-    return Object.freeze(inputs);
+    return inputs;
   }
 
   /** Freeze and validate one format's authoritative output map. */
@@ -398,9 +397,9 @@ class CjsFormat {
     VIDEO: PayloadType.VIDEO
   });
   static id = "";
-  static mediaTypes = Object.freeze([]);
-  static extensions = Object.freeze([]);
-  static outputs = Object.freeze({});
+  static mediaTypes = [];
+  static extensions = [];
+  static outputs = {};
   /**
    * What this format can be written FROM, empty when it cannot be written.
    *
@@ -411,7 +410,7 @@ class CjsFormat {
    * contract - it says nothing about what payload it takes or whether the
    * result is lossy.
    */
-  static inputs = Object.freeze({});
+  static inputs = {};
   static requestResponseType = "arraybuffer";
   static worker = null;
 }