qarl 1.1.1 → 1.2.0

package/README.md

@@ -1,68 +1,272 @@
-# QARL (Quantum Animation Remixable Library) 😎
-
-*Description generated by GPT while we were busy doing more important things.*
-
-QARL is an animation library for my game engine.
-
-⚠️ **Attention!** ⚠️
-
-New project! 💡 It surely has some bugs, unfinished features, and odd solutions, but I've put a lot of heart and effort into it. Thanks for stopping by—I hope you'll enjoy it! 🙏✨
-
-## Why QARL? 🏎️💨
-
-Looking for performance? QARL's FromTo animation computes so fast, it feels like it bends space-time! 💫 No more waiting for slow calculations—just smooth, seamless transitions that keep up with the pace of your game.
-
-## Installation
-
-Install the library via npm:
-
-```bash
-npm install qarl
-```
-
-## FromTo example
-
-```js
-const cube3 = new THREE.Mesh(
-  new THREE.BoxGeometry(),
-  new THREE.MeshBasicMaterial({ color: 0x00ffff })
-)
-
-new QARL.FromTo({
-    target: cube3,
-    dynamic: true,
-    loop: true,
-    time: 3000,
-    mode: QARL.modes.pingPong, // bounce, yoyo, pingPong
-    easing: QARL.easings.outQuad,
-    from: { rotation: { x: 1, y: 2 }, position: { x: 2, z: 2 }, scale: { x: .01, y: 1, z: 1 } },
-    to: { rotation: { x: 3, y: -5 }, position: { x: -2, z: -2 }, scale: { x: 3, y: .5, z: .5 } },
-})
-```
-
-## Curve example
-
-```js
-const cube3 = new THREE.Mesh(
-  new THREE.BoxGeometry(),
-  new THREE.MeshBasicMaterial({ color: 0xff00ff })
-)
-
-new QARL.Curve({
-    target: cube3,
-    loop: true,
-    time: 10000,
-    mode: QARL.modes.yoyo,
-    easing: QARL.easings.inOutBack,
-    smoothing: 10,
-    properties: ['position.x', 'position.y', 'position.z', 'scale.x', 'scale.y', 'scale.z'],
-    points: [
-        [-2, -2, 0, .1, .5, .5],
-        [ 2, -2, 0, .5, .2, .2],
-        [ 2,  0, 1, .1, .5, .5],
-        [-2,  0, 1, .5, .2, .2],
-        [-2,  2, 0, .1, .5, .5],
-        [ 2,  2, 0, .5, .2, .2],
-    ],
-})
-```
+# QARL (Quantum Animation Remixable Library) 😎
+
+*Description generated by GPT while we were busy doing more important things.*
+
+QARL is an animation library for game engine.
+
+⚠️ **Attention!** ⚠️
+
+New project! 💡 It surely has some bugs, unfinished features, and odd solutions, but a lot of heart and effort went into it. Thanks for stopping by—hope it will be enjoyed! 🙏✨
+
+## Why QARL? 🏎️💨
+
+Looking for performance? QARL's FromTo animation computes so fast, it feels like it bends space-time! 💫 No more waiting for slow calculations—just smooth, seamless transitions that keep up with the pace of your game.
+
+## Installation
+
+Install the library via npm:
+
+```bash
+npm install qarl
+```
+
+## FromTo example
+
+```js
+const cube3 = new THREE.Mesh(
+  new THREE.BoxGeometry(),
+  new THREE.MeshBasicMaterial({ color: 0x00ffff })
+)
+
+const fromToAnim = new QARL.FromTo({
+    target: cube3,
+    dynamic: true, // default false - to bake from and to
+    loop: true,
+    time: 3000,
+    mode: QARL.modes.pingPong, // bounce, yoyo, pingPong
+    easing: QARL.easings.outQuad,
+    from: { rotation: { x: 1, y: 2 }, position: { x: 2, z: 2 }, scale: { x: .01, y: 1, z: 1 } },
+    to: { rotation: { x: 3, y: -5 }, position: { x: -2, z: -2 }, scale: { x: 3, y: .5, z: .5 } },
+})
+
+// fromToAnim.play()
+
+// fromToAnim.step(dt)
+```
+
+## Curve example
+
+```js
+const cube3 = new THREE.Mesh(
+  new THREE.BoxGeometry(),
+  new THREE.MeshBasicMaterial({ color: 0xff00ff })
+)
+
+//  default mode
+
+const curveAnim = new QARL.Curve({
+    target: cube3,
+    loop: true,
+    time: 10000,
+    mode: QARL.modes.yoyo,
+    easing: QARL.easings.inOutBack,
+    smoothing: 10,
+
+    // position.x
+    points: [
+        [-2],
+        [ 2],
+        [ 2],
+        [-2],
+        [-2],
+        [ 2],
+    ],
+
+    // or position.x and position.y
+    // points: [
+    //     [-2, -2],
+    //     [ 2, -2],
+    //     [ 2,  0],
+    //     [-2,  0],
+    //     [-2,  2],
+    //     [ 2,  2],
+    // ],
+
+    // or position.x, position.y and position.z
+    // points: [
+    //     [-2, -2,  0,],
+    //     [ 2, -2,  0,],
+    //     [ 2,  0,  1,],
+    //     [-2,  0,  1,],
+    //     [-2,  2,  0,],
+    //     [ 2,  2,  0,],
+    // ],
+})
+
+// or custome mode
+
+const curveAnim = new QARL.Curve({
+    target: cube3,
+    loop: true,
+    time: 10000,
+    mode: QARL.modes.yoyo,
+    easing: QARL.easings.inOutBack,
+    smoothing: 10,
+    properties: ['position.z', 'scale.y', 'scale.z', 'position.x'], // custom properties order
+    points: [
+        [0, .5, .5, -2,],
+        [0, .2, .2,  2,],
+        [1, .5, .5,  2,],
+        [1, .2, .2, -2,],
+        [0, .5, .5, -2,],
+        [0, .2, .2,  2,],
+    ],
+})
+
+// curveAnim.play()
+
+// curveAnim.step(dt)
+```
+
+
+## Manager example
+
+```js
+const qarlManager = new QARL.Manager()
+
+const cube3 = new THREE.Mesh(
+  new THREE.BoxGeometry(),
+  new THREE.MeshBasicMaterial({ color: 0xff00ff })
+)
+
+const qarl1 = qarlManager.create({
+    target: cube3,
+    loop: true,
+    time: 10000,
+    mode: QARL.modes.yoyo,
+    easing: QARL.easings.inOutBack,
+    smoothing: 10,
+    // properties: ['position.x', 'position.y', 'position.z'], // default properties
+    points: [
+        [-2, -2, 0],
+        [ 2, -2, 0],
+        [ 2,  0, 1],
+        [-2,  0, 1],
+        [-2,  2, 0],
+        [ 2,  2, 0],
+    ],
+})
+
+// or
+
+const cube3clone = cube3.clone()
+
+const qarl2 = qarlManager.create({
+    target: cube3clone,
+    loop: true,
+    time: 3000,
+    mode: QARL.modes.pingPong, // bounce, yoyo, pingPong
+    easing: QARL.easings.outQuad,
+    from: { rotation: { x: 1, y: 2 }, position: { x: 2, z: 2 }, scale: { x: .01, y: 1, z: 1 } },
+    to: { rotation: { x: 3, y: -5 }, position: { x: -2, z: -2 }, scale: { x: 3, y: .5, z: .5 } },
+})
+
+// qarlManager.update(dt)
+```
+
+## Play Animation Instantly example
+
+
+```js
+const cube3 = new THREE.Mesh(
+  new THREE.BoxGeometry(),
+  new THREE.MeshBasicMaterial({ color: 0xff00ff })
+)
+
+QARL.play({
+    target: cube3,
+    loop: true,
+    time: 10000,
+    mode: QARL.modes.yoyo,
+    easing: QARL.easings.inOutBack,
+    smoothing: 10,
+    // properties: ['position.x', 'position.y', 'position.z'], // default properties
+    points: [
+        [-2, -2, 0],
+        [ 2, -2, 0],
+        [ 2,  0, 1],
+        [-2,  0, 1],
+        [-2,  2, 0],
+        [ 2,  2, 0],
+    ],
+})
+
+// or
+
+const cube3clone = cube3.clone()
+
+QARL.play({
+    target: cube3clone,
+    loop: true,
+    time: 3000,
+    mode: QARL.modes.bounce,
+    easing: QARL.easings.inOutSine,
+    from: { rotation: { x: 1, y: 2 }, position: { x: 2, z: 2 }, scale: { x: .01, y: 1, z: 1 } },
+    to: { rotation: { x: 3, y: -5 }, position: { x: -2, z: -2 }, scale: { x: 3, y: .5, z: .5 } },
+})
+
+// async
+
+await QARL.play({ /*... config ...*/ }, true) // true for async
+
+```
+
+## GlobalManager and Loop example
+
+```js
+import { GlobalManager, Loop } from 'qarl';
+
+// Создаем объекты для анимации
+const cube = new THREE.Mesh(
+  new THREE.BoxGeometry(),
+  new THREE.MeshBasicMaterial({ color: 0xff6b6b })
+);
+
+const sphere = new THREE.Mesh(
+  new THREE.SphereGeometry(0.7),
+  new THREE.MeshBasicMaterial({ color: 0x4ecdc4 })
+);
+
+// Анимация куба с поворотом
+const cubeAnimation = GlobalManager.create({
+    target: cube,
+    time: 2000,
+    from: { rotation: { x: 0, y: 0, z: 0 } },
+    to: { rotation: { x: Math.PI * 2, y: Math.PI * 2, z: Math.PI * 2 } },
+    easing: 'outElastic',
+    loop: true,
+    mode: 'pingPong'
+});
+
+// Анимация сферы с движением и масштабированием
+const sphereAnimation = GlobalManager.create({
+    target: sphere,
+    time: 3000,
+    properties: ['position.x', 'position.y', 'position.z', 'scale.x', 'scale.y', 'scale.z'],
+    points: [
+        [0, 0, 0, 1, 1, 1],
+        [1, 2, 0, 2, .5, 2],
+        [-1, 2, 0, 1, 2, 1],
+        [0, 0, 0, 1, 1, 1]
+    ],
+    smoothing: 20,
+    easing: 'outBack',
+    loop: true,
+});
+
+// Запускаем анимации
+cubeAnimation.play();
+sphereAnimation.play();
+
+// Создаем игровой цикл
+const gameLoop = Loop.start((dt) => {
+    // Обновляем все анимации через GlobalManager
+    GlobalManager.update(dt);
+
+    // Ваша игровая логика здесь
+    // renderer.render(scene, camera);
+});
+
+// Остановка цикла (если нужно)
+// Loop.stop(gameLoop);
+```

package/dist/qarl.es.min.js

@@ -0,0 +1 @@
+var t={228:t=>{var e=Object.prototype.hasOwnProperty,s="~";function i(){}function n(t,e,s){this.fn=t,this.context=e,this.once=s||!1}function r(t,e,i,r,o){if("function"!=typeof i)throw new TypeError("The listener must be a function");var a=new n(i,r||t,o),h=s?s+e:e;return t._events[h]?t._events[h].fn?t._events[h]=[t._events[h],a]:t._events[h].push(a):(t._events[h]=a,t._eventsCount++),t}function o(t,e){0===--t._eventsCount?t._events=new i:delete t._events[e]}function a(){this._events=new i,this._eventsCount=0}Object.create&&(i.prototype=Object.create(null),(new i).__proto__||(s=!1)),a.prototype.eventNames=function(){var t,i,n=[];if(0===this._eventsCount)return n;for(i in t=this._events)e.call(t,i)&&n.push(s?i.slice(1):i);return Object.getOwnPropertySymbols?n.concat(Object.getOwnPropertySymbols(t)):n},a.prototype.listeners=function(t){var e=s?s+t:t,i=this._events[e];if(!i)return[];if(i.fn)return[i.fn];for(var n=0,r=i.length,o=new Array(r);n<r;n++)o[n]=i[n].fn;return o},a.prototype.listenerCount=function(t){var e=s?s+t:t,i=this._events[e];return i?i.fn?1:i.length:0},a.prototype.emit=function(t,e,i,n,r,o){var a=s?s+t:t;if(!this._events[a])return!1;var h,p,c=this._events[a],l=arguments.length;if(c.fn){switch(c.once&&this.removeListener(t,c.fn,void 0,!0),l){case 1:return c.fn.call(c.context),!0;case 2:return c.fn.call(c.context,e),!0;case 3:return c.fn.call(c.context,e,i),!0;case 4:return c.fn.call(c.context,e,i,n),!0;case 5:return c.fn.call(c.context,e,i,n,r),!0;case 6:return c.fn.call(c.context,e,i,n,r,o),!0}for(p=1,h=new Array(l-1);p<l;p++)h[p-1]=arguments[p];c.fn.apply(c.context,h)}else{var u,m=c.length;for(p=0;p<m;p++)switch(c[p].once&&this.removeListener(t,c[p].fn,void 0,!0),l){case 1:c[p].fn.call(c[p].context);break;case 2:c[p].fn.call(c[p].context,e);break;case 3:c[p].fn.call(c[p].context,e,i);break;case 4:c[p].fn.call(c[p].context,e,i,n);break;default:if(!h)for(u=1,h=new Array(l-1);u<l;u++)h[u-1]=arguments[u];c[p].fn.apply(c[p].context,h)}}return!0},a.prototype.on=function(t,e,s){return r(this,t,e,s,!1)},a.prototype.once=function(t,e,s){return r(this,t,e,s,!0)},a.prototype.removeListener=function(t,e,i,n){var r=s?s+t:t;if(!this._events[r])return this;if(!e)return o(this,r),this;var a=this._events[r];if(a.fn)a.fn!==e||n&&!a.once||i&&a.context!==i||o(this,r);else{for(var h=0,p=[],c=a.length;h<c;h++)(a[h].fn!==e||n&&!a[h].once||i&&a[h].context!==i)&&p.push(a[h]);p.length?this._events[r]=1===p.length?p[0]:p:o(this,r)}return this},a.prototype.removeAllListeners=function(t){var e;return t?(e=s?s+t:t,this._events[e]&&o(this,e)):(this._events=new i,this._eventsCount=0),this},a.prototype.off=a.prototype.removeListener,a.prototype.addListener=a.prototype.on,a.prefixed=s,a.EventEmitter=a,t.exports=a}},e={};function s(i){var n=e[i];if(void 0!==n)return n.exports;var r=e[i]={exports:{}};return t[i](r,r.exports,s),r.exports}s.d=(t,e)=>{for(var i in e)s.o(e,i)&&!s.o(t,i)&&Object.defineProperty(t,i,{enumerable:!0,get:e[i]})},s.o=(t,e)=>Object.prototype.hasOwnProperty.call(t,e);const i=s(228),n={processors:[],time:0,loop:!1,mode:null,delay:0,repeat:0,target:null,easing:t=>t,reversed:!1,repeatDelay:0},r={PLAY:"play",STOP:"stop",BEGIN:"begin",UPDATE:"update",REPEAT:"repeat",COMPLETE:"complete"},o=2*Math.PI,a=Math.pow,h={reverse:t=>1-t,linear:t=>t,yoyo:t=>1-Math.abs(1-2*t),inQuad:t=>a(t,2),outQuad:t=>t*(2-t),inOutQuad:t=>t<.5?2*t*t:(4-2*t)*t-1,inCubic:t=>a(t,3),outCubic:t=>--t*t*t+1,inOutCubic:t=>t<.5?4*a(t,3):(t-1)*(2*t-2)*(2*t-2)+1,inQuart:t=>a(t,4),outQuart:t=>1- --t*a(t,3),inOutQuart:t=>t<.5?8*a(t,4):1-8*--t*t*t*t,inQuint:t=>a(t,5),outQuint:t=>1+--t*a(t,4),inOutQuint:t=>t<.5?16*a(t,5):1+16*--t*t*t*t*t,inSine:t=>1-Math.cos(t*Math.PI/2),outSine:t=>Math.sin(t*Math.PI/2),inOutSine:t=>-(Math.cos(Math.PI*t)-1)/2,inBack:(t,e=1.70158)=>t*t*((e+1)*t-e),outBack:(t,e=1.70158)=>(t-=1)*t*((e+1)*t+e)+1,inOutBack:(t,e=1.70158)=>(t*=2)<1?t*t*((1.525*e+1)*t-1.525*e)*.5:.5*((t-=2)*t*((1.525*e+1)*t+1.525*e)+2),inExpo:t=>0===t?0:Math.pow(2,10*(t-1)),outExpo:t=>1===t?1:1-Math.pow(2,-10*t),inOutExpo:t=>0===t?0:1===t?1:t<.5?.5*Math.pow(2,20*t-10):1-.5*Math.pow(2,-20*t+10),inElastic:(t,e=1,s=.5)=>0===t?0:1===t?1:-e*Math.pow(2,10*(t-1))*Math.sin((t-1-s/o*Math.asin(1/e))*o/s),outElastic:(t,e=1,s=.5)=>0===t?0:1===t?1:e*Math.pow(2,-10*t)*Math.sin((t-s/o*Math.asin(1/e))*o/s)+1,inOutElastic:(t,e=1,s=.5)=>0===t?0:1===t?1:t<.5?-.5*e*Math.pow(2,20*t-10)*Math.sin((20*t-11.125)*o/s):.5*e*Math.pow(2,-20*t+10)*Math.sin((20*t-11.125)*o/s)+1},p={pingPong:function(t){return t<=.5?this._easing(2*t):1-this._easing(2*(t-.5))},yoyo:function(t){return this._easing(h.yoyo(t))},bounce:function(t){return h.yoyo(this._easing(t))}};let c=0;class l extends i{on(...t){return super.on(...t),this}off(...t){return super.off(...t),this}once(...t){return super.once(...t),this}onComplete(...t){return super.on(r.COMPLETE,...t),this}onUpdate(...t){return super.on(r.UPDATE,...t),this}static DEFAULTS=n;static _noop(){}static mergeConfigs(t,e){t!==e&&Object.keys(e).forEach(s=>{"object"==typeof e[s]&&null!==e[s]?(t[s]&&"object"==typeof t[s]||(t[s]={}),l.mergeConfigs(t[s],e[s])):t[s]=e[s]})}static lerp(t,e,s){return t+(e-t)*s}constructor(t={},e){super(),this.index=c++,this.overrides=t,this.settings={},this.reset(t),e&&(this.manager=e),this.lastDeltaTime=0}_processState(){this.step=l._noop,this.progress=0,this.easeValue=0,this.elapsedTime=0,this.promise=null,this._resolve=l._noop,this._refreshDynamicProps()}_refreshDynamicProps(){this.applyProcessors(this.settings);const{target:t,time:e,repeat:s,loop:i,reversed:n,delay:r}=this.settings;this.target=t,this.time=Math.max(e,0),this.repeat=s>0?s:i?1/0:0,this.reversed=n,this.remainingDelay=r,this._processEasing()}_processEasing(){const t="string"==typeof this.settings.easing?h[this.settings.easing]||h.linear:this.settings.easing;this._easing=this.reversed?this._reversedEasing:t;const e="string"==typeof this.settings.mode?p[this.settings.mode]:this.settings.mode;this._calculateEasing=e?e.bind(this):this._easing}_reversedEasing=t=>this.settings.easing(1-t);_update(){this.progress=this.elapsedTime/this.time,this.easeValue=this._calculateEasing(this.progress),this.emit(r.UPDATE,this)}_stepDelay=t=>{this.remainingDelay-=t,this.lastDeltaTime=t,this.remainingDelay>0||(this.step=this._stepTime,this.step(Math.abs(this.remainingDelay)),this.remainingDelay=this.settings.delay)};_stepTime=(t=0)=>{this.elapsedTime+=t,this.lastDeltaTime=t,this.elapsedTime>=this.time?(this.elapsedTime=this.time,this._update(),this._complete()):this._update()};_complete(){this.repeat-- >0?this._repeat():(this._resolve(),this.stop(!1),this.emit(r.COMPLETE))}_repeat(t=!0){this.remainingDelay=this.settings.repeatDelay,this.elapsedTime=0,this.remainingDelay>0&&(this.step=this._stepDelay),this._update(),t&&this.emit(r.REPEAT)}reset(t=this.constructor.DEFAULTS){return this.settings={...this.constructor.DEFAULTS,...t},this._processState(),this}applyProcessors(t=this.settings){t.processors.forEach(e=>{l.mergeConfigs(t,e.call(this,t)||{})})}tweak(t={}){return l.mergeConfigs(this.settings,t),this._refreshDynamicProps(),this}seek(t=0,e=!0){return this.elapsedTime=Math.min(Math.max(t,0),this.time),e&&this._update(),this}setProgress(t=0,e=!0){return this.seek(this.time*t,e)}reverse(t=!1){return this.reversed=!this.reversed,this.seek(this.time-this.elapsedTime,t),this._processEasing(),this}play(t=!0){return this.isPlaying||(t&&this.emit(r.PLAY),this.remainingDelay>0?this.step=this._stepDelay:(this.step=this._stepTime,this.emit(r.BEGIN)),this.manager&&this.manager.addToActive(this)),this}playPromise(t=this.promise){return this.play(),this.promise=t||new Promise(t=>{this._resolve=t}),this.promise}stop(t=!0){return this._processState(),t&&this.emit(r.STOP),this.manager&&this.manager.removeFromActive(this),this}pause(){return this.step=l._noop,this.manager&&this.manager.removeFromActive(this),this}replay(t=!1){return this.stop(t),this.play(t),this}get isPlaying(){return this.step!==l._noop}remove(){this.stop(),this.manager.remove(this)}}class u extends l{static DEFAULTS={...l.DEFAULTS,properties:null,points:[],smoothing:20};_preparePropertySetters(){this.propertySetters=this.properties.map(t=>{const e=t.split("."),s=e.pop();return t=>{let i=this.target;for(let t=0;t<e.length;t++)i=i[e[t]];i[s]=t}})}_generatePath(){const t=this.settings.points,e=Math.max(this.settings.smoothing,1),s=[];function i(t,e,s,i,n){const r=n*n,o=r*n;return t.map((a,h)=>.5*(2*e[h]+(-t[h]+s[h])*n+(2*t[h]-5*e[h]+4*s[h]-i[h])*r+(-t[h]+3*e[h]-3*s[h]+i[h])*o))}this.totalLength=0;for(let n=0;n<t.length-1;n++){const r=t[0===n?n:n-1],o=t[n],a=t[n+1],h=t[n+2<t.length?n+2:n+1];for(let t=0;t<e;t++){const n=i(r,o,a,h,t/e);s.push(n),s.length>1&&(this.totalLength+=this._calculateDistance(s[s.length-2],n))}}return s.push(t[t.length-1]),s}_calculateDistance(t,e){return Math.sqrt(t.reduce((s,i,n)=>s+Math.pow(e[n]-t[n],2),0))}_refreshDynamicProps(){super._refreshDynamicProps(),this.path=this._generatePath(),this.target&&0!==this.path.length?(this._tryToSetupProperties(),this._preparePropertySetters()):this._setTargetProperties=l._noop}_tryToSetupProperties(){if(this.settings.properties)this.properties=this.settings.properties;else if(this.path[0].length<=3){const t=[["position.x"],["position.x","position.y"],["position.x","position.y","position.z"]];this.properties=t[this.path[0].length-1]}else this.properties=[]}_setTargetProperties(t){for(let e=0;e<this.propertySetters.length;e++)this.propertySetters[e](t[e])}_clamp(t,e,s){return Math.max(e,Math.min(t,s))}_getInterpolatedPosition(){const t=this.path.length-1,e=this.easeValue*t,s=this._clamp(e,0,t),i=s>=t?t-1:Math.floor(s),n=Math.min(i+1,t),r=e-i,o=this.path[i],a=this.path[n];return o.map((t,e)=>l.lerp(t,a[e],r))}_update(){super._update(),this._setTargetProperties(this._getInterpolatedPosition())}}class m extends l{static DEFAULTS={...l.DEFAULTS,dynamic:!1,from:null,to:null};_refreshDynamicProps(){super._refreshDynamicProps(),this._processFromTo()}_processFromTo(){this._lerps=[],this.target&&(this._setupStates(),this._createLerps())}_setupStates(){this._from=this.settings.from||this._createState(this.settings.to||{},this.target),this._to=this.settings.to||this._createState(this.settings.from||{},this.target)}_createState(t={},e={},s={}){const i=(t,e,s)=>{for(const n in t)"object"==typeof t[n]?(s[n]={},i(t[n],e[n],s[n])):s[n]=e[n]};return i(t,e,s),s}_createLerpStep(t,e,s,i){if(this.settings.dynamic)return()=>{t[i]=l.lerp(e[i],s[i],this.easeValue)};{const n=e[i],r=s[i]-n;return()=>{t[i]=n+r*this.easeValue}}}_createLerps(t=this.target,e=this._from,s=this._to){for(const i in s)"object"==typeof s[i]?this._createLerps(t[i],e[i],s[i]):this._lerps.push(this._createLerpStep(t,e,s,i))}_update(){super._update();for(const t of this._lerps)t()}from(t={}){return this.tweak({from:t}),this}to(t={}){return this.tweak({to:t}),this}swap(){return this.tweak({from:this.settings.to,to:this.settings.from}),this}}function g(t){return t.target?t.creator?t.creator instanceof l?t.creator:(console.error("Invalid creator provided. Using default creator."),l):t.points?u:t.from||t.to?m:l:l}class f{constructor(){this.activeAnimations=new Map,this.allAnimations=new Map}create({on:t={},once:e={},...s}){const i=new(g(s))(s,this);return Object.keys(t).forEach(e=>{i.on(e,t[e])}),Object.keys(e).forEach(t=>{i.once(t,e[t])}),this.add(i),i}update=t=>{this.activeAnimations.forEach(e=>{e.step(t)})};getActiveAnimations(){return Array.from(this.activeAnimations.values())}getAllAnimations(){return Array.from(this.allAnimations.values())}remove({index:t}={}){t&&(this.activeAnimations.delete(t),this.allAnimations.delete(t))}add(t){this.allAnimations.set(t.index,t)}addToActive(t){this.activeAnimations.set(t.index,t)}removeFromActive(t){this.activeAnimations.delete(t.index)}stopAll(){this.activeAnimations.forEach(t=>{t.stop()})}removeAll(){this.stopAll(),this.activeAnimations.clear(),this.allAnimations.clear()}}const _=new f;class y{constructor(t,e={}){this.callback=t,this.options={maxDeltaTime:100,...e},this.isRunning=!1,this.lastTime=0,this.animationId=null}static start(t,e={}){const s=new y(t,e);return s.start(),s}start(){if(this.isRunning)return;this.isRunning=!0;const t=e=>{if(!this.isRunning)return;const s=Math.min(e-this.lastTime,this.options.maxDeltaTime);this.lastTime=e,this.callback(s),this.isRunning&&(this.animationId=requestAnimationFrame(t))};requestAnimationFrame(e=>{this.lastTime=e,t(e)})}stop(){this.isRunning=!1,this.animationId&&(cancelAnimationFrame(this.animationId),this.animationId=null)}get running(){return this.isRunning}}function v(t,e){const s=new new g(t)(t);return y.start(s.step.bind(s)),e?s.playPromise():s.play()}export{l as Core,u as Curve,n as DEFAULTS,r as EVENTS,m as FromTo,_ as GlobalManager,y as Loop,f as Manager,h as easings,p as modes,v as play};

package/kill-port.js

@@ -0,0 +1,16 @@
+const { exec } = require('child_process');
+
+exec('netstat -ano | findstr :8081', (error, stdout) => {
+  if (stdout) {
+    const lines = stdout.trim().split('\n');
+    lines.forEach(line => {
+      const parts = line.trim().split(/\s+/);
+      const pid = parts[parts.length - 1];
+      if (pid && pid !== '0') {
+        exec(`taskkill /PID ${pid} /F`, (err) => {
+          if (!err) console.log(`Killed process ${pid} on port 8081`);
+        });
+      }
+    });
+  }
+});

package/package.json

@@ -1,19 +1,36 @@
-{
-  "name": "qarl",
-  "version": "1.1.1",
-  "description": "simple animation library",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ThreePixDroid/qarl.git"
-  },
-  "author": "threepixdroid",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/ThreePixDroid/qarl/issues"
-  },
-  "homepage": "https://github.com/ThreePixDroid/qarl#readme"
-}
+{
+  "name": "qarl",
+  "version": "1.2.0",
+  "description": "simple animation library",
+  "main": "dist/qarl.es.min.js",
+  "module": "dist/qarl.es.min.js",
+  "exports": {
+    ".": "./dist/qarl.es.min.js"
+  },
+  "scripts": {
+    "build": "webpack --mode=production",
+    "dev": "node kill-port.js && webpack serve --mode=development"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ThreePixDroid/qarl.git"
+  },
+  "author": "threepixdroid",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/ThreePixDroid/qarl/issues"
+  },
+  "homepage": "https://github.com/ThreePixDroid/qarl#readme",
+  "dependencies": {
+    "eventemitter3": "^5.0.1"
+  },
+  "devDependencies": {
+    "html-loader": "^5.1.0",
+    "html-webpack-plugin": "^5.6.4",
+    "terser-webpack-plugin": "^5.3.14",
+    "three": "^0.180.0",
+    "webpack": "^5.102.1",
+    "webpack-cli": "^6.0.1",
+    "webpack-dev-server": "^5.2.2"
+  }
+}

package/src/behaviors/easings.js

@@ -1,72 +1,78 @@
 
-    // created by chatGPT
-    const PI2 = Math.PI * 2
+// created by chatGPT
+const PI2 = Math.PI * 2
+const pow = Math.pow
 
-    export const easings = {
-        reverse: (t) => 1 - t,
-        linear: (t) => t,
-        yoyo: (t) => 1 - Math.abs(1 - t * 2),
+// оптимизировать вычисления - для ускорения
+// сократить код - для компактности
+// разделить на отдельные методы вместо одного большого объекта - для независимости
+// поправить нейминг или перенестив другую область reverse, linear, yoyo - в идеале облегчить доступ через QARL."easeName"
+// или вообще использовать строки вместо функций - "easeName" - для простоты
+export const easings = {
+  reverse: (t) => 1 - t,
+  linear: (t) => t,
+  yoyo: (t) => 1 - Math.abs(1 - t * 2),
 
-        inQuad: (t) => t * t,
-        outQuad: (t) => t * (2 - t),
-        inOutQuad: (t) => t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t,
+  inQuad: (t) => pow(t, 2),
+  outQuad: (t) => t * (2 - t),
+  inOutQuad: (t) => t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t,
 
-        inCubic: (t) => t * t * t,
-        outCubic: (t) => (--t) * t * t + 1,
-        inOutCubic: (t) => t < 0.5 ? 4 * t * t * t : (t - 1) * (2 * t - 2) * (2 * t - 2) + 1,
+  inCubic: (t) => pow(t, 3),
+  outCubic: (t) => (--t) * t * t + 1,
+  inOutCubic: (t) => t < 0.5 ? 4 * pow(t, 3) : (t - 1) * (2 * t - 2) * (2 * t - 2) + 1,
 
-        inQuart: (t) => t * t * t * t,
-        outQuart: (t) => 1 - (--t) * t * t * t,
-        inOutQuart: (t) => t < 0.5 ? 8 * t * t * t * t : 1 - 8 * (--t) * t * t * t,
+  inQuart: (t) => pow(t, 4),
+  outQuart: (t) => 1 - (--t) * pow(t, 3),
+  inOutQuart: (t) => t < 0.5 ? 8 * pow(t, 4) : 1 - 8 * (--t) * t * t * t,
 
-        inQuint: (t) => t * t * t * t * t,
-        outQuint: (t) => 1 + (--t) * t * t * t * t,
-        inOutQuint: (t) => t < 0.5 ? 16 * t * t * t * t * t : 1 + 16 * (--t) * t * t * t * t,
+  inQuint: (t) => pow(t, 5),
+  outQuint: (t) => 1 + (--t) * pow(t, 4),
+  inOutQuint: (t) => t < 0.5 ? 16 * pow(t, 5) : 1 + 16 * (--t) * t * t * t * t,
 
-        inSine: (t) => 1 - Math.cos((t * Math.PI) / 2),
-        outSine: (t) => Math.sin((t * Math.PI) / 2),
-        inOutSine: (t) => -(Math.cos(Math.PI * t) - 1) / 2,
+  inSine: (t) => 1 - Math.cos((t * Math.PI) / 2),
+  outSine: (t) => Math.sin((t * Math.PI) / 2),
+  inOutSine: (t) => -(Math.cos(Math.PI * t) - 1) / 2,
 
-        inBack: (t, s = 1.70158) => t * t * ((s + 1) * t - s),
-        outBack: (t, s = 1.70158) => ((t -= 1) * t * ((s + 1) * t + s) + 1),
-        inOutBack: (t, s = 1.70158) =>
-            (t *= 2) < 1
-                ? 0.5 * (t * t * ((s * 1.525 + 1) * t - s * 1.525))
-                : 0.5 * ((t -= 2) * t * ((s * 1.525 + 1) * t + s * 1.525) + 2),
+  inBack: (t, s = 1.70158) => t * t * ((s + 1) * t - s),
+  outBack: (t, s = 1.70158) => ((t -= 1) * t * ((s + 1) * t + s) + 1),
+  inOutBack: (t, s = 1.70158) =>
+    (t *= 2) < 1
+      ? 0.5 * (t * t * ((s * 1.525 + 1) * t - s * 1.525))
+      : 0.5 * ((t -= 2) * t * ((s * 1.525 + 1) * t + s * 1.525) + 2),
 
-        inExpo: (t) => (t === 0 ? 0 : Math.pow(2, 10 * (t - 1))),
-        outExpo: (t) => (t === 1 ? 1 : 1 - Math.pow(2, -10 * t)),
-        inOutExpo: (t) => (
-            t === 0
-                ? 0
-                : t === 1
-                    ? 1
-                    : t < 0.5
-                        ? 0.5 * Math.pow(2, 20 * t - 10)
-                        : 1 - 0.5 * Math.pow(2, -20 * t + 10)
-        ),
+  inExpo: (t) => (t === 0 ? 0 : Math.pow(2, 10 * (t - 1))),
+  outExpo: (t) => (t === 1 ? 1 : 1 - Math.pow(2, -10 * t)),
+  inOutExpo: (t) => (
+    t === 0
+      ? 0
+      : t === 1
+        ? 1
+        : t < 0.5
+          ? 0.5 * Math.pow(2, 20 * t - 10)
+          : 1 - 0.5 * Math.pow(2, -20 * t + 10)
+  ),
 
-        inElastic: (t, a = 1, p = 0.5) => (
-            t === 0
-                ? 0
-                : t === 1
-                    ? 1
-                    : -a * Math.pow(2, 10 * (t - 1)) * Math.sin(((t - 1 - p / PI2 * Math.asin(1 / a)) * PI2) / p)
-        ),
-        outElastic: (t, a = 1, p = 0.5) => (
-            t === 0
-                ? 0
-                : t === 1
-                    ? 1
-                    : a * Math.pow(2, -10 * t) * Math.sin(((t - p / PI2 * Math.asin(1 / a)) * PI2) / p) + 1
-        ),
-        inOutElastic: (t, a = 1, p = 0.5) => (
-            t === 0
-                ? 0
-                : t === 1
-                    ? 1
-                    : t < 0.5
-                        ? -0.5 * a * Math.pow(2, 20 * t - 10) * Math.sin(((20 * t - 11.125) * PI2) / p)
-                        : 0.5 * a * Math.pow(2, -20 * t + 10) * Math.sin(((20 * t - 11.125) * PI2) / p) + 1
-        )
-    }
+  inElastic: (t, a = 1, p = 0.5) => (
+    t === 0
+      ? 0
+      : t === 1
+        ? 1
+        : -a * Math.pow(2, 10 * (t - 1)) * Math.sin(((t - 1 - p / PI2 * Math.asin(1 / a)) * PI2) / p)
+  ),
+  outElastic: (t, a = 1, p = 0.5) => (
+    t === 0
+      ? 0
+      : t === 1
+        ? 1
+        : a * Math.pow(2, -10 * t) * Math.sin(((t - p / PI2 * Math.asin(1 / a)) * PI2) / p) + 1
+  ),
+  inOutElastic: (t, a = 1, p = 0.5) => (
+    t === 0
+      ? 0
+      : t === 1
+        ? 1
+        : t < 0.5
+          ? -0.5 * a * Math.pow(2, 20 * t - 10) * Math.sin(((20 * t - 11.125) * PI2) / p)
+          : 0.5 * a * Math.pow(2, -20 * t + 10) * Math.sin(((20 * t - 11.125) * PI2) / p) + 1
+  )
+}

package/src/behaviors/modes.js

@@ -15,33 +15,30 @@ import { easings } from "./easings"
 export const modes = {
   /**
    * Реализует пинг-понг эффект для анимации.
-   * @private
    * @param {number} t - Текущее время анимации.
    * @returns {number} Измененное значение времени для эффекта пинг-понг.
    */
   pingPong: function (t) {
-      return t <= 0.5
-          ? this._easing(t * 2)
-          : 1 - this._easing((t - 0.5) * 2)
+    return t <= 0.5
+      ? this._easing(t * 2)
+      : 1 - this._easing((t - 0.5) * 2)
   },
-  
+
   /**
    * Реализует эффект зеркального отражения анимации.
-   * @private
    * @param {number} t - Текущее время анимации.
    * @returns {number} Измененное значение времени для эффекта зеркального отражения.
    */
   yoyo: function (t) {
-      return this._easing(easings.yoyo(t))
+    return this._easing(easings.yoyo(t))
   },
 
   /**
    * Реализует эффект отскока для анимации.
-   * @private
    * @param {number} t - Текущее время анимации.
    * @returns {number} Измененное значение времени для эффекта отскока.
    */
   bounce: function (t) {
-      return easings.yoyo(this._easing(t))
+    return easings.yoyo(this._easing(t))
   },
-}
+}