@newkrok/three-particles 2.9.0 → 2.10.0

package/README.md

@@ -16,6 +16,9 @@ Particle system for ThreeJS.
 *   Visual editor for creating and fine-tuning effects: [THREE Particles Editor](https://github.com/NewKrok/three-particles-editor)
 *   Highly customizable particle properties (position, velocity, size, color, alpha, rotation, etc.).
 *   Support for various emitter shapes and parameters.
+*   Force fields and attractors for dynamic particle behavior (point attraction/repulsion, directional wind).
+*   Sub-emitters triggered on particle birth or death events.
+*   Serialization support for saving and loading particle system configs.
 *   TypeDoc API documentation available.
 
 # Live Demo & Examples

package/dist/index.d.ts

@@ -133,6 +133,45 @@ declare const enum SubEmitterTrigger {
      */
     DEATH = "DEATH"
 }
+/**
+ * Defines the type of force field that affects particles.
+ *
+ * @enum {string}
+ */
+declare const enum ForceFieldType {
+    /**
+     * Attract or repel particles toward/from a point in space.
+     * Positive strength attracts, negative strength repels.
+     * Configure with position, strength, range, and falloff.
+     */
+    POINT = "POINT",
+    /**
+     * Apply a constant directional force to all particles (like wind).
+     * Configure with direction and strength.
+     */
+    DIRECTIONAL = "DIRECTIONAL"
+}
+/**
+ * Defines how force diminishes with distance from a POINT force field center.
+ * Only applicable to {@link ForceFieldType.POINT} force fields.
+ *
+ * @enum {string}
+ */
+declare const enum ForceFieldFalloff {
+    /**
+     * No falloff — force is constant within range.
+     */
+    NONE = "NONE",
+    /**
+     * Force decreases linearly with distance: `1 - d/range`.
+     */
+    LINEAR = "LINEAR",
+    /**
+     * Force decreases with the square of distance: `1 - (d/range)²`.
+     * More physically realistic than linear falloff.
+     */
+    QUADRATIC = "QUADRATIC"
+}
 
 /**
  * A fixed numerical value.
@@ -753,6 +792,78 @@ type SubEmitterConfig = {
      */
     maxInstances?: number;
 };
+/**
+ * Configuration for a force field that affects particle velocities.
+ * Force fields can attract, repel, or push particles in a direction.
+ *
+ * @example
+ * ```typescript
+ * // Point attractor at origin
+ * const attractor: ForceFieldConfig = {
+ *   type: ForceFieldType.POINT,
+ *   position: new THREE.Vector3(0, 0, 0),
+ *   strength: 5.0,
+ *   range: 10,
+ *   falloff: ForceFieldFalloff.QUADRATIC,
+ * };
+ *
+ * // Repulsion shield
+ * const shield: ForceFieldConfig = {
+ *   type: ForceFieldType.POINT,
+ *   position: new THREE.Vector3(0, 0, 0),
+ *   strength: -3.0,
+ *   range: 5,
+ *   falloff: ForceFieldFalloff.LINEAR,
+ * };
+ *
+ * // Wind effect
+ * const wind: ForceFieldConfig = {
+ *   type: ForceFieldType.DIRECTIONAL,
+ *   direction: new THREE.Vector3(1, 0, 0),
+ *   strength: 2.0,
+ * };
+ * ```
+ */
+type ForceFieldConfig = {
+    /** Whether this force field is active. @default true */
+    isActive?: boolean;
+    /** Type of the force field. @default ForceFieldType.POINT */
+    type?: ForceFieldType;
+    /** Position in 3D space for POINT type force fields. @default (0,0,0) */
+    position?: THREE.Vector3;
+    /** Direction vector for DIRECTIONAL type force fields. @default (0,1,0) */
+    direction?: THREE.Vector3;
+    /**
+     * Force strength. Positive = attract (POINT) or push along direction (DIRECTIONAL).
+     * Negative = repel (POINT) or push against direction (DIRECTIONAL).
+     * Supports constant, random range, or lifetime curve (evaluated against system lifetime).
+     * @default 1
+     */
+    strength?: Constant | RandomBetweenTwoConstants | LifetimeCurve;
+    /**
+     * Maximum effective range for POINT type. Particles beyond this distance are unaffected.
+     * @default Infinity
+     */
+    range?: number;
+    /**
+     * How force diminishes with distance for POINT type.
+     * @default ForceFieldFalloff.LINEAR
+     */
+    falloff?: ForceFieldFalloff;
+};
+/**
+ * Internal normalized force field configuration where all properties are required.
+ * Created during particle system initialization from user-provided {@link ForceFieldConfig}.
+ */
+type NormalizedForceFieldConfig = {
+    isActive: boolean;
+    type: ForceFieldType;
+    position: THREE.Vector3;
+    direction: THREE.Vector3;
+    strength: Constant | RandomBetweenTwoConstants | LifetimeCurve;
+    range: number;
+    falloff: ForceFieldFalloff;
+};
 /**
  * Configuration object for the particle system.
  * Defines all aspects of the particle system, including its appearance, behavior, and runtime events.
@@ -1256,6 +1367,27 @@ type ParticleSystemConfig = {
      * ```
      */
     subEmitters?: Array<SubEmitterConfig>;
+    /**
+     * Force fields that affect particle velocities.
+     * Each force field can attract, repel, or push particles in a direction.
+     * Multiple force fields are applied cumulatively.
+     *
+     * @default []
+     *
+     * @example
+     * ```typescript
+     * forceFields: [
+     *   {
+     *     type: ForceFieldType.POINT,
+     *     position: new THREE.Vector3(0, 0, 0),
+     *     strength: 5.0,
+     *     range: 10,
+     *     falloff: ForceFieldFalloff.QUADRATIC,
+     *   },
+     * ]
+     * ```
+     */
+    forceFields?: Array<ForceFieldConfig>;
     /**
      * Called on every update frame with particle system data.
      */
@@ -1345,6 +1477,7 @@ type ParticleSystemInstance = {
     looping: boolean;
     simulationSpace: SimulationSpace;
     gravity: number;
+    normalizedForceFields: Array<NormalizedForceFieldConfig>;
     emission: Emission;
     normalizedConfig: NormalizedParticleSystemConfig;
     iterationCount: number;
@@ -1852,4 +1985,4 @@ declare const getDefaultParticleSystemConfig: () => any;
 declare const createParticleSystem: (config?: ParticleSystemConfig, externalNow?: number) => ParticleSystem;
 declare const updateParticleSystems: (cycleData: CycleData) => void;
 
-export { type BezierCurve, type BezierPoint, type Box, type Burst, type BurstState, type Circle, type Cone, type Constant, type CurveBase, type CurveFunction, CurveFunctionId, type CycleData, type EasingCurve, type Emission, EmitFrom, type GeneralData, LifeTimeCurve, type LifetimeCurve, type MinMaxColor, type Noise, type NoiseConfig, type NormalizedParticleSystemConfig, type ParticleSystem, type ParticleSystemConfig, type ParticleSystemInstance, type Point3D, type RandomBetweenTwoConstants, type Rectangle, type Renderer, type Rgb, Shape, type ShapeConfig, SimulationSpace, type Sphere, type SubEmitterConfig, SubEmitterTrigger, type TextureSheetAnimation, TimeMode, type Transform, type VelocityOverLifetime, applyModifiers, blendingMap, calculateRandomPositionAndVelocityOnBox, calculateRandomPositionAndVelocityOnCircle, calculateRandomPositionAndVelocityOnCone, calculateRandomPositionAndVelocityOnRectangle, calculateRandomPositionAndVelocityOnSphere, calculateValue, createBezierCurveFunction, createDefaultParticleTexture, createParticleSystem, curveFunctionIdMap, getBezierCacheSize, getCurveFunction, getCurveFunctionFromConfig, getDefaultParticleSystemConfig, isLifeTimeCurve, removeBezierCurveFunction, updateParticleSystems };
+export { type BezierCurve, type BezierPoint, type Box, type Burst, type BurstState, type Circle, type Cone, type Constant, type CurveBase, type CurveFunction, CurveFunctionId, type CycleData, type EasingCurve, type Emission, EmitFrom, type ForceFieldConfig, ForceFieldFalloff, ForceFieldType, type GeneralData, LifeTimeCurve, type LifetimeCurve, type MinMaxColor, type Noise, type NoiseConfig, type NormalizedForceFieldConfig, type NormalizedParticleSystemConfig, type ParticleSystem, type ParticleSystemConfig, type ParticleSystemInstance, type Point3D, type RandomBetweenTwoConstants, type Rectangle, type Renderer, type Rgb, Shape, type ShapeConfig, SimulationSpace, type Sphere, type SubEmitterConfig, SubEmitterTrigger, type TextureSheetAnimation, TimeMode, type Transform, type VelocityOverLifetime, applyModifiers, blendingMap, calculateRandomPositionAndVelocityOnBox, calculateRandomPositionAndVelocityOnCircle, calculateRandomPositionAndVelocityOnCone, calculateRandomPositionAndVelocityOnRectangle, calculateRandomPositionAndVelocityOnSphere, calculateValue, createBezierCurveFunction, createDefaultParticleTexture, createParticleSystem, curveFunctionIdMap, getBezierCacheSize, getCurveFunction, getCurveFunctionFromConfig, getDefaultParticleSystemConfig, isLifeTimeCurve, removeBezierCurveFunction, updateParticleSystems };

package/dist/index.js

@@ -1,5 +1,5 @@
 import Easing from 'easing-functions';
-import * as THREE3 from 'three';
+import * as THREE4 from 'three';
 import { ObjectUtils } from '@newkrok/three-utils';
 import { Gyroscope } from 'three/examples/jsm/misc/Gyroscope.js';
 import { FBM } from 'three-noise/build/three-noise.module.js';
@@ -165,6 +165,17 @@ var SubEmitterTrigger = /* @__PURE__ */ ((SubEmitterTrigger2) => {
   SubEmitterTrigger2["DEATH"] = "DEATH";
   return SubEmitterTrigger2;
 })(SubEmitterTrigger || {});
+var ForceFieldType = /* @__PURE__ */ ((ForceFieldType2) => {
+  ForceFieldType2["POINT"] = "POINT";
+  ForceFieldType2["DIRECTIONAL"] = "DIRECTIONAL";
+  return ForceFieldType2;
+})(ForceFieldType || {});
+var ForceFieldFalloff = /* @__PURE__ */ ((ForceFieldFalloff2) => {
+  ForceFieldFalloff2["NONE"] = "NONE";
+  ForceFieldFalloff2["LINEAR"] = "LINEAR";
+  ForceFieldFalloff2["QUADRATIC"] = "QUADRATIC";
+  return ForceFieldFalloff2;
+})(ForceFieldFalloff || {});
 var calculateRandomPositionAndVelocityOnSphere = (position, quaternion, velocity, speed, {
   radius,
   radiusThickness,
@@ -209,7 +220,7 @@ var calculateRandomPositionAndVelocityOnCone = (position, quaternion, velocity,
   position.applyQuaternion(quaternion);
   const positionLength = position.length();
   const normalizedAngle = Math.abs(
-    positionLength / radius * THREE3.MathUtils.degToRad(angle)
+    positionLength / radius * THREE4.MathUtils.degToRad(angle)
   );
   const sinNormalizedAngle = Math.sin(normalizedAngle);
   const speedMultiplierByPosition = 1 / positionLength;
@@ -284,8 +295,8 @@ var calculateRandomPositionAndVelocityOnRectangle = (position, quaternion, veloc
   const _rotation = rotation;
   const xOffset = Math.random() * _scale.x - _scale.x / 2;
   const yOffset = Math.random() * _scale.y - _scale.y / 2;
-  const rotationX = THREE3.MathUtils.degToRad(_rotation.x);
-  const rotationY = THREE3.MathUtils.degToRad(_rotation.y);
+  const rotationX = THREE4.MathUtils.degToRad(_rotation.x);
+  const rotationY = THREE4.MathUtils.degToRad(_rotation.y);
   position.x = xOffset * Math.cos(rotationY);
   position.y = yOffset * Math.cos(rotationX);
   position.z = xOffset * Math.sin(rotationY) - yOffset * Math.sin(rotationX);
@@ -308,7 +319,7 @@ var createDefaultParticleTexture = () => {
       context.arc(centerX, centerY, radius, 0, 2 * Math.PI, false);
       context.fillStyle = "white";
       context.fill();
-      const texture = new THREE3.CanvasTexture(canvas);
+      const texture = new THREE4.CanvasTexture(canvas);
       texture.needsUpdate = true;
       return texture;
     } else {
@@ -345,15 +356,15 @@ var calculateValue = (particleSystemId, value, time = 0) => {
     if (value.min === value.max) {
       return value.min ?? 0;
     }
-    return THREE3.MathUtils.randFloat(value.min ?? 0, value.max ?? 1);
+    return THREE4.MathUtils.randFloat(value.min ?? 0, value.max ?? 1);
   }
   const lifetimeCurve = value;
   return getCurveFunctionFromConfig(particleSystemId, lifetimeCurve)(time) * (lifetimeCurve.scale ?? 1);
 };
 
 // src/js/effects/three-particles/three-particles-modifiers.ts
-var noiseInput = new THREE3.Vector3(0, 0, 0);
-var orbitalEuler = new THREE3.Euler();
+var noiseInput = new THREE4.Vector3(0, 0, 0);
+var orbitalEuler = new THREE4.Euler();
 var applyModifiers = ({
   delta,
   generalData,
@@ -590,12 +601,81 @@ var ParticleSystemVertexShader = `
   }
 `;
 var particle_system_vertex_shader_glsl_default = ParticleSystemVertexShader;
+var _forceDirection = new THREE4.Vector3();
+var applyPointForce = (field, strength, velocity, positionArr, positionIndex, delta) => {
+  _forceDirection.set(
+    field.position.x - positionArr[positionIndex],
+    field.position.y - positionArr[positionIndex + 1],
+    field.position.z - positionArr[positionIndex + 2]
+  );
+  const distance = _forceDirection.length();
+  if (distance < 1e-4) return;
+  if (field.range !== Infinity && distance > field.range) return;
+  _forceDirection.divideScalar(distance);
+  let falloffMultiplier = 1;
+  if (field.range !== Infinity) {
+    const normalizedDistance = distance / field.range;
+    switch (field.falloff) {
+      case "LINEAR" /* LINEAR */:
+        falloffMultiplier = 1 - normalizedDistance;
+        break;
+      case "QUADRATIC" /* QUADRATIC */:
+        falloffMultiplier = 1 - normalizedDistance * normalizedDistance;
+        break;
+      case "NONE" /* NONE */:
+        falloffMultiplier = 1;
+        break;
+    }
+  }
+  const force = strength * falloffMultiplier * delta;
+  velocity.x += _forceDirection.x * force;
+  velocity.y += _forceDirection.y * force;
+  velocity.z += _forceDirection.z * force;
+};
+var applyDirectionalForce = (field, strength, velocity, delta) => {
+  const force = strength * delta;
+  velocity.x += field.direction.x * force;
+  velocity.y += field.direction.y * force;
+  velocity.z += field.direction.z * force;
+};
+var applyForceFields = ({
+  particleSystemId,
+  forceFields,
+  velocity,
+  positionArr,
+  positionIndex,
+  delta,
+  systemLifetimePercentage
+}) => {
+  for (let i = 0; i < forceFields.length; i++) {
+    const field = forceFields[i];
+    if (!field.isActive) continue;
+    const strength = calculateValue(
+      particleSystemId,
+      field.strength,
+      systemLifetimePercentage
+    );
+    if (strength === 0) continue;
+    if (field.type === "POINT" /* POINT */) {
+      applyPointForce(
+        field,
+        strength,
+        velocity,
+        positionArr,
+        positionIndex,
+        delta
+      );
+    } else if (field.type === "DIRECTIONAL" /* DIRECTIONAL */) {
+      applyDirectionalForce(field, strength, velocity, delta);
+    }
+  }
+};
 
 // src/js/effects/three-particles/three-particles.ts
 var _particleSystemId = 0;
 var createdParticleSystems = [];
-var _subEmitterPosition = new THREE3.Vector3();
-var _lastWorldPositionSnapshot = new THREE3.Vector3();
+var _subEmitterPosition = new THREE4.Vector3();
+var _lastWorldPositionSnapshot = new THREE4.Vector3();
 var _distanceStep = { x: 0, y: 0, z: 0 };
 var _tempPosition = { x: 0, y: 0, z: 0 };
 var _modifierParams = {
@@ -607,18 +687,18 @@ var _modifierParams = {
   particleIndex: 0
 };
 var blendingMap = {
-  "THREE.NoBlending": THREE3.NoBlending,
-  "THREE.NormalBlending": THREE3.NormalBlending,
-  "THREE.AdditiveBlending": THREE3.AdditiveBlending,
-  "THREE.SubtractiveBlending": THREE3.SubtractiveBlending,
-  "THREE.MultiplyBlending": THREE3.MultiplyBlending
+  "THREE.NoBlending": THREE4.NoBlending,
+  "THREE.NormalBlending": THREE4.NormalBlending,
+  "THREE.AdditiveBlending": THREE4.AdditiveBlending,
+  "THREE.SubtractiveBlending": THREE4.SubtractiveBlending,
+  "THREE.MultiplyBlending": THREE4.MultiplyBlending
 };
 var getDefaultParticleSystemConfig = () => JSON.parse(JSON.stringify(DEFAULT_PARTICLE_SYSTEM_CONFIG));
 var DEFAULT_PARTICLE_SYSTEM_CONFIG = {
   transform: {
-    position: new THREE3.Vector3(),
-    rotation: new THREE3.Vector3(),
-    scale: new THREE3.Vector3(1, 1, 1)
+    position: new THREE4.Vector3(),
+    rotation: new THREE4.Vector3(),
+    scale: new THREE4.Vector3(1, 1, 1)
   },
   duration: 5,
   looping: true,
@@ -670,7 +750,7 @@ var DEFAULT_PARTICLE_SYSTEM_CONFIG = {
   },
   map: void 0,
   renderer: {
-    blending: THREE3.NormalBlending,
+    blending: THREE4.NormalBlending,
     discardBackgroundColor: false,
     backgroundColorTolerance: 1,
     backgroundColor: { r: 1, g: 1, b: 1 },
@@ -756,11 +836,12 @@ var DEFAULT_PARTICLE_SYSTEM_CONFIG = {
     sizeAmount: 0
   },
   textureSheetAnimation: {
-    tiles: new THREE3.Vector2(1, 1),
+    tiles: new THREE4.Vector2(1, 1),
     timeMode: "LIFETIME" /* LIFETIME */,
     fps: 30,
     startFrame: 0
-  }
+  },
+  forceFields: []
 };
 var createFloat32Attributes = ({
   geometry,
@@ -776,7 +857,7 @@ var createFloat32Attributes = ({
   } else {
     array.fill(factory);
   }
-  geometry.setAttribute(propertyName, new THREE3.BufferAttribute(array, 1));
+  geometry.setAttribute(propertyName, new THREE4.BufferAttribute(array, 1));
 };
 var calculatePositionAndVelocity = (generalData, { shape, sphere, cone, circle, rectangle, box }, startSpeed, position, velocity) => {
   const calculatedStartSpeed = calculateValue(
@@ -860,14 +941,14 @@ var createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow
     particleSystemId: _particleSystemId++,
     normalizedLifetimePercentage: 0,
     distanceFromLastEmitByDistance: 0,
-    lastWorldPosition: new THREE3.Vector3(-99999),
-    currentWorldPosition: new THREE3.Vector3(-99999),
-    worldPositionChange: new THREE3.Vector3(),
-    worldQuaternion: new THREE3.Quaternion(),
-    wrapperQuaternion: new THREE3.Quaternion(),
-    lastWorldQuaternion: new THREE3.Quaternion(-99999),
-    worldEuler: new THREE3.Euler(),
-    gravityVelocity: new THREE3.Vector3(0, 0, 0),
+    lastWorldPosition: new THREE4.Vector3(-99999),
+    currentWorldPosition: new THREE4.Vector3(-99999),
+    worldPositionChange: new THREE4.Vector3(),
+    worldQuaternion: new THREE4.Quaternion(),
+    wrapperQuaternion: new THREE4.Quaternion(),
+    lastWorldQuaternion: new THREE4.Quaternion(-99999),
+    worldEuler: new THREE4.Euler(),
+    gravityVelocity: new THREE4.Vector3(0, 0, 0),
     startValues: {},
     linearVelocityData: void 0,
     orbitalVelocityData: void 0,
@@ -911,17 +992,28 @@ var createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow
     onUpdate,
     onComplete,
     textureSheetAnimation,
-    subEmitters
+    subEmitters,
+    forceFields: rawForceFields
   } = normalizedConfig;
+  const toVector3 = (v, fallback) => v ? new THREE4.Vector3(v.x ?? 0, v.y ?? 0, v.z ?? 0) : fallback.clone();
+  const normalizedForceFields = (rawForceFields ?? []).map((ff) => ({
+    isActive: ff.isActive ?? true,
+    type: ff.type ?? "POINT" /* POINT */,
+    position: toVector3(ff.position, new THREE4.Vector3(0, 0, 0)),
+    direction: toVector3(ff.direction, new THREE4.Vector3(0, 1, 0)).normalize(),
+    strength: ff.strength ?? 1,
+    range: Math.max(0, ff.range ?? Infinity),
+    falloff: ff.falloff ?? "LINEAR" /* LINEAR */
+  }));
   if (typeof renderer?.blending === "string")
     renderer.blending = blendingMap[renderer.blending];
   const startPositions = Array.from(
     { length: maxParticles },
-    () => new THREE3.Vector3()
+    () => new THREE4.Vector3()
   );
   const velocities = Array.from(
     { length: maxParticles },
-    () => new THREE3.Vector3()
+    () => new THREE4.Vector3()
   );
   generalData.creationTimes = Array.from({ length: maxParticles }, () => 0);
   const freeList = Array.from(
@@ -932,7 +1024,7 @@ var createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow
     generalData.linearVelocityData = Array.from(
       { length: maxParticles },
       () => ({
-        speed: new THREE3.Vector3(
+        speed: new THREE4.Vector3(
           velocityOverLifetime.linear.x ? calculateValue(
             generalData.particleSystemId,
             velocityOverLifetime.linear.x,
@@ -968,7 +1060,7 @@ var createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow
     generalData.orbitalVelocityData = Array.from(
       { length: maxParticles },
       () => ({
-        speed: new THREE3.Vector3(
+        speed: new THREE4.Vector3(
           velocityOverLifetime.orbital.x ? calculateValue(
             generalData.particleSystemId,
             velocityOverLifetime.orbital.x,
@@ -999,7 +1091,7 @@ var createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow
             velocityOverLifetime.orbital.z
           ) : void 0
         },
-        positionOffset: new THREE3.Vector3()
+        positionOffset: new THREE4.Vector3()
       })
     );
   }
@@ -1037,7 +1129,7 @@ var createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow
     if (value.isActive)
       generalData.lifetimeValues[key] = Array.from(
         { length: maxParticles },
-        () => THREE3.MathUtils.randFloat(value.min, value.max)
+        () => THREE4.MathUtils.randFloat(value.min, value.max)
       );
   });
   generalData.noise = {
@@ -1061,7 +1153,7 @@ var createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow
       probabilityPassed: false
     }));
   }
-  const material = new THREE3.ShaderMaterial({
+  const material = new THREE4.ShaderMaterial({
     uniforms: {
       elapsed: {
         value: 0
@@ -1095,7 +1187,7 @@ var createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow
     depthTest: renderer.depthTest,
     depthWrite: renderer.depthWrite
   });
-  const geometry = new THREE3.BufferGeometry();
+  const geometry = new THREE4.BufferGeometry();
   for (let i = 0; i < maxParticles; i++)
     calculatePositionAndVelocity(
       generalData,
@@ -1112,7 +1204,7 @@ var createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow
   }
   geometry.setAttribute(
     "position",
-    new THREE3.BufferAttribute(positionArray, 3)
+    new THREE4.BufferAttribute(positionArray, 3)
   );
   createFloat32Attributes({
     geometry,
@@ -1249,7 +1341,7 @@ var createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow
     );
     geometry.attributes.rotation.needsUpdate = true;
     if (normalizedConfig.rotationOverLifetime.isActive)
-      generalData.lifetimeValues.rotationOverLifetime[particleIndex] = THREE3.MathUtils.randFloat(
+      generalData.lifetimeValues.rotationOverLifetime[particleIndex] = THREE4.MathUtils.randFloat(
         normalizedConfig.rotationOverLifetime.min,
         normalizedConfig.rotationOverLifetime.max
       );
@@ -1333,7 +1425,7 @@ var createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow
   const cleanupCompletedInstances = (instances) => {
     for (let i = instances.length - 1; i >= 0; i--) {
       const sub = instances[i];
-      const points = sub.instance instanceof THREE3.Points ? sub.instance : sub.instance.children[0];
+      const points = sub.instance instanceof THREE4.Points ? sub.instance : sub.instance.children[0];
       const isActiveArr = points?.geometry?.attributes?.isActive?.array;
       if (!isActiveArr) {
         sub.dispose();
@@ -1368,7 +1460,7 @@ var createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow
           looping: false,
           transform: {
             ...subConfig.config.transform,
-            position: new THREE3.Vector3(position.x, position.y, position.z)
+            position: new THREE4.Vector3(position.x, position.y, position.z)
           },
           ...inheritVelocity > 0 ? {
             startSpeed: (typeof subConfig.config.startSpeed === "number" ? subConfig.config.startSpeed : typeof subConfig.config.startSpeed === "object" && subConfig.config.startSpeed !== null && "min" in subConfig.config.startSpeed ? subConfig.config.startSpeed.min ?? 0 : 0) + velocity.length() * inheritVelocity
@@ -1381,11 +1473,11 @@ var createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow
       instances.push(subSystem);
     }
   };
-  let particleSystem = new THREE3.Points(geometry, material);
+  let particleSystem = new THREE4.Points(geometry, material);
   particleSystem.position.copy(transform.position);
-  particleSystem.rotation.x = THREE3.MathUtils.degToRad(transform.rotation.x);
-  particleSystem.rotation.y = THREE3.MathUtils.degToRad(transform.rotation.y);
-  particleSystem.rotation.z = THREE3.MathUtils.degToRad(transform.rotation.z);
+  particleSystem.rotation.x = THREE4.MathUtils.degToRad(transform.rotation.x);
+  particleSystem.rotation.y = THREE4.MathUtils.degToRad(transform.rotation.y);
+  particleSystem.rotation.z = THREE4.MathUtils.degToRad(transform.rotation.z);
   particleSystem.scale.copy(transform.scale);
   const calculatedCreationTime = now + calculateValue(generalData.particleSystemId, startDelay) * 1e3;
   let wrapper;
@@ -1436,6 +1528,7 @@ var createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow
     looping,
     simulationSpace,
     gravity,
+    normalizedForceFields,
     emission,
     normalizedConfig,
     iterationCount: 0,
@@ -1491,9 +1584,11 @@ var updateParticleSystemInstance = (props, { now, delta, elapsed }) => {
     activateParticle,
     simulationSpace,
     gravity,
+    normalizedForceFields,
     onParticleDeath,
     onParticleBirth
   } = props;
+  const hasForceFields = normalizedForceFields.length > 0;
   const lifetime = now - creationTime;
   const normalizedLifetime = lifetime % (duration * 1e3);
   generalData.normalizedLifetimePercentage = Math.max(
@@ -1562,6 +1657,17 @@ var updateParticleSystemInstance = (props, { now, delta, elapsed }) => {
         velocity.x -= gravityVelocity.x * delta;
         velocity.y -= gravityVelocity.y * delta;
         velocity.z -= gravityVelocity.z * delta;
+        if (hasForceFields) {
+          applyForceFields({
+            particleSystemId: generalData.particleSystemId,
+            forceFields: normalizedForceFields,
+            velocity,
+            positionArr,
+            positionIndex: index * 3,
+            delta,
+            systemLifetimePercentage: generalData.normalizedLifetimePercentage
+          });
+        }
         if (gravity !== 0 || velocity.x !== 0 || velocity.y !== 0 || velocity.z !== 0 || worldPositionChange.x !== 0 || worldPositionChange.y !== 0 || worldPositionChange.z !== 0) {
           const positionIndex = index * 3;
           if (simulationSpace === "WORLD" /* WORLD */) {
@@ -1697,6 +1803,6 @@ var updateParticleSystems = (cycleData) => {
   );
 };
 
-export { CurveFunctionId, EmitFrom, LifeTimeCurve, Shape, SimulationSpace, SubEmitterTrigger, TimeMode, applyModifiers, blendingMap, calculateRandomPositionAndVelocityOnBox, calculateRandomPositionAndVelocityOnCircle, calculateRandomPositionAndVelocityOnCone, calculateRandomPositionAndVelocityOnRectangle, calculateRandomPositionAndVelocityOnSphere, calculateValue, createBezierCurveFunction, createDefaultParticleTexture, createParticleSystem, curveFunctionIdMap, getBezierCacheSize, getCurveFunction, getCurveFunctionFromConfig, getDefaultParticleSystemConfig, isLifeTimeCurve, removeBezierCurveFunction, updateParticleSystems };
+export { CurveFunctionId, EmitFrom, ForceFieldFalloff, ForceFieldType, LifeTimeCurve, Shape, SimulationSpace, SubEmitterTrigger, TimeMode, applyModifiers, blendingMap, calculateRandomPositionAndVelocityOnBox, calculateRandomPositionAndVelocityOnCircle, calculateRandomPositionAndVelocityOnCone, calculateRandomPositionAndVelocityOnRectangle, calculateRandomPositionAndVelocityOnSphere, calculateValue, createBezierCurveFunction, createDefaultParticleTexture, createParticleSystem, curveFunctionIdMap, getBezierCacheSize, getCurveFunction, getCurveFunctionFromConfig, getDefaultParticleSystemConfig, isLifeTimeCurve, removeBezierCurveFunction, updateParticleSystems };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map