@trunkjs/browser-utils 1.0.13 → 1.0.15

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## 1.0.15 (2025-08-24)
+
+This was a version bump only for browser-utils to align it with other projects, there were no code changes.
+
+## 1.0.14 (2025-08-24)
+
+This was a version bump only for browser-utils to align it with other projects, there were no code changes.
+
 ## 1.0.13 (2025-08-13)
 
 This was a version bump only for browser-utils to align it with other projects, there were no code changes.

package/index.d.ts

@@ -1,6 +1,7 @@
 export * from './lib/create-element';
 export * from './lib/Debouncer';
 export * from './lib/get-error-location';
+export * from './lib/Logger';
 export * from './lib/Stopwatch';
 export * from './lib/wait-for';
 export * from './mixins/LoggingMixin';

package/index.js

@@ -1,78 +1,96 @@
-var h = Object.defineProperty;
-var c = (e) => {
-  throw TypeError(e);
+var g = Object.defineProperty;
+var c = (t) => {
+  throw TypeError(t);
 };
-var f = (e, t, n) => t in e ? h(e, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[t] = n;
-var a = (e, t, n) => f(e, typeof t != "symbol" ? t + "" : t, n), d = (e, t, n) => t.has(e) || c("Cannot " + n);
-var o = (e, t, n) => (d(e, t, "read from private field"), n ? n.call(e) : t.get(e)), l = (e, t, n) => t.has(e) ? c("Cannot add the same private member more than once") : t instanceof WeakSet ? t.add(e) : t.set(e, n), m = (e, t, n, i) => (d(e, t, "write to private field"), i ? i.call(e, n) : t.set(e, n), n);
-function w(e, t = {}, n = []) {
+var f = (t, e, n) => e in t ? g(t, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : t[e] = n;
+var l = (t, e, n) => f(t, typeof e != "symbol" ? e + "" : e, n), d = (t, e, n) => e.has(t) || c("Cannot " + n);
+var r = (t, e, n) => (d(t, e, "read from private field"), n ? n.call(t) : e.get(t)), u = (t, e, n) => e.has(t) ? c("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(t) : e.set(t, n), m = (t, e, n, i) => (d(t, e, "write to private field"), i ? i.call(t, n) : e.set(t, n), n);
+function E(t, e = {}, n = []) {
   Array.isArray(n) || (n = [n]);
-  const i = document.createElement(e);
-  for (const s in t)
-    t[s] !== null && t[s] !== void 0 && i.setAttribute(s, t[s] !== !0 ? t[s] : "");
+  const i = document.createElement(t);
+  for (const s in e)
+    e[s] !== null && e[s] !== void 0 && i.setAttribute(s, e[s] !== !0 ? e[s] : "");
   for (const s of n)
     i.append(typeof s == "string" ? document.createTextNode(s) : s);
   return i;
 }
-class L {
+class y {
   /**
    *
    * @param delay     Debounce delay in milliseconds
    * @param max_delay Maximum delay in milliseconds, if false then no maximum delay is applied
    */
-  constructor(t, n = !1) {
-    a(this, "timeout", null);
-    a(this, "startTimeWithMs", 0);
-    this.delay = t, this.max_delay = n;
+  constructor(e, n = !1) {
+    l(this, "timeout", null);
+    l(this, "startTimeWithMs", 0);
+    this.delay = e, this.max_delay = n;
   }
   async wait() {
-    return this.startTimeWithMs === 0 && (this.startTimeWithMs = Date.now()), this.timeout && (this.max_delay === !1 || this.startTimeWithMs + this.max_delay > Date.now()) && clearTimeout(this.timeout), new Promise((t) => {
+    return this.startTimeWithMs === 0 && (this.startTimeWithMs = Date.now()), this.timeout && (this.max_delay === !1 || this.startTimeWithMs + this.max_delay > Date.now()) && clearTimeout(this.timeout), new Promise((e) => {
       this.timeout = setTimeout(() => {
-        this.startTimeWithMs = 0, t(!0);
+        this.startTimeWithMs = 0, e(!0);
       }, this.delay);
     });
   }
-  debounce(t) {
+  debounce(e) {
     this.timeout && clearTimeout(this.timeout), this.timeout = setTimeout(() => {
-      t();
+      e();
     }, this.delay);
   }
 }
-function p(e) {
-  if (typeof e.lineNumber == "number")
+function I(t) {
+  if (typeof t.lineNumber == "number")
     return {
-      file: e.fileName || e.sourceURL,
-      line: e.lineNumber,
-      column: e.columnNumber ?? void 0
+      file: t.fileName || t.sourceURL,
+      line: t.lineNumber,
+      column: t.columnNumber ?? void 0
     };
-  if (typeof e.line == "number")
+  if (typeof t.line == "number")
     return {
-      file: e.sourceURL,
-      line: e.line,
-      column: e.column
+      file: t.sourceURL,
+      line: t.line,
+      column: t.column
     };
-  const n = String(e.stack || e.message || "").split(`
+  const n = String(t.stack || t.message || "").split(`
 `), i = /(.*?)(?:\(|@)?(.*?):(\d+):(\d+)\)?$/;
   for (const s of n) {
-    const r = s.match(i);
-    if (r)
-      return { file: r[2], line: +r[3], column: +r[4] };
+    const a = s.match(i);
+    if (a)
+      return { file: a[2], line: +a[3], column: +a[4] };
   }
-  return { file: e.fileName || e.sourceURL };
+  return { file: t.fileName || t.sourceURL };
 }
-class T {
-  constructor(t, n = !0) {
-    a(this, "label");
-    a(this, "last");
-    a(this, "startTime");
-    a(this, "running", !1);
-    a(this, "enabled");
-    this.label = t, this.enabled = n, this.startTime = this.last = performance.now(), this.running = !0;
-  }
-  lap(t = "") {
+class w {
+  constructor(e, n, i = "main") {
+    this._debug = e, this.myElementId = n, this.instanceId = i;
+  }
+  log(...e) {
+    this._debug && console.log(`[LOG][ID:${this.myElementId}:${this.instanceId}]`, ...e);
+  }
+  warn(...e) {
+    console.warn(`[WARN][ID:${this.myElementId}:${this.instanceId}]`, ...e);
+  }
+  error(...e) {
+    console.error(`[ERROR][ID:${this.myElementId}:${this.instanceId}]`, ...e);
+  }
+  throwError(...e) {
+    const n = `[ERROR][ID:${this.myElementId}:${this.instanceId}] ${e.join(" ")}`;
+    throw this.error(...e), new Error(n);
+  }
+}
+class p {
+  constructor(e, n = !0) {
+    l(this, "label");
+    l(this, "last");
+    l(this, "startTime");
+    l(this, "running", !1);
+    l(this, "enabled");
+    this.label = e, this.enabled = n, this.startTime = this.last = performance.now(), this.running = !0;
+  }
+  lap(e = "") {
     if (!this.enabled) return;
     const n = performance.now(), i = (n - this.last) / 1e3;
-    this.last = n, console.debug(`[${this.label}] ${t} +${i.toFixed(3)}s`);
+    this.last = n, console.debug(`[${this.label}] ${e} +${i.toFixed(3)}s`);
   }
   elapsed() {
     return performance.now() - this.startTime;
@@ -90,43 +108,44 @@ class T {
     return this.running;
   }
 }
-function y(e, t, n) {
+function T(t, e, n) {
   return new Promise((i, s) => {
-    const r = (u) => {
-      e.removeEventListener(t, r, n), i(u);
+    const a = (h) => {
+      t.removeEventListener(e, a, n), i(h);
     };
-    e.addEventListener(t, r, n);
+    t.addEventListener(e, a, n);
   });
 }
-function E() {
-  return document.readyState === "loading" ? new Promise((e) => {
-    document.addEventListener("DOMContentLoaded", () => e());
+function $() {
+  return document.readyState === "loading" ? new Promise((t) => {
+    document.addEventListener("DOMContentLoaded", () => t());
   }) : Promise.resolve();
 }
-function v() {
-  return document.readyState === "complete" ? Promise.resolve() : new Promise((e) => {
-    window.addEventListener("load", () => e());
+function D() {
+  return document.readyState === "complete" ? Promise.resolve() : new Promise((t) => {
+    window.addEventListener("load", () => t());
   });
 }
-function D(e) {
-  return new Promise((t) => setTimeout(t, e));
+function v(t) {
+  return new Promise((e) => setTimeout(e, t));
 }
-function x(e) {
-  return new Promise((t) => {
+function R(t) {
+  return new Promise((e) => {
     const n = (i) => {
-      e.removeEventListener("animationend", n), t(i);
+      t.removeEventListener("animationend", n), e(i);
     };
-    e.addEventListener("animationend", n);
+    t.addEventListener("animationend", n);
   });
 }
-let g = 1;
-function M(e) {
-  var n, i;
-  class t extends e {
+let b = 1;
+function x(t) {
+  var n, i, s;
+  class e extends t {
     constructor() {
       super(...arguments);
-      l(this, n, null);
-      l(this, i, g++);
+      u(this, n, null);
+      u(this, i, b++);
+      u(this, s, null);
     }
     /**
      * Clears the cached debug flag so the attribute will be checked again
@@ -136,29 +155,36 @@ function M(e) {
       m(this, n, null);
     }
     get _debug() {
-      return o(this, n) !== null ? o(this, n) : (this instanceof HTMLElement && m(this, n, this.hasAttribute("debug") && !["false", "0", "off", "no"].includes(this.getAttribute("debug") || "")), o(this, n) === !0 && console.log(`[DEBUG][ID:${o(this, i)}] LoggingMixin: Debug mode is enabled for <${this.tagName}>`, this), o(this, n));
+      return r(this, n) !== null ? r(this, n) : (this instanceof HTMLElement && m(this, n, this.hasAttribute("debug") && !["false", "0", "off", "no"].includes(this.getAttribute("debug") || "")), r(this, n) === !0 && console.log(`[DEBUG][ID:${r(this, i)}] LoggingMixin: Debug mode is enabled for <${this.tagName}>`, this), r(this, n) ?? !1);
+    }
+    getLogger(o = "main") {
+      return r(this, s) || m(this, s, new w(this._debug, `${r(this, i)}`, o)), r(this, s);
+    }
+    log(...o) {
+      this.getLogger().log(...o);
     }
-    log(...u) {
-      this._debug && console.log(`[LOG][ID:${o(this, i)}]`, ...u);
+    warn(...o) {
+      this.getLogger().warn(...o);
     }
-    warn(...u) {
-      console.warn(`[WARN][ID:${o(this, i)}]`, ...u);
+    error(...o) {
+      this.getLogger().error(...o);
     }
-    error(...u) {
-      console.error(`[ERROR][ID:${o(this, i)}]`, ...u);
+    throwError(...o) {
+      return this.getLogger().throwError(...o);
     }
   }
-  return n = new WeakMap(), i = new WeakMap(), t;
+  return n = new WeakMap(), i = new WeakMap(), s = new WeakMap(), e;
 }
 export {
-  L as Debouncer,
-  M as LoggingMixin,
-  T as Stopwatch,
-  w as create_element,
-  p as getErrorLocation,
-  D as sleep,
-  y as waitFor,
-  x as waitForAnimationEnd,
-  E as waitForDomContentLoaded,
-  v as waitForLoad
+  y as Debouncer,
+  w as Logger,
+  x as LoggingMixin,
+  p as Stopwatch,
+  E as create_element,
+  I as getErrorLocation,
+  v as sleep,
+  T as waitFor,
+  R as waitForAnimationEnd,
+  $ as waitForDomContentLoaded,
+  D as waitForLoad
 };

package/lib/Logger.d.ts

@@ -0,0 +1,10 @@
+export declare class Logger {
+    private _debug;
+    private myElementId;
+    private instanceId;
+    constructor(_debug: boolean, myElementId: string, instanceId?: string);
+    log(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+    throwError(...args: any[]): never;
+}

package/mixins/LoggingMixin.d.ts

@@ -1,3 +1,4 @@
+import { Logger } from '../lib/Logger';
 type Constructor<T = object> = abstract new (...args: any[]) => T;
 /**
  * LoggingMixin
@@ -17,19 +18,27 @@ type Constructor<T = object> = abstract new (...args: any[]) => T;
  *   // or with Lit:
  *   class MyLitEl extends LoggingMixin(ReactiveElement) {}
  *
+ *
+ *   // Create a new Logger Instance
+ *   const logger = this.getLogger("loader1");
+ *   logger.log("This is a log message from loader1");
+ *
  *   <my-element debug></my-element>       // enables debug logging
  */
 export declare function LoggingMixin<TBase extends Constructor<object>>(Base: TBase): (abstract new (...args: any[]) => {
-    "__#1703@#debugCached": boolean | null;
-    "__#1703@#myElementId": number;
+    "__#1729@#debugCached": boolean | null;
+    "__#1729@#myElementId": number;
     /**
      * Clears the cached debug flag so the attribute will be checked again
      * on the next log/warn/error call.
      */
     invalidateDebugCache(): void;
-    readonly _debug: boolean | null;
+    "__#1729@#myLoggerInstance": Logger | null;
+    readonly _debug: boolean;
+    getLogger(instanceId?: string): Logger;
     log(...args: any[]): void;
     warn(...args: any[]): void;
     error(...args: any[]): void;
+    throwError(...args: any[]): never;
 }) & TBase;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@trunkjs/browser-utils",
-    "version": "1.0.13",
+    "version": "1.0.15",
     "main": "./index.js",
     "dependencies": {},
     "type": "module",