@d1g1tal/subscribr 3.0.5 → 4.0.1

package/LICENSE

@@ -1,12 +1,12 @@
-Copyright (c) 2023, Jason DiMeo
-
-Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided
-that the above copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE
-INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE
-FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
-ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-
+Copyright (c) 2023, Jason DiMeo
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided
+that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE
+INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE
+FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
+ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
 Source: http://opensource.org/licenses/ISC

package/README.md

@@ -1,75 +1,75 @@
-# subscribr
-JavaScript Publish/Subscribe
-
-This simple class enables you to subscribe and publish events using the Observer pattern.
-
-Basically, you subscribe your event handler using the `Subscribr` instance and are returned a `Subscription` instance.
-
-When the event is published, your event handler will be called.
-
-### Installation:
-```bash
-# Install with pnpm
-pnpm install @d1g1tal/subscribr
-
-# Install with NPM
-npm install @d1g1tal/subscribr
-```
-Or Script tags from downloaded script or from a NPM CDN like jsDelivr
-
-```html
-<!-- Load as global script -->
-<script src="/subscribr/dist/iife/subscribr.min.js"></script>
-
-<!-- Load from CDN -->
-<script src="https://cdn.jsdelivr.net/npm/@d1g1tal/subscribr@3/dist/iife/subscribr.min.js"></script>
-
-<!-- Load as ES Module -->
-<script type="module">
-	import Subscribr from '/app/js/subscribr.min.js';
-</script>
-
-<!-- Load from CDN -->
-<script type="module">
-	import Subscribr from 'https://cdn.jsdelivr.net/npm/@d1g1tal/subscribr@3/dist/subscribr.min.js';
-</script>
-```
-
-### Usage:
-```javascript
-// ES Module
-import Subscribr from '@d1g1tal/subscribr';
-
-const subscribr = new Subscribr();
-const eventName = 'myEvent';
-
-// Subscribr.prototype.subscribe returns a Subscription object.
-const mySubscription = subscribr.subscribe(eventName, (event, data) => console.log(`Event: '${event.type}' published with data: ${data}`));
-
-// Publish the event with just the name and a CustomEvent will be created with the eventName. All handlers that have subscribed are called
-subscribr.publish(eventName, { foo: 'bar', zip: 'fizz' }); // Event: 'myEvent' published with data: { foo: 'bar', zip: 'fizz' }
-
-// Is the event subscribed?
-const isSubscribed = subscribr.isSubscribed(mySubscription); // true
-
-const isUnsubscribed = subscribr.unsubscribe(mySubscription); // true
-
-const isSubscribed = subscribr.isSubscribed(mySubscription); // false
-
-
-// Subscribe to a DOM event
-const eventTargetSubscription = subsribr.subscribe('eventTargetChanged', (event, data) => console.log(`Event target changed with data: ${data}`));
-
-// Add some event to an event target (DOMElement)
-new EventTarget().addEventListener('change', function(event) {
-	// Publish the event and all handlers that have subscribed are called
-	subscribr.publish('eventTargetChanged', event, { value: this.value }); // Event target changed with data: {value: 'new value'}
-});
-
-// Is the event subscribed?
-const isSubscribed = subscribr.isSubscribed(eventTargetSubscription); // true
-
-const isUnsubscribed = subscribr.unsubscribe(eventTargetSubscription); // true
-
-const isSubscribed = subscribr.isSubscribed(eventTargetSubscription); // false
+# subscribr
+JavaScript Publish/Subscribe
+
+This simple class enables you to subscribe and publish events using the Observer pattern.
+
+Basically, you subscribe your event handler using the `Subscribr` instance and are returned a `Subscription` instance.
+
+When the event is published, your event handler will be called.
+
+### Installation:
+```bash
+# Install with pnpm
+pnpm install @d1g1tal/subscribr
+
+# Install with NPM
+npm install @d1g1tal/subscribr
+```
+Or Script tags from downloaded script or from a NPM CDN like jsDelivr
+
+```html
+<!-- Load as global script -->
+<script src="/subscribr/dist/iife/subscribr.min.js"></script>
+
+<!-- Load from CDN -->
+<script src="https://cdn.jsdelivr.net/npm/@d1g1tal/subscribr@3/dist/iife/subscribr.min.js"></script>
+
+<!-- Load as ES Module -->
+<script type="module">
+	import Subscribr from '/app/js/subscribr.min.js';
+</script>
+
+<!-- Load from CDN -->
+<script type="module">
+	import Subscribr from 'https://cdn.jsdelivr.net/npm/@d1g1tal/subscribr@3/dist/subscribr.min.js';
+</script>
+```
+
+### Usage:
+```javascript
+// ES Module
+import Subscribr from '@d1g1tal/subscribr';
+
+const subscribr = new Subscribr();
+const eventName = 'myEvent';
+
+// Subscribr.prototype.subscribe returns a Subscription object.
+const mySubscription = subscribr.subscribe(eventName, (event, data) => console.log(`Event: '${event.type}' published with data: ${data}`));
+
+// Publish the event with just the name and a CustomEvent will be created with the eventName. All handlers that have subscribed are called
+subscribr.publish(eventName, { foo: 'bar', zip: 'fizz' }); // Event: 'myEvent' published with data: { foo: 'bar', zip: 'fizz' }
+
+// Is the event subscribed?
+const isSubscribed = subscribr.isSubscribed(mySubscription); // true
+
+const isUnsubscribed = subscribr.unsubscribe(mySubscription); // true
+
+const isSubscribed = subscribr.isSubscribed(mySubscription); // false
+
+
+// Subscribe to a DOM event
+const eventTargetSubscription = subsribr.subscribe('eventTargetChanged', (event, data) => console.log(`Event target changed with data: ${data}`));
+
+// Add some event to an event target (DOMElement)
+new EventTarget().addEventListener('change', function(event) {
+	// Publish the event and all handlers that have subscribed are called
+	subscribr.publish('eventTargetChanged', event, { value: this.value }); // Event target changed with data: {value: 'new value'}
+});
+
+// Is the event subscribed?
+const isSubscribed = subscribr.isSubscribed(eventTargetSubscription); // true
+
+const isUnsubscribed = subscribr.unsubscribe(eventTargetSubscription); // true
+
+const isSubscribed = subscribr.isSubscribed(eventTargetSubscription); // false
 ```

package/dist/subscribr.d.ts

@@ -0,0 +1,109 @@
+/** Context event listener function. */
+type ContextEventListener = (event: Event, data?: unknown) => void;
+
+/** A wrapper for an event handler that binds a context to the event handler. */
+declare class ContextEventHandler {
+    private readonly context;
+    private readonly eventListener;
+    /**
+     * @param {unknown} context The context to bind to the event handler.
+     * @param {ContextEventListener} eventListener The event handler to call when the event is published.
+     */
+    constructor(context: unknown, eventListener: ContextEventListener);
+    /**
+     * Call the event handler for the provided event.
+     *
+     * @param {Event} event The event to handle
+     * @param {unknown?} [data] The value to be passed to the event handler as a parameter.
+     */
+    handle(event: Event, data?: unknown): void;
+    /**
+     * A String value that is used in the creation of the default string
+     * description of an object. Called by the built-in method {@link Object.prototype.toString}.
+     *
+     * @returns {string} The default string description of this object.
+     */
+    get [Symbol.toStringTag](): string;
+}
+
+/** Represents a subscription to an event. */
+declare class Subscription {
+    private readonly _eventName;
+    private readonly _contextEventHandler;
+    /**
+     * @param {string} eventName The event name.
+     * @param {ContextEventHandler} contextEventHandler Then context event handler.
+     */
+    constructor(eventName: string, contextEventHandler: ContextEventHandler);
+    /**
+     * Gets the event name for the subscription.
+     *
+     * @returns {string} The event name.
+     */
+    get eventName(): string;
+    /**
+     * Gets the context event handler.
+     *
+     * @returns {ContextEventHandler} The context event handler
+     */
+    get contextEventHandler(): ContextEventHandler;
+    /**
+     * A String value that is used in the creation of the default string
+     * description of an object. Called by the built-in method {@link Object.prototype.toString}.
+     *
+     * @returns {string} The default string description of this object.
+     */
+    get [Symbol.toStringTag](): string;
+}
+
+/**
+ * A class that allows objects to subscribe to events and be notified when the event is published.
+ *
+ * @class
+ * @exports Subscribr
+ */
+declare class Subscribr {
+    private readonly subscribers;
+    constructor();
+    /**
+     * Subscribe to an event
+     *
+     * @param {string} eventName The event name to subscribe to.
+     * @param {ContextEventListener} eventHandler The event handler to call when the event is published.
+     * @param {unknown} [context] The context to bind to the event handler.
+     * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.
+     */
+    subscribe(eventName: string, eventHandler: ContextEventListener, context?: unknown): Subscription;
+    /**
+     * Unsubscribe from the event
+     *
+     * @param {Subscription} subscription The subscription to unsubscribe.
+     * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.
+     */
+    unsubscribe({ eventName, contextEventHandler }: Subscription): boolean;
+    /**
+     * Publish an event
+     *
+     * @template T
+     * @param {string} eventName The name of the event.
+     * @param {Event} [event=new CustomEvent(eventName)] The event to be handled.
+     * @param {T} [data] The value to be passed to the event handler as a parameter.
+     */
+    publish<T>(eventName: string, event?: Event, data?: T): void;
+    /**
+     * Check if the event and handler are subscribed.
+     *
+     * @param {Subscription} subscription The subscription object.
+     * @returns {boolean} true if the event name and handler are subscribed, false otherwise.
+     */
+    isSubscribed({ eventName, contextEventHandler }: Subscription): boolean;
+    /**
+     * A String value that is used in the creation of the default string
+     * description of an object. Called by the built-in method {@link Object.prototype.toString}.
+     *
+     * @returns {string} The default string description of this object.
+     */
+    get [Symbol.toStringTag](): string;
+}
+
+export { ContextEventHandler, type ContextEventListener, Subscribr, Subscription };

package/dist/subscribr.js

@@ -1,171 +1,2 @@
-// node_modules/.pnpm/@d1g1tal+collections@1.0.1/node_modules/@d1g1tal/collections/src/set-multi-map.js
-var SetMultiMap = class extends Map {
-  /**
-   * Adds a new element with a specified key and value to the SetMultiMap.
-   * If an element with the same key already exists, the value will be added to the underlying {@link Set}.
-   * If the value already exists in the {@link Set}, it will not be added again.
-   *
-   * @param {K} key The key to set.
-   * @param {V} value The value to add to the SetMultiMap
-   * @returns {SetMultiMap<K, V>} The SetMultiMap with the updated key and value.
-   */
-  set(key, value) {
-    super.set(key, (super.get(key) ?? /* @__PURE__ */ new Set()).add(value));
-    return this;
-  }
-  /**
-   * Checks if a specific key has a specific value.
-   *
-   * @param {K} key The key to check.
-   * @param {V} value The value to check.
-   * @returns {boolean} True if the key has the value, false otherwise.
-   */
-  hasValue(key, value) {
-    const values = super.get(key);
-    return values ? values.has(value) : false;
-  }
-  /**
-   * Removes a specific value from a specific key.
-   *
-   * @param {K} key The key to remove the value from.
-   * @param {V} value The value to remove.
-   * @returns {boolean} True if the value was removed, false otherwise.
-   */
-  deleteValue(key, value) {
-    const values = super.get(key);
-    if (values) {
-      return values.delete(value);
-    }
-    return false;
-  }
-  get [Symbol.toStringTag]() {
-    return "SetMultiMap";
-  }
-};
-
-// src/context-event-handler.js
-var ContextEventHandler = class {
-  #context;
-  #eventHandler;
-  /**
-   * @param {*} context The context to bind to the event handler.
-   * @param {function(*): void} eventHandler The event handler to call when the event is published.
-   */
-  constructor(context, eventHandler) {
-    this.#context = context;
-    this.#eventHandler = eventHandler;
-  }
-  /**
-   * Call the event handler for the provided event.
-   *
-   * @param {Event} event The event to handle
-   * @param {*} [data] The value to be passed to the event handler as a parameter.
-   */
-  handle(event, data) {
-    this.#eventHandler.call(this.#context, event, data);
-  }
-  get [Symbol.toStringTag]() {
-    return "ContextEventHandler";
-  }
-};
-
-// src/subscription.js
-var Subscription = class {
-  #eventName;
-  #contextEventHandler;
-  /**
-   * @param {string} eventName The event name.
-   * @param {ContextEventHandler} contextEventHandler Then context event handler.
-   */
-  constructor(eventName, contextEventHandler) {
-    this.#eventName = eventName;
-    this.#contextEventHandler = contextEventHandler;
-  }
-  /**
-   * Gets the event name for the subscription.
-   *
-   * @returns {string} The event name.
-   */
-  get eventName() {
-    return this.#eventName;
-  }
-  /**
-   * Gets the context event handler.
-   *
-   * @returns {ContextEventHandler} The context event handler
-   */
-  get contextEventHandler() {
-    return this.#contextEventHandler;
-  }
-  get [Symbol.toStringTag]() {
-    return "Subscription";
-  }
-};
-
-// src/subscribr.js
-var Subscribr = class {
-  /** @type {SetMultiMap<string, ContextEventHandler>} */
-  #subscribers;
-  constructor() {
-    this.#subscribers = new SetMultiMap();
-  }
-  /**
-   * Subscribe to an event
-   *
-   * @param {string} eventName The event name to subscribe to.
-   * @param {function(Event, *): void} eventHandler The event handler to call when the event is published.
-   * @param {*} [context] The context to bind to the event handler.
-   * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.
-   */
-  subscribe(eventName, eventHandler, context = eventHandler) {
-    const contextEventHandler = new ContextEventHandler(context, eventHandler);
-    this.#subscribers.set(eventName, contextEventHandler);
-    return new Subscription(eventName, contextEventHandler);
-  }
-  /**
-   * Unsubscribe from the event
-   *
-   * @param {Subscription} subscription The subscription to unsubscribe.
-   * @param {string} subscription.eventName The event name to subscribe to.
-   * @param {ContextEventHandler} subscription.contextEventHandler The event handler to call when the event is published.
-   * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.
-   */
-  unsubscribe({ eventName, contextEventHandler }) {
-    const contextEventHandlers = this.#subscribers.get(eventName);
-    const removed = contextEventHandlers?.delete(contextEventHandler);
-    if (removed && contextEventHandlers.size === 0) {
-      this.#subscribers.delete(eventName);
-    }
-    return removed;
-  }
-  /**
-   * Publish an event
-   *
-   * @param {string} eventName The name of the event.
-   * @param {Event} [event=new CustomEvent(eventName)] The event to be handled.
-   * @param {*} [data] The value to be passed to the event handler as a parameter.
-   */
-  publish(eventName, event = new CustomEvent(eventName), data) {
-    if (data == null && !(event instanceof Event)) {
-      [data, event] = [event, new CustomEvent(eventName)];
-    }
-    this.#subscribers.get(eventName)?.forEach((contextEventHandler) => contextEventHandler.handle(event, data));
-  }
-  /**
-   * Check if the event and handler are subscribed.
-   *
-   * @param {Subscription} subscription The subscription object.
-   * @param {string} subscription.eventName The name of the event to check.
-   * @param {ContextEventHandler} subscription.contextEventHandler The event handler to check.
-   * @returns {boolean} true if the event name and handler are subscribed, false otherwise.
-   */
-  isSubscribed({ eventName, contextEventHandler }) {
-    return this.#subscribers.get(eventName)?.has(contextEventHandler);
-  }
-  get [Symbol.toStringTag]() {
-    return "Subscribr";
-  }
-};
-export {
-  Subscribr as default
-};
+var s=class extends Map{set(e,t){return super.set(e,(super.get(e)??new Set).add(t)),this}hasValue(e,t){let n=super.get(e);return n?n.has(t):!1}find(e,t){let n=this.get(e);if(n!==void 0)return Array.from(n).find(t)}deleteValue(e,t){if(t===void 0)return this.delete(e);let n=super.get(e);if(n){let i=n.delete(t);return n.size===0&&super.delete(e),i}return!1}get[Symbol.toStringTag](){return"SetMultiMap"}};var r=class{context;eventListener;constructor(e,t){this.context=e,this.eventListener=t}handle(e,t){this.eventListener.call(this.context,e,t)}get[Symbol.toStringTag](){return"ContextEventHandler"}};var l=class{_eventName;_contextEventHandler;constructor(e,t){this._eventName=e,this._contextEventHandler=t}get eventName(){return this._eventName}get contextEventHandler(){return this._contextEventHandler}get[Symbol.toStringTag](){return"Subscription"}};var u=class{subscribers;constructor(){this.subscribers=new s}subscribe(e,t,n=t){let i=new r(n,t);return this.subscribers.set(e,i),new l(e,i)}unsubscribe({eventName:e,contextEventHandler:t}){let n=this.subscribers.get(e)??new Set,i=n.delete(t);return i&&n.size===0&&this.subscribers.delete(e),i}publish(e,t=new CustomEvent(e),n){this.subscribers.get(e)?.forEach(i=>i.handle(t,n))}isSubscribed({eventName:e,contextEventHandler:t}){return this.subscribers.get(e)?.has(t)??!1}get[Symbol.toStringTag](){return"Subscribr"}};export{r as ContextEventHandler,u as Subscribr,l as Subscription};
+//# sourceMappingURL=subscribr.js.map

package/dist/subscribr.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../node_modules/.pnpm/@d1g1tal+collections@2.0.2_typescript@5.6.2/node_modules/@d1g1tal/collections/src/set-multi-map.ts", "../src/context-event-handler.ts", "../src/subscription.ts", "../src/subscribr.ts"],
+  "sourcesContent": ["/** A {@link Map} that can contain multiple, unique, values for the same key. */\nexport class SetMultiMap<K, V> extends Map<K, Set<V>>{\n\t/**\n\t * Adds a new element with a specified key and value to the SetMultiMap.\n\t * If an element with the same key already exists, the value will be added to the underlying {@link Set}.\n\t * If the value already exists in the {@link Set}, it will not be added again.\n\t *\n\t * @param {K} key The key to set.\n\t * @param {V} value The value to add to the SetMultiMap\n\t * @returns {SetMultiMap<K, V>} The SetMultiMap with the updated key and value.\n\t */\n\t// @ts-expect-error I am overriding the set method from the Map class\n\toverride set(key: K, value: V): SetMultiMap<K, V> {\n\t\tsuper.set(key, (super.get(key) ?? new Set()).add(value));\n\n\t\treturn this;\n\t}\n\n\t/**\n\t * Checks if a specific key has a specific value.\n\t *\n\t * @param {K} key The key to check.\n\t * @param {V} value The value to check.\n\t * @returns {boolean} True if the key has the value, false otherwise.\n\t */\n\thasValue(key: K, value: V): boolean {\n\t\tconst values = super.get(key);\n\n\t\treturn values ? values.has(value) : false;\n\t}\n\n\tfind(key: K, iterator: (value: V) => boolean): V | undefined {\n\t\tconst values = this.get(key);\n\n\t\tif (values !== undefined) {\n\t\t\treturn Array.from(values).find(iterator);\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Removes a specific value from a specific key.\n\t *\n\t * @param {K} key The key to remove the value from.\n\t * @param {V | undefined} value The value to remove.\n\t * @returns {boolean} True if the value was removed, false otherwise.\n\t */\n\tdeleteValue(key: K, value: V | undefined): boolean {\n\t\tif (value === undefined) { return this.delete(key) }\n\n\t\tconst values = super.get(key);\n\t\tif (values) {\n\t\t\tconst deleted = values.delete(value);\n\n\t\t\tif (values.size === 0) {\n\t\t\t\tsuper.delete(key);\n\t\t\t}\n\n\t\t\treturn deleted;\n\t\t}\n\n\t\treturn false;\n\t}\n\n\toverride get [Symbol.toStringTag](): string {\n\t\treturn 'SetMultiMap';\n\t}\n}", "import type { ContextEventListener } from './@types';\n\n/** A wrapper for an event handler that binds a context to the event handler. */\nexport class ContextEventHandler {\n\tprivate readonly context: unknown;\n\tprivate readonly eventListener: ContextEventListener;\n\n\t/**\n\t * @param {unknown} context The context to bind to the event handler.\n\t * @param {ContextEventListener} eventListener The event handler to call when the event is published.\n\t */\n\tconstructor(context: unknown, eventListener: ContextEventListener) {\n\t\tthis.context = context;\n\t\tthis.eventListener = eventListener;\n\t}\n\n\t/**\n\t * Call the event handler for the provided event.\n\t *\n\t * @param {Event} event The event to handle\n\t * @param {unknown?} [data] The value to be passed to the event handler as a parameter.\n\t */\n\thandle(event: Event, data?: unknown): void {\n\t\tthis.eventListener.call(this.context, event, data);\n\t}\n\n\t/**\n\t * A String value that is used in the creation of the default string\n\t * description of an object. Called by the built-in method {@link Object.prototype.toString}.\n\t *\n\t * @returns {string} The default string description of this object.\n\t */\n\tget [Symbol.toStringTag](): string {\n\t\treturn 'ContextEventHandler';\n\t}\n}", "import type { ContextEventHandler } from './context-event-handler';\n\n/** Represents a subscription to an event. */\nexport class Subscription {\n\tprivate readonly _eventName: string;\n\tprivate readonly _contextEventHandler: ContextEventHandler;\n\n\t/**\n\t * @param {string} eventName The event name.\n\t * @param {ContextEventHandler} contextEventHandler Then context event handler.\n\t */\n\tconstructor(eventName: string, contextEventHandler: ContextEventHandler) {\n\t\tthis._eventName = eventName;\n\t\tthis._contextEventHandler = contextEventHandler;\n\t}\n\n\t/**\n\t * Gets the event name for the subscription.\n\t *\n\t * @returns {string} The event name.\n\t */\n\tget eventName(): string {\n\t\treturn this._eventName;\n\t}\n\n\t/**\n\t * Gets the context event handler.\n\t *\n\t * @returns {ContextEventHandler} The context event handler\n\t */\n\tget contextEventHandler(): ContextEventHandler {\n\t\treturn this._contextEventHandler;\n\t}\n\n\t/**\n\t * A String value that is used in the creation of the default string\n\t * description of an object. Called by the built-in method {@link Object.prototype.toString}.\n\t *\n\t * @returns {string} The default string description of this object.\n\t */\n\tget [Symbol.toStringTag](): string {\n\t\treturn 'Subscription';\n\t}\n}", "import { SetMultiMap } from '@d1g1tal/collections/src';\nimport { ContextEventHandler } from './context-event-handler';\nimport { Subscription } from './subscription';\nimport type { ContextEventListener } from './@types';\n\n/**\n * A class that allows objects to subscribe to events and be notified when the event is published.\n *\n * @class\n * @exports Subscribr\n */\nexport class Subscribr {\n\tprivate readonly subscribers: SetMultiMap<string, ContextEventHandler>;\n\n\tconstructor() {\n\t\tthis.subscribers = new SetMultiMap();\n\t}\n\n\t/**\n\t * Subscribe to an event\n\t *\n\t * @param {string} eventName The event name to subscribe to.\n\t * @param {ContextEventListener} eventHandler The event handler to call when the event is published.\n\t * @param {unknown} [context] The context to bind to the event handler.\n\t * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.\n\t */\n\tsubscribe(eventName: string, eventHandler: ContextEventListener, context: unknown = eventHandler): Subscription {\n\t\tconst contextEventHandler = new ContextEventHandler(context, eventHandler);\n\t\tthis.subscribers.set(eventName, contextEventHandler);\n\n\t\treturn new Subscription(eventName, contextEventHandler);\n\t}\n\n\t/**\n\t * Unsubscribe from the event\n\t *\n\t * @param {Subscription} subscription The subscription to unsubscribe.\n\t * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.\n\t */\n\tunsubscribe({ eventName, contextEventHandler }: Subscription): boolean {\n\t\tconst contextEventHandlers = this.subscribers.get(eventName) ?? new Set();\n\t\tconst removed = contextEventHandlers.delete(contextEventHandler);\n\n\t\tif (removed && contextEventHandlers.size === 0) {\tthis.subscribers.delete(eventName) }\n\n\t\treturn removed;\n\t}\n\n\t/**\n\t * Publish an event\n\t *\n\t * @template T\n\t * @param {string} eventName The name of the event.\n\t * @param {Event} [event=new CustomEvent(eventName)] The event to be handled.\n\t * @param {T} [data] The value to be passed to the event handler as a parameter.\n\t */\n\tpublish<T>(eventName: string, event: Event = new CustomEvent(eventName), data?: T): void {\n\t\tthis.subscribers.get(eventName)?.forEach((contextEventHandler: ContextEventHandler) => contextEventHandler.handle(event, data));\n\t}\n\n\t/**\n\t * Check if the event and handler are subscribed.\n\t *\n\t * @param {Subscription} subscription The subscription object.\n\t * @returns {boolean} true if the event name and handler are subscribed, false otherwise.\n\t */\n\tisSubscribed({ eventName, contextEventHandler }: Subscription): boolean {\n\t\treturn this.subscribers.get(eventName)?.has(contextEventHandler) ?? false;\n\t}\n\n\t/**\n\t * A String value that is used in the creation of the default string\n\t * description of an object. Called by the built-in method {@link Object.prototype.toString}.\n\t *\n\t * @returns {string} The default string description of this object.\n\t */\n\tget [Symbol.toStringTag](): string {\n\t\treturn 'Subscribr';\n\t}\n}"],
+  "mappings": "AACO,IAAMA,EAAN,cAAgC,GAAc,CAW3C,IAAIC,EAAQC,EAA6B,CACjD,aAAM,IAAID,GAAM,MAAM,IAAIA,CAAG,GAAK,IAAI,KAAO,IAAIC,CAAK,CAAC,EAEhD,IACR,CASA,SAASD,EAAQC,EAAmB,CACnC,IAAMC,EAAS,MAAM,IAAIF,CAAG,EAE5B,OAAOE,EAASA,EAAO,IAAID,CAAK,EAAI,EACrC,CAEA,KAAKD,EAAQG,EAAgD,CAC5D,IAAMD,EAAS,KAAK,IAAIF,CAAG,EAE3B,GAAIE,IAAW,OACd,OAAO,MAAM,KAAKA,CAAM,EAAE,KAAKC,CAAQ,CAIzC,CASA,YAAYH,EAAQC,EAA+B,CAClD,GAAIA,IAAU,OAAa,OAAO,KAAK,OAAOD,CAAG,EAEjD,IAAME,EAAS,MAAM,IAAIF,CAAG,EAC5B,GAAIE,EAAQ,CACX,IAAME,EAAUF,EAAO,OAAOD,CAAK,EAEnC,OAAIC,EAAO,OAAS,GACnB,MAAM,OAAOF,CAAG,EAGVI,CACR,CAEA,MAAO,EACR,CAEA,IAAc,OAAO,WAAW,GAAY,CAC3C,MAAO,aACR,CACD,ECjEO,IAAMC,EAAN,KAA0B,CACf,QACA,cAMjB,YAAYC,EAAkBC,EAAqC,CAClE,KAAK,QAAUD,EACf,KAAK,cAAgBC,CACtB,CAQA,OAAOC,EAAcC,EAAsB,CAC1C,KAAK,cAAc,KAAK,KAAK,QAASD,EAAOC,CAAI,CAClD,CAQA,IAAK,OAAO,WAAW,GAAY,CAClC,MAAO,qBACR,CACD,EChCO,IAAMC,EAAN,KAAmB,CACR,WACA,qBAMjB,YAAYC,EAAmBC,EAA0C,CACxE,KAAK,WAAaD,EAClB,KAAK,qBAAuBC,CAC7B,CAOA,IAAI,WAAoB,CACvB,OAAO,KAAK,UACb,CAOA,IAAI,qBAA2C,CAC9C,OAAO,KAAK,oBACb,CAQA,IAAK,OAAO,WAAW,GAAY,CAClC,MAAO,cACR,CACD,EChCO,IAAMC,EAAN,KAAgB,CACL,YAEjB,aAAc,CACb,KAAK,YAAc,IAAIC,CACxB,CAUA,UAAUC,EAAmBC,EAAoCC,EAAmBD,EAA4B,CAC/G,IAAME,EAAsB,IAAIC,EAAoBF,EAASD,CAAY,EACzE,YAAK,YAAY,IAAID,EAAWG,CAAmB,EAE5C,IAAIE,EAAaL,EAAWG,CAAmB,CACvD,CAQA,YAAY,CAAE,UAAAH,EAAW,oBAAAG,CAAoB,EAA0B,CACtE,IAAMG,EAAuB,KAAK,YAAY,IAAIN,CAAS,GAAK,IAAI,IAC9DO,EAAUD,EAAqB,OAAOH,CAAmB,EAE/D,OAAII,GAAWD,EAAqB,OAAS,GAAK,KAAK,YAAY,OAAON,CAAS,EAE5EO,CACR,CAUA,QAAWP,EAAmBQ,EAAe,IAAI,YAAYR,CAAS,EAAGS,EAAgB,CACxF,KAAK,YAAY,IAAIT,CAAS,GAAG,QAASG,GAA6CA,EAAoB,OAAOK,EAAOC,CAAI,CAAC,CAC/H,CAQA,aAAa,CAAE,UAAAT,EAAW,oBAAAG,CAAoB,EAA0B,CACvE,OAAO,KAAK,YAAY,IAAIH,CAAS,GAAG,IAAIG,CAAmB,GAAK,EACrE,CAQA,IAAK,OAAO,WAAW,GAAY,CAClC,MAAO,WACR,CACD",
+  "names": ["SetMultiMap", "key", "value", "values", "iterator", "deleted", "ContextEventHandler", "context", "eventListener", "event", "data", "Subscription", "eventName", "contextEventHandler", "Subscribr", "SetMultiMap", "eventName", "eventHandler", "context", "contextEventHandler", "ContextEventHandler", "Subscription", "contextEventHandlers", "removed", "event", "data"]
+}

package/package.json

@@ -1,15 +1,32 @@
 {
   "name": "@d1g1tal/subscribr",
-  "version": "3.0.5",
+  "version": "4.0.1",
   "description": "JavaScript Publish/Subscribe Library",
-  "type": "module",
-  "exports": {
-    ".": "./src/subscribr.js",
-    "./*.js": "./src/*.js"
+  "author": "Jason DiMeo",
+  "license": "ISC",
+  "homepage": "https://github.com/D1g1talEntr0py/subscribr#readme",
+  "bugs": {
+    "url": "https://github.com/D1g1talEntr0py/subscribr/issues"
   },
+  "keywords": [
+    "JavaScript",
+    "ObserverPattern",
+    "Publish/Subscribe"
+  ],
   "publishConfig": {
     "access": "public"
   },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/subscribr.d.ts",
+      "import": "./dist/subscribr.js"
+    },
+    "./src": {
+      "types": "./dist/subscribr.d.ts",
+      "import": "./src/index.ts"
+    }
+  },
   "files": [
     "/src",
     "/dist"
@@ -18,49 +35,48 @@
     "type": "git",
     "url": "git+https://github.com/D1g1talEntr0py/subscribr.git"
   },
-  "keywords": [
-    "JavaScript",
-    "ObserverPattern",
-    "Publish/Subscribe"
-  ],
-  "author": "Jason DiMeo",
-  "license": "ISC",
-  "bugs": {
-    "url": "https://github.com/D1g1talEntr0py/subscribr/issues"
-  },
-  "homepage": "https://github.com/D1g1talEntr0py/subscribr#readme",
   "dependencies": {
-    "@d1g1tal/collections": "^1.0.1"
+    "@d1g1tal/collections": "^2.0.2"
   },
   "devDependencies": {
     "@d1g1tal/chrysalis": "^2.5.0",
-    "esbuild": "^0.20.1",
-    "esbuild-library": "^1.0.7",
-    "eslint": "^8.57.0",
-    "eslint-plugin-compat": "^4.2.0",
-    "eslint-plugin-jsdoc": "^48.2.0",
-    "jest": "^29.7.0"
+    "@eslint/compat": "^1.1.1",
+    "@eslint/js": "^9.11.1",
+    "@types/eslint__js": "^8.42.3",
+    "@types/node": "^22.7.4",
+    "@typescript-eslint/eslint-plugin": "^8.7.0",
+    "@typescript-eslint/parser": "^8.7.0",
+    "@vitest/coverage-v8": "^2.1.1",
+    "eslint": "^9.11.1",
+    "eslint-plugin-compat": "^6.0.1",
+    "eslint-plugin-jsdoc": "^50.3.0",
+    "globals": "^15.9.0",
+    "typescript": "^5.6.2",
+    "typescript-eslint": "^8.7.0",
+    "vitest": "^2.1.1"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
   },
-  "jest": {
-    "verbose": true,
-    "transform": {},
-    "coverageDirectory": "./tests/coverage/",
-    "coveragePathIgnorePatterns": [
-      "/node_modules/"
-    ],
-    "collectCoverage": true,
-    "collectCoverageFrom": [
-      "src/**/*.js"
-    ]
+  "engines": {
+    "node": ">=20.15.1"
   },
   "browserslist": [
     "defaults and fully supports es6-module",
-    "node >= 20.10"
+    "node >= 20.15.1"
   ],
   "scripts": {
-    "build": "node esbuild.js",
-    "lint": "eslint --ext .js --fix --ignore-path .gitignore .",
-    "d.ts": "tsc --allowJs -declaration --emitDeclarationOnly  --skipLibCheck --lib esnext index.js",
-    "test": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js"
+    "build": "tsbuild",
+    "build:watch": "tsbuild --watch",
+    "type-check": "tsbuild --typeCheck",
+    "lint": "eslint ./src",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "prepublish": "pnpm lint && pnpm test && pnpm -s build"
   }
 }

package/src/@types/index.ts

@@ -0,0 +1,4 @@
+/** Context event listener function. */
+type ContextEventListener = (event: Event, data?: unknown) => void;
+
+export type { ContextEventListener };

package/src/context-event-handler.ts

@@ -0,0 +1,36 @@
+import type { ContextEventListener } from './@types';
+
+/** A wrapper for an event handler that binds a context to the event handler. */
+export class ContextEventHandler {
+	private readonly context: unknown;
+	private readonly eventListener: ContextEventListener;
+
+	/**
+	 * @param {unknown} context The context to bind to the event handler.
+	 * @param {ContextEventListener} eventListener The event handler to call when the event is published.
+	 */
+	constructor(context: unknown, eventListener: ContextEventListener) {
+		this.context = context;
+		this.eventListener = eventListener;
+	}
+
+	/**
+	 * Call the event handler for the provided event.
+	 *
+	 * @param {Event} event The event to handle
+	 * @param {unknown?} [data] The value to be passed to the event handler as a parameter.
+	 */
+	handle(event: Event, data?: unknown): void {
+		this.eventListener.call(this.context, event, data);
+	}
+
+	/**
+	 * A String value that is used in the creation of the default string
+	 * description of an object. Called by the built-in method {@link Object.prototype.toString}.
+	 *
+	 * @returns {string} The default string description of this object.
+	 */
+	get [Symbol.toStringTag](): string {
+		return 'ContextEventHandler';
+	}
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export { Subscribr } from './subscribr';
+export { Subscription } from './subscription';
+export { ContextEventHandler } from './context-event-handler';
+export type { ContextEventListener } from './@types';

package/src/subscribr.ts

@@ -0,0 +1,80 @@
+import { SetMultiMap } from '@d1g1tal/collections/src';
+import { ContextEventHandler } from './context-event-handler';
+import { Subscription } from './subscription';
+import type { ContextEventListener } from './@types';
+
+/**
+ * A class that allows objects to subscribe to events and be notified when the event is published.
+ *
+ * @class
+ * @exports Subscribr
+ */
+export class Subscribr {
+	private readonly subscribers: SetMultiMap<string, ContextEventHandler>;
+
+	constructor() {
+		this.subscribers = new SetMultiMap();
+	}
+
+	/**
+	 * Subscribe to an event
+	 *
+	 * @param {string} eventName The event name to subscribe to.
+	 * @param {ContextEventListener} eventHandler The event handler to call when the event is published.
+	 * @param {unknown} [context] The context to bind to the event handler.
+	 * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.
+	 */
+	subscribe(eventName: string, eventHandler: ContextEventListener, context: unknown = eventHandler): Subscription {
+		const contextEventHandler = new ContextEventHandler(context, eventHandler);
+		this.subscribers.set(eventName, contextEventHandler);
+
+		return new Subscription(eventName, contextEventHandler);
+	}
+
+	/**
+	 * Unsubscribe from the event
+	 *
+	 * @param {Subscription} subscription The subscription to unsubscribe.
+	 * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.
+	 */
+	unsubscribe({ eventName, contextEventHandler }: Subscription): boolean {
+		const contextEventHandlers = this.subscribers.get(eventName) ?? new Set();
+		const removed = contextEventHandlers.delete(contextEventHandler);
+
+		if (removed && contextEventHandlers.size === 0) {	this.subscribers.delete(eventName) }
+
+		return removed;
+	}
+
+	/**
+	 * Publish an event
+	 *
+	 * @template T
+	 * @param {string} eventName The name of the event.
+	 * @param {Event} [event=new CustomEvent(eventName)] The event to be handled.
+	 * @param {T} [data] The value to be passed to the event handler as a parameter.
+	 */
+	publish<T>(eventName: string, event: Event = new CustomEvent(eventName), data?: T): void {
+		this.subscribers.get(eventName)?.forEach((contextEventHandler: ContextEventHandler) => contextEventHandler.handle(event, data));
+	}
+
+	/**
+	 * Check if the event and handler are subscribed.
+	 *
+	 * @param {Subscription} subscription The subscription object.
+	 * @returns {boolean} true if the event name and handler are subscribed, false otherwise.
+	 */
+	isSubscribed({ eventName, contextEventHandler }: Subscription): boolean {
+		return this.subscribers.get(eventName)?.has(contextEventHandler) ?? false;
+	}
+
+	/**
+	 * A String value that is used in the creation of the default string
+	 * description of an object. Called by the built-in method {@link Object.prototype.toString}.
+	 *
+	 * @returns {string} The default string description of this object.
+	 */
+	get [Symbol.toStringTag](): string {
+		return 'Subscribr';
+	}
+}

package/src/subscription.ts

@@ -0,0 +1,44 @@
+import type { ContextEventHandler } from './context-event-handler';
+
+/** Represents a subscription to an event. */
+export class Subscription {
+	private readonly _eventName: string;
+	private readonly _contextEventHandler: ContextEventHandler;
+
+	/**
+	 * @param {string} eventName The event name.
+	 * @param {ContextEventHandler} contextEventHandler Then context event handler.
+	 */
+	constructor(eventName: string, contextEventHandler: ContextEventHandler) {
+		this._eventName = eventName;
+		this._contextEventHandler = contextEventHandler;
+	}
+
+	/**
+	 * Gets the event name for the subscription.
+	 *
+	 * @returns {string} The event name.
+	 */
+	get eventName(): string {
+		return this._eventName;
+	}
+
+	/**
+	 * Gets the context event handler.
+	 *
+	 * @returns {ContextEventHandler} The context event handler
+	 */
+	get contextEventHandler(): ContextEventHandler {
+		return this._contextEventHandler;
+	}
+
+	/**
+	 * A String value that is used in the creation of the default string
+	 * description of an object. Called by the built-in method {@link Object.prototype.toString}.
+	 *
+	 * @returns {string} The default string description of this object.
+	 */
+	get [Symbol.toStringTag](): string {
+		return 'Subscription';
+	}
+}

package/dist/iife/subscribr.js

@@ -1,164 +0,0 @@
-(() => {
-	var SetMultiMap = class extends Map {
-	  /**
-	   * Adds a new element with a specified key and value to the SetMultiMap.
-	   * If an element with the same key already exists, the value will be added to the underlying {@link Set}.
-	   * If the value already exists in the {@link Set}, it will not be added again.
-	   *
-	   * @param {K} key The key to set.
-	   * @param {V} value The value to add to the SetMultiMap
-	   * @returns {SetMultiMap<K, V>} The SetMultiMap with the updated key and value.
-	   */
-	  set(key, value) {
-	    super.set(key, (super.get(key) ?? /* @__PURE__ */ new Set()).add(value));
-	    return this;
-	  }
-	  /**
-	   * Checks if a specific key has a specific value.
-	   *
-	   * @param {K} key The key to check.
-	   * @param {V} value The value to check.
-	   * @returns {boolean} True if the key has the value, false otherwise.
-	   */
-	  hasValue(key, value) {
-	    const values = super.get(key);
-	    return values ? values.has(value) : false;
-	  }
-	  /**
-	   * Removes a specific value from a specific key.
-	   *
-	   * @param {K} key The key to remove the value from.
-	   * @param {V} value The value to remove.
-	   * @returns {boolean} True if the value was removed, false otherwise.
-	   */
-	  deleteValue(key, value) {
-	    const values = super.get(key);
-	    if (values) {
-	      return values.delete(value);
-	    }
-	    return false;
-	  }
-	  get [Symbol.toStringTag]() {
-	    return "SetMultiMap";
-	  }
-	};
-	var ContextEventHandler = class {
-	  #context;
-	  #eventHandler;
-	  /**
-	   * @param {*} context The context to bind to the event handler.
-	   * @param {function(*): void} eventHandler The event handler to call when the event is published.
-	   */
-	  constructor(context, eventHandler) {
-	    this.#context = context;
-	    this.#eventHandler = eventHandler;
-	  }
-	  /**
-	   * Call the event handler for the provided event.
-	   *
-	   * @param {Event} event The event to handle
-	   * @param {*} [data] The value to be passed to the event handler as a parameter.
-	   */
-	  handle(event, data) {
-	    this.#eventHandler.call(this.#context, event, data);
-	  }
-	  get [Symbol.toStringTag]() {
-	    return "ContextEventHandler";
-	  }
-	};
-	var Subscription = class {
-	  #eventName;
-	  #contextEventHandler;
-	  /**
-	   * @param {string} eventName The event name.
-	   * @param {ContextEventHandler} contextEventHandler Then context event handler.
-	   */
-	  constructor(eventName, contextEventHandler) {
-	    this.#eventName = eventName;
-	    this.#contextEventHandler = contextEventHandler;
-	  }
-	  /**
-	   * Gets the event name for the subscription.
-	   *
-	   * @returns {string} The event name.
-	   */
-	  get eventName() {
-	    return this.#eventName;
-	  }
-	  /**
-	   * Gets the context event handler.
-	   *
-	   * @returns {ContextEventHandler} The context event handler
-	   */
-	  get contextEventHandler() {
-	    return this.#contextEventHandler;
-	  }
-	  get [Symbol.toStringTag]() {
-	    return "Subscription";
-	  }
-	};
-	var Subscribr = class {
-	  /** @type {SetMultiMap<string, ContextEventHandler>} */
-	  #subscribers;
-	  constructor() {
-	    this.#subscribers = new SetMultiMap();
-	  }
-	  /**
-	   * Subscribe to an event
-	   *
-	   * @param {string} eventName The event name to subscribe to.
-	   * @param {function(Event, *): void} eventHandler The event handler to call when the event is published.
-	   * @param {*} [context] The context to bind to the event handler.
-	   * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.
-	   */
-	  subscribe(eventName, eventHandler, context = eventHandler) {
-	    const contextEventHandler = new ContextEventHandler(context, eventHandler);
-	    this.#subscribers.set(eventName, contextEventHandler);
-	    return new Subscription(eventName, contextEventHandler);
-	  }
-	  /**
-	   * Unsubscribe from the event
-	   *
-	   * @param {Subscription} subscription The subscription to unsubscribe.
-	   * @param {string} subscription.eventName The event name to subscribe to.
-	   * @param {ContextEventHandler} subscription.contextEventHandler The event handler to call when the event is published.
-	   * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.
-	   */
-	  unsubscribe({ eventName, contextEventHandler }) {
-	    const contextEventHandlers = this.#subscribers.get(eventName);
-	    const removed = contextEventHandlers?.delete(contextEventHandler);
-	    if (removed && contextEventHandlers.size === 0) {
-	      this.#subscribers.delete(eventName);
-	    }
-	    return removed;
-	  }
-	  /**
-	   * Publish an event
-	   *
-	   * @param {string} eventName The name of the event.
-	   * @param {Event} [event=new CustomEvent(eventName)] The event to be handled.
-	   * @param {*} [data] The value to be passed to the event handler as a parameter.
-	   */
-	  publish(eventName, event = new CustomEvent(eventName), data) {
-	    if (data == null && !(event instanceof Event)) {
-	      [data, event] = [event, new CustomEvent(eventName)];
-	    }
-	    this.#subscribers.get(eventName)?.forEach((contextEventHandler) => contextEventHandler.handle(event, data));
-	  }
-	  /**
-	   * Check if the event and handler are subscribed.
-	   *
-	   * @param {Subscription} subscription The subscription object.
-	   * @param {string} subscription.eventName The name of the event to check.
-	   * @param {ContextEventHandler} subscription.contextEventHandler The event handler to check.
-	   * @returns {boolean} true if the event name and handler are subscribed, false otherwise.
-	   */
-	  isSubscribed({ eventName, contextEventHandler }) {
-	    return this.#subscribers.get(eventName)?.has(contextEventHandler);
-	  }
-	  get [Symbol.toStringTag]() {
-	    return "Subscribr";
-	  }
-	};
-	globalThis.Subscribr = Subscribr;
-})();

package/dist/iife/subscribr.min.js

@@ -1,2 +0,0 @@
-(()=>{var n=class extends Map{set(t,e){return super.set(t,(super.get(t)??new Set).add(e)),this}hasValue(t,e){let s=super.get(t);return!!s&&s.has(e)}deleteValue(t,e){let s=super.get(t);return!!s&&s.delete(e)}get[Symbol.toStringTag](){return"SetMultiMap"}},u=class{#t;#e;constructor(t,e){this.#t=t,this.#e=e}handle(t,e){this.#e.call(this.#t,t,e)}get[Symbol.toStringTag](){return"ContextEventHandler"}},i=class{#t;#e;constructor(t,e){this.#t=t,this.#e=e}get eventName(){return this.#t}get contextEventHandler(){return this.#e}get[Symbol.toStringTag](){return"Subscription"}},l=class{#t;constructor(){this.#t=new n}subscribe(t,e,s=e){let r=new u(s,e);return this.#t.set(t,r),new i(t,r)}unsubscribe({eventName:t,contextEventHandler:e}){let s=this.#t.get(t),r=s?.delete(e);return r&&s.size===0&&this.#t.delete(t),r}publish(t,e=new CustomEvent(t),s){s!=null||e instanceof Event||([s,e]=[e,new CustomEvent(t)]),this.#t.get(t)?.forEach(r=>r.handle(e,s))}isSubscribed({eventName:t,contextEventHandler:e}){return this.#t.get(t)?.has(e)}get[Symbol.toStringTag](){return"Subscribr"}};globalThis.Subscribr=l})();
-//# sourceMappingURL=subscribr.min.js.map

package/dist/iife/subscribr.min.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["subscribr.js"],
-  "sourcesContent": ["(()=>{var e=class extends Map{set(e,t){return super.set(e,(super.get(e)??new Set).add(t)),this}hasValue(e,t){let s=super.get(e);return!!s&&s.has(t)}deleteValue(e,t){let s=super.get(e);return!!s&&s.delete(t)}get[Symbol.toStringTag](){return\"SetMultiMap\"}},t=class{#e;#t;constructor(e,t){this.#e=e,this.#t=t}handle(e,t){this.#t.call(this.#e,e,t)}get[Symbol.toStringTag](){return\"ContextEventHandler\"}},s=class{#s;#r;constructor(e,t){this.#s=e,this.#r=t}get eventName(){return this.#s}get contextEventHandler(){return this.#r}get[Symbol.toStringTag](){return\"Subscription\"}},r=class{#n;constructor(){this.#n=new e}subscribe(e,r,n=r){let u=new t(n,r);return this.#n.set(e,u),new s(e,u)}unsubscribe({eventName:e,contextEventHandler:t}){let s=this.#n.get(e),r=s?.delete(t);return r&&0===s.size&&this.#n.delete(e),r}publish(e,t=new CustomEvent(e),s){null!=s||t instanceof Event||([s,t]=[t,new CustomEvent(e)]),this.#n.get(e)?.forEach(e=>e.handle(t,s))}isSubscribed({eventName:e,contextEventHandler:t}){return this.#n.get(e)?.has(t)}get[Symbol.toStringTag](){return\"Subscribr\"}};globalThis.Subscribr=r})();"],
-  "mappings": "CAAC,IAAI,CAAC,IAAIA,EAAE,cAAc,GAAG,CAAC,IAAIA,EAAEC,EAAE,CAAC,OAAO,MAAM,IAAID,GAAG,MAAM,IAAIA,CAAC,GAAG,IAAI,KAAK,IAAIC,CAAC,CAAC,EAAE,IAAI,CAAC,SAASD,EAAEC,EAAE,CAAC,IAAI,EAAE,MAAM,IAAID,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,IAAIC,CAAC,CAAC,CAAC,YAAYD,EAAEC,EAAE,CAAC,IAAI,EAAE,MAAM,IAAID,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,OAAOC,CAAC,CAAC,CAAC,IAAI,OAAO,WAAW,GAAG,CAAC,MAAM,aAAa,CAAC,EAAEA,EAAE,KAAK,CAACC,GAAGC,GAAG,YAAYH,EAAEC,EAAE,CAAC,KAAKC,GAAGF,EAAE,KAAKG,GAAGF,CAAC,CAAC,OAAOD,EAAEC,EAAE,CAAC,KAAKE,GAAG,KAAK,KAAKD,GAAGF,EAAEC,CAAC,CAAC,CAAC,IAAI,OAAO,WAAW,GAAG,CAAC,MAAM,qBAAqB,CAAC,EAAEG,EAAE,KAAK,CAACC,GAAGC,GAAG,YAAYN,EAAEC,EAAE,CAAC,KAAKI,GAAGL,EAAE,KAAKM,GAAGL,CAAC,CAAC,IAAI,WAAW,CAAC,OAAO,KAAKI,EAAE,CAAC,IAAI,qBAAqB,CAAC,OAAO,KAAKC,EAAE,CAAC,IAAI,OAAO,WAAW,GAAG,CAAC,MAAM,cAAc,CAAC,EAAEC,EAAE,KAAK,CAACC,GAAG,aAAa,CAAC,KAAKA,GAAG,IAAIR,CAAC,CAAC,UAAUA,EAAEO,EAAEE,EAAEF,EAAE,CAAC,IAAIG,EAAE,IAAIT,EAAEQ,EAAEF,CAAC,EAAE,OAAO,KAAKC,GAAG,IAAIR,EAAEU,CAAC,EAAE,IAAIN,EAAEJ,EAAEU,CAAC,CAAC,CAAC,YAAY,CAAC,UAAUV,EAAE,oBAAoBC,CAAC,EAAE,CAAC,IAAI,EAAE,KAAKO,GAAG,IAAIR,CAAC,EAAE,EAAE,GAAG,OAAOC,CAAC,EAAE,OAAO,GAAO,EAAE,OAAN,GAAY,KAAKO,GAAG,OAAOR,CAAC,EAAE,CAAC,CAAC,QAAQA,EAAEC,EAAE,IAAI,YAAYD,CAAC,EAAE,EAAE,CAAO,GAAN,MAASC,aAAa,QAAQ,CAAC,EAAEA,CAAC,EAAE,CAACA,EAAE,IAAI,YAAYD,CAAC,CAAC,GAAG,KAAKQ,GAAG,IAAIR,CAAC,GAAG,QAAQA,GAAGA,EAAE,OAAOC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,UAAUD,EAAE,oBAAoBC,CAAC,EAAE,CAAC,OAAO,KAAKO,GAAG,IAAIR,CAAC,GAAG,IAAIC,CAAC,CAAC,CAAC,IAAI,OAAO,WAAW,GAAG,CAAC,MAAM,WAAW,CAAC,EAAE,WAAW,UAAUM,CAAC,GAAG",
-  "names": ["e", "t", "#e", "#t", "s", "#s", "#r", "r", "#n", "n", "u"]
-}

package/dist/subscribr.min.js

@@ -1,2 +0,0 @@
-var n=class extends Map{set(t,e){return super.set(t,(super.get(t)??new Set).add(e)),this}hasValue(t,e){let s=super.get(t);return!!s&&s.has(e)}deleteValue(t,e){let s=super.get(t);return!!s&&s.delete(e)}get[Symbol.toStringTag](){return"SetMultiMap"}},u=class{#t;#e;constructor(t,e){this.#t=t,this.#e=e}handle(t,e){this.#e.call(this.#t,t,e)}get[Symbol.toStringTag](){return"ContextEventHandler"}},a=class{#t;#e;constructor(t,e){this.#t=t,this.#e=e}get eventName(){return this.#t}get contextEventHandler(){return this.#e}get[Symbol.toStringTag](){return"Subscription"}},l=class{#t;constructor(){this.#t=new n}subscribe(t,e,s=e){let r=new u(s,e);return this.#t.set(t,r),new a(t,r)}unsubscribe({eventName:t,contextEventHandler:e}){let s=this.#t.get(t),r=s?.delete(e);return r&&s.size===0&&this.#t.delete(t),r}publish(t,e=new CustomEvent(t),s){s!=null||e instanceof Event||([s,e]=[e,new CustomEvent(t)]),this.#t.get(t)?.forEach(r=>r.handle(e,s))}isSubscribed({eventName:t,contextEventHandler:e}){return this.#t.get(t)?.has(e)}get[Symbol.toStringTag](){return"Subscribr"}};export{l as default};
-//# sourceMappingURL=subscribr.min.js.map

package/dist/subscribr.min.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["subscribr.js"],
-  "sourcesContent": ["var e=class extends Map{set(e,t){return super.set(e,(super.get(e)??new Set).add(t)),this}hasValue(e,t){let s=super.get(e);return!!s&&s.has(t)}deleteValue(e,t){let s=super.get(e);return!!s&&s.delete(t)}get[Symbol.toStringTag](){return\"SetMultiMap\"}},t=class{#e;#t;constructor(e,t){this.#e=e,this.#t=t}handle(e,t){this.#t.call(this.#e,e,t)}get[Symbol.toStringTag](){return\"ContextEventHandler\"}},s=class{#s;#r;constructor(e,t){this.#s=e,this.#r=t}get eventName(){return this.#s}get contextEventHandler(){return this.#r}get[Symbol.toStringTag](){return\"Subscription\"}},r=class{#n;constructor(){this.#n=new e}subscribe(e,r,n=r){let u=new t(n,r);return this.#n.set(e,u),new s(e,u)}unsubscribe({eventName:e,contextEventHandler:t}){let s=this.#n.get(e),r=s?.delete(t);return r&&0===s.size&&this.#n.delete(e),r}publish(e,t=new CustomEvent(e),s){null!=s||t instanceof Event||([s,t]=[t,new CustomEvent(e)]),this.#n.get(e)?.forEach(e=>e.handle(t,s))}isSubscribed({eventName:e,contextEventHandler:t}){return this.#n.get(e)?.has(t)}get[Symbol.toStringTag](){return\"Subscribr\"}};export{r as default};"],
-  "mappings": "AAAA,IAAIA,EAAE,cAAc,GAAG,CAAC,IAAIA,EAAEC,EAAE,CAAC,OAAO,MAAM,IAAID,GAAG,MAAM,IAAIA,CAAC,GAAG,IAAI,KAAK,IAAIC,CAAC,CAAC,EAAE,IAAI,CAAC,SAASD,EAAEC,EAAE,CAAC,IAAI,EAAE,MAAM,IAAID,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,IAAIC,CAAC,CAAC,CAAC,YAAYD,EAAEC,EAAE,CAAC,IAAI,EAAE,MAAM,IAAID,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,OAAOC,CAAC,CAAC,CAAC,IAAI,OAAO,WAAW,GAAG,CAAC,MAAM,aAAa,CAAC,EAAEA,EAAE,KAAK,CAACC,GAAGC,GAAG,YAAYH,EAAEC,EAAE,CAAC,KAAKC,GAAGF,EAAE,KAAKG,GAAGF,CAAC,CAAC,OAAOD,EAAEC,EAAE,CAAC,KAAKE,GAAG,KAAK,KAAKD,GAAGF,EAAEC,CAAC,CAAC,CAAC,IAAI,OAAO,WAAW,GAAG,CAAC,MAAM,qBAAqB,CAAC,EAAEG,EAAE,KAAK,CAACC,GAAGC,GAAG,YAAYN,EAAEC,EAAE,CAAC,KAAKI,GAAGL,EAAE,KAAKM,GAAGL,CAAC,CAAC,IAAI,WAAW,CAAC,OAAO,KAAKI,EAAE,CAAC,IAAI,qBAAqB,CAAC,OAAO,KAAKC,EAAE,CAAC,IAAI,OAAO,WAAW,GAAG,CAAC,MAAM,cAAc,CAAC,EAAEC,EAAE,KAAK,CAACC,GAAG,aAAa,CAAC,KAAKA,GAAG,IAAIR,CAAC,CAAC,UAAUA,EAAEO,EAAEE,EAAEF,EAAE,CAAC,IAAIG,EAAE,IAAIT,EAAEQ,EAAEF,CAAC,EAAE,OAAO,KAAKC,GAAG,IAAIR,EAAEU,CAAC,EAAE,IAAIN,EAAEJ,EAAEU,CAAC,CAAC,CAAC,YAAY,CAAC,UAAUV,EAAE,oBAAoBC,CAAC,EAAE,CAAC,IAAI,EAAE,KAAKO,GAAG,IAAIR,CAAC,EAAE,EAAE,GAAG,OAAOC,CAAC,EAAE,OAAO,GAAO,EAAE,OAAN,GAAY,KAAKO,GAAG,OAAOR,CAAC,EAAE,CAAC,CAAC,QAAQA,EAAEC,EAAE,IAAI,YAAYD,CAAC,EAAE,EAAE,CAAO,GAAN,MAASC,aAAa,QAAQ,CAAC,EAAEA,CAAC,EAAE,CAACA,EAAE,IAAI,YAAYD,CAAC,CAAC,GAAG,KAAKQ,GAAG,IAAIR,CAAC,GAAG,QAAQA,GAAGA,EAAE,OAAOC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,UAAUD,EAAE,oBAAoBC,CAAC,EAAE,CAAC,OAAO,KAAKO,GAAG,IAAIR,CAAC,GAAG,IAAIC,CAAC,CAAC,CAAC,IAAI,OAAO,WAAW,GAAG,CAAC,MAAM,WAAW,CAAC,EAAE,OAAOM,KAAK",
-  "names": ["e", "t", "#e", "#t", "s", "#s", "#r", "r", "#n", "n", "u"]
-}

package/src/context-event-handler.js

@@ -1,27 +0,0 @@
-export default class ContextEventHandler {
-	#context;
-	#eventHandler;
-
-	/**
-	 * @param {*} context The context to bind to the event handler.
-	 * @param {function(*): void} eventHandler The event handler to call when the event is published.
-	 */
-	constructor(context, eventHandler) {
-		this.#context = context;
-		this.#eventHandler = eventHandler;
-	}
-
-	/**
-	 * Call the event handler for the provided event.
-	 *
-	 * @param {Event} event The event to handle
-	 * @param {*} [data] The value to be passed to the event handler as a parameter.
-	 */
-	handle(event, data) {
-		this.#eventHandler.call(this.#context, event, data);
-	}
-
-	get [Symbol.toStringTag]() {
-		return 'ContextEventHandler';
-	}
-}

package/src/subscribr.js

@@ -1,75 +0,0 @@
-import SetMultiMap from '@d1g1tal/collections/set-multi-map.js';
-import ContextEventHandler from './context-event-handler.js';
-import Subscription from './subscription.js';
-
-export default class Subscribr {
-	/** @type {SetMultiMap<string, ContextEventHandler>} */
-	#subscribers;
-
-	constructor() {
-		this.#subscribers = new SetMultiMap();
-	}
-
-	/**
-	 * Subscribe to an event
-	 *
-	 * @param {string} eventName The event name to subscribe to.
-	 * @param {function(Event, *): void} eventHandler The event handler to call when the event is published.
-	 * @param {*} [context] The context to bind to the event handler.
-	 * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.
-	 */
-	subscribe(eventName, eventHandler, context = eventHandler) {
-		const contextEventHandler = new ContextEventHandler(context, eventHandler);
-		this.#subscribers.set(eventName, contextEventHandler);
-
-		return new Subscription(eventName, contextEventHandler);
-	}
-
-	/**
-	 * Unsubscribe from the event
-	 *
-	 * @param {Subscription} subscription The subscription to unsubscribe.
-	 * @param {string} subscription.eventName The event name to subscribe to.
-	 * @param {ContextEventHandler} subscription.contextEventHandler The event handler to call when the event is published.
-	 * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.
-	 */
-	unsubscribe({ eventName, contextEventHandler }) {
-		const contextEventHandlers = this.#subscribers.get(eventName);
-		const removed = contextEventHandlers?.delete(contextEventHandler);
-
-		if (removed && contextEventHandlers.size === 0) {	this.#subscribers.delete(eventName) }
-
-		return removed;
-	}
-
-	/**
-	 * Publish an event
-	 *
-	 * @param {string} eventName The name of the event.
-	 * @param {Event} [event=new CustomEvent(eventName)] The event to be handled.
-	 * @param {*} [data] The value to be passed to the event handler as a parameter.
-	 */
-	publish(eventName, event = new CustomEvent(eventName), data) {
-		if (data == null && !(event instanceof Event)) {
-			// Swap the event and data parameters because only data was passed without an event object
-			[data, event] = [event, new CustomEvent(eventName)];
-		}
-		this.#subscribers.get(eventName)?.forEach((contextEventHandler) => contextEventHandler.handle(event, data));
-	}
-
-	/**
-	 * Check if the event and handler are subscribed.
-	 *
-	 * @param {Subscription} subscription The subscription object.
-	 * @param {string} subscription.eventName The name of the event to check.
-	 * @param {ContextEventHandler} subscription.contextEventHandler The event handler to check.
-	 * @returns {boolean} true if the event name and handler are subscribed, false otherwise.
-	 */
-	isSubscribed({ eventName, contextEventHandler }) {
-		return this.#subscribers.get(eventName)?.has(contextEventHandler);
-	}
-
-	get [Symbol.toStringTag]() {
-		return 'Subscribr';
-	}
-}

package/src/subscription.js

@@ -1,37 +0,0 @@
-/** @typedef { import('./context-event-handler.js').default } ContextEventHandler */
-
-export default class Subscription {
-	#eventName;
-	#contextEventHandler;
-
-	/**
-	 * @param {string} eventName The event name.
-	 * @param {ContextEventHandler} contextEventHandler Then context event handler.
-	 */
-	constructor(eventName, contextEventHandler) {
-		this.#eventName = eventName;
-		this.#contextEventHandler = contextEventHandler;
-	}
-
-	/**
-	 * Gets the event name for the subscription.
-	 *
-	 * @returns {string} The event name.
-	 */
-	get eventName() {
-		return this.#eventName;
-	}
-
-	/**
-	 * Gets the context event handler.
-	 *
-	 * @returns {ContextEventHandler} The context event handler
-	 */
-	get contextEventHandler() {
-		return this.#contextEventHandler;
-	}
-
-	get [Symbol.toStringTag]() {
-		return 'Subscription';
-	}
-}