mvc-kit 2.5.2 → 2.5.4

package/dist/mvc-kit.js

@@ -1,1135 +1,30 @@
-import { E } from "./singleton-CaEXSbYg.js";
-import { h as B, s as F, t as X, a as Y } from "./singleton-CaEXSbYg.js";
-import { C as A } from "./PersistentCollection-BFrgskju.js";
-import { P as U } from "./PersistentCollection-BFrgskju.js";
-class x extends Error {
-  constructor(t, e) {
-    super(e ?? `HTTP ${t}`), this.status = t, this.name = "HttpError";
-  }
-}
-function O(r) {
-  return r instanceof Error && r.name === "AbortError";
-}
-function C(r) {
-  return r === 401 ? "unauthorized" : r === 403 ? "forbidden" : r === 404 ? "not_found" : r === 422 ? "validation" : r === 429 ? "rate_limited" : r >= 500 ? "server_error" : "unknown";
-}
-function z(r) {
-  return typeof r == "object" && r !== null && typeof r.status == "number" && typeof r.statusText == "string" && !(r instanceof Error);
-}
-function T(r) {
-  return r instanceof Error && r.name === "AbortError" ? {
-    code: "abort",
-    message: "Request was aborted",
-    original: r
-  } : r instanceof x ? {
-    code: C(r.status),
-    message: r.message,
-    status: r.status,
-    original: r
-  } : z(r) ? {
-    code: C(r.status),
-    message: r.statusText || `HTTP ${r.status}`,
-    status: r.status,
-    original: r
-  } : r instanceof TypeError && r.message.toLowerCase().includes("fetch") ? {
-    code: "network",
-    message: r.message,
-    original: r
-  } : r instanceof Error && r.name === "TimeoutError" ? {
-    code: "timeout",
-    message: r.message,
-    original: r
-  } : r instanceof Error ? {
-    code: "unknown",
-    message: r.message,
-    original: r
-  } : {
-    code: "unknown",
-    message: String(r),
-    original: r
-  };
-}
-const d = typeof __MVC_KIT_DEV__ < "u" && __MVC_KIT_DEV__;
-function M(r) {
-  return r !== null && typeof r == "object" && typeof r.subscribe == "function";
-}
-function b(r, t, e) {
-  let s = Object.getPrototypeOf(r);
-  for (; s && s !== t; ) {
-    const n = Object.getOwnPropertyDescriptors(s);
-    for (const [o, c] of Object.entries(n))
-      o !== "constructor" && e(o, c, s);
-    s = Object.getPrototypeOf(s);
-  }
-}
-const j = Object.freeze({ loading: !1, error: null, errorCode: null }), m = ["async", "subscribeAsync"], P = /* @__PURE__ */ new Set(["onInit", "onSet", "onDispose"]);
-class y {
-  _state;
-  _initialState;
-  _disposed = !1;
-  _initialized = !1;
-  _listeners = /* @__PURE__ */ new Set();
-  _abortController = null;
-  _cleanups = null;
-  _subscriptionCleanups = null;
-  _eventBus = null;
-  // ── Reactive derived state (RFC 1) ─────────────────────────────
-  _revision = 0;
-  _stateTracking = null;
-  _sourceTracking = null;
-  _trackedSources = /* @__PURE__ */ new Map();
-  // ── Async tracking (RFC 2) ──────────────────────────────────────
-  _asyncStates = /* @__PURE__ */ new Map();
-  _asyncSnapshots = /* @__PURE__ */ new Map();
-  _asyncListeners = /* @__PURE__ */ new Set();
-  _asyncProxy = null;
-  _activeOps = null;
-  /** DEV-only timeout (ms) for detecting ghost async operations after dispose. */
-  static GHOST_TIMEOUT = 3e3;
-  constructor(t) {
-    this._state = Object.freeze({ ...t }), this._initialState = this._state, this._guardReservedKeys();
-  }
-  /** Current frozen state object. */
-  get state() {
-    return this._state;
-  }
-  /** Whether this instance has been disposed. */
-  get disposed() {
-    return this._disposed;
-  }
-  /** Whether init() has been called. */
-  get initialized() {
-    return this._initialized;
-  }
-  /** AbortSignal that fires when this instance is disposed. Lazily created. */
-  get disposeSignal() {
-    return this._abortController || (this._abortController = new AbortController()), this._abortController.signal;
-  }
-  /** Lazily-created typed EventBus for emitting and subscribing to events. */
-  get events() {
-    return this._eventBus || (this._eventBus = new E()), this._eventBus;
-  }
-  /** Initializes the instance. Called automatically by React hooks after mount. */
-  init() {
-    if (!(this._initialized || this._disposed))
-      return this._initialized = !0, this._trackSubscribables(), this._installStateProxy(), this._memoizeGetters(), this._wrapMethods(), this.onInit?.();
-  }
-  /**
-   * Merges partial state into current state. If no values actually
-   * changed by reference, this is a no-op.
-   *
-   * Triggers React re-render via listener notification. Called when:
-   *   - User code calls set() to update source state
-   *
-   * NOT called for subscribable member notifications — those use
-   * a separate notification path (see _trackSubscribables).
-   */
-  set(t) {
-    if (this._disposed) return;
-    if (d && this._stateTracking) {
-      console.error(
-        "[mvc-kit] set() called inside a getter. Getters must be pure — they read state and return a value. They must never call set(), which would cause an infinite render loop. Move this logic to an action method."
-      );
-      return;
-    }
-    const e = typeof t == "function" ? t(this._state) : t;
-    if (!Object.keys(e).some(
-      (l) => e[l] !== this._state[l]
-    ))
-      return;
-    const o = this._state, c = Object.freeze({ ...o, ...e });
-    this._state = c, this._revision++, this.onSet?.(o, c);
-    for (const l of this._listeners)
-      l(c, o);
-  }
-  /**
-   * Emits a typed event via the internal EventBus.
-   * Safe to call during dispose cleanup callbacks.
-   * @protected
-   */
-  emit(t, e) {
-    (this._eventBus?.disposed ?? this._disposed) || this.events.emit(t, e);
-  }
-  /** Subscribes to state changes. Returns an unsubscribe function. */
-  subscribe(t) {
-    return this._disposed ? () => {
-    } : (this._listeners.add(t), () => {
-      this._listeners.delete(t);
-    });
-  }
-  /** Tears down the instance, releasing all subscriptions and resources. */
-  dispose() {
-    if (!this._disposed) {
-      if (this._disposed = !0, this._teardownSubscriptions(), this._abortController?.abort(), this._cleanups) {
-        for (const t of this._cleanups) t();
-        this._cleanups = null;
-      }
-      this._eventBus?.dispose(), this.onDispose?.(), this._listeners.clear();
-    }
-  }
-  /**
-   * Resets state to initial values (or provided state), aborts in-flight work,
-   * clears async tracking, and re-runs onInit().
-   */
-  reset(t) {
-    if (!this._disposed) {
-      this._abortController?.abort(), this._abortController = null, this._teardownSubscriptions(), this._state = t ? Object.freeze({ ...t }) : this._initialState, this._revision++, this._asyncStates.clear(), this._asyncSnapshots.clear(), this._notifyAsync(), this._trackSubscribables();
-      for (const e of this._listeners)
-        e(this._state, this._state);
-      return this.onInit?.();
-    }
-  }
-  /**
-   * Registers a cleanup function to be called on dispose. Used internally for things like method wrapper
-   * cleanup and event bus disposal, but can also be used by subclasses for custom cleanup logic.
-   * @param fn
-   * @protected
-   */
-  addCleanup(t) {
-    this._cleanups || (this._cleanups = []), this._cleanups.push(t);
-  }
-  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
-  subscribeTo(t, e) {
-    const s = t.subscribe(e);
-    return this._subscriptionCleanups || (this._subscriptionCleanups = []), this._subscriptionCleanups.push(s), s;
-  }
-  // ── Async tracking API ──────────────────────────────────────────
-  /** Proxy providing `TaskState` (loading, error, errorCode) per async method. */
-  get async() {
-    if (!this._asyncProxy) {
-      const t = this;
-      this._asyncProxy = new Proxy({}, {
-        get(e, s) {
-          return t._asyncSnapshots.get(s) ?? j;
-        },
-        has(e, s) {
-          return t._asyncSnapshots.has(s);
-        },
-        ownKeys() {
-          return Array.from(t._asyncSnapshots.keys());
-        },
-        getOwnPropertyDescriptor(e, s) {
-          if (t._asyncSnapshots.has(s))
-            return { configurable: !0, enumerable: !0, value: t._asyncSnapshots.get(s) };
-        }
-      });
-    }
-    return this._asyncProxy;
-  }
-  /** Subscribes to async state changes. Used by `useAsync` for React integration. */
-  subscribeAsync(t) {
-    return this._disposed ? () => {
-    } : (this._asyncListeners.add(t), () => {
-      this._asyncListeners.delete(t);
-    });
-  }
-  _notifyAsync() {
-    for (const t of this._asyncListeners)
-      t();
-  }
-  // ── Async tracking internals ────────────────────────────────────
-  _teardownSubscriptions() {
-    for (const t of this._trackedSources.values()) t.unsubscribe();
-    if (this._trackedSources.clear(), this._subscriptionCleanups) {
-      for (const t of this._subscriptionCleanups) t();
-      this._subscriptionCleanups = null;
-    }
-  }
-  _guardReservedKeys() {
-    b(this, y.prototype, (t) => {
-      if (m.includes(t))
-        throw new Error(
-          `[mvc-kit] "${t}" is a reserved property on ViewModel and cannot be overridden.`
-        );
-    });
-  }
-  _wrapMethods() {
-    for (const n of m)
-      if (Object.getOwnPropertyDescriptor(this, n)?.value !== void 0)
-        throw new Error(
-          `[mvc-kit] "${n}" is a reserved property on ViewModel and cannot be overridden.`
-        );
-    const t = this, e = /* @__PURE__ */ new Set(), s = [];
-    d && (this._activeOps = /* @__PURE__ */ new Map()), b(this, y.prototype, (n, o) => {
-      if (o.get || o.set || typeof o.value != "function" || n.startsWith("_") || P.has(n) || e.has(n)) return;
-      e.add(n);
-      const c = o.value;
-      let l = !1;
-      const p = function(...g) {
-        if (t._disposed) {
-          d && console.warn(`[mvc-kit] "${n}" called after dispose — ignored.`);
-          return;
-        }
-        d && !t._initialized && console.warn(
-          `[mvc-kit] "${n}" called before init(). Async tracking is active only after init().`
-        );
-        let u;
-        try {
-          u = c.apply(t, g);
-        } catch (a) {
-          throw a;
-        }
-        if (!u || typeof u.then != "function")
-          return l || (l = !0, t._asyncStates.delete(n), t._asyncSnapshots.delete(n), t[n] = c.bind(t)), u;
-        let i = t._asyncStates.get(n);
-        return i || (i = { loading: !1, error: null, errorCode: null, count: 0 }, t._asyncStates.set(n, i)), i.count++, i.loading = !0, i.error = null, i.errorCode = null, t._asyncSnapshots.set(n, Object.freeze({ loading: !0, error: null, errorCode: null })), t._notifyAsync(), d && t._activeOps && t._activeOps.set(n, (t._activeOps.get(n) ?? 0) + 1), u.then(
-          (a) => {
-            if (t._disposed) return a;
-            if (i.count--, i.loading = i.count > 0, t._asyncSnapshots.set(
-              n,
-              Object.freeze({ loading: i.loading, error: i.error, errorCode: i.errorCode })
-            ), t._notifyAsync(), d && t._activeOps) {
-              const _ = (t._activeOps.get(n) ?? 1) - 1;
-              _ <= 0 ? t._activeOps.delete(n) : t._activeOps.set(n, _);
-            }
-            return a;
-          },
-          (a) => {
-            if (O(a)) {
-              if (t._disposed || (i.count--, i.loading = i.count > 0, t._asyncSnapshots.set(
-                n,
-                Object.freeze({ loading: i.loading, error: i.error, errorCode: i.errorCode })
-              ), t._notifyAsync()), d && t._activeOps) {
-                const h = (t._activeOps.get(n) ?? 1) - 1;
-                h <= 0 ? t._activeOps.delete(n) : t._activeOps.set(n, h);
-              }
-              return;
-            }
-            if (t._disposed) return;
-            i.count--, i.loading = i.count > 0;
-            const _ = T(a);
-            if (i.error = _.message, i.errorCode = _.code, t._asyncSnapshots.set(
-              n,
-              Object.freeze({ loading: i.loading, error: _.message, errorCode: _.code })
-            ), t._notifyAsync(), d && t._activeOps) {
-              const h = (t._activeOps.get(n) ?? 1) - 1;
-              h <= 0 ? t._activeOps.delete(n) : t._activeOps.set(n, h);
-            }
-            throw a;
-          }
-        );
-      };
-      s.push(n), t[n] = p;
-    }), s.length > 0 && this.addCleanup(() => {
-      const n = d && t._activeOps ? new Map(t._activeOps) : null;
-      for (const o of s)
-        d ? t[o] = () => {
-          console.warn(`[mvc-kit] "${o}" called after dispose — ignored.`);
-        } : t[o] = () => {
-        };
-      t._asyncListeners.clear(), t._asyncStates.clear(), t._asyncSnapshots.clear(), d && n && n.size > 0 && t._scheduleGhostCheck(n);
-    });
-  }
-  _scheduleGhostCheck(t) {
-    d && setTimeout(() => {
-      for (const [e, s] of t)
-        console.warn(
-          `[mvc-kit] Ghost async operation detected: "${e}" had ${s} pending call(s) when the ViewModel was disposed. Consider using disposeSignal to cancel in-flight work.`
-        );
-    }, this.constructor.GHOST_TIMEOUT);
-  }
-  // ── Auto-tracking internals ────────────────────────────────────
-  /**
-   * Installs a context-sensitive state getter on the instance.
-   *
-   * During getter tracking (_stateTracking is active): returns a Proxy
-   * that records which state properties are accessed.
-   *
-   * Otherwise: returns the frozen state object directly. This is critical
-   * for React's useSyncExternalStore — it needs a changing reference to
-   * detect state updates and trigger re-renders.
-   */
-  _installStateProxy() {
-    const t = new Proxy({}, {
-      get: (e, s) => (this._stateTracking?.add(s), this._state[s]),
-      ownKeys: () => Reflect.ownKeys(this._state),
-      getOwnPropertyDescriptor: (e, s) => Reflect.getOwnPropertyDescriptor(this._state, s),
-      set: () => {
-        throw new Error("Cannot mutate state directly. Use set() instead.");
-      },
-      has: (e, s) => s in this._state
-    });
-    Object.defineProperty(this, "state", {
-      get: () => this._stateTracking ? t : this._state,
-      configurable: !0,
-      enumerable: !0
-    });
-  }
-  /**
-   * Scans own instance properties for Subscribable objects and sets up
-   * automatic dependency tracking for each one found.
-   *
-   * For each subscribable member:
-   *   1. Subscribe to it. On notification: bump its tracked revision
-   *      AND the VM's global revision, then force a new state reference
-   *      and notify listeners so React re-renders.
-   *   2. Replace the instance property with a getter that participates
-   *      in dependency tracking.
-   *   3. Register unsubscribe in the dispose chain.
-   *
-   * Called during init(), AFTER all subclass property initializers
-   * have run (they execute during the constructor, before init()).
-   */
-  _trackSubscribables() {
-    for (const t of Object.getOwnPropertyNames(this)) {
-      const e = this[t];
-      if (!M(e)) continue;
-      let s;
-      const n = () => {
-        if (!this._disposed) {
-          s.revision++, this._revision++, this._state = Object.freeze({ ...this._state });
-          for (const l of this._listeners)
-            l(this._state, this._state);
-        }
-      }, o = e.subscribe(n), c = typeof e.subscribeAsync == "function" ? e.subscribeAsync(n) : void 0;
-      s = {
-        source: e,
-        revision: 0,
-        unsubscribe: c ? () => {
-          o(), c();
-        } : o
-      }, this._trackedSources.set(t, s), Object.defineProperty(this, t, {
-        get: () => (this._sourceTracking?.set(t, s), e),
-        configurable: !0,
-        enumerable: !1
-      });
-    }
-  }
-  /**
-   * Walks the prototype chain from the subclass up to (but not including)
-   * ViewModel.prototype. For every getter found, replaces it on the
-   * instance with a memoized version that tracks dependencies and caches.
-   *
-   * Processing order: most-derived class first. If a subclass overrides
-   * a parent getter, only the subclass version is memoized.
-   */
-  _memoizeGetters() {
-    const t = /* @__PURE__ */ new Set();
-    b(this, y.prototype, (e, s) => {
-      !s.get || t.has(e) || (t.add(e), this._wrapGetter(e, s.get));
-    });
-  }
-  /**
-   * Replaces a single prototype getter with a memoized version on this
-   * instance. The memoized getter tracks both state dependencies and
-   * subscribable member dependencies, caching its result and
-   * revalidating through a three-tier strategy:
-   *
-   *   Tier 1 (fast):   revision unchanged → return cached (1 int compare)
-   *   Tier 2 (medium): revision changed but this getter's deps didn't → return cached
-   *   Tier 3 (slow):   at least one dep changed → full recompute with tracking
-   */
-  _wrapGetter(t, e) {
-    let s, n = -1, o, c, l;
-    Object.defineProperty(this, t, {
-      get: () => {
-        if (this._disposed || n === this._revision)
-          return s;
-        if (o && c) {
-          let i = !0;
-          for (const [a, _] of c)
-            if (this._state[a] !== _) {
-              i = !1;
-              break;
-            }
-          if (i && l)
-            for (const [a, _] of l) {
-              const h = this._trackedSources.get(a);
-              if (h && h.revision !== _) {
-                i = !1;
-                break;
-              }
-            }
-          if (i)
-            return n = this._revision, s;
-        }
-        const p = this._stateTracking, g = this._sourceTracking;
-        this._stateTracking = /* @__PURE__ */ new Set(), this._sourceTracking = /* @__PURE__ */ new Map();
-        try {
-          s = e.call(this);
-        } catch (i) {
-          throw this._stateTracking = p, this._sourceTracking = g, i;
-        }
-        o = this._stateTracking;
-        const u = this._sourceTracking;
-        if (this._stateTracking = p, this._sourceTracking = g, p)
-          for (const i of o) p.add(i);
-        if (g)
-          for (const [i, a] of u)
-            g.set(i, a);
-        c = /* @__PURE__ */ new Map();
-        for (const i of o)
-          c.set(i, this._state[i]);
-        l = /* @__PURE__ */ new Map();
-        for (const [i, a] of u)
-          l.set(i, a.revision);
-        return n = this._revision, s;
-      },
-      configurable: !0,
-      enumerable: !0
-    });
-  }
-}
-class $ {
-  _state;
-  _committed;
-  _disposed = !1;
-  _initialized = !1;
-  _listeners = /* @__PURE__ */ new Set();
-  _abortController = null;
-  _cleanups = null;
-  constructor(t) {
-    const e = Object.freeze({ ...t });
-    this._state = e, this._committed = e;
-  }
-  /** Current frozen state object. */
-  get state() {
-    return this._state;
-  }
-  /**
-   * The baseline state for dirty tracking.
-   */
-  get committed() {
-    return this._committed;
-  }
-  /**
-   * True if current state differs from committed state.
-   */
-  get dirty() {
-    return !this.shallowEqual(this._state, this._committed);
-  }
-  /**
-   * Validation errors for the current state.
-   */
-  get errors() {
-    return this.validate(this._state);
-  }
-  /**
-   * True if there are no validation errors.
-   */
-  get valid() {
-    return Object.keys(this.errors).length === 0;
-  }
-  /** Whether this instance has been disposed. */
-  get disposed() {
-    return this._disposed;
-  }
-  /** Whether init() has been called. */
-  get initialized() {
-    return this._initialized;
-  }
-  /** AbortSignal that fires when this instance is disposed. Lazily created. */
-  get disposeSignal() {
-    return this._abortController || (this._abortController = new AbortController()), this._abortController.signal;
-  }
-  /** Initializes the instance. Called automatically by React hooks after mount. */
-  init() {
-    if (!(this._initialized || this._disposed))
-      return this._initialized = !0, this.onInit?.();
-  }
-  /**
-   * Merges partial state with validation. No-op if no values changed by reference.
-   * @protected
-   */
-  set(t) {
-    if (this._disposed)
-      throw new Error("Cannot set state on disposed Model");
-    const e = typeof t == "function" ? t(this._state) : t;
-    if (!Object.keys(e).some(
-      (l) => e[l] !== this._state[l]
-    ))
-      return;
-    const o = this._state, c = Object.freeze({ ...o, ...e });
-    this._state = c, this.onSet?.(o, c);
-    for (const l of this._listeners)
-      l(c, o);
-  }
-  /**
-   * Mark current state as the new baseline (not dirty).
-   */
-  commit() {
-    if (this._disposed)
-      throw new Error("Cannot commit on disposed Model");
-    this._committed = this._state;
-  }
-  /**
-   * Revert state to committed baseline.
-   */
-  rollback() {
-    if (this._disposed)
-      throw new Error("Cannot rollback on disposed Model");
-    if (this.shallowEqual(this._state, this._committed))
-      return;
-    const t = this._state;
-    this._state = this._committed, this.onSet?.(t, this._state);
-    for (const e of this._listeners)
-      e(this._state, t);
-  }
-  /** Subscribes to state changes. Returns an unsubscribe function. */
-  subscribe(t) {
-    return this._disposed ? () => {
-    } : (this._listeners.add(t), () => {
-      this._listeners.delete(t);
-    });
-  }
-  /** Tears down the instance, releasing all subscriptions and resources. */
-  dispose() {
-    if (!this._disposed) {
-      if (this._disposed = !0, this._abortController?.abort(), this._cleanups) {
-        for (const t of this._cleanups) t();
-        this._cleanups = null;
-      }
-      this.onDispose?.(), this._listeners.clear();
-    }
-  }
-  /**
-   * Override to provide validation logic.
-   * Return an object mapping field keys to error messages.
-   */
-  validate(t) {
-    return {};
-  }
-  /** Registers a cleanup function to be called on dispose. @protected */
-  addCleanup(t) {
-    this._cleanups || (this._cleanups = []), this._cleanups.push(t);
-  }
-  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
-  subscribeTo(t, e) {
-    const s = t.subscribe(e);
-    return this.addCleanup(s), s;
-  }
-  shallowEqual(t, e) {
-    const s = Object.keys(t), n = Object.keys(e);
-    if (s.length !== n.length)
-      return !1;
-    for (const o of s)
-      if (t[o] !== e[o])
-        return !1;
-    return !0;
-  }
-}
-const f = typeof __MVC_KIT_DEV__ < "u" && __MVC_KIT_DEV__, D = Object.freeze({ loading: !1, error: null, errorCode: null }), w = ["async", "subscribeAsync"], k = /* @__PURE__ */ new Set(["onInit", "onDispose"]);
-class v extends A {
-  _external = null;
-  _initialized = !1;
-  // ── Async tracking fields ──
-  _asyncStates = /* @__PURE__ */ new Map();
-  _asyncSnapshots = /* @__PURE__ */ new Map();
-  _asyncListeners = /* @__PURE__ */ new Set();
-  _asyncProxy = null;
-  _activeOps = null;
-  /** DEV-only timeout (ms) for detecting ghost async operations after dispose. */
-  static GHOST_TIMEOUT = 3e3;
-  constructor(t) {
-    const e = t != null && !Array.isArray(t);
-    if (super(e ? [] : t ?? []), e && (this._external = t, f)) {
-      const s = this.constructor;
-      (s.MAX_SIZE > 0 || s.TTL > 0) && console.warn(
-        `[mvc-kit] Resource "${s.name}" has MAX_SIZE or TTL set but uses an injected Collection. Configure these on the Collection instead.`
-      );
-    }
-    this._guardReservedKeys();
-  }
-  // ── Lifecycle ─────────────────────────────────────────────────
-  /** Whether init() has been called. */
-  get initialized() {
-    return this._initialized;
-  }
-  /** Initializes the instance. Called automatically by React hooks after mount. */
-  init() {
-    if (!(this._initialized || this.disposed))
-      return this._initialized = !0, this._wrapMethods(), this.onInit?.();
-  }
-  // ── Collection delegation ─────────────────────────────────────
-  get state() {
-    return this._external ? this._external.state : super.state;
-  }
-  get items() {
-    return this._external ? this._external.items : super.items;
-  }
-  get length() {
-    return this._external ? this._external.length : super.length;
-  }
-  add(...t) {
-    this._external ? this._external.add(...t) : super.add(...t);
-  }
-  upsert(...t) {
-    this._external ? this._external.upsert(...t) : super.upsert(...t);
-  }
-  update(t, e) {
-    this._external ? this._external.update(t, e) : super.update(t, e);
-  }
-  remove(...t) {
-    this._external ? this._external.remove(...t) : super.remove(...t);
-  }
-  reset(t) {
-    this._external ? this._external.reset(t) : super.reset(t);
-  }
-  clear() {
-    this._external ? this._external.clear() : super.clear();
-  }
-  optimistic(t) {
-    return this._external ? this._external.optimistic(t) : super.optimistic(t);
-  }
-  get(t) {
-    return this._external ? this._external.get(t) : super.get(t);
-  }
-  has(t) {
-    return this._external ? this._external.has(t) : super.has(t);
-  }
-  find(t) {
-    return this._external ? this._external.find(t) : super.find(t);
-  }
-  filter(t) {
-    return this._external ? this._external.filter(t) : super.filter(t);
-  }
-  sorted(t) {
-    return this._external ? this._external.sorted(t) : super.sorted(t);
-  }
-  map(t) {
-    return this._external ? this._external.map(t) : super.map(t);
-  }
-  subscribe(t) {
-    return this.disposed ? () => {
-    } : this._external ? this._external.subscribe(t) : super.subscribe(t);
-  }
-  // ── Async tracking API ────────────────────────────────────────
-  /** Proxy providing `TaskState` (loading, error, errorCode) per async method. */
-  get async() {
-    if (!this._asyncProxy) {
-      const t = this;
-      this._asyncProxy = new Proxy({}, {
-        get(e, s) {
-          return t._asyncSnapshots.get(s) ?? D;
-        },
-        has(e, s) {
-          return t._asyncSnapshots.has(s);
-        },
-        ownKeys() {
-          return Array.from(t._asyncSnapshots.keys());
-        },
-        getOwnPropertyDescriptor(e, s) {
-          if (t._asyncSnapshots.has(s))
-            return { configurable: !0, enumerable: !0, value: t._asyncSnapshots.get(s) };
-        }
-      });
-    }
-    return this._asyncProxy;
-  }
-  /** Subscribes to async state changes. Used by `useAsync` and `useInstance` for React integration. */
-  subscribeAsync(t) {
-    return this.disposed ? () => {
-    } : (this._asyncListeners.add(t), () => {
-      this._asyncListeners.delete(t);
-    });
-  }
-  // ── Private: async tracking internals ─────────────────────────
-  _notifyAsync() {
-    for (const t of this._asyncListeners)
-      t();
-  }
-  _guardReservedKeys() {
-    b(this, v.prototype, (t) => {
-      if (w.includes(t))
-        throw new Error(
-          `[mvc-kit] "${t}" is a reserved property on Resource and cannot be overridden.`
-        );
-    });
-  }
-  _wrapMethods() {
-    for (const n of w)
-      if (Object.getOwnPropertyDescriptor(this, n)?.value !== void 0)
-        throw new Error(
-          `[mvc-kit] "${n}" is a reserved property on Resource and cannot be overridden.`
-        );
-    const t = this, e = /* @__PURE__ */ new Set(), s = [];
-    f && (this._activeOps = /* @__PURE__ */ new Map()), b(this, v.prototype, (n, o) => {
-      if (o.get || o.set || typeof o.value != "function" || n.startsWith("_") || k.has(n) || e.has(n)) return;
-      e.add(n);
-      const c = o.value;
-      let l = !1;
-      const p = function(...g) {
-        if (t.disposed) {
-          f && console.warn(`[mvc-kit] "${n}" called after dispose — ignored.`);
-          return;
-        }
-        f && !t._initialized && console.warn(
-          `[mvc-kit] "${n}" called before init(). Async tracking is active only after init().`
-        );
-        let u;
-        try {
-          u = c.apply(t, g);
-        } catch (a) {
-          throw a;
-        }
-        if (!u || typeof u.then != "function")
-          return l || (l = !0, t._asyncStates.delete(n), t._asyncSnapshots.delete(n), t[n] = c.bind(t)), u;
-        let i = t._asyncStates.get(n);
-        return i || (i = { loading: !1, error: null, errorCode: null, count: 0 }, t._asyncStates.set(n, i)), i.count++, i.loading = !0, i.error = null, i.errorCode = null, t._asyncSnapshots.set(n, Object.freeze({ loading: !0, error: null, errorCode: null })), t._notifyAsync(), f && t._activeOps && t._activeOps.set(n, (t._activeOps.get(n) ?? 0) + 1), u.then(
-          (a) => {
-            if (t.disposed) return a;
-            if (i.count--, i.loading = i.count > 0, t._asyncSnapshots.set(
-              n,
-              Object.freeze({ loading: i.loading, error: i.error, errorCode: i.errorCode })
-            ), t._notifyAsync(), f && t._activeOps) {
-              const _ = (t._activeOps.get(n) ?? 1) - 1;
-              _ <= 0 ? t._activeOps.delete(n) : t._activeOps.set(n, _);
-            }
-            return a;
-          },
-          (a) => {
-            if (O(a)) {
-              if (t.disposed || (i.count--, i.loading = i.count > 0, t._asyncSnapshots.set(
-                n,
-                Object.freeze({ loading: i.loading, error: i.error, errorCode: i.errorCode })
-              ), t._notifyAsync()), f && t._activeOps) {
-                const h = (t._activeOps.get(n) ?? 1) - 1;
-                h <= 0 ? t._activeOps.delete(n) : t._activeOps.set(n, h);
-              }
-              return;
-            }
-            if (t.disposed) return;
-            i.count--, i.loading = i.count > 0;
-            const _ = T(a);
-            if (i.error = _.message, i.errorCode = _.code, t._asyncSnapshots.set(
-              n,
-              Object.freeze({ loading: i.loading, error: _.message, errorCode: _.code })
-            ), t._notifyAsync(), f && t._activeOps) {
-              const h = (t._activeOps.get(n) ?? 1) - 1;
-              h <= 0 ? t._activeOps.delete(n) : t._activeOps.set(n, h);
-            }
-            throw a;
-          }
-        );
-      };
-      s.push(n), t[n] = p;
-    }), s.length > 0 && this.addCleanup(() => {
-      const n = f && t._activeOps ? new Map(t._activeOps) : null;
-      for (const o of s)
-        f ? t[o] = () => {
-          console.warn(`[mvc-kit] "${o}" called after dispose — ignored.`);
-        } : t[o] = () => {
-        };
-      t._asyncListeners.clear(), t._asyncStates.clear(), t._asyncSnapshots.clear(), f && n && n.size > 0 && t._scheduleGhostCheck(n);
-    });
-  }
-  _scheduleGhostCheck(t) {
-    f && setTimeout(() => {
-      for (const [e, s] of t)
-        console.warn(
-          `[mvc-kit] Ghost async operation detected: "${e}" had ${s} pending call(s) when the Resource was disposed. Consider using disposeSignal to cancel in-flight work.`
-        );
-    }, this.constructor.GHOST_TIMEOUT);
-  }
-}
-class L {
-  _disposed = !1;
-  _initialized = !1;
-  _abortController = null;
-  _cleanups = null;
-  /** Whether this instance has been disposed. */
-  get disposed() {
-    return this._disposed;
-  }
-  /** Whether init() has been called. */
-  get initialized() {
-    return this._initialized;
-  }
-  /** AbortSignal that fires when this instance is disposed. Lazily created. */
-  get disposeSignal() {
-    return this._abortController || (this._abortController = new AbortController()), this._abortController.signal;
-  }
-  /** Initializes the instance. Called automatically by React hooks after mount. */
-  init() {
-    if (!(this._initialized || this._disposed))
-      return this._initialized = !0, this.onInit?.();
-  }
-  /** Tears down the instance, releasing all subscriptions and resources. */
-  dispose() {
-    if (!this._disposed) {
-      if (this._disposed = !0, this._abortController?.abort(), this._cleanups) {
-        for (const t of this._cleanups) t();
-        this._cleanups = null;
-      }
-      this.onDispose?.();
-    }
-  }
-  /** Registers a cleanup function to be called on dispose. @protected */
-  addCleanup(t) {
-    this._cleanups || (this._cleanups = []), this._cleanups.push(t);
-  }
-  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
-  subscribeTo(t, e) {
-    const s = t.subscribe(e);
-    return this.addCleanup(s), s;
-  }
-}
-class V {
-  _disposed = !1;
-  _initialized = !1;
-  _abortController = null;
-  _cleanups = null;
-  /** Whether this instance has been disposed. */
-  get disposed() {
-    return this._disposed;
-  }
-  /** Whether init() has been called. */
-  get initialized() {
-    return this._initialized;
-  }
-  /** AbortSignal that fires when this instance is disposed. Lazily created. */
-  get disposeSignal() {
-    return this._abortController || (this._abortController = new AbortController()), this._abortController.signal;
-  }
-  /** Initializes the instance. Called automatically by React hooks after mount. */
-  init() {
-    if (!(this._initialized || this._disposed))
-      return this._initialized = !0, this.onInit?.();
-  }
-  /** Tears down the instance, releasing all subscriptions and resources. */
-  dispose() {
-    if (!this._disposed) {
-      if (this._disposed = !0, this._abortController?.abort(), this._cleanups) {
-        for (const t of this._cleanups) t();
-        this._cleanups = null;
-      }
-      this.onDispose?.();
-    }
-  }
-  /** Registers a cleanup function to be called on dispose. @protected */
-  addCleanup(t) {
-    this._cleanups || (this._cleanups = []), this._cleanups.push(t);
-  }
-}
-const S = typeof __MVC_KIT_DEV__ < "u" && __MVC_KIT_DEV__, R = Object.freeze({
-  connected: !1,
-  reconnecting: !1,
-  attempt: 0,
-  error: null
-});
-class N {
-  // Static config (subclass overrides)
-  /** Base delay (ms) for reconnection backoff. */
-  static RECONNECT_BASE = 1e3;
-  /** Maximum delay cap (ms) for reconnection backoff. */
-  static RECONNECT_MAX = 3e4;
-  /** Exponential backoff multiplier for reconnection delay. */
-  static RECONNECT_FACTOR = 2;
-  /** Maximum number of reconnection attempts before giving up. */
-  static MAX_ATTEMPTS = 1 / 0;
-  // ── Internal state ──────────────────────────────────────────────
-  _status = R;
-  _connState = 0;
-  _disposed = !1;
-  _initialized = !1;
-  _listeners = /* @__PURE__ */ new Set();
-  _handlers = /* @__PURE__ */ new Map();
-  _abortController = null;
-  _connectAbort = null;
-  _reconnectTimer = null;
-  _cleanups = null;
-  // ── Subscribable<ChannelStatus> ─────────────────────────────────
-  /** Current connection status. */
-  get state() {
-    return this._status;
-  }
-  /** Subscribes to connection status changes. Returns an unsubscribe function. */
-  subscribe(t) {
-    return this._disposed ? () => {
-    } : (this._listeners.add(t), () => {
-      this._listeners.delete(t);
-    });
-  }
-  // ── Disposable / Initializable ──────────────────────────────────
-  /** Whether this instance has been disposed. */
-  get disposed() {
-    return this._disposed;
-  }
-  /** Whether init() has been called. */
-  get initialized() {
-    return this._initialized;
-  }
-  /** AbortSignal that fires when this instance is disposed. Lazily created. */
-  get disposeSignal() {
-    return this._abortController || (this._abortController = new AbortController()), this._abortController.signal;
-  }
-  /** Initializes the instance. Called automatically by React hooks after mount. */
-  init() {
-    if (!(this._initialized || this._disposed))
-      return this._initialized = !0, this.onInit?.();
-  }
-  /** Tears down the instance, releasing all subscriptions and resources. */
-  dispose() {
-    if (!this._disposed) {
-      this._disposed = !0, this._connState = 4, this._reconnectTimer !== null && (clearTimeout(this._reconnectTimer), this._reconnectTimer = null), this._connectAbort?.abort(), this._connectAbort = null, this._abortController?.abort();
-      try {
-        this.close();
-      } catch {
-      }
-      if (this._cleanups) {
-        for (const t of this._cleanups) t();
-        this._cleanups = null;
-      }
-      this.onDispose?.(), this._listeners.clear(), this._handlers.clear();
-    }
-  }
-  // ── Connection control ──────────────────────────────────────────
-  /** Initiates a connection with automatic reconnection on failure. */
-  connect() {
-    if (this._disposed) {
-      S && console.warn("[mvc-kit] connect() called after dispose — ignored.");
-      return;
-    }
-    S && !this._initialized && console.warn("[mvc-kit] connect() called before init()."), !(this._connState === 1 || this._connState === 2) && (this._reconnectTimer !== null && (clearTimeout(this._reconnectTimer), this._reconnectTimer = null), this._attemptConnect(0));
-  }
-  /** Closes the connection and cancels any pending reconnection. */
-  disconnect() {
-    if (!this._disposed) {
-      if (this._reconnectTimer !== null && (clearTimeout(this._reconnectTimer), this._reconnectTimer = null), this._connectAbort?.abort(), this._connectAbort = null, this._connState === 2 || this._connState === 1) {
-        this._connState = 0;
-        try {
-          this.close();
-        } catch {
-        }
-      } else
-        this._connState = 0;
-      this._setStatus({ connected: !1, reconnecting: !1, attempt: 0, error: null });
-    }
-  }
-  // ── Subclass signals ────────────────────────────────────────────
-  /** Call from subclass when a message arrives from the transport. @protected */
-  receive(t, e) {
-    if (this._disposed) {
-      S && console.warn(`[mvc-kit] receive("${String(t)}") called after dispose — ignored.`);
-      return;
-    }
-    const s = this._handlers.get(t);
-    if (s)
-      for (const n of s)
-        n(e);
-  }
-  /** Call from subclass when the transport connection drops unexpectedly. Triggers reconnection. @protected */
-  disconnected() {
-    this._disposed || this._connState !== 2 && this._connState !== 1 || (this._connectAbort?.abort(), this._connectAbort = null, this._connState = 3, this._scheduleReconnect(1));
-  }
-  // ── Consumer API ────────────────────────────────────────────────
-  /** Subscribes to a specific message type. Returns an unsubscribe function. */
-  on(t, e) {
-    if (this._disposed) return () => {
-    };
-    let s = this._handlers.get(t);
-    return s || (s = /* @__PURE__ */ new Set(), this._handlers.set(t, s)), s.add(e), () => {
-      s.delete(e);
-    };
-  }
-  /** Subscribes to a message type, auto-removing the handler after the first invocation. */
-  once(t, e) {
-    const s = this.on(t, (n) => {
-      s(), e(n);
-    });
-    return s;
-  }
-  // ── Infrastructure ──────────────────────────────────────────────
-  /** Registers a cleanup function to be called on dispose. @protected */
-  addCleanup(t) {
-    this._cleanups || (this._cleanups = []), this._cleanups.push(t);
-  }
-  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
-  subscribeTo(t, e) {
-    const s = t.subscribe(e);
-    return this.addCleanup(s), s;
-  }
-  // ── Backoff ─────────────────────────────────────────────────────
-  /** Computes the reconnect backoff delay with jitter for the given attempt number. @protected */
-  _calculateDelay(t) {
-    const e = this.constructor, s = Math.min(
-      e.RECONNECT_BASE * Math.pow(e.RECONNECT_FACTOR, t),
-      e.RECONNECT_MAX
-    );
-    return Math.random() * s;
-  }
-  // ── Internals ───────────────────────────────────────────────────
-  _setStatus(t) {
-    const e = this._status;
-    if (!(e.connected === t.connected && e.reconnecting === t.reconnecting && e.attempt === t.attempt && e.error === t.error)) {
-      this._status = Object.freeze(t);
-      for (const s of this._listeners)
-        s(this._status, e);
-    }
-  }
-  _attemptConnect(t) {
-    if (this._disposed) return;
-    this._connState = 1, this._connectAbort?.abort(), this._connectAbort = new AbortController();
-    const e = this._abortController ? AbortSignal.any([this._abortController.signal, this._connectAbort.signal]) : this._connectAbort.signal;
-    this._setStatus({
-      connected: !1,
-      reconnecting: t > 0,
-      attempt: t,
-      error: null
-    });
-    let s;
-    try {
-      s = this.open(e);
-    } catch (n) {
-      this._onOpenFailed(t, n);
-      return;
-    }
-    s && typeof s.then == "function" ? s.then(
-      () => this._onOpenSucceeded(),
-      (n) => this._onOpenFailed(t, n)
-    ) : this._onOpenSucceeded();
-  }
-  _onOpenSucceeded() {
-    this._disposed || this._connState === 1 && (this._connState = 2, this._setStatus({
-      connected: !0,
-      reconnecting: !1,
-      attempt: 0,
-      error: null
-    }));
-  }
-  _onOpenFailed(t, e) {
-    this._disposed || this._connState !== 0 && (this._connectAbort?.abort(), this._connectAbort = null, this._connState = 3, this._scheduleReconnect(t + 1, e));
-  }
-  _scheduleReconnect(t, e) {
-    const s = this.constructor;
-    if (t > s.MAX_ATTEMPTS) {
-      this._connState = 0, this._setStatus({
-        connected: !1,
-        reconnecting: !1,
-        attempt: t,
-        error: e instanceof Error ? e.message : "Max reconnection attempts reached"
-      });
-      return;
-    }
-    const n = e instanceof Error ? e.message : e ? String(e) : null;
-    this._setStatus({
-      connected: !1,
-      reconnecting: !0,
-      attempt: t,
-      error: n
-    });
-    const o = this._calculateDelay(t - 1);
-    this._reconnectTimer = setTimeout(() => {
-      this._reconnectTimer = null, this._attemptConnect(t);
-    }, o);
-  }
-}
+import { ViewModel } from "./ViewModel.js";
+import { Model } from "./Model.js";
+import { Collection } from "./Collection.js";
+import { PersistentCollection } from "./PersistentCollection.js";
+import { Resource } from "./Resource.js";
+import { Controller } from "./Controller.js";
+import { Service } from "./Service.js";
+import { EventBus } from "./EventBus.js";
+import { Channel } from "./Channel.js";
+import { HttpError, classifyError, isAbortError } from "./errors.js";
+import { hasSingleton, singleton, teardown, teardownAll } from "./singleton.js";
 export {
-  N as Channel,
-  A as Collection,
-  L as Controller,
-  E as EventBus,
-  x as HttpError,
-  $ as Model,
-  U as PersistentCollection,
-  v as Resource,
-  V as Service,
-  y as ViewModel,
-  T as classifyError,
-  B as hasSingleton,
-  O as isAbortError,
-  F as singleton,
-  X as teardown,
-  Y as teardownAll
+  Channel,
+  Collection,
+  Controller,
+  EventBus,
+  HttpError,
+  Model,
+  PersistentCollection,
+  Resource,
+  Service,
+  ViewModel,
+  classifyError,
+  hasSingleton,
+  isAbortError,
+  singleton,
+  teardown,
+  teardownAll
 };
 //# sourceMappingURL=mvc-kit.js.map