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

package/docs/trinity/reference/implementation-status.md

@@ -184,23 +184,17 @@ marked `@io.always`. Controller float variables deliberately carry that marker
 so equal writes still reach their destination and dirty mask. Initialization
 is silent, and the masks remain frame-consumed; those semantics are part of the
 parity gate rather than incidental test behavior.
-
-## Current runtime limits
-
-- Device creation, GPU resources, draw submission, presentation, and
-  device-loss recovery require an engine package.
-- Mesh batches leave collection with complete draw arguments. The two
-  suballocation bases are read from the geometry resource's allocations and are
-  zero until an engine writes them, which is the correct answer for a backend
-  that gives each mesh its own buffers rather than pooling.
-- The frame body is ordered by core's `CjsFrameDriver`, which requires exact
-  lifecycle, render-context, and render-job identities. Presentation is not
-  part of the frame: the previous frame is presented at the top of the next
-  tick, and the tick is engine-owned.
-- Vertex-declaration matching is resolved once, by semantic and index, into a
-  binding plan engines consume. A shader input the mesh cannot supply is
-  reported rather than resolved, because the two references legitimately differ
-  on the substitute.
+
+## Current runtime limits
+
+The architecture owns [mesh draw arguments](../architecture.md#render-batch-contract),
+[frame/tick ordering](../architecture.md#frame-contract), and
+[vertex-declaration matching](../architecture.md#vertex-declaration-matching).
+`CjsFrameDriver` requires exact lifecycle, render-context, and render-job identities.
+Catalog completeness and promotion gates are below.
+
+- Device creation, GPU resources, draw submission, presentation, and
+  device-loss recovery require an engine package.
 - Per-object constant records join the layout's declared stages to a
   technique's shader-type mask. Carbon's `Standard` and `Skinned` per-object
   classes disagree on gating the pixel payload; this package takes the gated
@@ -219,64 +213,45 @@ parity gate rather than incidental test behavior.
   counters, dimensions, gamma/mip/upscaling settings, atlas settings, and an
   optional shadow map. Pixel fill precedes vertex fill because it resets the
   upscaling amount read by the vertex record.
-- Per-object constant data is complete on the CPU side: every catalogued struct
-  with a Carbon producer in this package is filled. The exceptions are values
-  that are literally GPU addresses - bone-ring and morph-ring offsets - which
-  keep their defaults until an engine supplies them, and `Tr2PerObjectVSData`,
-  whose only Carbon filler is an interior placeable that is not a
-  Trinity-layer class.
-- Generated classes may expose explicit obligations, but manual behavior
-  belongs in maintained source from the first substantive edit. The five
-  legacy Sprite2D files that carried implementations, their portable
-  `Tr2Sprite2dContainerBase`, the corrected `EveSmartLightSpotLight`, and
-  implemented `Obb` were promoted on 2026-08-22. The rewritten portable
-  `Tr2ProjectBoundingBoxBracket` projection and its active-context curve path
-  were promoted in the same tranche. `Tr2Sprite2dRenderJob` now owns its
-  portable render-job traversal and picking behavior, while the common
-  Sprite2D base starts with Carbon's picking state enabled and throws for
-  unimplemented concrete traversal contracts. `Tr2Transform` now owns the
-  common curve, SRT, mesh, sorting, motion-history, distance-scale, and all ten
-  camera-modifier paths inherited by `EveTransform`; the active render context
-  supplies Carbon's view position, matrices, and cached field of view. The
-  particle system now accepts that inherited view-update call and derives its
-  portable bounds/visibility scheduling without owning a GPU buffer.
-  `Tr2ShadowMap` now owns its exact static and dynamic splits, light-space
-  bounds, shimmer-stable orthographic frusta, and fixed per-split shader data.
-  Its matrices remain logical until the scene's terminal RawData write. A
-  nominal `CjsShadowMapExecutor` throws until an engine realizes atlas targets,
-  passes, result drawing, and optional denoising.
-  `Tr2VolumetricsRenderer` now owns per-attribute fog blending, quality and
-  planet state, and the terminal froxel per-frame RawData writes. The scene
-  owns one renderer by default and calls its per-frame fill directly; the
-  maintained scene driver now calls `UpdateFogSettings` after lighting overrides. Physical
-  fog/volumetric resources and passes delegate through a nominal throwing
-  `CjsVolumetricsExecutor`. The remaining generated methods are explicit
-  throwing obligations; the generated tree no longer owns manual behavior.
-  `Tr2SSAO` and `Tr2PostProcessRenderer` are also maintained now: their
-  quality/settings methods are portable and implemented, while physical
-  `Filter` and `Execute` remain exact-signature throwing engine obligations.
-  `ITr2FroxelFogSettings` is now the maintained nominal provider contract
-  consumed by the registry. `EveCurveLineSet` is also maintained and owns Eve
-  transform, visibility, and per-object policy; its `Tr2CurveLineSet` base now
-  rebuilds Carbon's CPU bounds, while physical line-stream batches remain one
-  visible engine obligation. `EveConnector` now owns the portable connector
-  geometry and animation policy and emits directly into that maintained line
-  set. `EveLineContainer` owns the ordered clear/update/append/submit cycle and
-  delegates visibility and bounds directly. `EveProjectBracket` now consumes
-  the active frame context to project, dock, offset, round, and publish a
-  tracked world position with Carbon's visibility-callback latch.
-  `EveTacticalOverlay` now owns Carbon's effect-local variables, LOD and
-  prior-frame segment budget, culling, and exact flat quad-instance records.
-  `EveChildInstanceMeshRenderer` now owns distribution updates, visibility,
-  bounds, Carbon-exact billboard transforms, and canonical CPU instance rows;
-  `EveSmartLightMesh` adds the smart-light group, colour-modifier, and material
-  parameter policy over that nominal base. Their instance declaration uses the
-  shader-compatible `TEXCOORD8` through `TEXCOORD14` range, while engines remain
-  responsible for physical buffer realization.
-  Their generated classes and the standalone connector enum have been retired.
-- The child reference and socket resource seam is synchronous and injected.
-- Socket parameter auto-creation currently covers the emitted string
-  parameter type; additional types require corresponding schema emission.
+- Per-object layouts and restored data classes do not prove producer
+  completeness. `EveLineSet` and `EveCurveLineSet` now allocate
+  `Tr2PerObjectDataStandard`, but `EveEllipseSet.GetPerObjectData` still reaches
+  the required throwing base. Bone-ring and morph-ring offsets retain defaults
+  until supplied, and `Tr2PerObjectVSData`'s interior-placeable filler belongs
+  to the character domain, not this Trinity layer.
+- The five legacy Sprite2D implementations, `Tr2Sprite2dContainerBase`,
+  corrected `EveSmartLightSpotLight`, `Obb`, and the rewritten
+  `Tr2ProjectBoundingBoxBracket` projection/active-context curve path were
+  promoted on 2026-08-22. `Tr2Sprite2dRenderJob` owns portable render-job traversal and
+  picking; the common Sprite2D base enables Carbon's picking state and throws
+  for unimplemented concrete traversal contracts.
+  `Tr2Transform` owns curve, SRT, mesh, sorting, motion-history, distance-scale,
+  and all ten camera-modifier paths inherited by `EveTransform`; the active
+  context supplies view position, matrices, and cached field of view. The
+  particle system accepts the inherited view-update call and derives portable
+  bounds/visibility scheduling without a GPU buffer.
+  `Tr2ShadowMap` owns exact static and dynamic splits; the
+  [shadow](../architecture.md#cascaded-shadow-contract),
+  [fog](../architecture.md#froxel-fog-contract),
+  [post-process](../architecture.md#post-process-renderer-boundary), and
+  [curve-line](../architecture.md#curve-line-boundary) contracts own the
+  maintained behavior and remaining explicit implementation gaps. Shadow
+  preparation and resolve now run on `Tr2ShadowMap` through the AL; unported
+  fog passes throw on `Tr2VolumetricsRenderer`, not on an external executor.
+  The scene owns one `Tr2VolumetricsRenderer` by default.
+  `EveProjectBracket` retains the visibility-callback latch, and
+  `EveTacticalOverlay` retains LOD and the prior-frame segment budget.
+  `EveChildInstanceMeshRenderer` owns distribution updates, visibility, bounds, and Carbon-exact
+  billboard transforms; `EveSmartLightMesh` adds smart-light group,
+  colour-modifier, and material-parameter policy. Their canonical CPU rows and
+  shader-compatible declaration belong to the
+  [instance-stream contract](../architecture.md#instance-stream-contract).
+  These generated classes and the standalone connector enum are retired;
+  remaining generated methods are explicit throwing obligations, not manual
+  behavior. [Promotion starts with the first substantive edit](../concepts/generated-class-lifecycle.md#current-lifecycle).
+- The child reference and socket resource seam is synchronous and injected.
+- Socket parameter auto-creation currently covers the emitted string
+  parameter type; additional types require corresponding schema emission.
 - Portable pick-batch and identity behavior is implemented for
   `EveSpaceObject2`, `EveTransform`, and the inherited transform family.
   GPU-readback scene picking remains explicit, as do decal pick-batch and

package/docs/trinity/reference/main-semantic-extraction.md

@@ -87,22 +87,18 @@ guess this vector.
 Optional values such as ellipsoid data, screen size, morph and bone offsets,
 impact fields, and custom data appear only when the object, shared record, or
 explicit overrides provide them.
-
-## Per-frame ownership
-
-These extraction helpers do not build per-frame state. `EveSpaceScene` owns
-the persistent per-frame records. `PopulatePerFramePSData` and
-`PopulatePerFrameVSData` consume the scene's stored history and jitter fields
-and fill lighting, fog, shadow-quality, volumetric, and upscaling values. The
-JavaScript scene does not yet advance history or compute jitter; the host must
-provision those fields or they retain identity/zero defaults.
-
-See [Per-frame and per-object data](../architecture.md#per-frame-and-per-object-data)
-for driver-supplied inputs and pixel-before-vertex fill order. The engine
-serializes or uploads both records.
-
-## Related documentation
-
-- [Architecture and ownership boundaries](../architecture.md)
+
+## Per-frame ownership
+
+These helpers do not build per-frame state. `EveSpaceScene` owns the persistent
+records filled by `PopulatePerFramePSData` and `PopulatePerFrameVSData`;
+engines serialize or upload them. See
+[Per-frame and per-object data](../architecture.md#per-frame-and-per-object-data)
+for host-provisioned history/jitter and identity/zero defaults, driver inputs,
+filled scene values, and required pixel-before-vertex order.
+
+## Related documentation
+
+- [Architecture and ownership boundaries](../architecture.md)
 - [Current API](api.md)
 - [Implementation status and audits](implementation-status.md)

package/docs/trinityal/reference/classes/README.md

@@ -8,10 +8,10 @@ Summary: Catalogs the device-facing descriptions and the GPU-free stub backend t
 <!-- class:Tr2BaseDeviceResourceAL -->
 ## `Tr2BaseDeviceResourceAL`
 
-Base of every abstraction-layer resource, with the registry that makes live resources enumerable and releasable by memory class.
+The base of every AL resource.
 
 - Export: `@carbonenginejs/runtime/trinityal`
-- Source: `src/trinityal/Tr2DeviceResourceAL.js`
+- Source: `src/trinityal/Tr2DeviceResourceAL/Tr2BaseDeviceResourceAL.js`
 - Visibility: Public
 - Kind: Carbon
 
@@ -41,7 +41,37 @@ Emulates the user-pointer draws every backend delegates to it, staging a caller'
 Multisample sample count and quality level.
 
 - Export: `@carbonenginejs/runtime/trinityal`
-- Source: `src/trinityal/Tr2HalHelperStructures.js`
+- Source: `src/trinityal/Tr2HalHelperStructures/Tr2MsaaDesc.js`
+- Visibility: Public
+- Kind: Carbon
+
+<!-- class:Tr2SubresourceData -->
+## `Tr2SubresourceData`
+
+One mip of one layer: where its pixels are, and how they are laid out.
+
+- Export: `@carbonenginejs/runtime/trinityal`
+- Source: `src/trinityal/Tr2HalHelperStructures/Tr2SubresourceData.js`
+- Visibility: Public
+- Kind: Carbon
+
+<!-- class:Tr2Viewport -->
+## `Tr2Viewport`
+
+The viewport a render context draws through.
+
+- Export: `@carbonenginejs/runtime/trinityal`
+- Source: `src/trinityal/Tr2HalHelperStructures/Tr2Viewport.js`
+- Visibility: Public
+- Kind: Carbon
+
+<!-- class:Tr2SamplerDescription -->
+## `Tr2SamplerDescription`
+
+The authored sampler state a `Tr2SamplerStateAL` is created from, and the key its factory dedupes on.
+
+- Export: `@carbonenginejs/runtime/trinityal`
+- Source: `src/trinityal/Tr2HalHelperStructures/Tr2SamplerDescription.js`
 - Visibility: Public
 - Kind: Carbon
 
@@ -51,7 +81,7 @@ Multisample sample count and quality level.
 A box within a texture, in pixels.
 
 - Export: `@carbonenginejs/runtime/trinityal`
-- Source: `src/trinityal/Tr2HalHelperStructures.js`
+- Source: `src/trinityal/Tr2HalHelperStructures/Tr2TextureCoordBox.js`
 - Visibility: Public
 - Kind: Carbon
 
@@ -61,37 +91,47 @@ A box within a texture, in pixels.
 The range of faces, mip levels and pixels a map, update or copy applies to; unset means the whole resource.
 
 - Export: `@carbonenginejs/runtime/trinityal`
-- Source: `src/trinityal/Tr2HalHelperStructures.js`
+- Source: `src/trinityal/Tr2HalHelperStructures/Tr2TextureSubresource.js`
 - Visibility: Public
 - Kind: Carbon
 
 <!-- class:Tr2RegisterMapAL -->
 ## `Tr2RegisterMapAL`
 
-Which shader-resource, unordered-access and sampler registers a program reads, kept per shader stage so the same register number in two stages stays two bindings.
+Stage/register to dense resource index, with counts spanning all stages.
 
 - Export: `@carbonenginejs/runtime/trinityal`
-- Source: `src/trinityal/Tr2ResourceSetAL.js`
+- Source: `src/trinityal/Tr2ResourceSetAL/Tr2RegisterMapAL.js`
 - Visibility: Public
 - Kind: Carbon
 
 <!-- class:Tr2ResourceSetDescriptionAL -->
 ## `Tr2ResourceSetDescriptionAL`
 
-What a resource set binds at each shader stage and register: shader resources with their colour space, unordered-access resources with their mip, samplers, and constant buffers.
+A program's mapped resources. Constant buffers bind separately through SetConstants.
+
+- Export: `@carbonenginejs/runtime/trinityal`
+- Source: `src/trinityal/Tr2ResourceSetAL/Tr2ResourceSetDescriptionAL.js`
+- Visibility: Public
+- Kind: Carbon
+
+<!-- class:Tr2ResourceSetAL -->
+## `Tr2ResourceSetAL`
+
+Public handle; implementation selection belongs to the creating context. The creating context selects the implementation; copied handles and context bindings retain shared ownership. Backend release follows garbage collection or explicit device-resource teardown.
 
 - Export: `@carbonenginejs/runtime/trinityal`
-- Source: `src/trinityal/Tr2ResourceSetAL.js`
+- Source: `src/trinityal/Tr2ResourceSetAL/Tr2ResourceSetAL.js`
 - Visibility: Public
 - Kind: Carbon
 
 <!-- class:Tr2ResourceSetALStub -->
 ## `Tr2ResourceSetALStub`
 
-GPU-free resource set that keeps the description and program it was created from, so a headless caller can read back what it asked to bind.
+A resource set the backend has accepted.
 
 - Export: `@carbonenginejs/runtime/trinityal`
-- Source: `src/trinityal/Tr2ResourceSetAL.js`
+- Source: `src/trinityal/Tr2ResourceSetAL/Tr2ResourceSetALStub.js`
 - Visibility: Public
 - Kind: Carbon
 
@@ -108,70 +148,70 @@ GPU-free fence that tracks whether a marker is outstanding, answering as a devic
 <!-- class:Tr2OcclusionQueryALStub -->
 ## `Tr2OcclusionQueryALStub`
 
-GPU-free occlusion query that reports zero passing pixels and catches a mispaired Begin and End.
+Counts the pixels a bracketed draw passed.
 
 - Export: `@carbonenginejs/runtime/trinityal/stub`
-- Source: `src/trinityal/stub/Tr2QueryALStub.js`
+- Source: `src/trinityal/stub/Tr2OcclusionQueryALStub.js`
 - Visibility: Public
 - Kind: Carbon
 
 <!-- class:Tr2GpuTimerALStub -->
 ## `Tr2GpuTimerALStub`
 
-GPU-free timer reporting Carbon's tiny fixed span, and minus one when no timer exists so a caller can tell that from no elapsed time.
+Times a bracketed span of GPU work.
 
 - Export: `@carbonenginejs/runtime/trinityal/stub`
-- Source: `src/trinityal/stub/Tr2QueryALStub.js`
+- Source: `src/trinityal/stub/Tr2GpuTimerALStub.js`
 - Visibility: Public
 - Kind: Carbon
 
 <!-- class:Tr2PipelineStatsQueryALStub -->
 ## `Tr2PipelineStatsQueryALStub`
 
-GPU-free pipeline-statistics query that always succeeds and reports an empty statistics set.
+Collects pipeline statistics over a bracketed span.
 
 - Export: `@carbonenginejs/runtime/trinityal/stub`
-- Source: `src/trinityal/stub/Tr2QueryALStub.js`
+- Source: `src/trinityal/stub/Tr2PipelineStatsQueryALStub/Tr2PipelineStatsQueryALStub.js`
 - Visibility: Public
 - Kind: Carbon
 
 <!-- class:Tr2VideoAdapterInfoStub -->
 ## `Tr2VideoAdapterInfoStub`
 
-Adapter and display-mode enumeration answering with Carbon's single fictional adapter, whose available mode deliberately differs from its current mode.
+Adapter and display-mode enumeration.
 
 - Export: `@carbonenginejs/runtime/trinityal/stub`
-- Source: `src/trinityal/stub/Tr2VideoAdapterInfoALStub.js`
+- Source: `src/trinityal/stub/Tr2VideoAdapterInfoStub.js`
 - Visibility: Public
 - Kind: Carbon
 
 <!-- class:Tr2DepthAttachment -->
 ## `Tr2DepthAttachment`
 
-What a render pass does with its depth attachment at both edges: the load action, the store action, and the depth a clear starts from.
+How a pass treats its depth attachment.
 
 - Export: `@carbonenginejs/runtime/trinityal`
-- Source: `src/trinityal/Tr2RenderPassAL.js`
+- Source: `src/trinityal/Tr2RenderPassAL/Tr2DepthAttachment.js`
 - Visibility: Public
 - Kind: Carbon
 
 <!-- class:Tr2ColorAttachment -->
 ## `Tr2ColorAttachment`
 
-What a render pass does with one colour attachment at both edges: the load action, the store action, and the packed colour a clear starts from.
+How a pass treats one colour attachment.
 
 - Export: `@carbonenginejs/runtime/trinityal`
-- Source: `src/trinityal/Tr2RenderPassAL.js`
+- Source: `src/trinityal/Tr2RenderPassAL/Tr2ColorAttachment.js`
 - Visibility: Public
 - Kind: Carbon
 
 <!-- class:Tr2BufferDescriptionAL -->
 ## `Tr2BufferDescriptionAL`
 
-How a buffer is laid out and what may touch it: format or stride, element count, and the GPU and CPU usage flags.
+How a buffer is laid out and what may touch it.
 
 - Export: `@carbonenginejs/runtime/trinityal/stub`
-- Source: `src/trinityal/stub/Tr2BufferALStub.js`
+- Source: `src/trinityal/Tr2BufferAL/Tr2BufferDescriptionAL.js`
 - Visibility: Public
 - Kind: Carbon
 
@@ -271,7 +311,7 @@ A vertex definition the backend has accepted, copied so a caller's later edit ca
 A list of resources handed to `UseResources` so a backend can make them resident together. Every member is empty in the stub, as in Carbon: residency is a device concern.
 
 - Export: `@carbonenginejs/runtime/trinityal/stub`
-- Source: `src/trinityal/stub/Tr2RenderContextALStub.js`
+- Source: `src/trinityal/stub/Tr2RenderContextALStub/Tr2BindlessResourcesAL.js`
 - Visibility: Public
 - Kind: Carbon
 
@@ -281,6 +321,16 @@ A list of resources handed to `UseResources` so a backend can make them resident
 GPU-free render context keeping real render-target and depth-stencil state, and a real back buffer, while drawing nothing.
 
 - Export: `@carbonenginejs/runtime/trinityal/stub`
-- Source: `src/trinityal/stub/Tr2RenderContextALStub.js`
+- Source: `src/trinityal/stub/Tr2RenderContextALStub/Tr2RenderContextALStub.js`
+- Visibility: Public
+- Kind: Carbon
+
+<!-- class:Tr2DeviceResourceAL -->
+## `Tr2DeviceResourceAL`
+
+Forwards the resource registry interface to concrete backend resource methods.
+
+- Export: `@carbonenginejs/runtime/trinityal`
+- Source: `src/trinityal/Tr2DeviceResourceAL/Tr2DeviceResourceAL.js`
 - Visibility: Public
 - Kind: Carbon

package/docs/trinityal/reference/classes/dropped.md

@@ -0,0 +1,82 @@
+# Dropped abstraction-layer class catalog
+
+Status: Evolving
+Scope: `@carbonenginejs/runtime/trinityal` classes under `src/trinityal/dropped`
+Audience: Backend authors, maintainers, and automated readers
+Summary: Provides one-sentence purpose descriptors for abstraction-layer donor classes that are written but deliberately not live, each carrying the reason and, where the behaviour is ported under another name, where it went.
+
+Every class here comes from a backend Carbon compiles instead of ours. That is
+not on its own a reason to ignore one: `MetalWorkQueue` is the declared model
+for `CjsWebgpuWorkQueue`, and of the seven below, five describe behaviour this
+package already ports under different names. They are written so the
+correspondence is checkable rather than assumed.
+
+<!-- class:ConstantBufferToken -->
+## `ConstantBufferToken`
+
+Retained-only reference shape mirroring Carbon's atomic constant-arena token, superseded by the plain `m_token` field `CjsWebgpuConstantBufferAL` carries, because uploads here happen on one thread.
+
+- Export: None
+- Source: `src/trinityal/dropped/ConstantBufferToken.js`
+- Visibility: Internal
+- Kind: Faithful Carbon port
+
+<!-- class:MetalBlendState -->
+## `MetalBlendState`
+
+Retained-only reference shape mirroring Carbon's hashable Metal blend record, superseded by the pipeline recipe `Tr2RenderStateSetup.GetWebgpuRecipe` projects, because WebGPU folds blending into the render pipeline and has no per-state setter.
+
+- Export: None
+- Source: `src/trinityal/dropped/MetalBlendState.js`
+- Visibility: Internal
+- Kind: Faithful Carbon port
+
+<!-- class:MetalClearState -->
+## `MetalClearState`
+
+Retained-only reference shape mirroring Carbon's per-pass load, store and clear state, superseded by the equivalent fields WebGPU carries on each render-pass attachment.
+
+- Export: None
+- Source: `src/trinityal/dropped/MetalClearState.js`
+- Visibility: Internal
+- Kind: Faithful Carbon port
+
+<!-- class:MetalColor -->
+## `MetalColor`
+
+Retained-only reference shape mirroring Carbon's plain RGBA aggregate for Metal clear and blend colours, superseded by `vec4`, which already is one.
+
+- Export: None
+- Source: `src/trinityal/dropped/MetalColor.js`
+- Visibility: Internal
+- Kind: Faithful Carbon port
+
+<!-- class:MetalDepthBias -->
+## `MetalDepthBias`
+
+Retained-only reference shape mirroring Carbon's Metal depth-bias triple, superseded by the authored render states `RS_DEPTHBIAS` and `RS_SLOPESCALEDEPTHBIAS`, which `Tr2RenderStateSetup.GetWebgpuRecipe` already projects onto the pipeline's depth-stencil state.
+
+- Export: None
+- Source: `src/trinityal/dropped/MetalDepthBias.js`
+- Visibility: Internal
+- Kind: Faithful Carbon port
+
+<!-- class:MetalRenderPassHint -->
+## `MetalRenderPassHint`
+
+Carbon's deferred render-pass attachment record, whose behaviour this package ports on `CjsWebgpuWorkQueue` and `CjsWebgpuRenderContextAL` while flattening the struct into loose colour and depth arguments to match WebGPU's own descriptor.
+
+- Export: None
+- Source: `src/trinityal/dropped/MetalRenderPassHint.js`
+- Visibility: Internal
+- Kind: Faithful Carbon port
+
+<!-- class:ShaderResourceMask -->
+## `ShaderResourceMask`
+
+Retained-only reference shape mirroring Carbon's per-stage bind masks, superseded by the stage bindings `CjsWebgpuShaderAL` carries, because WebGPU resolves binding validity when a bind group layout is created rather than per draw.
+
+- Export: None
+- Source: `src/trinityal/dropped/ShaderResourceMask.js`
+- Visibility: Internal
+- Kind: Faithful Carbon port

package/docs/trinityal/webgpu/README.md

@@ -25,7 +25,9 @@ selection, renderer scheduling, and scene extraction remain outside the engine.
 
 ## Start here
 
-Start with the [architecture](architecture.md), then use the
+For Trinity integration, start with the [current AL draw path](architecture.md#current-al-draw-path).
+The descriptor API below remains a separate surface; its harness adapters do
+not replace Trinity's batch walk. Then use the
 [API reference](reference/api.md). Maintainers qualifying generated shader
 packages should use the [WebGPU harness](guides/webgpu-harness.md).