@newkrok/three-particles 1.0.3 → 2.0.1

package/README.md

@@ -1,26 +1,42 @@
 # THREE Particles
+[![Run Tests](https://github.com/NewKrok/three-particles/actions/workflows/test.yml/badge.svg)](https://github.com/NewKrok/three-particles/actions/workflows/test.yml)
+[![NPM Version](https://img.shields.io/npm/v/@newkrok/three-particles.svg)](https://www.npmjs.com/package/@newkrok/three-particles)
+[![NPM Downloads](https://img.shields.io/npm/dw/@newkrok/three-particles.svg)](https://www.npmjs.com/package/@newkrok/three-particles)
+[![Bundle Size](https://img.shields.io/bundlephobia/minzip/@newkrok/three-particles)](https://bundlephobia.com/package/@newkrok/three-particles)
 
-Particle system for ThreeJS
+Particle system for ThreeJS.
 
 # THREE Particles Editor
 
-You can create your own particle effects with it's editor https://github.com/NewKrok/three-particles-editor
+You can create your own particle effects with its editor: [https://github.com/NewKrok/three-particles-editor](https://github.com/NewKrok/three-particles-editor)
 
 # Video
 
-- Projectiles: https://youtu.be/Q352JuxON04
-- First preview: https://youtu.be/dtN_bndvoGU
+- Projectiles: [https://youtu.be/Q352JuxON04](https://youtu.be/Q352JuxON04)
+- First preview: [https://youtu.be/dtN_bndvoGU](https://youtu.be/dtN_bndvoGU)
 
-# Live demo
+# Live Demo
 
-https://newkrok.com/three-particles-editor/index.html
+[https://newkrok.com/three-particles-editor/index.html](https://newkrok.com/three-particles-editor/index.html)
 
-# Install
+# Documentation
 
-npm package https://www.npmjs.com/package/@newkrok/three-particles
+Automatically generated TypeDoc: [https://newkrok.github.io/three-particles/](https://newkrok.github.io/three-particles/)
 
-Install with npm
-`npm i @newkrok/three-particles`
+# Install
 
-Add as a package.json dependency
-`"dependencies": { ... "@newkrok/three-particles": "0.7.0" ... }, `
+NPM package: [https://www.npmjs.com/package/@newkrok/three-particles](https://www.npmjs.com/package/@newkrok/three-particles)
+
+Install with npm:
+```bash
+npm i @newkrok/three-particles
+```
+
+Add as a `package.json` dependency:
+```json
+"dependencies": {
+  ...
+  "@newkrok/three-particles": "2.0.0"
+  ...
+}
+```

package/dist/bundle-report.json

@@ -0,0 +1 @@
+[{"label":"three-particles.min.js","isAsset":true,"statSize":82300,"groups":[{"label":"dist","path":"./dist","statSize":72435,"groups":[{"id":69,"label":"index.js + 14 modules (concatenated)","path":"./dist/index.js + 14 modules (concatenated)","statSize":72435,"parsedSize":0,"gzipSize":0,"concatenated":true,"groups":[{"label":"dist","path":"./dist/index.js + 14 modules (concatenated)/dist","statSize":52729,"groups":[{"id":null,"label":"index.js","path":"./dist/index.js + 14 modules (concatenated)/dist/index.js","statSize":426,"parsedSize":0,"gzipSize":0,"inaccurateSizes":true},{"label":"js/effects/three-particles","path":"./dist/index.js + 14 modules (concatenated)/dist/js/effects/three-particles","statSize":52303,"groups":[{"id":null,"label":"three-particles-bezier.js","path":"./dist/index.js + 14 modules (concatenated)/dist/js/effects/three-particles/three-particles-bezier.js","statSize":2350,"parsedSize":0,"gzipSize":0,"inaccurateSizes":true},{"id":null,"label":"three-particles-curves.js","path":"./dist/index.js + 14 modules (concatenated)/dist/js/effects/three-particles/three-particles-curves.js","statSize":2628,"parsedSize":0,"gzipSize":0,"inaccurateSizes":true},{"id":null,"label":"three-particles-modifiers.js","path":"./dist/index.js + 14 modules (concatenated)/dist/js/effects/three-particles/three-particles-modifiers.js","statSize":4748,"parsedSize":0,"gzipSize":0,"inaccurateSizes":true},{"id":null,"label":"three-particles-utils.js","path":"./dist/index.js + 14 modules (concatenated)/dist/js/effects/three-particles/three-particles-utils.js","statSize":8634,"parsedSize":0,"gzipSize":0,"inaccurateSizes":true},{"id":null,"label":"three-particles.js","path":"./dist/index.js + 14 modules (concatenated)/dist/js/effects/three-particles/three-particles.js","statSize":31146,"parsedSize":0,"gzipSize":0,"inaccurateSizes":true},{"label":"shaders","path":"./dist/index.js + 14 modules (concatenated)/dist/js/effects/three-particles/shaders","statSize":2797,"groups":[{"id":null,"label":"particle-system-fragment-shader.glsl.js","path":"./dist/index.js + 14 modules (concatenated)/dist/js/effects/three-particles/shaders/particle-system-fragment-shader.glsl.js","statSize":1939,"parsedSize":0,"gzipSize":0,"inaccurateSizes":true},{"id":null,"label":"particle-system-vertex-shader.glsl.js","path":"./dist/index.js + 14 modules (concatenated)/dist/js/effects/three-particles/shaders/particle-system-vertex-shader.glsl.js","statSize":858,"parsedSize":0,"gzipSize":0,"inaccurateSizes":true}],"parsedSize":0,"gzipSize":0,"inaccurateSizes":true}],"parsedSize":0,"gzipSize":0,"inaccurateSizes":true}],"parsedSize":0,"gzipSize":0,"inaccurateSizes":true},{"label":"node_modules","path":"./dist/index.js + 14 modules (concatenated)/node_modules","statSize":19664,"groups":[{"label":"@newkrok/three-utils/src/js/newkrok/three-utils","path":"./dist/index.js + 14 modules (concatenated)/node_modules/@newkrok/three-utils/src/js/newkrok/three-utils","statSize":5203,"groups":[{"id":null,"label":"index.js","path":"./dist/index.js + 14 modules (concatenated)/node_modules/@newkrok/three-utils/src/js/newkrok/three-utils/index.js","statSize":349,"parsedSize":0,"gzipSize":0,"inaccurateSizes":true},{"id":null,"label":"callback-utils.js","path":"./dist/index.js + 14 modules (concatenated)/node_modules/@newkrok/three-utils/src/js/newkrok/three-utils/callback-utils.js","statSize":1350,"parsedSize":0,"gzipSize":0,"inaccurateSizes":true},{"id":null,"label":"object-utils.js","path":"./dist/index.js + 14 modules (concatenated)/node_modules/@newkrok/three-utils/src/js/newkrok/three-utils/object-utils.js","statSize":2458,"parsedSize":0,"gzipSize":0,"inaccurateSizes":true},{"id":null,"label":"time-utils.js","path":"./dist/index.js + 14 modules (concatenated)/node_modules/@newkrok/three-utils/src/js/newkrok/three-utils/time-utils.js","statSize":1046,"parsedSize":0,"gzipSize":0,"inaccurateSizes":true}],"parsedSize":0,"gzipSize":0,"inaccurateSizes":true},{"label":"three/examples/jsm/misc","path":"./dist/index.js + 14 modules (concatenated)/node_modules/three/examples/jsm/misc","statSize":1540,"groups":[{"id":null,"label":"Gyroscope.js","path":"./dist/index.js + 14 modules (concatenated)/node_modules/three/examples/jsm/misc/Gyroscope.js","statSize":1540,"parsedSize":0,"gzipSize":0,"inaccurateSizes":true}],"parsedSize":0,"gzipSize":0,"inaccurateSizes":true},{"label":"three-noise/build","path":"./dist/index.js + 14 modules (concatenated)/node_modules/three-noise/build","statSize":12921,"groups":[{"id":null,"label":"three-noise.module.js","path":"./dist/index.js + 14 modules (concatenated)/node_modules/three-noise/build/three-noise.module.js","statSize":12921,"parsedSize":0,"gzipSize":0,"inaccurateSizes":true}],"parsedSize":0,"gzipSize":0,"inaccurateSizes":true}],"parsedSize":0,"gzipSize":0,"inaccurateSizes":true}]}],"parsedSize":0,"gzipSize":0},{"label":"node_modules/easing-functions","path":"./node_modules/easing-functions","statSize":9865,"groups":[{"id":300,"label":"index.js","path":"./node_modules/easing-functions/index.js","statSize":9865}],"parsedSize":0,"gzipSize":0}],"isInitialByEntrypoint":{"main":true}}]

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './js/effects/three-particles/three-particles-bezier.js';
+export * from './js/effects/three-particles/three-particles-curves.js';
+export * from './js/effects/three-particles/three-particles-enums.js';
+export * from './js/effects/three-particles/three-particles-modifiers.js';
+export * from './js/effects/three-particles/three-particles-utils.js';
+export * from './js/effects/three-particles/three-particles.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":"AAAA,cAAc,wDAAwD,CAAC;AACvE,cAAc,wDAAwD,CAAC;AACvE,cAAc,uDAAuD,CAAC;AACtE,cAAc,2DAA2D,CAAC;AAC1E,cAAc,uDAAuD,CAAC;AACtE,cAAc,iDAAiD,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './js/effects/three-particles/three-particles-bezier.js';
+export * from './js/effects/three-particles/three-particles-curves.js';
+export * from './js/effects/three-particles/three-particles-enums.js';
+export * from './js/effects/three-particles/three-particles-modifiers.js';
+export * from './js/effects/three-particles/three-particles-utils.js';
+export * from './js/effects/three-particles/three-particles.js';

package/dist/js/effects/three-particles/index.d.ts

@@ -0,0 +1,7 @@
+export * from './three-particles-bezier.js';
+export * from './three-particles-curves.js';
+export * from './three-particles-enums.js';
+export * from './three-particles-modifiers.js';
+export * from './three-particles-utils.js';
+export * from './three-particles.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/js/effects/three-particles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/js/effects/three-particles/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}

package/dist/js/effects/three-particles/index.js

@@ -0,0 +1,6 @@
+export * from './three-particles-bezier.js';
+export * from './three-particles-curves.js';
+export * from './three-particles-enums.js';
+export * from './three-particles-modifiers.js';
+export * from './three-particles-utils.js';
+export * from './three-particles.js';

package/dist/js/effects/three-particles/shaders/particle-system-fragment-shader.glsl.d.ts

@@ -0,0 +1,3 @@
+declare const ParticleSystemFragmentShader = "\n  uniform sampler2D map;\n  uniform float elapsed;\n  uniform float fps;\n  uniform bool useFPSForFrameIndex;\n  uniform vec2 tiles;\n  uniform bool discardBackgroundColor;\n  uniform vec3 backgroundColor;\n  uniform float backgroundColorTolerance;\n\n  varying vec4 vColor;\n  varying float vLifetime;\n  varying float vStartLifetime;\n  varying float vRotation;\n  varying float vStartFrame;\n\n  void main()\n  {\n    gl_FragColor = vColor;\n    float mid = 0.5;\n\n    float frameIndex = round(vStartFrame) + (\n      useFPSForFrameIndex == true\n        ? fps == 0.0\n            ? 0.0\n            : max((vLifetime / 1000.0) * fps, 0.0)\n        : max(min(floor(min(vLifetime / vStartLifetime, 1.0) * (tiles.x * tiles.y)), tiles.x * tiles.y - 1.0), 0.0)\n    );\n        \n    float spriteXIndex = floor(mod(frameIndex, tiles.x));\n    float spriteYIndex = floor(mod(frameIndex / tiles.x, tiles.y));\n\n    vec2 frameUV = vec2(\n      gl_PointCoord.x / tiles.x + spriteXIndex / tiles.x,\n      gl_PointCoord.y / tiles.y + spriteYIndex / tiles.y);\n\n    vec2 center = vec2(0.5, 0.5);\n    vec2 centeredPoint = gl_PointCoord - center;\n\n    mat2 rotation = mat2(\n      cos(vRotation), sin(vRotation),\n      -sin(vRotation), cos(vRotation)\n    );\n\n    centeredPoint = rotation * centeredPoint;\n    vec2 centeredMiddlePoint = vec2(\n      centeredPoint.x + center.x,\n      centeredPoint.y + center.y\n    );\n\n    float dist = distance(centeredMiddlePoint, center);\n    if (dist > 0.5) discard;\n\n    vec2 uvPoint = vec2(\n      centeredMiddlePoint.x / tiles.x + spriteXIndex / tiles.x,\n      centeredMiddlePoint.y / tiles.y + spriteYIndex / tiles.y\n    );\n\n    vec4 rotatedTexture = texture2D(map, uvPoint);\n\n    gl_FragColor = gl_FragColor * rotatedTexture;\n\n    if (discardBackgroundColor && abs(length(rotatedTexture.rgb - backgroundColor.rgb)) < backgroundColorTolerance ) discard;\n  }\n";
+export default ParticleSystemFragmentShader;
+//# sourceMappingURL=particle-system-fragment-shader.glsl.d.ts.map

package/dist/js/effects/three-particles/shaders/particle-system-fragment-shader.glsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle-system-fragment-shader.glsl.d.ts","sourceRoot":"","sources":["../../../../../src/js/effects/three-particles/shaders/particle-system-fragment-shader.glsl.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,4BAA4B,k4DAgEjC,CAAC;AAEF,eAAe,4BAA4B,CAAC"}

package/{src → dist}/js/effects/three-particles/shaders/particle-system-fragment-shader.glsl.js

@@ -1,67 +1,66 @@
-const ParticleSystemFragmentShader = `
-  uniform sampler2D map;
-  uniform float elapsed;
-  uniform float fps;
-  uniform bool useFPSForFrameIndex;
-  uniform vec2 tiles;
-  uniform bool discardBackgroundColor;
-  uniform vec3 backgroundColor;
-  uniform float backgroundColorTolerance;
-
-  varying vec4 vColor;
-  varying float vLifetime;
-  varying float vStartLifetime;
-  varying float vRotation;
-  varying float vStartFrame;
-
-  void main()
-  {
-    gl_FragColor = vColor;
-    float mid = 0.5;
-
-    float frameIndex = round(vStartFrame) + (
-      useFPSForFrameIndex == true
-        ? fps == 0.0
-            ? 0.0
-            : max((vLifetime / 1000.0) * fps, 0.0)
-        : max(min(floor(min(vLifetime / vStartLifetime, 1.0) * (tiles.x * tiles.y)), tiles.x * tiles.y - 1.0), 0.0)
-    );
-        
-    float spriteXIndex = floor(mod(frameIndex, tiles.x));
-    float spriteYIndex = floor(mod(frameIndex / tiles.x, tiles.y));
-
-    vec2 frameUV = vec2(
-      gl_PointCoord.x / tiles.x + spriteXIndex / tiles.x,
-      gl_PointCoord.y / tiles.y + spriteYIndex / tiles.y);
-
-    vec2 center = vec2(0.5, 0.5);
-    vec2 centeredPoint = gl_PointCoord - center;
-
-    mat2 rotation = mat2(
-      cos(vRotation), sin(vRotation),
-      -sin(vRotation), cos(vRotation)
-    );
-
-    centeredPoint = rotation * centeredPoint;
-    vec2 centeredMiddlePoint = vec2(
-      centeredPoint.x + center.x,
-      centeredPoint.y + center.y
-    );
-
-    float dist = distance(centeredMiddlePoint, center);
-    if (dist > 0.5) discard;
-
-    vec2 uvPoint = vec2(
-      centeredMiddlePoint.x / tiles.x + spriteXIndex / tiles.x,
-      centeredMiddlePoint.y / tiles.y + spriteYIndex / tiles.y
-    );
-
-    vec4 rotatedTexture = texture2D(map, uvPoint);
-
-    gl_FragColor = gl_FragColor * rotatedTexture;
-
-    if (discardBackgroundColor && abs(length(rotatedTexture.rgb - backgroundColor.rgb)) < backgroundColorTolerance ) discard;
-  }
-`;
-
-export default ParticleSystemFragmentShader;
+const ParticleSystemFragmentShader = `
+  uniform sampler2D map;
+  uniform float elapsed;
+  uniform float fps;
+  uniform bool useFPSForFrameIndex;
+  uniform vec2 tiles;
+  uniform bool discardBackgroundColor;
+  uniform vec3 backgroundColor;
+  uniform float backgroundColorTolerance;
+
+  varying vec4 vColor;
+  varying float vLifetime;
+  varying float vStartLifetime;
+  varying float vRotation;
+  varying float vStartFrame;
+
+  void main()
+  {
+    gl_FragColor = vColor;
+    float mid = 0.5;
+
+    float frameIndex = round(vStartFrame) + (
+      useFPSForFrameIndex == true
+        ? fps == 0.0
+            ? 0.0
+            : max((vLifetime / 1000.0) * fps, 0.0)
+        : max(min(floor(min(vLifetime / vStartLifetime, 1.0) * (tiles.x * tiles.y)), tiles.x * tiles.y - 1.0), 0.0)
+    );
+        
+    float spriteXIndex = floor(mod(frameIndex, tiles.x));
+    float spriteYIndex = floor(mod(frameIndex / tiles.x, tiles.y));
+
+    vec2 frameUV = vec2(
+      gl_PointCoord.x / tiles.x + spriteXIndex / tiles.x,
+      gl_PointCoord.y / tiles.y + spriteYIndex / tiles.y);
+
+    vec2 center = vec2(0.5, 0.5);
+    vec2 centeredPoint = gl_PointCoord - center;
+
+    mat2 rotation = mat2(
+      cos(vRotation), sin(vRotation),
+      -sin(vRotation), cos(vRotation)
+    );
+
+    centeredPoint = rotation * centeredPoint;
+    vec2 centeredMiddlePoint = vec2(
+      centeredPoint.x + center.x,
+      centeredPoint.y + center.y
+    );
+
+    float dist = distance(centeredMiddlePoint, center);
+    if (dist > 0.5) discard;
+
+    vec2 uvPoint = vec2(
+      centeredMiddlePoint.x / tiles.x + spriteXIndex / tiles.x,
+      centeredMiddlePoint.y / tiles.y + spriteYIndex / tiles.y
+    );
+
+    vec4 rotatedTexture = texture2D(map, uvPoint);
+
+    gl_FragColor = gl_FragColor * rotatedTexture;
+
+    if (discardBackgroundColor && abs(length(rotatedTexture.rgb - backgroundColor.rgb)) < backgroundColorTolerance ) discard;
+  }
+`;
+export default ParticleSystemFragmentShader;

package/dist/js/effects/three-particles/shaders/particle-system-vertex-shader.glsl.d.ts

@@ -0,0 +1,3 @@
+declare const ParticleSystemVertexShader = "\n  attribute float size;\n  attribute float colorR;\n  attribute float colorG;\n  attribute float colorB;\n  attribute float colorA;\n  attribute float lifetime;\n  attribute float startLifetime;\n  attribute float rotation;\n  attribute float startFrame;\n\n  varying mat4 vPosition;\n  varying vec4 vColor;\n  varying float vLifetime;\n  varying float vStartLifetime;\n  varying float vRotation;\n  varying float vStartFrame;\n\n  void main()\n  {\n    vColor = vec4(colorR, colorG, colorB, colorA);\n    vLifetime = lifetime;\n    vStartLifetime = startLifetime;\n    vRotation = rotation;\n    vStartFrame = startFrame;\n\n    vec4 mvPosition = modelViewMatrix * vec4(position, 1.0);\n    gl_PointSize = size * (100.0 / length(mvPosition.xyz));\n    gl_Position = projectionMatrix * mvPosition;\n  }\n";
+export default ParticleSystemVertexShader;
+//# sourceMappingURL=particle-system-vertex-shader.glsl.d.ts.map

package/dist/js/effects/three-particles/shaders/particle-system-vertex-shader.glsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle-system-vertex-shader.glsl.d.ts","sourceRoot":"","sources":["../../../../../src/js/effects/three-particles/shaders/particle-system-vertex-shader.glsl.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,0BAA0B,2yBA8B/B,CAAC;AAEF,eAAe,0BAA0B,CAAC"}

package/{src → dist}/js/effects/three-particles/shaders/particle-system-vertex-shader.glsl.js

@@ -1,33 +1,32 @@
-const ParticleSystemVertexShader = `
-  attribute float size;
-  attribute float colorR;
-  attribute float colorG;
-  attribute float colorB;
-  attribute float colorA;
-  attribute float lifetime;
-  attribute float startLifetime;
-  attribute float rotation;
-  attribute float startFrame;
-
-  varying mat4 vPosition;
-  varying vec4 vColor;
-  varying float vLifetime;
-  varying float vStartLifetime;
-  varying float vRotation;
-  varying float vStartFrame;
-
-  void main()
-  {
-    vColor = vec4(colorR, colorG, colorB, colorA);
-    vLifetime = lifetime;
-    vStartLifetime = startLifetime;
-    vRotation = rotation;
-    vStartFrame = startFrame;
-
-    vec4 mvPosition = modelViewMatrix * vec4(position, 1.0);
-    gl_PointSize = size * (100.0 / length(mvPosition.xyz));
-    gl_Position = projectionMatrix * mvPosition;
-  }
-`;
-
-export default ParticleSystemVertexShader;
+const ParticleSystemVertexShader = `
+  attribute float size;
+  attribute float colorR;
+  attribute float colorG;
+  attribute float colorB;
+  attribute float colorA;
+  attribute float lifetime;
+  attribute float startLifetime;
+  attribute float rotation;
+  attribute float startFrame;
+
+  varying mat4 vPosition;
+  varying vec4 vColor;
+  varying float vLifetime;
+  varying float vStartLifetime;
+  varying float vRotation;
+  varying float vStartFrame;
+
+  void main()
+  {
+    vColor = vec4(colorR, colorG, colorB, colorA);
+    vLifetime = lifetime;
+    vStartLifetime = startLifetime;
+    vRotation = rotation;
+    vStartFrame = startFrame;
+
+    vec4 mvPosition = modelViewMatrix * vec4(position, 1.0);
+    gl_PointSize = size * (100.0 / length(mvPosition.xyz));
+    gl_Position = projectionMatrix * mvPosition;
+  }
+`;
+export default ParticleSystemVertexShader;

package/dist/js/effects/three-particles/three-particles-bezier.d.ts

@@ -0,0 +1,5 @@
+import { BezierPoint, CurveFunction } from './types.js';
+export declare const createBezierCurveFunction: (particleSystemId: number, bezierPoints: Array<BezierPoint>) => CurveFunction;
+export declare const removeBezierCurveFunction: (particleSystemId: number) => void;
+export declare const getBezierCacheSize: () => number;
+//# sourceMappingURL=three-particles-bezier.d.ts.map

package/dist/js/effects/three-particles/three-particles-bezier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-particles-bezier.d.ts","sourceRoot":"","sources":["../../../../src/js/effects/three-particles/three-particles-bezier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAcxD,eAAO,MAAM,yBAAyB,GACpC,kBAAkB,MAAM,EACxB,cAAc,KAAK,CAAC,WAAW,CAAC,kBAgDjC,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,kBAAkB,MAAM,SAYjE,CAAC;AAEF,eAAO,MAAM,kBAAkB,cAAqB,CAAC"}

package/dist/js/effects/three-particles/three-particles-bezier.js

@@ -0,0 +1,62 @@
+const cache = [];
+const nCr = (n, k) => {
+    let z = 1;
+    for (let i = 1; i <= k; i++)
+        z *= (n + 1 - i) / i;
+    return z;
+};
+export const createBezierCurveFunction = (particleSystemId, bezierPoints) => {
+    const cacheEntry = cache.find((item) => item.bezierPoints === bezierPoints);
+    if (cacheEntry) {
+        if (!cacheEntry.referencedBy.includes(particleSystemId))
+            cacheEntry.referencedBy.push(particleSystemId);
+        return cacheEntry.curveFunction;
+    }
+    const entry = {
+        referencedBy: [particleSystemId],
+        bezierPoints,
+        curveFunction: (percentage) => {
+            if (percentage < 0)
+                return bezierPoints[0].y;
+            if (percentage > 1)
+                return bezierPoints[bezierPoints.length - 1].y;
+            let start = 0;
+            let stop = bezierPoints.length - 1;
+            bezierPoints.find((point, index) => {
+                const result = percentage < (point.percentage ?? 0);
+                if (result)
+                    stop = index;
+                else if (point.percentage !== undefined)
+                    start = index;
+                return result;
+            });
+            const n = stop - start;
+            const calculatedPercentage = (percentage - (bezierPoints[start].percentage ?? 0)) /
+                ((bezierPoints[stop].percentage ?? 1) -
+                    (bezierPoints[start].percentage ?? 0));
+            let value = 0;
+            for (let i = 0; i <= n; i++) {
+                const p = bezierPoints[start + i];
+                const c = nCr(n, i) *
+                    Math.pow(1 - calculatedPercentage, n - i) *
+                    Math.pow(calculatedPercentage, i);
+                value += c * p.y;
+            }
+            return value;
+        },
+    };
+    cache.push(entry);
+    return entry.curveFunction;
+};
+export const removeBezierCurveFunction = (particleSystemId) => {
+    while (true) {
+        const index = cache.findIndex((item) => item.referencedBy.includes(particleSystemId));
+        if (index === -1)
+            break;
+        const entry = cache[index];
+        entry.referencedBy = entry.referencedBy.filter((id) => id !== particleSystemId);
+        if (entry.referencedBy.length === 0)
+            cache.splice(index, 1);
+    }
+};
+export const getBezierCacheSize = () => cache.length;

package/dist/js/effects/three-particles/three-particles-curves.d.ts

@@ -0,0 +1,37 @@
+import { CurveFunction } from './types.js';
+export declare const enum CurveFunctionId {
+    BEZIER = "BEZIER",
+    LINEAR = "LINEAR",
+    QUADRATIC_IN = "QUADRATIC_IN",
+    QUADRATIC_OUT = "QUADRATIC_OUT",
+    QUADRATIC_IN_OUT = "QUADRATIC_IN_OUT",
+    CUBIC_IN = "CUBIC_IN",
+    CUBIC_OUT = "CUBIC_OUT",
+    CUBIC_IN_OUT = "CUBIC_IN_OUT",
+    QUARTIC_IN = "QUARTIC_IN",
+    QUARTIC_OUT = "QUARTIC_OUT",
+    QUARTIC_IN_OUT = "QUARTIC_IN_OUT",
+    QUINTIC_IN = "QUINTIC_IN",
+    QUINTIC_OUT = "QUINTIC_OUT",
+    QUINTIC_IN_OUT = "QUINTIC_IN_OUT",
+    SINUSOIDAL_IN = "SINUSOIDAL_IN",
+    SINUSOIDAL_OUT = "SINUSOIDAL_OUT",
+    SINUSOIDAL_IN_OUT = "SINUSOIDAL_IN_OUT",
+    EXPONENTIAL_IN = "EXPONENTIAL_IN",
+    EXPONENTIAL_OUT = "EXPONENTIAL_OUT",
+    EXPONENTIAL_IN_OUT = "EXPONENTIAL_IN_OUT",
+    CIRCULAR_IN = "CIRCULAR_IN",
+    CIRCULAR_OUT = "CIRCULAR_OUT",
+    CIRCULAR_IN_OUT = "CIRCULAR_IN_OUT",
+    ELASTIC_IN = "ELASTIC_IN",
+    ELASTIC_OUT = "ELASTIC_OUT",
+    ELASTIC_IN_OUT = "ELASTIC_IN_OUT",
+    BACK_IN = "BACK_IN",
+    BACK_OUT = "BACK_OUT",
+    BACK_IN_OUT = "BACK_IN_OUT",
+    BOUNCE_IN = "BOUNCE_IN",
+    BOUNCE_OUT = "BOUNCE_OUT",
+    BOUNCE_IN_OUT = "BOUNCE_IN_OUT"
+}
+export declare const getCurveFunction: (curveFunctionId: CurveFunctionId | CurveFunction) => CurveFunction;
+//# sourceMappingURL=three-particles-curves.d.ts.map

package/dist/js/effects/three-particles/three-particles-curves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-particles-curves.d.ts","sourceRoot":"","sources":["../../../../src/js/effects/three-particles/three-particles-curves.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,0BAAkB,eAAe;IAC/B,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,gBAAgB,qBAAqB;IACrC,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,YAAY,iBAAiB;IAC7B,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,iBAAiB,sBAAsB;IACvC,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,kBAAkB,uBAAuB;IACzC,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;IAC7B,eAAe,oBAAoB;IACnC,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,aAAa,kBAAkB;CAChC;AAoCD,eAAO,MAAM,gBAAgB,GAC3B,iBAAiB,eAAe,GAAG,aAAa,KAC/C,aAGuC,CAAC"}

package/dist/js/effects/three-particles/three-particles-curves.js

@@ -0,0 +1,37 @@
+import Easing from 'easing-functions';
+const CurveFunctionIdMap = {
+    ["LINEAR" /* CurveFunctionId.LINEAR */]: Easing.Linear.None,
+    ["QUADRATIC_IN" /* CurveFunctionId.QUADRATIC_IN */]: Easing.Quadratic.In,
+    ["QUADRATIC_OUT" /* CurveFunctionId.QUADRATIC_OUT */]: Easing.Quadratic.Out,
+    ["QUADRATIC_IN_OUT" /* CurveFunctionId.QUADRATIC_IN_OUT */]: Easing.Quadratic.InOut,
+    ["CUBIC_IN" /* CurveFunctionId.CUBIC_IN */]: Easing.Cubic.In,
+    ["CUBIC_OUT" /* CurveFunctionId.CUBIC_OUT */]: Easing.Cubic.Out,
+    ["CUBIC_IN_OUT" /* CurveFunctionId.CUBIC_IN_OUT */]: Easing.Cubic.InOut,
+    ["QUARTIC_IN" /* CurveFunctionId.QUARTIC_IN */]: Easing.Quartic.In,
+    ["QUARTIC_OUT" /* CurveFunctionId.QUARTIC_OUT */]: Easing.Quartic.Out,
+    ["QUARTIC_IN_OUT" /* CurveFunctionId.QUARTIC_IN_OUT */]: Easing.Quartic.InOut,
+    ["QUINTIC_IN" /* CurveFunctionId.QUINTIC_IN */]: Easing.Quintic.In,
+    ["QUINTIC_OUT" /* CurveFunctionId.QUINTIC_OUT */]: Easing.Quintic.Out,
+    ["QUINTIC_IN_OUT" /* CurveFunctionId.QUINTIC_IN_OUT */]: Easing.Quintic.InOut,
+    ["SINUSOIDAL_IN" /* CurveFunctionId.SINUSOIDAL_IN */]: Easing.Sinusoidal.In,
+    ["SINUSOIDAL_OUT" /* CurveFunctionId.SINUSOIDAL_OUT */]: Easing.Sinusoidal.Out,
+    ["SINUSOIDAL_IN_OUT" /* CurveFunctionId.SINUSOIDAL_IN_OUT */]: Easing.Sinusoidal.InOut,
+    ["EXPONENTIAL_IN" /* CurveFunctionId.EXPONENTIAL_IN */]: Easing.Exponential.In,
+    ["EXPONENTIAL_OUT" /* CurveFunctionId.EXPONENTIAL_OUT */]: Easing.Exponential.Out,
+    ["EXPONENTIAL_IN_OUT" /* CurveFunctionId.EXPONENTIAL_IN_OUT */]: Easing.Exponential.InOut,
+    ["CIRCULAR_IN" /* CurveFunctionId.CIRCULAR_IN */]: Easing.Circular.In,
+    ["CIRCULAR_OUT" /* CurveFunctionId.CIRCULAR_OUT */]: Easing.Circular.Out,
+    ["CIRCULAR_IN_OUT" /* CurveFunctionId.CIRCULAR_IN_OUT */]: Easing.Circular.InOut,
+    ["ELASTIC_IN" /* CurveFunctionId.ELASTIC_IN */]: Easing.Elastic.In,
+    ["ELASTIC_OUT" /* CurveFunctionId.ELASTIC_OUT */]: Easing.Elastic.Out,
+    ["ELASTIC_IN_OUT" /* CurveFunctionId.ELASTIC_IN_OUT */]: Easing.Elastic.InOut,
+    ["BACK_IN" /* CurveFunctionId.BACK_IN */]: Easing.Back.In,
+    ["BACK_OUT" /* CurveFunctionId.BACK_OUT */]: Easing.Back.Out,
+    ["BACK_IN_OUT" /* CurveFunctionId.BACK_IN_OUT */]: Easing.Back.InOut,
+    ["BOUNCE_IN" /* CurveFunctionId.BOUNCE_IN */]: Easing.Bounce.In,
+    ["BOUNCE_OUT" /* CurveFunctionId.BOUNCE_OUT */]: Easing.Bounce.Out,
+    ["BOUNCE_IN_OUT" /* CurveFunctionId.BOUNCE_IN_OUT */]: Easing.Bounce.InOut,
+};
+export const getCurveFunction = (curveFunctionId) => typeof curveFunctionId === 'function'
+    ? curveFunctionId
+    : CurveFunctionIdMap[curveFunctionId];

package/dist/js/effects/three-particles/three-particles-enums.d.ts

@@ -0,0 +1,25 @@
+export declare const enum SimulationSpace {
+    LOCAL = "LOCAL",
+    WORLD = "WORLD"
+}
+export declare const enum Shape {
+    SPHERE = "SPHERE",
+    CONE = "CONE",
+    BOX = "BOX",
+    CIRCLE = "CIRCLE",
+    RECTANGLE = "RECTANGLE"
+}
+export declare const enum EmitFrom {
+    VOLUME = "VOLUME",
+    SHELL = "SHELL",
+    EDGE = "EDGE"
+}
+export declare const enum TimeMode {
+    LIFETIME = "LIFETIME",
+    FPS = "FPS"
+}
+export declare const enum LifeTimeCurve {
+    BEZIER = "BEZIER",
+    EASING = "EASING"
+}
+//# sourceMappingURL=three-particles-enums.d.ts.map

package/dist/js/effects/three-particles/three-particles-enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-particles-enums.d.ts","sourceRoot":"","sources":["../../../../src/js/effects/three-particles/three-particles-enums.ts"],"names":[],"mappings":"AAAA,0BAAkB,eAAe;IAC/B,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED,0BAAkB,KAAK;IACrB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED,0BAAkB,QAAQ;IACxB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AAED,0BAAkB,QAAQ;IACxB,QAAQ,aAAa;IACrB,GAAG,QAAQ;CACZ;AAED,0BAAkB,aAAa;IAC7B,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB"}

package/dist/js/effects/three-particles/three-particles-enums.js

@@ -0,0 +1 @@
+export {};

package/dist/js/effects/three-particles/three-particles-modifiers.d.ts

@@ -0,0 +1,11 @@
+import * as THREE from 'three';
+import { GeneralData, NormalizedParticleSystemConfig } from './types.js';
+export declare const applyModifiers: ({ delta, generalData, normalizedConfig, attributes, particleLifetimePercentage, particleIndex, }: {
+    delta: number;
+    generalData: GeneralData;
+    normalizedConfig: NormalizedParticleSystemConfig;
+    attributes: THREE.NormalBufferAttributes;
+    particleLifetimePercentage: number;
+    particleIndex: number;
+}) => void;
+//# sourceMappingURL=three-particles-modifiers.d.ts.map

package/dist/js/effects/three-particles/three-particles-modifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-particles-modifiers.d.ts","sourceRoot":"","sources":["../../../../src/js/effects/three-particles/three-particles-modifiers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,WAAW,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAKzE,eAAO,MAAM,cAAc,GAAI,kGAO5B;IACD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,WAAW,CAAC;IACzB,gBAAgB,EAAE,8BAA8B,CAAC;IACjD,UAAU,EAAE,KAAK,CAAC,sBAAsB,CAAC;IACzC,0BAA0B,EAAE,MAAM,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;CACvB,SA8IA,CAAC"}

package/dist/js/effects/three-particles/three-particles-modifiers.js

@@ -0,0 +1,93 @@
+import * as THREE from 'three';
+import { calculateValue } from './three-particles-utils.js';
+const noiseInput = new THREE.Vector3(0, 0, 0);
+const orbitalEuler = new THREE.Euler();
+export const applyModifiers = ({ delta, generalData, normalizedConfig, attributes, particleLifetimePercentage, particleIndex, }) => {
+    const { particleSystemId, startValues, lifetimeValues, linearVelocityData, orbitalVelocityData, noise, } = generalData;
+    const positionIndex = particleIndex * 3;
+    const positionArr = attributes.position.array;
+    if (linearVelocityData) {
+        const { speed, valueModifiers } = linearVelocityData[particleIndex];
+        const normalizedXSpeed = valueModifiers.x
+            ? valueModifiers.x(particleLifetimePercentage)
+            : speed.x;
+        const normalizedYSpeed = valueModifiers.y
+            ? valueModifiers.y(particleLifetimePercentage)
+            : speed.y;
+        const normalizedZSpeed = valueModifiers.z
+            ? valueModifiers.z(particleLifetimePercentage)
+            : speed.z;
+        positionArr[positionIndex] += normalizedXSpeed * delta;
+        positionArr[positionIndex + 1] += normalizedYSpeed * delta;
+        positionArr[positionIndex + 2] += normalizedZSpeed * delta;
+        attributes.position.needsUpdate = true;
+    }
+    if (orbitalVelocityData) {
+        const { speed, positionOffset, valueModifiers } = orbitalVelocityData[particleIndex];
+        positionArr[positionIndex] -= positionOffset.x;
+        positionArr[positionIndex + 1] -= positionOffset.y;
+        positionArr[positionIndex + 2] -= positionOffset.z;
+        const normalizedXSpeed = valueModifiers.x
+            ? valueModifiers.x(particleLifetimePercentage)
+            : speed.x;
+        const normalizedYSpeed = valueModifiers.y
+            ? valueModifiers.y(particleLifetimePercentage)
+            : speed.y;
+        const normalizedZSpeed = valueModifiers.z
+            ? valueModifiers.z(particleLifetimePercentage)
+            : speed.z;
+        orbitalEuler.set(normalizedXSpeed * delta, normalizedZSpeed * delta, normalizedYSpeed * delta);
+        positionOffset.applyEuler(orbitalEuler);
+        positionArr[positionIndex] += positionOffset.x;
+        positionArr[positionIndex + 1] += positionOffset.y;
+        positionArr[positionIndex + 2] += positionOffset.z;
+        attributes.position.needsUpdate = true;
+    }
+    if (normalizedConfig.sizeOverLifetime.isActive) {
+        const multiplier = calculateValue(particleSystemId, normalizedConfig.sizeOverLifetime.lifetimeCurve, particleLifetimePercentage);
+        attributes.size.array[particleIndex] =
+            startValues.startSize[particleIndex] * multiplier;
+        attributes.size.needsUpdate = true;
+    }
+    if (normalizedConfig.opacityOverLifetime.isActive) {
+        const multiplier = calculateValue(particleSystemId, normalizedConfig.opacityOverLifetime.lifetimeCurve, particleLifetimePercentage);
+        attributes.colorA.array[particleIndex] =
+            startValues.startOpacity[particleIndex] * multiplier;
+        attributes.colorA.needsUpdate = true;
+    }
+    if (lifetimeValues.rotationOverLifetime) {
+        attributes.rotation.array[particleIndex] +=
+            lifetimeValues.rotationOverLifetime[particleIndex] * delta * 0.02;
+        attributes.rotation.needsUpdate = true;
+    }
+    if (noise.isActive) {
+        const { sampler, strength, offsets, positionAmount, rotationAmount, sizeAmount, } = noise;
+        let noiseOnPosition;
+        const noisePosition = (particleLifetimePercentage + (offsets ? offsets[particleIndex] : 0)) *
+            10 *
+            strength;
+        const noisePower = 0.15 * strength;
+        noiseInput.set(noisePosition, 0, 0);
+        noiseOnPosition = sampler.get3(noiseInput);
+        positionArr[positionIndex] += noiseOnPosition * noisePower * positionAmount;
+        if (rotationAmount !== 0) {
+            attributes.rotation.array[particleIndex] +=
+                noiseOnPosition * noisePower * rotationAmount;
+            attributes.rotation.needsUpdate = true;
+        }
+        if (sizeAmount !== 0) {
+            attributes.size.array[particleIndex] +=
+                noiseOnPosition * noisePower * sizeAmount;
+            attributes.size.needsUpdate = true;
+        }
+        noiseInput.set(noisePosition, noisePosition, 0);
+        noiseOnPosition = sampler.get3(noiseInput);
+        positionArr[positionIndex + 1] +=
+            noiseOnPosition * noisePower * positionAmount;
+        noiseInput.set(noisePosition, noisePosition, noisePosition);
+        noiseOnPosition = sampler.get3(noiseInput);
+        positionArr[positionIndex + 2] +=
+            noiseOnPosition * noisePower * positionAmount;
+        attributes.position.needsUpdate = true;
+    }
+};