@carbonenginejs/runtime-resource 0.12.2 → 0.14.0

package/docs/formats/webgl/README.md

@@ -3,40 +3,98 @@
 Status: Evolving
 Scope: `@carbonenginejs/runtime-resource/formats/webgl`
 Audience: Shader-tool authors, runtime integrators, and maintainers
-Summary: Explains CEWG packages, portable reflection, and DXBC-to-GLSL conversion.
+Summary: Explains WebGL effect packages, completeness, and DXBC-to-GLSL conversion.
 
 ## Purpose
 
-`@carbonenginejs/runtime-resource/formats/webgl` reads and builds CEWG packages and converts
-supported compiled Carbon effect stages into GLSL ES 3.00 package data. It
-preserves complete source permutation topology and, for version-15 effects,
-portable reflection for every unique body without creating live shader or GPU
-objects.
+`@carbonenginejs/runtime-resource/formats/webgl` builds effect packages and
+converts supported compiled Carbon effect stages into GLSL ES 3.00 package
+data. It preserves complete source permutation topology without creating live
+shader or GPU objects.
 
 ## Use this package when
 
-Use `format-webgl` to inspect or build CEWG bytes, translate supported DXBC
+Use `format-webgl` to inspect or build package bytes, translate supported DXBC
 stages, or convert one compiled effect while preserving all source
-permutations and portable reflection. Use runtime and engine packages for live
-shader objects, resource selection, bindings, and draws.
+permutations. Use runtime and engine packages for live shader objects, resource
+selection, bindings, and draws.
 
 ## Where it fits
 
 ```text
 compiled effect bytes
         |
-        +---- format-hlsl ---- portable source reflection
+        +---- format-hlsl ---- source parsing and permutation analysis
         +---- format-dxbc ---- decoded shader programs
         |
         v
      format-webgl
-  CEWG + GLSL ES 3.00
+  Carbon container + GLSL ES 3.00
         |
-        +---- runtime-resource ---- selection, cache, Tr2Shader hydration
+        +---- runtime-resource ---- selection, cache, Tr2Shader
         +---- runtime-trinity ----- effect/material facade and parameters
         `---- WebGL engine -------- programs, bindings, and draws
 ```
 
+The emitted artifact is a shared Carbon v15 container, not a tagged-chunk
+package; the GLSL replaces the DXBC in each stage's program slot. Backend body
+keys deliberately retain the historical `body_<offset>_<size>` form.
+`EFFECT_PERMUTATION_GRAPH_CHUNK` (`PGRF`) still records every Cartesian
+permutation, its option indices, its exact source record, and a
+content-deduplicated body identity.
+
+## Completeness
+
+The build result reports four flags plus a separate qualification:
+
+- `sourceComplete` is true only for version-15 effects.
+- `backendComplete` remains false. Successful translation does not yet prove
+  the engine's physical binding/layout and transform contract.
+- `runtimeComplete` remains false. Live shader objects and GPU handles are
+  outside the format package.
+- `qualification.ok` separately reports whether the selected WebGL programs
+  translated and formed the required raster/compute families. It is returned
+  frozen.
+
+Selected-only or technique/pass/stage-filtered packages still carry complete
+version-15 source coverage, but only their selected backend programs.
+
+Beyond those flags, `glslEffectCompleteness` runs checks that a translation can
+be structurally valid and still be wrong. Two families are worth knowing about:
+
+- `unlowered_local_light_family` — the recognised local-light constants
+  survived into GLSL without being lowered. It is deliberately scoped to that
+  one family: a general "every declared resource is used" rule fires on good
+  builds, because Carbon routinely describes resources a body does not read.
+- `resource_transform_underfilled`, `_layer_gap`, `_carrier_undeclared`, and
+  `_input_still_bound` — a declared resource transform (the detail-map array is
+  the live case) did not complete. Each check is scoped to the stage the
+  transform names, and transform vocabulary is WGSL's: a transform saying
+  `fragment` applies to the WebGL `pixel` stage. Running them across every
+  stage in a pass instead produces 48 false positives.
+
+### Measured link rate
+
+Across all 4,833 shipped compiled effects, **9,319 of 9,321 emitted programs
+compile and link in a real WebGL2 context.** Before the DXBC SM5.1 range-id
+operand fix the rate was near 61%, and the failures were the lesser half of the
+problem: shaders that *did* link were reading constant-buffer rows off the
+register number, and in 56 of 161 multi-dimensional resource operands were
+bound to the wrong texture entirely.
+
+## Tier and permutation policy
+
+For EVE shader work:
+
+- High is `.sm_depth`.
+- Medium is `.sm_hi`.
+- Low is `.sm_lo`.
+- Unpacked Quad V5 evidence must explicitly select `SOPPT_ENABLED`; the
+  default permutation is commonly PPT-off and is not representative.
+
+Always resolve an option tuple against the current source axes. Do not persist
+a permutation index across builds.
+
 ## Start here
 
 ```js
@@ -49,7 +107,7 @@ const packageData = CjsWebglFormat.read(packageBytes);
 ## Documentation map
 
 - [Architecture and ownership](architecture.md)
-- [Effect reflection contract](effect-reflection.md)
+- [Carbon compiled-effect container](../carbon-effect-container.md)
 - [Constant-buffer layouts](carbon-constant-layouts.md)
 - [Declaration and I/O lowering](decl-io.md)
 - [Structured-memory lowering](memory-structured.md)

package/docs/formats/webgl/architecture.md

@@ -8,37 +8,37 @@ Summary: Defines the package's compiler, container, runtime, and engine boundari
 ## Purpose
 
 `format-webgl` is the transformation and package layer between compiled
-Carbon-style effects and WebGL engine realization. It emits portable CEWG data
-and GLSL ES 3.00 without constructing mutable runtime shader classes or WebGL
-objects.
+Carbon-style effects and WebGL engine realization. It emits Carbon container
+bytes and GLSL ES 3.00 without constructing mutable runtime shader classes or
+WebGL objects.
 
 ## Dependency direction
 
 ```text
 @carbonenginejs/runtime-resource/formats/hlsl
           |
-          +---- effect parsing and portable reflection
+          +---- effect parsing and permutation analysis
           |
           v
 @carbonenginejs/runtime-resource/formats/webgl <---- @carbonenginejs/runtime-resource/formats/dxbc
           |                              decoded DXBC
           |
-          +---- CEWG bytes, metadata, reflection, GLSL
+          +---- Carbon container bytes, metadata, GLSL
           |
-          +---- runtime-resource ---- package selection + Tr2Shader hydration
+          +---- runtime-resource ---- option selection + Tr2Shader
           +---- runtime-trinity ----- effect/material facade + parameters
           `---- WebGL engine -------- GPU realization
 ```
 
 Tools may call the public byte-oriented API, but the format package does not
-import the toolchain. Runtime packages consume immutable package data through
-an explicit adapter boundary.
+import the toolchain. Runtime packages read the emitted container bytes
+directly.
 
 ## Owned responsibilities
 
-- Reading, inspecting, validating, and building CEWG v1 containers.
+- Building the shared Carbon v15 container for the WebGL backend, with GLSL in
+  each stage's program slot.
 - Preserving every source permutation and unique body identity.
-- Packing complete version-15 portable reflection and exact shared bytes.
 - Translating supported DXBC vertex, pixel, and bounded map-style compute
   stages into GLSL ES 3.00.
 - Preserving backend bodies, stages, programs, manifests, and render states.
@@ -46,12 +46,11 @@ an explicit adapter boundary.
 
 ## Ownership elsewhere
 
-- `format-hlsl` owns compiled-effect parsing and the portable reflection
-  schema.
+- `format-hlsl` owns compiled-effect parsing and permutation analysis.
 - `format-dxbc` owns DXBC decoding.
-- `runtime-resource` owns `Tr2EffectRes`, package bytes, option selection,
-  per-permutation cache identity, canonical `Tr2Shader`, reflection records,
-  sampler setup records, and portable hydration.
+- `runtime-resource` owns `Tr2EffectRes`, the container bytes, option
+  selection, per-permutation cache identity, canonical `Tr2Shader`, reflection
+  records, and sampler setup records.
 - `runtime-trinity` owns the mutable `Tr2Effect`/`Tr2Material` facade,
   parameters, authored options, and sampler overrides.
 - The WebGL engine owns program compilation, locations, layouts, resource
@@ -59,12 +58,12 @@ an explicit adapter boundary.
 
 ## Completeness boundary
 
-Version-15 CEWG can be source-complete while remaining backend- and
+A version-15 build can be source-complete while remaining backend- and
 runtime-incomplete. Successful GLSL translation and compile/link do not prove
 the engine's physical binding/layout contract or a rendered result.
 
 ## Related documentation
 
 - [Package documentation](README.md)
-- [Effect reflection contract](effect-reflection.md)
+- [Carbon compiled-effect container](../carbon-effect-container.md)
 - [Class-purpose catalog](reference/classes/README.md)

package/docs/formats/webgl/carbon-constant-layouts.md

@@ -5,7 +5,7 @@ Scope: Carbon/Trinity constant-buffer layouts used by `@carbonenginejs/runtime-r
 Audience: Shader translators, runtime packers, and engine integrators
 Summary: Maps Carbon constant-buffer registers and field layouts for WebGL integration.
 
-> Produced 2026-07-05 from ../carbonengine source (authoritative) for the CEWG
+> Produced 2026-07-05 from ../carbonengine source (authoritative) for the Carbon WebGL
 > per-frame/per-object packer in ccpwgl. All register offsets are in float4
 > (vec4) units. File references are relative to
 > `../carbonengine/trinity/trinity/`.
@@ -271,8 +271,8 @@ cascaded-shadow + froxel tail (95 regs) is absent in ccpwgl.
 In Carbon DX11, cb3[26]=boneOffsets, cb3[27]=morph, cb3[28]=customData, and
 joints live in the separate `BoneTransforms` structured buffer (69 max,
 Float4x3). ccpwgl WebGL2 splices 58 joints inline at cb3[26..199] instead.
-The CEWG path keeps Carbon's shape: cb3 stays 29 regs, joints go to the
-dedicated CewgSb UBO (capacity 69). Bone-count note: Carbon
+The Carbon WebGL path keeps Carbon's shape: cb3 stays 29 regs, joints go to the
+dedicated CjsSb UBO (capacity 69). Bone-count note: Carbon
 TR2_MAX_BONES_PER_MESHAREA=69 vs ccpwgl inline 58 (likely a WebGL uniform
 budget choice, not a Carbon constant).
 

package/docs/formats/webgl/decl-io.md

@@ -543,7 +543,7 @@ target lowering is "emit nothing" — worth flagging clearly to the implementing
 engineer so they don't go looking for a `s0` GLSL symbol; the register-stable name
 `s0` only shows up in Carbon binding-manifest metadata (`CARBONENGINEJS-FORK.md`:
 "`s0`" is one of the register-stable symbols this fork preserves for
-`Tr2EffectBindingManifest`), not in the GLSL source text itself.
+`HlslEffectBindingManifest`), not in the GLSL source text itself.
 
 **Confidence: high** — the Vulkan/non-Vulkan branch is unconditional and
 unambiguous; the only judgment call is confirming this project always wants
@@ -622,7 +622,7 @@ attribute channels, including blend indices, as float vertex attributes via
 `gl.vertexAttribPointer` (not `vertexAttribIPointer`)** — a real `uvec4 in_...`
 declaration either fails to link against that float-typed buffer binding, or links
 but silently produces garbage/invisible geometry
-(`028-cewg-skinned-blend-index-abi-lowering.md`: "Raw CEWG validation can link
+(`028-cewg-skinned-blend-index-abi-lowering.md`: "Raw Carbon WebGL validation can link
 integer attributes, but ccpwgl runtime binding can still fail or produce invisible
 geometry if the source reaches compile as `uvec4`."). The proven, validated fix
 (`028-...md`; `TRANSPILING-GAPS.md` "Ranked helper action plan" documents the general
@@ -635,7 +635,7 @@ and bitcast at every *use* site instead: any instruction reading `in_BLENDINDICE
 as an index wraps it in `floatBitsToUint(in_BLENDINDICES0)` (or, if the actual buffer
 data was uploaded as plain float index values rather than bit-pattern-encoded uints —
 verify per-attribute — a plain `uint(in_BLENDINDICES0.x)` truncating conversion
-instead of a bitcast; the CEWG lowering evidence describes casting at use sites but
+instead of a bitcast; the Carbon WebGL lowering evidence describes casting at use sites but
 does not pin down which of these two forms every producer used, see Confidence
 below). This is the **general form** of the family-level "every register is a float
 vec4" convention applied specifically to `dcl_input`: unlike the `r#` temp file

package/docs/formats/webgl/memory-structured.md

@@ -171,10 +171,18 @@ runnable WebGL2 GLSL for, restricted to the `BoneTransforms` skinning case
    byteOffset" agreement check, silently no-opping the rewrite. The previous
    worked example here was internally inconsistent with the very rewrite
    contract it was illustrating.
-2. A package-time rewrite pass (`scripts/packageTr2WebglEffect.js`,
-   functions `lowerWebgl2SkinningAbi` at lines 826-864 and
-   `lowerStructuredBoneLoad` at lines 873-902) runs over that generated GLSL text
-   and performs, **in this exact order**:
+2. A package-time rewrite pass over the generated GLSL text, performing the
+   steps below **in this exact order**.
+
+   > **Superseded (2026-08-02).** This pass no longer exists. The emitter now
+   > declares vertex-stage structured buffers as `std140` UBOs when it emits the
+   > shader, with real bindings, rather than rewriting text afterwards — see
+   > `DxbcGlslEmitter.js`, the `dcl_resource_structured` vertex branch. The
+   > regex functions it describes were deleted from
+   > `scripts/packageTr2WebglEffect.js`, so the line citations below point at
+   > nothing. The section is kept because it records *why* each rewrite was
+   > needed, which the ccpwgl runtime ABI still constrains; read it as history,
+   > not as a description of the code.
    1. Strip the `#ifdef GL_ARB_shader_storage_buffer_object` /
       `GL_ARB_shader_image_load_store` extension guard blocks (regexes at
       `packageTr2WebglEffect.js:832-833`).
@@ -215,7 +223,7 @@ runnable WebGL2 GLSL for, restricted to the `BoneTransforms` skinning case
       place** (`packageTr2WebglEffect.js:886,890,895,898` all `return match`) —
       this is a silent-failure edge case the implementing engineer must guard
       against (add a diagnostic) rather than trust to fail loudly.
-   8. If any rewrite happened, inject a `// CEWG: BoneTransforms lowered to cb3
+   8. If any rewrite happened, inject a `// Carbon WebGL: BoneTransforms lowered to cb3
       JointMat rows.` marker comment after `#version 300 es`
       (`packageTr2WebglEffect.js:859-861`).
 
@@ -229,8 +237,19 @@ pixel `usampler2D` data textures (see `DxbcGlslEmitter.js` `dcl_resource_structu
 pixel branch), which compiles but consumes a texture unit each; on real drivers
 the `_depth` quad variants overflow `MAX_TEXTURE_IMAGE_UNITS`(16).
 
-**Resolution (2026-07-08) — stub, not rewrite.** Since CEWG does not support this
-tiled lighting, the packager can DROP it instead of lowering it. Run
+**Superseded (2026-08-02) — the lights fit, and are kept.** The two light
+buffers now lower to a single packed `RGBA32UI` data texture rather than one
+texture each, which frees two units, and the `Detail1/2/3Map` textures merge into
+one array texture, which frees one or two more. Both `.sm_depth` quad variants
+land at or under 16 with lighting intact: `unpackedskinned_quaddetailv5` at 15,
+`unpackedskinned_quadheatdetailv5` at 16. See
+`/docs/contracts/webgl2-texture-budget.md`. Dropping the lights is still
+available as `--stub-light-resources` for isolating a lighting problem, but it is
+no longer the answer to the budget. The paragraph below describes that opt-in
+path and remains accurate.
+
+**Earlier resolution (2026-07-08) — stub, not rewrite.** Since Carbon WebGL does not
+support this tiled lighting, the packager can DROP it instead of lowering it. Run
 `packageTr2WebglEffect.js --stub-light-resources`: it resolves the light resource
 names (`LightBuffer`, `LightIndexBuffer`, `LightProfileArray`) to `t#` registers
 from the Carbon `.sm` reflection (RDEF is stripped, so names live only there —
@@ -239,7 +258,7 @@ sb11/sb12/s13) and passes them to `emitGlsl` as `stubResourceRegisters`. The
 emitter then drops their decl+binding and lowers reads to `uintBitsToFloat(0u)`
 (structured) / `vec4(0.0)` (sampled) — zeroing the per-tile light count makes the
 light loop dead. The packager also strips those `resource` bindings from the
-manifest JSON (`stripLightResourcesFromManifest`) so the CEWG runtime does not
+manifest JSON (`stripLightResourcesFromManifest`) so the Carbon WebGL runtime does not
 synthesize a texture def (glType 0 → "Invalid shader texture definition") for the
 now-undeclared light buffers. Opt-in, default off; every other package is
 unchanged. A functional light constant-buffer path remains possible but was not

package/docs/formats/webgl/texture-sample.md

@@ -74,7 +74,7 @@ Ground truth: `toGLSLOperand.cpp:1738-1882` (`ResourceName`, `TextureSamplerName
   `ResourceName`, when `useCombinedTextureSamplers` is true — `toGLSLInstruction.cpp:1332-1336`).
   This is deliberate register-identity preservation per `CARBONENGINEJS-FORK.md`
   ("emitting deterministic register-stable GLSL symbols such as `cb3`, `t0`, and `s0`" /
-  "preserving enough register identity for `Tr2EffectBindingManifest`... and eventual
+  "preserving enough register identity for `HlslEffectBindingManifest`... and eventual
   trinityjs binding work"): the emitter must keep declaring the bare `t#` uniform even
   though the sampling calls use the combined name, so downstream tooling can still find a
   `t#`-named uniform to correlate against Carbon metadata.

package/docs/formats/webgpu/README.md

@@ -3,7 +3,7 @@
 Status: Evolving
 Scope: `@carbonenginejs/runtime-resource/formats/webgpu`
 Audience: Shader-tool authors, engine integrators, and maintainers
-Summary: Explains the Carbon-record CEWGPU format, compiled-effect conversion API, and bounded DXBC-to-WGSL compiler.
+Summary: Explains the Carbon-record Carbon WebGPU format, compiled-effect conversion API, and bounded DXBC-to-WGSL compiler.
 
 ## Purpose
 
@@ -26,7 +26,7 @@ translation gate. Backend and runtime completeness remain broader gates.
 
 Use the WebGPU format subpath when you need to:
 
-- inspect or build a `.cewgpu` package;
+- inspect or build a `.carbonwebgpu` package;
 - analyze caller-supplied compiled effect bytes;
 - lower supported DXBC vertex and fragment programs to WGSL;
 - build one collision-free WebGPU binding layout across a complete pass; or
@@ -79,6 +79,6 @@ For compiled-effect conversion, continue with the
 - [Architecture and boundaries](architecture.md)
 - [Effect packaging guide](guides/effect-packaging.md)
 - [Public API reference](reference/api.md)
-- [CEWGPU package format](formats/cewgpu.md)
+- [Carbon WebGPU package format](formats/carbon-webgpu.md)
 - [WGSL compatibility](reference/wgsl-compatibility.md)
 - [Class-purpose catalog](reference/classes/README.md)

package/docs/formats/webgpu/architecture.md

@@ -23,7 +23,7 @@ creating live GPU objects.
 @carbonenginejs/runtime-resource/formats/webgpu <---- @carbonenginejs/runtime-resource/formats/dxbc
           |                              decoded DXBC
           |
-          +---- CEWGPU bytes, analysis, WGSL, canonical layouts
+          +---- Carbon WebGPU bytes, analysis, WGSL, canonical layouts
           |
           v
 @carbonenginejs/engine-webgpu
@@ -35,7 +35,7 @@ then package data to the engine.
 
 ## Owned responsibilities
 
-- Reading, inspecting, and building Carbon-record CEWGPU containers.
+- Reading, inspecting, and building Carbon-record Carbon WebGPU containers.
 - Resolving one compiled-effect permutation and complete pass.
 - Preserving every source permutation row and representable non-program
   description field; non-dynamic sampler names are unrecoverable and stage
@@ -55,8 +55,7 @@ then package data to the engine.
 ## Ownership elsewhere
 
 - `@carbonenginejs/runtime-resource/formats/hlsl` owns compiled-effect parsing, permutation resolution,
-  unique-body enumeration, binding-manifest interpretation, and the shared
-  body-local portable reflection schema/validator.
+  unique-body enumeration, and binding-manifest interpretation.
 - `@carbonenginejs/runtime-resource/formats/dxbc` owns DXBC container and instruction decoding.
 - `@carbonenginejs/engine-webgpu` owns `GPUDevice`, shader-module compilation, bind groups,
   pipelines, resource realization, device loss, and draw execution.
@@ -71,7 +70,7 @@ then package data to the engine.
 
 The public class accepts `ArrayBuffer`, typed-array, and compatible byte views.
 Its source does not read files, inspect processes, or invoke native programs.
-This allows applications to fetch or select bytes and build CEWGPU data in a
+This allows applications to fetch or select bytes and build Carbon WebGPU data in a
 browser.
 
 The repository's command-line scripts are development adapters over the same
@@ -92,5 +91,5 @@ listed in [WGSL compatibility](reference/wgsl-compatibility.md).
 ## Related documentation
 
 - [Package documentation](README.md)
-- [CEWGPU package format](formats/cewgpu.md)
+- [Carbon WebGPU package format](formats/carbon-webgpu.md)
 - [Public API reference](reference/api.md)

package/docs/formats/webgpu/formats/{cewgpu.md → carbon-webgpu.md}

@@ -1,4 +1,4 @@
-# CEWGPU effect container
+# Carbon WebGPU effect container
 
 Status: Evolving
 Scope: `@carbonenginejs/runtime-resource/formats/webgpu`
@@ -7,7 +7,7 @@ Summary: Defines the Carbon v15 record container used for WebGPU effects, its ba
 
 ## Purpose
 
-A `.cewgpu` file is a stock Carbon version-15 compiled-effect container whose
+A `.carbonwebgpu` file is a stock Carbon version-15 compiled-effect container whose
 program slots carry WGSL instead of DXBC. It preserves every permutation row
 and representable non-program description/reflection fields. Non-dynamic
 sampler names are unrecoverable and stage order is canonicalized. Source-stage
@@ -15,10 +15,10 @@ programs are not stored: a translated slot contains WGSL and an untranslated slo
 Each translated pass may also carry one WebGPU backend block containing
 bind-group layouts and resource transforms.
 
-There is no CEWGPU-specific magic, envelope, payload tag, or container version.
+There is no Carbon WebGPU-specific magic, envelope, payload tag, or container version.
 Backend identity comes from the resource path, such as `effect.webgpu/`, just
 as Carbon selects `effect.dx11/`, `effect.dx12/`, or `effect.metal/`.
-`isCewgpu(bytes)` is therefore only a Carbon-v15 shape check. It cannot prove
+`isCarbonWebgpu(bytes)` is therefore only a Carbon-v15 shape check. It cannot prove
 that arbitrary version-15 bytes contain WGSL.
 
 ## Wire layout
@@ -34,7 +34,7 @@ outline, the file contains:
   emitted-description-byte aliases sharing that body; and
 - one optional backend block after each pass's render states.
 
-The Carbon region is backend-invariant. CEWGPU substitutes:
+The Carbon region is backend-invariant. Carbon WebGPU substitutes:
 
 - UTF-8 WGSL in each translated stage's `shaderData`;
 - the fixed entry point `main`, which is omitted from the wire because every
@@ -48,7 +48,7 @@ remain represented without pretending WebGPU can execute them.
 
 ## No stored chunks
 
-The former flat CEWGPU format stored `INFO`, `META`, `PGRF`, `RFLX`, `RBLB`,
+The former flat Carbon WebGPU format stored `INFO`, `META`, `PGRF`, `RFLX`, `RBLB`,
 `ANLS`, `WGSL`, and `WGSB` chunks. The current wire stores none of them.
 
 Equivalent read surfaces are derived from the one Carbon record tree:
@@ -65,19 +65,18 @@ Equivalent read surfaces are derived from the one Carbon record tree:
 
 `Read(..., { emit: "json" })` returns these compatibility views as plain data.
 They are not independent stored documents and carry no cross-document digests.
-`Read(..., { emit: "raw" })` returns the internal `CewgpuContainer` reader.
+`Read(..., { emit: "raw" })` returns the internal `CarbonWebgpuContainer` reader.
 There is no `chunks` array and no generic `Build(chunks)` API.
 
 ## Building
 
 `BuildEffect` accepts version-15 compiled-effect bytes only. It parses the
 complete input, resolves the requested permutation, lowers selected programs,
-and writes a new Carbon v15 container. Full portable source reflection exists
-in the in-memory build result; source-stage program bytes and the caller's
-source hash are not retained in the emitted wire.
+and writes a new Carbon v15 container. Source-stage program bytes and the
+caller's source hash are not retained in the emitted wire.
 
 The returned build record is richer than the bytes. Its `info`, `metadata`,
-`permutationGraph`, `reflection`, `analysis`, `wgsl`, `backendBodySet`, and
+`permutationGraph`, `analysis`, `wgsl`, `backendBodySet`, `inspection`, and
 `qualification` fields are build-time evidence for callers. They must not be
 interpreted as separate records stored in the container.
 

package/docs/formats/webgpu/guides/effect-packaging.md

@@ -1,9 +1,9 @@
-# Build a CEWGPU package from compiled effect bytes
+# Build a Carbon WebGPU package from compiled effect bytes
 
 Status: Evolving
 Scope: `@carbonenginejs/runtime-resource/formats/webgpu`
 Audience: Shader-tool authors and engine integrators
-Summary: Shows how to translate version-15 compiled effects into Carbon-record CEWGPU bytes.
+Summary: Shows how to translate version-15 compiled effects into Carbon-record Carbon WebGPU bytes.
 
 ## Purpose
 
@@ -57,8 +57,8 @@ The emitted bytes are a stock Carbon v15 effect container:
 - translated passes may carry a WebGPU backend block with bind-group layouts
   and resource transforms.
 
-Source-stage DXBC and the original source hash are not stored in CEWGPU bytes.
-Full portable source reflection remains available only in the in-memory
+Source-stage DXBC and the original source hash are not stored in Carbon WebGPU bytes.
+The build result no longer carries any source-reflection document; it was removed with the intermediate format. What remains in memory is
 `BuildEffect` result.
 
 There are no stored `INFO`, `META`, `PGRF`, `RFLX`, `ANLS`, `WGSL`, or `WGSB`
@@ -96,12 +96,10 @@ The returned record contains build-time evidence in addition to `bytes`:
 
 | Field | Purpose |
 | --- | --- |
-| `bytes` | Carbon v15 CEWGPU bytes. |
+| `bytes` | Carbon v15 Carbon WebGPU bytes. |
 | `info` | Producer, source, translation-scope, and completeness evidence. |
 | `metadata` | Resolved selection and caller provenance. |
 | `permutationGraph` | Complete source permutation and body-alias view. |
-| `reflection` | Complete portable source reflection used while building. |
-| `reflectionBlobs` | Exact portable-reflection payload bytes. |
 | `analysis` | Selected-body diagnostic analysis. |
 | `wgsl` | Emitted shaders, layouts, and transforms. |
 | `backendBodySet` | All-body translation result, or `null` in selected mode. |
@@ -185,7 +183,7 @@ in-memory derived status.
 
 ## Related documentation
 
-- [CEWGPU effect container](../formats/cewgpu.md)
+- [Carbon WebGPU effect container](../formats/carbon-webgpu.md)
 - [Public API reference](../reference/api.md)
 - [WGSL compatibility](../reference/wgsl-compatibility.md)
 - [Carbon compiled-effect container](../../carbon-effect-container.md)

package/docs/formats/webgpu/reference/api.md

@@ -39,10 +39,10 @@ const reader = new WebgpuFormat({
 | `SetClass(type, Class)` | Registers or removes one constructor. |
 | `GetClass(type)` | Returns one registered constructor. |
 | `HasClass(type)` | Reports whether a constructor is registered. |
-| `Read(bytes, options?)` | Reads Carbon-record CEWGPU bytes. |
+| `Read(bytes, options?)` | Reads Carbon-record Carbon WebGPU bytes. |
 | `Inspect(bytes, options?)` | Returns a compact container summary. |
 | `AnalyzeEffect(bytes, options?)` | Analyzes compiled-effect bytes without packaging. |
-| `BuildEffect(bytes, options?)` | Translates a version-15 effect to CEWGPU bytes. |
+| `BuildEffect(bytes, options?)` | Translates a version-15 effect to Carbon WebGPU bytes. |
 | `BuildShaderIr(input, options?)` | Builds validated shader IR from DXBC or decoded input. |
 | `BuildWgsl(input, options?)` | Emits supported shader IR as WGSL. |
 | `BuildWgslBindingPlan(programs, options?)` | Allocates one binding layout across a pass. |
@@ -56,18 +56,18 @@ not a generic chunk container.
 
 | Static helper | Purpose |
 | --- | --- |
-| `isCewgpu(bytes)` | Reports whether bytes have the Carbon-v15 shape. |
+| `isCarbonWebgpu(bytes)` | Reports whether bytes have the Carbon-v15 shape. |
 | `read(bytes, options?)` | Reads one container. |
 | `inspect(bytes, options?)` | Inspects one container. |
 | `analyzeEffect(bytes, options?)` | Analyzes one compiled effect. |
-| `buildEffect(bytes, options?)` | Builds CEWGPU bytes from a version-15 effect. |
+| `buildEffect(bytes, options?)` | Builds Carbon WebGPU bytes from a version-15 effect. |
 | `buildShaderIr(input, options?)` | Builds shader IR. |
 | `buildWgsl(input, options?)` | Emits WGSL. |
 | `buildWgslBindingPlan(programs, options?)` | Allocates a pass binding plan. |
 | `buildWgslSet(entries)` | Builds a portable WGSL set. |
 | `toJSON(value)` | Converts output to JSON-compatible data. |
 
-`isCewgpu` checks the first dword for Carbon version 15. CEWGPU has no private
+`isCarbonWebgpu` checks the first dword for Carbon version 15. Carbon WebGPU has no private
 magic or payload tag, so this is a shape check rather than backend identity.
 Callers establish identity through the resource path that supplied the bytes.
 
@@ -114,11 +114,10 @@ DXBC instructions and compiler IR.
 
 `BuildEffect` is narrower: current packaging requires the version-15 record
 layout. The wire retains every permutation row and non-program description
-field that the mapping can represent; non-dynamic sampler names are
-unrecoverable and stage order is canonicalized. Source-stage DXBC and the
-caller's source hash are not retained in the wire. The build result retains
-full portable source reflection, including source program bytes. Compiler IR
-is transient and is neither stored in the wire nor returned by `BuildEffect`.
+field that the mapping can represent, including non-dynamic sampler names and
+the file's authored pass-stage order. Source-stage DXBC and the caller's source
+hash are not retained in the wire. Compiler IR is transient and is neither
+stored in the wire nor returned by `BuildEffect`.
 
 Unknown, duplicate, or unresolved permutation assertions fail closed.
 
@@ -148,7 +147,7 @@ consumer's resource path.
 
 - `bytes`;
 - build-time `info` and `metadata`;
-- `permutationGraph`, portable `reflection`, and `reflectionBlobs`;
+- `permutationGraph`;
 - selected `analysis` and `wgsl`;
 - `backendBodySet` for all mode;
 - an `inspection` obtained by rereading the emitted bytes; and
@@ -192,6 +191,6 @@ points, and malformed backend blocks.
 ## Related documentation
 
 - [Effect packaging guide](../guides/effect-packaging.md)
-- [CEWGPU effect container](../formats/cewgpu.md)
+- [Carbon WebGPU effect container](../formats/carbon-webgpu.md)
 - [WGSL compatibility](wgsl-compatibility.md)
 - [Class-purpose catalog](classes/README.md)

package/docs/formats/webgpu/reference/wgsl-compatibility.md

@@ -1273,10 +1273,10 @@ used before the Carbon-container switchover. Their corpus counts remain
 compiler and provenance evidence; `INFO`, `META`, `PGRF`, `RFLX`, `RBLB`,
 `ANLS`, and `WGSL` are no longer stored chunks. Current bytes are Carbon
 version-15 records with derived compatibility views. See
-[CEWGPU effect container](../formats/cewgpu.md).
+[Carbon WebGPU effect container](../formats/carbon-webgpu.md).
 
 At the 0.4.2 checkpoint, `BuildEffect` emitted selected-effect INFO schema
-version 2 while the binary CEWGPU container remained version 1. INFO v2
+version 2 while the binary Carbon WebGPU container remained version 1. INFO v2
 recorded the WebGPU target,
 backend-package and translator semantic versions, and a lower-case SHA-256
 digest computed over the exact compiled-effect input byte view. A conflicting
@@ -1311,9 +1311,8 @@ are unchanged; old readers tolerate the additive chunk.
 
 The 0.4.4 selected-reflection checkpoint adds complete version-15 reflection
 for the selected body in `RFLX`, with every exact byte vector externalized into
-canonical deduplicated `RBLB` records. The upstream
-`@carbonenginejs/runtime-resource/formats/hlsl/portable` v1 validator is rerun after
-reconstruction; package validation also reconciles INFO source identity,
+canonical deduplicated `RBLB` records. A body-reflection validator was rerun
+after reconstruction; package validation also reconciles INFO source identity,
 META/PGRF body identity, and every ANLS pass/stage source record. Earlier
 effect versions retain the legacy package surface. All-body reflection remains
 unsupported, so source/backend/runtime completeness remain false.
@@ -1335,7 +1334,7 @@ qualified packages:
 A packed-package Chrome smoke builds and reads a real version-15 effect in the
 browser, resolves all reflected byte references, structured-clones the JSON
 view, and fails closed after raw blob corruption with no console errors. The
-engine prepares a newly generated real `quads.sm_hi` CEWGPU package with 10
+engine prepares a newly generated real `quads.sm_hi` Carbon WebGPU package with 10
 canonical bindings and zero WGSL warnings. The high-tier
 `unpacked_quadv5.sm_depth` DX11 self-pair remains exhaustively qualified across
 480 bodies, 4,480 emitted stage occurrences, and 2,240 ready pass occurrences;
@@ -1347,8 +1346,12 @@ reflection for every unique version-15 source body while ANLS/WGSL remain
 selected-backend data. `GetPortableEffectReflection(permutationIndex)` exposes
 any package permutation as a fresh, format-hlsl-validated document with owned
 byte payloads. `runtime-resource` owns `Tr2EffectRes` selection, canonical
-`Tr2Shader` hydration, and the per-index cache; renderer-owned handles remain
-an engine concern.
+`Tr2Shader` construction, and the per-index cache; renderer-owned handles
+remain an engine concern.
+
+That RFLX/RBLB apparatus and its accessor were removed after this checkpoint.
+`Tr2EffectRes` now reads the Carbon container directly; the entries above are
+retained as the record of what the format did at the time.
 
 An exhaustive build-3444265 oracle retains 507 qualified, 30 unsupported, and
 zero failed/unqualified results. For all 507 emitted packages, `META`, `PGRF`,