mvc-kit 2.5.3 → 2.5.4

package/dist/Collection.js

@@ -0,0 +1,452 @@
+const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+class Collection {
+  /** 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 = false;
+  _listeners = /* @__PURE__ */ new Set();
+  _index = /* @__PURE__ */ new Map();
+  _abortController = null;
+  _cleanups = null;
+  _timestamps = null;
+  _evictionTimer = null;
+  constructor(initialItems = []) {
+    let result = [...initialItems];
+    if (this._ttl > 0) {
+      this._timestamps = /* @__PURE__ */ new Map();
+      const now = Date.now();
+      for (const item of result) {
+        this._timestamps.set(item.id, now);
+      }
+    }
+    if (this._maxSize > 0 && result.length > this._maxSize) {
+      const excess = result.length - this._maxSize;
+      const evicted = result.slice(0, excess);
+      result = result.slice(excess);
+      for (const item of evicted) {
+        this._timestamps?.delete(item.id);
+      }
+    }
+    this._items = Object.freeze(result);
+    this.rebuildIndex();
+    this._scheduleEvictionTimer();
+  }
+  /**
+   * Alias for Subscribable compatibility.
+   */
+  get state() {
+    return this._items;
+  }
+  /** The raw array of items. */
+  get items() {
+    return this._items;
+  }
+  /** Number of items in the collection. */
+  get length() {
+    return this._items.length;
+  }
+  /** Whether this instance has been disposed. */
+  get disposed() {
+    return this._disposed;
+  }
+  /** AbortSignal that fires when this instance is disposed. Lazily created. */
+  get disposeSignal() {
+    if (!this._abortController) {
+      this._abortController = new AbortController();
+    }
+    return 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(...items) {
+    if (this._disposed) {
+      throw new Error("Cannot add to disposed Collection");
+    }
+    if (items.length === 0) {
+      return;
+    }
+    const seen = /* @__PURE__ */ new Set();
+    const newItems = [];
+    for (const item of items) {
+      if (!this._index.has(item.id) && !seen.has(item.id)) {
+        newItems.push(item);
+        seen.add(item.id);
+      }
+    }
+    if (newItems.length === 0) return;
+    const prev = this._items;
+    let result = [...prev, ...newItems];
+    for (const item of newItems) {
+      this._index.set(item.id, item);
+    }
+    if (this._timestamps) {
+      const now = Date.now();
+      for (const item of newItems) {
+        this._timestamps.set(item.id, now);
+      }
+    }
+    if (this._maxSize > 0 && result.length > this._maxSize) {
+      result = this._evictForCapacity(result);
+    }
+    this._items = Object.freeze(result);
+    this.notify(prev);
+    this._scheduleEvictionTimer();
+  }
+  /**
+   * 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(...items) {
+    if (this._disposed) {
+      throw new Error("Cannot upsert on disposed Collection");
+    }
+    if (items.length === 0) return;
+    const incoming = /* @__PURE__ */ new Map();
+    for (const item of items) {
+      incoming.set(item.id, item);
+    }
+    const prev = this._items;
+    let changed = false;
+    const replaced = /* @__PURE__ */ new Set();
+    const newArray = [];
+    for (const existing of prev) {
+      if (incoming.has(existing.id)) {
+        const replacement = incoming.get(existing.id);
+        if (replacement !== existing) changed = true;
+        newArray.push(replacement);
+        replaced.add(existing.id);
+      } else {
+        newArray.push(existing);
+      }
+    }
+    for (const [id, item] of incoming) {
+      if (!replaced.has(id)) {
+        newArray.push(item);
+        changed = true;
+      }
+    }
+    if (!changed) return;
+    if (this._timestamps) {
+      const now = Date.now();
+      for (const [id] of incoming) {
+        this._timestamps.set(id, now);
+      }
+    }
+    for (const [id, item] of incoming) {
+      this._index.set(id, item);
+    }
+    let result = newArray;
+    if (this._maxSize > 0 && result.length > this._maxSize) {
+      result = this._evictForCapacity(result);
+    }
+    this._items = Object.freeze(result);
+    this.notify(prev);
+    this._scheduleEvictionTimer();
+  }
+  /**
+   * Remove items by id(s).
+   */
+  remove(...ids) {
+    if (this._disposed) {
+      throw new Error("Cannot remove from disposed Collection");
+    }
+    if (ids.length === 0) {
+      return;
+    }
+    const idSet = new Set(ids);
+    const filtered = this._items.filter((item) => !idSet.has(item.id));
+    if (filtered.length === this._items.length) {
+      return;
+    }
+    const prev = this._items;
+    this._items = Object.freeze(filtered);
+    for (const id of ids) {
+      this._index.delete(id);
+      this._timestamps?.delete(id);
+    }
+    this.notify(prev);
+    this._scheduleEvictionTimer();
+  }
+  /**
+   * Update an item by id with partial changes.
+   */
+  update(id, changes) {
+    if (this._disposed) {
+      throw new Error("Cannot update disposed Collection");
+    }
+    const idx = this._items.findIndex((item) => item.id === id);
+    if (idx === -1) {
+      return;
+    }
+    const existing = this._items[idx];
+    const updated = { ...existing, ...changes, id };
+    const keys = Object.keys(changes);
+    const hasChanges = keys.some((key) => changes[key] !== existing[key]);
+    if (!hasChanges) {
+      return;
+    }
+    const prev = this._items;
+    const newItems = [...prev];
+    newItems[idx] = updated;
+    this._items = Object.freeze(newItems);
+    this._index.set(id, updated);
+    this.notify(prev);
+  }
+  /**
+   * Replace all items.
+   */
+  reset(items) {
+    if (this._disposed) {
+      throw new Error("Cannot reset disposed Collection");
+    }
+    const prev = this._items;
+    if (this._timestamps) {
+      this._timestamps.clear();
+      const now = Date.now();
+      for (const item of items) {
+        this._timestamps.set(item.id, now);
+      }
+    }
+    let result = [...items];
+    if (this._maxSize > 0 && result.length > this._maxSize) {
+      result = this._evictForCapacity(result);
+    }
+    this._items = Object.freeze(result);
+    this.rebuildIndex();
+    this.notify(prev);
+    this._scheduleEvictionTimer();
+  }
+  /**
+   * Remove all items.
+   */
+  clear() {
+    if (this._disposed) {
+      throw new Error("Cannot clear disposed Collection");
+    }
+    if (this._items.length === 0) {
+      return;
+    }
+    const prev = this._items;
+    this._items = Object.freeze([]);
+    this._index.clear();
+    this._timestamps?.clear();
+    this._clearEvictionTimer();
+    this.notify(prev);
+  }
+  /**
+   * Snapshot current state, apply callback mutations, and return a rollback function.
+   * Rollback restores items to pre-callback state regardless of later mutations.
+   */
+  optimistic(callback) {
+    if (this._disposed) {
+      throw new Error("Cannot perform optimistic update on disposed Collection");
+    }
+    const snapshot = this._items;
+    const timestampSnapshot = this._timestamps ? new Map(this._timestamps) : null;
+    callback();
+    let rolledBack = false;
+    return () => {
+      if (rolledBack || this._disposed) return;
+      rolledBack = true;
+      const prev = this._items;
+      this._items = snapshot;
+      if (timestampSnapshot) {
+        this._timestamps = timestampSnapshot;
+      }
+      this.rebuildIndex();
+      this.notify(prev);
+      this._scheduleEvictionTimer();
+    };
+  }
+  // ── Query Methods (pure, no notification) ──
+  /**
+   * Get item by id.
+   */
+  get(id) {
+    return this._index.get(id);
+  }
+  /**
+   * Check if item exists by id.
+   */
+  has(id) {
+    return this._index.has(id);
+  }
+  /**
+   * Find first item matching predicate.
+   */
+  find(predicate) {
+    return this._items.find(predicate);
+  }
+  /**
+   * Filter items matching predicate.
+   */
+  filter(predicate) {
+    return this._items.filter(predicate);
+  }
+  /**
+   * Return sorted copy.
+   */
+  sorted(compareFn) {
+    return [...this._items].sort(compareFn);
+  }
+  /**
+   * Map items to new array.
+   */
+  map(fn) {
+    return this._items.map(fn);
+  }
+  // ── Subscribable interface ──
+  /** Subscribes to state changes. Returns an unsubscribe function. */
+  subscribe(listener) {
+    if (this._disposed) {
+      return () => {
+      };
+    }
+    this._listeners.add(listener);
+    return () => {
+      this._listeners.delete(listener);
+    };
+  }
+  /** Tears down the instance, releasing all subscriptions and resources. */
+  dispose() {
+    if (this._disposed) {
+      return;
+    }
+    this._disposed = true;
+    this._clearEvictionTimer();
+    this._abortController?.abort();
+    if (this._cleanups) {
+      for (const fn of this._cleanups) fn();
+      this._cleanups = null;
+    }
+    this.onDispose?.();
+    this._listeners.clear();
+    this._index.clear();
+    this._timestamps?.clear();
+  }
+  /** Registers a cleanup function to be called on dispose. @protected */
+  addCleanup(fn) {
+    if (!this._cleanups) {
+      this._cleanups = [];
+    }
+    this._cleanups.push(fn);
+  }
+  notify(prev) {
+    for (const listener of this._listeners) {
+      listener(this._items, prev);
+    }
+  }
+  rebuildIndex() {
+    this._index.clear();
+    for (const item of this._items) {
+      this._index.set(item.id, item);
+    }
+  }
+  // ── Eviction Internals ──
+  _evictForCapacity(items) {
+    const excess = items.length - this._maxSize;
+    if (excess <= 0) return items;
+    const candidates = items.slice(0, excess);
+    const toEvict = this._applyOnEvict(candidates, "capacity");
+    if (toEvict === false) return items;
+    if (toEvict.length === 0) return items;
+    const evictIds = new Set(toEvict.map((item) => item.id));
+    const result = items.filter((item) => !evictIds.has(item.id));
+    for (const item of toEvict) {
+      this._index.delete(item.id);
+      this._timestamps?.delete(item.id);
+    }
+    return result;
+  }
+  _applyOnEvict(candidates, reason) {
+    if (!this.onEvict) return candidates;
+    const result = this.onEvict(candidates, reason);
+    if (result === false) {
+      if (__DEV__ && reason === "capacity" && this._maxSize > 0) {
+        const currentSize = this._items.length + candidates.length;
+        if (currentSize > this._maxSize * 2) {
+          console.warn(
+            `[mvc-kit] Collection exceeded 2x MAX_SIZE (${currentSize}/${this._maxSize}). onEvict is vetoing eviction — this may cause unbounded growth.`
+          );
+        }
+      }
+      return false;
+    }
+    if (Array.isArray(result)) {
+      const candidateIds = new Set(candidates.map((c) => c.id));
+      return result.filter((item) => candidateIds.has(item.id));
+    }
+    return candidates;
+  }
+  _sweepExpired() {
+    if (this._disposed || !this._timestamps || this._ttl <= 0) return;
+    const now = Date.now();
+    const ttl = this._ttl;
+    const expired = [];
+    for (const item of this._items) {
+      const ts = this._timestamps.get(item.id);
+      if (ts !== void 0 && now - ts >= ttl) {
+        expired.push(item);
+      }
+    }
+    if (expired.length === 0) {
+      this._scheduleEvictionTimer();
+      return;
+    }
+    const toEvict = this._applyOnEvict(expired, "ttl");
+    if (toEvict === false) {
+      this._scheduleEvictionTimer();
+      return;
+    }
+    if (toEvict.length === 0) {
+      this._scheduleEvictionTimer();
+      return;
+    }
+    const evictIds = new Set(toEvict.map((item) => item.id));
+    const prev = this._items;
+    this._items = Object.freeze(
+      prev.filter((item) => !evictIds.has(item.id))
+    );
+    for (const item of toEvict) {
+      this._index.delete(item.id);
+      this._timestamps.delete(item.id);
+    }
+    this.notify(prev);
+    this._scheduleEvictionTimer();
+  }
+  _scheduleEvictionTimer() {
+    this._clearEvictionTimer();
+    if (this._disposed || !this._timestamps || this._ttl <= 0 || this._timestamps.size === 0) return;
+    const now = Date.now();
+    const ttl = this._ttl;
+    let earliest = Infinity;
+    for (const ts of this._timestamps.values()) {
+      if (ts < earliest) earliest = ts;
+    }
+    const delay = Math.max(0, earliest + ttl - now);
+    this._evictionTimer = setTimeout(() => this._sweepExpired(), delay);
+  }
+  _clearEvictionTimer() {
+    if (this._evictionTimer !== null) {
+      clearTimeout(this._evictionTimer);
+      this._evictionTimer = null;
+    }
+  }
+}
+export {
+  Collection
+};
+//# sourceMappingURL=Collection.js.map

package/dist/Collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Collection.js","sources":["../src/Collection.ts"],"sourcesContent":["import type { Listener, Subscribable } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\ntype CollectionState<T> = T[];\ntype CollectionListener<T> = Listener<CollectionState<T>>;\n\n/**\n * Reactive typed array with CRUD and query methods.\n */\nexport class Collection<T extends { id: string | number }> implements Subscribable<CollectionState<T>> {\n  /** Maximum number of items before FIFO eviction. 0 = unlimited. */\n  static MAX_SIZE = 0;\n  /** Time-to-live in milliseconds. 0 = no expiry. */\n  static TTL = 0;\n\n  private _items: readonly T[] = [];\n  private _disposed = false;\n  private _listeners = new Set<CollectionListener<T>>();\n  private _index = new Map<T['id'], T>();\n  private _abortController: AbortController | null = null;\n  private _cleanups: (() => void)[] | null = null;\n  private _timestamps: Map<T['id'], number> | null = null;\n  private _evictionTimer: ReturnType<typeof setTimeout> | null = null;\n\n  constructor(initialItems: T[] = []) {\n    let result = [...initialItems];\n\n    if (this._ttl > 0) {\n      this._timestamps = new Map();\n      const now = Date.now();\n      for (const item of result) {\n        this._timestamps.set(item.id, now);\n      }\n    }\n\n    if (this._maxSize > 0 && result.length > this._maxSize) {\n      // FIFO: trim from the front (oldest items)\n      const excess = result.length - this._maxSize;\n      const evicted = result.slice(0, excess);\n      result = result.slice(excess);\n      for (const item of evicted) {\n        this._timestamps?.delete(item.id);\n      }\n    }\n\n    this._items = Object.freeze(result);\n    this.rebuildIndex();\n    this._scheduleEvictionTimer();\n  }\n\n  /**\n   * Alias for Subscribable compatibility.\n   */\n  get state(): T[] {\n    return this._items as T[];\n  }\n\n  /** The raw array of items. */\n  get items(): T[] {\n    return this._items as T[];\n  }\n\n  /** Number of items in the collection. */\n  get length(): number {\n    return this._items.length;\n  }\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\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  // ── Config Accessors ──\n\n  private get _maxSize(): number {\n    return (this.constructor as typeof Collection).MAX_SIZE;\n  }\n\n  private get _ttl(): number {\n    return (this.constructor as typeof Collection).TTL;\n  }\n\n  // ── CRUD Methods (notify listeners) ──\n\n  /**\n   * Add one or more items. Items with existing IDs are silently skipped.\n   */\n  add(...items: T[]): void {\n    if (this._disposed) {\n      throw new Error('Cannot add to disposed Collection');\n    }\n\n    if (items.length === 0) {\n      return;\n    }\n\n    const seen = new Set<T['id']>();\n    const newItems: T[] = [];\n    for (const item of items) {\n      if (!this._index.has(item.id) && !seen.has(item.id)) {\n        newItems.push(item);\n        seen.add(item.id);\n      }\n    }\n    if (newItems.length === 0) return;\n\n    const prev = this._items;\n    let result = [...prev, ...newItems];\n\n    for (const item of newItems) {\n      this._index.set(item.id, item);\n    }\n\n    // Record timestamps for TTL\n    if (this._timestamps) {\n      const now = Date.now();\n      for (const item of newItems) {\n        this._timestamps.set(item.id, now);\n      }\n    }\n\n    // Enforce capacity before freeze/notify\n    if (this._maxSize > 0 && result.length > this._maxSize) {\n      result = this._evictForCapacity(result);\n    }\n\n    this._items = Object.freeze(result);\n    this.notify(prev);\n    this._scheduleEvictionTimer();\n  }\n\n  /**\n   * Add or replace items by ID. Existing items are replaced in-place\n   * (preserving array position); new items are appended. Deduplicates\n   * input — last occurrence wins. No-op if nothing changed (reference\n   * comparison).\n   */\n  upsert(...items: T[]): void {\n    if (this._disposed) {\n      throw new Error('Cannot upsert on disposed Collection');\n    }\n    if (items.length === 0) return;\n\n    // Deduplicate input — last occurrence wins\n    const incoming = new Map<T['id'], T>();\n    for (const item of items) {\n      incoming.set(item.id, item);\n    }\n\n    const prev = this._items;\n    let changed = false;\n    const replaced = new Set<T['id']>();\n    const newArray: T[] = [];\n\n    // Replace existing items in-place\n    for (const existing of prev) {\n      if (incoming.has(existing.id)) {\n        const replacement = incoming.get(existing.id)!;\n        if (replacement !== existing) changed = true;\n        newArray.push(replacement);\n        replaced.add(existing.id);\n      } else {\n        newArray.push(existing);\n      }\n    }\n\n    // Append genuinely new items\n    for (const [id, item] of incoming) {\n      if (!replaced.has(id)) {\n        newArray.push(item);\n        changed = true;\n      }\n    }\n\n    if (!changed) return;\n\n    // Record/refresh timestamps for TTL (upsert refreshes existing)\n    if (this._timestamps) {\n      const now = Date.now();\n      for (const [id] of incoming) {\n        this._timestamps.set(id, now);\n      }\n    }\n\n    for (const [id, item] of incoming) {\n      this._index.set(id, item);\n    }\n\n    // Enforce capacity before freeze/notify\n    let result = newArray;\n    if (this._maxSize > 0 && result.length > this._maxSize) {\n      result = this._evictForCapacity(result);\n    }\n\n    this._items = Object.freeze(result);\n    this.notify(prev);\n    this._scheduleEvictionTimer();\n  }\n\n  /**\n   * Remove items by id(s).\n   */\n  remove(...ids: T['id'][]): void {\n    if (this._disposed) {\n      throw new Error('Cannot remove from disposed Collection');\n    }\n\n    if (ids.length === 0) {\n      return;\n    }\n\n    const idSet = new Set(ids);\n    const filtered = this._items.filter(item => !idSet.has(item.id));\n\n    if (filtered.length === this._items.length) {\n      return; // No items removed\n    }\n\n    const prev = this._items;\n    this._items = Object.freeze(filtered);\n\n    for (const id of ids) {\n      this._index.delete(id);\n      this._timestamps?.delete(id);\n    }\n\n    this.notify(prev);\n    this._scheduleEvictionTimer();\n  }\n\n  /**\n   * Update an item by id with partial changes.\n   */\n  update(id: T['id'], changes: Partial<T>): void {\n    if (this._disposed) {\n      throw new Error('Cannot update disposed Collection');\n    }\n\n    const idx = this._items.findIndex(item => item.id === id);\n    if (idx === -1) {\n      return;\n    }\n\n    const existing = this._items[idx];\n    const updated = { ...existing, ...changes, id }; // Ensure id is preserved\n\n    // Check if anything actually changed\n    const keys = Object.keys(changes) as (keyof T)[];\n    const hasChanges = keys.some(key => changes[key] !== existing[key]);\n    if (!hasChanges) {\n      return;\n    }\n\n    const prev = this._items;\n    const newItems = [...prev];\n    newItems[idx] = updated;\n    this._items = Object.freeze(newItems);\n    this._index.set(id, updated);\n\n    this.notify(prev);\n  }\n\n  /**\n   * Replace all items.\n   */\n  reset(items: T[]): void {\n    if (this._disposed) {\n      throw new Error('Cannot reset disposed Collection');\n    }\n\n    const prev = this._items;\n\n    // Record timestamps for TTL\n    if (this._timestamps) {\n      this._timestamps.clear();\n      const now = Date.now();\n      for (const item of items) {\n        this._timestamps.set(item.id, now);\n      }\n    }\n\n    let result = [...items];\n\n    // Enforce capacity before freeze/notify\n    if (this._maxSize > 0 && result.length > this._maxSize) {\n      result = this._evictForCapacity(result);\n    }\n\n    this._items = Object.freeze(result);\n    this.rebuildIndex();\n\n    this.notify(prev);\n    this._scheduleEvictionTimer();\n  }\n\n  /**\n   * Remove all items.\n   */\n  clear(): void {\n    if (this._disposed) {\n      throw new Error('Cannot clear disposed Collection');\n    }\n\n    if (this._items.length === 0) {\n      return;\n    }\n\n    const prev = this._items;\n    this._items = Object.freeze([]);\n    this._index.clear();\n    this._timestamps?.clear();\n    this._clearEvictionTimer();\n\n    this.notify(prev);\n  }\n\n  /**\n   * Snapshot current state, apply callback mutations, and return a rollback function.\n   * Rollback restores items to pre-callback state regardless of later mutations.\n   */\n  optimistic(callback: () => void): () => void {\n    if (this._disposed) {\n      throw new Error('Cannot perform optimistic update on disposed Collection');\n    }\n\n    const snapshot = this._items;\n    const timestampSnapshot = this._timestamps ? new Map(this._timestamps) : null;\n    callback();\n\n    let rolledBack = false;\n    return () => {\n      if (rolledBack || this._disposed) return;\n      rolledBack = true;\n\n      const prev = this._items;\n      this._items = snapshot;\n      if (timestampSnapshot) {\n        this._timestamps = timestampSnapshot;\n      }\n      this.rebuildIndex();\n      this.notify(prev);\n      this._scheduleEvictionTimer();\n    };\n  }\n\n  // ── Query Methods (pure, no notification) ──\n\n  /**\n   * Get item by id.\n   */\n  get(id: T['id']): T | undefined {\n    return this._index.get(id);\n  }\n\n  /**\n   * Check if item exists by id.\n   */\n  has(id: T['id']): boolean {\n    return this._index.has(id);\n  }\n\n  /**\n   * Find first item matching predicate.\n   */\n  find(predicate: (item: T) => boolean): T | undefined {\n    return this._items.find(predicate);\n  }\n\n  /**\n   * Filter items matching predicate.\n   */\n  filter(predicate: (item: T) => boolean): T[] {\n    return this._items.filter(predicate) as T[];\n  }\n\n  /**\n   * Return sorted copy.\n   */\n  sorted(compareFn: (a: T, b: T) => number): T[] {\n    return [...this._items].sort(compareFn);\n  }\n\n  /**\n   * Map items to new array.\n   */\n  map<U>(fn: (item: T) => U): U[] {\n    return this._items.map(fn);\n  }\n\n  // ── Subscribable interface ──\n\n  /** Subscribes to state changes. Returns an unsubscribe function. */\n  subscribe(listener: CollectionListener<T>): () => 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._clearEvictionTimer();\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    this._index.clear();\n    this._timestamps?.clear();\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  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n\n  /**\n   * Called before items are auto-evicted by capacity or TTL.\n   * Override to filter which items get evicted, or veto entirely.\n   *\n   * @param items - Candidates for eviction\n   * @param reason - Why eviction is happening\n   * @returns void to proceed with all, false to veto, or T[] subset to evict only those\n   */\n  protected onEvict?(items: T[], reason: 'capacity' | 'ttl'): T[] | false | void;\n\n  private notify(prev: readonly T[]): void {\n    for (const listener of this._listeners) {\n      listener(this._items as T[], prev as T[]);\n    }\n  }\n\n  private rebuildIndex(): void {\n    this._index.clear();\n    for (const item of this._items) {\n      this._index.set(item.id, item);\n    }\n  }\n\n  // ── Eviction Internals ──\n\n  private _evictForCapacity(items: T[]): T[] {\n    const excess = items.length - this._maxSize;\n    if (excess <= 0) return items;\n\n    const candidates = items.slice(0, excess);\n    const toEvict = this._applyOnEvict(candidates, 'capacity');\n\n    if (toEvict === false) return items; // veto\n\n    if (toEvict.length === 0) return items; // nothing to evict\n\n    const evictIds = new Set(toEvict.map(item => item.id));\n    const result = items.filter(item => !evictIds.has(item.id));\n\n    // Clean up index and timestamps for evicted items\n    for (const item of toEvict) {\n      this._index.delete(item.id);\n      this._timestamps?.delete(item.id);\n    }\n\n    return result;\n  }\n\n  private _applyOnEvict(candidates: T[], reason: 'capacity' | 'ttl'): T[] | false {\n    if (!this.onEvict) return candidates;\n\n    const result = this.onEvict(candidates, reason);\n    if (result === false) {\n      // DEV warning when veto causes collection to exceed 2x MAX_SIZE\n      if (__DEV__ && reason === 'capacity' && this._maxSize > 0) {\n        const currentSize = this._items.length + candidates.length;\n        if (currentSize > this._maxSize * 2) {\n          console.warn(\n            `[mvc-kit] Collection exceeded 2x MAX_SIZE (${currentSize}/${this._maxSize}). ` +\n            `onEvict is vetoing eviction — this may cause unbounded growth.`\n          );\n        }\n      }\n      return false;\n    }\n    if (Array.isArray(result)) {\n      // Only include items that are actually in the current items\n      const candidateIds = new Set(candidates.map(c => c.id));\n      return result.filter(item => candidateIds.has(item.id));\n    }\n    return candidates; // void = proceed with all\n  }\n\n  private _sweepExpired(): void {\n    if (this._disposed || !this._timestamps || this._ttl <= 0) return;\n\n    const now = Date.now();\n    const ttl = this._ttl;\n    const expired: T[] = [];\n\n    for (const item of this._items) {\n      const ts = this._timestamps.get(item.id);\n      if (ts !== undefined && (now - ts) >= ttl) {\n        expired.push(item);\n      }\n    }\n\n    if (expired.length === 0) {\n      this._scheduleEvictionTimer();\n      return;\n    }\n\n    const toEvict = this._applyOnEvict(expired, 'ttl');\n\n    if (toEvict === false) {\n      this._scheduleEvictionTimer();\n      return;\n    }\n\n    if (toEvict.length === 0) {\n      this._scheduleEvictionTimer();\n      return;\n    }\n\n    const evictIds = new Set(toEvict.map(item => item.id));\n    const prev = this._items;\n    this._items = Object.freeze(\n      (prev as T[]).filter((item: T) => !evictIds.has(item.id))\n    );\n\n    for (const item of toEvict) {\n      this._index.delete(item.id);\n      this._timestamps.delete(item.id);\n    }\n\n    this.notify(prev);\n    this._scheduleEvictionTimer();\n  }\n\n  private _scheduleEvictionTimer(): void {\n    this._clearEvictionTimer();\n\n    if (this._disposed || !this._timestamps || this._ttl <= 0 || this._timestamps.size === 0) return;\n\n    const now = Date.now();\n    const ttl = this._ttl;\n    let earliest = Infinity;\n\n    for (const ts of this._timestamps.values()) {\n      if (ts < earliest) earliest = ts;\n    }\n\n    const delay = Math.max(0, (earliest + ttl) - now);\n    this._evictionTimer = setTimeout(() => this._sweepExpired(), delay);\n  }\n\n  private _clearEvictionTimer(): void {\n    if (this._evictionTimer !== null) {\n      clearTimeout(this._evictionTimer);\n      this._evictionTimer = null;\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/Controller.cjs

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+class Controller {
+  _disposed = false;
+  _initialized = false;
+  _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() {
+    if (!this._abortController) {
+      this._abortController = new AbortController();
+    }
+    return this._abortController.signal;
+  }
+  /** Initializes the instance. Called automatically by React hooks after mount. */
+  init() {
+    if (this._initialized || this._disposed) return;
+    this._initialized = true;
+    return this.onInit?.();
+  }
+  /** Tears down the instance, releasing all subscriptions and resources. */
+  dispose() {
+    if (this._disposed) {
+      return;
+    }
+    this._disposed = true;
+    this._abortController?.abort();
+    if (this._cleanups) {
+      for (const fn of this._cleanups) fn();
+      this._cleanups = null;
+    }
+    this.onDispose?.();
+  }
+  /** Registers a cleanup function to be called on dispose. @protected */
+  addCleanup(fn) {
+    if (!this._cleanups) {
+      this._cleanups = [];
+    }
+    this._cleanups.push(fn);
+  }
+  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
+  subscribeTo(source, listener) {
+    const unsubscribe = source.subscribe(listener);
+    this.addCleanup(unsubscribe);
+    return unsubscribe;
+  }
+}
+exports.Controller = Controller;
+//# sourceMappingURL=Controller.cjs.map

package/dist/Controller.cjs.map

@@ -0,0 +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;;"}

package/dist/Controller.js

@@ -0,0 +1,57 @@
+class Controller {
+  _disposed = false;
+  _initialized = false;
+  _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() {
+    if (!this._abortController) {
+      this._abortController = new AbortController();
+    }
+    return this._abortController.signal;
+  }
+  /** Initializes the instance. Called automatically by React hooks after mount. */
+  init() {
+    if (this._initialized || this._disposed) return;
+    this._initialized = true;
+    return this.onInit?.();
+  }
+  /** Tears down the instance, releasing all subscriptions and resources. */
+  dispose() {
+    if (this._disposed) {
+      return;
+    }
+    this._disposed = true;
+    this._abortController?.abort();
+    if (this._cleanups) {
+      for (const fn of this._cleanups) fn();
+      this._cleanups = null;
+    }
+    this.onDispose?.();
+  }
+  /** Registers a cleanup function to be called on dispose. @protected */
+  addCleanup(fn) {
+    if (!this._cleanups) {
+      this._cleanups = [];
+    }
+    this._cleanups.push(fn);
+  }
+  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
+  subscribeTo(source, listener) {
+    const unsubscribe = source.subscribe(listener);
+    this.addCleanup(unsubscribe);
+    return unsubscribe;
+  }
+}
+export {
+  Controller
+};
+//# sourceMappingURL=Controller.js.map

package/dist/Controller.js.map

@@ -0,0 +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;"}