@prozilla-os/shared 1.1.1 → 1.2.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2023 Sieben De Beule
-
-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
+MIT License
+
+Copyright (c) 2023 Sieben De Beule
+
+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/README.md

@@ -1,63 +1,40 @@
-<div align="center">
-  <br />
-  <p>
-    <a href="https://os.prozilla.dev/"><img src="https://os.prozilla.dev/assets/logo.svg?v=2" height="200" alt="ProzillaOS" /></a>
-  </p>
-  <p>
-    <a href="https://github.com/prozilla-os/ProzillaOS/blob/main/LICENSE.md"><img alt="License" src="https://img.shields.io/github/license/Prozilla/ProzillaOS?style=flat-square&color=FF4D5B&label=License"></a>
-    <a href="https://github.com/prozilla-os/ProzillaOS"><img alt="Stars" src="https://img.shields.io/github/stars/Prozilla/ProzillaOS?style=flat-square&color=FED24C&label=%E2%AD%90"></a>
-    <a href="https://github.com/prozilla-os/ProzillaOS"><img alt="Forks" src="https://img.shields.io/github/forks/Prozilla/ProzillaOS?style=flat-square&color=4D9CFF&label=Forks&logo=github"></a>
-    <a href="https://www.npmjs.com/package/prozilla-os"><img alt="NPM Version" src="https://img.shields.io/npm/v/prozilla-os?logo=npm&style=flat-square&label=prozilla-os&color=FF4D5B"></a>
-  </p>
-</div>
-
-## About 
-
-`@prozilla-os/shared` is a library of shared utility functions for ProzillaOS packages.
-
-## Installation
-
-```sh
-$ npm install @prozilla-os/shared
-$ yarn add @prozilla-os/shared
-$ pnpm add @prozilla-os/shared
-```
-
-## Usage
-
-### `appViteConfig(basePath, entryPath)`
-
-Helper function for creating Vite configurations for ProzillaOS apps.
-
-#### Params
-
-- `basePath` (string) - Path of base directory
-- `entryPath` (string) - Path of library entry
-
-#### Example
-```tsx
-// vite.config.ts
-
-import { defineConfig } from "vite";
-import { appViteConfig } from "@prozilla-os/shared";
-
-export default defineConfig({
-	...appViteConfig(__dirname, "src/main.ts")
-});
-```
-
-## Links
-
-- [Demo][demo]
-- [Docs][docs]
-- [GitHub][github]
-- [npm][npm]
-- [Discord][discord]
-- [Ko-fi][ko-fi]
-
-[demo]: https://os.prozilla.dev/
-[docs]: [docs]: https://os.prozilla.dev/docs/reference/shared
-[github]: https://github.com/prozilla-os/ProzillaOS/tree/main/packages/shared
-[npm]: https://www.npmjs.com/package/@prozilla-os/shared
-[discord]: https://discord.gg/JwbyQP4tdz
-[ko-fi]: https://ko-fi.com/prozilla
+<div align="center">
+  <br />
+  <p>
+    <a href="https://os.prozilla.dev/"><img src="https://os.prozilla.dev/assets/logo.svg?v=2" height="200" alt="ProzillaOS" /></a>
+  </p>
+  <p>
+    <a href="https://github.com/prozilla-os/ProzillaOS/blob/main/LICENSE.md"><img alt="License" src="https://img.shields.io/github/license/Prozilla/ProzillaOS?style=flat-square&color=FF4D5B&label=License"></a>
+    <a href="https://github.com/prozilla-os/ProzillaOS"><img alt="Stars" src="https://img.shields.io/github/stars/Prozilla/ProzillaOS?style=flat-square&color=FED24C&label=%E2%AD%90"></a>
+    <a href="https://github.com/prozilla-os/ProzillaOS"><img alt="Forks" src="https://img.shields.io/github/forks/Prozilla/ProzillaOS?style=flat-square&color=4D9CFF&label=Forks&logo=github"></a>
+    <a href="https://www.npmjs.com/package/prozilla-os"><img alt="NPM Version" src="https://img.shields.io/npm/v/prozilla-os?logo=npm&style=flat-square&label=prozilla-os&color=FF4D5B"></a>
+  </p>
+</div>
+
+## About
+
+`@prozilla-os/shared` is a library of shared utility functions and variables for ProzillaOS packages.
+
+## Installation
+
+```sh
+npm install @prozilla-os/shared
+yarn add @prozilla-os/shared
+pnpm add @prozilla-os/shared
+```
+
+## Links
+
+- [Demo][demo]
+- [Docs][docs]
+- [GitHub][github]
+- [npm][npm]
+- [Discord][discord]
+- [Ko-fi][ko-fi]
+
+[demo]: https://os.prozilla.dev/
+[docs]: https://os.prozilla.dev/docs/reference/shared
+[github]: https://github.com/prozilla-os/ProzillaOS/tree/main/packages/shared
+[npm]: https://www.npmjs.com/package/@prozilla-os/shared
+[discord]: https://discord.gg/JwbyQP4tdz
+[ko-fi]: https://ko-fi.com/prozilla

package/dist/main.d.ts

@@ -1,12 +1,71 @@
-import { UserConfig } from 'vite';
+export declare const ANSI: {
+    fg: {
+        black: string;
+        red: string;
+        green: string;
+        yellow: string;
+        blue: string;
+        magenta: string;
+        cyan: string;
+        white: string;
+    };
+    bg: {};
+    decoration: {
+        dim: string;
+        bold: string;
+    };
+    reset: string;
+};
+
+export declare function clamp(value: number, min: number, max: number): number;
+
+export declare class EventEmitter<EventMap extends EventNamesMap> {
+    #private;
+    static EVENT_NAMES: EventNamesMap;
+    /**
+     * Add event listener for an event
+     */
+    on<Key extends keyof EventMap>(eventName: Key, callback: Listener): Listener;
+    /**
+     * Remove event listener for an event
+     */
+    off<Key extends keyof EventMap>(eventName: Key, callback: Listener): void;
+    /**
+     * Dispatch event
+     */
+    emit<Key extends keyof EventMap>(eventName: Key, data?: unknown): void;
+}
+
+export declare type EventNamesMap = Record<string, string>;
 
 /**
- * Helper function for creating Vite configurations for ProzillaOS apps
- * @param basePath - Path of base directory
- * @param entryPath - Path of library entry
- * @returns Vite configuration
- * @see https://vitejs.dev/config/
+ * Format a time relative to now
+ * @param date - The date
+ * @param maxLength - The maximum amount of units, e.g.: 3 => years, months, days
  */
-export declare const appViteConfig: (basePath: string, entryPath: string) => UserConfig;
+export declare function formatRelativeTime(date: Date, maxLength: number | undefined, allowAffixes: boolean): string;
+
+/**
+ * Format a time
+ * @param time - Time in milliseconds
+ * @param maxLength - The maximum amount of units, e.g.: 3 => years, months, days
+ */
+export declare function formatTime(time: number, maxLength: number | undefined, allowAffixes: boolean): string;
+
+export declare function isValidInteger(number: number | string): number | boolean;
+
+export declare type Listener = (data: unknown) => void;
+
+export declare function parseBool(input: string): boolean;
+
+export declare function randomFromArray<Type>(array: Type[]): Type;
+
+export declare function randomRange(min: number, max: number): number;
+
+export declare function removeDuplicatesFromArray<Type>(array: Type[]): Type[];
+
+export declare function removeFromArray<Type>(item: Type, array: Type[]): void;
+
+export declare function round(value: number, precision: number): number;
 
 export { }

package/dist/main.js

@@ -1,39 +1,139 @@
-import r from "@vitejs/plugin-react-swc";
-import i from "vite-plugin-dts";
-import { libInjectCss as l } from "vite-plugin-lib-inject-css";
-import { resolve as n, sep as t, posix as p } from "path";
-const f = (s, o) => {
-  let e = n(s, o);
-  return t === "\\" && (e = e.split(t).join(p.sep)), console.log("Using Vite config for app"), console.log("Entry: " + e), {
-    plugins: [
-      r(),
-      l(),
-      i({
-        include: ["src"],
-        outDir: "dist",
-        rollupTypes: !0,
-        strictOutput: !0,
-        pathsToAliases: !1,
-        tsconfigPath: "tsconfig.build.json"
-      })
-    ],
-    build: {
-      lib: {
-        entry: e,
-        formats: ["es"]
-      },
-      rollupOptions: {
-        external: ["react", "react/jsx-runtime", "@prozilla-os/core"],
-        output: {
-          assetFileNames: "assets/[name][extname]",
-          entryFileNames: "[name].js"
-        }
-      },
-      sourcemap: !0
-    }
-  };
+var g = Object.defineProperty;
+var m = (t) => {
+  throw TypeError(t);
+};
+var M = (t, n, e) => n in t ? g(t, n, { enumerable: !0, configurable: !0, writable: !0, value: e }) : t[n] = e;
+var d = (t, n, e) => M(t, typeof n != "symbol" ? n + "" : n, e), y = (t, n, e) => n.has(t) || m("Cannot " + e);
+var i = (t, n, e) => (y(t, n, "read from private field"), e ? e.call(t) : n.get(t)), x = (t, n, e) => n.has(t) ? m("Cannot add the same private member more than once") : n instanceof WeakSet ? n.add(t) : n.set(t, e);
+const A = {
+  fg: {
+    black: "\x1B[30m",
+    red: "\x1B[31m",
+    green: "\x1B[32m",
+    yellow: "\x1B[33m",
+    blue: "\x1B[34m",
+    magenta: "\x1B[35m",
+    cyan: "\x1B[36m",
+    white: "\x1B[37m"
+  },
+  bg: {},
+  decoration: {
+    dim: "\x1B[2m",
+    bold: "\x1B[1m"
+  },
+  reset: "\x1B[0m"
+};
+function E(t, n) {
+  const e = n.indexOf(t);
+  e !== -1 && n.splice(e, 1);
+}
+function O(t) {
+  return t[Math.floor(Math.random() * t.length)];
+}
+function T(t) {
+  return t.filter((n, e) => t.indexOf(n) === e);
+}
+const p = {
+  s: 1e3,
+  m: 1e3 * 60,
+  h: 1e3 * 60 * 60,
+  d: 1e3 * 60 * 60 * 24,
+  w: 1e3 * 60 * 60 * 24 * 7,
+  n: 1e3 * 60 * 60 * 24 * 31,
+  y: 1e3 * 60 * 60 * 24 * 365,
+  c: 1e3 * 60 * 60 * 24 * 365 * 100
 };
+function b(t, n = 3, e) {
+  const s = [], a = (o, f) => {
+    if (!e)
+      return o.join(", ");
+    let u = "", h = "";
+    return f ? h = "ago" : u = "in", [u, o.join(", "), h].join(" ").trim();
+  };
+  let c = !1;
+  if (t < 0 && (t = -t, c = !0), Math.abs(t) < p.s)
+    return a(["less than a second"], c);
+  const l = [], B = {
+    s: "seconds",
+    m: "minutes",
+    h: "hours",
+    d: "days",
+    n: "months",
+    y: "years"
+  };
+  for (const [o, f] of Object.entries(p).reverse()) {
+    if (o === "w" || o === "c")
+      continue;
+    const u = Math.floor(t / f);
+    t -= u * f, u > 0 && l.push({ amount: u, label: B[o] });
+  }
+  for (let o = 0; o < n; o++) {
+    const f = l[o];
+    f && s.push(`${f.amount} ${f.label}`);
+  }
+  return s.length === 0 ? a(["less than a second"], c) : a(s, c);
+}
+function j(t, n = 3, e) {
+  const s = t.valueOf() - Date.now();
+  return b(s, n, e);
+}
+var r;
+class w {
+  constructor() {
+    x(this, r, {});
+  }
+  /**
+   * Add event listener for an event
+   */
+  on(n, e) {
+    return i(this, r)[n] || (i(this, r)[n] = []), i(this, r)[n].push(e), e;
+  }
+  /**
+   * Remove event listener for an event
+   */
+  off(n, e) {
+    i(this, r)[n] && (i(this, r)[n] = i(this, r)[n].filter(
+      (s) => s !== e
+    ));
+  }
+  /**
+   * Dispatch event
+   */
+  emit(n, e) {
+    i(this, r)[n] && i(this, r)[n].forEach((s) => {
+      s(e);
+    });
+  }
+}
+r = new WeakMap(), d(w, "EVENT_NAMES", {});
+function R(t, n, e) {
+  return t < n ? n : t > e ? e : t;
+}
+function D(t, n) {
+  return Math.random() * (n - t) + t;
+}
+function F(t, n) {
+  const e = Math.pow(10, n || 0);
+  return Math.round(t * e) / e;
+}
+function S(t) {
+  return typeof t == "number" || parseInt(t) || parseInt(t) === 0;
+}
+function C(t) {
+  return t.trim().toLowerCase() === "true";
+}
 export {
-  f as appViteConfig
+  A as ANSI,
+  w as EventEmitter,
+  R as clamp,
+  j as formatRelativeTime,
+  b as formatTime,
+  S as isValidInteger,
+  C as parseBool,
+  O as randomFromArray,
+  D as randomRange,
+  T as removeDuplicatesFromArray,
+  E as removeFromArray,
+  F as round
 };
 //# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sources":["../src/configs/app.vite.config.ts"],"sourcesContent":["import { UserConfig } from \"vite\";\r\nimport react from \"@vitejs/plugin-react-swc\";\r\nimport dts from \"vite-plugin-dts\";\r\nimport { libInjectCss } from \"vite-plugin-lib-inject-css\";\r\nimport { posix, resolve, sep } from \"path\";\r\n\r\n/**\r\n * Helper function for creating Vite configurations for ProzillaOS apps\r\n * @param basePath - Path of base directory\r\n * @param entryPath - Path of library entry\r\n * @returns Vite configuration\r\n * @see https://vitejs.dev/config/\r\n */\r\nexport const appViteConfig = (basePath: string, entryPath: string): UserConfig => {\r\n\tlet entryFile = resolve(basePath, entryPath);\r\n\r\n\t// Normalize paths for Windows compatibility\r\n\tif (sep === \"\\\\\")\r\n\t\tentryFile = entryFile.split(sep).join(posix.sep);\r\n\r\n\tconsole.log(\"Using Vite config for app\");\r\n\tconsole.log(\"Entry: \" + entryFile);\r\n\r\n\treturn {\r\n\t\tplugins: [\r\n\t\t\treact(),\r\n\t\t\tlibInjectCss(),\r\n\t\t\tdts({\r\n\t\t\t\tinclude: [\"src\"],\r\n\t\t\t\toutDir: \"dist\",\r\n\t\t\t\trollupTypes: true,\r\n\t\t\t\tstrictOutput: true,\r\n\t\t\t\tpathsToAliases: false,\r\n\t\t\t\ttsconfigPath: \"tsconfig.build.json\"\r\n\t\t\t})\r\n\t\t],\r\n\t\tbuild: {\r\n\t\t\tlib: {\r\n\t\t\t\tentry: entryFile,\r\n\t\t\t\tformats: [\"es\"],\r\n\t\t\t},\r\n\t\t\trollupOptions: {\r\n\t\t\t\texternal: [\"react\", \"react/jsx-runtime\", \"@prozilla-os/core\"],\r\n\t\t\t\toutput: {\r\n\t\t\t\t\tassetFileNames: \"assets/[name][extname]\",\r\n\t\t\t\t\tentryFileNames: \"[name].js\",\r\n\t\t\t\t}\r\n\t\t\t},\r\n\t\t\tsourcemap: true\r\n\t\t}\r\n\t};\r\n};"],"names":["appViteConfig","basePath","entryPath","entryFile","resolve","sep","posix","react","libInjectCss","dts"],"mappings":";;;;AAaa,MAAAA,IAAgB,CAACC,GAAkBC,MAAkC;AAC7E,MAAAC,IAAYC,EAAQH,GAAUC,CAAS;AAG3C,SAAIG,MAAQ,SACXF,IAAYA,EAAU,MAAME,CAAG,EAAE,KAAKC,EAAM,GAAG,IAEhD,QAAQ,IAAI,2BAA2B,GAC/B,QAAA,IAAI,YAAYH,CAAS,GAE1B;AAAA,IACN,SAAS;AAAA,MACRI,EAAM;AAAA,MACNC,EAAa;AAAA,MACbC,EAAI;AAAA,QACH,SAAS,CAAC,KAAK;AAAA,QACf,QAAQ;AAAA,QACR,aAAa;AAAA,QACb,cAAc;AAAA,QACd,gBAAgB;AAAA,QAChB,cAAc;AAAA,MAAA,CACd;AAAA,IACF;AAAA,IACA,OAAO;AAAA,MACN,KAAK;AAAA,QACJ,OAAON;AAAA,QACP,SAAS,CAAC,IAAI;AAAA,MACf;AAAA,MACA,eAAe;AAAA,QACd,UAAU,CAAC,SAAS,qBAAqB,mBAAmB;AAAA,QAC5D,QAAQ;AAAA,UACP,gBAAgB;AAAA,UAChB,gBAAgB;AAAA,QACjB;AAAA,MACD;AAAA,MACA,WAAW;AAAA,IACZ;AAAA,EAAA;AAEF;"}
+{"version":3,"file":"main.js","sources":["../src/constants/ansi.const.ts","../src/features/_utils/array.utils.ts","../src/features/_utils/date.utils.ts","../src/features/_utils/event.utils.ts","../src/features/_utils/math.utils.ts","../src/features/_utils/number.utils.ts","../src/features/_utils/string.utils.ts"],"sourcesContent":["export const ANSI = {\n\tfg: {\n\t\tblack: \"\\u001b[30m\",\n\t\tred: \"\\u001b[31m\",\n\t\tgreen: \"\\u001b[32m\",\n\t\tyellow: \"\\u001b[33m\",\n\t\tblue: \"\\u001b[34m\",\n\t\tmagenta: \"\\u001b[35m\",\n\t\tcyan: \"\\u001b[36m\",\n\t\twhite: \"\\u001b[37m\",\n\t},\n\tbg: {\n\n\t},\n\tdecoration: {\n\t\tdim: \"\\u001b[2m\",\n\t\tbold: \"\\u001b[1m\",\n\t},\n\treset: \"\\u001b[0m\",\n};","export function removeFromArray<Type>(item: Type, array: Type[]) {\n\tconst index = array.indexOf(item);\n\tif (index !== -1) {\n\t\tarray.splice(index, 1);\n\t}\n}\n\nexport function randomFromArray<Type>(array: Type[]): Type {\n\treturn array[Math.floor(Math.random() * array.length)];\n}\n\nexport function removeDuplicatesFromArray<Type>(array: Type[]): Type[] {\n\treturn array.filter((item, index) => array.indexOf(item) === index);\n}","const TIME_INDICATORS = {\n\t\"s\": 1000,\n\t\"m\": 1000 * 60,\n\t\"h\": 1000 * 60 * 60,\n\t\"d\": 1000 * 60 * 60 * 24,\n\t\"w\": 1000 * 60 * 60 * 24 * 7,\n\t\"n\": 1000 * 60 * 60 * 24 * 31,\n\t\"y\": 1000 * 60 * 60 * 24 * 365,\n\t\"c\": 1000 * 60 * 60 * 24 * 365 * 100,\n};\n\n/**\n * Format a time\n * @param time - Time in milliseconds\n * @param maxLength - The maximum amount of units, e.g.: 3 => years, months, days\n */\nexport function formatTime(time: number, maxLength: number = 3, allowAffixes: boolean): string {\n\tconst result: string[] = [];\n\n\tconst formatResult = (result: string[], inPast: boolean): string => {\n\t\tif (!allowAffixes)\n\t\t\treturn result.join(\", \");\n\n\t\tlet prefix = \"\";\n\t\tlet suffix = \"\";\n\n\t\tif (inPast) {\n\t\t\tsuffix = \"ago\";\n\t\t} else {\n\t\t\tprefix = \"in\";\n\t\t}\n\n\t\treturn [prefix, result.join(\", \"), suffix].join(\" \").trim();\n\t};\n\n\tlet inPast = false;\n\n\tif (time < 0) {\n\t\ttime = -time;\n\t\tinPast = true;\n\t}\n\n\tif (Math.abs(time) < TIME_INDICATORS.s) {\n\t\treturn formatResult([\"less than a second\"], inPast);\n\t}\n\n\tconst units: { amount: number, label: string }[] = [];\n\tconst unitLabels: Record<string, string> = {\n\t\t\"s\": \"seconds\",\n\t\t\"m\": \"minutes\",\n\t\t\"h\": \"hours\",\n\t\t\"d\": \"days\",\n\t\t\"n\": \"months\",\n\t\t\"y\": \"years\",\n\t};\n\n\tfor (const [key, value] of Object.entries(TIME_INDICATORS).reverse()) {\n\t\tif (key === \"w\" || key === \"c\")\n\t\t\tcontinue;\n\n\t\tconst amount = Math.floor(time / value);\n\t\ttime -= amount * value;\n\n\t\tif (amount > 0)\n\t\t\tunits.push({ amount, label: unitLabels[key] });\n\t}\n\n\tfor (let i = 0; i < maxLength; i++) {\n\t\tconst unit = units[i];\n\n\t\tif (unit)\n\t\t\tresult.push(`${unit.amount} ${unit.label}`);\n\t}\n\n\tif (result.length === 0) {\n\t\treturn formatResult([\"less than a second\"], inPast);\n\t} else {\n\t\treturn formatResult(result, inPast);\n\t}\n};\n\n/**\n * Format a time relative to now\n * @param date - The date\n * @param maxLength - The maximum amount of units, e.g.: 3 => years, months, days\n */\nexport function formatRelativeTime(date: Date, maxLength: number = 3, allowAffixes: boolean): string {\n\tconst difference = date.valueOf() - Date.now();\n\treturn formatTime(difference, maxLength, allowAffixes);\n};","export type EventNamesMap = Record<string, string>;\nexport type Listener = (data: unknown) => void;\n\nexport class EventEmitter<EventMap extends EventNamesMap> {\n\tstatic EVENT_NAMES: EventNamesMap = {};\n\n\t#events: Record<string, Array<Listener>> = {};\n\n\t/**\n\t * Add event listener for an event\n\t */\n\ton<Key extends keyof EventMap>(eventName: Key, callback: Listener) {\n\t\tif (!this.#events[eventName as string]) {\n\t\t\tthis.#events[eventName as string] = [];\n\t\t}\n\t\tthis.#events[eventName as string].push(callback);\n\t\treturn callback;\n\t}\n\t\n\t/**\n\t * Remove event listener for an event\n\t */\n\toff<Key extends keyof EventMap>(eventName: Key, callback: Listener) {\n\t\tif (this.#events[eventName as string]) {\n\t\t\tthis.#events[eventName as string] = this.#events[eventName as string].filter(\n\t\t\t\t(listener) => listener !== callback\n\t\t\t);\n\t\t}\n\t}\n\t\n\t/**\n\t * Dispatch event\n\t */\n\temit<Key extends keyof EventMap>(eventName: Key, data?: unknown) {\n\t\tif (this.#events[eventName as string]) {\n\t\t\tthis.#events[eventName as string].forEach((listener) => {\n\t\t\t\tlistener(data);\n\t\t\t});\n\t\t}\n\t}\n}","export function clamp(value: number, min: number, max: number): number {\n\tif (value < min) {\n\t\treturn min;\n\t} else if (value > max) {\n\t\treturn max;\n\t} else {\n\t\treturn value;\n\t}\n}\n\nexport function randomRange(min: number, max: number): number {\n\treturn Math.random() * (max - min) + min;\n}\n\nexport function round(value: number, precision: number): number {\n\tconst multiplier = Math.pow(10, precision || 0);\n\treturn Math.round(value * multiplier) / multiplier;\n}","export function isValidInteger(number: number | string): number | boolean {\n\treturn (typeof number === \"number\" || parseInt(number) || parseInt(number) === 0);\n}","export function parseBool(input: string) {\r\n\treturn input.trim().toLowerCase() === \"true\";\r\n}"],"names":["ANSI","removeFromArray","item","array","index","randomFromArray","removeDuplicatesFromArray","TIME_INDICATORS","formatTime","time","maxLength","allowAffixes","result","formatResult","inPast","prefix","suffix","units","unitLabels","key","value","amount","i","unit","formatRelativeTime","date","difference","_events","EventEmitter","__privateAdd","eventName","callback","__privateGet","listener","data","__publicField","clamp","min","max","randomRange","round","precision","multiplier","isValidInteger","number","parseBool","input"],"mappings":"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"}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@prozilla-os/shared",
   "description": "A library of shared utility functions for ProzillaOS packages.",
-  "version": "1.1.1",
+  "version": "1.2.1",
   "homepage": "https://os.prozilla.dev",
   "author": {
     "name": "Prozilla",
     "email": "business@prozilla.dev",
     "url": "https://prozilla.dev/"
   },
+  "funding": "https://ko-fi.com/prozilla",
   "type": "module",
   "main": "dist/main.js",
   "types": "dist/main.d.ts",
@@ -17,13 +18,12 @@
     "directory": "packages/shared"
   },
   "license": "MIT",
-  "dependencies": {},
   "devDependencies": {
     "@types/node": "^20.14.5",
     "@types/react": "^18.3.3",
     "@vitejs/plugin-react-swc": "^3.7.0",
-    "typescript": "^5.4.5",
-    "vite": "^5.3.1",
+    "typescript": "^5.5.4",
+    "vite": "^5.4.8",
     "vite-plugin-dts": "^3.9.1",
     "vite-plugin-lib-inject-css": "^2.1.1"
   },