mvc-kit 2.12.5 → 2.13.0

package/dist/Collection.cjs

@@ -1,507 +1,427 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const bindPublicMethods = require("./bindPublicMethods.cjs");
-const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
-const PROTECTED_KEYS = /* @__PURE__ */ new Set(["addCleanup"]);
+const require_bindPublicMethods = require("./bindPublicMethods.cjs");
+//#region src/Collection.ts
+var __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+var PROTECTED_KEYS = new Set(["addCleanup"]);
 function freeze(obj) {
-  return __DEV__ ? Object.freeze(obj) : obj;
-}
-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 = freeze(result);
-    this._rebuildIndex();
-    this._scheduleEvictionTimer();
-    bindPublicMethods.bindPublicMethods(this, Object.prototype, PROTECTED_KEYS);
-  }
-  /**
-   * 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;
-    }
-    if (items.length === 1) {
-      const item = items[0];
-      if (this._index.has(item.id)) return;
-      const prev2 = this._items;
-      let result2 = [...prev2, item];
-      this._index.set(item.id, item);
-      if (this._timestamps) this._timestamps.set(item.id, Date.now());
-      if (this._maxSize > 0 && result2.length > this._maxSize) {
-        result2 = this._evictForCapacity(result2);
-      }
-      this._items = freeze(result2);
-      this._notify(prev2);
-      this._scheduleEvictionTimer();
-      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 = 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;
-    if (items.length === 1) {
-      const item = items[0];
-      const existing = this._index.get(item.id);
-      if (existing) {
-        if (existing === item) return;
-        const prev2 = this._items;
-        const idx = this._items.indexOf(existing);
-        const newItems = [...prev2];
-        newItems[idx] = item;
-        this._index.set(item.id, item);
-        if (this._timestamps) this._timestamps.set(item.id, Date.now());
-        this._items = freeze(newItems);
-        this._notify(prev2);
-      } else {
-        const prev2 = this._items;
-        let result2 = [...prev2, item];
-        this._index.set(item.id, item);
-        if (this._timestamps) this._timestamps.set(item.id, Date.now());
-        if (this._maxSize > 0 && result2.length > this._maxSize) {
-          result2 = this._evictForCapacity(result2);
-        }
-        this._items = freeze(result2);
-        this._notify(prev2);
-        this._scheduleEvictionTimer();
-      }
-      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 = 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;
-    }
-    if (ids.length === 1) {
-      const id = ids[0];
-      if (!this._index.has(id)) return;
-      const prev2 = this._items;
-      this._items = freeze(prev2.filter((item) => item.id !== id));
-      this._index.delete(id);
-      this._timestamps?.delete(id);
-      this._notify(prev2);
-      this._scheduleEvictionTimer();
-      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 = 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 existing = this._index.get(id);
-    if (!existing) return;
-    const keys = Object.keys(changes);
-    const hasChanges = keys.some((key) => changes[key] !== existing[key]);
-    if (!hasChanges) return;
-    const updated = { ...existing, ...changes, id };
-    const prev = this._items;
-    const idx = this._items.indexOf(existing);
-    const newItems = [...prev];
-    newItems[idx] = updated;
-    this._items = 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 = 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 = 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 = 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;
-    }
-  }
+	return __DEV__ ? Object.freeze(obj) : obj;
 }
+/**
+* Reactive typed array with CRUD and query methods.
+*/
+var Collection = class {
+	/** 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 = freeze(result);
+		this._rebuildIndex();
+		this._scheduleEvictionTimer();
+		require_bindPublicMethods.bindPublicMethods(this, Object.prototype, PROTECTED_KEYS);
+	}
+	/**
+	* 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;
+	}
+	get _maxSize() {
+		return this.constructor.MAX_SIZE;
+	}
+	get _ttl() {
+		return this.constructor.TTL;
+	}
+	/**
+	* 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;
+		if (items.length === 1) {
+			const item = items[0];
+			if (this._index.has(item.id)) return;
+			const prev = this._items;
+			let result = [...prev, item];
+			this._index.set(item.id, item);
+			if (this._timestamps) this._timestamps.set(item.id, Date.now());
+			if (this._maxSize > 0 && result.length > this._maxSize) result = this._evictForCapacity(result);
+			this._items = freeze(result);
+			this._notify(prev);
+			this._scheduleEvictionTimer();
+			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 = 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;
+		if (items.length === 1) {
+			const item = items[0];
+			const existing = this._index.get(item.id);
+			if (existing) {
+				if (existing === item) return;
+				const prev = this._items;
+				const idx = this._items.indexOf(existing);
+				const newItems = [...prev];
+				newItems[idx] = item;
+				this._index.set(item.id, item);
+				if (this._timestamps) this._timestamps.set(item.id, Date.now());
+				this._items = freeze(newItems);
+				this._notify(prev);
+			} else {
+				const prev = this._items;
+				let result = [...prev, item];
+				this._index.set(item.id, item);
+				if (this._timestamps) this._timestamps.set(item.id, Date.now());
+				if (this._maxSize > 0 && result.length > this._maxSize) result = this._evictForCapacity(result);
+				this._items = freeze(result);
+				this._notify(prev);
+				this._scheduleEvictionTimer();
+			}
+			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 = 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;
+		if (ids.length === 1) {
+			const id = ids[0];
+			if (!this._index.has(id)) return;
+			const prev = this._items;
+			this._items = freeze(prev.filter((item) => item.id !== id));
+			this._index.delete(id);
+			this._timestamps?.delete(id);
+			this._notify(prev);
+			this._scheduleEvictionTimer();
+			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 = 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 existing = this._index.get(id);
+		if (!existing) return;
+		if (!Object.keys(changes).some((key) => changes[key] !== existing[key])) return;
+		const updated = {
+			...existing,
+			...changes,
+			id
+		};
+		const prev = this._items;
+		const idx = this._items.indexOf(existing);
+		const newItems = [...prev];
+		newItems[idx] = updated;
+		this._items = 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 = 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 = 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();
+		};
+	}
+	/**
+	* 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);
+	}
+	/** 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);
+	}
+	_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 = 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;
+		}
+	}
+};
+//#endregion
 exports.Collection = Collection;
-//# sourceMappingURL=Collection.cjs.map
+
+//# sourceMappingURL=Collection.cjs.map