event-emission 0.2.0 → 0.2.1

package/README.md

@@ -59,17 +59,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 +138,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:**
 
@@ -146,6 +185,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 +204,22 @@ const unsubscribe = events.addEventListener('message', (event) => {
 unsubscribe();
 ```
 
-**Options:**
+**Options:** (or pass `true`/`false` for capture)
 
-| Option   | Type          | Description                                  |
-| -------- | ------------- | -------------------------------------------- |
-| `once`   | `boolean`     | Remove listener after first invocation       |
-| `signal` | `AbortSignal` | Abort signal to remove listener when aborted |
+| 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 |
+
+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.
 
@@ -266,7 +310,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 +360,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 +380,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 +396,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 +407,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 +497,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,25 @@ 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;
     /**
      * 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 +104,9 @@ 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]>) => EmissionEvent<T[keyof T & string]> | null): () => void;
+    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;
     /**
      * Adds a wildcard listener that receives events matching the pattern.
      * Use '*' for all events, or 'namespace:*' for namespaced events.
@@ -124,7 +123,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 +151,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,EAIV,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"}