@forgeax/engine-vfx-render 0.1.27 → 0.1.29

package/README.md

@@ -24,10 +24,10 @@ const renderer = created.value;
 ```
 
 Create the host before the Renderer and pass `host.feature` at Renderer
-construction. `attachWorld` installs the schema-v2 Pack loader and one
-FixedUpdate producer. `detachWorld` removes both the system and runtime
-resource. Material and mesh GUIDs resolve through the attached World's
-`AssetRegistry`.
+construction. `attachWorld` installs the versioned Pack loader (including the
+Program v3 path) and one FixedUpdate producer. `detachWorld` removes both the
+system and runtime resource. Material and mesh GUIDs resolve through the
+attached World's `AssetRegistry`.
 
 ## Frame path
 
@@ -47,8 +47,10 @@ The generic render seam accepts persistent compute programs/buffers/bindings, ex
 |:--|:--|:--|
 | Particle state | Emitter instance | Initial clear only |
 | Alive flags, scan scratch, stable indices | Emitter instance | Initial clear only |
-| Indirect commands | Emitter instance | Static geometry fields at creation; instance count on GPU |
+| Indirect commands | Emitter instance | None; GPU projection writes geometry fields and compaction owns instance count |
 | Tick uniforms | Bounded ring | One small write per fixed tick |
+| Program v3 Parameters | Emitter instance | One snapshot write per fixed tick when declared |
+| Program v3 Custom | Emitter instance | GPU-persistent; no per-particle CPU mirror |
 | Renderer projection instances | Renderer instance | None after allocation |
 | Mesh geometry/index data | Prepared graphics cache | Initial upload |
 | Ribbon strip resources | Ribbon renderer | Initial allocation; GPU indirect count |
@@ -56,6 +58,25 @@ The generic render seam accepts persistent compute programs/buffers/bindings, ex
 | Beam endpoint resources | Beam renderer | Initial allocation; GPU endpoint projection |
 
 There is no steady-state particle readback or CPU particle upload.
+
+Material particle inputs use up to four vec4 lanes. The highest selected lane
+determines the input region size; selecting lane 3 alone still reserves four
+lanes. VFX projects the cooked values on GPU and forwards that lane count in the
+graphics program declaration. Render derives the matching multi-stream layout
+and includes its complete stride/attributes in pipeline identity.
+
+| Adapter | Core instance bytes | First material-input shader location |
+|:--|--:|--:|
+| Billboard | 124 | 9 |
+| Ribbon / Trail / Beam | 48 | 4 |
+| Mesh | 72 | 10 |
+
+Each selected input occupies its declared lane at `coreBytes + lane * 16`;
+instance stride is `coreBytes + (highestLane + 1) * 16`. Missing or stale material
+declarations fail with structured input errors rather than silently substituting
+zero-valued inputs. Four-lane and sparse-lane support is exercised through the
+cooked five-topology Dawn fixture, not only synthetic buffer uploads.
+
 Bindings retained by an attached player keep their transitive buffers alive. When a player,
 emitter, or World disappears, untouched GPU resources leave the live cache immediately and their
 buffers are destroyed only after the submitted queue work completes. Renderer recovery and dispose
@@ -63,13 +84,28 @@ use the same owner path.
 
 ## Rendering
 
-- Billboard projection uses camera right/up, particle width/height, and `size_rotation.z`; color and HDR material values are packed per renderer on GPU.
+- Billboard projection uses camera right/up, particle width/height, and the v3 `sprite_rotation`; color and HDR material values are packed per renderer on GPU.
 - Mesh renderers consume the explicitly selected `MeshAsset` submesh geometry/index data and one independent projected instance stream per renderer.
+- Program v3 Mesh projection writes world-space center and Quaternion/Scale3 basis
+  data. The built-in Mesh adapter supplies geometry inputs to the same Standard
+  surface evaluator as scene Mesh. Render owns lighting preparation, topology
+  variants, effective material values, Skylight inputs, and Cluster bindings;
+  particles do not allocate a second lighting system or scene Mesh/Instance tables.
+  Negative/non-uniform scale uses an inverse-transpose normal basis and preserves
+  tangent handedness. Mesh `castShadows` contributes the same GPU instance/index/
+  indirect data to Standard light views through a `shadow-caster` plan pass.
+  The shared Dawn/WebGPU acceptance fixture proves directional/point/spot casting,
+  camera-culled casters, Point receiving and authored bias, and four roughness/
+  metallic combinations against ordinary Mesh under a real HDR equirect.
+  Current-depth-dependent simulation executes after opaque depth; early shadows
+  consume the last submitted projection. Render-only frames retain it without
+  advancing simulation, and a catch-up submission exposes only its final tick to
+  the following frame. The indirect buffer is never reinitialized per tick.
 - Multiple renderers on one emitter receive independent material values and indirect command offsets.
 - A material pass named `particle-billboard` or `particle-mesh` selects that renderer's authored
-  shader module and render state. Ordinary `Forward` passes are ignored because their vertex layout
-  is not a particle projection contract; absence of a matching particle pass uses the package-owned
-  built-in shader.
+  shader module and render state. Without a matching particle pass, the package-owned
+  built-in shader supplies the particle vertex adapter. Mesh preserves the ordinary
+  `Forward` material render state; the other renderers use their particle defaults.
 - A custom particle material with a non-empty `parameters` schema receives the standard material
   bind group at group 1. Numeric parameters are uploaded through the shader-schema UBO layout;
   texture parameters resolve their authored TextureAsset and optional SamplerAsset through the
@@ -80,7 +116,8 @@ use the same owner path.
   remains owned by the shared GPU resource store.
 - Billboard blend is explicit: `additive`, premultiplied `alpha`, or `opaque-cutout`.
 - Scene color/depth target formats and sample counts derive from RenderFeature targets.
-- Fixed bounds cull projection/draw before graph contribution; simulation follows the source culling policy.
+- Fixed bounds suppress the main-camera raster when culled, not an enabled Mesh
+  shadow contribution. Simulation follows the source culling policy.
 - Camera-frustum results publish through `setEmitterCameraVisibility`; session mute/isolate is a separate mask that suppresses compute and draw contribution while retaining prepared bindings as warm state. A paused player can therefore be isolated and restored without a new simulation intent or GPU-resource reallocation.
 - WGSL runtime time is the effect-relative `phaseTick`; the world-global tick remains an internal ring-selection and correlation clock. Replay and deterministic seek therefore restart shader time as well as CPU scheduling.
 
@@ -118,6 +155,14 @@ reattach, or player destruction therefore returns a structured
 lease after any host generation change. These controls are transient runtime
 intent and do not modify authored `ParticleEffectPlayer` data.
 
+The same generation-bound lease exposes `patchPlayerParameters` and
+`submitChannel` for the bounded runtime control surface. Parameter patches
+return the host generation, parameter generation, and pending patch count;
+channel submissions retain the existing typed channel/event/sub-emitter path.
+Missing players, invalid instance input, stale generations, and detached
+worlds all return the closed `VfxRuntimeHostControlError` union. There is no
+open Data Interface or second channel registry.
+
 `createVfxRenderInspectSnapshot` and `topologyRecoveryHint` expose structured
 readiness and recovery evidence. Device loss or a stale generation discards the
 affected topology resources and rebuilds them from cooked reflection.

package/dist/__tests__/persistent-ticks.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=persistent-ticks.integration.test.d.ts.map

package/dist/__tests__/persistent-ticks.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-ticks.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/persistent-ticks.integration.test.ts"],"names":[],"mappings":""}

package/dist/feature/event-resources.d.ts

@@ -1,9 +1,16 @@
-import type { VfxGpuEmitterProgram, VfxGpuTickIntent } from '@forgeax/engine-vfx';
+import type { VfxGpuEmitterProgramAny, VfxGpuTickIntent } from '@forgeax/engine-vfx';
 export declare const VFX_EVENT_INPUT_BYTES = 32;
 export declare const VFX_EVENT_BYTES = 32;
 export declare const VFX_EVENT_COUNTER_BYTES = 16;
-export declare function eventInputCapacity(emitter: VfxGpuEmitterProgram): number;
-export declare function eventCapacity(emitter: VfxGpuEmitterProgram): number;
+export declare function eventInputCapacity(emitter: VfxGpuEmitterProgramAny): number;
+export declare function eventCapacity(emitter: VfxGpuEmitterProgramAny): number;
 export declare function encodeEventInputs(intent: VfxGpuTickIntent): Uint8Array;
+/**
+ * Pack the fixed-tick inputs and GPU-produced events into one typed storage
+ * resource. The managed event kernel uses the reflected input capacity as the
+ * split point; this keeps channel/sub-emitter semantics while leaving one
+ * storage binding available for Custom-enabled emitters.
+ */
+export declare function encodeEventBuffer(intent: VfxGpuTickIntent): Uint8Array;
 export declare function eventCounterData(): Uint8Array;
 //# sourceMappingURL=event-resources.d.ts.map

package/dist/feature/event-resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-resources.d.ts","sourceRoot":"","sources":["../../src/feature/event-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAElF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAW1C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAKxE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAMnE;AAWD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAkBtE;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CAE7C"}
+{"version":3,"file":"event-resources.d.ts","sourceRoot":"","sources":["../../src/feature/event-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAErF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAW1C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAK3E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAMtE;AAWD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAkBtE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAMtE;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CAE7C"}

package/dist/feature/gpu-particle-feature.d.ts

@@ -1,13 +1,13 @@
 import type { EntityHandle, World } from '@forgeax/engine-ecs';
 import type { RenderFeature } from '@forgeax/engine-render';
 import { type MaterialAsset, type MeshAsset } from '@forgeax/engine-types';
-import type { ParticleRendererSource } from '@forgeax/engine-vfx';
-import { type VfxGpuRuntime, type VfxGpuTickIntent } from '@forgeax/engine-vfx';
+import type { ParticleRendererSourceV3 } from '@forgeax/engine-vfx';
+import { type VfxGpuEmitterSource, type VfxGpuRuntime, type VfxGpuTickIntent } from '@forgeax/engine-vfx';
 import type { VfxDataInterfaceRegistry } from '../host/data-interface-providers.js';
 import type { ParticleRenderCamera } from './camera.js';
 import type { VfxStagePlanObservation } from './stage-plan.js';
-type ParticleRendererKind = ParticleRendererSource['kind'];
-type ParticleTopologyRenderer = Extract<ParticleRendererSource, {
+type ParticleRendererKind = ParticleRendererSourceV3['kind'];
+type ParticleTopologyRenderer = Extract<ParticleRendererSourceV3, {
     readonly capacity: number;
 }>;
 type ParticleTopologyKind = ParticleTopologyRenderer['kind'];
@@ -44,7 +44,7 @@ export interface BillboardAdvancedSample {
     readonly sceneDepth: number;
     readonly depthAvailable: boolean;
 }
-export declare function resolveBillboardAdvancedState(renderer: Extract<ParticleRendererSource, {
+export declare function resolveBillboardAdvancedState(renderer: Extract<ParticleRendererSourceV3, {
     readonly kind: 'billboard';
 }>, sample: BillboardAdvancedSample): import("@forgeax/engine-types").ResultErr<{
     code: "vfx-renderer-depth-missing";
@@ -80,6 +80,19 @@ interface ExtractedWorld {
     readonly runtime: VfxGpuRuntime;
     readonly camera: ParticleRenderCamera;
     readonly intents: readonly VfxGpuTickIntent[];
+    /**
+     * Last submitted emitter state kept drawable between fixed ticks.  The
+     * queue above is simulation work only; renderHz is allowed to exceed
+     * fixedHz, and a live emitter must keep its projection/raster lease warm.
+     */
+    readonly retained: readonly RetainedEmitter[];
+}
+interface RetainedEmitter {
+    readonly player: VfxGpuEmitterSource['player'];
+    readonly emitter: VfxGpuEmitterSource['emitter'];
+    readonly intent: VfxGpuTickIntent;
+    readonly localToWorld: Float32Array;
+    readonly visible: boolean;
 }
 interface ExtractedFrame {
     readonly worlds: readonly ExtractedWorld[];

package/dist/feature/gpu-particle-feature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gpu-particle-feature.d.ts","sourceRoot":"","sources":["../../src/feature/gpu-particle-feature.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gpu-particle-feature.d.ts","sourceRoot":"","sources":["../../src/feature/gpu-particle-feature.ts"],"names":[],"mappings":"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"}

package/dist/feature/particle-resources.d.ts

@@ -1,8 +1,8 @@
 import type { RenderFeatureMaterialShaderBindingContract } from '@forgeax/engine-render';
-import { type MaterialAsset, type MaterialRenderState, type MeshAsset, type Result } from '@forgeax/engine-types';
-import type { ParticleRendererSource } from '@forgeax/engine-vfx';
-type ParticleRendererKind = ParticleRendererSource['kind'];
-type ParticleTopologyRenderer = Extract<ParticleRendererSource, {
+import { type MaterialAsset, type MaterialParticleInput, type MaterialRenderState, type MeshAsset, type Result } from '@forgeax/engine-types';
+import type { ParticleRendererSourceV3 } from '@forgeax/engine-vfx';
+type ParticleRendererKind = ParticleRendererSourceV3['kind'];
+type ParticleTopologyRenderer = Extract<ParticleRendererSourceV3, {
     readonly capacity: number;
 }>;
 type ParticleTopologyKind = ParticleTopologyRenderer['kind'];
@@ -13,6 +13,14 @@ export declare const PARTICLE_SHADER_IDENTIFIERS: Readonly<{
     trail: "forgeax::vfx-render.particles.trail";
     beam: "forgeax::vfx-render.particles.beam";
 }>;
+/** Built-in shader variants with one explicit vec4 material-input lane block. */
+export declare const PARTICLE_INPUT_SHADER_IDENTIFIERS: Readonly<{
+    billboard: "forgeax::vfx-render.particles.billboard-inputs";
+    mesh: "forgeax::vfx-render.particles.mesh-inputs";
+    ribbon: "forgeax::vfx-render.particles.ribbon-inputs";
+    trail: "forgeax::vfx-render.particles.trail-inputs";
+    beam: "forgeax::vfx-render.particles.beam-inputs";
+}>;
 export interface TopologyResourcePlan {
     readonly topology: ParticleTopologyKind;
     readonly capacity: number;
@@ -50,7 +58,7 @@ export interface ParticleMaterialPass {
     readonly shader: string;
     readonly renderState?: MaterialRenderState;
 }
-type ParticleBlendMode = Extract<ParticleRendererSource, {
+type ParticleBlendMode = Extract<ParticleRendererSourceV3, {
     readonly kind: 'billboard';
 }>['blend'];
 /**
@@ -59,7 +67,35 @@ type ParticleBlendMode = Extract<ParticleRendererSource, {
  * different contract, so silently accepting it would compile the wrong input
  * shape and make authored particle shaders appear to work while never running.
  */
-export declare function particleMaterialPass(kind: ParticleRendererKind, material: MaterialAsset | undefined): ParticleMaterialPass;
+export declare function particleMaterialPass(kind: ParticleRendererKind, material: MaterialAsset | undefined, hasParticleInputs?: boolean): ParticleMaterialPass;
+export interface PreparedParticleMaterialInputs {
+    /** The exact declarations requested by this renderer, in authored order. */
+    readonly definitions: readonly MaterialParticleInput[];
+    /** Number of vec4 lanes reserved in the per-particle instance stream. */
+    readonly lanes: number;
+    /** Byte width of the per-particle input projection. */
+    readonly stride: number;
+}
+export interface ParticleMaterialInputPreparationError {
+    readonly code: 'vfx-material-input-missing' | 'vfx-material-input-wrong-type' | 'vfx-material-input-stale' | 'vfx-material-input-duplicate';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: {
+        readonly material?: string;
+        readonly name?: string;
+        readonly lane?: number;
+        readonly path?: string;
+    };
+}
+/**
+ * Validate and prepare the material-side particle-input bridge.
+ *
+ * The returned stride is added to the renderer-owned GPU instance stream; no
+ * CPU mirror or per-frame upload is created. Reflection is required when the
+ * renderer came from a cooked effect so an old material/program pair cannot
+ * silently bind a different input layout.
+ */
+export declare function prepareParticleMaterialInputs(renderer: ParticleRendererSourceV3, material: MaterialAsset | undefined, reflected?: readonly MaterialParticleInput[]): Result<PreparedParticleMaterialInputs, ParticleMaterialInputPreparationError>;
 /**
  * Resolve the default pipeline state for a particle renderer.
  *
@@ -84,5 +120,6 @@ export declare function particleMaterialUsesBindings(material: MaterialAsset | u
  */
 export declare function particleMaterialSceneDepthBinding(contract: RenderFeatureMaterialShaderBindingContract | undefined): 0 | 1 | undefined;
 export declare function canonicalMeshVertices(mesh: MeshAsset): Float32Array;
+export declare function canonicalMeshVerticesCached(mesh: MeshAsset): Float32Array;
 export {};
 //# sourceMappingURL=particle-resources.d.ts.map

package/dist/feature/particle-resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"particle-resources.d.ts","sourceRoot":"","sources":["../../src/feature/particle-resources.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"particle-resources.d.ts","sourceRoot":"","sources":["../../src/feature/particle-resources.ts"],"names":[],"mappings":"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"}

package/dist/host/data-interface-providers.d.ts

@@ -1,8 +1,10 @@
 import { type Result } from '@forgeax/engine-types';
-import { type VfxDataInterfaceError, type VfxDataInterfaceProvider, type VfxDataInterfaceRequirement, type VfxDataInterfaceResolution } from '@forgeax/engine-vfx';
+import { type VfxDataInterfaceError, type VfxDataInterfaceProvider, type VfxDataInterfaceRequirement, type VfxDataInterfaceResolution, type VfxDataInterfaceResource } from '@forgeax/engine-vfx';
 export type { VfxDataInterfaceProvider } from '@forgeax/engine-vfx';
 export interface VfxDataInterfaceAvailabilitySource {
     readonly available: (generation: number) => boolean;
+    readonly sampleCount?: 1 | 4;
+    readonly resource?: (generation: number) => VfxDataInterfaceResource['resource'] | undefined;
 }
 export interface VfxDataInterfaceRegistry {
     readonly providers: readonly VfxDataInterfaceProvider[];
@@ -15,5 +17,6 @@ export interface VfxDataInterfaceRegistry {
 }
 export declare function createCameraProvider(source: VfxDataInterfaceAvailabilitySource): VfxDataInterfaceProvider<'camera'>;
 export declare function createSceneDepthProvider(source: VfxDataInterfaceAvailabilitySource): VfxDataInterfaceProvider<'scene-depth'>;
+export declare function createNoiseProvider(source: VfxDataInterfaceAvailabilitySource): VfxDataInterfaceProvider<'noise'>;
 export declare function createVfxDataInterfaceRegistry(initialProviders?: readonly VfxDataInterfaceProvider[]): VfxDataInterfaceRegistry;
 //# sourceMappingURL=data-interface-providers.d.ts.map

package/dist/host/data-interface-providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-interface-providers.d.ts","sourceRoot":"","sources":["../../src/host/data-interface-providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAEL,KAAK,qBAAqB,EAE1B,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAGhC,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CACrD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACxD,QAAQ,CAAC,QAAQ,EACb;QACE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,0BAA0B,EAAE,qBAAqB,CAAC,CAAC;KAC5E,GACD,SAAS,CAAC;IACd,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAClF,OAAO,CACL,YAAY,EAAE,SAAS,2BAA2B,EAAE,EACpD,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,0BAA0B,EAAE,qBAAqB,CAAC,CAAC;CAC9D;AA0CD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,kCAAkC,GACzC,wBAAwB,CAAC,QAAQ,CAAC,CAEpC;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kCAAkC,GACzC,wBAAwB,CAAC,aAAa,CAAC,CAEzC;AAED,wBAAgB,8BAA8B,CAC5C,gBAAgB,GAAE,SAAS,wBAAwB,EAAO,GACzD,wBAAwB,CA+B1B"}
+{"version":3,"file":"data-interface-providers.d.ts","sourceRoot":"","sources":["../../src/host/data-interface-providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAEL,KAAK,qBAAqB,EAE1B,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAE9B,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,wBAAwB,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;CAC9F;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACxD,QAAQ,CAAC,QAAQ,EACb;QACE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,0BAA0B,EAAE,qBAAqB,CAAC,CAAC;KAC5E,GACD,SAAS,CAAC;IACd,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAClF,OAAO,CACL,YAAY,EAAE,SAAS,2BAA2B,EAAE,EACpD,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,0BAA0B,EAAE,qBAAqB,CAAC,CAAC;CAC9D;AAqDD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,kCAAkC,GACzC,wBAAwB,CAAC,QAAQ,CAAC,CAEpC;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kCAAkC,GACzC,wBAAwB,CAAC,aAAa,CAAC,CAEzC;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kCAAkC,GACzC,wBAAwB,CAAC,OAAO,CAAC,CAEnC;AAED,wBAAgB,8BAA8B,CAC5C,gBAAgB,GAAE,SAAS,wBAAwB,EAAO,GACzD,wBAAwB,CA+B1B"}

package/dist/host/vfx-runtime-host.d.ts

@@ -1,7 +1,7 @@
 import type { AssetRegistry as LegacyAssetRegistry, RuntimeAssetRegistry } from '@forgeax/engine-assets-runtime';
 import { type EntityHandle, type World } from '@forgeax/engine-ecs';
 import type { Asset, AssetDecoderLease, Result } from '@forgeax/engine-types';
-import type { VfxDataInterfaceError, VfxDataInterfaceProvider, VfxDataInterfaceRequirement, VfxDataInterfaceResolution, VfxGpuPlayerInspectSnapshot, VfxGpuRuntimeDiagnostic, VfxReplayInput, VfxValueMap } from '@forgeax/engine-vfx';
+import type { VfxChannelInput, VfxDataInterfaceError, VfxDataInterfaceProvider, VfxDataInterfaceRequirement, VfxDataInterfaceResolution, VfxGpuPlayerInspectSnapshot, VfxGpuRuntimeDiagnostic, VfxReplayInput, VfxValueMap } from '@forgeax/engine-vfx';
 import type { ParticleRenderCameraSource } from '../feature/camera.js';
 import { gpuParticleRenderFeature } from '../feature/gpu-particle-feature.js';
 import { type VfxDataInterfaceRegistry } from './data-interface-providers.js';
@@ -34,13 +34,14 @@ export interface VfxRuntimeHostError {
     };
 }
 export interface VfxRuntimeHostControlError {
-    readonly code: 'vfx-host-control-world-detached' | 'vfx-host-control-stale-generation' | 'vfx-host-control-runtime-unavailable' | 'vfx-host-control-player-unavailable';
+    readonly code: 'vfx-host-control-world-detached' | 'vfx-host-control-stale-generation' | 'vfx-host-control-runtime-unavailable' | 'vfx-host-control-player-unavailable' | 'vfx-host-control-instance-rejected';
     readonly expected: string;
     readonly hint: string;
     readonly detail: {
         readonly requestedGeneration?: number;
         readonly currentGeneration?: number;
         readonly player?: EntityHandle;
+        readonly causeCode?: string;
     };
 }
 export interface VfxRuntimeHostControl {
@@ -67,6 +68,24 @@ export interface VfxRuntimeHostControl {
         readonly state: 'enabled' | 'paused';
         readonly generation: number;
     }, VfxRuntimeHostControlError>;
+    patchPlayerParameters(input: {
+        readonly player: EntityHandle;
+        readonly values: Partial<VfxValueMap>;
+    }): Result<{
+        readonly state: 'queued';
+        readonly generation: number;
+        readonly parameterGeneration: number;
+        readonly pendingPatchCount: number;
+    }, VfxRuntimeHostControlError>;
+    submitChannel(input: {
+        readonly player: EntityHandle;
+        readonly channel: string;
+        readonly payload: VfxChannelInput['payload'];
+        readonly sequence: number;
+    }): Result<{
+        readonly state: 'queued';
+        readonly generation: number;
+    }, VfxRuntimeHostControlError>;
 }
 export interface VfxRuntimeHost {
     readonly feature: ReturnType<typeof gpuParticleRenderFeature>;

package/dist/host/vfx-runtime-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vfx-runtime-host.d.ts","sourceRoot":"","sources":["../../src/host/vfx-runtime-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,IAAI,mBAAmB,EACpC,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAsB,KAAK,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,KAAK,EACV,KAAK,EACL,iBAAiB,EAGjB,MAAM,EACP,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EACvB,cAAc,EACd,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAS7B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,+BAA+B,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE;QAChB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;KAC3C,CAAC;IACF,MAAM,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;CACnF;AAED,KAAK,aAAa,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,yBAAyB,CAAC;AAE5F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC1D;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EACT,gCAAgC,GAChC,8BAA8B,GAC9B,8BAA8B,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EACT,iCAAiC,GACjC,mCAAmC,GACnC,sCAAsC,GACtC,qCAAqC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;QACtC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;KAChC,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,KAAK,EAAE;QACZ,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;QAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;KACpD,GAAG,MAAM,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,0BAA0B,CAAC,CAAC;IAClG,wBAAwB,CAAC,KAAK,EAAE;QAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;QAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;KAC3B,GAAG,MAAM,CACR;QACE,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC;QACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,EACD,0BAA0B,CAC3B,CAAC;IACF,0BAA0B,CAAC,KAAK,EAAE;QAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;KAC3B,GAAG,MAAM,CACR;QACE,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;QACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,EACD,0BAA0B,CAC3B,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;IAC9D,QAAQ,CAAC,cAAc,EAAE,wBAAwB,CAAC;IAClD,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,6BAA6B,GAAG,SAAS,CAAC;IACjE,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,qBAAqB,EAAE,0BAA0B,CAAC,CAAC;IACxF,qBAAqB,CAAC,KAAK,EAAE;QAC3B,QAAQ,CAAC,YAAY,EAAE,SAAS,2BAA2B,EAAE,CAAC;QAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,GAAG,MAAM,CAAC,0BAA0B,EAAE,qBAAqB,CAAC,CAAC;IAC9D,WAAW,CAAC,KAAK,EAAE;QACjB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;KAChC,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,kBAAkB,CAAA;KAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC9F,WAAW,CAAC,KAAK,EAAE;QACjB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;KACvB,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAAA;KAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;CAC3F;AAED,4DAA4D;AAC5D,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,iBAAiB,CAE1F;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC1D;AAsBD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAkSnF"}
+{"version":3,"file":"vfx-runtime-host.d.ts","sourceRoot":"","sources":["../../src/host/vfx-runtime-host.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 export type { ParticleRenderCamera, ParticleRenderCameraSource } from './feature/camera.js';
-export { encodeEventInputs, eventCapacity, eventCounterData, eventInputCapacity, VFX_EVENT_BYTES, VFX_EVENT_COUNTER_BYTES, VFX_EVENT_INPUT_BYTES, } from './feature/event-resources.js';
+export { encodeEventBuffer, encodeEventInputs, eventCapacity, eventCounterData, eventInputCapacity, VFX_EVENT_BYTES, VFX_EVENT_COUNTER_BYTES, VFX_EVENT_INPUT_BYTES, } from './feature/event-resources.js';
 export { createVfxRenderInspectSnapshot, gpuParticleRenderFeature, resolveBillboardAdvancedState, topologyRecoveryHint, } from './feature/gpu-particle-feature.js';
-export { createTopologyResourcePlan, PARTICLE_SHADER_IDENTIFIERS, topologyCapacitySnapshot, } from './feature/particle-resources.js';
+export type { ParticleMaterialInputPreparationError, PreparedParticleMaterialInputs, } from './feature/particle-resources.js';
+export { createTopologyResourcePlan, PARTICLE_INPUT_SHADER_IDENTIFIERS, PARTICLE_SHADER_IDENTIFIERS, prepareParticleMaterialInputs, topologyCapacitySnapshot, } from './feature/particle-resources.js';
 export type { VfxStagePlanError, VfxStagePlanObservation, VfxStageReadiness, VfxStageRecovery, VfxValidatedStage, VfxValidatedStagePlan, } from './feature/stage-plan.js';
 export { observeStagePlan, stageDispatches, stageRecoveryReadiness, validatedStagePlan, } from './feature/stage-plan.js';
 export type { VfxDataInterfaceAvailabilitySource, VfxDataInterfaceProvider, VfxDataInterfaceRegistry, } from './host/data-interface-providers.js';
-export { createCameraProvider, createSceneDepthProvider, createVfxDataInterfaceRegistry, } from './host/data-interface-providers.js';
+export { createCameraProvider, createNoiseProvider, createSceneDepthProvider, createVfxDataInterfaceRegistry, } from './host/data-interface-providers.js';
 export type { VfxAuthoringAssetRegistry, VfxRuntimeHost, VfxRuntimeHostControl, VfxRuntimeHostControlError, VfxRuntimeHostError, VfxRuntimeHostInspectSnapshot, VfxRuntimeHostOptions, } from './host/vfx-runtime-host.js';
 export { createVfxRuntimeHost, installVfxRuntimeDecoder } from './host/vfx-runtime-host.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,kCAAkC,EAClC,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,6BAA6B,EAC7B,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EACV,qCAAqC,EACrC,8BAA8B,GAC/B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EACjC,2BAA2B,EAC3B,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,kCAAkC,EAClC,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,6BAA6B,EAC7B,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}