@carbonenginejs/runtime-resource 0.10.0 → 0.11.1

package/dist/resource/shader/sampler/Tr2SamplerSetup.js

@@ -1,39 +1,23 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { type, impl } from '@carbonenginejs/runtime-utils/schema';
+import { CjsSchema, type, impl } from '@carbonenginejs/runtime-utils/schema';
 import { CjsModel } from '@carbonenginejs/runtime-utils/model';
 import { isPlainObject } from '@carbonenginejs/runtime-utils/is';
 import { cloneCarbonValue } from '@carbonenginejs/runtime-utils/types';
 
-let _initStatic, _initClass, _init_name, _init_extra_name, _init_hasName, _init_extra_hasName, _init_sampler, _init_extra_sampler, _init_isDynamic, _init_extra_isDynamic;
+// Source: trinity/trinity/Shader/Tr2EffectDescription.h
 
 /** Reflected sampler name and complete device-free sampler descriptor. */
-let _Tr2SamplerSetup;
 class Tr2SamplerSetup extends CjsModel {
-  static {
-    ({
-      e: [_init_name, _init_extra_name, _init_hasName, _init_extra_hasName, _init_sampler, _init_extra_sampler, _init_isDynamic, _init_extra_isDynamic, _initStatic],
-      c: [_Tr2SamplerSetup, _initClass]
-    } = _applyDecs2311(this, [type.define({
-      className: "Tr2SamplerSetup",
-      family: "shader"
-    })], [[[type, type.string], 16, "name"], [[impl, impl.adapted, void 0, impl.reason("The schema string field cannot distinguish an authored null sampler name from an empty name; portable reflection must retain that distinction for static sampler records."), type, type.boolean], 16, "hasName"], [type.rawStruct("Tr2SamplerStateAL"), 0, "sampler"], [[impl, impl.adapted, void 0, impl.reason("The portable effect contract distinguishes dynamic and static sampler declarations before an engine creates sampler state."), type, type.boolean], 16, "isDynamic"], [[impl, impl.custom, void 0, impl.reason("Carbon reads compiled effect bytes directly; CarbonEngineJS hydrates the browser-safe portable-reflection contract after format parsing.")], 26, "fromPortable"]], 0, void 0, CjsModel));
-    _initStatic(this);
-  }
-  constructor(...args) {
-    super(...args);
-    _init_extra_isDynamic(this);
-  }
   /** name (const char*) */
-  name = _init_name(this, "");
+  name = "";
 
   /** Whether the source sampler carried a name rather than authored null. */
-  hasName = (_init_extra_name(this), _init_hasName(this, false));
+  hasName = false;
 
   /** sampler (Tr2SamplerStateAL) */
-  sampler = (_init_extra_hasName(this), _init_sampler(this, null));
+  sampler = null;
 
   /** Whether the sampler occupies a dynamic register rather than static signature state. */
-  isDynamic = (_init_extra_sampler(this), _init_isDynamic(this, false));
+  isDynamic = false;
 
   /**
    * Construct a canonical sampler record from JS/JSON model values.
@@ -71,10 +55,21 @@ class Tr2SamplerSetup extends CjsModel {
     sampler.isDynamic = !!value.isDynamic;
     return sampler;
   }
-  static {
-    _initClass();
-  }
 }
 
-export { _Tr2SamplerSetup as Tr2SamplerSetup };
+// Declared imperatively rather than with decorators, so this module stays
+// plain ESM that loads from source without a transform. The decorator
+// expressions are reused verbatim, so the registered metadata is identical.
+// Statics belong in `methods`: decorateMethod targets the prototype and
+// would register a static as an instance field.
+CjsSchema.define(Tr2SamplerSetup, {
+  className: "Tr2SamplerSetup",
+  family: "shader"
+});
+CjsSchema.decorateField(Tr2SamplerSetup, "name", type.string);
+CjsSchema.decorateField(Tr2SamplerSetup, "hasName", impl.adapted, impl.reason("The schema string field cannot distinguish an authored null sampler name from an empty name; portable reflection must retain that distinction for static sampler records."), type.boolean);
+CjsSchema.decorateField(Tr2SamplerSetup, "sampler", type.rawStruct("Tr2SamplerStateAL"));
+CjsSchema.decorateField(Tr2SamplerSetup, "isDynamic", impl.adapted, impl.reason("The portable effect contract distinguishes dynamic and static sampler declarations before an engine creates sampler state."), type.boolean);
+
+export { Tr2SamplerSetup };
 //# sourceMappingURL=Tr2SamplerSetup.js.map

package/dist/resource/shader/sampler/Tr2SamplerSetup.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2SamplerSetup.js","sources":["../../../../../src/resource/shader/sampler/Tr2SamplerSetup.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { impl, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { isPlainObject } from \"@carbonenginejs/runtime-utils/is\";\nimport { cloneCarbonValue } from \"@carbonenginejs/runtime-utils/types\";\n\n/** Reflected sampler name and complete device-free sampler descriptor. */\n@type.define({ className: \"Tr2SamplerSetup\", family: \"shader\" })\nexport class Tr2SamplerSetup extends CjsModel\n{\n\n  /** name (const char*) */\n  @type.string\n  name = \"\";\n\n  /** Whether the source sampler carried a name rather than authored null. */\n  @impl.adapted\n  @impl.reason(\"The schema string field cannot distinguish an authored null sampler name from an empty name; portable reflection must retain that distinction for static sampler records.\")\n  @type.boolean\n  hasName = false;\n\n  /** sampler (Tr2SamplerStateAL) */\n  @type.rawStruct(\"Tr2SamplerStateAL\")\n  sampler = null;\n\n  /** Whether the sampler occupies a dynamic register rather than static signature state. */\n  @impl.adapted\n  @impl.reason(\"The portable effect contract distinguishes dynamic and static sampler declarations before an engine creates sampler state.\")\n  @type.boolean\n  isDynamic = false;\n\n  /**\n   * Construct a canonical sampler record from JS/JSON model values.\n   *\n   * @param {object} values Canonical model values.\n   * @param {object} options CjsModel import options.\n   * @returns {Tr2SamplerSetup} Hydrated sampler.\n   */\n  static from(values = {}, options = {})\n  {\n    let normalized = values;\n    if (values && Object.hasOwn(values, \"name\")\n      && !Object.hasOwn(values, \"hasName\"))\n    {\n      normalized = {\n        ...values,\n        hasName: values.name !== null,\n        name: values.name === null ? \"\" : values.name\n      };\n    }\n    return super.from(normalized, options);\n  }\n\n  /**\n   * Build one sampler from its portable JSON reflection record.\n   *\n   * @param {object} value Portable sampler record.\n   * @returns {Tr2SamplerSetup} Reflected sampler.\n   */\n  @impl.custom\n  @impl.reason(\"Carbon reads compiled effect bytes directly; CarbonEngineJS hydrates the browser-safe portable-reflection contract after format parsing.\")\n  static fromPortable(value)\n  {\n    if (!isPlainObject(value))\n    {\n      throw new TypeError(\"Portable effect sampler must be an object\");\n    }\n    const sampler = new this();\n    sampler.hasName = value.name !== null;\n    sampler.name = sampler.hasName ? String(value.name ?? \"\") : \"\";\n    sampler.sampler = cloneCarbonValue(value.descriptor);\n    sampler.isDynamic = !!value.isDynamic;\n    return sampler;\n  }\n\n}\n"],"names":["_Tr2SamplerSetup","Tr2SamplerSetup","CjsModel","e","_init_name","_init_extra_name","_init_hasName","_init_extra_hasName","_init_sampler","_init_extra_sampler","_init_isDynamic","_init_extra_isDynamic","_initStatic","c","_initClass","_applyDecs","type","define","className","family","string","impl","adapted","reason","boolean","rawStruct","custom","constructor","args","name","hasName","sampler","isDynamic","from","values","options","normalized","Object","hasOwn","fromPortable","value","isPlainObject","TypeError","String","cloneCarbonValue","descriptor"],"mappings":"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"}
+{"version":3,"file":"Tr2SamplerSetup.js","sources":["../../../../../src/resource/shader/sampler/Tr2SamplerSetup.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { CjsSchema, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { isPlainObject } from \"@carbonenginejs/runtime-utils/is\";\nimport { cloneCarbonValue } from \"@carbonenginejs/runtime-utils/types\";\n\n/** Reflected sampler name and complete device-free sampler descriptor. */\nexport class Tr2SamplerSetup extends CjsModel\n{\n\n  /** name (const char*) */\n  name = \"\";\n\n  /** Whether the source sampler carried a name rather than authored null. */\n  hasName = false;\n\n  /** sampler (Tr2SamplerStateAL) */\n  sampler = null;\n\n  /** Whether the sampler occupies a dynamic register rather than static signature state. */\n  isDynamic = false;\n\n  /**\n   * Construct a canonical sampler record from JS/JSON model values.\n   *\n   * @param {object} values Canonical model values.\n   * @param {object} options CjsModel import options.\n   * @returns {Tr2SamplerSetup} Hydrated sampler.\n   */\n  static from(values = {}, options = {})\n  {\n    let normalized = values;\n    if (values && Object.hasOwn(values, \"name\")\n      && !Object.hasOwn(values, \"hasName\"))\n    {\n      normalized = {\n        ...values,\n        hasName: values.name !== null,\n        name: values.name === null ? \"\" : values.name\n      };\n    }\n    return super.from(normalized, options);\n  }\n\n  /**\n   * Build one sampler from its portable JSON reflection record.\n   *\n   * @param {object} value Portable sampler record.\n   * @returns {Tr2SamplerSetup} Reflected sampler.\n   */\n  static fromPortable(value)\n  {\n    if (!isPlainObject(value))\n    {\n      throw new TypeError(\"Portable effect sampler must be an object\");\n    }\n    const sampler = new this();\n    sampler.hasName = value.name !== null;\n    sampler.name = sampler.hasName ? String(value.name ?? \"\") : \"\";\n    sampler.sampler = cloneCarbonValue(value.descriptor);\n    sampler.isDynamic = !!value.isDynamic;\n    return sampler;\n  }\n\n}\n\n// Declared imperatively rather than with decorators, so this module stays\n// plain ESM that loads from source without a transform. The decorator\n// expressions are reused verbatim, so the registered metadata is identical.\n// Statics belong in `methods`: decorateMethod targets the prototype and\n// would register a static as an instance field.\nCjsSchema.define(Tr2SamplerSetup, {\n  className: \"Tr2SamplerSetup\",\n  family: \"shader\"\n});\nCjsSchema.decorateField(Tr2SamplerSetup, \"name\", type.string);\nCjsSchema.decorateField(Tr2SamplerSetup, \"hasName\", impl.adapted, impl.reason(\"The schema string field cannot distinguish an authored null sampler name from an empty name; portable reflection must retain that distinction for static sampler records.\"), type.boolean);\nCjsSchema.decorateField(Tr2SamplerSetup, \"sampler\", type.rawStruct(\"Tr2SamplerStateAL\"));\nCjsSchema.decorateField(Tr2SamplerSetup, \"isDynamic\", impl.adapted, impl.reason(\"The portable effect contract distinguishes dynamic and static sampler declarations before an engine creates sampler state.\"), type.boolean);\n"],"names":["Tr2SamplerSetup","CjsModel","name","hasName","sampler","isDynamic","from","values","options","normalized","Object","hasOwn","fromPortable","value","isPlainObject","TypeError","String","cloneCarbonValue","descriptor","CjsSchema","define","className","family","decorateField","type","string","impl","adapted","reason","boolean","rawStruct"],"mappings":";;;;;AAAA;;AAMA;AACO,MAAMA,eAAe,SAASC,QAAQ,CAC7C;AAEE;AACAC,EAAAA,IAAI,GAAG,EAAE;;AAET;AACAC,EAAAA,OAAO,GAAG,KAAK;;AAEf;AACAC,EAAAA,OAAO,GAAG,IAAI;;AAEd;AACAC,EAAAA,SAAS,GAAG,KAAK;;AAEjB;AACF;AACA;AACA;AACA;AACA;AACA;EACE,OAAOC,IAAIA,CAACC,MAAM,GAAG,EAAE,EAAEC,OAAO,GAAG,EAAE,EACrC;IACE,IAAIC,UAAU,GAAGF,MAAM;IACvB,IAAIA,MAAM,IAAIG,MAAM,CAACC,MAAM,CAACJ,MAAM,EAAE,MAAM,CAAC,IACtC,CAACG,MAAM,CAACC,MAAM,CAACJ,MAAM,EAAE,SAAS,CAAC,EACtC;AACEE,MAAAA,UAAU,GAAG;AACX,QAAA,GAAGF,MAAM;AACTJ,QAAAA,OAAO,EAAEI,MAAM,CAACL,IAAI,KAAK,IAAI;QAC7BA,IAAI,EAAEK,MAAM,CAACL,IAAI,KAAK,IAAI,GAAG,EAAE,GAAGK,MAAM,CAACL;OAC1C;AACH,IAAA;AACA,IAAA,OAAO,KAAK,CAACI,IAAI,CAACG,UAAU,EAAED,OAAO,CAAC;AACxC,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACE,OAAOI,YAAYA,CAACC,KAAK,EACzB;AACE,IAAA,IAAI,CAACC,aAAa,CAACD,KAAK,CAAC,EACzB;AACE,MAAA,MAAM,IAAIE,SAAS,CAAC,2CAA2C,CAAC;AAClE,IAAA;AACA,IAAA,MAAMX,OAAO,GAAG,IAAI,IAAI,EAAE;AAC1BA,IAAAA,OAAO,CAACD,OAAO,GAAGU,KAAK,CAACX,IAAI,KAAK,IAAI;AACrCE,IAAAA,OAAO,CAACF,IAAI,GAAGE,OAAO,CAACD,OAAO,GAAGa,MAAM,CAACH,KAAK,CAACX,IAAI,IAAI,EAAE,CAAC,GAAG,EAAE;IAC9DE,OAAO,CAACA,OAAO,GAAGa,gBAAgB,CAACJ,KAAK,CAACK,UAAU,CAAC;AACpDd,IAAAA,OAAO,CAACC,SAAS,GAAG,CAAC,CAACQ,KAAK,CAACR,SAAS;AACrC,IAAA,OAAOD,OAAO;AAChB,EAAA;AAEF;;AAEA;AACA;AACA;AACA;AACA;AACAe,SAAS,CAACC,MAAM,CAACpB,eAAe,EAAE;AAChCqB,EAAAA,SAAS,EAAE,iBAAiB;AAC5BC,EAAAA,MAAM,EAAE;AACV,CAAC,CAAC;AACFH,SAAS,CAACI,aAAa,CAACvB,eAAe,EAAE,MAAM,EAAEwB,IAAI,CAACC,MAAM,CAAC;AAC7DN,SAAS,CAACI,aAAa,CAACvB,eAAe,EAAE,SAAS,EAAE0B,IAAI,CAACC,OAAO,EAAED,IAAI,CAACE,MAAM,CAAC,2KAA2K,CAAC,EAAEJ,IAAI,CAACK,OAAO,CAAC;AACzQV,SAAS,CAACI,aAAa,CAACvB,eAAe,EAAE,SAAS,EAAEwB,IAAI,CAACM,SAAS,CAAC,mBAAmB,CAAC,CAAC;AACxFX,SAAS,CAACI,aAAa,CAACvB,eAAe,EAAE,WAAW,EAAE0B,IAAI,CAACC,OAAO,EAAED,IAAI,CAACE,MAAM,CAAC,4HAA4H,CAAC,EAAEJ,IAAI,CAACK,OAAO,CAAC;;;;"}

package/docs/formats/README.md

@@ -41,6 +41,10 @@ metadata. Worker eligibility never changes the format's direct API; see
 | Wwise soundbank (`.bnk`) | `CjsBnkFormat` | `@carbonenginejs/runtime-resource/formats/bnk` |
 | CMF (`.cmf`) | `CjsCmfFormat` | `@carbonenginejs/runtime-resource/formats/cmf` |
 | DDS (`.dds`) | `CjsDdsFormat` | `@carbonenginejs/runtime-resource/formats/dds` |
+| DXBC (shader bytecode) | `CjsDxbcFormat` | `@carbonenginejs/runtime-resource/formats/dxbc` |
+| Compiled effect (`.sm_hi`, `.sm_lo`, `.sm_depth`) | `CjsHlslFormat` | `@carbonenginejs/runtime-resource/formats/hlsl` |
+| CEWG WebGL effect package | `CjsWebglFormat` | `@carbonenginejs/runtime-resource/formats/webgl` |
+| CEWGPU WebGPU effect package | `CjsWebgpuFormat` | `@carbonenginejs/runtime-resource/formats/webgpu` |
 | FBX (`.fbx`) | `CjsFbxFormat` | `@carbonenginejs/runtime-resource/formats/fbx` |
 | FLAC (`.flac`) | `CjsFlacFormat` | `@carbonenginejs/runtime-resource/formats/flac` |
 | GIF (`.gif`) | `CjsGifFormat` | `@carbonenginejs/runtime-resource/formats/gif` |

package/docs/formats/provenance.md

@@ -18,6 +18,10 @@ under `format-notices/<format>/`.
 | `format-black` | `9fcaaff9e5f28c90b628d8a10b7c79aff7913a90` | `CjsBlackFormat` | `@carbonenginejs/runtime-resource/formats/black` |
 | `format-cmf` | unborn working-tree snapshot | `CjsCmfFormat` | `@carbonenginejs/runtime-resource/formats/cmf` |
 | `format-dds` | `66fa149cd826e1114ad0be84479f89dee753ed76` | `CjsDdsFormat` | `@carbonenginejs/runtime-resource/formats/dds` |
+| `format-dxbc` | `3790bda40d7d0d3b774eeb4d82a13827dbe332df` | `CjsDxbcFormat` | `@carbonenginejs/runtime-resource/formats/dxbc` |
+| `format-hlsl` | `e494203f3a1e10866fbe148b460297045cd959ed` | `CjsHlslFormat` | `@carbonenginejs/runtime-resource/formats/hlsl` |
+| `format-webgl` | `428bc141d090b7416745ea43bf3fc320b9e99b43` | `CjsWebglFormat` | `@carbonenginejs/runtime-resource/formats/webgl` |
+| `format-webgpu` | `ffabae8c6a6c658f30807582300aa97522964ee7` | `CjsWebgpuFormat` | `@carbonenginejs/runtime-resource/formats/webgpu` |
 | `format-fbx` | `8d0fcc2fe44c8096b35e360a903bff30b49eb592` | `CjsFbxFormat` | `@carbonenginejs/runtime-resource/formats/fbx` |
 | `format-flac` | unborn working-tree snapshot | `CjsFlacFormat` | `@carbonenginejs/runtime-resource/formats/flac` |
 | `format-gif` | `5d831c5c0533a9579682f776274574289a520899` | `CjsGifFormat` | `@carbonenginejs/runtime-resource/formats/gif` |
@@ -156,9 +160,13 @@ snapshot must record its new source and digest here.
 - `format-carbon` remains the schema emitter/generator and build-time schema
   authority. Black consumes its published definitions; Red exposes the copied
   catalog but does not yet enforce it while reading YAML fields.
-- `format-dxbc`, `format-hlsl`, `format-webgl`, and `format-webgpu` are active
-  shader work and were not copied, annotated, or otherwise modified by this
-  migration.
+- The shader formats were excluded from the original migration while their
+  implementations were still being finished. That sequencing guard was lifted
+  on 2026-07-29 and they moved in as ordinary formats. All four landed:
+  `formats/dxbc`, `formats/hlsl`, `formats/webgl`, and `formats/webgpu`. Their
+  standalone repositories remain in place, unmodified by the move. Their
+  local-only test fixtures are game-derived and were deliberately not copied;
+  the suites that need them skip with an explicit reason.
 
 ## Typed-array ownership adjustments
 

package/docs/reference/classes/formats.md

@@ -133,6 +133,78 @@ LSB-first bit reader over a single 128-bit BC7 block bitstream for the software
 - Visibility: Internal
 - Kind: Internal implementation class
 
+### dxbc
+
+<!-- class:CjsDxbcFormat -->
+## `CjsDxbcFormat`
+
+DXBC shader-bytecode format profile that reads container chunks, signatures, and the decoded shader program from compiled Direct3D bytecode.
+
+- Export: `@carbonenginejs/runtime-resource/formats/dxbc`
+- Source: `src/formats/dxbc/CjsDxbcFormat.js`
+- Visibility: Public
+- Kind: Original CarbonEngineJS class
+
+<!-- class:DxbcReader -->
+## `DxbcReader`
+
+Bounded little-endian byte cursor over DXBC payloads, with optional shared string-table resolution.
+
+- Export: `None`
+- Source: `src/formats/dxbc/core/DxbcReader.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:DxbcContainer -->
+## `DxbcContainer`
+
+Parsed DXBC container that locates and exposes its four-character-code chunks.
+
+- Export: `None`
+- Source: `src/formats/dxbc/core/container.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:DxbcInstructionDecoder -->
+## `DxbcInstructionDecoder`
+
+Decodes the DXBC shader token stream into structured instructions, operands, and declarations.
+
+- Export: `None`
+- Source: `src/formats/dxbc/core/decoder.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:DxbcReadError -->
+## `DxbcReadError`
+
+Error raised when DXBC bytes are malformed, truncated, or structurally invalid.
+
+- Export: `None`
+- Source: `src/formats/dxbc/core/errors.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:DxbcShaderProgram -->
+## `DxbcShaderProgram`
+
+Decoded DXBC shader program: version, stage type, and its ordered instruction stream.
+
+- Export: `None`
+- Source: `src/formats/dxbc/core/program.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:DxbcSignatureChunk -->
+## `DxbcSignatureChunk`
+
+Parsed DXBC input, output, or patch-constant signature chunk and its parameter records.
+
+- Export: `None`
+- Source: `src/formats/dxbc/core/signature.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
 ### fbx
 
 <!-- class:CjsFbxFormat -->
@@ -263,6 +335,228 @@ Adaptive weighted symbol window that Oodle1 dictionaries use to model symbol pro
 - Visibility: Internal
 - Kind: Internal implementation class
 
+### hlsl
+
+<!-- class:CjsHlslFormat -->
+## `CjsHlslFormat`
+
+Compiled Carbon effect format profile that reads .sm_* shader packages into permutation, technique, and stage metadata.
+
+- Export: `@carbonenginejs/runtime-resource/formats/hlsl`
+- Source: `src/formats/hlsl/CjsHlslFormat.js`
+- Visibility: Public
+- Kind: Original CarbonEngineJS class
+
+<!-- class:HlslReader -->
+## `HlslReader`
+
+Bounded little-endian byte cursor over compiled effect payloads, with shared string-table resolution.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/HlslReader.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslEffectReadError -->
+## `HlslEffectReadError`
+
+Error raised when compiled effect bytes are malformed, truncated, or an unsupported version.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/HlslEffectReadError.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslEffectStateManager -->
+## `HlslEffectStateManager`
+
+Resolves and caches render-state setups referenced by a compiled effect while it is read.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/HlslEffectStateManager.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslRenderStateSetup -->
+## `HlslRenderStateSetup`
+
+Ordered render-state key and value records attached to one pass.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/HlslRenderStateSetup.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslResourceSetDescription -->
+## `HlslResourceSetDescription`
+
+Describes one resource set bound by a compiled effect stage.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/HlslResourceSetDescription.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslShaderBytecode -->
+## `HlslShaderBytecode`
+
+Stage bytecode payload carried by a compiled effect, with its stage type and name.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/HlslShaderBytecode.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslEffectRes -->
+## `HlslEffectRes`
+
+Parsed compiled effect resource: permutation axes, body offsets, and lazily decoded shader bodies.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/resources/HlslEffectRes.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslShaderPermutation -->
+## `HlslShaderPermutation`
+
+One permutation axis of a compiled effect, with its ordered options and default.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/resources/HlslShaderPermutation.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslEffectBindingManifest -->
+## `HlslEffectBindingManifest`
+
+Flattened per-stage binding manifest derived from a resolved effect description.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/shader/HlslEffectBindingManifest.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslEffectConstant -->
+## `HlslEffectConstant`
+
+Reflected shader constant: name, offset, size, type, dimension, and element count.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/shader/HlslEffectConstant.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslEffectDescription -->
+## `HlslEffectDescription`
+
+Decoded effect body: techniques, passes, stages, libraries, and top-level annotations.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/shader/HlslEffectDescription.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslEffectLibrary -->
+## `HlslEffectLibrary`
+
+Ray-tracing shader library record with its exports, payload size, and stage inputs.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/shader/HlslEffectLibrary.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslEffectParameterAnnotation -->
+## `HlslEffectParameterAnnotation`
+
+Typed annotation attached to a reflected effect parameter.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/shader/HlslEffectParameterAnnotation.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslEffectResource -->
+## `HlslEffectResource`
+
+Reflected shader resource or UAV binding with its register identity and array count.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/shader/HlslEffectResource.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslEffectStageInput -->
+## `HlslEffectStageInput`
+
+Reflected stage input: constants, resources, samplers, signatures, and default constant bytes.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/shader/HlslEffectStageInput.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslEffectTechnique -->
+## `HlslEffectTechnique`
+
+Named technique of a compiled effect body and its ordered passes.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/shader/HlslEffectTechnique.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslPass -->
+## `HlslPass`
+
+One pass of a technique, carrying its stage inputs and render states.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/shader/HlslPass.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslSamplerDescription -->
+## `HlslSamplerDescription`
+
+Sampler state description: filters, address modes, LOD bounds, and comparison function.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/shader/HlslSamplerDescription.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslSamplerSetup -->
+## `HlslSamplerSetup`
+
+Named or static sampler setup bound by a compiled effect stage.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/shader/HlslSamplerSetup.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslShader -->
+## `HlslShader`
+
+Decoded shader body for one permutation index, wrapping its effect description.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/shader/HlslShader.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:HlslShaderOption -->
+## `HlslShaderOption`
+
+One option value of a permutation axis.
+
+- Export: `None`
+- Source: `src/formats/hlsl/core/tr2/shader/HlslShaderOption.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
 ### jpeg
 
 <!-- class:CjsJpegFormat -->
@@ -443,6 +737,152 @@ WAV audio format profile that inspects RIFF chunk metadata and reads supported W
 - Visibility: Public
 - Kind: Original CarbonEngineJS class
 
+### shared effect layer
+
+<!-- class:ReflectionBlobStore -->
+## `ReflectionBlobStore`
+
+Content-addressed arena that deduplicates every exact byte payload referenced by portable effect reflection.
+
+- Export: `None`
+- Source: `src/format/effect/effectReflectionPackage.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+### webgl
+
+<!-- class:CjsWebglFormat -->
+## `CjsWebglFormat`
+
+WebGL shader format profile that translates compiled Carbon effects into CEWG packages carrying GLSL programs and portable source reflection.
+
+- Export: `@carbonenginejs/runtime-resource/formats/webgl`
+- Source: `src/formats/webgl/CjsWebglFormat.js`
+- Visibility: Public
+- Kind: Original CarbonEngineJS class
+
+<!-- class:CewgPackage -->
+## `CewgPackage`
+
+Reader for the flat CEWG container: chunk lookup, cached JSON decoding, and validated portable reflection access.
+
+- Export: `None`
+- Source: `src/formats/webgl/core/cewg/CewgPackage.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:CewgPackageBuilder -->
+## `CewgPackageBuilder`
+
+Builds a CEWG container from ordered, uniquely tagged chunks.
+
+- Export: `None`
+- Source: `src/formats/webgl/core/cewg/CewgPackageBuilder.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:WebglReader -->
+## `WebglReader`
+
+Bounded little-endian byte cursor over CEWG container bytes.
+
+- Export: `None`
+- Source: `src/formats/webgl/core/cewg/binary.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:WebglReadError -->
+## `WebglReadError`
+
+Error raised when CEWG bytes or package documents are malformed or inconsistent.
+
+- Export: `None`
+- Source: `src/formats/webgl/core/errors.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:DxbcGlslEmitter -->
+## `DxbcGlslEmitter`
+
+Translates decoded DXBC shader programs into GLSL for the WebGL backend.
+
+- Export: `None`
+- Source: `src/formats/webgl/core/glsl/DxbcGlslEmitter.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:DxbcGlslHelperRegistry -->
+## `DxbcGlslHelperRegistry`
+
+Collects and emits the GLSL helper functions a translated program requires.
+
+- Export: `None`
+- Source: `src/formats/webgl/core/glsl/DxbcGlslHelpers.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:DxbcGlslOperandFormatter -->
+## `DxbcGlslOperandFormatter`
+
+Formats DXBC operands, swizzles, and modifiers as GLSL expressions.
+
+- Export: `None`
+- Source: `src/formats/webgl/core/glsl/DxbcGlslOperandFormatter.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+### webgpu
+
+<!-- class:CjsWebgpuFormat -->
+## `CjsWebgpuFormat`
+
+WebGPU shader format profile that translates compiled Carbon effects into CEWGPU packages carrying WGSL programs, bind-group layouts, and portable source reflection.
+
+- Export: `@carbonenginejs/runtime-resource/formats/webgpu`
+- Source: `src/formats/webgpu/CjsWebgpuFormat.js`
+- Visibility: Public
+- Kind: Original CarbonEngineJS class
+
+<!-- class:CewgpuPackage -->
+## `CewgpuPackage`
+
+Reader for the flat CEWGPU container: chunk lookup, cached JSON decoding, and gated portable reflection and backend program access.
+
+- Export: `None`
+- Source: `src/formats/webgpu/core/cewgpu/CewgpuPackage.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:CewgpuPackageBuilder -->
+## `CewgpuPackageBuilder`
+
+Builds a CEWGPU container from ordered, uniquely tagged chunks.
+
+- Export: `None`
+- Source: `src/formats/webgpu/core/cewgpu/CewgpuPackageBuilder.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:WebgpuReader -->
+## `WebgpuReader`
+
+Bounded little-endian byte cursor over CEWGPU container bytes.
+
+- Export: `None`
+- Source: `src/formats/webgpu/core/cewgpu/binary.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:WebgpuReadError -->
+## `WebgpuReadError`
+
+Error raised when CEWGPU bytes or package documents are malformed or inconsistent.
+
+- Export: `None`
+- Source: `src/formats/webgpu/core/errors.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
 ### webm
 
 <!-- class:CjsWebmFormat -->

package/format-notices/dxbc/LICENSE

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

package/format-notices/dxbc/NOTICE

@@ -0,0 +1,20 @@
+carbonenginejs/format-dxbc
+==========================
+
+A pure-JavaScript reader for Microsoft DXBC (Direct3D compiled shader
+bytecode) containers and the SM4/SM5 instruction token stream.
+
+Contains no Microsoft, CarbonEngine, or Fenris Creations (CCP Games) code. The
+token-stream layout follows Microsoft's public d3d11TokenizedProgramFormat
+documentation. CarbonEngine and Fenris Creations (CCP Games) are mentioned for
+interoperability and target-ecosystem context only; DXBC itself is a Microsoft
+format. Unity Technologies' HLSLcc (MIT) was used as a behavioral reference
+while auditing instruction semantics; no HLSLcc source is included in this
+repository.
+
+This package is not affiliated with or endorsed by CCP Games.
+
+CarbonEngineJS-facing code is copyright cppctamber / CarbonEngineJS
+contributors.
+
+Repository license: MIT. See LICENSE.

package/format-notices/hlsl/LICENSE

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