@forgeax/engine-vfx 0.0.0-dev.8d955ade1c79

package/dist/code-source.d.ts

@@ -0,0 +1,140 @@
+import { type Result } from '@forgeax/engine-types';
+/** Engine-owned seed module used by newly-authored particle effects. */
+export declare const PARTICLE_CODE_DEFAULT_MODULE_ID: "forgeax_vfx::default";
+export type ParticleBoundsSource = {
+    readonly kind: 'aabb';
+    readonly min: readonly [number, number, number];
+    readonly max: readonly [number, number, number];
+} | {
+    readonly kind: 'sphere';
+    readonly center: readonly [number, number, number];
+    readonly radius: number;
+};
+export type ParticleRendererOverflowPolicy = 'drop-newest' | 'drop-oldest';
+export type ParticleRendererSorting = 'none' | 'emitter' | 'back-to-front';
+export interface ParticleTextureSheetSource {
+    readonly columns: number;
+    readonly rows: number;
+    readonly frameRate: number;
+    readonly frameCount?: number;
+}
+export interface ParticleSoftParticleSource {
+    readonly fadeDistance: number;
+}
+export type ParticleRendererSource = {
+    readonly kind: 'billboard';
+    readonly material: string;
+    readonly blend?: 'additive' | 'alpha' | 'opaque-cutout';
+    readonly enabled?: boolean;
+    readonly capacity?: number;
+    readonly overflow?: ParticleRendererOverflowPolicy;
+    readonly textureSheet?: ParticleTextureSheetSource;
+    readonly pivot?: readonly [number, number];
+    readonly softParticle?: ParticleSoftParticleSource;
+    readonly sorting?: ParticleRendererSorting;
+} | {
+    readonly kind: 'mesh';
+    readonly material: string;
+    readonly mesh: string;
+    readonly submesh?: number;
+    readonly enabled?: boolean;
+} | {
+    readonly kind: 'ribbon';
+    readonly material: string;
+    readonly stripKey: 'alive-index';
+    readonly capacity: number;
+    readonly overflow?: ParticleRendererOverflowPolicy;
+    readonly enabled?: boolean;
+    readonly width?: number;
+} | {
+    readonly kind: 'trail';
+    readonly material: string;
+    readonly historyLength: number;
+    readonly capacity: number;
+    readonly overflow?: ParticleRendererOverflowPolicy;
+    readonly enabled?: boolean;
+    readonly width?: number;
+} | {
+    readonly kind: 'beam';
+    readonly material: string;
+    readonly endpointField: 'velocity';
+    readonly capacity: number;
+    readonly overflow?: ParticleRendererOverflowPolicy;
+    readonly enabled?: boolean;
+    readonly width?: number;
+};
+export type ParticleChannelOverflowPolicy = ParticleRendererOverflowPolicy;
+export type ParticleStageDomain = 'particle';
+export type ParticleStageResourceAccess = 'read' | 'write' | 'read-write';
+export interface ParticleStageResourceSource {
+    readonly name: string;
+    readonly access: ParticleStageResourceAccess;
+}
+export interface ParticleStageSource {
+    readonly id: string;
+    readonly entry: string;
+    readonly domain: ParticleStageDomain;
+    readonly resources: readonly ParticleStageResourceSource[];
+    readonly dependsOn: readonly string[];
+    readonly iterationBudget: number;
+}
+export declare const PARTICLE_STAGE_RESOURCE_NAMES: readonly ["particles", "runtime", "aliveIndices", "counters", "indirect", "scratch", "billboardInstances", "channelInputs", "events", "eventCounters"];
+export interface ParticleChannelSource {
+    readonly id: string;
+    readonly payload?: 'impact';
+    readonly capacity: number;
+    readonly overflow: ParticleChannelOverflowPolicy;
+}
+export interface ParticleEventSource {
+    readonly id: string;
+    readonly channel: string;
+    readonly subEmitter: string;
+    readonly fanOut: number;
+    readonly recursionDepth: number;
+}
+export interface ParticleEmitterSourceV2 {
+    readonly id: string;
+    readonly capacity: number;
+    readonly backend: {
+        readonly required: 'gpu';
+    };
+    readonly space: 'local' | 'world';
+    readonly bounds: ParticleBoundsSource;
+    readonly schedule: {
+        readonly rate: number;
+        readonly bursts?: readonly {
+            readonly time: number;
+            readonly count: number;
+        }[];
+        readonly loopDuration?: number;
+    };
+    readonly program: {
+        readonly module: string;
+    };
+    readonly renderers: readonly ParticleRendererSource[];
+    readonly channels?: readonly ParticleChannelSource[];
+    readonly events?: readonly ParticleEventSource[];
+    readonly simulationWhenCulled?: 'continue' | 'pause' | 'restart-on-visible';
+}
+export interface ParticleEffectRootSourceV2 {
+    readonly schemaVersion: 2;
+    readonly emitters: readonly ParticleEmitterSourceV2[];
+}
+export type ParticleEffectSourceV2 = ParticleEffectRootSourceV2;
+export interface ParticleCodeSourceInvalidDetail {
+    readonly path: string;
+    readonly emitterId?: string;
+    readonly stageId?: string;
+    readonly resource?: string;
+}
+export interface ParticleCodeSourceError {
+    readonly code: 'vfx-source-invalid' | 'vfx-source-version-unsupported' | 'vfx-source-channel-invalid' | 'vfx-source-event-invalid' | 'vfx-source-stage-invalid' | 'vfx-source-renderer-invalid';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: ParticleCodeSourceInvalidDetail;
+}
+/** Parse compiler-owned stage metadata from authored WGSL comments. */
+export declare function parseVfxStageDeclarations(source: string): Result<readonly ParticleStageSource[], ParticleCodeSourceError>;
+export declare function parseParticleEffectSourceV2(value: unknown): Result<ParticleEffectSourceV2, ParticleCodeSourceError>;
+export declare function defineParticleEffectSourceV2<T extends ParticleEffectSourceV2>(source: T): T;
+//# sourceMappingURL=code-source.d.ts.map

package/dist/code-source.d.ts.map

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

package/dist/data-interface.d.ts

@@ -0,0 +1,53 @@
+import { type Result } from '@forgeax/engine-types';
+export type VfxDataInterfaceKind = keyof VfxDataInterfaceBindingTypeByKind;
+export type VfxDataInterfaceToken = `vfx:${VfxDataInterfaceKind}`;
+export type VfxDataInterfaceBindingType = VfxDataInterfaceBindingTypeByKind[VfxDataInterfaceKind];
+type VfxDataInterfaceBindingTypeByKind = {
+    readonly camera: 'uniform';
+    readonly 'scene-depth': 'sampled-depth';
+    readonly noise: 'sampled-float';
+    readonly channel: 'storage-read';
+};
+export type VfxDataInterfaceLifetime = 'generation';
+export interface VfxDataInterfaceRequirement {
+    readonly token: VfxDataInterfaceToken;
+    readonly kind: VfxDataInterfaceKind;
+    readonly binding: number;
+    readonly bindingType: VfxDataInterfaceBindingType;
+    readonly lifetime: VfxDataInterfaceLifetime;
+}
+export interface VfxDataInterfaceResource {
+    readonly token: VfxDataInterfaceToken;
+    readonly kind: VfxDataInterfaceKind;
+    readonly bindingType: VfxDataInterfaceBindingType;
+    readonly generation: number;
+}
+export interface VfxDataInterfaceErrorDetail {
+    readonly token: VfxDataInterfaceToken;
+    readonly providerId?: string;
+    readonly expectedGeneration?: number;
+    readonly actualGeneration?: number;
+    readonly expectedBindingType?: VfxDataInterfaceBindingType;
+    readonly actualBindingType?: VfxDataInterfaceBindingType;
+}
+export interface VfxDataInterfaceError {
+    readonly code: 'vfx-data-interface-missing' | 'vfx-data-interface-wrong-type' | 'vfx-data-interface-stale' | 'vfx-data-interface-duplicate';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: VfxDataInterfaceErrorDetail;
+}
+export type VfxDataInterfaceProvider<K extends VfxDataInterfaceKind = VfxDataInterfaceKind> = {
+    readonly id: string;
+    readonly token: `vfx:${K}`;
+    readonly kind: K;
+    readonly bindingType: VfxDataInterfaceBindingTypeByKind[K];
+    readonly provide: (generation: number) => Result<VfxDataInterfaceResource, VfxDataInterfaceError>;
+};
+export interface VfxDataInterfaceResolution {
+    readonly generation: number;
+    readonly readiness: 'ready';
+    readonly resources: readonly VfxDataInterfaceResource[];
+}
+export declare function resolveVfxDataInterfaces(requirements: readonly VfxDataInterfaceRequirement[], providers: readonly VfxDataInterfaceProvider[], generation: number): Result<VfxDataInterfaceResolution, VfxDataInterfaceError>;
+export {};
+//# sourceMappingURL=data-interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-interface.d.ts","sourceRoot":"","sources":["../src/data-interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,oBAAoB,GAAG,MAAM,iCAAiC,CAAC;AAE3E,MAAM,MAAM,qBAAqB,GAAG,OAAO,oBAAoB,EAAE,CAAC;AAElE,MAAM,MAAM,2BAA2B,GAAG,iCAAiC,CAAC,oBAAoB,CAAC,CAAC;AAElG,KAAK,iCAAiC,GAAG;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,YAAY,CAAC;AAEpD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;CAC7C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;IAC3D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,2BAA2B,CAAC;CAC1D;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EACT,4BAA4B,GAC5B,+BAA+B,GAC/B,0BAA0B,GAC1B,8BAA8B,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;CAC9C;AAED,MAAM,MAAM,wBAAwB,CAAC,CAAC,SAAS,oBAAoB,GAAG,oBAAoB,IAAI;IAC5F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,WAAW,EAAE,iCAAiC,CAAC,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC,wBAAwB,EAAE,qBAAqB,CAAC,CAAC;CACnG,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACzD;AAYD,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,SAAS,2BAA2B,EAAE,EACpD,SAAS,EAAE,SAAS,wBAAwB,EAAE,EAC9C,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,0BAA0B,EAAE,qBAAqB,CAAC,CAoG3D"}

package/dist/effect-contract.d.ts

@@ -0,0 +1,57 @@
+import { type Result } from '@forgeax/engine-types';
+import type { VfxDataInterfaceRequirement } from './data-interface.js';
+export type VfxValue = number | readonly number[];
+export type VfxValueMap = Readonly<Record<string, VfxValue>>;
+export interface VfxReflectedField {
+    readonly name: string;
+    readonly type: VfxValueType;
+    readonly offset: number;
+    readonly size: number;
+    readonly alignment: number;
+    readonly defaultValue?: VfxValue;
+}
+export interface VfxReflectedStruct {
+    readonly name: string;
+    readonly fields: readonly VfxReflectedField[];
+    readonly size: number;
+    readonly alignment: number;
+}
+export interface VfxEffectReflection {
+    readonly version: 1;
+    readonly parameters: VfxReflectedStruct;
+    readonly custom: VfxReflectedStruct;
+    readonly dataInterfaces?: readonly VfxDataInterfaceRequirement[];
+    readonly fingerprint: string;
+}
+export interface VfxEffectContractErrorDetail {
+    readonly path: string;
+    readonly actual?: unknown;
+}
+export interface VfxEffectContractError {
+    readonly code: 'vfx-value-unknown-field' | 'vfx-value-type-mismatch' | 'vfx-value-not-finite' | 'vfx-reflection-invalid';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: VfxEffectContractErrorDetail;
+}
+export interface VfxEffectContract<Values extends VfxValueMap = VfxValueMap> {
+    readonly reflection: VfxEffectReflection;
+    readonly fingerprint: string;
+    readonly packedSize: number;
+    readonly defaults: Values;
+    createValues(initial?: Partial<Values>): Result<Values, VfxEffectContractError>;
+    validateValues(values: VfxValueMap): Result<Values, VfxEffectContractError>;
+    pack(values: Values): Result<Uint8Array, VfxEffectContractError>;
+}
+declare const VECTOR_LENGTH: {
+    f32: number;
+    i32: number;
+    u32: number;
+    'vec2<f32>': number;
+    'vec3<f32>': number;
+    'vec4<f32>': number;
+};
+export type VfxValueType = keyof typeof VECTOR_LENGTH;
+export declare function createVfxEffectContract<Values extends VfxValueMap = VfxValueMap>(reflection: VfxEffectReflection): VfxEffectContract<Values>;
+export declare function validateVfxEffectValues(reflection: VfxEffectReflection, values: VfxValueMap): Result<VfxValueMap, VfxEffectContractError>;
+export {};
+//# sourceMappingURL=effect-contract.d.ts.map

package/dist/effect-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-contract.d.ts","sourceRoot":"","sources":["../src/effect-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAEvE,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AAClD,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACjE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EACT,yBAAyB,GACzB,yBAAyB,GACzB,sBAAsB,GACtB,wBAAwB,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;CAC/C;AAED,MAAM,WAAW,iBAAiB,CAAC,MAAM,SAAS,WAAW,GAAG,WAAW;IACzE,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAChF,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAC5E,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;CAClE;AAED,QAAA,MAAM,aAAa;;;;;;;CAOlB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,aAAa,CAAC;AAgHtD,wBAAgB,uBAAuB,CAAC,MAAM,SAAS,WAAW,GAAG,WAAW,EAC9E,UAAU,EAAE,mBAAmB,GAC9B,iBAAiB,CAAC,MAAM,CAAC,CAiC3B;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,mBAAmB,EAC/B,MAAM,EAAE,WAAW,GAClB,MAAM,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAE7C"}

package/dist/gpu-loader.d.ts

@@ -0,0 +1,33 @@
+import type { AssetRegistry as LegacyAssetRegistry, RuntimeAssetRegistry } from '@forgeax/engine-assets-runtime';
+import type { AssetDecoderContribution, LoadContext, Result } from '@forgeax/engine-types';
+import { type VfxGpuEffectAsset } from './gpu-program.js';
+export interface VfxGpuAssetError {
+    readonly code: 'vfx-asset-v2-invalid' | 'vfx-asset-v2-program-missing' | 'vfx-asset-v2-fingerprint-mismatch';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: {
+        readonly guid: string;
+        readonly path: string;
+    };
+}
+interface PackLoaderInput {
+    readonly guid: string;
+    readonly kind: string;
+    readonly payload: Record<string, unknown>;
+    readonly artifacts: Readonly<Record<string, {
+        readonly descriptor: {
+            readonly path: string;
+            readonly mediaType: string;
+        };
+        readonly bytes: Uint8Array;
+    }>>;
+}
+export declare const vfxGpuEffectPackLoader: {
+    kind: string;
+    load(input: PackLoaderInput, _context: LoadContext): Promise<Result<VfxGpuEffectAsset, VfxGpuAssetError>>;
+};
+/** VFX owner decoder contribution for the core registry's typed map. */
+export declare const vfxGpuEffectContribution: AssetDecoderContribution<VfxGpuEffectAsset, 'particle-effect'>;
+export declare function loadVfxGpuEffect(registry: LegacyAssetRegistry | RuntimeAssetRegistry, guid: string): Promise<Result<VfxGpuEffectAsset, unknown>>;
+export {};
+//# sourceMappingURL=gpu-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-loader.d.ts","sourceRoot":"","sources":["../src/gpu-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,IAAI,mBAAmB,EACpC,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,wBAAwB,EAGxB,WAAW,EACX,MAAM,EACP,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EACT,sBAAsB,GACtB,8BAA8B,GAC9B,mCAAmC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE;AAED,UAAU,eAAe;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAC1B,MAAM,CACJ,MAAM,EACN;QACE,QAAQ,CAAC,UAAU,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3E,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;KAC5B,CACF,CACF,CAAC;CACH;AAuED,eAAO,MAAM,sBAAsB;;gBAGxB,eAAe,YACZ,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;CAmHxD,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,EAAE,wBAAwB,CAC7D,iBAAiB,EACjB,iBAAiB,CAoClB,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,mBAAmB,GAAG,oBAAoB,EACpD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAW7C"}

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":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,8BAA8B,EAC9B,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,eAAO,MAAM,sBAAsB,EAAG,uBAAgC,CAAC;AACvE,eAAO,MAAM,4BAA4B,EAAG,8BAAuC,CAAC;AAEpF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS;QAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;KAC9C,EAAE,CAAC;IACJ,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAA;KAAE,CAAC;IACxF,QAAQ,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,UAAU,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACjE,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,eAAe,CAAC,EAAE,wBAAwB,CAAC;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC1D;AAED,MAAM,WAAW,oBACf,SAAQ,IAAI,CACV,4BAA4B,EAC5B,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAC3E;IACD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC,WAAW,CAAC,CAAC;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,uBAAuB,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAC5F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;CAC9C;AAED,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAC;IAC5E,QAAQ,CAAC,MAAM,EAAE,OAAO,sBAAsB,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC"}

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';
+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,kCAAkC,CAAC;AAC9E,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"}