hz-particles 1.2.0 → 1.4.0

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

@@ -80,7 +80,16 @@ export interface ParticleSystemConfig {
   cylinderVelocityDirection?: string;
   bloomIntensity?: number;
   rotation?: number;
-  rotationMode?: 'fixed' | 'random' | 'velocity';
+  /**
+   * Particle orientation. `fixed`/`random`/`velocity` are billboard modes; `oriented` locks the
+   * quad to a fixed world-space plane (Euler `orientX/Y/Z`); `cylindrical` keeps it upright while
+   * facing the camera horizontally (edge-on from directly above/below).
+   */
+  rotationMode?: 'fixed' | 'random' | 'velocity' | 'oriented' | 'cylindrical';
+  /** Euler angles in radians for `rotationMode: 'oriented'`. */
+  orientX?: number;
+  orientY?: number;
+  orientZ?: number;
   minRotation?: number;
   maxRotation?: number;
   aspectRatio?: number;
@@ -121,6 +130,12 @@ export interface ParticleSystemConfig {
   script?: string;
   glbModelData?: string;
   displayUnit?: 'm' | 'cm';
+  /** Delay in seconds before this emitter starts, for relative sequencing of emitters. */
+  startAt?: number;
+  /** Enable keyframe animation of system parameters over time (driven by the unified clock). */
+  keyframesEnabled?: boolean;
+  /** Per-parameter keyframe tracks (value + curve/easing), keyed by config field name. */
+  keyframes?: Record<string, unknown>;
   onAppearanceChange?: ((config: ParticleSystemConfig) => void) | null;
   onColorChange?: ((config: ParticleSystemConfig) => void) | null;
   onSizeChange?: ((config: ParticleSystemConfig) => void) | null;