@ixfx/debug 0.45.0 → 0.56.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021-2024 Clint Heyer
+Copyright (c) 2021-2025 Clint Heyer
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -88,3 +88,30 @@ Permission is hereby granted, free of charge, to any person obtaining a copy of
 The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+----
+
+Package: Kalman.js
+https://github.com/wouterbulten/kalmanjs
+
+MIT License
+
+Copyright (c) 2019 Wouter Bulten
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/{bundle → dist}/index.d.ts

@@ -11,42 +11,40 @@ type LogMessage = {
   readonly msg: any;
   readonly category?: string;
 };
-//# sourceMappingURL=types.d.ts.map
-
 //#endregion
 //#region src/logger.d.ts
 /**
- * Returns a console logging function which prefixes messages. This is
- * useful for tracing messages from different components. Each prefix
- * is assigned a colour, further helping to distinguish messages.
- *
- * Use {@link logSet} to get a bundled set.
- *
- * ```
- * // Initialise once
- * const log = logger(`a`);
- * const error = logger(`a`, `error`);
- * const warn = logger(`a`, `warn);
- *
- * // And then use
- * log(`Hello`);    // console.log(`a Hello`);
- * error(`Uh-oh`);  // console.error(`a Uh-oh`);
- * warn(`Eek!`);    // console.warn(`a Eeek!`);
- * ```
- *
- * Provide the `colourKey` parameter to make log messages
- * be coloured the same, even though the prefix is different.
- * ```js
- * // Both loggers will use the same colour because they
- * // share the colour key `system`
- * const log = logger(`a`,`log`,`system`);
- * const log2 = logger(`b`, `log`, `system`);
- * ```
- * @param prefix
- * @param kind
- * @param colourKey Optional key to colour log lines by instead of prefix
- * @returns
- */
+* Returns a console logging function which prefixes messages. This is
+* useful for tracing messages from different components. Each prefix
+* is assigned a colour, further helping to distinguish messages.
+*
+* Use {@link logSet} to get a bundled set.
+*
+* ```
+* // Initialise once
+* const log = logger(`a`);
+* const error = logger(`a`, `error`);
+* const warn = logger(`a`, `warn);
+*
+* // And then use
+* log(`Hello`);    // console.log(`a Hello`);
+* error(`Uh-oh`);  // console.error(`a Uh-oh`);
+* warn(`Eek!`);    // console.warn(`a Eeek!`);
+* ```
+*
+* Provide the `colourKey` parameter to make log messages
+* be coloured the same, even though the prefix is different.
+* ```js
+* // Both loggers will use the same colour because they
+* // share the colour key `system`
+* const log = logger(`a`,`log`,`system`);
+* const log2 = logger(`b`, `log`, `system`);
+* ```
+* @param prefix
+* @param kind
+* @param colourKey Optional key to colour log lines by instead of prefix
+* @returns
+*/
 declare const logger: (prefix: string, kind?: `log` | `warn` | `error`, colourKey?: string) => MessageLogger;
 /**
 * Returns a bundled collection of {@link logger}s
@@ -77,53 +75,48 @@ declare const logSet: (prefix: string, verbose?: boolean, colourKey?: string) =>
   error: MessageLogger;
 };
 /**
- * Either a flag for default console logging, or a simple log function
- */
+* Either a flag for default console logging, or a simple log function
+*/
 type LogOption = boolean | MessageLogger;
 /**
- * Resolve a LogOption to a function
- * @param l
- * @returns
- */
+* Resolve a LogOption to a function
+* @param l
+* @returns
+*/
 declare const resolveLogOption: (l?: LogOption, defaults?: {
   readonly category?: string;
   readonly kind?: string;
 }) => MessageLogger;
 declare const logColours: (key: string, args?: unknown) => string;
-//# sourceMappingURL=logger.d.ts.map
 //#endregion
 //#region src/fps-counter.d.ts
 /**
- * Calculates frames per second.
- *
- * Returns a function which needs to be called at the end of each frame.
- *
- * ```js
- * const fps = fpsCounter();
- *
- * function loop() {
- *  fps(); // Calculate fps
- *  window.requestAnimationFrame(loop);
- * }
- *
- * loop();
- * ```
- * @param autoDisplay If true (default), prints out the FPS to the console
- * @param computeAfterFrames Calculates after this many frames. Higher numbers smoothes the value somewhat
- * @returns
- */
+* Calculates frames per second.
+* 
+* Returns a function which needs to be called at the end of each frame.
+* 
+* ```js
+* const fps = fpsCounter();
+* 
+* function loop() {
+*  fps(); // Calculate fps
+*  window.requestAnimationFrame(loop);
+* }
+* 
+* loop();
+* ```
+* @param autoDisplay If true (default), prints out the FPS to the console
+* @param computeAfterFrames Calculates after this many frames. Higher numbers smoothes the value somewhat
+* @returns 
+*/
 declare const fpsCounter: (autoDisplay?: boolean, computeAfterFrames?: number) => () => number;
-//# sourceMappingURL=fps-counter.d.ts.map
 //#endregion
 //#region src/error-message.d.ts
 /**
- * Returns a string representation of an error
- * @param ex
- * @returns
- */
+* Returns a string representation of an error
+* @param ex 
+* @returns 
+*/
 declare const getErrorMessage: (ex: unknown) => string;
-//# sourceMappingURL=error-message.d.ts.map
-
 //#endregion
-export { LogKind, LogMessage, LogOption, LogSet, MessageLogger, fpsCounter, getErrorMessage, logColours, logSet, logger, resolveLogOption };
-//# sourceMappingURL=index.d.ts.map
+export { LogKind, LogMessage, LogOption, LogSet, MessageLogger, fpsCounter, getErrorMessage, logColours, logSet, logger, resolveLogOption };

package/dist/index.js

@@ -0,0 +1,185 @@
+//#region src/util.ts
+const getOrGenerateSync = (map, fn) => (key, args) => {
+	let value = map.get(key);
+	if (value !== void 0) return value;
+	value = fn(key, args);
+	map.set(key, value);
+	return value;
+};
+
+//#endregion
+//#region src/logger.ts
+/**
+* Returns a console logging function which prefixes messages. This is
+* useful for tracing messages from different components. Each prefix
+* is assigned a colour, further helping to distinguish messages.
+*
+* Use {@link logSet} to get a bundled set.
+*
+* ```
+* // Initialise once
+* const log = logger(`a`);
+* const error = logger(`a`, `error`);
+* const warn = logger(`a`, `warn);
+*
+* // And then use
+* log(`Hello`);    // console.log(`a Hello`);
+* error(`Uh-oh`);  // console.error(`a Uh-oh`);
+* warn(`Eek!`);    // console.warn(`a Eeek!`);
+* ```
+*
+* Provide the `colourKey` parameter to make log messages
+* be coloured the same, even though the prefix is different.
+* ```js
+* // Both loggers will use the same colour because they
+* // share the colour key `system`
+* const log = logger(`a`,`log`,`system`);
+* const log2 = logger(`b`, `log`, `system`);
+* ```
+* @param prefix
+* @param kind
+* @param colourKey Optional key to colour log lines by instead of prefix
+* @returns
+*/
+const logger = (prefix, kind = `log`, colourKey) => (m) => {
+	if (m === void 0) m = `(undefined)`;
+	else if (typeof m === `object`) m = JSON.stringify(m);
+	const colour = colourKey ?? prefix;
+	switch (kind) {
+		case `log`:
+			console.log(`%c${prefix} ${m}`, `color: ${logColours(colour)}`);
+			break;
+		case `warn`:
+			console.warn(prefix, m);
+			break;
+		case `error`:
+			console.error(prefix, m);
+			break;
+	}
+};
+/**
+* Returns a bundled collection of {@link logger}s
+*
+* ```js
+* const con = logSet(`a`);
+* con.log(`Hello`);  // console.log(`a Hello`);
+* con.warn(`Uh-oh`); // console.warn(`a Uh-oh`);
+* con.error(`Eek!`); // console.error(`a Eek!`);
+* ```
+*
+* By default each prefix is assigned a colour. To use
+* another logic, provide the `colourKey` parameter.
+*
+* ```js
+* // Both set of loggers will use same colour
+* const con = logSet(`a`, true, `system`);
+* const con2 = logSet(`b`, true, `system`);
+* ```
+* @param prefix Prefix for log messages
+* @param verbose True by default. If false, log() messages are a no-op
+* @param colourKey If specified, log messages will be coloured by this key instead of prefix (default)
+* @returns
+*/
+const logSet = (prefix, verbose = true, colourKey) => {
+	if (verbose) return {
+		log: logger(prefix, `log`, colourKey),
+		warn: logger(prefix, `warn`, colourKey),
+		error: logger(prefix, `error`, colourKey)
+	};
+	return {
+		log: (_) => {
+			/** no-op */
+		},
+		warn: logger(prefix, `warn`, colourKey),
+		error: logger(prefix, `error`, colourKey)
+	};
+};
+/**
+* Resolve a LogOption to a function
+* @param l
+* @returns
+*/
+const resolveLogOption = (l, defaults = {}) => {
+	if (l === void 0 || typeof l === `boolean` && !l) return (_) => {
+		/** no-op */
+	};
+	const defaultCat = defaults.category ?? ``;
+	const defaultKind = defaults.kind ?? void 0;
+	if (typeof l === `boolean`) return (messageOrString) => {
+		const m = typeof messageOrString === `string` ? { msg: messageOrString } : messageOrString;
+		const kind = m.kind ?? defaultKind;
+		const category = m.category ?? defaultCat;
+		let message = m.msg;
+		if (category) message = `[${category}] ${message}`;
+		switch (kind) {
+			case `error`:
+				console.error(message);
+				break;
+			case `warn`:
+				console.warn(message);
+				break;
+			case `info`:
+				console.info(message);
+				break;
+			default: console.log(message);
+		}
+	};
+	return l;
+};
+let logColourCount = 0;
+const logColours = getOrGenerateSync(/* @__PURE__ */ new Map(), () => {
+	return `hsl(${++logColourCount * 137.508},50%,75%)`;
+});
+
+//#endregion
+//#region src/fps-counter.ts
+/**
+* Calculates frames per second.
+* 
+* Returns a function which needs to be called at the end of each frame.
+* 
+* ```js
+* const fps = fpsCounter();
+* 
+* function loop() {
+*  fps(); // Calculate fps
+*  window.requestAnimationFrame(loop);
+* }
+* 
+* loop();
+* ```
+* @param autoDisplay If true (default), prints out the FPS to the console
+* @param computeAfterFrames Calculates after this many frames. Higher numbers smoothes the value somewhat
+* @returns 
+*/
+const fpsCounter = (autoDisplay = true, computeAfterFrames = 500) => {
+	let count = 0;
+	let lastFps = 0;
+	let countStart = performance.now();
+	return () => {
+		if (count++ >= computeAfterFrames) {
+			const elapsed = performance.now() - countStart;
+			countStart = performance.now();
+			count = 0;
+			lastFps = Math.floor(computeAfterFrames / elapsed * 1e3);
+			if (autoDisplay) console.log(`fps: ${lastFps}`);
+		}
+		return lastFps;
+	};
+};
+
+//#endregion
+//#region src/error-message.ts
+/**
+* Returns a string representation of an error
+* @param ex 
+* @returns 
+*/
+const getErrorMessage = (ex) => {
+	if (typeof ex === `string`) return ex;
+	if (ex instanceof Error) return ex.message;
+	return ex;
+};
+
+//#endregion
+export { fpsCounter, getErrorMessage, logColours, logSet, logger, resolveLogOption };

package/package.json

@@ -1,23 +1,46 @@
 {
   "name": "@ixfx/debug",
-  "version": "0.45.0",
+  "version": "0.56.0",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
   "files": [
-    "dist/",
-    "bundle/"
+    "dist"
   ],
-  "dependencies": {},
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": {
-      "types": "./dist/src/index.d.ts",
-      "import": "./dist/src/index.js"
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./dist/*",
+        "./*"
+      ]
     }
   },
-  "scripts": {
-    "package-bundle": "tsdown",
-    "clean": "rm -rf dist && rm -rf bundle"
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "ixfx guards",
+  "keywords": [
+    "ixfx",
+    "interactivity",
+    "guards"
+  ],
+  "homepage": "https://ixfxfun.dev",
+  "bugs": {
+    "url": "https://github.com/@ixfxfun/ixfx/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/@ixfxfun/ixfx.git",
+    "directory": "packages/guards"
+  },
+  "author": "Clint Heyer <clint@thestaticvoid.net>",
+  "engines": {
+    "node": ">=20.19.0"
   },
-  "main": "dist/src/index.js"
+  "scripts": {}
 }

package/bundle/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/logger.ts","../src/fps-counter.ts","../src/error-message.ts"],"sourcesContent":[],"mappings":";KAAY,MAAA;EAAA,SAAM,GAAA,EACF,aADE;EAAA,SAAA,IAAA,EAED,aAFC;EAAA,SACF,KAAA,EAEE,aAFF;CAAa;AAEX,KAEN,aAAA,GAFM,CAAA,OAAA,EAEoB,UAFpB,GAAA,MAAA,EAAA,GAAA,IAAA;AAAa,KAGnB,OAAA,GAHmB,MAAA,GAAA,OAAA,GAAA,OAAA,GAAA,MAAA;AAEnB,KAEA,UAAA,GAFa;EACb,SAAA,IAAO,CAAA,EAED,OAFC;EACP,SAAA,GAAA,EAAU,GAAA;;;;;;;AAPtB;;;;;AAG+B;AAE/B;AACA;AACA;;;;ACgCA;AAqDA;;;;;;AAoBA;AAOA;;;;AAwCC;AAID;;;;AChJA;;;cDoBa,iFAKR;AEvCL;;;;;;;;;;;;;;;;;;;;;;;cFuFa;OAeZ;;;;;;;KAKW,SAAA,aAAsB;;;;;;cAOrB,uBACP;;;MAEH;cAyCU;;;;;ADnKb;;;;;AAG+B;AAE/B;AACA;AACA;;;;ACgCA;AAqDA;;;;;cCzEa;AD6Fb;;;;ADhHA;;;;AAGkB,cGEL,eHFK,EAAA,CAAA,EAAA,EAAA,OAAA,EAAA,GAAA,MAAA;AAAa"}

package/bundle/index.js

@@ -1,2 +0,0 @@
-const e=(e,t)=>(n,r)=>{let i=e.get(n);return i===void 0?(i=t(n,r),e.set(n,i),i):i},t=(e,t=`log`,n)=>r=>{r===void 0?r=`(undefined)`:typeof r==`object`&&(r=JSON.stringify(r));let i=n??e;switch(t){case`log`:console.log(`%c${e} ${r}`,`color: ${a(i)}`);break;case`warn`:console.warn(e,r);break;case`error`:console.error(e,r);break}},n=(e,n=!0,r)=>n?{log:t(e,`log`,r),warn:t(e,`warn`,r),error:t(e,`error`,r)}:{log:e=>{},warn:t(e,`warn`,r),error:t(e,`error`,r)},r=(e,t={})=>{if(e===void 0||typeof e==`boolean`&&!e)return e=>{};let n=t.category??``,r=t.kind??void 0;return typeof e==`boolean`?e=>{let t=typeof e==`string`?{msg:e}:e,i=t.kind??r,a=t.category??n,o=t.msg;switch(a&&(o=`[${a}] ${o}`),i){case`error`:console.error(o);break;case`warn`:console.warn(o);break;case`info`:console.info(o);break;default:console.log(o)}}:e};let i=0;const a=e(new Map,()=>{let e=++i*137.508;return`hsl(${e},50%,75%)`}),o=(e=!0,t=500)=>{let n=0,r=0,i=performance.now();return()=>{if(n++>=t){let a=performance.now()-i;i=performance.now(),n=0,r=Math.floor(t/a*1e3),e&&console.log(`fps: ${r}`)}return r}},s=e=>typeof e==`string`?e:e instanceof Error?e.message:e;export{o as fpsCounter,s as getErrorMessage,a as logColours,n as logSet,t as logger,r as resolveLogOption};
-//# sourceMappingURL=index.js.map

package/bundle/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":["map: Map<K, V>","fn: (key: K, args?: Z) => V","key: K","args?: Z","prefix: string","kind: `log` | `warn` | `error`","colourKey?: string","m: any","_: any","l?: LogOption","defaults: { readonly category?: string; readonly kind?: string }","_: LogMessage | string","messageOrString: LogMessage | string","ex: unknown"],"sources":["../src/util.ts","../src/logger.ts","../src/fps-counter.ts","../src/error-message.ts"],"sourcesContent":["export const getOrGenerateSync =\n  <K, V, Z>(map: Map<K, V>, fn: (key: K, args?: Z) => V) =>\n    (key: K, args?: Z): V => {\n      let value = map.get(key);\n      if (value !== undefined) return value;\n      value = fn(key, args);\n      map.set(key, value);\n      return value;\n    };","import type { MessageLogger, LogMessage } from \"./types.js\";\nimport { getOrGenerateSync } from \"./util.js\";\n\n/**\n * Returns a console logging function which prefixes messages. This is\n * useful for tracing messages from different components. Each prefix\n * is assigned a colour, further helping to distinguish messages.\n *\n * Use {@link logSet} to get a bundled set.\n *\n * ```\n * // Initialise once\n * const log = logger(`a`);\n * const error = logger(`a`, `error`);\n * const warn = logger(`a`, `warn);\n *\n * // And then use\n * log(`Hello`);    // console.log(`a Hello`);\n * error(`Uh-oh`);  // console.error(`a Uh-oh`);\n * warn(`Eek!`);    // console.warn(`a Eeek!`);\n * ```\n *\n * Provide the `colourKey` parameter to make log messages\n * be coloured the same, even though the prefix is different.\n * ```js\n * // Both loggers will use the same colour because they\n * // share the colour key `system`\n * const log = logger(`a`,`log`,`system`);\n * const log2 = logger(`b`, `log`, `system`);\n * ```\n * @param prefix\n * @param kind\n * @param colourKey Optional key to colour log lines by instead of prefix\n * @returns\n */\n\n\n\n\nexport const logger =\n  (\n    prefix: string,\n    kind: `log` | `warn` | `error` = `log`,\n    colourKey?: string\n  ): MessageLogger =>\n    (m: any) => {\n      if (m === undefined) {\n        m = `(undefined)`;\n      } else if (typeof m === `object`) {\n        m = JSON.stringify(m);\n      }\n\n      const colour = colourKey ?? prefix;\n      switch (kind) {\n        case `log`: {\n          console.log(`%c${ prefix } ${ m }`, `color: ${ logColours(colour) }`);\n          break;\n        }\n        case `warn`: {\n          console.warn(prefix, m);\n          break;\n        }\n        case `error`: {\n          console.error(prefix, m);\n          break;\n        }\n      }\n    };\n\n/**\n* Returns a bundled collection of {@link logger}s\n*\n* ```js\n* const con = logSet(`a`);\n* con.log(`Hello`);  // console.log(`a Hello`);\n* con.warn(`Uh-oh`); // console.warn(`a Uh-oh`);\n* con.error(`Eek!`); // console.error(`a Eek!`);\n* ```\n*\n* By default each prefix is assigned a colour. To use\n* another logic, provide the `colourKey` parameter.\n*\n* ```js\n* // Both set of loggers will use same colour\n* const con = logSet(`a`, true, `system`);\n* const con2 = logSet(`b`, true, `system`);\n* ```\n* @param prefix Prefix for log messages\n* @param verbose True by default. If false, log() messages are a no-op\n* @param colourKey If specified, log messages will be coloured by this key instead of prefix (default)\n* @returns\n*/\nexport const logSet = (prefix: string, verbose = true, colourKey?: string) => {\n  if (verbose) {\n    return {\n      log: logger(prefix, `log`, colourKey),\n      warn: logger(prefix, `warn`, colourKey),\n      error: logger(prefix, `error`, colourKey),\n    };\n  }\n  return {\n    log: (_: any) => {\n      /** no-op */\n    },\n    warn: logger(prefix, `warn`, colourKey),\n    error: logger(prefix, `error`, colourKey),\n  };\n};\n\n/**\n * Either a flag for default console logging, or a simple log function\n */\nexport type LogOption = boolean | MessageLogger;\n\n/**\n * Resolve a LogOption to a function\n * @param l\n * @returns\n */\nexport const resolveLogOption = (\n  l?: LogOption,\n  defaults: { readonly category?: string; readonly kind?: string } = {}\n): MessageLogger => {\n  if (l === undefined || (typeof l === `boolean` && !l)) {\n    return (_: LogMessage | string) => {\n      /** no-op */\n    };\n  }\n  const defaultCat = defaults.category ?? ``;\n  const defaultKind = defaults.kind ?? undefined;\n\n  if (typeof l === `boolean`) {\n    return (messageOrString: LogMessage | string) => {\n      const m =\n        typeof messageOrString === `string` ? { msg: messageOrString } : messageOrString;\n      const kind = m.kind ?? defaultKind;\n      const category = m.category ?? defaultCat;\n      let message = m.msg;\n      if (category) message = `[${ category }] ${ message }`;\n      switch (kind) {\n        case `error`: {\n          console.error(message);\n          break;\n        }\n        case `warn`: {\n          console.warn(message);\n          break;\n        }\n        case `info`: {\n          console.info(message);\n          break;\n        }\n        default: {\n          console.log(message);\n        }\n      }\n    };\n  }\n  return l;\n};\n\n\nlet logColourCount = 0;\nexport const logColours = getOrGenerateSync(new Map<string, string>(), () => {\n  const hue = ++logColourCount * 137.508; // use golden angle approximation\n  return `hsl(${ hue },50%,75%)`;\n});","/**\n * Calculates frames per second.\n * \n * Returns a function which needs to be called at the end of each frame.\n * \n * ```js\n * const fps = fpsCounter();\n * \n * function loop() {\n *  fps(); // Calculate fps\n *  window.requestAnimationFrame(loop);\n * }\n * \n * loop();\n * ```\n * @param autoDisplay If true (default), prints out the FPS to the console\n * @param computeAfterFrames Calculates after this many frames. Higher numbers smoothes the value somewhat\n * @returns \n */\nexport const fpsCounter = (autoDisplay = true, computeAfterFrames = 500) => {\n  let count = 0;\n  let lastFps = 0;\n  let countStart = performance.now();\n\n  return () => {\n    if (count++ >= computeAfterFrames) {\n      const elapsed = performance.now() - countStart;\n      countStart = performance.now();\n      count = 0;\n      lastFps = Math.floor((computeAfterFrames / elapsed) * 1000);\n      if (autoDisplay) console.log(`fps: ${ lastFps }`);\n    }\n    return lastFps\n  }\n}","/**\n * Returns a string representation of an error\n * @param ex \n * @returns \n */\nexport const getErrorMessage = (ex: unknown): string => {\n  if (typeof ex === `string`) return ex;\n  if (ex instanceof Error) {\n    return ex.message;\n  }\n  return ex as string;\n};"],"mappings":"AAAA,MAAa,EACX,CAAUA,EAAgBC,IACxB,CAACC,EAAQC,IAAgB,CACvB,IAAI,EAAQ,EAAI,IAAI,EAAI,CAIxB,OAHI,IAAU,IAAA,IACd,EAAQ,EAAG,EAAK,EAAK,CACrB,EAAI,IAAI,EAAK,EAAM,CACZ,GAHyB,CAIjC,EC+BQ,EACX,CACEC,EACAC,EAAiC,MACjCC,IAEA,AAACC,GAAW,CACN,IAAM,IAAA,GACR,EAAI,cACK,OAAO,GAAM,WACtB,EAAI,KAAK,UAAU,EAAE,EAGvB,IAAM,EAAS,GAAa,EAC5B,OAAQ,EAAR,CACE,IAAK,MACH,QAAQ,IAAI,CAAC,EAAE,EAAG,EAAQ,CAAC,EAAG,GAAI,CAAE,CAAC,OAAO,EAAG,EAAW,EAAO,EAAG,CAAC,CACrE,MAEF,IAAK,OACH,QAAQ,KAAK,EAAQ,EAAE,CACvB,MAEF,IAAK,QACH,QAAQ,MAAM,EAAQ,EAAE,CACxB,KAEH,CACF,EAyBQ,EAAS,CAACH,EAAgB,EAAU,GAAME,IACjD,EACK,CACL,IAAK,EAAO,EAAQ,MAAO,EAAU,CACrC,KAAM,EAAO,EAAQ,OAAQ,EAAU,CACvC,MAAO,EAAO,EAAQ,QAAS,EAAU,AAC1C,EAEI,CACL,IAAK,AAACE,GAAW,CAEhB,EACD,KAAM,EAAO,EAAQ,OAAQ,EAAU,CACvC,MAAO,EAAO,EAAQ,QAAS,EAAU,AAC1C,EAaU,EAAmB,CAC9BC,EACAC,EAAmE,CAAE,IACnD,CAClB,GAAI,IAAM,IAAA,IAAc,OAAO,GAAM,WAAa,CAAC,EACjD,MAAO,CAACC,GAA2B,CAElC,EAEH,IAAM,EAAa,EAAS,UAAY,GAClC,EAAc,EAAS,MAAQ,IAAA,GA6BrC,OA3BI,OAAO,GAAM,UACR,AAACC,GAAyC,CAC/C,IAAM,EACJ,OAAO,GAAoB,SAAW,CAAE,IAAK,CAAiB,EAAG,EAC7D,EAAO,EAAE,MAAQ,EACjB,EAAW,EAAE,UAAY,EAC3B,EAAU,EAAE,IAEhB,OADI,IAAU,EAAU,CAAC,CAAC,EAAG,EAAU,EAAE,EAAG,GAAU,EAC9C,EAAR,CACE,IAAK,QACH,QAAQ,MAAM,EAAQ,CACtB,MAEF,IAAK,OACH,QAAQ,KAAK,EAAQ,CACrB,MAEF,IAAK,OACH,QAAQ,KAAK,EAAQ,CACrB,MAEF,QACE,QAAQ,IAAI,EAAQ,AAEvB,CACF,EAEI,CACR,EAGD,IAAI,EAAiB,EACrB,MAAa,EAAa,EAAkB,IAAI,IAAuB,IAAM,CAC3E,IAAM,EAAM,EAAE,EAAiB,QAC/B,MAAO,CAAC,IAAI,EAAG,EAAK,SAAS,CAAC,AAC/B,EAAC,CCnJW,EAAa,CAAC,EAAc,GAAM,EAAqB,MAAQ,CAC1E,IAAI,EAAQ,EACR,EAAU,EACV,EAAa,YAAY,KAAK,CAElC,MAAO,IAAM,CACX,GAAI,KAAW,EAAoB,CACjC,IAAM,EAAU,YAAY,KAAK,CAAG,EACpC,EAAa,YAAY,KAAK,CAC9B,EAAQ,EACR,EAAU,KAAK,MAAO,EAAqB,EAAW,IAAK,CACvD,GAAa,QAAQ,IAAI,CAAC,KAAK,EAAG,GAAU,CAAC,AAClD,CACD,OAAO,CACR,CACF,EC7BY,EAAkB,AAACC,GAC1B,OAAO,GAAO,SAAiB,EAC/B,aAAc,MACT,EAAG,QAEL"}

package/dist/__tests__/test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=test.d.ts.map

package/dist/__tests__/test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../__tests__/test.ts"],"names":[],"mappings":""}

package/dist/__tests__/test.js

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

package/dist/src/error-message.d.ts

@@ -1,7 +0,0 @@
-/**
- * Returns a string representation of an error
- * @param ex
- * @returns
- */
-export declare const getErrorMessage: (ex: unknown) => string;
-//# sourceMappingURL=error-message.d.ts.map

package/dist/src/error-message.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-message.d.ts","sourceRoot":"","sources":["../../src/error-message.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,IAAI,OAAO,KAAG,MAM7C,CAAC"}

package/dist/src/error-message.js

@@ -1,13 +0,0 @@
-/**
- * Returns a string representation of an error
- * @param ex
- * @returns
- */
-export const getErrorMessage = (ex) => {
-    if (typeof ex === `string`)
-        return ex;
-    if (ex instanceof Error) {
-        return ex.message;
-    }
-    return ex;
-};

package/dist/src/fps-counter.d.ts

@@ -1,21 +0,0 @@
-/**
- * Calculates frames per second.
- *
- * Returns a function which needs to be called at the end of each frame.
- *
- * ```js
- * const fps = fpsCounter();
- *
- * function loop() {
- *  fps(); // Calculate fps
- *  window.requestAnimationFrame(loop);
- * }
- *
- * loop();
- * ```
- * @param autoDisplay If true (default), prints out the FPS to the console
- * @param computeAfterFrames Calculates after this many frames. Higher numbers smoothes the value somewhat
- * @returns
- */
-export declare const fpsCounter: (autoDisplay?: boolean, computeAfterFrames?: number) => () => number;
-//# sourceMappingURL=fps-counter.d.ts.map

package/dist/src/fps-counter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fps-counter.d.ts","sourceRoot":"","sources":["../../src/fps-counter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,UAAU,GAAI,qBAAkB,EAAE,2BAAwB,iBAetE,CAAA"}

package/dist/src/fps-counter.js

@@ -1,35 +0,0 @@
-/**
- * Calculates frames per second.
- *
- * Returns a function which needs to be called at the end of each frame.
- *
- * ```js
- * const fps = fpsCounter();
- *
- * function loop() {
- *  fps(); // Calculate fps
- *  window.requestAnimationFrame(loop);
- * }
- *
- * loop();
- * ```
- * @param autoDisplay If true (default), prints out the FPS to the console
- * @param computeAfterFrames Calculates after this many frames. Higher numbers smoothes the value somewhat
- * @returns
- */
-export const fpsCounter = (autoDisplay = true, computeAfterFrames = 500) => {
-    let count = 0;
-    let lastFps = 0;
-    let countStart = performance.now();
-    return () => {
-        if (count++ >= computeAfterFrames) {
-            const elapsed = performance.now() - countStart;
-            countStart = performance.now();
-            count = 0;
-            lastFps = Math.floor((computeAfterFrames / elapsed) * 1000);
-            if (autoDisplay)
-                console.log(`fps: ${lastFps}`);
-        }
-        return lastFps;
-    };
-};

package/dist/src/index.d.ts

@@ -1,5 +0,0 @@
-export * from './types.js';
-export * from './logger.js';
-export * from './fps-counter.js';
-export * from './error-message.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/dist/src/index.js

@@ -1,4 +0,0 @@
-export * from './types.js';
-export * from './logger.js';
-export * from './fps-counter.js';
-export * from './error-message.js';

package/dist/src/logger.d.ts

@@ -1,77 +0,0 @@
-import type { MessageLogger } from "./types.js";
-/**
- * Returns a console logging function which prefixes messages. This is
- * useful for tracing messages from different components. Each prefix
- * is assigned a colour, further helping to distinguish messages.
- *
- * Use {@link logSet} to get a bundled set.
- *
- * ```
- * // Initialise once
- * const log = logger(`a`);
- * const error = logger(`a`, `error`);
- * const warn = logger(`a`, `warn);
- *
- * // And then use
- * log(`Hello`);    // console.log(`a Hello`);
- * error(`Uh-oh`);  // console.error(`a Uh-oh`);
- * warn(`Eek!`);    // console.warn(`a Eeek!`);
- * ```
- *
- * Provide the `colourKey` parameter to make log messages
- * be coloured the same, even though the prefix is different.
- * ```js
- * // Both loggers will use the same colour because they
- * // share the colour key `system`
- * const log = logger(`a`,`log`,`system`);
- * const log2 = logger(`b`, `log`, `system`);
- * ```
- * @param prefix
- * @param kind
- * @param colourKey Optional key to colour log lines by instead of prefix
- * @returns
- */
-export declare const logger: (prefix: string, kind?: `log` | `warn` | `error`, colourKey?: string) => MessageLogger;
-/**
-* Returns a bundled collection of {@link logger}s
-*
-* ```js
-* const con = logSet(`a`);
-* con.log(`Hello`);  // console.log(`a Hello`);
-* con.warn(`Uh-oh`); // console.warn(`a Uh-oh`);
-* con.error(`Eek!`); // console.error(`a Eek!`);
-* ```
-*
-* By default each prefix is assigned a colour. To use
-* another logic, provide the `colourKey` parameter.
-*
-* ```js
-* // Both set of loggers will use same colour
-* const con = logSet(`a`, true, `system`);
-* const con2 = logSet(`b`, true, `system`);
-* ```
-* @param prefix Prefix for log messages
-* @param verbose True by default. If false, log() messages are a no-op
-* @param colourKey If specified, log messages will be coloured by this key instead of prefix (default)
-* @returns
-*/
-export declare const logSet: (prefix: string, verbose?: boolean, colourKey?: string) => {
-    log: MessageLogger;
-    warn: MessageLogger;
-    error: MessageLogger;
-};
-/**
- * Either a flag for default console logging, or a simple log function
- */
-export type LogOption = boolean | MessageLogger;
-/**
- * Resolve a LogOption to a function
- * @param l
- * @returns
- */
-export declare const resolveLogOption: (l?: LogOption, defaults?: {
-    readonly category?: string;
-    readonly kind?: string;
-}) => MessageLogger;
-export declare const logColours: (key: string, args?: unknown) => string;
-//# sourceMappingURL=logger.d.ts.map

package/dist/src/logger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,YAAY,CAAC;AAG5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH,eAAO,MAAM,MAAM,GAEf,QAAQ,MAAM,EACd,OAAM,KAAK,GAAG,MAAM,GAAG,OAAe,EACtC,YAAY,MAAM,KACjB,aAuBA,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;;;EAsBE;AACF,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,iBAAc,EAAE,YAAY,MAAM;;;;CAexE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,IAAI,SAAS,EACb,WAAU;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,KACpE,aAqCF,CAAC;AAIF,eAAO,MAAM,UAAU,yCAGrB,CAAC"}

package/dist/src/logger.js

@@ -1,142 +0,0 @@
-import { getOrGenerateSync } from "./util.js";
-/**
- * Returns a console logging function which prefixes messages. This is
- * useful for tracing messages from different components. Each prefix
- * is assigned a colour, further helping to distinguish messages.
- *
- * Use {@link logSet} to get a bundled set.
- *
- * ```
- * // Initialise once
- * const log = logger(`a`);
- * const error = logger(`a`, `error`);
- * const warn = logger(`a`, `warn);
- *
- * // And then use
- * log(`Hello`);    // console.log(`a Hello`);
- * error(`Uh-oh`);  // console.error(`a Uh-oh`);
- * warn(`Eek!`);    // console.warn(`a Eeek!`);
- * ```
- *
- * Provide the `colourKey` parameter to make log messages
- * be coloured the same, even though the prefix is different.
- * ```js
- * // Both loggers will use the same colour because they
- * // share the colour key `system`
- * const log = logger(`a`,`log`,`system`);
- * const log2 = logger(`b`, `log`, `system`);
- * ```
- * @param prefix
- * @param kind
- * @param colourKey Optional key to colour log lines by instead of prefix
- * @returns
- */
-export const logger = (prefix, kind = `log`, colourKey) => (m) => {
-    if (m === undefined) {
-        m = `(undefined)`;
-    }
-    else if (typeof m === `object`) {
-        m = JSON.stringify(m);
-    }
-    const colour = colourKey ?? prefix;
-    switch (kind) {
-        case `log`: {
-            console.log(`%c${prefix} ${m}`, `color: ${logColours(colour)}`);
-            break;
-        }
-        case `warn`: {
-            console.warn(prefix, m);
-            break;
-        }
-        case `error`: {
-            console.error(prefix, m);
-            break;
-        }
-    }
-};
-/**
-* Returns a bundled collection of {@link logger}s
-*
-* ```js
-* const con = logSet(`a`);
-* con.log(`Hello`);  // console.log(`a Hello`);
-* con.warn(`Uh-oh`); // console.warn(`a Uh-oh`);
-* con.error(`Eek!`); // console.error(`a Eek!`);
-* ```
-*
-* By default each prefix is assigned a colour. To use
-* another logic, provide the `colourKey` parameter.
-*
-* ```js
-* // Both set of loggers will use same colour
-* const con = logSet(`a`, true, `system`);
-* const con2 = logSet(`b`, true, `system`);
-* ```
-* @param prefix Prefix for log messages
-* @param verbose True by default. If false, log() messages are a no-op
-* @param colourKey If specified, log messages will be coloured by this key instead of prefix (default)
-* @returns
-*/
-export const logSet = (prefix, verbose = true, colourKey) => {
-    if (verbose) {
-        return {
-            log: logger(prefix, `log`, colourKey),
-            warn: logger(prefix, `warn`, colourKey),
-            error: logger(prefix, `error`, colourKey),
-        };
-    }
-    return {
-        log: (_) => {
-            /** no-op */
-        },
-        warn: logger(prefix, `warn`, colourKey),
-        error: logger(prefix, `error`, colourKey),
-    };
-};
-/**
- * Resolve a LogOption to a function
- * @param l
- * @returns
- */
-export const resolveLogOption = (l, defaults = {}) => {
-    if (l === undefined || (typeof l === `boolean` && !l)) {
-        return (_) => {
-            /** no-op */
-        };
-    }
-    const defaultCat = defaults.category ?? ``;
-    const defaultKind = defaults.kind ?? undefined;
-    if (typeof l === `boolean`) {
-        return (messageOrString) => {
-            const m = typeof messageOrString === `string` ? { msg: messageOrString } : messageOrString;
-            const kind = m.kind ?? defaultKind;
-            const category = m.category ?? defaultCat;
-            let message = m.msg;
-            if (category)
-                message = `[${category}] ${message}`;
-            switch (kind) {
-                case `error`: {
-                    console.error(message);
-                    break;
-                }
-                case `warn`: {
-                    console.warn(message);
-                    break;
-                }
-                case `info`: {
-                    console.info(message);
-                    break;
-                }
-                default: {
-                    console.log(message);
-                }
-            }
-        };
-    }
-    return l;
-};
-let logColourCount = 0;
-export const logColours = getOrGenerateSync(new Map(), () => {
-    const hue = ++logColourCount * 137.508; // use golden angle approximation
-    return `hsl(${hue},50%,75%)`;
-});

package/dist/src/types.d.ts

@@ -1,13 +0,0 @@
-export type LogSet = {
-    readonly log: MessageLogger;
-    readonly warn: MessageLogger;
-    readonly error: MessageLogger;
-};
-export type MessageLogger = (message: LogMessage | string) => void;
-export type LogKind = `info` | `debug` | `error` | `warn`;
-export type LogMessage = {
-    readonly kind?: LogKind;
-    readonly msg: any;
-    readonly category?: string;
-};
-//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CAC/B,CAAA;AACD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,KAAK,IAAI,CAAC;AACnE,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAC1D,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAA"}

package/dist/src/types.js

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

package/dist/src/util.d.ts

@@ -1,2 +0,0 @@
-export declare const getOrGenerateSync: <K, V, Z>(map: Map<K, V>, fn: (key: K, args?: Z) => V) => (key: K, args?: Z) => V;
-//# sourceMappingURL=util.d.ts.map

package/dist/src/util.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,GAC3B,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,MAClD,KAAK,CAAC,EAAE,OAAO,CAAC,KAAG,CAMnB,CAAC"}

package/dist/src/util.js

@@ -1,8 +0,0 @@
-export const getOrGenerateSync = (map, fn) => (key, args) => {
-    let value = map.get(key);
-    if (value !== undefined)
-        return value;
-    value = fn(key, args);
-    map.set(key, value);
-    return value;
-};

package/dist/tsconfig.tsbuildinfo

@@ -1 +0,0 @@
-{"root":["../src/error-message.ts","../src/fps-counter.ts","../src/index.ts","../src/logger.ts","../src/types.ts","../src/util.ts","../__tests__/test.ts"],"version":"5.8.3"}