mvc-kit 2.5.5 → 2.6.0

package/README.md

@@ -497,18 +497,31 @@ class ChatViewModel extends ViewModel<State> {
 }
 ```
 
+### `listenTo(source, event, handler)` (protected)
+
+Subscribe to a typed event on a Channel or EventBus with automatic cleanup on dispose (and reset, for ViewModels). The event counterpart to `subscribeTo`.
+
+```typescript
+class ChatViewModel extends ViewModel<State> {
+  private channel = singleton(ChatChannel);
+
+  protected onInit() {
+    this.listenTo(this.channel, 'message', (msg) => {
+      this.set({ messages: [...this.state.messages, msg] });
+    });
+  }
+}
+```
+
+Available on ViewModel, Controller, Channel, and Model.
+
 ### `addCleanup(fn)` (protected)
 
-Register a teardown callback that fires on `dispose()`, after disposeSignal abort but before `onDispose()`. No manual bookkeeping needed.
+Register a teardown callback that fires on `dispose()`, after disposeSignal abort but before `onDispose()`. Use for timers and external subscriptions not covered by `subscribeTo` or `listenTo`.
 
 ```typescript
 class DashboardController extends Controller {
   protected onInit() {
-    // Subscriptions are automatically cleaned up on dispose
-    const unsub = someStore.subscribe(() => this.refresh());
-    this.addCleanup(unsub);
-
-    // Timers too
     const id = setInterval(() => this.poll(), 5000);
     this.addCleanup(() => clearInterval(id));
   }

package/agent-config/claude-code/skills/guide/anti-patterns.md

@@ -451,7 +451,24 @@ Persistence adds I/O overhead on every mutation. For high-churn data, this cause
 
 ---
 
-## 19. Missing hydrate() for Async Adapters
+## 19. Using addCleanup for channel.on()/bus.on() Subscriptions
+
+```typescript
+// BAD — manual addCleanup is easy to forget and not reset-safe
+protected onInit() {
+  const unsub = this.channel.on('message', handler);
+  this.addCleanup(unsub);
+}
+
+// GOOD — listenTo auto-cleans up on dispose and reset
+protected onInit() {
+  this.listenTo(this.channel, 'message', handler);
+}
+```
+
+---
+
+## 20. Missing hydrate() for Async Adapters
 
 ```typescript
 // BAD — accessing items before hydrate() on async adapter

package/agent-config/claude-code/skills/guide/api-reference.md

@@ -68,6 +68,7 @@ class MyVM extends ViewModel<State, { saved: { id: string }; error: void }> {
 ### Cleanup
 - `disposeSignal: AbortSignal` — Lazily created, auto-aborted on `dispose()`.
 - `subscribeTo(source: Subscribable, listener): void` — Auto-unsubscribe on dispose.
+- `listenTo(source: EventSource, event, handler): void` — Subscribe to Channel/EventBus event with auto-cleanup on dispose and reset.
 - `addCleanup(fn: () => void): void` — Register teardown callback.
 - `subscribe(listener: Listener<S>): () => void` — Subscribe to state changes.
 - `dispose(): void` — Idempotent. `set()` and `emit()` become no-ops after dispose.
@@ -105,7 +106,7 @@ protected validate(state: S): ValidationErrors<S> {
 ```
 
 ### Lifecycle & Cleanup
-Same as ViewModel: `onInit()`, `onSet()`, `onDispose()`, `disposeSignal`, `subscribeTo()`, `addCleanup()`, `subscribe()`, `dispose()`.
+Same as ViewModel: `onInit()`, `onSet()`, `onDispose()`, `disposeSignal`, `subscribeTo()`, `listenTo()`, `addCleanup()`, `subscribe()`, `dispose()`.
 
 ---
 
@@ -273,6 +274,7 @@ Stateless orchestrator. Component-scoped.
 - `onDispose(): void`
 - `disposeSignal: AbortSignal`
 - `subscribeTo(source, listener): void`
+- `listenTo(source, event, handler): void`
 - `addCleanup(fn): void`
 - `dispose(): void`
 

package/agent-config/claude-code/skills/guide/patterns.md

@@ -88,7 +88,7 @@ class LocationsViewModel extends ViewModel<State> {
 }
 ```
 
-Use `subscribeTo()` only for imperative side effects (e.g. play a sound on new messages), not for deriving values.
+Use `subscribeTo()` only for imperative side effects (e.g. play a sound on new messages), not for deriving values. Use `listenTo()` for Channel/EventBus event subscriptions — it auto-cleans up on dispose and reset.
 
 ---
 

package/agent-config/copilot/copilot-instructions.md

@@ -34,7 +34,7 @@ import { NativeCollection } from 'mvc-kit/react-native';
 4. **One ViewModel per component** via `useLocal`. No `useEffect` for data loading — use `onInit()`.
 5. **No `useState`/`useMemo`/`useCallback`** — the ViewModel is the hook.
 6. **Components are declarative.** Read `state.x` for raw, `vm.x` for computed, `vm.async.x` for loading/error.
-7. **Collections are encapsulated.** ViewModel getters read from collections directly — auto-tracking handles reactivity. Use `subscribeTo()` only for imperative side effects. Components never import Collections.
+7. **Collections are encapsulated.** ViewModel getters read from collections directly — auto-tracking handles reactivity. Use `subscribeTo()` only for imperative side effects. Use `listenTo()` for Channel/EventBus event subscriptions (auto-cleanup on dispose and reset). Components never import Collections.
 8. **Services are stateless.** Accept `AbortSignal`, throw `HttpError`, no knowledge of ViewModels.
 9. **Pass `this.disposeSignal`** to every async call.
 10. **Lifecycle**: `construct → init() → use → dispose()`. Hooks auto-call `init()`.

package/agent-config/cursor/cursorrules

@@ -34,7 +34,7 @@ import { NativeCollection } from 'mvc-kit/react-native';
 4. **One ViewModel per component** via `useLocal`. No `useEffect` for data loading — use `onInit()`.
 5. **No `useState`/`useMemo`/`useCallback`** — the ViewModel is the hook.
 6. **Components are declarative.** Read `state.x` for raw, `vm.x` for computed, `vm.async.x` for loading/error.
-7. **Collections are encapsulated.** ViewModel getters read from collections directly — auto-tracking handles reactivity. Use `subscribeTo()` only for imperative side effects. Components never import Collections.
+7. **Collections are encapsulated.** ViewModel getters read from collections directly — auto-tracking handles reactivity. Use `subscribeTo()` only for imperative side effects. Use `listenTo()` for Channel/EventBus event subscriptions (auto-cleanup on dispose and reset). Components never import Collections.
 8. **Services are stateless.** Accept `AbortSignal`, throw `HttpError`, no knowledge of ViewModels.
 9. **Pass `this.disposeSignal`** to every async call.
 10. **Lifecycle**: `construct → init() → use → dispose()`. Hooks auto-call `init()`.

package/dist/Channel.cjs

@@ -193,6 +193,12 @@ class Channel {
     this.addCleanup(unsubscribe);
     return unsubscribe;
   }
+  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */
+  listenTo(source, event, handler) {
+    const unsubscribe = source.on(event, handler);
+    this.addCleanup(unsubscribe);
+    return unsubscribe;
+  }
   // ── Backoff ─────────────────────────────────────────────────────
   /** Computes the reconnect backoff delay with jitter for the given attempt number. @protected */
   _calculateDelay(attempt) {

package/dist/Channel.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Channel.cjs","sources":["../src/Channel.ts"],"sourcesContent":["import type { Listener, Subscribable, Disposable, Initializable } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// ── Types ─────────────────────────────────────────────────────────\n\n/** Describes the current connection state of a Channel. */\nexport interface ChannelStatus {\n  readonly connected: boolean;\n  readonly reconnecting: boolean;\n  readonly attempt: number;\n  readonly error: string | null;\n}\n\ntype Handler<T> = (payload: T) => void;\n\nconst enum ConnectionState {\n  Idle,\n  Connecting,\n  Connected,\n  Reconnecting,\n  Disposed,\n}\n\nconst INITIAL_STATUS: ChannelStatus = Object.freeze({\n  connected: false,\n  reconnecting: false,\n  attempt: 0,\n  error: null,\n});\n\n// ── Channel ───────────────────────────────────────────────────────\n\n/**\n * Abstract persistent connection with automatic reconnection and exponential backoff.\n * Subclass to implement WebSocket, SSE, or other transport protocols.\n */\nexport abstract class Channel<M extends Record<string, any>>\n  implements Subscribable<ChannelStatus>, Initializable, Disposable\n{\n  // Static config (subclass overrides)\n  /** Base delay (ms) for reconnection backoff. */\n  static RECONNECT_BASE = 1000;\n  /** Maximum delay cap (ms) for reconnection backoff. */\n  static RECONNECT_MAX = 30000;\n  /** Exponential backoff multiplier for reconnection delay. */\n  static RECONNECT_FACTOR = 2;\n  /** Maximum number of reconnection attempts before giving up. */\n  static MAX_ATTEMPTS = Infinity;\n\n  // ── Internal state ──────────────────────────────────────────────\n  private _status: ChannelStatus = INITIAL_STATUS;\n  private _connState: ConnectionState = ConnectionState.Idle;\n  private _disposed = false;\n  private _initialized = false;\n  private _listeners = new Set<Listener<ChannelStatus>>();\n  private _handlers = new Map<keyof M, Set<Handler<unknown>>>();\n  private _abortController: AbortController | null = null;\n  private _connectAbort: AbortController | null = null;\n  private _reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private _cleanups: (() => void)[] | null = null;\n\n  // ── Subscribable<ChannelStatus> ─────────────────────────────────\n\n  /** Current connection status. */\n  get state(): ChannelStatus {\n    return this._status;\n  }\n\n  /** Subscribes to connection status changes. Returns an unsubscribe function. */\n  subscribe(listener: Listener<ChannelStatus>): () => void {\n    if (this._disposed) return () => {};\n    this._listeners.add(listener);\n    return () => { this._listeners.delete(listener); };\n  }\n\n  // ── Disposable / Initializable ──────────────────────────────────\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /** Tears down the instance, releasing all subscriptions and resources. */\n  dispose(): void {\n    if (this._disposed) return;\n    this._disposed = true;\n    this._connState = ConnectionState.Disposed;\n\n    // Cancel pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    // Abort per-connection signal\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    // Abort dispose signal\n    this._abortController?.abort();\n\n    // Close transport\n    try { this.close(); } catch { /* swallow close errors during dispose */ }\n\n    // Run cleanups\n    if (this._cleanups) {\n      for (const fn of this._cleanups) fn();\n      this._cleanups = null;\n    }\n\n    this.onDispose?.();\n    this._listeners.clear();\n    this._handlers.clear();\n  }\n\n  // ── Subclass contract ───────────────────────────────────────────\n\n  /** Establishes the underlying connection. Called internally by connect(). @protected */\n  protected abstract open(signal: AbortSignal): void | Promise<void>;\n  /** Tears down the underlying connection. Called internally by disconnect() and dispose(). @protected */\n  protected abstract close(): void;\n\n  // ── Connection control ──────────────────────────────────────────\n\n  /** Initiates a connection with automatic reconnection on failure. */\n  connect(): void {\n    if (this._disposed) {\n      if (__DEV__) {\n        console.warn('[mvc-kit] connect() called after dispose — ignored.');\n      }\n      return;\n    }\n    if (__DEV__ && !this._initialized) {\n      console.warn('[mvc-kit] connect() called before init().');\n    }\n    if (\n      this._connState === ConnectionState.Connecting ||\n      this._connState === ConnectionState.Connected\n    ) {\n      return;\n    }\n\n    // Cancel any pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    this._attemptConnect(0);\n  }\n\n  /** Closes the connection and cancels any pending reconnection. */\n  disconnect(): void {\n    if (this._disposed) return;\n\n    // Cancel pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    // Abort current connection attempt\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    // Close transport\n    if (\n      this._connState === ConnectionState.Connected ||\n      this._connState === ConnectionState.Connecting\n    ) {\n      this._connState = ConnectionState.Idle;\n      try { this.close(); } catch { /* swallow */ }\n    } else {\n      this._connState = ConnectionState.Idle;\n    }\n\n    this._setStatus({ connected: false, reconnecting: false, attempt: 0, error: null });\n  }\n\n  // ── Subclass signals ────────────────────────────────────────────\n\n  /** Call from subclass when a message arrives from the transport. @protected */\n  protected receive<K extends keyof M>(type: K, payload: M[K]): void {\n    if (this._disposed) {\n      if (__DEV__) {\n        console.warn(`[mvc-kit] receive(\"${String(type)}\") called after dispose — ignored.`);\n      }\n      return;\n    }\n\n    const handlers = this._handlers.get(type);\n    if (handlers) {\n      for (const handler of handlers) {\n        handler(payload);\n      }\n    }\n  }\n\n  /** Call from subclass when the transport connection drops unexpectedly. Triggers reconnection. @protected */\n  protected disconnected(): void {\n    if (this._disposed) return;\n    // Only trigger reconnect from connected or connecting states\n    if (\n      this._connState !== ConnectionState.Connected &&\n      this._connState !== ConnectionState.Connecting\n    ) {\n      return;\n    }\n\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    this._connState = ConnectionState.Reconnecting;\n    this._scheduleReconnect(1);\n  }\n\n  // ── Consumer API ────────────────────────────────────────────────\n\n  /** Subscribes to a specific message type. Returns an unsubscribe function. */\n  on<K extends keyof M>(type: K, handler: Handler<M[K]>): () => void {\n    if (this._disposed) return () => {};\n\n    let handlers = this._handlers.get(type);\n    if (!handlers) {\n      handlers = new Set();\n      this._handlers.set(type, handlers);\n    }\n    handlers.add(handler as Handler<unknown>);\n\n    return () => { handlers!.delete(handler as Handler<unknown>); };\n  }\n\n  /** Subscribes to a message type, auto-removing the handler after the first invocation. */\n  once<K extends keyof M>(type: K, handler: Handler<M[K]>): () => void {\n    const unsubscribe = this.on(type, (payload) => {\n      unsubscribe();\n      handler(payload);\n    });\n    return unsubscribe;\n  }\n\n  // ── Infrastructure ──────────────────────────────────────────────\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n\n  // ── Backoff ─────────────────────────────────────────────────────\n\n  /** Computes the reconnect backoff delay with jitter for the given attempt number. @protected */\n  protected _calculateDelay(attempt: number): number {\n    const ctor = this.constructor as typeof Channel;\n    const capped = Math.min(\n      ctor.RECONNECT_BASE * Math.pow(ctor.RECONNECT_FACTOR, attempt),\n      ctor.RECONNECT_MAX,\n    );\n    return Math.random() * capped;\n  }\n\n  // ── Internals ───────────────────────────────────────────────────\n\n  private _setStatus(next: ChannelStatus): void {\n    const prev = this._status;\n    if (\n      prev.connected === next.connected &&\n      prev.reconnecting === next.reconnecting &&\n      prev.attempt === next.attempt &&\n      prev.error === next.error\n    ) {\n      return;\n    }\n\n    this._status = Object.freeze(next);\n    for (const listener of this._listeners) {\n      listener(this._status, prev);\n    }\n  }\n\n  private _attemptConnect(attempt: number): void {\n    if (this._disposed) return;\n\n    this._connState = ConnectionState.Connecting;\n\n    // Create per-connection abort controller\n    this._connectAbort?.abort();\n    this._connectAbort = new AbortController();\n\n    const signal = this._abortController\n      ? AbortSignal.any([this._abortController.signal, this._connectAbort.signal])\n      : this._connectAbort.signal;\n\n    this._setStatus({\n      connected: false,\n      reconnecting: attempt > 0,\n      attempt,\n      error: null,\n    });\n\n    let result: void | Promise<void>;\n    try {\n      result = this.open(signal);\n    } catch (e) {\n      this._onOpenFailed(attempt, e);\n      return;\n    }\n\n    if (result && typeof (result as Promise<void>).then === 'function') {\n      (result as Promise<void>).then(\n        () => this._onOpenSucceeded(),\n        (e) => this._onOpenFailed(attempt, e),\n      );\n    } else {\n      this._onOpenSucceeded();\n    }\n  }\n\n  private _onOpenSucceeded(): void {\n    if (this._disposed) return;\n    // Only transition if we're still connecting (disconnect may have been called)\n    if (this._connState !== ConnectionState.Connecting) return;\n\n    this._connState = ConnectionState.Connected;\n    this._setStatus({\n      connected: true,\n      reconnecting: false,\n      attempt: 0,\n      error: null,\n    });\n  }\n\n  private _onOpenFailed(attempt: number, error: unknown): void {\n    if (this._disposed) return;\n    // If disconnect was called during open, don't reconnect\n    if (this._connState === ConnectionState.Idle) return;\n\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    this._connState = ConnectionState.Reconnecting;\n    this._scheduleReconnect(attempt + 1, error);\n  }\n\n  private _scheduleReconnect(attempt: number, error?: unknown): void {\n    const ctor = this.constructor as typeof Channel;\n\n    if (attempt > ctor.MAX_ATTEMPTS) {\n      this._connState = ConnectionState.Idle;\n      this._setStatus({\n        connected: false,\n        reconnecting: false,\n        attempt,\n        error: error instanceof Error ? error.message : 'Max reconnection attempts reached',\n      });\n      return;\n    }\n\n    const errorMsg = error instanceof Error ? error.message : (error ? String(error) : null);\n\n    this._setStatus({\n      connected: false,\n      reconnecting: true,\n      attempt,\n      error: errorMsg,\n    });\n\n    const delay = this._calculateDelay(attempt - 1);\n    this._reconnectTimer = setTimeout(() => {\n      this._reconnectTimer = null;\n      this._attemptConnect(attempt);\n    }, delay);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"Channel.cjs","sources":["../src/Channel.ts"],"sourcesContent":["import type { Listener, Subscribable, Disposable, Initializable, EventSource } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// ── Types ─────────────────────────────────────────────────────────\n\n/** Describes the current connection state of a Channel. */\nexport interface ChannelStatus {\n  readonly connected: boolean;\n  readonly reconnecting: boolean;\n  readonly attempt: number;\n  readonly error: string | null;\n}\n\ntype Handler<T> = (payload: T) => void;\n\nconst enum ConnectionState {\n  Idle,\n  Connecting,\n  Connected,\n  Reconnecting,\n  Disposed,\n}\n\nconst INITIAL_STATUS: ChannelStatus = Object.freeze({\n  connected: false,\n  reconnecting: false,\n  attempt: 0,\n  error: null,\n});\n\n// ── Channel ───────────────────────────────────────────────────────\n\n/**\n * Abstract persistent connection with automatic reconnection and exponential backoff.\n * Subclass to implement WebSocket, SSE, or other transport protocols.\n */\nexport abstract class Channel<M extends Record<string, any>>\n  implements Subscribable<ChannelStatus>, Initializable, Disposable\n{\n  // Static config (subclass overrides)\n  /** Base delay (ms) for reconnection backoff. */\n  static RECONNECT_BASE = 1000;\n  /** Maximum delay cap (ms) for reconnection backoff. */\n  static RECONNECT_MAX = 30000;\n  /** Exponential backoff multiplier for reconnection delay. */\n  static RECONNECT_FACTOR = 2;\n  /** Maximum number of reconnection attempts before giving up. */\n  static MAX_ATTEMPTS = Infinity;\n\n  // ── Internal state ──────────────────────────────────────────────\n  private _status: ChannelStatus = INITIAL_STATUS;\n  private _connState: ConnectionState = ConnectionState.Idle;\n  private _disposed = false;\n  private _initialized = false;\n  private _listeners = new Set<Listener<ChannelStatus>>();\n  private _handlers = new Map<keyof M, Set<Handler<unknown>>>();\n  private _abortController: AbortController | null = null;\n  private _connectAbort: AbortController | null = null;\n  private _reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private _cleanups: (() => void)[] | null = null;\n\n  // ── Subscribable<ChannelStatus> ─────────────────────────────────\n\n  /** Current connection status. */\n  get state(): ChannelStatus {\n    return this._status;\n  }\n\n  /** Subscribes to connection status changes. Returns an unsubscribe function. */\n  subscribe(listener: Listener<ChannelStatus>): () => void {\n    if (this._disposed) return () => {};\n    this._listeners.add(listener);\n    return () => { this._listeners.delete(listener); };\n  }\n\n  // ── Disposable / Initializable ──────────────────────────────────\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /** Tears down the instance, releasing all subscriptions and resources. */\n  dispose(): void {\n    if (this._disposed) return;\n    this._disposed = true;\n    this._connState = ConnectionState.Disposed;\n\n    // Cancel pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    // Abort per-connection signal\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    // Abort dispose signal\n    this._abortController?.abort();\n\n    // Close transport\n    try { this.close(); } catch { /* swallow close errors during dispose */ }\n\n    // Run cleanups\n    if (this._cleanups) {\n      for (const fn of this._cleanups) fn();\n      this._cleanups = null;\n    }\n\n    this.onDispose?.();\n    this._listeners.clear();\n    this._handlers.clear();\n  }\n\n  // ── Subclass contract ───────────────────────────────────────────\n\n  /** Establishes the underlying connection. Called internally by connect(). @protected */\n  protected abstract open(signal: AbortSignal): void | Promise<void>;\n  /** Tears down the underlying connection. Called internally by disconnect() and dispose(). @protected */\n  protected abstract close(): void;\n\n  // ── Connection control ──────────────────────────────────────────\n\n  /** Initiates a connection with automatic reconnection on failure. */\n  connect(): void {\n    if (this._disposed) {\n      if (__DEV__) {\n        console.warn('[mvc-kit] connect() called after dispose — ignored.');\n      }\n      return;\n    }\n    if (__DEV__ && !this._initialized) {\n      console.warn('[mvc-kit] connect() called before init().');\n    }\n    if (\n      this._connState === ConnectionState.Connecting ||\n      this._connState === ConnectionState.Connected\n    ) {\n      return;\n    }\n\n    // Cancel any pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    this._attemptConnect(0);\n  }\n\n  /** Closes the connection and cancels any pending reconnection. */\n  disconnect(): void {\n    if (this._disposed) return;\n\n    // Cancel pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    // Abort current connection attempt\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    // Close transport\n    if (\n      this._connState === ConnectionState.Connected ||\n      this._connState === ConnectionState.Connecting\n    ) {\n      this._connState = ConnectionState.Idle;\n      try { this.close(); } catch { /* swallow */ }\n    } else {\n      this._connState = ConnectionState.Idle;\n    }\n\n    this._setStatus({ connected: false, reconnecting: false, attempt: 0, error: null });\n  }\n\n  // ── Subclass signals ────────────────────────────────────────────\n\n  /** Call from subclass when a message arrives from the transport. @protected */\n  protected receive<K extends keyof M>(type: K, payload: M[K]): void {\n    if (this._disposed) {\n      if (__DEV__) {\n        console.warn(`[mvc-kit] receive(\"${String(type)}\") called after dispose — ignored.`);\n      }\n      return;\n    }\n\n    const handlers = this._handlers.get(type);\n    if (handlers) {\n      for (const handler of handlers) {\n        handler(payload);\n      }\n    }\n  }\n\n  /** Call from subclass when the transport connection drops unexpectedly. Triggers reconnection. @protected */\n  protected disconnected(): void {\n    if (this._disposed) return;\n    // Only trigger reconnect from connected or connecting states\n    if (\n      this._connState !== ConnectionState.Connected &&\n      this._connState !== ConnectionState.Connecting\n    ) {\n      return;\n    }\n\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    this._connState = ConnectionState.Reconnecting;\n    this._scheduleReconnect(1);\n  }\n\n  // ── Consumer API ────────────────────────────────────────────────\n\n  /** Subscribes to a specific message type. Returns an unsubscribe function. */\n  on<K extends keyof M>(type: K, handler: Handler<M[K]>): () => void {\n    if (this._disposed) return () => {};\n\n    let handlers = this._handlers.get(type);\n    if (!handlers) {\n      handlers = new Set();\n      this._handlers.set(type, handlers);\n    }\n    handlers.add(handler as Handler<unknown>);\n\n    return () => { handlers!.delete(handler as Handler<unknown>); };\n  }\n\n  /** Subscribes to a message type, auto-removing the handler after the first invocation. */\n  once<K extends keyof M>(type: K, handler: Handler<M[K]>): () => void {\n    const unsubscribe = this.on(type, (payload) => {\n      unsubscribe();\n      handler(payload);\n    });\n    return unsubscribe;\n  }\n\n  // ── Infrastructure ──────────────────────────────────────────────\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */\n  protected listenTo<E extends Record<string, any>, K extends keyof E>(\n    source: EventSource<E>,\n    event: K,\n    handler: (payload: E[K]) => void,\n  ): () => void {\n    const unsubscribe = source.on(event, handler);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n\n  // ── Backoff ─────────────────────────────────────────────────────\n\n  /** Computes the reconnect backoff delay with jitter for the given attempt number. @protected */\n  protected _calculateDelay(attempt: number): number {\n    const ctor = this.constructor as typeof Channel;\n    const capped = Math.min(\n      ctor.RECONNECT_BASE * Math.pow(ctor.RECONNECT_FACTOR, attempt),\n      ctor.RECONNECT_MAX,\n    );\n    return Math.random() * capped;\n  }\n\n  // ── Internals ───────────────────────────────────────────────────\n\n  private _setStatus(next: ChannelStatus): void {\n    const prev = this._status;\n    if (\n      prev.connected === next.connected &&\n      prev.reconnecting === next.reconnecting &&\n      prev.attempt === next.attempt &&\n      prev.error === next.error\n    ) {\n      return;\n    }\n\n    this._status = Object.freeze(next);\n    for (const listener of this._listeners) {\n      listener(this._status, prev);\n    }\n  }\n\n  private _attemptConnect(attempt: number): void {\n    if (this._disposed) return;\n\n    this._connState = ConnectionState.Connecting;\n\n    // Create per-connection abort controller\n    this._connectAbort?.abort();\n    this._connectAbort = new AbortController();\n\n    const signal = this._abortController\n      ? AbortSignal.any([this._abortController.signal, this._connectAbort.signal])\n      : this._connectAbort.signal;\n\n    this._setStatus({\n      connected: false,\n      reconnecting: attempt > 0,\n      attempt,\n      error: null,\n    });\n\n    let result: void | Promise<void>;\n    try {\n      result = this.open(signal);\n    } catch (e) {\n      this._onOpenFailed(attempt, e);\n      return;\n    }\n\n    if (result && typeof (result as Promise<void>).then === 'function') {\n      (result as Promise<void>).then(\n        () => this._onOpenSucceeded(),\n        (e) => this._onOpenFailed(attempt, e),\n      );\n    } else {\n      this._onOpenSucceeded();\n    }\n  }\n\n  private _onOpenSucceeded(): void {\n    if (this._disposed) return;\n    // Only transition if we're still connecting (disconnect may have been called)\n    if (this._connState !== ConnectionState.Connecting) return;\n\n    this._connState = ConnectionState.Connected;\n    this._setStatus({\n      connected: true,\n      reconnecting: false,\n      attempt: 0,\n      error: null,\n    });\n  }\n\n  private _onOpenFailed(attempt: number, error: unknown): void {\n    if (this._disposed) return;\n    // If disconnect was called during open, don't reconnect\n    if (this._connState === ConnectionState.Idle) return;\n\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    this._connState = ConnectionState.Reconnecting;\n    this._scheduleReconnect(attempt + 1, error);\n  }\n\n  private _scheduleReconnect(attempt: number, error?: unknown): void {\n    const ctor = this.constructor as typeof Channel;\n\n    if (attempt > ctor.MAX_ATTEMPTS) {\n      this._connState = ConnectionState.Idle;\n      this._setStatus({\n        connected: false,\n        reconnecting: false,\n        attempt,\n        error: error instanceof Error ? error.message : 'Max reconnection attempts reached',\n      });\n      return;\n    }\n\n    const errorMsg = error instanceof Error ? error.message : (error ? String(error) : null);\n\n    this._setStatus({\n      connected: false,\n      reconnecting: true,\n      attempt,\n      error: errorMsg,\n    });\n\n    const delay = this._calculateDelay(attempt - 1);\n    this._reconnectTimer = setTimeout(() => {\n      this._reconnectTimer = null;\n      this._attemptConnect(attempt);\n    }, delay);\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/Channel.d.ts

@@ -1,4 +1,4 @@
-import type { Listener, Subscribable, Disposable, Initializable } from './types';
+import type { Listener, Subscribable, Disposable, Initializable, EventSource } from './types';
 /** Describes the current connection state of a Channel. */
 export interface ChannelStatus {
     readonly connected: boolean;
@@ -64,6 +64,8 @@ export declare abstract class Channel<M extends Record<string, any>> implements
     protected addCleanup(fn: () => void): void;
     /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
     protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void;
+    /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */
+    protected listenTo<E extends Record<string, any>, K extends keyof E>(source: EventSource<E>, event: K, handler: (payload: E[K]) => void): () => void;
     /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */
     protected onInit?(): void | Promise<void>;
     /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */

package/dist/Channel.d.ts.map

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

package/dist/Channel.js

@@ -191,6 +191,12 @@ class Channel {
     this.addCleanup(unsubscribe);
     return unsubscribe;
   }
+  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */
+  listenTo(source, event, handler) {
+    const unsubscribe = source.on(event, handler);
+    this.addCleanup(unsubscribe);
+    return unsubscribe;
+  }
   // ── Backoff ─────────────────────────────────────────────────────
   /** Computes the reconnect backoff delay with jitter for the given attempt number. @protected */
   _calculateDelay(attempt) {

package/dist/Channel.js.map

@@ -1 +1 @@
-{"version":3,"file":"Channel.js","sources":["../src/Channel.ts"],"sourcesContent":["import type { Listener, Subscribable, Disposable, Initializable } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// ── Types ─────────────────────────────────────────────────────────\n\n/** Describes the current connection state of a Channel. */\nexport interface ChannelStatus {\n  readonly connected: boolean;\n  readonly reconnecting: boolean;\n  readonly attempt: number;\n  readonly error: string | null;\n}\n\ntype Handler<T> = (payload: T) => void;\n\nconst enum ConnectionState {\n  Idle,\n  Connecting,\n  Connected,\n  Reconnecting,\n  Disposed,\n}\n\nconst INITIAL_STATUS: ChannelStatus = Object.freeze({\n  connected: false,\n  reconnecting: false,\n  attempt: 0,\n  error: null,\n});\n\n// ── Channel ───────────────────────────────────────────────────────\n\n/**\n * Abstract persistent connection with automatic reconnection and exponential backoff.\n * Subclass to implement WebSocket, SSE, or other transport protocols.\n */\nexport abstract class Channel<M extends Record<string, any>>\n  implements Subscribable<ChannelStatus>, Initializable, Disposable\n{\n  // Static config (subclass overrides)\n  /** Base delay (ms) for reconnection backoff. */\n  static RECONNECT_BASE = 1000;\n  /** Maximum delay cap (ms) for reconnection backoff. */\n  static RECONNECT_MAX = 30000;\n  /** Exponential backoff multiplier for reconnection delay. */\n  static RECONNECT_FACTOR = 2;\n  /** Maximum number of reconnection attempts before giving up. */\n  static MAX_ATTEMPTS = Infinity;\n\n  // ── Internal state ──────────────────────────────────────────────\n  private _status: ChannelStatus = INITIAL_STATUS;\n  private _connState: ConnectionState = ConnectionState.Idle;\n  private _disposed = false;\n  private _initialized = false;\n  private _listeners = new Set<Listener<ChannelStatus>>();\n  private _handlers = new Map<keyof M, Set<Handler<unknown>>>();\n  private _abortController: AbortController | null = null;\n  private _connectAbort: AbortController | null = null;\n  private _reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private _cleanups: (() => void)[] | null = null;\n\n  // ── Subscribable<ChannelStatus> ─────────────────────────────────\n\n  /** Current connection status. */\n  get state(): ChannelStatus {\n    return this._status;\n  }\n\n  /** Subscribes to connection status changes. Returns an unsubscribe function. */\n  subscribe(listener: Listener<ChannelStatus>): () => void {\n    if (this._disposed) return () => {};\n    this._listeners.add(listener);\n    return () => { this._listeners.delete(listener); };\n  }\n\n  // ── Disposable / Initializable ──────────────────────────────────\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /** Tears down the instance, releasing all subscriptions and resources. */\n  dispose(): void {\n    if (this._disposed) return;\n    this._disposed = true;\n    this._connState = ConnectionState.Disposed;\n\n    // Cancel pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    // Abort per-connection signal\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    // Abort dispose signal\n    this._abortController?.abort();\n\n    // Close transport\n    try { this.close(); } catch { /* swallow close errors during dispose */ }\n\n    // Run cleanups\n    if (this._cleanups) {\n      for (const fn of this._cleanups) fn();\n      this._cleanups = null;\n    }\n\n    this.onDispose?.();\n    this._listeners.clear();\n    this._handlers.clear();\n  }\n\n  // ── Subclass contract ───────────────────────────────────────────\n\n  /** Establishes the underlying connection. Called internally by connect(). @protected */\n  protected abstract open(signal: AbortSignal): void | Promise<void>;\n  /** Tears down the underlying connection. Called internally by disconnect() and dispose(). @protected */\n  protected abstract close(): void;\n\n  // ── Connection control ──────────────────────────────────────────\n\n  /** Initiates a connection with automatic reconnection on failure. */\n  connect(): void {\n    if (this._disposed) {\n      if (__DEV__) {\n        console.warn('[mvc-kit] connect() called after dispose — ignored.');\n      }\n      return;\n    }\n    if (__DEV__ && !this._initialized) {\n      console.warn('[mvc-kit] connect() called before init().');\n    }\n    if (\n      this._connState === ConnectionState.Connecting ||\n      this._connState === ConnectionState.Connected\n    ) {\n      return;\n    }\n\n    // Cancel any pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    this._attemptConnect(0);\n  }\n\n  /** Closes the connection and cancels any pending reconnection. */\n  disconnect(): void {\n    if (this._disposed) return;\n\n    // Cancel pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    // Abort current connection attempt\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    // Close transport\n    if (\n      this._connState === ConnectionState.Connected ||\n      this._connState === ConnectionState.Connecting\n    ) {\n      this._connState = ConnectionState.Idle;\n      try { this.close(); } catch { /* swallow */ }\n    } else {\n      this._connState = ConnectionState.Idle;\n    }\n\n    this._setStatus({ connected: false, reconnecting: false, attempt: 0, error: null });\n  }\n\n  // ── Subclass signals ────────────────────────────────────────────\n\n  /** Call from subclass when a message arrives from the transport. @protected */\n  protected receive<K extends keyof M>(type: K, payload: M[K]): void {\n    if (this._disposed) {\n      if (__DEV__) {\n        console.warn(`[mvc-kit] receive(\"${String(type)}\") called after dispose — ignored.`);\n      }\n      return;\n    }\n\n    const handlers = this._handlers.get(type);\n    if (handlers) {\n      for (const handler of handlers) {\n        handler(payload);\n      }\n    }\n  }\n\n  /** Call from subclass when the transport connection drops unexpectedly. Triggers reconnection. @protected */\n  protected disconnected(): void {\n    if (this._disposed) return;\n    // Only trigger reconnect from connected or connecting states\n    if (\n      this._connState !== ConnectionState.Connected &&\n      this._connState !== ConnectionState.Connecting\n    ) {\n      return;\n    }\n\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    this._connState = ConnectionState.Reconnecting;\n    this._scheduleReconnect(1);\n  }\n\n  // ── Consumer API ────────────────────────────────────────────────\n\n  /** Subscribes to a specific message type. Returns an unsubscribe function. */\n  on<K extends keyof M>(type: K, handler: Handler<M[K]>): () => void {\n    if (this._disposed) return () => {};\n\n    let handlers = this._handlers.get(type);\n    if (!handlers) {\n      handlers = new Set();\n      this._handlers.set(type, handlers);\n    }\n    handlers.add(handler as Handler<unknown>);\n\n    return () => { handlers!.delete(handler as Handler<unknown>); };\n  }\n\n  /** Subscribes to a message type, auto-removing the handler after the first invocation. */\n  once<K extends keyof M>(type: K, handler: Handler<M[K]>): () => void {\n    const unsubscribe = this.on(type, (payload) => {\n      unsubscribe();\n      handler(payload);\n    });\n    return unsubscribe;\n  }\n\n  // ── Infrastructure ──────────────────────────────────────────────\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n\n  // ── Backoff ─────────────────────────────────────────────────────\n\n  /** Computes the reconnect backoff delay with jitter for the given attempt number. @protected */\n  protected _calculateDelay(attempt: number): number {\n    const ctor = this.constructor as typeof Channel;\n    const capped = Math.min(\n      ctor.RECONNECT_BASE * Math.pow(ctor.RECONNECT_FACTOR, attempt),\n      ctor.RECONNECT_MAX,\n    );\n    return Math.random() * capped;\n  }\n\n  // ── Internals ───────────────────────────────────────────────────\n\n  private _setStatus(next: ChannelStatus): void {\n    const prev = this._status;\n    if (\n      prev.connected === next.connected &&\n      prev.reconnecting === next.reconnecting &&\n      prev.attempt === next.attempt &&\n      prev.error === next.error\n    ) {\n      return;\n    }\n\n    this._status = Object.freeze(next);\n    for (const listener of this._listeners) {\n      listener(this._status, prev);\n    }\n  }\n\n  private _attemptConnect(attempt: number): void {\n    if (this._disposed) return;\n\n    this._connState = ConnectionState.Connecting;\n\n    // Create per-connection abort controller\n    this._connectAbort?.abort();\n    this._connectAbort = new AbortController();\n\n    const signal = this._abortController\n      ? AbortSignal.any([this._abortController.signal, this._connectAbort.signal])\n      : this._connectAbort.signal;\n\n    this._setStatus({\n      connected: false,\n      reconnecting: attempt > 0,\n      attempt,\n      error: null,\n    });\n\n    let result: void | Promise<void>;\n    try {\n      result = this.open(signal);\n    } catch (e) {\n      this._onOpenFailed(attempt, e);\n      return;\n    }\n\n    if (result && typeof (result as Promise<void>).then === 'function') {\n      (result as Promise<void>).then(\n        () => this._onOpenSucceeded(),\n        (e) => this._onOpenFailed(attempt, e),\n      );\n    } else {\n      this._onOpenSucceeded();\n    }\n  }\n\n  private _onOpenSucceeded(): void {\n    if (this._disposed) return;\n    // Only transition if we're still connecting (disconnect may have been called)\n    if (this._connState !== ConnectionState.Connecting) return;\n\n    this._connState = ConnectionState.Connected;\n    this._setStatus({\n      connected: true,\n      reconnecting: false,\n      attempt: 0,\n      error: null,\n    });\n  }\n\n  private _onOpenFailed(attempt: number, error: unknown): void {\n    if (this._disposed) return;\n    // If disconnect was called during open, don't reconnect\n    if (this._connState === ConnectionState.Idle) return;\n\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    this._connState = ConnectionState.Reconnecting;\n    this._scheduleReconnect(attempt + 1, error);\n  }\n\n  private _scheduleReconnect(attempt: number, error?: unknown): void {\n    const ctor = this.constructor as typeof Channel;\n\n    if (attempt > ctor.MAX_ATTEMPTS) {\n      this._connState = ConnectionState.Idle;\n      this._setStatus({\n        connected: false,\n        reconnecting: false,\n        attempt,\n        error: error instanceof Error ? error.message : 'Max reconnection attempts reached',\n      });\n      return;\n    }\n\n    const errorMsg = error instanceof Error ? error.message : (error ? String(error) : null);\n\n    this._setStatus({\n      connected: false,\n      reconnecting: true,\n      attempt,\n      error: errorMsg,\n    });\n\n    const delay = this._calculateDelay(attempt - 1);\n    this._reconnectTimer = setTimeout(() => {\n      this._reconnectTimer = null;\n      this._attemptConnect(attempt);\n    }, delay);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"Channel.js","sources":["../src/Channel.ts"],"sourcesContent":["import type { Listener, Subscribable, Disposable, Initializable, EventSource } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// ── Types ─────────────────────────────────────────────────────────\n\n/** Describes the current connection state of a Channel. */\nexport interface ChannelStatus {\n  readonly connected: boolean;\n  readonly reconnecting: boolean;\n  readonly attempt: number;\n  readonly error: string | null;\n}\n\ntype Handler<T> = (payload: T) => void;\n\nconst enum ConnectionState {\n  Idle,\n  Connecting,\n  Connected,\n  Reconnecting,\n  Disposed,\n}\n\nconst INITIAL_STATUS: ChannelStatus = Object.freeze({\n  connected: false,\n  reconnecting: false,\n  attempt: 0,\n  error: null,\n});\n\n// ── Channel ───────────────────────────────────────────────────────\n\n/**\n * Abstract persistent connection with automatic reconnection and exponential backoff.\n * Subclass to implement WebSocket, SSE, or other transport protocols.\n */\nexport abstract class Channel<M extends Record<string, any>>\n  implements Subscribable<ChannelStatus>, Initializable, Disposable\n{\n  // Static config (subclass overrides)\n  /** Base delay (ms) for reconnection backoff. */\n  static RECONNECT_BASE = 1000;\n  /** Maximum delay cap (ms) for reconnection backoff. */\n  static RECONNECT_MAX = 30000;\n  /** Exponential backoff multiplier for reconnection delay. */\n  static RECONNECT_FACTOR = 2;\n  /** Maximum number of reconnection attempts before giving up. */\n  static MAX_ATTEMPTS = Infinity;\n\n  // ── Internal state ──────────────────────────────────────────────\n  private _status: ChannelStatus = INITIAL_STATUS;\n  private _connState: ConnectionState = ConnectionState.Idle;\n  private _disposed = false;\n  private _initialized = false;\n  private _listeners = new Set<Listener<ChannelStatus>>();\n  private _handlers = new Map<keyof M, Set<Handler<unknown>>>();\n  private _abortController: AbortController | null = null;\n  private _connectAbort: AbortController | null = null;\n  private _reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private _cleanups: (() => void)[] | null = null;\n\n  // ── Subscribable<ChannelStatus> ─────────────────────────────────\n\n  /** Current connection status. */\n  get state(): ChannelStatus {\n    return this._status;\n  }\n\n  /** Subscribes to connection status changes. Returns an unsubscribe function. */\n  subscribe(listener: Listener<ChannelStatus>): () => void {\n    if (this._disposed) return () => {};\n    this._listeners.add(listener);\n    return () => { this._listeners.delete(listener); };\n  }\n\n  // ── Disposable / Initializable ──────────────────────────────────\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /** Tears down the instance, releasing all subscriptions and resources. */\n  dispose(): void {\n    if (this._disposed) return;\n    this._disposed = true;\n    this._connState = ConnectionState.Disposed;\n\n    // Cancel pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    // Abort per-connection signal\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    // Abort dispose signal\n    this._abortController?.abort();\n\n    // Close transport\n    try { this.close(); } catch { /* swallow close errors during dispose */ }\n\n    // Run cleanups\n    if (this._cleanups) {\n      for (const fn of this._cleanups) fn();\n      this._cleanups = null;\n    }\n\n    this.onDispose?.();\n    this._listeners.clear();\n    this._handlers.clear();\n  }\n\n  // ── Subclass contract ───────────────────────────────────────────\n\n  /** Establishes the underlying connection. Called internally by connect(). @protected */\n  protected abstract open(signal: AbortSignal): void | Promise<void>;\n  /** Tears down the underlying connection. Called internally by disconnect() and dispose(). @protected */\n  protected abstract close(): void;\n\n  // ── Connection control ──────────────────────────────────────────\n\n  /** Initiates a connection with automatic reconnection on failure. */\n  connect(): void {\n    if (this._disposed) {\n      if (__DEV__) {\n        console.warn('[mvc-kit] connect() called after dispose — ignored.');\n      }\n      return;\n    }\n    if (__DEV__ && !this._initialized) {\n      console.warn('[mvc-kit] connect() called before init().');\n    }\n    if (\n      this._connState === ConnectionState.Connecting ||\n      this._connState === ConnectionState.Connected\n    ) {\n      return;\n    }\n\n    // Cancel any pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    this._attemptConnect(0);\n  }\n\n  /** Closes the connection and cancels any pending reconnection. */\n  disconnect(): void {\n    if (this._disposed) return;\n\n    // Cancel pending reconnect\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    // Abort current connection attempt\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    // Close transport\n    if (\n      this._connState === ConnectionState.Connected ||\n      this._connState === ConnectionState.Connecting\n    ) {\n      this._connState = ConnectionState.Idle;\n      try { this.close(); } catch { /* swallow */ }\n    } else {\n      this._connState = ConnectionState.Idle;\n    }\n\n    this._setStatus({ connected: false, reconnecting: false, attempt: 0, error: null });\n  }\n\n  // ── Subclass signals ────────────────────────────────────────────\n\n  /** Call from subclass when a message arrives from the transport. @protected */\n  protected receive<K extends keyof M>(type: K, payload: M[K]): void {\n    if (this._disposed) {\n      if (__DEV__) {\n        console.warn(`[mvc-kit] receive(\"${String(type)}\") called after dispose — ignored.`);\n      }\n      return;\n    }\n\n    const handlers = this._handlers.get(type);\n    if (handlers) {\n      for (const handler of handlers) {\n        handler(payload);\n      }\n    }\n  }\n\n  /** Call from subclass when the transport connection drops unexpectedly. Triggers reconnection. @protected */\n  protected disconnected(): void {\n    if (this._disposed) return;\n    // Only trigger reconnect from connected or connecting states\n    if (\n      this._connState !== ConnectionState.Connected &&\n      this._connState !== ConnectionState.Connecting\n    ) {\n      return;\n    }\n\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    this._connState = ConnectionState.Reconnecting;\n    this._scheduleReconnect(1);\n  }\n\n  // ── Consumer API ────────────────────────────────────────────────\n\n  /** Subscribes to a specific message type. Returns an unsubscribe function. */\n  on<K extends keyof M>(type: K, handler: Handler<M[K]>): () => void {\n    if (this._disposed) return () => {};\n\n    let handlers = this._handlers.get(type);\n    if (!handlers) {\n      handlers = new Set();\n      this._handlers.set(type, handlers);\n    }\n    handlers.add(handler as Handler<unknown>);\n\n    return () => { handlers!.delete(handler as Handler<unknown>); };\n  }\n\n  /** Subscribes to a message type, auto-removing the handler after the first invocation. */\n  once<K extends keyof M>(type: K, handler: Handler<M[K]>): () => void {\n    const unsubscribe = this.on(type, (payload) => {\n      unsubscribe();\n      handler(payload);\n    });\n    return unsubscribe;\n  }\n\n  // ── Infrastructure ──────────────────────────────────────────────\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */\n  protected listenTo<E extends Record<string, any>, K extends keyof E>(\n    source: EventSource<E>,\n    event: K,\n    handler: (payload: E[K]) => void,\n  ): () => void {\n    const unsubscribe = source.on(event, handler);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n\n  // ── Backoff ─────────────────────────────────────────────────────\n\n  /** Computes the reconnect backoff delay with jitter for the given attempt number. @protected */\n  protected _calculateDelay(attempt: number): number {\n    const ctor = this.constructor as typeof Channel;\n    const capped = Math.min(\n      ctor.RECONNECT_BASE * Math.pow(ctor.RECONNECT_FACTOR, attempt),\n      ctor.RECONNECT_MAX,\n    );\n    return Math.random() * capped;\n  }\n\n  // ── Internals ───────────────────────────────────────────────────\n\n  private _setStatus(next: ChannelStatus): void {\n    const prev = this._status;\n    if (\n      prev.connected === next.connected &&\n      prev.reconnecting === next.reconnecting &&\n      prev.attempt === next.attempt &&\n      prev.error === next.error\n    ) {\n      return;\n    }\n\n    this._status = Object.freeze(next);\n    for (const listener of this._listeners) {\n      listener(this._status, prev);\n    }\n  }\n\n  private _attemptConnect(attempt: number): void {\n    if (this._disposed) return;\n\n    this._connState = ConnectionState.Connecting;\n\n    // Create per-connection abort controller\n    this._connectAbort?.abort();\n    this._connectAbort = new AbortController();\n\n    const signal = this._abortController\n      ? AbortSignal.any([this._abortController.signal, this._connectAbort.signal])\n      : this._connectAbort.signal;\n\n    this._setStatus({\n      connected: false,\n      reconnecting: attempt > 0,\n      attempt,\n      error: null,\n    });\n\n    let result: void | Promise<void>;\n    try {\n      result = this.open(signal);\n    } catch (e) {\n      this._onOpenFailed(attempt, e);\n      return;\n    }\n\n    if (result && typeof (result as Promise<void>).then === 'function') {\n      (result as Promise<void>).then(\n        () => this._onOpenSucceeded(),\n        (e) => this._onOpenFailed(attempt, e),\n      );\n    } else {\n      this._onOpenSucceeded();\n    }\n  }\n\n  private _onOpenSucceeded(): void {\n    if (this._disposed) return;\n    // Only transition if we're still connecting (disconnect may have been called)\n    if (this._connState !== ConnectionState.Connecting) return;\n\n    this._connState = ConnectionState.Connected;\n    this._setStatus({\n      connected: true,\n      reconnecting: false,\n      attempt: 0,\n      error: null,\n    });\n  }\n\n  private _onOpenFailed(attempt: number, error: unknown): void {\n    if (this._disposed) return;\n    // If disconnect was called during open, don't reconnect\n    if (this._connState === ConnectionState.Idle) return;\n\n    this._connectAbort?.abort();\n    this._connectAbort = null;\n\n    this._connState = ConnectionState.Reconnecting;\n    this._scheduleReconnect(attempt + 1, error);\n  }\n\n  private _scheduleReconnect(attempt: number, error?: unknown): void {\n    const ctor = this.constructor as typeof Channel;\n\n    if (attempt > ctor.MAX_ATTEMPTS) {\n      this._connState = ConnectionState.Idle;\n      this._setStatus({\n        connected: false,\n        reconnecting: false,\n        attempt,\n        error: error instanceof Error ? error.message : 'Max reconnection attempts reached',\n      });\n      return;\n    }\n\n    const errorMsg = error instanceof Error ? error.message : (error ? String(error) : null);\n\n    this._setStatus({\n      connected: false,\n      reconnecting: true,\n      attempt,\n      error: errorMsg,\n    });\n\n    const delay = this._calculateDelay(attempt - 1);\n    this._reconnectTimer = setTimeout(() => {\n      this._reconnectTimer = null;\n      this._attemptConnect(attempt);\n    }, delay);\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/Controller.cjs

@@ -52,6 +52,12 @@ class Controller {
     this.addCleanup(unsubscribe);
     return unsubscribe;
   }
+  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */
+  listenTo(source, event, handler) {
+    const unsubscribe = source.on(event, handler);
+    this.addCleanup(unsubscribe);
+    return unsubscribe;
+  }
 }
 exports.Controller = Controller;
 //# sourceMappingURL=Controller.cjs.map

package/dist/Controller.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Controller.cjs","sources":["../src/Controller.ts"],"sourcesContent":["import type { Disposable, Subscribable, Listener } from './types';\n\n/**\n * Base class for stateless orchestrators.\n * Controllers coordinate between ViewModels, Models, and Services.\n */\nexport abstract class Controller implements Disposable {\n  private _disposed = false;\n  private _initialized = false;\n  private _abortController: AbortController | null = null;\n  private _cleanups: (() => void)[] | null = null;\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /** Tears down the instance, releasing all subscriptions and resources. */\n  dispose(): void {\n    if (this._disposed) {\n      return;\n    }\n\n    this._disposed = true;\n    this._abortController?.abort();\n    if (this._cleanups) {\n      for (const fn of this._cleanups) fn();\n      this._cleanups = null;\n    }\n    this.onDispose?.();\n  }\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n}\n"],"names":[],"mappings":";;AAMO,MAAe,WAAiC;AAAA,EAC7C,YAAY;AAAA,EACZ,eAAe;AAAA,EACf,mBAA2C;AAAA,EAC3C,YAAmC;AAAA;AAAA,EAG3C,IAAI,WAAoB;AACtB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,cAAuB;AACzB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,gBAA6B;AAC/B,QAAI,CAAC,KAAK,kBAAkB;AAC1B,WAAK,mBAAmB,IAAI,gBAAA;AAAA,IAC9B;AACA,WAAO,KAAK,iBAAiB;AAAA,EAC/B;AAAA;AAAA,EAGA,OAA6B;AAC3B,QAAI,KAAK,gBAAgB,KAAK,UAAW;AACzC,SAAK,eAAe;AACpB,WAAO,KAAK,SAAA;AAAA,EACd;AAAA;AAAA,EAGA,UAAgB;AACd,QAAI,KAAK,WAAW;AAClB;AAAA,IACF;AAEA,SAAK,YAAY;AACjB,SAAK,kBAAkB,MAAA;AACvB,QAAI,KAAK,WAAW;AAClB,iBAAW,MAAM,KAAK,UAAW,IAAA;AACjC,WAAK,YAAY;AAAA,IACnB;AACA,SAAK,YAAA;AAAA,EACP;AAAA;AAAA,EAGU,WAAW,IAAsB;AACzC,QAAI,CAAC,KAAK,WAAW;AACnB,WAAK,YAAY,CAAA;AAAA,IACnB;AACA,SAAK,UAAU,KAAK,EAAE;AAAA,EACxB;AAAA;AAAA,EAGU,YAAe,QAAyB,UAAmC;AACnF,UAAM,cAAc,OAAO,UAAU,QAAQ;AAC7C,SAAK,WAAW,WAAW;AAC3B,WAAO;AAAA,EACT;AAMF;;"}
+{"version":3,"file":"Controller.cjs","sources":["../src/Controller.ts"],"sourcesContent":["import type { Disposable, Subscribable, Listener, EventSource } from './types';\n\n/**\n * Base class for stateless orchestrators.\n * Controllers coordinate between ViewModels, Models, and Services.\n */\nexport abstract class Controller implements Disposable {\n  private _disposed = false;\n  private _initialized = false;\n  private _abortController: AbortController | null = null;\n  private _cleanups: (() => void)[] | null = null;\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /** Tears down the instance, releasing all subscriptions and resources. */\n  dispose(): void {\n    if (this._disposed) {\n      return;\n    }\n\n    this._disposed = true;\n    this._abortController?.abort();\n    if (this._cleanups) {\n      for (const fn of this._cleanups) fn();\n      this._cleanups = null;\n    }\n    this.onDispose?.();\n  }\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */\n  protected listenTo<E extends Record<string, any>, K extends keyof E>(\n    source: EventSource<E>,\n    event: K,\n    handler: (payload: E[K]) => void,\n  ): () => void {\n    const unsubscribe = source.on(event, handler);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n}\n"],"names":[],"mappings":";;AAMO,MAAe,WAAiC;AAAA,EAC7C,YAAY;AAAA,EACZ,eAAe;AAAA,EACf,mBAA2C;AAAA,EAC3C,YAAmC;AAAA;AAAA,EAG3C,IAAI,WAAoB;AACtB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,cAAuB;AACzB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,gBAA6B;AAC/B,QAAI,CAAC,KAAK,kBAAkB;AAC1B,WAAK,mBAAmB,IAAI,gBAAA;AAAA,IAC9B;AACA,WAAO,KAAK,iBAAiB;AAAA,EAC/B;AAAA;AAAA,EAGA,OAA6B;AAC3B,QAAI,KAAK,gBAAgB,KAAK,UAAW;AACzC,SAAK,eAAe;AACpB,WAAO,KAAK,SAAA;AAAA,EACd;AAAA;AAAA,EAGA,UAAgB;AACd,QAAI,KAAK,WAAW;AAClB;AAAA,IACF;AAEA,SAAK,YAAY;AACjB,SAAK,kBAAkB,MAAA;AACvB,QAAI,KAAK,WAAW;AAClB,iBAAW,MAAM,KAAK,UAAW,IAAA;AACjC,WAAK,YAAY;AAAA,IACnB;AACA,SAAK,YAAA;AAAA,EACP;AAAA;AAAA,EAGU,WAAW,IAAsB;AACzC,QAAI,CAAC,KAAK,WAAW;AACnB,WAAK,YAAY,CAAA;AAAA,IACnB;AACA,SAAK,UAAU,KAAK,EAAE;AAAA,EACxB;AAAA;AAAA,EAGU,YAAe,QAAyB,UAAmC;AACnF,UAAM,cAAc,OAAO,UAAU,QAAQ;AAC7C,SAAK,WAAW,WAAW;AAC3B,WAAO;AAAA,EACT;AAAA;AAAA,EAGU,SACR,QACA,OACA,SACY;AACZ,UAAM,cAAc,OAAO,GAAG,OAAO,OAAO;AAC5C,SAAK,WAAW,WAAW;AAC3B,WAAO;AAAA,EACT;AAMF;;"}

package/dist/Controller.d.ts

@@ -1,4 +1,4 @@
-import type { Disposable, Subscribable, Listener } from './types';
+import type { Disposable, Subscribable, Listener, EventSource } from './types';
 /**
  * Base class for stateless orchestrators.
  * Controllers coordinate between ViewModels, Models, and Services.
@@ -22,6 +22,8 @@ export declare abstract class Controller implements Disposable {
     protected addCleanup(fn: () => void): void;
     /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
     protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void;
+    /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */
+    protected listenTo<E extends Record<string, any>, K extends keyof E>(source: EventSource<E>, event: K, handler: (payload: E[K]) => void): () => void;
     /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */
     protected onInit?(): void | Promise<void>;
     /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */

package/dist/Controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Controller.d.ts","sourceRoot":"","sources":["../src/Controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAElE;;;GAGG;AACH,8BAAsB,UAAW,YAAW,UAAU;IACpD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,SAAS,CAA+B;IAEhD,+CAA+C;IAC/C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,sCAAsC;IACtC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,6EAA6E;IAC7E,IAAI,aAAa,IAAI,WAAW,CAK/B;IAED,iFAAiF;IACjF,IAAI,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5B,0EAA0E;IAC1E,OAAO,IAAI,IAAI;IAcf,uEAAuE;IACvE,SAAS,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAO1C,2FAA2F;IAC3F,SAAS,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAMpF,4FAA4F;IAC5F,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IACzC,uFAAuF;IACvF,SAAS,CAAC,SAAS,CAAC,IAAI,IAAI;CAC7B"}
+{"version":3,"file":"Controller.d.ts","sourceRoot":"","sources":["../src/Controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE/E;;;GAGG;AACH,8BAAsB,UAAW,YAAW,UAAU;IACpD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,SAAS,CAA+B;IAEhD,+CAA+C;IAC/C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,sCAAsC;IACtC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,6EAA6E;IAC7E,IAAI,aAAa,IAAI,WAAW,CAK/B;IAED,iFAAiF;IACjF,IAAI,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5B,0EAA0E;IAC1E,OAAO,IAAI,IAAI;IAcf,uEAAuE;IACvE,SAAS,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAO1C,2FAA2F;IAC3F,SAAS,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAMpF,yGAAyG;IACzG,SAAS,CAAC,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACjE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAC/B,MAAM,IAAI;IAMb,4FAA4F;IAC5F,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IACzC,uFAAuF;IACvF,SAAS,CAAC,SAAS,CAAC,IAAI,IAAI;CAC7B"}

package/dist/Controller.js

@@ -50,6 +50,12 @@ class Controller {
     this.addCleanup(unsubscribe);
     return unsubscribe;
   }
+  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */
+  listenTo(source, event, handler) {
+    const unsubscribe = source.on(event, handler);
+    this.addCleanup(unsubscribe);
+    return unsubscribe;
+  }
 }
 export {
   Controller

package/dist/Controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"Controller.js","sources":["../src/Controller.ts"],"sourcesContent":["import type { Disposable, Subscribable, Listener } from './types';\n\n/**\n * Base class for stateless orchestrators.\n * Controllers coordinate between ViewModels, Models, and Services.\n */\nexport abstract class Controller implements Disposable {\n  private _disposed = false;\n  private _initialized = false;\n  private _abortController: AbortController | null = null;\n  private _cleanups: (() => void)[] | null = null;\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /** Tears down the instance, releasing all subscriptions and resources. */\n  dispose(): void {\n    if (this._disposed) {\n      return;\n    }\n\n    this._disposed = true;\n    this._abortController?.abort();\n    if (this._cleanups) {\n      for (const fn of this._cleanups) fn();\n      this._cleanups = null;\n    }\n    this.onDispose?.();\n  }\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n}\n"],"names":[],"mappings":"AAMO,MAAe,WAAiC;AAAA,EAC7C,YAAY;AAAA,EACZ,eAAe;AAAA,EACf,mBAA2C;AAAA,EAC3C,YAAmC;AAAA;AAAA,EAG3C,IAAI,WAAoB;AACtB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,cAAuB;AACzB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,gBAA6B;AAC/B,QAAI,CAAC,KAAK,kBAAkB;AAC1B,WAAK,mBAAmB,IAAI,gBAAA;AAAA,IAC9B;AACA,WAAO,KAAK,iBAAiB;AAAA,EAC/B;AAAA;AAAA,EAGA,OAA6B;AAC3B,QAAI,KAAK,gBAAgB,KAAK,UAAW;AACzC,SAAK,eAAe;AACpB,WAAO,KAAK,SAAA;AAAA,EACd;AAAA;AAAA,EAGA,UAAgB;AACd,QAAI,KAAK,WAAW;AAClB;AAAA,IACF;AAEA,SAAK,YAAY;AACjB,SAAK,kBAAkB,MAAA;AACvB,QAAI,KAAK,WAAW;AAClB,iBAAW,MAAM,KAAK,UAAW,IAAA;AACjC,WAAK,YAAY;AAAA,IACnB;AACA,SAAK,YAAA;AAAA,EACP;AAAA;AAAA,EAGU,WAAW,IAAsB;AACzC,QAAI,CAAC,KAAK,WAAW;AACnB,WAAK,YAAY,CAAA;AAAA,IACnB;AACA,SAAK,UAAU,KAAK,EAAE;AAAA,EACxB;AAAA;AAAA,EAGU,YAAe,QAAyB,UAAmC;AACnF,UAAM,cAAc,OAAO,UAAU,QAAQ;AAC7C,SAAK,WAAW,WAAW;AAC3B,WAAO;AAAA,EACT;AAMF;"}
+{"version":3,"file":"Controller.js","sources":["../src/Controller.ts"],"sourcesContent":["import type { Disposable, Subscribable, Listener, EventSource } from './types';\n\n/**\n * Base class for stateless orchestrators.\n * Controllers coordinate between ViewModels, Models, and Services.\n */\nexport abstract class Controller implements Disposable {\n  private _disposed = false;\n  private _initialized = false;\n  private _abortController: AbortController | null = null;\n  private _cleanups: (() => void)[] | null = null;\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /** Tears down the instance, releasing all subscriptions and resources. */\n  dispose(): void {\n    if (this._disposed) {\n      return;\n    }\n\n    this._disposed = true;\n    this._abortController?.abort();\n    if (this._cleanups) {\n      for (const fn of this._cleanups) fn();\n      this._cleanups = null;\n    }\n    this.onDispose?.();\n  }\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */\n  protected listenTo<E extends Record<string, any>, K extends keyof E>(\n    source: EventSource<E>,\n    event: K,\n    handler: (payload: E[K]) => void,\n  ): () => void {\n    const unsubscribe = source.on(event, handler);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n}\n"],"names":[],"mappings":"AAMO,MAAe,WAAiC;AAAA,EAC7C,YAAY;AAAA,EACZ,eAAe;AAAA,EACf,mBAA2C;AAAA,EAC3C,YAAmC;AAAA;AAAA,EAG3C,IAAI,WAAoB;AACtB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,cAAuB;AACzB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,gBAA6B;AAC/B,QAAI,CAAC,KAAK,kBAAkB;AAC1B,WAAK,mBAAmB,IAAI,gBAAA;AAAA,IAC9B;AACA,WAAO,KAAK,iBAAiB;AAAA,EAC/B;AAAA;AAAA,EAGA,OAA6B;AAC3B,QAAI,KAAK,gBAAgB,KAAK,UAAW;AACzC,SAAK,eAAe;AACpB,WAAO,KAAK,SAAA;AAAA,EACd;AAAA;AAAA,EAGA,UAAgB;AACd,QAAI,KAAK,WAAW;AAClB;AAAA,IACF;AAEA,SAAK,YAAY;AACjB,SAAK,kBAAkB,MAAA;AACvB,QAAI,KAAK,WAAW;AAClB,iBAAW,MAAM,KAAK,UAAW,IAAA;AACjC,WAAK,YAAY;AAAA,IACnB;AACA,SAAK,YAAA;AAAA,EACP;AAAA;AAAA,EAGU,WAAW,IAAsB;AACzC,QAAI,CAAC,KAAK,WAAW;AACnB,WAAK,YAAY,CAAA;AAAA,IACnB;AACA,SAAK,UAAU,KAAK,EAAE;AAAA,EACxB;AAAA;AAAA,EAGU,YAAe,QAAyB,UAAmC;AACnF,UAAM,cAAc,OAAO,UAAU,QAAQ;AAC7C,SAAK,WAAW,WAAW;AAC3B,WAAO;AAAA,EACT;AAAA;AAAA,EAGU,SACR,QACA,OACA,SACY;AACZ,UAAM,cAAc,OAAO,GAAG,OAAO,OAAO;AAC5C,SAAK,WAAW,WAAW;AAC3B,WAAO;AAAA,EACT;AAMF;"}

package/dist/Model.cjs

@@ -157,6 +157,12 @@ class Model {
     this.addCleanup(unsubscribe);
     return unsubscribe;
   }
+  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */
+  listenTo(source, event, handler) {
+    const unsubscribe = source.on(event, handler);
+    this.addCleanup(unsubscribe);
+    return unsubscribe;
+  }
   shallowEqual(a, b) {
     const keysA = Object.keys(a);
     const keysB = Object.keys(b);

package/dist/Model.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Model.cjs","sources":["../src/Model.ts"],"sourcesContent":["import type { Listener, Updater, Subscribable, ValidationErrors } from './types';\n\n/**\n * Reactive entity with validation and dirty tracking.\n */\nexport abstract class Model<S extends object> implements Subscribable<S> {\n  private _state: Readonly<S>;\n  private _committed: Readonly<S>;\n  private _disposed = false;\n  private _initialized = false;\n  private _listeners = new Set<Listener<S>>();\n  private _abortController: AbortController | null = null;\n  private _cleanups: (() => void)[] | null = null;\n\n  constructor(initialState: S) {\n    const frozen = Object.freeze({ ...initialState });\n    this._state = frozen;\n    this._committed = frozen;\n  }\n\n  /** Current frozen state object. */\n  get state(): S {\n    return this._state;\n  }\n\n  /**\n   * The baseline state for dirty tracking.\n   */\n  get committed(): S {\n    return this._committed;\n  }\n\n  /**\n   * True if current state differs from committed state.\n   */\n  get dirty(): boolean {\n    return !this.shallowEqual(this._state, this._committed);\n  }\n\n  /**\n   * Validation errors for the current state.\n   */\n  get errors(): ValidationErrors<S> {\n    return this.validate(this._state);\n  }\n\n  /**\n   * True if there are no validation errors.\n   */\n  get valid(): boolean {\n    return Object.keys(this.errors).length === 0;\n  }\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /**\n   * Merges partial state with validation. No-op if no values changed by reference.\n   * @protected\n   */\n  protected set(partialOrUpdater: Partial<S> | Updater<S>): void {\n    if (this._disposed) {\n      throw new Error('Cannot set state on disposed Model');\n    }\n\n    const partial =\n      typeof partialOrUpdater === 'function'\n        ? partialOrUpdater(this._state)\n        : partialOrUpdater;\n\n    // Check if any values actually changed (shallow equality)\n    const keys = Object.keys(partial) as (keyof S)[];\n    const hasChanges = keys.some(\n      (key) => partial[key] !== this._state[key]\n    );\n\n    if (!hasChanges) {\n      return;\n    }\n\n    const prev = this._state;\n    const next = Object.freeze({ ...prev, ...partial });\n    this._state = next;\n\n    this.onSet?.(prev, next);\n\n    for (const listener of this._listeners) {\n      listener(next, prev);\n    }\n  }\n\n  /**\n   * Mark current state as the new baseline (not dirty).\n   */\n  commit(): void {\n    if (this._disposed) {\n      throw new Error('Cannot commit on disposed Model');\n    }\n    this._committed = this._state;\n  }\n\n  /**\n   * Revert state to committed baseline.\n   */\n  rollback(): void {\n    if (this._disposed) {\n      throw new Error('Cannot rollback on disposed Model');\n    }\n\n    if (this.shallowEqual(this._state, this._committed)) {\n      return;\n    }\n\n    const prev = this._state;\n    this._state = this._committed;\n\n    this.onSet?.(prev, this._state);\n\n    for (const listener of this._listeners) {\n      listener(this._state, prev);\n    }\n  }\n\n  /** Subscribes to state changes. Returns an unsubscribe function. */\n  subscribe(listener: Listener<S>): () => void {\n    if (this._disposed) {\n      return () => {};\n    }\n\n    this._listeners.add(listener);\n\n    return () => {\n      this._listeners.delete(listener);\n    };\n  }\n\n  /** Tears down the instance, releasing all subscriptions and resources. */\n  dispose(): void {\n    if (this._disposed) {\n      return;\n    }\n\n    this._disposed = true;\n    this._abortController?.abort();\n    if (this._cleanups) {\n      for (const fn of this._cleanups) fn();\n      this._cleanups = null;\n    }\n    this.onDispose?.();\n    this._listeners.clear();\n  }\n\n  /**\n   * Override to provide validation logic.\n   * Return an object mapping field keys to error messages.\n   */\n  protected validate(_state: S): ValidationErrors<S> {\n    return {};\n  }\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called after every set() with the previous state. @protected */\n  protected onSet?(prev: S, next: S): void;\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n\n  private shallowEqual(a: S, b: S): boolean {\n    const keysA = Object.keys(a) as (keyof S)[];\n    const keysB = Object.keys(b) as (keyof S)[];\n\n    if (keysA.length !== keysB.length) {\n      return false;\n    }\n\n    for (const key of keysA) {\n      if (a[key] !== b[key]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"Model.cjs","sources":["../src/Model.ts"],"sourcesContent":["import type { Listener, Updater, Subscribable, ValidationErrors, EventSource } from './types';\n\n/**\n * Reactive entity with validation and dirty tracking.\n */\nexport abstract class Model<S extends object> implements Subscribable<S> {\n  private _state: Readonly<S>;\n  private _committed: Readonly<S>;\n  private _disposed = false;\n  private _initialized = false;\n  private _listeners = new Set<Listener<S>>();\n  private _abortController: AbortController | null = null;\n  private _cleanups: (() => void)[] | null = null;\n\n  constructor(initialState: S) {\n    const frozen = Object.freeze({ ...initialState });\n    this._state = frozen;\n    this._committed = frozen;\n  }\n\n  /** Current frozen state object. */\n  get state(): S {\n    return this._state;\n  }\n\n  /**\n   * The baseline state for dirty tracking.\n   */\n  get committed(): S {\n    return this._committed;\n  }\n\n  /**\n   * True if current state differs from committed state.\n   */\n  get dirty(): boolean {\n    return !this.shallowEqual(this._state, this._committed);\n  }\n\n  /**\n   * Validation errors for the current state.\n   */\n  get errors(): ValidationErrors<S> {\n    return this.validate(this._state);\n  }\n\n  /**\n   * True if there are no validation errors.\n   */\n  get valid(): boolean {\n    return Object.keys(this.errors).length === 0;\n  }\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /**\n   * Merges partial state with validation. No-op if no values changed by reference.\n   * @protected\n   */\n  protected set(partialOrUpdater: Partial<S> | Updater<S>): void {\n    if (this._disposed) {\n      throw new Error('Cannot set state on disposed Model');\n    }\n\n    const partial =\n      typeof partialOrUpdater === 'function'\n        ? partialOrUpdater(this._state)\n        : partialOrUpdater;\n\n    // Check if any values actually changed (shallow equality)\n    const keys = Object.keys(partial) as (keyof S)[];\n    const hasChanges = keys.some(\n      (key) => partial[key] !== this._state[key]\n    );\n\n    if (!hasChanges) {\n      return;\n    }\n\n    const prev = this._state;\n    const next = Object.freeze({ ...prev, ...partial });\n    this._state = next;\n\n    this.onSet?.(prev, next);\n\n    for (const listener of this._listeners) {\n      listener(next, prev);\n    }\n  }\n\n  /**\n   * Mark current state as the new baseline (not dirty).\n   */\n  commit(): void {\n    if (this._disposed) {\n      throw new Error('Cannot commit on disposed Model');\n    }\n    this._committed = this._state;\n  }\n\n  /**\n   * Revert state to committed baseline.\n   */\n  rollback(): void {\n    if (this._disposed) {\n      throw new Error('Cannot rollback on disposed Model');\n    }\n\n    if (this.shallowEqual(this._state, this._committed)) {\n      return;\n    }\n\n    const prev = this._state;\n    this._state = this._committed;\n\n    this.onSet?.(prev, this._state);\n\n    for (const listener of this._listeners) {\n      listener(this._state, prev);\n    }\n  }\n\n  /** Subscribes to state changes. Returns an unsubscribe function. */\n  subscribe(listener: Listener<S>): () => void {\n    if (this._disposed) {\n      return () => {};\n    }\n\n    this._listeners.add(listener);\n\n    return () => {\n      this._listeners.delete(listener);\n    };\n  }\n\n  /** Tears down the instance, releasing all subscriptions and resources. */\n  dispose(): void {\n    if (this._disposed) {\n      return;\n    }\n\n    this._disposed = true;\n    this._abortController?.abort();\n    if (this._cleanups) {\n      for (const fn of this._cleanups) fn();\n      this._cleanups = null;\n    }\n    this.onDispose?.();\n    this._listeners.clear();\n  }\n\n  /**\n   * Override to provide validation logic.\n   * Return an object mapping field keys to error messages.\n   */\n  protected validate(_state: S): ValidationErrors<S> {\n    return {};\n  }\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */\n  protected listenTo<E extends Record<string, any>, K extends keyof E>(\n    source: EventSource<E>,\n    event: K,\n    handler: (payload: E[K]) => void,\n  ): () => void {\n    const unsubscribe = source.on(event, handler);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called after every set() with the previous state. @protected */\n  protected onSet?(prev: S, next: S): void;\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n\n  private shallowEqual(a: S, b: S): boolean {\n    const keysA = Object.keys(a) as (keyof S)[];\n    const keysB = Object.keys(b) as (keyof S)[];\n\n    if (keysA.length !== keysB.length) {\n      return false;\n    }\n\n    for (const key of keysA) {\n      if (a[key] !== b[key]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/Model.d.ts

@@ -1,4 +1,4 @@
-import type { Listener, Updater, Subscribable, ValidationErrors } from './types';
+import type { Listener, Updater, Subscribable, ValidationErrors, EventSource } from './types';
 /**
  * Reactive entity with validation and dirty tracking.
  */
@@ -63,6 +63,8 @@ export declare abstract class Model<S extends object> implements Subscribable<S>
     protected addCleanup(fn: () => void): void;
     /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
     protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void;
+    /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */
+    protected listenTo<E extends Record<string, any>, K extends keyof E>(source: EventSource<E>, event: K, handler: (payload: E[K]) => void): () => void;
     /** Lifecycle hook called after every set() with the previous state. @protected */
     protected onSet?(prev: S, next: S): void;
     /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */

package/dist/Model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Model.d.ts","sourceRoot":"","sources":["../src/Model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEjF;;GAEG;AACH,8BAAsB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,SAAS,CAA+B;gBAEpC,YAAY,EAAE,CAAC;IAM3B,mCAAmC;IACnC,IAAI,KAAK,IAAI,CAAC,CAEb;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,CAAC,CAEjB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAEhC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,+CAA+C;IAC/C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,sCAAsC;IACtC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,6EAA6E;IAC7E,IAAI,aAAa,IAAI,WAAW,CAK/B;IAED,iFAAiF;IACjF,IAAI,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5B;;;OAGG;IACH,SAAS,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IA+B9D;;OAEG;IACH,MAAM,IAAI,IAAI;IAOd;;OAEG;IACH,QAAQ,IAAI,IAAI;IAmBhB,oEAAoE;IACpE,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAY5C,0EAA0E;IAC1E,OAAO,IAAI,IAAI;IAef;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAIlD,uEAAuE;IACvE,SAAS,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAO1C,2FAA2F;IAC3F,SAAS,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAMpF,kFAAkF;IAClF,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IACxC,4FAA4F;IAC5F,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IACzC,uFAAuF;IACvF,SAAS,CAAC,SAAS,CAAC,IAAI,IAAI;IAE5B,OAAO,CAAC,YAAY;CAgBrB"}
+{"version":3,"file":"Model.d.ts","sourceRoot":"","sources":["../src/Model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE9F;;GAEG;AACH,8BAAsB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,SAAS,CAA+B;gBAEpC,YAAY,EAAE,CAAC;IAM3B,mCAAmC;IACnC,IAAI,KAAK,IAAI,CAAC,CAEb;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,CAAC,CAEjB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAEhC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,+CAA+C;IAC/C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,sCAAsC;IACtC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,6EAA6E;IAC7E,IAAI,aAAa,IAAI,WAAW,CAK/B;IAED,iFAAiF;IACjF,IAAI,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5B;;;OAGG;IACH,SAAS,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IA+B9D;;OAEG;IACH,MAAM,IAAI,IAAI;IAOd;;OAEG;IACH,QAAQ,IAAI,IAAI;IAmBhB,oEAAoE;IACpE,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAY5C,0EAA0E;IAC1E,OAAO,IAAI,IAAI;IAef;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAIlD,uEAAuE;IACvE,SAAS,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAO1C,2FAA2F;IAC3F,SAAS,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAMpF,yGAAyG;IACzG,SAAS,CAAC,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACjE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAC/B,MAAM,IAAI;IAMb,kFAAkF;IAClF,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IACxC,4FAA4F;IAC5F,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IACzC,uFAAuF;IACvF,SAAS,CAAC,SAAS,CAAC,IAAI,IAAI;IAE5B,OAAO,CAAC,YAAY;CAgBrB"}

package/dist/Model.js

@@ -155,6 +155,12 @@ class Model {
     this.addCleanup(unsubscribe);
     return unsubscribe;
   }
+  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */
+  listenTo(source, event, handler) {
+    const unsubscribe = source.on(event, handler);
+    this.addCleanup(unsubscribe);
+    return unsubscribe;
+  }
   shallowEqual(a, b) {
     const keysA = Object.keys(a);
     const keysB = Object.keys(b);