@forgeax/engine-vfx 0.1.2

package/dist/gpu-program.d.ts

@@ -0,0 +1,80 @@
+import type { BindGroupLayoutDescriptor, ParticleEffectAsset, ParticleEffectProgram, ParticleEffectProgramEmitter } from '@forgeax/engine-types';
+import type { ParticleChannelSource, ParticleEmitterSourceV2, ParticleEventSource, ParticleRendererOverflowPolicy, ParticleRendererSorting, ParticleRendererSource, ParticleStageDomain, ParticleStageResourceAccess } from './code-source.js';
+import type { VfxDataInterfaceRequirement } from './data-interface.js';
+import type { VfxEffectReflection } from './effect-contract.js';
+export declare const VFX_GPU_PROGRAM_FORMAT: "forgeax-vfx-program-2";
+export declare const VFX_GPU_PROGRAM_ARTIFACT_KEY: "particle-effect/program.json";
+export interface VfxGpuStageReflection {
+    readonly id: string;
+    readonly entry: string;
+    readonly entryPoint: string;
+    readonly domain: ParticleStageDomain;
+    readonly resources: readonly {
+        readonly name: string;
+        readonly access: ParticleStageResourceAccess;
+    }[];
+    readonly dependsOn: readonly string[];
+    readonly iterationBudget: number;
+}
+export interface VfxGpuRendererReflection {
+    readonly topology: ParticleRendererSource['kind'];
+    readonly resource: string;
+    readonly capacity: number;
+    readonly overflow: ParticleRendererOverflowPolicy;
+    readonly enabled: boolean;
+    readonly shaderInputs: readonly string[];
+    readonly textureSheet?: {
+        readonly columns: number;
+        readonly rows: number;
+        readonly frameRate: number;
+        readonly frameCount: number;
+    };
+    readonly pivot?: readonly [number, number];
+    readonly softParticle?: {
+        readonly fadeDistance: number;
+        readonly requiresDepth: true;
+    };
+    readonly sorting?: ParticleRendererSorting;
+    readonly stripKey?: 'alive-index';
+    readonly historyLength?: number;
+    readonly endpointField?: 'velocity';
+}
+export interface VfxGpuProgramReflection {
+    readonly hooks: readonly ['vfx_spawn', 'vfx_update'];
+    readonly imports: readonly string[];
+    readonly resources: readonly string[];
+    readonly entryPoints: readonly string[];
+    readonly bindings: readonly BindGroupLayoutDescriptor[];
+    readonly layout?: VfxEffectReflection;
+    readonly dataInterfaces?: readonly VfxDataInterfaceRequirement[];
+    readonly eventChannels?: readonly ParticleChannelSource[];
+    readonly events?: readonly ParticleEventSource[];
+    readonly eventEntryPoint?: 'forgeax_vfx_event_main';
+    readonly stages?: readonly VfxGpuStageReflection[];
+    readonly renderers?: readonly VfxGpuRendererReflection[];
+}
+export interface VfxGpuEmitterProgram extends Omit<ParticleEffectProgramEmitter, 'schedule' | 'bounds' | 'renderers' | 'reflection' | 'channels' | 'events'> {
+    readonly id: string;
+    readonly module: string;
+    readonly capacity: number;
+    readonly backend: ParticleEmitterSourceV2['backend'];
+    readonly space: ParticleEmitterSourceV2['space'];
+    readonly schedule: ParticleEmitterSourceV2['schedule'];
+    readonly bounds: ParticleEmitterSourceV2['bounds'];
+    readonly renderers: ParticleEmitterSourceV2['renderers'];
+    readonly channels?: readonly ParticleChannelSource[];
+    readonly events?: readonly ParticleEventSource[];
+    readonly simulationWhenCulled: NonNullable<ParticleEmitterSourceV2['simulationWhenCulled']>;
+    readonly wgsl: string;
+    readonly reflection: VfxGpuProgramReflection;
+}
+export interface VfxGpuProgram extends Omit<ParticleEffectProgram, 'emitters'> {
+    readonly format: typeof VFX_GPU_PROGRAM_FORMAT;
+    readonly fingerprint: string;
+    readonly emitters: readonly VfxGpuEmitterProgram[];
+}
+export interface VfxGpuEffectAsset extends ParticleEffectAsset {
+    readonly guid: string;
+    readonly program: VfxGpuProgram;
+}
+//# sourceMappingURL=gpu-program.d.ts.map

package/dist/gpu-program.d.ts.map

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

package/dist/gpu-runtime.d.ts

@@ -0,0 +1,174 @@
+import { type EntityHandle, type World } from '@forgeax/engine-ecs';
+import type { Plugin } from '@forgeax/engine-plugin';
+import { type Handle } from '@forgeax/engine-types';
+import type { VfxValueMap } from './effect-contract.js';
+import type { VfxGpuEmitterProgram } from './gpu-program.js';
+import { ParticleEffectInstance, type VfxChannelCounters, type VfxReplayInput } from './instance.js';
+export declare const VFX_GPU_RUNTIME_RESOURCE_KEY = "VfxGpuRuntime";
+export interface VfxInspectSnapshotInput {
+    readonly layoutFingerprint: string;
+    readonly parameterGeneration: number;
+    readonly patchCount: number;
+    readonly dataInterfaces?: unknown;
+    readonly channels?: unknown;
+    readonly stages?: unknown;
+    readonly renderers?: unknown;
+    readonly hmr?: unknown;
+    readonly gpuTiming?: unknown;
+    readonly error?: {
+        readonly code: string;
+        readonly expected: string;
+        readonly hint: string;
+        readonly detail: unknown;
+    };
+}
+export declare function createVfxInspectSnapshot(input: VfxInspectSnapshotInput): {
+    readonly error?: {
+        readonly code: string;
+        readonly expected: string;
+        readonly hint: string;
+        readonly detail: unknown;
+    };
+    readonly gpuTiming?: {} | null;
+    readonly hmr?: {} | null;
+    readonly renderers?: {} | null;
+    readonly stages?: {} | null;
+    readonly channels?: {} | null;
+    readonly dataInterfaces?: {} | null;
+    readonly layout: {
+        readonly fingerprint: string;
+    };
+    readonly values: {
+        readonly generation: number;
+        readonly patchCount: number;
+    };
+};
+export interface VfxGpuTickIntent {
+    readonly sequence: number;
+    readonly player: EntityHandle;
+    readonly emitter: VfxGpuEmitterProgram;
+    readonly programFingerprint: string;
+    readonly reset: boolean;
+    readonly fixedDelta: number;
+    /** Effect-relative fixed tick. Resets to zero for replay and restart-on-visible. */
+    readonly phaseTick: number;
+    /** World-global FixedTime tick retained for renderer ring selection and correlation. */
+    readonly tick: number;
+    readonly seed: number;
+    readonly playCycle: number;
+    readonly spawnCount: number;
+    readonly firstParticleId: number;
+    readonly instanceGeneration: number;
+    readonly instancePatchCount: number;
+    readonly parameterBlock: Uint8Array;
+    readonly canonicalPayload: Uint8Array;
+    readonly replayInput: VfxReplayInput<VfxValueMap>;
+    readonly channelInputs: VfxReplayInput<VfxValueMap>['channelInputs'];
+    readonly eventCounters: VfxChannelCounters;
+}
+export interface VfxGpuEmitterInspectSnapshot {
+    readonly id: string;
+    readonly module: string;
+    readonly capacity: number;
+    /** Renderer-owned camera-frustum result. This is not an editor mute/isolate control. */
+    readonly cameraVisible: boolean;
+    /** Session-only preview mask. False suppresses both simulation and retained rendering. */
+    readonly sessionEnabled: boolean;
+    readonly phaseTick: number | null;
+    readonly tick: number | null;
+    readonly playCycle: number | null;
+    readonly spawnCount: number;
+    readonly firstParticleId: number;
+    readonly reset: boolean;
+    readonly schedule: VfxGpuEmitterProgram['schedule'];
+    readonly bounds: VfxGpuEmitterProgram['bounds'];
+    readonly simulationWhenCulled: VfxGpuEmitterProgram['simulationWhenCulled'];
+    readonly renderers: readonly {
+        readonly index: number;
+        readonly kind: VfxGpuEmitterProgram['renderers'][number]['kind'];
+        readonly enabled: boolean;
+    }[];
+    readonly stages: readonly string[];
+    readonly dataInterfaces: readonly string[];
+}
+export interface VfxGpuCommittedInspectSnapshot {
+    readonly sequence: number;
+    readonly tick: number;
+    readonly phaseTick: number;
+    readonly playCycle: number;
+    readonly spawnCount: number;
+    readonly firstParticleId: number;
+    readonly reset: boolean;
+    readonly instanceGeneration: number;
+    readonly instancePatchCount: number;
+}
+export interface VfxGpuPlayerInspectSnapshot {
+    readonly player: EntityHandle;
+    readonly assetGuid: string;
+    readonly programFingerprint: string;
+    readonly seed: number;
+    readonly fixedDelta: number;
+    readonly playing: boolean;
+    readonly values: {
+        readonly layoutFingerprint: string;
+        readonly generation: number;
+        readonly pendingPatchCount: number;
+    };
+    readonly queuedIntents: number;
+    readonly queuedTicks: number;
+    readonly lastCommitted: VfxGpuCommittedInspectSnapshot | null;
+    readonly channels: VfxChannelCounters;
+    readonly emitters: readonly VfxGpuEmitterInspectSnapshot[];
+    readonly diagnostics: readonly VfxGpuRuntimeDiagnostic[];
+}
+export interface VfxGpuRuntimeDiagnostic {
+    readonly code: 'vfx-intent-queue-overflow' | 'vfx-effect-unavailable' | 'vfx-player-invalid' | 'vfx-instance-commit-failed';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: {
+        readonly player: EntityHandle;
+        readonly maxQueuedTicks?: number;
+    };
+}
+export interface VfxGpuRuntimeOptions {
+    readonly maxQueuedTicks?: number;
+}
+export declare class VfxGpuRuntime {
+    #private;
+    constructor(options?: VfxGpuRuntimeOptions);
+    /** Resource generation owned by the current VFX render attachment. */
+    get renderGeneration(): number;
+    snapshot(): readonly VfxGpuTickIntent[];
+    diagnostics(): readonly VfxGpuRuntimeDiagnostic[];
+    lastCommitted(player: EntityHandle): VfxGpuTickIntent | undefined;
+    inspectPlayers(): readonly VfxGpuPlayerInspectSnapshot[];
+    inspectPlayer(player: EntityHandle): VfxGpuPlayerInspectSnapshot | undefined;
+    eventCounters(player: EntityHandle): VfxChannelCounters;
+    markEventDispatched(player: EntityHandle, counters: VfxChannelCounters): void;
+    hasPlayer(player: EntityHandle): boolean;
+    attachInstance(player: EntityHandle, instance: ParticleEffectInstance): void;
+    detachInstance(player: EntityHandle): void;
+    getInstance(player: EntityHandle): ParticleEffectInstance | undefined;
+    setEmitterCameraVisibility(player: EntityHandle, emitterId: string, visible: boolean): void;
+    setEmitterSessionEnabled(player: EntityHandle, emitterId: string, enabled: boolean): void;
+    isEmitterSessionEnabled(player: EntityHandle, emitterId: string): boolean;
+    /** Restart from tick zero without changing authored `ParticleEffectPlayer.playing`. */
+    replay(player: EntityHandle, input?: VfxReplayInput<VfxValueMap>): void;
+    commit(sequence: number): void;
+    reset(player: EntityHandle): void;
+    /**
+     * Drop every generation-owned VFX runtime value after device recovery.
+     * Authored ParticleEffectPlayer state remains the restart source on the next
+     * FixedUpdate; no queued intent or stale instance crosses the boundary.
+     */
+    recover(): void;
+    advance(world: World, tick: number, fixedDelta: number, players: readonly {
+        readonly player: EntityHandle;
+        readonly effect: Handle<'ParticleEffectAsset', 'shared'>;
+        readonly playing: boolean;
+        readonly seed: number;
+        readonly timeScale: number;
+    }[]): void;
+}
+export declare function vfxGpuRuntimePlugin(options?: VfxGpuRuntimeOptions): Plugin;
+//# sourceMappingURL=gpu-runtime.d.ts.map

package/dist/gpu-runtime.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export type { ParticleEffectAsset, ParticleEmitterDefinition } from '@forgeax/engine-types';
+export { particleEffectContribution } from './assets/particle-effect-decoder.js';
+export type { VfxAuthoringCapabilityDescriptor, VfxAuthoringDependencyDescriptor, VfxAuthoringDescriptor, VfxAuthoringEmitterDescriptor, VfxAuthoringFieldDescriptor, VfxAuthoringNodeDescriptor, VfxAuthoringNodeRole, VfxAuthoringTimelineDescriptor, VfxAuthoringValue, } from './authoring-descriptor.js';
+export { describeVfxGpuEffect, isVfxGpuEffectAsset } from './authoring-descriptor.js';
+export type { ParticleBoundsSource, ParticleChannelOverflowPolicy, ParticleChannelSource, ParticleCodeSourceError, ParticleCodeSourceInvalidDetail, ParticleEffectRootSourceV2, ParticleEffectSourceV2, ParticleEmitterSourceV2, ParticleEventSource, ParticleRendererOverflowPolicy, ParticleRendererSorting, ParticleRendererSource, ParticleStageDomain, ParticleStageResourceAccess, ParticleStageResourceSource, ParticleStageSource, } from './code-source.js';
+export { defineParticleEffectSourceV2, PARTICLE_CODE_DEFAULT_MODULE_ID, PARTICLE_STAGE_RESOURCE_NAMES, parseParticleEffectSourceV2, parseVfxStageDeclarations, } from './code-source.js';
+export type { VfxDataInterfaceBindingType, VfxDataInterfaceError, VfxDataInterfaceErrorDetail, VfxDataInterfaceKind, VfxDataInterfaceLifetime, VfxDataInterfaceProvider, VfxDataInterfaceRequirement, VfxDataInterfaceResolution, VfxDataInterfaceResource, VfxDataInterfaceToken, } from './data-interface.js';
+export { resolveVfxDataInterfaces } from './data-interface.js';
+export type { VfxEffectContract, VfxEffectContractError, VfxEffectContractErrorDetail, VfxEffectReflection, VfxReflectedField, VfxReflectedStruct, VfxValue, VfxValueMap, VfxValueType, } from './effect-contract.js';
+export { createVfxEffectContract, validateVfxEffectValues } from './effect-contract.js';
+export type { VfxGpuAssetError } from './gpu-loader.js';
+export { loadVfxGpuEffect, vfxGpuEffectContribution, vfxGpuEffectPackLoader, } from './gpu-loader.js';
+export type { VfxGpuEffectAsset, VfxGpuEmitterProgram, VfxGpuProgram, VfxGpuProgramReflection, VfxGpuStageReflection, } from './gpu-program.js';
+export { VFX_GPU_PROGRAM_ARTIFACT_KEY, VFX_GPU_PROGRAM_FORMAT } from './gpu-program.js';
+export type { VfxGpuEmitterInspectSnapshot, VfxGpuPlayerInspectSnapshot, VfxGpuRuntimeDiagnostic, VfxGpuRuntimeOptions, VfxGpuTickIntent, } from './gpu-runtime.js';
+export { createVfxInspectSnapshot, VFX_GPU_RUNTIME_RESOURCE_KEY, VfxGpuRuntime, vfxGpuRuntimePlugin, } from './gpu-runtime.js';
+export type { VfxChannelCounters, VfxChannelInput, VfxChannelPayload, VfxInstanceCommit, VfxInstanceCommitOptions, VfxInstanceError, VfxInstanceOptions, VfxInstanceParent, VfxReplayInput, } from './instance.js';
+export { createParticleEffectInstance, ParticleEffectInstance, } from './instance.js';
+export type { ParticleEffectPlayerData } from './player.js';
+export { ParticleEffectPlayer } from './player.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,YAAY,EACV,gCAAgC,EAChC,gCAAgC,EAChC,sBAAsB,EACtB,6BAA6B,EAC7B,2BAA2B,EAC3B,0BAA0B,EAC1B,oBAAoB,EACpB,8BAA8B,EAC9B,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACtF,YAAY,EACV,oBAAoB,EACpB,6BAA6B,EAC7B,qBAAqB,EACrB,uBAAuB,EACvB,+BAA+B,EAC/B,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,8BAA8B,EAC9B,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,2BAA2B,EAC3B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,6BAA6B,EAC7B,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,2BAA2B,EAC3B,qBAAqB,EACrB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACxF,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACxF,YAAY,EACV,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,aAAa,EACb,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}