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

package/docs/trinity/concepts/eve-runtime-behavior.md

@@ -47,7 +47,7 @@ those bytes.
 controller and curve propagation, targetable-sphere behavior, child update and
 renderable traversal, and authored effect level of detail.
 
-Native pose realization, geometry loading, quad submission, device buffers,
+Native pose evaluation, geometry loading, quad submission, device buffers,
 and shader upload remain outside this package. A generated child that has not
 been promoted yet does not gain invented rendering behavior merely because a
 maintained root traverses it.

package/docs/trinity/reference/api.md

@@ -48,11 +48,11 @@ import {
 
 ## Schema and enum metadata
 
-Runtime classes use `@type.define` for Carbon class identity and field
-decorators from `@carbonenginejs/runtime/schema`. Enum-backed integer
-fields use `@schema.enum` so metadata consumers can present the maintained enum
-vocabulary. See [Enum ownership](../concepts/generated-class-lifecycle.md#enum-ownership)
-for class, family, and shared vocabulary placement.
+Runtime classes use `@type.define` for Carbon class identity and field
+decorators from `@carbonenginejs/runtime/schema`. Enum-backed integer
+fields use `@schema.enum` so metadata consumers can present the maintained enum
+vocabulary. See [Enum ownership](../concepts/generated-class-lifecycle.md#enum-ownership)
+for class, family, and shared vocabulary placement.
 
 Public methods that implement Carbon exposure use `@carbon.method`. The parity
 audit checks promoted classes for omitted and present-but-unexposed methods.
@@ -72,8 +72,8 @@ output buffers universally optional.
 
 - Generated wildcard subpaths are intake surfaces and can change when a class
   is promoted to its maintained family.
-- A graph class describing a device or buffer does not expose a live backend
-  object.
+- A class describing a device or buffer may hold and forward to its AL object,
+  as Carbon does; with the stub attached that costs no GPU.
 - Resource and engine capabilities are supplied by their owning packages.
 - Explicit implementation gaps remain visible rather than receiving guessed
   behavior.
@@ -85,3 +85,15 @@ output buffers universally optional.
 - [Eve runtime behavior](../concepts/eve-runtime-behavior.md)
 - [Generated-class lifecycle](../concepts/generated-class-lifecycle.md)
 - [Implementation status and audits](implementation-status.md)
+
+
+## Particle element descriptors
+
+`Tr2ParticleElementDeclaration.GetSize()` returns the fixed semantic dimensions
+(2 for lifetime, 3 for position/velocity, 1 for mass), or the authored `dimension`
+for custom elements. Custom dimensions are not clamped; particle buffer layout
+uses this method directly.
+
+`Tr2ParticleElementData.Invalid()` returns a new descriptor with dimension,
+usage index and offset zero, and `bufferType` set to `BufferType.COUNT`.
+The local `none` variable in Carbon's factory is not a descriptor property.

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

@@ -39,7 +39,7 @@ Retains the quarantined native CAS sharpening constants that renderer code repla
 <!-- class:EveInstancedMeshManager -->
 ## `EveInstancedMeshManager`
 
-Retains the quarantined native GPU-backed instancing manager whose realization belongs to an engine backend.
+Retains the quarantined native GPU-backed instancing manager; Carbon's scene owns it directly and it is not ported.
 
 - Source: `src/trinity/dropped/EveInstancedMeshManager.js`
 - Visibility: Internal
@@ -48,7 +48,7 @@ Retains the quarantined native GPU-backed instancing manager whose realization b
 <!-- class:EveSpherePinIndexTree -->
 ## `EveSpherePinIndexTree`
 
-Retains the quarantined pointer-backed spherical geometry index whose realization belongs to resource or engine spatial indexing.
+Retains the quarantined pointer-backed spherical geometry index; it is not ported.
 
 - Source: `src/trinity/dropped/EveSpherePinIndexTree.js`
 - Visibility: Internal
@@ -72,15 +72,6 @@ Retains the native device interface identity while maintained graph state and in
 - Visibility: Internal
 - Kind: Carbon dropped
 
-<!-- class:ITriEffectTextureParameter -->
-## `ITriEffectTextureParameter`
-
-Retains the pure texture-parameter interface identity superseded by maintained concrete texture-parameter graph classes.
-
-- Source: `src/trinity/dropped/ITriEffectTextureParameter.js`
-- Visibility: Internal
-- Kind: Carbon dropped
-
 <!-- class:ITriMatrix -->
 ## `ITriMatrix`
 

package/docs/trinity/reference/classes/eve-runtime.md

@@ -313,7 +313,7 @@ Persistent modular-space-object state stored as an effect child.
 Builds and publishes the canonical CPU instance stream from a placement distribution.
 
 It applies Carbon's billboard constraints and computes visibility and bounds;
-engines own physical instance-buffer realization.
+physical instance-buffer work is not ported yet.
 
 - Export: `@carbonenginejs/runtime/trinity/eve`
 - Source: `src/trinity/eve/child/EveChildInstanceMeshRenderer.js`