hz-particles 1.0.13 → 1.0.15

package/dist-lib/hz-particles.d.ts

@@ -12,7 +12,7 @@ export interface ParticleSystemConfig {
   lifetime?: number;
   emissionRate?: number;
   emissionDuration?: number;
-  emissionShape?: 'cube' | 'sphere' | 'square' | 'circle' | 'cylinder' | 'point';
+  emissionShape?: 'cube' | 'sphere' | 'square' | 'circle' | 'cylinder' | 'plain' | 'cone' | 'torus' | 'line' | 'hemisphere' | 'disc' | 'annulus' | 'capsule' | 'arc' | 'spiral' | 'frustum' | 'cubeSurface' | 'sphereSurface' | 'boxFrame' | 'polygon' | 'rectangle' | 'point';
   particleSize?: number;
   particleSpeed?: number;
   particleColor?: [number, number, number];
@@ -24,6 +24,7 @@ export interface ParticleSystemConfig {
   randomColors?: number[][];
   textureEnabled?: boolean;
   textureType?: 'image' | 'glb';
+  textureImageData?: string;
   glbModelEnabled?: boolean;
   glbFileName?: string | null;
   glbAnimated?: boolean;
@@ -47,12 +48,12 @@ export interface ParticleSystemConfig {
   attractorEnabled?: boolean;
   attractorStrength?: number;
   attractorPosition?: [number, number, number];
-  shapeRotationX?: number;
-  shapeRotationY?: number;
-  shapeRotationZ?: number;
-  shapeTranslationX?: number;
-  shapeTranslationY?: number;
-  shapeTranslationZ?: number;
+  emissionRotationX?: number;
+  emissionRotationY?: number;
+  emissionRotationZ?: number;
+  emissionTranslationX?: number;
+  emissionTranslationY?: number;
+  emissionTranslationZ?: number;
   overrideXVelocity?: boolean;
   overrideYVelocity?: boolean;
   overrideZVelocity?: boolean;
@@ -68,6 +69,8 @@ export interface ParticleSystemConfig {
   squareInnerSize?: number;
   circleOuterRadius?: number;
   circleInnerRadius?: number;
+  rectangleWidth?: number;
+  rectangleHeight?: number;
   circleVelocityDirection?: string;
   cylinderOuterRadius?: number;
   cylinderInnerRadius?: number;
@@ -96,9 +99,17 @@ export interface ParticleSystemConfig {
   emissionTrailWidth?: number;
   emissionTrailMinDistance?: number;
   emissionTrailMaxPoints?: number;
+  emissionTrailSegments?: number;
+  emissionTrailShape?: 'straight' | 'zigzag' | 'sine' | 'spiral';
+  emissionTrailShapeAmplitude?: number;
+  emissionTrailShapeFrequency?: number;
+  emissionTrailShapeSpeed?: number;
+  shapeDisplay?: boolean;
+  followSystemTranslation?: boolean;
   followSystemId?: number | null;
   hidden?: boolean;
   oneOnlyMode?: boolean;
+  script?: string;
   glbModelData?: string;
   onAppearanceChange?: ((config: ParticleSystemConfig) => void) | null;
   onColorChange?: ((config: ParticleSystemConfig) => void) | null;
@@ -283,6 +294,7 @@ export class ParticleSystem {
     outParticleData: Float32Array,
     outVelocities: Float32Array
   ): Promise<PhysicsReadbackResult>;
+  setScript(source: string | null): void;
   destroy(): void;
   respawnParticle(oldIndex: number, newIndex: number): void;
   updateBuffers(): void;
@@ -380,6 +392,13 @@ export class ParticlePhysics {
     instanceBuffer: GPUBuffer,
     velocityBuffer: GPUBuffer
   ): Promise<PhysicsReadbackResult>;
+  readbackForScript(
+    activeParticles: number,
+    outParticleData: Float32Array,
+    outVelocities: Float32Array,
+    instanceBuffer: GPUBuffer,
+    velocityBuffer: GPUBuffer
+  ): Promise<PhysicsReadbackResult>;
   destroy(): void;
   setDamping(dampingValue: number): void;
   setGravity(gravityValue: number): void;
@@ -476,6 +495,23 @@ export class Objects3DManager {
   ): void;
 }
 
+export class ParticleScript {
+  constructor(source: string, config: ParticleSystemConfig, maxParticles: number);
+  compile(source: string): void;
+  execute(
+    deltaTime: number,
+    time: number,
+    frame: number,
+    totalFrames: number,
+    particleData: Float32Array,
+    velocityData: Float32Array,
+    count: number
+  ): boolean;
+  snapshotConfig(config: ParticleSystemConfig): void;
+  restoreConfig(config: ParticleSystemConfig): void;
+  destroy(): void;
+}
+
 // ─── WebGPU Utilities ────────────────────────────────────────────────────────
 
 export function initWebGPU(canvas: HTMLCanvasElement): Promise<WebGPUContext>;