event-emission 0.2.0 → 0.3.0

package/README.md

@@ -9,6 +9,7 @@ A lightweight, zero-dependency, type-safe event system with DOM EventTarget ergo
 - **Typed events** - Event maps keep payloads and event names in sync
 - **DOM compatible** - `EmissionEvent` is a superset of the built-in `Event`
 - **Familiar API** - `addEventListener`, `removeEventListener`, `dispatchEvent`
+- **Node.js compatible** - `emit`, `on`, `off`, `addListener`, `removeListener`, `prependListener`, and more
 - **TC39 Observable** - Fully compliant `Observable` implementation (passes all `es-observable-tests`)
 - **Async iteration** - `for await...of` over events with backpressure options
 - **Wildcard listeners** - Listen to `*` or namespaced `user:*` patterns
@@ -59,17 +60,38 @@ events.dispatchEvent({
 ## Core concepts
 
 - **Event map**: a TypeScript type that maps event names to payload types.
-- **Event shape**: `{ type: string; detail: Payload }` for all listeners.
+- **Event shape**: `{ type: string; detail: Payload; bubbles?: boolean; cancelable?: boolean; composed?: boolean }` for dispatch.
 - **Unsubscribe**: `addEventListener` returns a function to remove the listener.
 
 ## API overview
 
+Core (`event-emission`):
+
 - `createEventTarget<E>(options?)`
 - `createEventTarget(target, { observe: true, ... })`
 - `EventEmission<E>` base class
-- `Observable<T>` compliant implementation
-- Interop: `fromEventTarget`, `forwardToEventTarget`, `pipe`
-- Utilities: `isObserved`, `getOriginal`
+
+Optional subpaths:
+
+- `Observable<T>` compliant implementation (`event-emission/observable`)
+- Interoperability: `fromEventTarget`, `forwardToEventTarget`, `pipe` (`event-emission/interoperability`)
+- Observe utilities: `isObserved`, `getOriginal`, `setupEventForwarding` (`event-emission/observe`)
+- Types-only exports (`event-emission/types`)
+
+## Subpath exports
+
+To keep the core entrypoint lean, optional features are exposed via subpath exports:
+
+```typescript
+import { Observable } from 'event-emission/observable';
+import { getOriginal, isObserved, setupEventForwarding } from 'event-emission/observe';
+import {
+  forwardToEventTarget,
+  fromEventTarget,
+  pipe,
+} from 'event-emission/interoperability';
+import type { EventTargetLike } from 'event-emission/types';
+```
 
 ## createEventTarget
 
@@ -117,11 +139,29 @@ state.user.name = 'Grace'; // Triggers 'update' and 'update:user.name'
 
 **Observe options:**
 
-| Option          | Type                            | Default  | Description                        |
-| --------------- | ------------------------------- | -------- | ---------------------------------- |
-| `observe`       | `boolean`                       | `false`  | Enable property change observation |
-| `deep`          | `boolean`                       | `true`   | Observe nested objects             |
-| `cloneStrategy` | `'shallow' \| 'deep' \| 'path'` | `'path'` | How to clone previous state        |
+Deep observation is enabled by default.
+
+| Option          | Type                            | Default  | Description                                                        |
+| --------------- | ------------------------------- | -------- | ------------------------------------------------------------------ |
+| `observe`       | `boolean`                       | `false`  | Enable property change observation                                 |
+| `deep`          | `boolean`                       | `true`   | Observe nested objects                                             |
+| `cloneStrategy` | `'shallow' \| 'deep' \| 'path'` | `'path'` | How to clone previous state                                        |
+| `deepClone`     | `<T>(value: T) => T`            | -        | Optional deep clone fallback when `structuredClone` is unavailable |
+
+Note: `cloneStrategy: 'deep'` uses `structuredClone` by default, or `deepClone` if provided.
+
+Example fallback:
+
+```typescript
+const state = createEventTarget(
+  { count: 0, user: { name: 'Ada' } },
+  {
+    observe: true,
+    cloneStrategy: 'deep',
+    deepClone: (value) => JSON.parse(JSON.stringify(value)),
+  },
+);
+```
 
 **Update event details:**
 
@@ -130,9 +170,21 @@ state.user.name = 'Grace'; // Triggers 'update' and 'update:user.name'
 
 ## Event listeners
 
+### `on(type, listener)`
+
+When called with a listener function (or `EventListenerObject`), `on` behaves like Node.js `addListener`—it registers the listener and returns an unsubscribe function.
+
+```typescript
+const unsubscribe = events.on('message', (event) => {
+  console.log(event.detail.text);
+});
+
+unsubscribe(); // Remove the listener
+```
+
 ### `on(type, options?)`
 
-Creates an `Observable` for a specific event type. This follows the `ObservableEventTarget` proposal, allowing for powerful composition.
+When called without a listener (or with an options object / boolean), `on` creates an `Observable` for a specific event type. This follows the `ObservableEventTarget` proposal, allowing for powerful composition.
 
 ```typescript
 const clicks = button.on('click', { passive: true });
@@ -146,6 +198,7 @@ clicks.subscribe((event) => {
 
 | Option         | Type          | Default | Description                                                                            |
 | -------------- | ------------- | ------- | -------------------------------------------------------------------------------------- |
+| `capture`      | `boolean`     | `false` | If true, listen during the capture phase                                               |
 | `receiveError` | `boolean`     | `false` | If true, listen for "error" events and forward them to the observer's error method     |
 | `handler`      | `Function`    | `null`  | Optional function to run stateful actions (like `preventDefault()`) before dispatching |
 | `once`         | `boolean`     | `false` | If true, the observable completes after the first event is dispatched                  |
@@ -164,18 +217,22 @@ const unsubscribe = events.addEventListener('message', (event) => {
 unsubscribe();
 ```
 
-**Options:**
+**Options:** (or pass `true`/`false` for capture)
+
+| Option    | Type          | Description                                  |
+| --------- | ------------- | -------------------------------------------- |
+| `capture` | `boolean`     | Listen during the capture phase              |
+| `once`    | `boolean`     | Remove listener after first invocation       |
+| `passive` | `boolean`     | Listener will not call `preventDefault()`    |
+| `signal`  | `AbortSignal` | Abort signal to remove listener when aborted |
 
-| Option   | Type          | Description                                  |
-| -------- | ------------- | -------------------------------------------- |
-| `once`   | `boolean`     | Remove listener after first invocation       |
-| `signal` | `AbortSignal` | Abort signal to remove listener when aborted |
+Note: `preventDefault()` only affects events dispatched with `cancelable: true`. `dispatchEvent` returns `false` when a cancelable event is prevented.
 
 ### `once(type, listener, options?)`
 
 Adds a one-time listener.
 
-### `removeEventListener(type, listener)`
+### `removeEventListener(type, listener, options?)`
 
 Removes a specific listener.
 
@@ -197,6 +254,70 @@ events.addWildcardListener('user:*', (event) => {
 
 Wildcard events include `{ type: pattern, originalType, detail }`.
 
+## Node.js EventEmitter compatibility
+
+Every event target also exposes the familiar Node.js `EventEmitter` interface, so you can use whichever style fits your codebase.
+
+### `emit(type, detail)`
+
+Dispatches an event and returns `true` if listeners were registered for that type, `false` otherwise.
+
+```typescript
+events.on('message', (event) => {
+  console.log(event.detail.text);
+});
+
+events.emit('message', { text: 'hello' }); // true
+events.emit('unknown', undefined); // false
+```
+
+### `off(type, listener)`
+
+Removes a listener. Alias for `removeEventListener(type, listener)`.
+
+### `addListener(type, listener)` / `removeListener(type, listener)`
+
+Aliases for `addEventListener` and `removeEventListener`.
+
+### `prependListener(type, listener)`
+
+Adds a listener at the **beginning** of the listener list. Returns an unsubscribe function.
+
+```typescript
+events.addEventListener('data', () => console.log('second'));
+events.prependListener('data', () => console.log('first'));
+
+events.emit('data', value); // logs "first", then "second"
+```
+
+### `prependOnceListener(type, listener)`
+
+Like `prependListener`, but the listener is removed after its first invocation.
+
+### `listeners(type)`
+
+Returns an array of the listener functions registered for the given type.
+
+### `rawListeners(type)`
+
+Like `listeners`, but once-listeners return a wrapper function with a `.listener` property pointing to the original callback.
+
+### `listenerCount(type)`
+
+Returns the number of listeners registered for the given type.
+
+### `eventNames()`
+
+Returns an array of event type strings that currently have registered listeners.
+
+```typescript
+events.on('foo', () => {});
+events.on('bar', () => {});
+
+events.eventNames(); // ['foo', 'bar']
+events.listenerCount('foo'); // 1
+```
+
 ## Async iteration
 
 You can use `for await...of` to consume events. This is great for stream-processing events with backpressure.
@@ -266,7 +387,7 @@ observable
 A fully compliant implementation of the TC39 Observable proposal.
 
 ```typescript
-import { Observable } from 'event-emission';
+import { Observable } from 'event-emission/observable';
 
 // Create from items
 const numbers = Observable.of(1, 2, 3);
@@ -316,7 +437,7 @@ class UserService extends EventEmission<{
 ### `fromEventTarget(domTarget, eventTypes, options?)`
 
 ```typescript
-import { fromEventTarget } from 'event-emission';
+import { fromEventTarget } from 'event-emission/interoperability';
 
 type ButtonEvents = {
   click: MouseEvent;
@@ -336,7 +457,8 @@ events.destroy();
 ### `forwardToEventTarget(source, domTarget, options?)`
 
 ```typescript
-import { createEventTarget, forwardToEventTarget } from 'event-emission';
+import { createEventTarget } from 'event-emission';
+import { forwardToEventTarget } from 'event-emission/interoperability';
 
 const events = createEventTarget<{ custom: { value: number } }>();
 const element = document.getElementById('target');
@@ -351,7 +473,8 @@ unsubscribe();
 ### `pipe(source, target, options?)`
 
 ```typescript
-import { createEventTarget, pipe } from 'event-emission';
+import { createEventTarget } from 'event-emission';
+import { pipe } from 'event-emission/interoperability';
 
 const componentEvents = createEventTarget<{ ready: void }>();
 const appBus = createEventTarget<{ ready: void }>();
@@ -361,7 +484,7 @@ const unsubscribe = pipe(componentEvents, appBus);
 unsubscribe();
 ```
 
-Note: `pipe(source, target)` forwards all events via a wildcard listener. The instance method `events.pipe(target)` only forwards event types that already have listeners when you call it.
+Note: Both `pipe(source, target)` and `events.pipe(target)` forward all events via a wildcard listener. Use a map function to transform events or return `null` to filter.
 
 ## React integration
 
@@ -451,26 +574,36 @@ const state = useObservable(store);
 
 Checks if an object is an observed proxy.
 
+```typescript
+import { isObserved } from 'event-emission/observe';
+```
+
 ### `getOriginal(proxy)`
 
 Returns the original unproxied object.
 
+```typescript
+import { getOriginal } from 'event-emission/observe';
+```
+
 ## TypeScript types
 
 ```typescript
 import type {
   EmissionEvent,
   EventTargetLike,
-  Observable,
   ObservableLike,
   Observer,
   Subscription,
   WildcardEvent,
   AddEventListenerOptionsLike,
+} from 'event-emission/types';
+
+import type {
   ObservableEventMap,
   PropertyChangeDetail,
   ArrayMutationDetail,
-  Subscriber,
-  SubscriptionObserver,
-} from 'event-emission';
+} from 'event-emission/observe';
+
+import type { Subscriber, SubscriptionObserver } from 'event-emission/observable';
 ```

package/dist/event-emission.d.ts

@@ -1,5 +1,5 @@
 import { SymbolObservable } from './symbols';
-import type { AddEventListenerOptionsLike, EmissionEvent, EventsIteratorOptions, EventTargetLike, ObservableLike, Observer, OnOptions, Subscription, WildcardEvent } from './types';
+import type { AddEventListenerOptionsLike, DispatchEventInput, DOMEventLike, EmissionEvent, EventListenerLike, EventListenerOptionsLike, EventsIteratorOptions, EventTargetLike, ObservableLike, Observer, OnOptions, Subscription, WildcardEvent } from './types';
 /**
  * Abstract base class for typed event emitters with DOM EventTarget
  * and TC39 Observable compatibility.
@@ -7,7 +7,7 @@ import type { AddEventListenerOptionsLike, EmissionEvent, EventsIteratorOptions,
  * Extend this class to create custom event emitters with typed events.
  * The class provides:
  * - DOM EventTarget compatible API (addEventListener, removeEventListener, dispatchEvent)
- * - TC39 Observable interop (subscribe, Symbol.observable)
+ * - TC39 Observable interoperability (subscribe, Symbol.observable)
  * - Async iteration support (events() method)
  * - Wildcard listeners for namespaced events
  * - Lifecycle management (complete(), completed)
@@ -39,7 +39,7 @@ import type { AddEventListenerOptionsLike, EmissionEvent, EventsIteratorOptions,
  * });
  * ```
  *
- * @example TC39 Observable interop
+ * @example TC39 Observable interoperability
  * ```typescript
  * const service = new UserService();
  *
@@ -67,7 +67,7 @@ import type { AddEventListenerOptionsLike, EmissionEvent, EventsIteratorOptions,
 export declare abstract class EventEmission<E extends Record<string, any>> {
     #private;
     /**
-     * Returns this observable for Symbol.observable interop.
+     * Returns this observable for Symbol.observable interoperability.
      */
     [SymbolObservable]: () => ObservableLike<EmissionEvent<E[keyof E]>>;
     constructor();
@@ -75,25 +75,30 @@ export declare abstract class EventEmission<E extends Record<string, any>> {
      * Adds an event listener for the specified event type.
      * Returns an unsubscribe function for convenience.
      */
-    addEventListener<K extends keyof E & string>(type: K, listener: (event: EmissionEvent<E[K]>) => void | Promise<void>, options?: AddEventListenerOptionsLike): () => void;
+    addEventListener<K extends keyof E & string>(type: K, listener: EventListenerLike<EmissionEvent<E[K], K>> | null, options?: AddEventListenerOptionsLike | boolean): () => void;
     /**
      * Removes an event listener for the specified event type.
      */
-    removeEventListener<K extends keyof E & string>(type: K, listener: (event: EmissionEvent<E[K]>) => void | Promise<void>): void;
+    removeEventListener<K extends keyof E & string>(type: K, listener: EventListenerLike<EmissionEvent<E[K], K>> | null, options?: EventListenerOptionsLike | boolean): void;
     /**
      * Dispatches an event to all registered listeners.
      * Returns false if the emitter has been completed, true otherwise.
      */
-    dispatchEvent<K extends keyof E & string>(event: EmissionEvent<E[K]>): boolean;
+    dispatchEvent<K extends keyof E & string>(event: DispatchEventInput<E[K], K> | DOMEventLike): boolean;
+    /**
+     * Adds a listener for the specified event type (Node.js-style).
+     * Returns an unsubscribe function.
+     */
+    on<K extends keyof E & string>(type: K, listener: EventListenerLike<EmissionEvent<E[K], K>>): () => void;
     /**
      * Returns an observable for the specified event type.
      */
-    on<K extends keyof E & string>(type: K, options?: OnOptions | boolean): ObservableLike<EmissionEvent<E[K]>>;
+    on<K extends keyof E & string>(type: K, options?: OnOptions | boolean): ObservableLike<EmissionEvent<E[K], K>>;
     /**
      * Adds a one-time listener for the specified event type.
      * Returns an unsubscribe function.
      */
-    once<K extends keyof E & string>(type: K, listener: (event: EmissionEvent<E[K]>) => void | Promise<void>, options?: Omit<AddEventListenerOptionsLike, 'once'>): () => void;
+    once<K extends keyof E & string>(type: K, listener: EventListenerLike<EmissionEvent<E[K], K>> | null, options?: Omit<AddEventListenerOptionsLike, 'once'> | boolean): () => void;
     /**
      * Removes all listeners, or those of the specified event type.
      */
@@ -104,10 +109,54 @@ export declare abstract class EventEmission<E extends Record<string, any>> {
     clear(): void;
     /**
      * Pipe events from this emitter to another target.
-     * Note: Only forwards events for types that have listeners when pipe() is called.
-     * Events for types registered after piping won't be forwarded automatically.
+     * Forwards all events. If mapFn returns null, the event is skipped.
+     */
+    pipe<T extends Record<string, any>>(target: EventTargetLike<T>, mapFn?: <K extends keyof E & string>(event: EmissionEvent<E[K], K>) => DispatchEventInput<T[keyof T & string], keyof T & string> | null): () => void;
+    /**
+     * Emits an event with the given type and detail.
+     * Returns true if the event type had registered listeners, false otherwise.
+     */
+    emit<K extends keyof E & string>(type: K, detail: E[K]): boolean;
+    /**
+     * Removes a listener for the specified event type.
+     */
+    off<K extends keyof E & string>(type: K, listener: EventListenerLike<EmissionEvent<E[K], K>>): void;
+    /**
+     * Adds a listener for the specified event type.
+     * Returns an unsubscribe function.
+     */
+    addListener<K extends keyof E & string>(type: K, listener: EventListenerLike<EmissionEvent<E[K], K>>): () => void;
+    /**
+     * Removes a listener for the specified event type.
+     */
+    removeListener<K extends keyof E & string>(type: K, listener: EventListenerLike<EmissionEvent<E[K], K>>): void;
+    /**
+     * Adds a listener at the beginning of the listener list for the specified type.
+     * Returns an unsubscribe function.
+     */
+    prependListener<K extends keyof E & string>(type: K, listener: EventListenerLike<EmissionEvent<E[K], K>>): () => void;
+    /**
+     * Adds a one-time listener at the beginning of the listener list.
+     * Returns an unsubscribe function.
+     */
+    prependOnceListener<K extends keyof E & string>(type: K, listener: EventListenerLike<EmissionEvent<E[K], K>>): () => void;
+    /**
+     * Returns an array of listener functions for the specified event type.
+     */
+    listeners<K extends keyof E & string>(type: K): Array<EventListenerLike<EmissionEvent<E[K], K>>>;
+    /**
+     * Returns an array of listener functions for the specified event type.
+     * Once-listeners return a wrapper with a `.listener` property pointing to the original.
+     */
+    rawListeners<K extends keyof E & string>(type: K): Array<EventListenerLike<EmissionEvent<E[K], K>>>;
+    /**
+     * Returns the number of listeners for the specified event type.
+     */
+    listenerCount<K extends keyof E & string>(type: K): number;
+    /**
+     * Returns an array of event type names that have registered listeners.
      */
-    pipe<T extends Record<string, any>>(target: EventTargetLike<T>, mapFn?: <K extends keyof E & string>(event: EmissionEvent<E[K]>) => EmissionEvent<T[keyof T & string]> | null): () => void;
+    eventNames(): Array<string>;
     /**
      * Adds a wildcard listener that receives events matching the pattern.
      * Use '*' for all events, or 'namespace:*' for namespaced events.
@@ -124,7 +173,7 @@ export declare abstract class EventEmission<E extends Record<string, any>> {
     /**
      * Subscribes an observer to events of a specific type (typed).
      */
-    subscribe<K extends keyof E & string>(type: K, observerOrNext?: Observer<EmissionEvent<E[K]>> | ((value: EmissionEvent<E[K]>) => void), error?: (err: unknown) => void, completeHandler?: () => void): Subscription;
+    subscribe<K extends keyof E & string>(type: K, observerOrNext?: Observer<EmissionEvent<E[K], K>> | ((value: EmissionEvent<E[K], K>) => void), error?: (err: unknown) => void, completeHandler?: () => void): Subscription;
     /**
      * Returns an observable that emits all events.
      */
@@ -152,6 +201,6 @@ export declare abstract class EventEmission<E extends Record<string, any>> {
      * }
      * ```
      */
-    events<K extends keyof E & string>(type: K, options?: EventsIteratorOptions): AsyncIterableIterator<EmissionEvent<E[K]>>;
+    events<K extends keyof E & string>(type: K, options?: EventsIteratorOptions): AsyncIterableIterator<EmissionEvent<E[K], K>>;
 }
 //# sourceMappingURL=event-emission.d.ts.map

package/dist/event-emission.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-emission.d.ts","sourceRoot":"","sources":["../src/event-emission.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"event-emission.d.ts","sourceRoot":"","sources":["../src/event-emission.ts"],"names":[],"mappings":"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"}

package/dist/factory.d.ts

@@ -15,7 +15,7 @@ export interface CreateEventTargetOptions {
  * Extends CreateEventTargetOptions with proxy observation settings.
  *
  * @property observe - Must be true to enable observation mode.
- * @property deep - If true, nested objects are also observed (default: false).
+ * @property deep - If true, nested objects are also observed (default: true).
  * @property cloneStrategy - Strategy for cloning previous state: 'shallow', 'deep', or 'path'.
  */
 export interface CreateEventTargetObserveOptions extends CreateEventTargetOptions, ObserveOptions {

package/dist/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAGV,eAAe,EAOhB,MAAM,SAAS,CAAC;AAcjB;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,+EAA+E;IAC/E,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,+BACf,SAAQ,wBAAwB,EAAE,cAAc;IAChD,+CAA+C;IAC/C,OAAO,EAAE,IAAI,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7D,IAAI,CAAC,EAAE,wBAAwB,GAC9B,eAAe,CAAC,CAAC,CAAC,CAAC;AAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAChD,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,+BAA+B,GACpC,CAAC,GAAG,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAKV,eAAe,EAOhB,MAAM,SAAS,CAAC;AAyCjB;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,+EAA+E;IAC/E,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,+BACf,SAAQ,wBAAwB,EAAE,cAAc;IAChD,+CAA+C;IAC/C,OAAO,EAAE,IAAI,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7D,IAAI,CAAC,EAAE,wBAAwB,GAC9B,eAAe,CAAC,CAAC,CAAC,CAAC;AAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAChD,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,+BAA+B,GACpC,CAAC,GAAG,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC"}