mvc-kit 2.3.0 → 2.5.0

package/dist/mvc-kit.js

@@ -1,31 +1,33 @@
-import { E as w } from "./singleton-CaEXSbYg.js";
-import { h as N, s as $, t as L, a as B } from "./singleton-CaEXSbYg.js";
-class C extends Error {
+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, s) {
     super(s ?? `HTTP ${t}`), this.status = t, this.name = "HttpError";
   }
 }
-function y(r) {
+function O(r) {
   return r instanceof Error && r.name === "AbortError";
 }
-function S(r) {
+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 T(r) {
+function z(r) {
   return typeof r == "object" && r !== null && typeof r.status == "number" && typeof r.statusText == "string" && !(r instanceof Error);
 }
-function E(r) {
+function T(r) {
   return r instanceof Error && r.name === "AbortError" ? {
     code: "abort",
     message: "Request was aborted",
     original: r
-  } : r instanceof C ? {
-    code: S(r.status),
+  } : r instanceof x ? {
+    code: C(r.status),
     message: r.message,
     status: r.status,
     original: r
-  } : T(r) ? {
-    code: S(r.status),
+  } : z(r) ? {
+    code: C(r.status),
     message: r.statusText || `HTTP ${r.status}`,
     status: r.status,
     original: r
@@ -48,20 +50,20 @@ function E(r) {
   };
 }
 const d = typeof __MVC_KIT_DEV__ < "u" && __MVC_KIT_DEV__;
-function O(r) {
+function M(r) {
   return r !== null && typeof r == "object" && typeof r.subscribe == "function";
 }
 function b(r, t, s) {
   let e = Object.getPrototypeOf(r);
   for (; e && e !== t; ) {
-    const i = Object.getOwnPropertyDescriptors(e);
-    for (const [n, a] of Object.entries(i))
-      n !== "constructor" && s(n, a, e);
+    const n = Object.getOwnPropertyDescriptors(e);
+    for (const [o, c] of Object.entries(n))
+      o !== "constructor" && s(o, c, e);
     e = Object.getPrototypeOf(e);
   }
 }
-const z = Object.freeze({ loading: !1, error: null, errorCode: null }), v = ["async", "subscribeAsync"], A = /* @__PURE__ */ new Set(["onInit", "onSet", "onDispose"]);
-class m {
+const j = Object.freeze({ loading: !1, error: null, errorCode: null }), m = ["async", "subscribeAsync"], P = /* @__PURE__ */ new Set(["onInit", "onSet", "onDispose"]);
+class S {
   _state;
   _initialState;
   _disposed = !1;
@@ -105,7 +107,7 @@ class m {
   }
   /** Lazily-created typed EventBus for emitting and subscribing to events. */
   get events() {
-    return this._eventBus || (this._eventBus = new w()), this._eventBus;
+    return this._eventBus || (this._eventBus = new E()), this._eventBus;
   }
   /** Initializes the instance. Called automatically by React hooks after mount. */
   init() {
@@ -132,13 +134,13 @@ class m {
     }
     const s = typeof t == "function" ? t(this._state) : t;
     if (!Object.keys(s).some(
-      (o) => s[o] !== this._state[o]
+      (l) => s[l] !== this._state[l]
     ))
       return;
-    const n = this._state, a = Object.freeze({ ...n, ...s });
-    this._state = a, this._revision++, this.onSet?.(n, a);
-    for (const o of this._listeners)
-      o(a, n);
+    const o = this._state, c = Object.freeze({ ...o, ...s });
+    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.
@@ -198,7 +200,7 @@ class m {
       const t = this;
       this._asyncProxy = new Proxy({}, {
         get(s, e) {
-          return t._asyncSnapshots.get(e) ?? z;
+          return t._asyncSnapshots.get(e) ?? j;
         },
         has(s, e) {
           return t._asyncSnapshots.has(e);
@@ -234,88 +236,88 @@ class m {
     }
   }
   _guardReservedKeys() {
-    b(this, m.prototype, (t) => {
-      if (v.includes(t))
+    b(this, S.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 i of v)
-      if (Object.getOwnPropertyDescriptor(this, i)?.value !== void 0)
+    for (const n of m)
+      if (Object.getOwnPropertyDescriptor(this, n)?.value !== void 0)
         throw new Error(
-          `[mvc-kit] "${i}" is a reserved property on ViewModel and cannot be overridden.`
+          `[mvc-kit] "${n}" is a reserved property on ViewModel and cannot be overridden.`
         );
     const t = this, s = /* @__PURE__ */ new Set(), e = [];
-    d && (this._activeOps = /* @__PURE__ */ new Map()), b(this, m.prototype, (i, n) => {
-      if (n.get || n.set || typeof n.value != "function" || i.startsWith("_") || A.has(i) || s.has(i)) return;
-      s.add(i);
-      const a = n.value;
-      let o = !1;
-      const l = function(...h) {
+    d && (this._activeOps = /* @__PURE__ */ new Map()), b(this, S.prototype, (n, o) => {
+      if (o.get || o.set || typeof o.value != "function" || n.startsWith("_") || P.has(n) || s.has(n)) return;
+      s.add(n);
+      const c = o.value;
+      let l = !1;
+      const p = function(...g) {
         if (t._disposed) {
-          d && console.warn(`[mvc-kit] "${i}" called after dispose — ignored.`);
+          d && console.warn(`[mvc-kit] "${n}" called after dispose — ignored.`);
           return;
         }
         d && !t._initialized && console.warn(
-          `[mvc-kit] "${i}" called before init(). Async tracking is active only after init().`
+          `[mvc-kit] "${n}" called before init(). Async tracking is active only after init().`
         );
         let u;
         try {
-          u = a.apply(t, h);
-        } catch (_) {
-          throw _;
+          u = c.apply(t, g);
+        } catch (a) {
+          throw a;
         }
         if (!u || typeof u.then != "function")
-          return o || (o = !0, t._asyncStates.delete(i), t._asyncSnapshots.delete(i), t[i] = a.bind(t)), u;
-        let c = t._asyncStates.get(i);
-        return c || (c = { loading: !1, error: null, errorCode: null, count: 0 }, t._asyncStates.set(i, c)), c.count++, c.loading = !0, c.error = null, c.errorCode = null, t._asyncSnapshots.set(i, Object.freeze({ loading: !0, error: null, errorCode: null })), t._notifyAsync(), d && t._activeOps && t._activeOps.set(i, (t._activeOps.get(i) ?? 0) + 1), u.then(
-          (_) => {
-            if (t._disposed) return _;
-            if (c.count--, c.loading = c.count > 0, t._asyncSnapshots.set(
-              i,
-              Object.freeze({ loading: c.loading, error: c.error, errorCode: c.errorCode })
+          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 f = (t._activeOps.get(i) ?? 1) - 1;
-              f <= 0 ? t._activeOps.delete(i) : t._activeOps.set(i, f);
+              const _ = (t._activeOps.get(n) ?? 1) - 1;
+              _ <= 0 ? t._activeOps.delete(n) : t._activeOps.set(n, _);
             }
-            return _;
+            return a;
           },
-          (_) => {
-            if (y(_)) {
-              if (t._disposed || (c.count--, c.loading = c.count > 0, t._asyncSnapshots.set(
-                i,
-                Object.freeze({ loading: c.loading, error: c.error, errorCode: c.errorCode })
+          (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 p = (t._activeOps.get(i) ?? 1) - 1;
-                p <= 0 ? t._activeOps.delete(i) : t._activeOps.set(i, p);
+                const h = (t._activeOps.get(n) ?? 1) - 1;
+                h <= 0 ? t._activeOps.delete(n) : t._activeOps.set(n, h);
               }
               return;
             }
             if (t._disposed) return;
-            c.count--, c.loading = c.count > 0;
-            const f = E(_);
-            if (c.error = f.message, c.errorCode = f.code, t._asyncSnapshots.set(
-              i,
-              Object.freeze({ loading: c.loading, error: f.message, errorCode: f.code })
+            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 p = (t._activeOps.get(i) ?? 1) - 1;
-              p <= 0 ? t._activeOps.delete(i) : t._activeOps.set(i, p);
+              const h = (t._activeOps.get(n) ?? 1) - 1;
+              h <= 0 ? t._activeOps.delete(n) : t._activeOps.set(n, h);
             }
-            throw _;
+            throw a;
           }
         );
       };
-      e.push(i), t[i] = l;
+      e.push(n), t[n] = p;
     }), e.length > 0 && this.addCleanup(() => {
-      const i = d && t._activeOps ? new Map(t._activeOps) : null;
-      for (const n of e)
-        d ? t[n] = () => {
-          console.warn(`[mvc-kit] "${n}" called after dispose — ignored.`);
-        } : t[n] = () => {
+      const n = d && t._activeOps ? new Map(t._activeOps) : null;
+      for (const o of e)
+        d ? t[o] = () => {
+          console.warn(`[mvc-kit] "${o}" called after dispose — ignored.`);
+        } : t[o] = () => {
         };
-      t._asyncListeners.clear(), t._asyncStates.clear(), t._asyncSnapshots.clear(), d && i && i.size > 0 && t._scheduleGhostCheck(i);
+      t._asyncListeners.clear(), t._asyncStates.clear(), t._asyncSnapshots.clear(), d && n && n.size > 0 && t._scheduleGhostCheck(n);
     });
   }
   _scheduleGhostCheck(t) {
@@ -371,15 +373,15 @@ class m {
   _trackSubscribables() {
     for (const t of Object.getOwnPropertyNames(this)) {
       const s = this[t];
-      if (!O(s)) continue;
+      if (!M(s)) continue;
       const e = {
         source: s,
         revision: 0,
         unsubscribe: s.subscribe(() => {
           if (!this._disposed) {
             e.revision++, this._revision++, this._state = Object.freeze({ ...this._state });
-            for (const i of this._listeners)
-              i(this._state, this._state);
+            for (const n of this._listeners)
+              n(this._state, this._state);
           }
         })
       };
@@ -400,7 +402,7 @@ class m {
    */
   _memoizeGetters() {
     const t = /* @__PURE__ */ new Set();
-    b(this, m.prototype, (s, e) => {
+    b(this, S.prototype, (s, e) => {
       !e.get || t.has(s) || (t.add(s), this._wrapGetter(s, e.get));
     });
   }
@@ -415,57 +417,57 @@ class m {
    *   Tier 3 (slow):   at least one dep changed → full recompute with tracking
    */
   _wrapGetter(t, s) {
-    let e, i = -1, n, a, o;
+    let e, n = -1, o, c, l;
     Object.defineProperty(this, t, {
       get: () => {
-        if (this._disposed || i === this._revision)
+        if (this._disposed || n === this._revision)
           return e;
-        if (n && a) {
-          let c = !0;
-          for (const [_, f] of a)
-            if (this._state[_] !== f) {
-              c = !1;
+        if (o && c) {
+          let i = !0;
+          for (const [a, _] of c)
+            if (this._state[a] !== _) {
+              i = !1;
               break;
             }
-          if (c && o)
-            for (const [_, f] of o) {
-              const p = this._trackedSources.get(_);
-              if (p && p.revision !== f) {
-                c = !1;
+          if (i && l)
+            for (const [a, _] of l) {
+              const h = this._trackedSources.get(a);
+              if (h && h.revision !== _) {
+                i = !1;
                 break;
               }
             }
-          if (c)
-            return i = this._revision, e;
+          if (i)
+            return n = this._revision, e;
         }
-        const l = this._stateTracking, h = this._sourceTracking;
+        const p = this._stateTracking, g = this._sourceTracking;
         this._stateTracking = /* @__PURE__ */ new Set(), this._sourceTracking = /* @__PURE__ */ new Map();
         try {
           e = s.call(this);
-        } catch (c) {
-          throw this._stateTracking = l, this._sourceTracking = h, c;
+        } catch (i) {
+          throw this._stateTracking = p, this._sourceTracking = g, i;
         }
-        n = this._stateTracking;
+        o = this._stateTracking;
         const u = this._sourceTracking;
-        if (this._stateTracking = l, this._sourceTracking = h, l)
-          for (const c of n) l.add(c);
-        if (h)
-          for (const [c, _] of u)
-            h.set(c, _);
-        a = /* @__PURE__ */ new Map();
-        for (const c of n)
-          a.set(c, this._state[c]);
-        o = /* @__PURE__ */ new Map();
-        for (const [c, _] of u)
-          o.set(c, _.revision);
-        return i = this._revision, e;
+        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, e;
       },
       configurable: !0,
       enumerable: !0
     });
   }
 }
-class j {
+class $ {
   _state;
   _committed;
   _disposed = !1;
@@ -531,13 +533,13 @@ class j {
       throw new Error("Cannot set state on disposed Model");
     const s = typeof t == "function" ? t(this._state) : t;
     if (!Object.keys(s).some(
-      (o) => s[o] !== this._state[o]
+      (l) => s[l] !== this._state[l]
     ))
       return;
-    const n = this._state, a = Object.freeze({ ...n, ...s });
-    this._state = a, this.onSet?.(n, a);
-    for (const o of this._listeners)
-      o(a, n);
+    const o = this._state, c = Object.freeze({ ...o, ...s });
+    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).
@@ -594,348 +596,230 @@ class j {
     return this.addCleanup(e), e;
   }
   shallowEqual(t, s) {
-    const e = Object.keys(t), i = Object.keys(s);
-    if (e.length !== i.length)
+    const e = Object.keys(t), n = Object.keys(s);
+    if (e.length !== n.length)
       return !1;
-    for (const n of e)
-      if (t[n] !== s[n])
+    for (const o of e)
+      if (t[o] !== s[o])
         return !1;
     return !0;
   }
 }
-const x = typeof __MVC_KIT_DEV__ < "u" && __MVC_KIT_DEV__;
-class D {
-  /** Maximum number of items before FIFO eviction. 0 = unlimited. */
-  static MAX_SIZE = 0;
-  /** Time-to-live in milliseconds. 0 = no expiry. */
-  static TTL = 0;
-  _items = [];
-  _disposed = !1;
-  _listeners = /* @__PURE__ */ new Set();
-  _index = /* @__PURE__ */ new Map();
-  _abortController = null;
-  _cleanups = null;
-  _timestamps = null;
-  _evictionTimer = null;
-  constructor(t = []) {
-    let s = [...t];
-    if (this._ttl > 0) {
-      this._timestamps = /* @__PURE__ */ new Map();
-      const e = Date.now();
-      for (const i of s)
-        this._timestamps.set(i.id, e);
-    }
-    if (this._maxSize > 0 && s.length > this._maxSize) {
-      const e = s.length - this._maxSize, i = s.slice(0, e);
-      s = s.slice(e);
-      for (const n of i)
-        this._timestamps?.delete(n.id);
+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 s = t != null && !Array.isArray(t);
+    if (super(s ? [] : t ?? []), s && (this._external = t, f)) {
+      const e = this.constructor;
+      (e.MAX_SIZE > 0 || e.TTL > 0) && console.warn(
+        `[mvc-kit] Resource "${e.name}" has MAX_SIZE or TTL set but uses an injected Collection. Configure these on the Collection instead.`
+      );
     }
-    this._items = Object.freeze(s), this.rebuildIndex(), this._scheduleEvictionTimer();
+    this._guardReservedKeys();
   }
-  /**
-   * Alias for Subscribable compatibility.
-   */
+  // ── 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._items;
+    return this._external ? this._external.state : super.state;
   }
-  /** The raw readonly array of items. */
   get items() {
-    return this._items;
+    return this._external ? this._external.items : super.items;
   }
-  /** Number of items in the collection. */
   get length() {
-    return this._items.length;
-  }
-  /** Whether this instance has been disposed. */
-  get disposed() {
-    return this._disposed;
+    return this._external ? this._external.length : super.length;
   }
-  /** AbortSignal that fires when this instance is disposed. Lazily created. */
-  get disposeSignal() {
-    return this._abortController || (this._abortController = new AbortController()), this._abortController.signal;
-  }
-  // ── Config Accessors ──
-  get _maxSize() {
-    return this.constructor.MAX_SIZE;
-  }
-  get _ttl() {
-    return this.constructor.TTL;
-  }
-  // ── CRUD Methods (notify listeners) ──
-  /**
-   * Add one or more items. Items with existing IDs are silently skipped.
-   */
   add(...t) {
-    if (this._disposed)
-      throw new Error("Cannot add to disposed Collection");
-    if (t.length === 0)
-      return;
-    const s = /* @__PURE__ */ new Set(), e = [];
-    for (const a of t)
-      !this._index.has(a.id) && !s.has(a.id) && (e.push(a), s.add(a.id));
-    if (e.length === 0) return;
-    const i = this._items;
-    let n = [...i, ...e];
-    for (const a of e)
-      this._index.set(a.id, a);
-    if (this._timestamps) {
-      const a = Date.now();
-      for (const o of e)
-        this._timestamps.set(o.id, a);
-    }
-    this._maxSize > 0 && n.length > this._maxSize && (n = this._evictForCapacity(n)), this._items = Object.freeze(n), this.notify(i), this._scheduleEvictionTimer();
+    this._external ? this._external.add(...t) : super.add(...t);
   }
-  /**
-   * Add or replace items by ID. Existing items are replaced in-place
-   * (preserving array position); new items are appended. Deduplicates
-   * input — last occurrence wins. No-op if nothing changed (reference
-   * comparison).
-   */
   upsert(...t) {
-    if (this._disposed)
-      throw new Error("Cannot upsert on disposed Collection");
-    if (t.length === 0) return;
-    const s = /* @__PURE__ */ new Map();
-    for (const l of t)
-      s.set(l.id, l);
-    const e = this._items;
-    let i = !1;
-    const n = /* @__PURE__ */ new Set(), a = [];
-    for (const l of e)
-      if (s.has(l.id)) {
-        const h = s.get(l.id);
-        h !== l && (i = !0), a.push(h), n.add(l.id);
-      } else
-        a.push(l);
-    for (const [l, h] of s)
-      n.has(l) || (a.push(h), i = !0);
-    if (!i) return;
-    if (this._timestamps) {
-      const l = Date.now();
-      for (const [h] of s)
-        this._timestamps.set(h, l);
-    }
-    for (const [l, h] of s)
-      this._index.set(l, h);
-    let o = a;
-    this._maxSize > 0 && o.length > this._maxSize && (o = this._evictForCapacity(o)), this._items = Object.freeze(o), this.notify(e), this._scheduleEvictionTimer();
-  }
-  /**
-   * Remove items by id(s).
-   */
-  remove(...t) {
-    if (this._disposed)
-      throw new Error("Cannot remove from disposed Collection");
-    if (t.length === 0)
-      return;
-    const s = new Set(t), e = this._items.filter((n) => !s.has(n.id));
-    if (e.length === this._items.length)
-      return;
-    const i = this._items;
-    this._items = Object.freeze(e);
-    for (const n of t)
-      this._index.delete(n), this._timestamps?.delete(n);
-    this.notify(i), this._scheduleEvictionTimer();
+    this._external ? this._external.upsert(...t) : super.upsert(...t);
   }
-  /**
-   * Update an item by id with partial changes.
-   */
   update(t, s) {
-    if (this._disposed)
-      throw new Error("Cannot update disposed Collection");
-    const e = this._items.findIndex((u) => u.id === t);
-    if (e === -1)
-      return;
-    const i = this._items[e], n = { ...i, ...s, id: t };
-    if (!Object.keys(s).some((u) => s[u] !== i[u]))
-      return;
-    const l = this._items, h = [...l];
-    h[e] = n, this._items = Object.freeze(h), this._index.set(t, n), this.notify(l);
+    this._external ? this._external.update(t, s) : super.update(t, s);
+  }
+  remove(...t) {
+    this._external ? this._external.remove(...t) : super.remove(...t);
   }
-  /**
-   * Replace all items.
-   */
   reset(t) {
-    if (this._disposed)
-      throw new Error("Cannot reset disposed Collection");
-    const s = this._items;
-    if (this._timestamps) {
-      this._timestamps.clear();
-      const i = Date.now();
-      for (const n of t)
-        this._timestamps.set(n.id, i);
-    }
-    let e = [...t];
-    this._maxSize > 0 && e.length > this._maxSize && (e = this._evictForCapacity(e)), this._items = Object.freeze(e), this.rebuildIndex(), this.notify(s), this._scheduleEvictionTimer();
+    this._external ? this._external.reset(t) : super.reset(t);
   }
-  /**
-   * Remove all items.
-   */
   clear() {
-    if (this._disposed)
-      throw new Error("Cannot clear disposed Collection");
-    if (this._items.length === 0)
-      return;
-    const t = this._items;
-    this._items = Object.freeze([]), this._index.clear(), this._timestamps?.clear(), this._clearEvictionTimer(), this.notify(t);
+    this._external ? this._external.clear() : super.clear();
   }
-  /**
-   * Snapshot current state, apply callback mutations, and return a rollback function.
-   * Rollback restores items to pre-callback state regardless of later mutations.
-   */
   optimistic(t) {
-    if (this._disposed)
-      throw new Error("Cannot perform optimistic update on disposed Collection");
-    const s = this._items, e = this._timestamps ? new Map(this._timestamps) : null;
-    t();
-    let i = !1;
-    return () => {
-      if (i || this._disposed) return;
-      i = !0;
-      const n = this._items;
-      this._items = s, e && (this._timestamps = e), this.rebuildIndex(), this.notify(n), this._scheduleEvictionTimer();
-    };
+    return this._external ? this._external.optimistic(t) : super.optimistic(t);
   }
-  // ── Query Methods (pure, no notification) ──
-  /**
-   * Get item by id.
-   */
   get(t) {
-    return this._index.get(t);
+    return this._external ? this._external.get(t) : super.get(t);
   }
-  /**
-   * Check if item exists by id.
-   */
   has(t) {
-    return this._index.has(t);
+    return this._external ? this._external.has(t) : super.has(t);
   }
-  /**
-   * Find first item matching predicate.
-   */
   find(t) {
-    return this._items.find(t);
+    return this._external ? this._external.find(t) : super.find(t);
   }
-  /**
-   * Filter items matching predicate.
-   */
   filter(t) {
-    return this._items.filter(t);
+    return this._external ? this._external.filter(t) : super.filter(t);
   }
-  /**
-   * Return sorted copy.
-   */
   sorted(t) {
-    return [...this._items].sort(t);
+    return this._external ? this._external.sorted(t) : super.sorted(t);
   }
-  /**
-   * Map items to new array.
-   */
   map(t) {
-    return this._items.map(t);
+    return this._external ? this._external.map(t) : super.map(t);
   }
-  // ── Subscribable interface ──
-  /** Subscribes to state changes. Returns an unsubscribe function. */
   subscribe(t) {
-    return this._disposed ? () => {
-    } : (this._listeners.add(t), () => {
-      this._listeners.delete(t);
-    });
+    return this.disposed ? () => {
+    } : this._external ? this._external.subscribe(t) : super.subscribe(t);
   }
-  /** Tears down the instance, releasing all subscriptions and resources. */
-  dispose() {
-    if (!this._disposed) {
-      if (this._disposed = !0, this._clearEvictionTimer(), this._abortController?.abort(), this._cleanups) {
-        for (const t of this._cleanups) t();
-        this._cleanups = null;
-      }
-      this.onDispose?.(), this._listeners.clear(), this._index.clear(), this._timestamps?.clear();
+  // ── 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(s, e) {
+          return t._asyncSnapshots.get(e) ?? D;
+        },
+        has(s, e) {
+          return t._asyncSnapshots.has(e);
+        },
+        ownKeys() {
+          return Array.from(t._asyncSnapshots.keys());
+        },
+        getOwnPropertyDescriptor(s, e) {
+          if (t._asyncSnapshots.has(e))
+            return { configurable: !0, enumerable: !0, value: t._asyncSnapshots.get(e) };
+        }
+      });
     }
+    return this._asyncProxy;
   }
-  /** Registers a cleanup function to be called on dispose. @protected */
-  addCleanup(t) {
-    this._cleanups || (this._cleanups = []), this._cleanups.push(t);
+  /** 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);
+    });
   }
-  notify(t) {
-    for (const s of this._listeners)
-      s(this._items, t);
-  }
-  rebuildIndex() {
-    this._index.clear();
-    for (const t of this._items)
-      this._index.set(t.id, t);
-  }
-  // ── Eviction Internals ──
-  _evictForCapacity(t) {
-    const s = t.length - this._maxSize;
-    if (s <= 0) return t;
-    const e = t.slice(0, s), i = this._applyOnEvict(e, "capacity");
-    if (i === !1 || i.length === 0) return t;
-    const n = new Set(i.map((o) => o.id)), a = t.filter((o) => !n.has(o.id));
-    for (const o of i)
-      this._index.delete(o.id), this._timestamps?.delete(o.id);
-    return a;
-  }
-  _applyOnEvict(t, s) {
-    if (!this.onEvict) return t;
-    const e = this.onEvict(t, s);
-    if (e === !1) {
-      if (x && s === "capacity" && this._maxSize > 0) {
-        const i = this._items.length + t.length;
-        i > this._maxSize * 2 && console.warn(
-          `[mvc-kit] Collection exceeded 2x MAX_SIZE (${i}/${this._maxSize}). onEvict is vetoing eviction — this may cause unbounded growth.`
+  // ── 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.`
         );
-      }
-      return !1;
-    }
-    if (Array.isArray(e)) {
-      const i = new Set(t.map((n) => n.id));
-      return e.filter((n) => i.has(n.id));
-    }
-    return t;
-  }
-  _sweepExpired() {
-    if (this._disposed || !this._timestamps || this._ttl <= 0) return;
-    const t = Date.now(), s = this._ttl, e = [];
-    for (const o of this._items) {
-      const l = this._timestamps.get(o.id);
-      l !== void 0 && t - l >= s && e.push(o);
-    }
-    if (e.length === 0) {
-      this._scheduleEvictionTimer();
-      return;
-    }
-    const i = this._applyOnEvict(e, "ttl");
-    if (i === !1) {
-      this._scheduleEvictionTimer();
-      return;
-    }
-    if (i.length === 0) {
-      this._scheduleEvictionTimer();
-      return;
-    }
-    const n = new Set(i.map((o) => o.id)), a = this._items;
-    this._items = Object.freeze(
-      a.filter((o) => !n.has(o.id))
-    );
-    for (const o of i)
-      this._index.delete(o.id), this._timestamps.delete(o.id);
-    this.notify(a), this._scheduleEvictionTimer();
-  }
-  _scheduleEvictionTimer() {
-    if (this._clearEvictionTimer(), this._disposed || !this._timestamps || this._ttl <= 0 || this._timestamps.size === 0) return;
-    const t = Date.now(), s = this._ttl;
-    let e = 1 / 0;
-    for (const n of this._timestamps.values())
-      n < e && (e = n);
-    const i = Math.max(0, e + s - t);
-    this._evictionTimer = setTimeout(() => this._sweepExpired(), i);
-  }
-  _clearEvictionTimer() {
-    this._evictionTimer !== null && (clearTimeout(this._evictionTimer), this._evictionTimer = null);
+    });
+  }
+  _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, s = /* @__PURE__ */ new Set(), e = [];
+    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) || s.has(n)) return;
+      s.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;
+          }
+        );
+      };
+      e.push(n), t[n] = p;
+    }), e.length > 0 && this.addCleanup(() => {
+      const n = f && t._activeOps ? new Map(t._activeOps) : null;
+      for (const o of e)
+        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 [s, e] of t)
+        console.warn(
+          `[mvc-kit] Ghost async operation detected: "${s}" had ${e} pending call(s) when the Resource was disposed. Consider using disposeSignal to cancel in-flight work.`
+        );
+    }, this.constructor.GHOST_TIMEOUT);
   }
 }
-class I {
+class L {
   _disposed = !1;
   _initialized = !1;
   _abortController = null;
@@ -977,7 +861,7 @@ class I {
     return this.addCleanup(e), e;
   }
 }
-class P {
+class V {
   _disposed = !1;
   _initialized = !1;
   _abortController = null;
@@ -1014,13 +898,13 @@ class P {
     this._cleanups || (this._cleanups = []), this._cleanups.push(t);
   }
 }
-const g = typeof __MVC_KIT_DEV__ < "u" && __MVC_KIT_DEV__, k = Object.freeze({
+const y = typeof __MVC_KIT_DEV__ < "u" && __MVC_KIT_DEV__, R = Object.freeze({
   connected: !1,
   reconnecting: !1,
   attempt: 0,
   error: null
 });
-class R {
+class N {
   // Static config (subclass overrides)
   /** Base delay (ms) for reconnection backoff. */
   static RECONNECT_BASE = 1e3;
@@ -1031,7 +915,7 @@ class R {
   /** Maximum number of reconnection attempts before giving up. */
   static MAX_ATTEMPTS = 1 / 0;
   // ── Internal state ──────────────────────────────────────────────
-  _status = k;
+  _status = R;
   _connState = 0;
   _disposed = !1;
   _initialized = !1;
@@ -1090,10 +974,10 @@ class R {
   /** Initiates a connection with automatic reconnection on failure. */
   connect() {
     if (this._disposed) {
-      g && console.warn("[mvc-kit] connect() called after dispose — ignored.");
+      y && console.warn("[mvc-kit] connect() called after dispose — ignored.");
       return;
     }
-    g && !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));
+    y && !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() {
@@ -1113,13 +997,13 @@ class R {
   /** Call from subclass when a message arrives from the transport. @protected */
   receive(t, s) {
     if (this._disposed) {
-      g && console.warn(`[mvc-kit] receive("${String(t)}") called after dispose — ignored.`);
+      y && console.warn(`[mvc-kit] receive("${String(t)}") called after dispose — ignored.`);
       return;
     }
     const e = this._handlers.get(t);
     if (e)
-      for (const i of e)
-        i(s);
+      for (const n of e)
+        n(s);
   }
   /** Call from subclass when the transport connection drops unexpectedly. Triggers reconnection. @protected */
   disconnected() {
@@ -1137,8 +1021,8 @@ class R {
   }
   /** Subscribes to a message type, auto-removing the handler after the first invocation. */
   once(t, s) {
-    const e = this.on(t, (i) => {
-      e(), s(i);
+    const e = this.on(t, (n) => {
+      e(), s(n);
     });
     return e;
   }
@@ -1183,13 +1067,13 @@ class R {
     let e;
     try {
       e = this.open(s);
-    } catch (i) {
-      this._onOpenFailed(t, i);
+    } catch (n) {
+      this._onOpenFailed(t, n);
       return;
     }
     e && typeof e.then == "function" ? e.then(
       () => this._onOpenSucceeded(),
-      (i) => this._onOpenFailed(t, i)
+      (n) => this._onOpenFailed(t, n)
     ) : this._onOpenSucceeded();
   }
   _onOpenSucceeded() {
@@ -1214,33 +1098,35 @@ class R {
       });
       return;
     }
-    const i = s instanceof Error ? s.message : s ? String(s) : null;
+    const n = s instanceof Error ? s.message : s ? String(s) : null;
     this._setStatus({
       connected: !1,
       reconnecting: !0,
       attempt: t,
-      error: i
+      error: n
     });
-    const n = this._calculateDelay(t - 1);
+    const o = this._calculateDelay(t - 1);
     this._reconnectTimer = setTimeout(() => {
       this._reconnectTimer = null, this._attemptConnect(t);
-    }, n);
+    }, o);
   }
 }
 export {
-  R as Channel,
-  D as Collection,
-  I as Controller,
-  w as EventBus,
-  C as HttpError,
-  j as Model,
-  P as Service,
-  m as ViewModel,
-  E as classifyError,
-  N as hasSingleton,
-  y as isAbortError,
-  $ as singleton,
-  L as teardown,
-  B as teardownAll
+  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,
+  S as ViewModel,
+  T as classifyError,
+  B as hasSingleton,
+  O as isAbortError,
+  F as singleton,
+  X as teardown,
+  Y as teardownAll
 };
 //# sourceMappingURL=mvc-kit.js.map