@oscarpalmer/timer 0.12.0 → 0.13.0

package/README.md

@@ -60,6 +60,20 @@ Both the nice helper methods and the class syntax create similar objects – `Wa
 |`stop()`|Stops the timer|
 |`restart()`|Restarts the timer|
 
+## Callbacks
+
+When you create a repeated timer, you can also provide a fourth parameter to act as a callback to run when the timer stops, as below:
+
+```typescript
+function after(finished: boolean) {
+	// Let's do something fun!
+}
+
+repeat(() => {}, 0, 10, after);
+```
+
+The `finished`-parameter for the `after`-function can be used to determine if the timer was stopped manually, or if it was able to finish its work.
+
 ## License
 
 [MIT licensed](LICENSE), natch :wink:

package/dist/timer.cjs

@@ -1,4 +1,3 @@
-"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -22,7 +21,7 @@ var __publicField = (obj, key, value) => {
   return value;
 };
 
-// src/index.ts
+// src/index.js
 var src_exports = {};
 __export(src_exports, {
   Repeated: () => Repeated,
@@ -32,111 +31,115 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 var milliseconds = Math.round(1e3 / 60);
-var request = requestAnimationFrame != null ? requestAnimationFrame : function(callback) {
-  var _a;
-  return (_a = setTimeout == null ? void 0 : setTimeout(() => {
+var request = globalThis.requestAnimationFrame ?? function(callback) {
+  return setTimeout?.(() => {
     callback(Date.now());
-  }, milliseconds)) != null ? _a : -1;
+  }, milliseconds);
 };
+function run(timed) {
+  timed.state.active = true;
+  timed.state.finished = false;
+  const isRepeated = timed instanceof Repeated;
+  let count = 0;
+  let start;
+  function step(timestamp) {
+    if (!timed.state.active) {
+      return;
+    }
+    start ?? (start = timestamp);
+    const elapsed = timestamp - start;
+    const elapsedMinimum = elapsed - milliseconds;
+    const elapsedMaximum = elapsed + milliseconds;
+    if (elapsedMinimum < timed.configuration.time && timed.configuration.time < elapsedMaximum) {
+      if (timed.state.active) {
+        timed.callbacks.default(isRepeated ? count : void 0);
+      }
+      count += 1;
+      if (isRepeated && count < timed.configuration.count) {
+        start = void 0;
+      } else {
+        timed.state.finished = true;
+        timed.stop();
+        return;
+      }
+    }
+    timed.state.frame = request(step);
+  }
+  timed.state.frame = request(step);
+}
 var Timed = class {
+  /**
+   * @param {Function} callback
+   * @param {number} time
+   * @param {number} count
+   * @param {Function?} afterCallback
+   */
   constructor(callback, time, count, afterCallback) {
+    /**
+     * @readonly
+     * @type {{after?: Function; default: Function}}
+     */
     __publicField(this, "callbacks");
+    /**
+     * @readonly
+     * @type {{count: number; time: number}}
+     */
     __publicField(this, "configuration");
-    __publicField(this, "state", {
-      active: false,
-      finished: false
-    });
+    /**
+     * @readonly
+     * @type {{active: boolean; finished: boolean; frame?: DOMHighResTimeStamp}}
+     */
+    __publicField(this, "state");
     const isRepeated = this instanceof Repeated;
     const type = isRepeated ? "repeated" : "waited";
     if (typeof callback !== "function") {
-      throw new Error(`A ${type} timer must have a callback function`);
+      throw new TypeError(`A ${type} timer must have a callback function`);
     }
     if (typeof time !== "number" || time < 0) {
-      throw new Error(`A ${type} timer must have a non-negative number as its time`);
+      throw new TypeError(`A ${type} timer must have a non-negative number as its time`);
     }
     if (isRepeated && (typeof count !== "number" || count < 2)) {
-      throw new Error("A repeated timer must have a number above 1 as its repeat count");
+      throw new TypeError("A repeated timer must have a number above 1 as its repeat count");
     }
-    if (isRepeated && afterCallback != null && typeof afterCallback !== "function") {
-      throw new Error("A repeated timer's after-callback must be a function");
+    if (isRepeated && afterCallback !== void 0 && typeof afterCallback !== "function") {
+      throw new TypeError("A repeated timer's after-callback must be a function");
     }
     this.configuration = { count, time };
     this.callbacks = {
       after: afterCallback,
       default: callback
     };
+    this.state = {
+      active: false,
+      finished: false,
+      frame: null
+    };
   }
-  /**
-   * Is the timer active?
-   */
+  /** */
   get active() {
     return this.state.active;
   }
-  /**
-   * Has the timer finished?
-   */
   get finished() {
-    return !this.state.active && this.state.finished;
-  }
-  static run(timed) {
-    timed.state.active = true;
-    timed.state.finished = false;
-    const isRepeated = timed instanceof Repeated;
-    let count = 0;
-    let start;
-    function step(timestamp) {
-      if (!timed.state.active) {
-        return;
-      }
-      start != null ? start : start = timestamp;
-      const elapsed = timestamp - start;
-      const elapsedMinimum = elapsed - milliseconds;
-      const elapsedMaximum = elapsed + milliseconds;
-      if (elapsedMinimum < timed.configuration.time && timed.configuration.time < elapsedMaximum) {
-        if (timed.state.active) {
-          timed.callbacks.default(isRepeated ? count : void 0);
-        }
-        count += 1;
-        if (isRepeated && count < timed.configuration.count) {
-          start = void 0;
-        } else {
-          timed.state.finished = true;
-          timed.stop();
-          return;
-        }
-      }
-      timed.state.frame = request(step);
-    }
-    timed.state.frame = request(step);
+    return !this.active && this.state.finished;
   }
-  /**
-   * Restart timer
-   */
   restart() {
     this.stop();
-    Timed.run(this);
+    run(this);
     return this;
   }
-  /**
-   * Start timer
-   */
   start() {
     if (!this.state.active) {
-      Timed.run(this);
+      run(this);
     }
     return this;
   }
-  /**
-   * Stop timer
-   */
   stop() {
-    var _a, _b, _c;
     this.state.active = false;
-    if (typeof this.state.frame === "undefined") {
+    if (this.state.frame === void 0) {
       return this;
     }
-    (_a = cancelAnimationFrame != null ? cancelAnimationFrame : clearTimeout) == null ? void 0 : _a(this.state.frame);
-    (_c = (_b = this.callbacks).after) == null ? void 0 : _c.call(_b, this.finished);
+    (globalThis.cancelAnimationFrame ?? clearTimeout)?.(this.state.frame);
+    this.callbacks.after?.(this.finished);
     this.state.frame = void 0;
     return this;
   }
@@ -144,8 +147,12 @@ var Timed = class {
 var Repeated = class extends Timed {
 };
 var Waited = class extends Timed {
+  /**
+   * @param {Function} callback
+   * @param {number} time
+   */
   constructor(callback, time) {
-    super(callback, time, 1);
+    super(callback, time, 1, null);
   }
 };
 function repeat(callback, time, count, afterCallback) {
@@ -154,4 +161,3 @@ function repeat(callback, time, count, afterCallback) {
 function wait(callback, time) {
   return new Waited(callback, time).start();
 }
-//# sourceMappingURL=timer.cjs.map

package/dist/timer.iife.js

@@ -1,2 +1 @@
-"use strict";var Timer=(()=>{var c=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var y=(a,e,t)=>e in a?c(a,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):a[e]=t;var w=(a,e)=>{for(var t in e)c(a,t,{get:e[t],enumerable:!0})},g=(a,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of k(e))!C.call(a,i)&&i!==t&&c(a,i,{get:()=>e[i],enumerable:!(n=v(e,i))||n.enumerable});return a};var A=a=>g(c({},"__esModule",{value:!0}),a);var l=(a,e,t)=>(y(a,typeof e!="symbol"?e+"":e,t),t);var M={};w(M,{Repeated:()=>o,Waited:()=>f,repeat:()=>x,wait:()=>R});var b=Math.round(16.666666666666668),d=requestAnimationFrame!=null?requestAnimationFrame:function(a){var e;return(e=setTimeout==null?void 0:setTimeout(()=>{a(Date.now())},b))!=null?e:-1},r=class{constructor(e,t,n,i){l(this,"callbacks");l(this,"configuration");l(this,"state",{active:!1,finished:!1});let s=this instanceof o,u=s?"repeated":"waited";if(typeof e!="function")throw new Error(`A ${u} timer must have a callback function`);if(typeof t!="number"||t<0)throw new Error(`A ${u} timer must have a non-negative number as its time`);if(s&&(typeof n!="number"||n<2))throw new Error("A repeated timer must have a number above 1 as its repeat count");if(s&&i!=null&&typeof i!="function")throw new Error("A repeated timer's after-callback must be a function");this.configuration={count:n,time:t},this.callbacks={after:i,default:e}}get active(){return this.state.active}get finished(){return!this.state.active&&this.state.finished}static run(e){e.state.active=!0,e.state.finished=!1;let t=e instanceof o,n=0,i;function s(u){if(!e.state.active)return;i!=null||(i=u);let h=u-i,p=h-b,m=h+b;if(p<e.configuration.time&&e.configuration.time<m)if(e.state.active&&e.callbacks.default(t?n:void 0),n+=1,t&&n<e.configuration.count)i=void 0;else{e.state.finished=!0,e.stop();return}e.state.frame=d(s)}e.state.frame=d(s)}restart(){return this.stop(),r.run(this),this}start(){return this.state.active||r.run(this),this}stop(){var e,t,n;return this.state.active=!1,typeof this.state.frame=="undefined"?this:((e=cancelAnimationFrame!=null?cancelAnimationFrame:clearTimeout)==null||e(this.state.frame),(n=(t=this.callbacks).after)==null||n.call(t,this.finished),this.state.frame=void 0,this)}},o=class extends r{},f=class extends r{constructor(e,t){super(e,t,1)}};function x(a,e,t,n){return new o(a,e,t,n).start()}function R(a,e){return new f(a,e).start()}return A(M);})();
-//# sourceMappingURL=timer.iife.js.map
+var Timer=(()=>{var u=Object.defineProperty;var w=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var y=(t,e,s)=>e in t?u(t,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):t[e]=s;var x=(t,e)=>{for(var s in e)u(t,s,{get:e[s],enumerable:!0})},T=(t,e,s,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of b(e))!g.call(t,a)&&a!==s&&u(t,a,{get:()=>e[a],enumerable:!(n=w(e,a))||n.enumerable});return t};var A=t=>T(u({},"__esModule",{value:!0}),t);var f=(t,e,s)=>(y(t,typeof e!="symbol"?e+"":e,s),s);var M={};x(M,{Repeated:()=>r,Waited:()=>h,repeat:()=>E,wait:()=>k});var l=Math.round(16.666666666666668),p=globalThis.requestAnimationFrame??function(t){return setTimeout?.(()=>{t(Date.now())},l)};function d(t){t.state.active=!0,t.state.finished=!1;let e=t instanceof r,s=0,n;function a(i){if(!t.state.active)return;n??(n=i);let o=i-n,m=o-l,v=o+l;if(m<t.configuration.time&&t.configuration.time<v)if(t.state.active&&t.callbacks.default(e?s:void 0),s+=1,e&&s<t.configuration.count)n=void 0;else{t.state.finished=!0,t.stop();return}t.state.frame=p(a)}t.state.frame=p(a)}var c=class{constructor(e,s,n,a){f(this,"callbacks");f(this,"configuration");f(this,"state");let i=this instanceof r,o=i?"repeated":"waited";if(typeof e!="function")throw new TypeError(`A ${o} timer must have a callback function`);if(typeof s!="number"||s<0)throw new TypeError(`A ${o} timer must have a non-negative number as its time`);if(i&&(typeof n!="number"||n<2))throw new TypeError("A repeated timer must have a number above 1 as its repeat count");if(i&&a!==void 0&&typeof a!="function")throw new TypeError("A repeated timer's after-callback must be a function");this.configuration={count:n,time:s},this.callbacks={after:a,default:e},this.state={active:!1,finished:!1,frame:null}}get active(){return this.state.active}get finished(){return!this.active&&this.state.finished}restart(){return this.stop(),d(this),this}start(){return this.state.active||d(this),this}stop(){return this.state.active=!1,this.state.frame===void 0?this:((globalThis.cancelAnimationFrame??clearTimeout)?.(this.state.frame),this.callbacks.after?.(this.finished),this.state.frame=void 0,this)}},r=class extends c{},h=class extends c{constructor(e,s){super(e,s,1,null)}};function E(t,e,s,n){return new r(t,e,s,n).start()}function k(t,e){return new h(t,e).start()}return A(M);})();

package/dist/timer.js

@@ -1,107 +1,120 @@
-// src/index.ts
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+
+// src/index.js
 var milliseconds = Math.round(1e3 / 60);
-var request = requestAnimationFrame ?? function(callback) {
+var request = globalThis.requestAnimationFrame ?? function(callback) {
   return setTimeout?.(() => {
     callback(Date.now());
-  }, milliseconds) ?? -1;
+  }, milliseconds);
 };
-var Timed = class {
-  callbacks;
-  configuration;
-  state = {
-    active: false,
-    finished: false
-  };
-  /**
-   * Is the timer active?
-   */
-  get active() {
-    return this.state.active;
+function run(timed) {
+  timed.state.active = true;
+  timed.state.finished = false;
+  const isRepeated = timed instanceof Repeated;
+  let count = 0;
+  let start;
+  function step(timestamp) {
+    if (!timed.state.active) {
+      return;
+    }
+    start ?? (start = timestamp);
+    const elapsed = timestamp - start;
+    const elapsedMinimum = elapsed - milliseconds;
+    const elapsedMaximum = elapsed + milliseconds;
+    if (elapsedMinimum < timed.configuration.time && timed.configuration.time < elapsedMaximum) {
+      if (timed.state.active) {
+        timed.callbacks.default(isRepeated ? count : void 0);
+      }
+      count += 1;
+      if (isRepeated && count < timed.configuration.count) {
+        start = void 0;
+      } else {
+        timed.state.finished = true;
+        timed.stop();
+        return;
+      }
+    }
+    timed.state.frame = request(step);
   }
+  timed.state.frame = request(step);
+}
+var Timed = class {
   /**
-   * Has the timer finished?
+   * @param {Function} callback
+   * @param {number} time
+   * @param {number} count
+   * @param {Function?} afterCallback
    */
-  get finished() {
-    return !this.state.active && this.state.finished;
-  }
   constructor(callback, time, count, afterCallback) {
+    /**
+     * @readonly
+     * @type {{after?: Function; default: Function}}
+     */
+    __publicField(this, "callbacks");
+    /**
+     * @readonly
+     * @type {{count: number; time: number}}
+     */
+    __publicField(this, "configuration");
+    /**
+     * @readonly
+     * @type {{active: boolean; finished: boolean; frame?: DOMHighResTimeStamp}}
+     */
+    __publicField(this, "state");
     const isRepeated = this instanceof Repeated;
     const type = isRepeated ? "repeated" : "waited";
     if (typeof callback !== "function") {
-      throw new Error(`A ${type} timer must have a callback function`);
+      throw new TypeError(`A ${type} timer must have a callback function`);
     }
     if (typeof time !== "number" || time < 0) {
-      throw new Error(`A ${type} timer must have a non-negative number as its time`);
+      throw new TypeError(`A ${type} timer must have a non-negative number as its time`);
     }
     if (isRepeated && (typeof count !== "number" || count < 2)) {
-      throw new Error("A repeated timer must have a number above 1 as its repeat count");
+      throw new TypeError("A repeated timer must have a number above 1 as its repeat count");
     }
-    if (isRepeated && afterCallback != null && typeof afterCallback !== "function") {
-      throw new Error("A repeated timer's after-callback must be a function");
+    if (isRepeated && afterCallback !== void 0 && typeof afterCallback !== "function") {
+      throw new TypeError("A repeated timer's after-callback must be a function");
     }
     this.configuration = { count, time };
     this.callbacks = {
       after: afterCallback,
       default: callback
     };
+    this.state = {
+      active: false,
+      finished: false,
+      frame: null
+    };
   }
-  static run(timed) {
-    timed.state.active = true;
-    timed.state.finished = false;
-    const isRepeated = timed instanceof Repeated;
-    let count = 0;
-    let start;
-    function step(timestamp) {
-      if (!timed.state.active) {
-        return;
-      }
-      start ??= timestamp;
-      const elapsed = timestamp - start;
-      const elapsedMinimum = elapsed - milliseconds;
-      const elapsedMaximum = elapsed + milliseconds;
-      if (elapsedMinimum < timed.configuration.time && timed.configuration.time < elapsedMaximum) {
-        if (timed.state.active) {
-          timed.callbacks.default(isRepeated ? count : void 0);
-        }
-        count += 1;
-        if (isRepeated && count < timed.configuration.count) {
-          start = void 0;
-        } else {
-          timed.state.finished = true;
-          timed.stop();
-          return;
-        }
-      }
-      timed.state.frame = request(step);
-    }
-    timed.state.frame = request(step);
+  /** */
+  get active() {
+    return this.state.active;
+  }
+  get finished() {
+    return !this.active && this.state.finished;
   }
-  /**
-   * Restart timer
-   */
   restart() {
     this.stop();
-    Timed.run(this);
+    run(this);
     return this;
   }
-  /**
-   * Start timer
-   */
   start() {
     if (!this.state.active) {
-      Timed.run(this);
+      run(this);
     }
     return this;
   }
-  /**
-   * Stop timer
-   */
   stop() {
     this.state.active = false;
-    if (typeof this.state.frame === "undefined") {
+    if (this.state.frame === void 0) {
       return this;
     }
-    (cancelAnimationFrame ?? clearTimeout)?.(this.state.frame);
+    (globalThis.cancelAnimationFrame ?? clearTimeout)?.(this.state.frame);
     this.callbacks.after?.(this.finished);
     this.state.frame = void 0;
     return this;
@@ -110,8 +123,12 @@ var Timed = class {
 var Repeated = class extends Timed {
 };
 var Waited = class extends Timed {
+  /**
+   * @param {Function} callback
+   * @param {number} time
+   */
   constructor(callback, time) {
-    super(callback, time, 1);
+    super(callback, time, 1, null);
   }
 };
 function repeat(callback, time, count, afterCallback) {
@@ -126,4 +143,3 @@ export {
   repeat,
   wait
 };
-//# sourceMappingURL=timer.js.map

package/package.json

@@ -6,15 +6,9 @@
 	"browser": "dist/timer.iife.js",
 	"description": "A better solution for timeout- and interval-based timers.",
 	"devDependencies": {
-		"@tsconfig/recommended": "^1.0",
-		"@types/node": "^18.15",
-		"@typescript-eslint/eslint-plugin": "^5.57",
-		"@typescript-eslint/parser": "^5.57",
 		"esbuild": "^0.17",
-		"eslint": "^8.38",
-		"eslint-config-xo": "^0.43",
-		"eslint-config-xo-typescript": "^0.57",
-		"typescript": "^5.0"
+		"typescript": "^5.0",
+		"xo": "^0.54"
 	},
 	"exports": {
 		".": {
@@ -43,14 +37,14 @@
 		"url": "git+https://github.com/oscarpalmer/timer.git"
 	},
 	"scripts": {
-		"build": "npm run build:cjs; npm run build:esm; npm run build:iife",
-		"build:cjs": "esbuild ./src/index.ts --bundle --sourcemap --format=cjs --outfile=./dist/timer.cjs --target=es2017",
-		"build:esm": "esbuild ./src/index.ts --bundle --sourcemap --format=esm --outfile=./dist/timer.js --target=esnext",
-		"build:iife": "esbuild ./src/index.ts --bundle --minify --sourcemap --format=iife --global-name=Timer --outfile=./dist/timer.iife.js --target=es2017",
-		"watch": "esbuild ./src/index.ts --bundle --watch --format=esm --outfile=./dist/timer.js --platform=browser --target=esnext"
+		"build": "npm run build:cjs; npm run build:esm; npm run build:iife; npm run types",
+		"build:cjs": "esbuild ./src/index.js --bundle --format=cjs --outfile=./dist/timer.cjs --target=es2020",
+		"build:esm": "esbuild ./src/index.js --bundle --format=esm --outfile=./dist/timer.js --target=es2020",
+		"build:iife": "esbuild ./src/index.js --bundle --minify --format=iife --global-name=Timer --outfile=./dist/timer.iife.js --target=es2020",
+		"types": "./node_modules/.bin/tsc ./src/index.js --allowJs --declaration --emitDeclarationOnly --removeComments"
 	},
 	"type": "module",
 	"types": "src/index.d.ts",
 	"unpkg": "dist/timer.iife.js",
-	"version": "0.12.0"
+	"version": "0.13.0"
 }

package/src/index.d.ts

@@ -1 +1,29 @@
-export * from './index';
+export function repeat(callback: Function, time: number, count: number, afterCallback: Function | null): Repeated;
+export function wait(callback: Function, time: number): Waited;
+export class Repeated extends Timed {
+}
+export class Waited extends Timed {
+    constructor(callback: Function, time: number);
+}
+declare class Timed {
+    constructor(callback: Function, time: number, count: number, afterCallback: Function | null);
+    readonly callbacks: {
+        after?: Function;
+        default: Function;
+    };
+    readonly configuration: {
+        count: number;
+        time: number;
+    };
+    readonly state: {
+        active: boolean;
+        finished: boolean;
+        frame?: DOMHighResTimeStamp;
+    };
+    get active(): boolean;
+    get finished(): boolean;
+    restart(): Timed;
+    start(): Timed;
+    stop(): Timed;
+}
+export {};

package/src/index.js

@@ -0,0 +1,193 @@
+const milliseconds = Math.round(1000 / 60);
+
+const request = globalThis.requestAnimationFrame ?? function (callback) {
+	return setTimeout?.(() => {
+		callback(Date.now());
+	}, milliseconds);
+};
+
+/**
+ * @param {Timed} timed
+ */
+function run(timed) {
+	timed.state.active = true;
+	timed.state.finished = false;
+
+	const isRepeated = timed instanceof Repeated;
+
+	let count = 0;
+
+	let start;
+
+	function step(timestamp) {
+		if (!timed.state.active) {
+			return;
+		}
+
+		start ??= timestamp;
+
+		const elapsed = timestamp - start;
+
+		const elapsedMinimum = elapsed - milliseconds;
+		const elapsedMaximum = elapsed + milliseconds;
+
+		if (elapsedMinimum < timed.configuration.time && timed.configuration.time < elapsedMaximum) {
+			if (timed.state.active) {
+				timed.callbacks.default(isRepeated ? count : undefined);
+			}
+
+			count += 1;
+
+			if (isRepeated && count < timed.configuration.count) {
+				start = undefined;
+			} else {
+				timed.state.finished = true;
+
+				timed.stop();
+
+				return;
+			}
+		}
+
+		timed.state.frame = request(step);
+	}
+
+	timed.state.frame = request(step);
+}
+
+class Timed {
+	/**
+	 * @readonly
+	 * @type {{after?: Function; default: Function}}
+	 */
+	callbacks;
+
+	/**
+	 * @readonly
+	 * @type {{count: number; time: number}}
+	 */
+	configuration;
+
+	/**
+	 * @readonly
+	 * @type {{active: boolean; finished: boolean; frame?: DOMHighResTimeStamp}}
+	 */
+	state;
+
+	/** */
+
+	get active() {
+		return this.state.active;
+	}
+
+	get finished() {
+		return !this.active && this.state.finished;
+	}
+
+	/**
+	 * @param {Function} callback
+	 * @param {number} time
+	 * @param {number} count
+	 * @param {Function?} afterCallback
+	 */
+	constructor(callback, time, count, afterCallback) {
+		const isRepeated = this instanceof Repeated;
+
+		const type = isRepeated
+			? 'repeated'
+			: 'waited';
+
+		if (typeof callback !== 'function') {
+			throw new TypeError(`A ${type} timer must have a callback function`);
+		}
+
+		if (typeof time !== 'number' || time < 0) {
+			throw new TypeError(`A ${type} timer must have a non-negative number as its time`);
+		}
+
+		if (isRepeated && (typeof count !== 'number' || count < 2)) {
+			throw new TypeError('A repeated timer must have a number above 1 as its repeat count');
+		}
+
+		if (isRepeated && afterCallback !== undefined && typeof afterCallback !== 'function') {
+			throw new TypeError('A repeated timer\'s after-callback must be a function');
+		}
+
+		this.configuration = {count, time};
+
+		this.callbacks = {
+			after: afterCallback,
+			default: callback,
+		};
+
+		this.state = {
+			active: false,
+			finished: false,
+			frame: null,
+		};
+	}
+
+	restart() {
+		this.stop();
+
+		run(this);
+
+		return this;
+	}
+
+	start() {
+		if (!this.state.active) {
+			run(this);
+		}
+
+		return this;
+	}
+
+	stop() {
+		this.state.active = false;
+
+		if (this.state.frame === undefined) {
+			return this;
+		}
+
+		(globalThis.cancelAnimationFrame ?? clearTimeout)?.(this.state.frame);
+
+		this.callbacks.after?.(this.finished);
+
+		this.state.frame = undefined;
+
+		return this;
+	}
+}
+
+export class Repeated extends Timed {}
+
+export class Waited extends Timed {
+	/**
+	 * @param {Function} callback
+	 * @param {number} time
+	 */
+	constructor(callback, time) {
+		super(callback, time, 1, null);
+	}
+}
+
+/**
+ * @param {Function} callback
+ * @param {number} time
+ * @param {number} count
+ * @param {Function?} afterCallback
+ * @return {Repeated} A repeated timer
+ */
+export function repeat(callback, time, count, afterCallback) {
+	return (new Repeated(callback, time, count, afterCallback)).start();
+}
+
+/**
+ * @param {Function} callback
+ * @param {number} time
+ * @return {Waited} A waited timer
+ */
+export function wait(callback, time) {
+	return (new Waited(callback, time)).start();
+}

package/dist/timer.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/index.ts"],
-  "sourcesContent": ["type AfterCallback = (finished: boolean) => void;\ntype RepeatedCallback = (index: number) => void;\ntype WaitedCallback = () => void;\n\ntype Callbacks<Callback> = {\n\tafter?: AfterCallback;\n\tdefault: Callback;\n};\n\ntype Configuration = {\n\tcount: number;\n\ttime: number;\n};\n\ntype State = {\n\tactive: boolean;\n\tfinished: boolean;\n\tframe?: number;\n};\n\nconst milliseconds = Math.round(1000 / 60);\n\nconst request = requestAnimationFrame ?? function (callback: FrameRequestCallback): number {\n\treturn (setTimeout?.(() => {\n\t\tcallback(Date.now());\n\t}, milliseconds) ?? -1) as unknown as number;\n};\n\nabstract class Timed<Callback> {\n\treadonly callbacks!: Callbacks<Callback>;\n\treadonly configuration!: Configuration;\n\n\treadonly state: State = {\n\t\tactive: false,\n\t\tfinished: false,\n\t};\n\n\t/**\n\t * Is the timer active?\n\t */\n\tget active(): boolean {\n\t\treturn this.state.active;\n\t}\n\n\t/**\n\t * Has the timer finished?\n\t */\n  get finished(): boolean {\n\t\treturn !this.state.active && this.state.finished;\n\t}\n\n\tconstructor(callback: Callback, time: number,\tcount: number, afterCallback?: AfterCallback) {\n\t\tconst isRepeated = this instanceof Repeated;\n\n\t\tconst type = isRepeated\n\t\t? 'repeated'\n\t\t: 'waited';\n\n\t\tif (typeof callback !== 'function') {\n\t\t\tthrow new Error(`A ${type} timer must have a callback function`);\n\t\t}\n\n\t\tif (typeof time !== 'number' || time < 0) {\n\t\t\tthrow new Error(`A ${type} timer must have a non-negative number as its time`);\n\t\t}\n\n\t\tif (isRepeated && (typeof count !== 'number' || count < 2)) {\n\t\t\tthrow new Error('A repeated timer must have a number above 1 as its repeat count');\n\t\t}\n\n\t\tif (isRepeated && afterCallback != null && typeof afterCallback !== 'function') {\n\t\t\tthrow new Error('A repeated timer\\'s after-callback must be a function');\n\t\t}\n\n\t\tthis.configuration = {count, time};\n\n\t\tthis.callbacks = {\n\t\t\tafter: afterCallback,\n\t\t\tdefault: callback,\n\t\t};\n\t}\n\n\tprivate static run(timed: Timed<(index: number | undefined) => void>): void {\n\t\ttimed.state.active = true;\n\t\ttimed.state.finished = false;\n\n\t\tconst isRepeated = timed instanceof Repeated;\n\n\t\tlet count = 0;\n\n\t\tlet start: DOMHighResTimeStamp | undefined;\n\n\t\tfunction step(timestamp: DOMHighResTimeStamp): void {\n\t\t\tif (!timed.state.active) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tstart ??= timestamp;\n\n\t\t\tconst elapsed = timestamp - start;\n\n\t\t\tconst elapsedMinimum = elapsed - milliseconds;\n\t\t\tconst elapsedMaximum = elapsed + milliseconds;\n\n\t\t\tif (elapsedMinimum < timed.configuration.time && timed.configuration.time < elapsedMaximum) {\n\t\t\t\tif (timed.state.active) {\n\t\t\t\t\ttimed.callbacks.default(isRepeated ? count : undefined);\n\t\t\t\t}\n\n\t\t\t\tcount += 1;\n\n\t\t\t\tif (isRepeated && count < timed.configuration.count) {\n\t\t\t\t\tstart = undefined;\n\t\t\t\t} else {\n\t\t\t\t\ttimed.state.finished = true;\n\n\t\t\t\t\ttimed.stop();\n\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\ttimed.state.frame = request(step);\n\t\t}\n\n\t\ttimed.state.frame = request(step);\n\t}\n\n\t/**\n\t * Restart timer\n\t */\n\trestart(): this {\n\t\tthis.stop();\n\n\t\tTimed.run(this as never);\n\n\t\treturn this;\n\t}\n\n\t/**\n\t * Start timer\n\t */\n\tstart(): this {\n\t\tif (!this.state.active) {\n\t\t\tTimed.run(this as never);\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t/**\n\t * Stop timer\n\t */\n\tstop(): this {\n\t\tthis.state.active = false;\n\n\t\tif (typeof this.state.frame === 'undefined') {\n\t\t\treturn this;\n\t\t}\n\n\t\t(cancelAnimationFrame ?? clearTimeout)?.(this.state.frame);\n\n\t\tthis.callbacks.after?.(this.finished);\n\n\t\tthis.state.frame = undefined;\n\n\t\treturn this;\n\t}\n}\n\n/**\n * A repeated timer\n */\nexport class Repeated extends Timed<RepeatedCallback> {}\n\n/**\n * A waited timer\n */\nexport class Waited extends Timed<WaitedCallback> {\n\tconstructor(callback: WaitedCallback, time: number) {\n\t\tsuper(callback, time, 1);\n\t}\n}\n\n/**\n * Create and start a new repeated timer\n */\nexport function repeat(callback: RepeatedCallback, time: number, count: number, afterCallback?: AfterCallback): Repeated {\n\treturn (new Repeated(callback, time, count, afterCallback)).start();\n}\n\n/**\n * Create and start a new waited timer\n */\nexport function wait(callback: WaitedCallback, time: number): Waited {\n\treturn (new Waited(callback, time)).start();\n}\n"],
-  "mappings": "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",
-  "names": []
-}

package/dist/timer.iife.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/index.ts"],
-  "sourcesContent": ["type AfterCallback = (finished: boolean) => void;\ntype RepeatedCallback = (index: number) => void;\ntype WaitedCallback = () => void;\n\ntype Callbacks<Callback> = {\n\tafter?: AfterCallback;\n\tdefault: Callback;\n};\n\ntype Configuration = {\n\tcount: number;\n\ttime: number;\n};\n\ntype State = {\n\tactive: boolean;\n\tfinished: boolean;\n\tframe?: number;\n};\n\nconst milliseconds = Math.round(1000 / 60);\n\nconst request = requestAnimationFrame ?? function (callback: FrameRequestCallback): number {\n\treturn (setTimeout?.(() => {\n\t\tcallback(Date.now());\n\t}, milliseconds) ?? -1) as unknown as number;\n};\n\nabstract class Timed<Callback> {\n\treadonly callbacks!: Callbacks<Callback>;\n\treadonly configuration!: Configuration;\n\n\treadonly state: State = {\n\t\tactive: false,\n\t\tfinished: false,\n\t};\n\n\t/**\n\t * Is the timer active?\n\t */\n\tget active(): boolean {\n\t\treturn this.state.active;\n\t}\n\n\t/**\n\t * Has the timer finished?\n\t */\n  get finished(): boolean {\n\t\treturn !this.state.active && this.state.finished;\n\t}\n\n\tconstructor(callback: Callback, time: number,\tcount: number, afterCallback?: AfterCallback) {\n\t\tconst isRepeated = this instanceof Repeated;\n\n\t\tconst type = isRepeated\n\t\t? 'repeated'\n\t\t: 'waited';\n\n\t\tif (typeof callback !== 'function') {\n\t\t\tthrow new Error(`A ${type} timer must have a callback function`);\n\t\t}\n\n\t\tif (typeof time !== 'number' || time < 0) {\n\t\t\tthrow new Error(`A ${type} timer must have a non-negative number as its time`);\n\t\t}\n\n\t\tif (isRepeated && (typeof count !== 'number' || count < 2)) {\n\t\t\tthrow new Error('A repeated timer must have a number above 1 as its repeat count');\n\t\t}\n\n\t\tif (isRepeated && afterCallback != null && typeof afterCallback !== 'function') {\n\t\t\tthrow new Error('A repeated timer\\'s after-callback must be a function');\n\t\t}\n\n\t\tthis.configuration = {count, time};\n\n\t\tthis.callbacks = {\n\t\t\tafter: afterCallback,\n\t\t\tdefault: callback,\n\t\t};\n\t}\n\n\tprivate static run(timed: Timed<(index: number | undefined) => void>): void {\n\t\ttimed.state.active = true;\n\t\ttimed.state.finished = false;\n\n\t\tconst isRepeated = timed instanceof Repeated;\n\n\t\tlet count = 0;\n\n\t\tlet start: DOMHighResTimeStamp | undefined;\n\n\t\tfunction step(timestamp: DOMHighResTimeStamp): void {\n\t\t\tif (!timed.state.active) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tstart ??= timestamp;\n\n\t\t\tconst elapsed = timestamp - start;\n\n\t\t\tconst elapsedMinimum = elapsed - milliseconds;\n\t\t\tconst elapsedMaximum = elapsed + milliseconds;\n\n\t\t\tif (elapsedMinimum < timed.configuration.time && timed.configuration.time < elapsedMaximum) {\n\t\t\t\tif (timed.state.active) {\n\t\t\t\t\ttimed.callbacks.default(isRepeated ? count : undefined);\n\t\t\t\t}\n\n\t\t\t\tcount += 1;\n\n\t\t\t\tif (isRepeated && count < timed.configuration.count) {\n\t\t\t\t\tstart = undefined;\n\t\t\t\t} else {\n\t\t\t\t\ttimed.state.finished = true;\n\n\t\t\t\t\ttimed.stop();\n\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\ttimed.state.frame = request(step);\n\t\t}\n\n\t\ttimed.state.frame = request(step);\n\t}\n\n\t/**\n\t * Restart timer\n\t */\n\trestart(): this {\n\t\tthis.stop();\n\n\t\tTimed.run(this as never);\n\n\t\treturn this;\n\t}\n\n\t/**\n\t * Start timer\n\t */\n\tstart(): this {\n\t\tif (!this.state.active) {\n\t\t\tTimed.run(this as never);\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t/**\n\t * Stop timer\n\t */\n\tstop(): this {\n\t\tthis.state.active = false;\n\n\t\tif (typeof this.state.frame === 'undefined') {\n\t\t\treturn this;\n\t\t}\n\n\t\t(cancelAnimationFrame ?? clearTimeout)?.(this.state.frame);\n\n\t\tthis.callbacks.after?.(this.finished);\n\n\t\tthis.state.frame = undefined;\n\n\t\treturn this;\n\t}\n}\n\n/**\n * A repeated timer\n */\nexport class Repeated extends Timed<RepeatedCallback> {}\n\n/**\n * A waited timer\n */\nexport class Waited extends Timed<WaitedCallback> {\n\tconstructor(callback: WaitedCallback, time: number) {\n\t\tsuper(callback, time, 1);\n\t}\n}\n\n/**\n * Create and start a new repeated timer\n */\nexport function repeat(callback: RepeatedCallback, time: number, count: number, afterCallback?: AfterCallback): Repeated {\n\treturn (new Repeated(callback, time, count, afterCallback)).start();\n}\n\n/**\n * Create and start a new waited timer\n */\nexport function wait(callback: WaitedCallback, time: number): Waited {\n\treturn (new Waited(callback, time)).start();\n}\n"],
-  "mappings": "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",
-  "names": ["src_exports", "__export", "Repeated", "Waited", "repeat", "wait", "milliseconds", "request", "callback", "_a", "Timed", "time", "count", "afterCallback", "__publicField", "isRepeated", "Repeated", "type", "timed", "start", "step", "timestamp", "elapsed", "elapsedMinimum", "elapsedMaximum", "_b", "_c", "Waited", "repeat", "wait"]
-}

package/dist/timer.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/index.ts"],
-  "sourcesContent": ["type AfterCallback = (finished: boolean) => void;\ntype RepeatedCallback = (index: number) => void;\ntype WaitedCallback = () => void;\n\ntype Callbacks<Callback> = {\n\tafter?: AfterCallback;\n\tdefault: Callback;\n};\n\ntype Configuration = {\n\tcount: number;\n\ttime: number;\n};\n\ntype State = {\n\tactive: boolean;\n\tfinished: boolean;\n\tframe?: number;\n};\n\nconst milliseconds = Math.round(1000 / 60);\n\nconst request = requestAnimationFrame ?? function (callback: FrameRequestCallback): number {\n\treturn (setTimeout?.(() => {\n\t\tcallback(Date.now());\n\t}, milliseconds) ?? -1) as unknown as number;\n};\n\nabstract class Timed<Callback> {\n\treadonly callbacks!: Callbacks<Callback>;\n\treadonly configuration!: Configuration;\n\n\treadonly state: State = {\n\t\tactive: false,\n\t\tfinished: false,\n\t};\n\n\t/**\n\t * Is the timer active?\n\t */\n\tget active(): boolean {\n\t\treturn this.state.active;\n\t}\n\n\t/**\n\t * Has the timer finished?\n\t */\n  get finished(): boolean {\n\t\treturn !this.state.active && this.state.finished;\n\t}\n\n\tconstructor(callback: Callback, time: number,\tcount: number, afterCallback?: AfterCallback) {\n\t\tconst isRepeated = this instanceof Repeated;\n\n\t\tconst type = isRepeated\n\t\t? 'repeated'\n\t\t: 'waited';\n\n\t\tif (typeof callback !== 'function') {\n\t\t\tthrow new Error(`A ${type} timer must have a callback function`);\n\t\t}\n\n\t\tif (typeof time !== 'number' || time < 0) {\n\t\t\tthrow new Error(`A ${type} timer must have a non-negative number as its time`);\n\t\t}\n\n\t\tif (isRepeated && (typeof count !== 'number' || count < 2)) {\n\t\t\tthrow new Error('A repeated timer must have a number above 1 as its repeat count');\n\t\t}\n\n\t\tif (isRepeated && afterCallback != null && typeof afterCallback !== 'function') {\n\t\t\tthrow new Error('A repeated timer\\'s after-callback must be a function');\n\t\t}\n\n\t\tthis.configuration = {count, time};\n\n\t\tthis.callbacks = {\n\t\t\tafter: afterCallback,\n\t\t\tdefault: callback,\n\t\t};\n\t}\n\n\tprivate static run(timed: Timed<(index: number | undefined) => void>): void {\n\t\ttimed.state.active = true;\n\t\ttimed.state.finished = false;\n\n\t\tconst isRepeated = timed instanceof Repeated;\n\n\t\tlet count = 0;\n\n\t\tlet start: DOMHighResTimeStamp | undefined;\n\n\t\tfunction step(timestamp: DOMHighResTimeStamp): void {\n\t\t\tif (!timed.state.active) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tstart ??= timestamp;\n\n\t\t\tconst elapsed = timestamp - start;\n\n\t\t\tconst elapsedMinimum = elapsed - milliseconds;\n\t\t\tconst elapsedMaximum = elapsed + milliseconds;\n\n\t\t\tif (elapsedMinimum < timed.configuration.time && timed.configuration.time < elapsedMaximum) {\n\t\t\t\tif (timed.state.active) {\n\t\t\t\t\ttimed.callbacks.default(isRepeated ? count : undefined);\n\t\t\t\t}\n\n\t\t\t\tcount += 1;\n\n\t\t\t\tif (isRepeated && count < timed.configuration.count) {\n\t\t\t\t\tstart = undefined;\n\t\t\t\t} else {\n\t\t\t\t\ttimed.state.finished = true;\n\n\t\t\t\t\ttimed.stop();\n\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\ttimed.state.frame = request(step);\n\t\t}\n\n\t\ttimed.state.frame = request(step);\n\t}\n\n\t/**\n\t * Restart timer\n\t */\n\trestart(): this {\n\t\tthis.stop();\n\n\t\tTimed.run(this as never);\n\n\t\treturn this;\n\t}\n\n\t/**\n\t * Start timer\n\t */\n\tstart(): this {\n\t\tif (!this.state.active) {\n\t\t\tTimed.run(this as never);\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t/**\n\t * Stop timer\n\t */\n\tstop(): this {\n\t\tthis.state.active = false;\n\n\t\tif (typeof this.state.frame === 'undefined') {\n\t\t\treturn this;\n\t\t}\n\n\t\t(cancelAnimationFrame ?? clearTimeout)?.(this.state.frame);\n\n\t\tthis.callbacks.after?.(this.finished);\n\n\t\tthis.state.frame = undefined;\n\n\t\treturn this;\n\t}\n}\n\n/**\n * A repeated timer\n */\nexport class Repeated extends Timed<RepeatedCallback> {}\n\n/**\n * A waited timer\n */\nexport class Waited extends Timed<WaitedCallback> {\n\tconstructor(callback: WaitedCallback, time: number) {\n\t\tsuper(callback, time, 1);\n\t}\n}\n\n/**\n * Create and start a new repeated timer\n */\nexport function repeat(callback: RepeatedCallback, time: number, count: number, afterCallback?: AfterCallback): Repeated {\n\treturn (new Repeated(callback, time, count, afterCallback)).start();\n}\n\n/**\n * Create and start a new waited timer\n */\nexport function wait(callback: WaitedCallback, time: number): Waited {\n\treturn (new Waited(callback, time)).start();\n}\n"],
-  "mappings": ";AAoBA,IAAM,eAAe,KAAK,MAAM,MAAO,EAAE;AAEzC,IAAM,UAAU,yBAAyB,SAAU,UAAwC;AAC1F,SAAQ,aAAa,MAAM;AAC1B,aAAS,KAAK,IAAI,CAAC;AAAA,EACpB,GAAG,YAAY,KAAK;AACrB;AAEA,IAAe,QAAf,MAA+B;AAAA,EACrB;AAAA,EACA;AAAA,EAEA,QAAe;AAAA,IACvB,QAAQ;AAAA,IACR,UAAU;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,SAAkB;AACrB,WAAO,KAAK,MAAM;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA,EAKC,IAAI,WAAoB;AACxB,WAAO,CAAC,KAAK,MAAM,UAAU,KAAK,MAAM;AAAA,EACzC;AAAA,EAEA,YAAY,UAAoB,MAAc,OAAe,eAA+B;AAC3F,UAAM,aAAa,gBAAgB;AAEnC,UAAM,OAAO,aACX,aACA;AAEF,QAAI,OAAO,aAAa,YAAY;AACnC,YAAM,IAAI,MAAM,KAAK,0CAA0C;AAAA,IAChE;AAEA,QAAI,OAAO,SAAS,YAAY,OAAO,GAAG;AACzC,YAAM,IAAI,MAAM,KAAK,wDAAwD;AAAA,IAC9E;AAEA,QAAI,eAAe,OAAO,UAAU,YAAY,QAAQ,IAAI;AAC3D,YAAM,IAAI,MAAM,iEAAiE;AAAA,IAClF;AAEA,QAAI,cAAc,iBAAiB,QAAQ,OAAO,kBAAkB,YAAY;AAC/E,YAAM,IAAI,MAAM,sDAAuD;AAAA,IACxE;AAEA,SAAK,gBAAgB,EAAC,OAAO,KAAI;AAEjC,SAAK,YAAY;AAAA,MAChB,OAAO;AAAA,MACP,SAAS;AAAA,IACV;AAAA,EACD;AAAA,EAEA,OAAe,IAAI,OAAyD;AAC3E,UAAM,MAAM,SAAS;AACrB,UAAM,MAAM,WAAW;AAEvB,UAAM,aAAa,iBAAiB;AAEpC,QAAI,QAAQ;AAEZ,QAAI;AAEJ,aAAS,KAAK,WAAsC;AACnD,UAAI,CAAC,MAAM,MAAM,QAAQ;AACxB;AAAA,MACD;AAEA,gBAAU;AAEV,YAAM,UAAU,YAAY;AAE5B,YAAM,iBAAiB,UAAU;AACjC,YAAM,iBAAiB,UAAU;AAEjC,UAAI,iBAAiB,MAAM,cAAc,QAAQ,MAAM,cAAc,OAAO,gBAAgB;AAC3F,YAAI,MAAM,MAAM,QAAQ;AACvB,gBAAM,UAAU,QAAQ,aAAa,QAAQ,MAAS;AAAA,QACvD;AAEA,iBAAS;AAET,YAAI,cAAc,QAAQ,MAAM,cAAc,OAAO;AACpD,kBAAQ;AAAA,QACT,OAAO;AACN,gBAAM,MAAM,WAAW;AAEvB,gBAAM,KAAK;AAEX;AAAA,QACD;AAAA,MACD;AAEA,YAAM,MAAM,QAAQ,QAAQ,IAAI;AAAA,IACjC;AAEA,UAAM,MAAM,QAAQ,QAAQ,IAAI;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA,EAKA,UAAgB;AACf,SAAK,KAAK;AAEV,UAAM,IAAI,IAAa;AAEvB,WAAO;AAAA,EACR;AAAA;AAAA;AAAA;AAAA,EAKA,QAAc;AACb,QAAI,CAAC,KAAK,MAAM,QAAQ;AACvB,YAAM,IAAI,IAAa;AAAA,IACxB;AAEA,WAAO;AAAA,EACR;AAAA;AAAA;AAAA;AAAA,EAKA,OAAa;AACZ,SAAK,MAAM,SAAS;AAEpB,QAAI,OAAO,KAAK,MAAM,UAAU,aAAa;AAC5C,aAAO;AAAA,IACR;AAEA,KAAC,wBAAwB,gBAAgB,KAAK,MAAM,KAAK;AAEzD,SAAK,UAAU,QAAQ,KAAK,QAAQ;AAEpC,SAAK,MAAM,QAAQ;AAEnB,WAAO;AAAA,EACR;AACD;AAKO,IAAM,WAAN,cAAuB,MAAwB;AAAC;AAKhD,IAAM,SAAN,cAAqB,MAAsB;AAAA,EACjD,YAAY,UAA0B,MAAc;AACnD,UAAM,UAAU,MAAM,CAAC;AAAA,EACxB;AACD;AAKO,SAAS,OAAO,UAA4B,MAAc,OAAe,eAAyC;AACxH,SAAQ,IAAI,SAAS,UAAU,MAAM,OAAO,aAAa,EAAG,MAAM;AACnE;AAKO,SAAS,KAAK,UAA0B,MAAsB;AACpE,SAAQ,IAAI,OAAO,UAAU,IAAI,EAAG,MAAM;AAC3C;",
-  "names": []
-}

package/src/index.ts

@@ -1,197 +0,0 @@
-type AfterCallback = (finished: boolean) => void;
-type RepeatedCallback = (index: number) => void;
-type WaitedCallback = () => void;
-
-type Callbacks<Callback> = {
-	after?: AfterCallback;
-	default: Callback;
-};
-
-type Configuration = {
-	count: number;
-	time: number;
-};
-
-type State = {
-	active: boolean;
-	finished: boolean;
-	frame?: number;
-};
-
-const milliseconds = Math.round(1000 / 60);
-
-const request = requestAnimationFrame ?? function (callback: FrameRequestCallback): number {
-	return (setTimeout?.(() => {
-		callback(Date.now());
-	}, milliseconds) ?? -1) as unknown as number;
-};
-
-abstract class Timed<Callback> {
-	readonly callbacks!: Callbacks<Callback>;
-	readonly configuration!: Configuration;
-
-	readonly state: State = {
-		active: false,
-		finished: false,
-	};
-
-	/**
-	 * Is the timer active?
-	 */
-	get active(): boolean {
-		return this.state.active;
-	}
-
-	/**
-	 * Has the timer finished?
-	 */
-  get finished(): boolean {
-		return !this.state.active && this.state.finished;
-	}
-
-	constructor(callback: Callback, time: number,	count: number, afterCallback?: AfterCallback) {
-		const isRepeated = this instanceof Repeated;
-
-		const type = isRepeated
-		? 'repeated'
-		: 'waited';
-
-		if (typeof callback !== 'function') {
-			throw new Error(`A ${type} timer must have a callback function`);
-		}
-
-		if (typeof time !== 'number' || time < 0) {
-			throw new Error(`A ${type} timer must have a non-negative number as its time`);
-		}
-
-		if (isRepeated && (typeof count !== 'number' || count < 2)) {
-			throw new Error('A repeated timer must have a number above 1 as its repeat count');
-		}
-
-		if (isRepeated && afterCallback != null && typeof afterCallback !== 'function') {
-			throw new Error('A repeated timer\'s after-callback must be a function');
-		}
-
-		this.configuration = {count, time};
-
-		this.callbacks = {
-			after: afterCallback,
-			default: callback,
-		};
-	}
-
-	private static run(timed: Timed<(index: number | undefined) => void>): void {
-		timed.state.active = true;
-		timed.state.finished = false;
-
-		const isRepeated = timed instanceof Repeated;
-
-		let count = 0;
-
-		let start: DOMHighResTimeStamp | undefined;
-
-		function step(timestamp: DOMHighResTimeStamp): void {
-			if (!timed.state.active) {
-				return;
-			}
-
-			start ??= timestamp;
-
-			const elapsed = timestamp - start;
-
-			const elapsedMinimum = elapsed - milliseconds;
-			const elapsedMaximum = elapsed + milliseconds;
-
-			if (elapsedMinimum < timed.configuration.time && timed.configuration.time < elapsedMaximum) {
-				if (timed.state.active) {
-					timed.callbacks.default(isRepeated ? count : undefined);
-				}
-
-				count += 1;
-
-				if (isRepeated && count < timed.configuration.count) {
-					start = undefined;
-				} else {
-					timed.state.finished = true;
-
-					timed.stop();
-
-					return;
-				}
-			}
-
-			timed.state.frame = request(step);
-		}
-
-		timed.state.frame = request(step);
-	}
-
-	/**
-	 * Restart timer
-	 */
-	restart(): this {
-		this.stop();
-
-		Timed.run(this as never);
-
-		return this;
-	}
-
-	/**
-	 * Start timer
-	 */
-	start(): this {
-		if (!this.state.active) {
-			Timed.run(this as never);
-		}
-
-		return this;
-	}
-
-	/**
-	 * Stop timer
-	 */
-	stop(): this {
-		this.state.active = false;
-
-		if (typeof this.state.frame === 'undefined') {
-			return this;
-		}
-
-		(cancelAnimationFrame ?? clearTimeout)?.(this.state.frame);
-
-		this.callbacks.after?.(this.finished);
-
-		this.state.frame = undefined;
-
-		return this;
-	}
-}
-
-/**
- * A repeated timer
- */
-export class Repeated extends Timed<RepeatedCallback> {}
-
-/**
- * A waited timer
- */
-export class Waited extends Timed<WaitedCallback> {
-	constructor(callback: WaitedCallback, time: number) {
-		super(callback, time, 1);
-	}
-}
-
-/**
- * Create and start a new repeated timer
- */
-export function repeat(callback: RepeatedCallback, time: number, count: number, afterCallback?: AfterCallback): Repeated {
-	return (new Repeated(callback, time, count, afterCallback)).start();
-}
-
-/**
- * Create and start a new waited timer
- */
-export function wait(callback: WaitedCallback, time: number): Waited {
-	return (new Waited(callback, time)).start();
-}