@gesslar/toolkit 3.33.0 → 3.34.0

package/package.json

@@ -5,7 +5,7 @@
     "name": "gesslar",
     "url": "https://gesslar.dev"
   },
-  "version": "3.33.0",
+  "version": "3.34.0",
   "license": "Unlicense",
   "homepage": "https://github.com/gesslar/toolkit#readme",
   "repository": {

package/src/browser/lib/Notify.js

@@ -1,7 +1,7 @@
 /**
- * Thin wrapper around `window` event handling to centralize emit/on/off
- * helpers. Used to dispatch simple CustomEvents and manage listeners in one
- * place.
+ * Thin wrapper around event dispatching to centralize emit/on/off helpers.
+ * Uses `globalThis` for safe resolution in server-side build environments
+ * (e.g. esm.sh) while defaulting to `window` at runtime.
  */
 
 /**
@@ -14,6 +14,15 @@ export class Notify {
   /** @type {string} Display name for debugging. */
   name = "Notify"
 
+  /**
+   * Returns the default event target (window or globalThis).
+   *
+   * @returns {EventTarget} The default event target.
+   */
+  get #target() {
+    return globalThis.window ?? globalThis
+  }
+
   /**
    * Emits a CustomEvent without expecting a return value.
    *
@@ -24,7 +33,7 @@ export class Notify {
    */
   emit(type, payload=undefined, options=undefined) {
     const evt = new CustomEvent(type, this.#buildEventInit(payload, options))
-    window.dispatchEvent(evt)
+    this.#target.dispatchEvent(evt)
   }
 
   /**
@@ -37,46 +46,55 @@ export class Notify {
    */
   request(type, payload={}, options=undefined) {
     const evt = new CustomEvent(type, this.#buildEventInit(payload, options))
-    window.dispatchEvent(evt)
+    this.#target.dispatchEvent(evt)
 
     return evt.detail
   }
 
   /**
-   * Registers a listener for the given event type on an HTMLElement (or
-   * window, if not specified).
+   * Registers a listener for the given event type on an EventTarget.
+   * Defaults to window when no element is provided.
    *
    * @param {string} type - Event name to listen for.
-   * @param {(evt: Notify) => void} handler - Listener callback.
-   * @param {HTMLElement | Window} [element] - The object to which to attach the handler. Default is window.
+   * @param {(evt: Event) => void} handler - Listener callback.
+   * @param {EventTarget} [element] - The target to attach the handler to. Defaults to window.
    * @param {boolean | object} [options] - Options to pass to addEventListener.
    * @returns {() => void} Dispose function to unregister the handler.
    */
-  on(type, handler, element=window, options=undefined) {
+  on(type, handler, element=undefined, options=undefined) {
     if(!(typeof type === "string" && type))
       throw new Error("No event 'type' specified to listen for.")
 
     if(typeof handler !== "function")
       throw new Error("No handler function specified.")
 
-    element.addEventListener(type, handler, options)
+    const target = element ?? this.#target
+    target.addEventListener(type, handler, options)
 
-    return () => this.off(type, handler, element, options)
+    return () => this.off(type, handler, target, options)
   }
 
   /**
    * Removes a previously registered listener for the given event type.
    *
    * @param {string} type - Event name to remove.
-   * @param {(evt: Notify) => void} handler - Listener callback to detach.
-   * @param {HTMLElement | Window} [element] - The object from which to remove the handler. Default is window.
+   * @param {(evt: Event) => void} handler - Listener callback to detach.
+   * @param {EventTarget} [element] - The target to remove the handler from. Defaults to window.
    * @param {boolean | object} [options] - Options to pass to removeEventListener.
    * @returns {void}
    */
-  off(type, handler, element=window, options=undefined) {
-    element.removeEventListener(type, handler, options)
+  off(type, handler, element=undefined, options=undefined) {
+    const target = element ?? this.#target
+    target.removeEventListener(type, handler, options)
   }
 
+  /**
+   * Builds the CustomEvent init object from detail and options.
+   *
+   * @param {unknown} detail - The event detail payload.
+   * @param {boolean | NotifyEventOptions} [options] - Event options.
+   * @returns {object} The event init object.
+   */
   #buildEventInit(detail, options) {
     if(typeof options === "boolean")
       return {detail, bubbles: options}

package/src/browser/lib/Valid.js

@@ -23,8 +23,7 @@ export default class Valid {
   static type(value, type, options) {
     Valid.assert(
       Data.isType(value, type, options),
-      `Invalid type. Expected ${type}, got ${JSON.stringify(value)}`,
-      1,
+      `Invalid type. Expected ${type}, got ${Data.typeOf(value)}`
     )
   }
 

package/types/browser/lib/Notify.d.ts

@@ -1,7 +1,7 @@
 /**
- * Thin wrapper around `window` event handling to centralize emit/on/off
- * helpers. Used to dispatch simple CustomEvents and manage listeners in one
- * place.
+ * Thin wrapper around event dispatching to centralize emit/on/off helpers.
+ * Uses `globalThis` for safe resolution in server-side build environments
+ * (e.g. esm.sh) while defaulting to `window` at runtime.
  */
 /**
  * @typedef {object} NotifyEventOptions
@@ -31,26 +31,26 @@ export class Notify {
      */
     request(type: string, payload?: unknown, options?: boolean | NotifyEventOptions): unknown;
     /**
-     * Registers a listener for the given event type on an HTMLElement (or
-     * window, if not specified).
+     * Registers a listener for the given event type on an EventTarget.
+     * Defaults to window when no element is provided.
      *
      * @param {string} type - Event name to listen for.
-     * @param {(evt: Notify) => void} handler - Listener callback.
-     * @param {HTMLElement | Window} [element] - The object to which to attach the handler. Default is window.
+     * @param {(evt: Event) => void} handler - Listener callback.
+     * @param {EventTarget} [element] - The target to attach the handler to. Defaults to window.
      * @param {boolean | object} [options] - Options to pass to addEventListener.
      * @returns {() => void} Dispose function to unregister the handler.
      */
-    on(type: string, handler: (evt: Notify) => void, element?: HTMLElement | Window, options?: boolean | object): () => void;
+    on(type: string, handler: (evt: Event) => void, element?: EventTarget, options?: boolean | object): () => void;
     /**
      * Removes a previously registered listener for the given event type.
      *
      * @param {string} type - Event name to remove.
-     * @param {(evt: Notify) => void} handler - Listener callback to detach.
-     * @param {HTMLElement | Window} [element] - The object from which to remove the handler. Default is window.
+     * @param {(evt: Event) => void} handler - Listener callback to detach.
+     * @param {EventTarget} [element] - The target to remove the handler from. Defaults to window.
      * @param {boolean | object} [options] - Options to pass to removeEventListener.
      * @returns {void}
      */
-    off(type: string, handler: (evt: Notify) => void, element?: HTMLElement | Window, options?: boolean | object): void;
+    off(type: string, handler: (evt: Event) => void, element?: EventTarget, options?: boolean | object): void;
     #private;
 }
 declare const _default: Notify;

package/types/browser/lib/Notify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Notify.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Notify.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH;IACE,iDAAiD;IACjD,MADW,MAAM,CACF;IAEf;;;;;;;OAOG;IACH,WALW,MAAM,YACN,OAAO,YACP,OAAO,GAAG,kBAAkB,GAC1B,IAAI,CAKhB;IAED;;;;;;;OAOG;IACH,cALW,MAAM,YACN,OAAO,YACP,OAAO,GAAG,kBAAkB,GAC1B,OAAO,CAOnB;IAED;;;;;;;;;OASG;IACH,SANW,MAAM,WACN,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,YACrB,WAAW,GAAG,MAAM,YACpB,OAAO,GAAG,MAAM,GACd,MAAM,IAAI,CAYtB;IAED;;;;;;;;OAQG;IACH,UANW,MAAM,WACN,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,YACrB,WAAW,GAAG,MAAM,YACpB,OAAO,GAAG,MAAM,GACd,IAAI,CAIhB;;CAWF;;;;;;;cAhFa,OAAO;;;;iBACP,OAAO;;;;eACP,OAAO"}
+{"version":3,"file":"Notify.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Notify.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH;IACE,iDAAiD;IACjD,MADW,MAAM,CACF;IAWf;;;;;;;OAOG;IACH,WALW,MAAM,YACN,OAAO,YACP,OAAO,GAAG,kBAAkB,GAC1B,IAAI,CAKhB;IAED;;;;;;;OAOG;IACH,cALW,MAAM,YACN,OAAO,YACP,OAAO,GAAG,kBAAkB,GAC1B,OAAO,CAOnB;IAED;;;;;;;;;OASG;IACH,SANW,MAAM,WACN,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,YACpB,WAAW,YACX,OAAO,GAAG,MAAM,GACd,MAAM,IAAI,CAatB;IAED;;;;;;;;OAQG;IACH,UANW,MAAM,WACN,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,YACpB,WAAW,YACX,OAAO,GAAG,MAAM,GACd,IAAI,CAKhB;;CAkBF;;;;;;;cAlGa,OAAO;;;;iBACP,OAAO;;;;eACP,OAAO"}

package/types/browser/lib/Valid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Valid.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Valid.js"],"names":[],"mappings":"AAWA;;GAEG;AACH;IACE;;;;;;OAMG;IACH,mBAJW,OAAO,QACP,MAAM,YACN,MAAM,QAQhB;IAED;;;;;;;;OAQG;IACH,yBANW,OAAO,WACP,MAAM,QAEN,MAAM,QAkBhB;IAED,+CAAmE;IAEnE;;;;;;OAMG;IACH,0CAHW,KAAK,CAAC,MAAM,CAAC,QAYvB;CACF"}
+{"version":3,"file":"Valid.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Valid.js"],"names":[],"mappings":"AAWA;;GAEG;AACH;IACE;;;;;;OAMG;IACH,mBAJW,OAAO,QACP,MAAM,YACN,MAAM,QAOhB;IAED;;;;;;;;OAQG;IACH,yBANW,OAAO,WACP,MAAM,QAEN,MAAM,QAkBhB;IAED,+CAAmE;IAEnE;;;;;;OAMG;IACH,0CAHW,KAAK,CAAC,MAAM,CAAC,QAYvB;CACF"}