@forgeax/engine-vfx 0.1.2

package/dist/__tests__/authoring-descriptor.unit.test.d.ts.map

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

package/dist/__tests__/channel-input.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=channel-input.unit.test.d.ts.map

package/dist/__tests__/channel-input.unit.test.d.ts.map

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

package/dist/__tests__/channel-inspect.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=channel-inspect.unit.test.d.ts.map

package/dist/__tests__/channel-inspect.unit.test.d.ts.map

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

package/dist/__tests__/code-source-v2.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=code-source-v2.unit.test.d.ts.map

package/dist/__tests__/code-source-v2.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-source-v2.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/code-source-v2.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/data-interface-contract.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data-interface-contract.unit.test.d.ts.map

package/dist/__tests__/data-interface-contract.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-interface-contract.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/data-interface-contract.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/effect-contract.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=effect-contract.unit.test.d.ts.map

package/dist/__tests__/effect-contract.unit.test.d.ts.map

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

package/dist/__tests__/gpu-program-simulation-culling-owner.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gpu-program-simulation-culling-owner.test-d.d.ts.map

package/dist/__tests__/gpu-program-simulation-culling-owner.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-program-simulation-culling-owner.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/gpu-program-simulation-culling-owner.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/gpu-reflection-vocabulary-owner.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gpu-reflection-vocabulary-owner.test-d.d.ts.map

package/dist/__tests__/gpu-reflection-vocabulary-owner.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-reflection-vocabulary-owner.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/gpu-reflection-vocabulary-owner.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/gpu-runtime.integration.test.d.ts

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

package/dist/__tests__/gpu-runtime.integration.test.d.ts.map

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

package/dist/__tests__/inspect-snapshot.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inspect-snapshot.unit.test.d.ts.map

package/dist/__tests__/inspect-snapshot.unit.test.d.ts.map

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

package/dist/__tests__/instance-public-api.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=instance-public-api.unit.test.d.ts.map

package/dist/__tests__/instance-public-api.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-public-api.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/instance-public-api.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/instance.unit.test.d.ts

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

package/dist/__tests__/instance.unit.test.d.ts.map

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

package/dist/__tests__/loader-v1-rejection.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=loader-v1-rejection.unit.test.d.ts.map

package/dist/__tests__/loader-v1-rejection.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-v1-rejection.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/loader-v1-rejection.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/player-reflection.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=player-reflection.unit.test.d.ts.map

package/dist/__tests__/player-reflection.unit.test.d.ts.map

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

package/dist/__tests__/player-type.test-d.d.ts

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

package/dist/__tests__/player-type.test-d.d.ts.map

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

package/dist/__tests__/renderer-source.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=renderer-source.unit.test.d.ts.map

package/dist/__tests__/renderer-source.unit.test.d.ts.map

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

package/dist/__tests__/replay-canonical.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=replay-canonical.unit.test.d.ts.map

package/dist/__tests__/replay-canonical.unit.test.d.ts.map

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

package/dist/__tests__/runtime-dist-isolation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-dist-isolation.test.d.ts.map

package/dist/__tests__/runtime-dist-isolation.test.d.ts.map

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

package/dist/__tests__/scriptable-pack-consumer.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scriptable-pack-consumer.test-d.d.ts.map

package/dist/__tests__/scriptable-pack-consumer.test-d.d.ts.map

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

package/dist/__tests__/stage-source.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stage-source.unit.test.d.ts.map

package/dist/__tests__/stage-source.unit.test.d.ts.map

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

package/dist/__tests__/vfx-data-interface-vocabulary-owner.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vfx-data-interface-vocabulary-owner.test-d.d.ts.map

package/dist/__tests__/vfx-data-interface-vocabulary-owner.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfx-data-interface-vocabulary-owner.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/vfx-data-interface-vocabulary-owner.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/vfx-performance-contract.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vfx-performance-contract.unit.test.d.ts.map

package/dist/__tests__/vfx-performance-contract.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfx-performance-contract.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/vfx-performance-contract.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/vfx-value-type-owner.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vfx-value-type-owner.test-d.d.ts.map

package/dist/__tests__/vfx-value-type-owner.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfx-value-type-owner.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/vfx-value-type-owner.test-d.ts"],"names":[],"mappings":""}

package/dist/assets/particle-effect-decoder.d.ts

@@ -0,0 +1,3 @@
+import { type AssetDecoderContribution, type ParticleEffectAsset } from '@forgeax/engine-types';
+export declare const particleEffectContribution: AssetDecoderContribution<ParticleEffectAsset, 'particle-effect'>;
+//# sourceMappingURL=particle-effect-decoder.d.ts.map

package/dist/assets/particle-effect-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle-effect-decoder.d.ts","sourceRoot":"","sources":["../../src/assets/particle-effect-decoder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,wBAAwB,EAI7B,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,0BAA0B,EAAE,wBAAwB,CAC/D,mBAAmB,EACnB,iBAAiB,CAuBlB,CAAC"}

package/dist/authoring-descriptor.d.ts

@@ -0,0 +1,60 @@
+import type { VfxGpuEffectAsset } from './gpu-program.js';
+export type VfxAuthoringValue = null | string | number | boolean | readonly VfxAuthoringValue[] | {
+    readonly [key: string]: VfxAuthoringValue;
+};
+export interface VfxAuthoringFieldDescriptor {
+    readonly path: string;
+    readonly label: string;
+    readonly value: VfxAuthoringValue;
+    readonly valueType: 'text' | 'number' | 'boolean' | 'vector' | 'object';
+}
+export type VfxAuthoringNodeRole = 'emitter' | 'program' | 'parameters' | 'custom' | 'stage' | 'channel' | 'event' | 'renderer';
+export interface VfxAuthoringNodeDescriptor {
+    readonly id: string;
+    readonly role: VfxAuthoringNodeRole;
+    readonly label: string;
+    readonly sourcePath: string;
+    readonly fields: readonly VfxAuthoringFieldDescriptor[];
+    readonly children: readonly VfxAuthoringNodeDescriptor[];
+}
+export interface VfxAuthoringEmitterDescriptor extends VfxAuthoringNodeDescriptor {
+    readonly role: 'emitter';
+    readonly module: string;
+}
+export interface VfxAuthoringTimelineDescriptor {
+    readonly emitterId: string;
+    readonly rate: number;
+    readonly bursts: readonly {
+        readonly time: number;
+        readonly count: number;
+    }[];
+    readonly loopDuration?: number;
+}
+export interface VfxAuthoringDependencyDescriptor {
+    readonly kind: 'asset' | 'module' | 'data-interface';
+    readonly identity: string;
+    readonly sourcePath: string;
+}
+export interface VfxAuthoringCapabilityDescriptor {
+    readonly id: string;
+    readonly state: 'executable' | 'partial' | 'unavailable';
+    readonly reason?: string;
+}
+export interface VfxAuthoringDescriptor {
+    readonly version: 1;
+    readonly assetGuid: string;
+    readonly schemaVersion: 2;
+    readonly artifactFingerprint: string;
+    readonly emitters: readonly VfxAuthoringEmitterDescriptor[];
+    readonly timeline: readonly VfxAuthoringTimelineDescriptor[];
+    readonly dependencies: readonly VfxAuthoringDependencyDescriptor[];
+    readonly capabilities: readonly VfxAuthoringCapabilityDescriptor[];
+}
+/** Narrow an AssetRegistry payload without making editor consumers duplicate
+ * the cooked program shape. This deliberately validates the stable producer
+ * discriminants only; detailed artifact validation remains the pack loader's
+ * responsibility. */
+export declare function isVfxGpuEffectAsset(value: unknown): value is VfxGpuEffectAsset;
+/** Project the cooked runtime asset into a compiler-free, UI-neutral authoring read model. */
+export declare function describeVfxGpuEffect(effect: VfxGpuEffectAsset): VfxAuthoringDescriptor;
+//# sourceMappingURL=authoring-descriptor.d.ts.map

package/dist/authoring-descriptor.d.ts.map

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

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 = 'drop-newest' | 'drop-oldest';
+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 } 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 single runtime decoder map. */
+export declare const vfxGpuEffectContribution: AssetDecoderContribution<VfxGpuEffectAsset, 'particle-effect'>;
+export declare function loadVfxGpuEffect(registry: AssetRegistry, 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,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,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,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,EAAE,wBAAwB,CAC7D,iBAAiB,EACjB,iBAAiB,CAoClB,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAE7C"}