mvc-kit 2.5.2 → 2.5.3

package/README.md

@@ -150,7 +150,7 @@ class RecentMessages extends Collection<Message> {
 }
 
 // Properties
-todos.items;              // readonly T[] (same as state)
+todos.items;              // T[] (same as state)
 todos.length;             // number of items
 
 // Query (pure, no notifications)
@@ -225,7 +225,7 @@ users.async.loadAll.error;     // error message, or null
 users.async.loadAll.errorCode; // 'not_found', 'network', etc.
 
 // Inherits all Collection methods
-users.items;       // readonly User[]
+users.items;       // User[]
 users.get(1);      // User | undefined
 users.filter(u => u.active);
 ```
@@ -754,8 +754,8 @@ function App() {
 | `Subscribable<S>` | Has `state`, `subscribe()`, `dispose()`, `disposeSignal` |
 | `Disposable` | Has `disposed`, `disposeSignal`, `dispose()` |
 | `Initializable` | Has `initialized`, `init()` |
-| `Listener<S>` | `(state: Readonly<S>, prev: Readonly<S>) => void` |
-| `Updater<S>` | `(state: Readonly<S>) => Partial<S>` |
+| `Listener<S>` | `(state: S, prev: S) => void` |
+| `Updater<S>` | `(prev: S) => Partial<S>` |
 | `ValidationErrors<S>` | `Partial<Record<keyof S, string>>` |
 | `TaskState` | `{ loading: boolean; error: string \| null }` |
 | `AsyncMethodKeys<T>` | Union of method names on `T` that return `Promise` (ViewModel) |

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

@@ -32,9 +32,9 @@ new MyViewModel(initialState: S)
 ```
 
 ### State
-- `state: Readonly<S>` — Current frozen state. Read `state.x` for raw values.
+- `state: S` — Current frozen state. Read `state.x` for raw values.
 - `set(partial: Partial<S>)` — Merge partial state. Skips if no values change.
-- `set(updater: (prev: Readonly<S>) => Partial<S>)` — Functional update.
+- `set(updater: (prev: S) => Partial<S>)` — Functional update.
 - `reset(newState?: S)` — Tear down lifecycle, re-initialize. Clears async tracking, re-runs `onInit()`.
 
 ### Computed Getters
@@ -62,7 +62,7 @@ class MyVM extends ViewModel<State, { saved: { id: string }; error: void }> {
 
 ### Lifecycle Hooks
 - `onInit(): void | Promise<void>` — Called once after `init()`. Data loading, subscriptions.
-- `onSet(prev: Readonly<S>, next: Readonly<S>): void` — Called after every state change.
+- `onSet(prev: S, next: S): void` — Called after every state change.
 - `onDispose(): void` — Called during `dispose()`, after cleanup callbacks.
 
 ### Cleanup
@@ -87,7 +87,7 @@ new MyModel(initialState: S)
 ```
 
 ### State & Validation
-- `state: Readonly<S>` — Current state.
+- `state: S` — Current state.
 - `set(partial: Partial<S>)` — Update state, re-validates.
 - `errors: ValidationErrors<S>` — `Partial<Record<keyof S, string>>`.
 - `valid: boolean` — True when `errors` is empty.
@@ -122,7 +122,7 @@ Reactive typed array with CRUD and query methods. Items must have an `id: string
 - `clear(): void`
 
 ### Query (pure, no notifications)
-- `items: readonly T[]` — Same as `state`.
+- `items: T[]` — Same as `state`.
 - `length: number`
 - `get(id: string): T | undefined` — O(1) via internal index.
 - `has(id: string): boolean`
@@ -158,12 +158,12 @@ Abstract base for Collections that persist to external storage. Extends Collecti
 - `static WRITE_DELAY = 100` — Debounce ms for storage writes. `0` = immediate.
 
 ### Public API
-- `hydrate(): Promise<readonly T[]>` — Load from storage, idempotent. Returns items.
+- `hydrate(): Promise<T[]>` — Load from storage, idempotent. Returns items.
 - `hydrated: boolean` — Whether storage data has been loaded.
 - `clearStorage(): void | Promise<void>` — Remove from storage AND clear in-memory.
 
 ### Serialization Hooks (overridable)
-- `serialize(items: readonly T[]): string` — Default: `JSON.stringify`.
+- `serialize(items: T[]): string` — Default: `JSON.stringify`.
 - `deserialize(raw: string): T[]` — Default: `JSON.parse`.
 
 ### Error Hook
@@ -370,11 +370,11 @@ useTeardown(UserViewModel, CartViewModel);
 ## Interfaces
 
 ```typescript
-interface Subscribable<S> { state: Readonly<S>; subscribe(listener: Listener<S>): () => void; dispose(): void; disposeSignal: AbortSignal; }
+interface Subscribable<S> { state: S; subscribe(listener: Listener<S>): () => void; dispose(): void; disposeSignal: AbortSignal; }
 interface Disposable { disposed: boolean; disposeSignal: AbortSignal; dispose(): void; }
 interface Initializable { initialized: boolean; init(): void; }
-type Listener<S> = (state: Readonly<S>, prev: Readonly<S>) => void;
-type Updater<S> = (state: Readonly<S>) => Partial<S>;
+type Listener<S> = (state: S, prev: S) => void;
+type Updater<S> = (prev: S) => Partial<S>;
 type ValidationErrors<S> = Partial<Record<keyof S, string>>;
 interface TaskState { readonly loading: boolean; readonly error: string | null; readonly errorCode: string | null; }
 ```

package/dist/Channel.d.ts

@@ -31,7 +31,7 @@ export declare abstract class Channel<M extends Record<string, any>> implements
     private _reconnectTimer;
     private _cleanups;
     /** Current connection status. */
-    get state(): Readonly<ChannelStatus>;
+    get state(): ChannelStatus;
     /** Subscribes to connection status changes. Returns an unsubscribe function. */
     subscribe(listener: Listener<ChannelStatus>): () => void;
     /** Whether this instance has been disposed. */

package/dist/Channel.d.ts.map

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

package/dist/Collection.d.ts

@@ -1,5 +1,5 @@
 import type { Listener, Subscribable } from './types';
-type CollectionState<T> = readonly T[];
+type CollectionState<T> = T[];
 type CollectionListener<T> = Listener<CollectionState<T>>;
 /**
  * Reactive typed array with CRUD and query methods.
@@ -23,9 +23,9 @@ export declare class Collection<T extends {
     /**
      * Alias for Subscribable compatibility.
      */
-    get state(): readonly T[];
-    /** The raw readonly array of items. */
-    get items(): readonly T[];
+    get state(): T[];
+    /** The raw array of items. */
+    get items(): T[];
     /** Number of items in the collection. */
     get length(): number;
     /** Whether this instance has been disposed. */
@@ -81,15 +81,15 @@ export declare class Collection<T extends {
     /**
      * Filter items matching predicate.
      */
-    filter(predicate: (item: T) => boolean): readonly T[];
+    filter(predicate: (item: T) => boolean): T[];
     /**
      * Return sorted copy.
      */
-    sorted(compareFn: (a: T, b: T) => number): readonly T[];
+    sorted(compareFn: (a: T, b: T) => number): T[];
     /**
      * Map items to new array.
      */
-    map<U>(fn: (item: T) => U): readonly U[];
+    map<U>(fn: (item: T) => U): U[];
     /** Subscribes to state changes. Returns an unsubscribe function. */
     subscribe(listener: CollectionListener<T>): () => void;
     /** Tears down the instance, releasing all subscriptions and resources. */

package/dist/Collection.d.ts.map

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

package/dist/Model.d.ts

@@ -12,11 +12,11 @@ export declare abstract class Model<S extends object> implements Subscribable<S>
     private _cleanups;
     constructor(initialState: S);
     /** Current frozen state object. */
-    get state(): Readonly<S>;
+    get state(): S;
     /**
      * The baseline state for dirty tracking.
      */
-    get committed(): Readonly<S>;
+    get committed(): S;
     /**
      * True if current state differs from committed state.
      */
@@ -58,13 +58,13 @@ export declare abstract class Model<S extends object> implements Subscribable<S>
      * Override to provide validation logic.
      * Return an object mapping field keys to error messages.
      */
-    protected validate(_state: Readonly<S>): ValidationErrors<S>;
+    protected validate(_state: S): ValidationErrors<S>;
     /** Registers a cleanup function to be called on dispose. @protected */
     protected addCleanup(fn: () => void): void;
     /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
     protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void;
     /** Lifecycle hook called after every set() with the previous state. @protected */
-    protected onSet?(prev: Readonly<S>, next: Readonly<S>): void;
+    protected onSet?(prev: S, next: S): void;
     /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */
     protected onInit?(): void | Promise<void>;
     /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */

package/dist/Model.d.ts.map

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

package/dist/PersistentCollection-B8kNECDj.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"PersistentCollection-B8kNECDj.cjs","sources":["../src/Collection.ts","../src/PersistentCollection.ts"],"sourcesContent":["import type { Listener, Subscribable } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\ntype CollectionState<T> = readonly 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(): readonly T[] {\n    return this._items;\n  }\n\n  /** The raw readonly array of items. */\n  get items(): readonly T[] {\n    return this._items;\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): readonly T[] {\n    return this._items.filter(predicate);\n  }\n\n  /**\n   * Return sorted copy.\n   */\n  sorted(compareFn: (a: T, b: T) => number): readonly T[] {\n    return [...this._items].sort(compareFn);\n  }\n\n  /**\n   * Map items to new array.\n   */\n  map<U>(fn: (item: T) => U): readonly 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, prev);\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","import { Collection } from './Collection';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// Track storageKey uniqueness in DEV\nconst _registeredKeys: Map<string, string> | null = __DEV__ ? new Map() : null;\n\n/**\n * Abstract base for Collections that persist to external storage.\n * Tracks deltas per mutation and flushes via debounced writes.\n * Subclasses implement the storage-specific `persist*` methods.\n */\nexport abstract class PersistentCollection<\n  T extends { id: string | number },\n> extends Collection<T> {\n  /** Debounce delay in ms for storage writes. 0 = immediate. */\n  static WRITE_DELAY = 100;\n\n  /** Unique key identifying this collection in storage. */\n  protected abstract readonly storageKey: string;\n\n  // ── Abstract persistence methods ──\n\n  protected abstract persistGet(id: T['id']): T | null | Promise<T | null>;\n  protected abstract persistGetAll(): T[] | Promise<T[]>;\n  /** Upsert semantics — insert or replace the given items. */\n  protected abstract persistSet(items: T[]): void | Promise<void>;\n  protected abstract persistRemove(ids: T['id'][]): void | Promise<void>;\n  protected abstract persistClear(): void | Promise<void>;\n\n  // ── Serialization hooks ──\n\n  /** Serialize items to a string. Used by string-based adapters (WebStorage, NativeCollection). */\n  protected serialize(items: readonly T[]): string {\n    return JSON.stringify(items);\n  }\n\n  /** Deserialize a string back to items. Used by string-based adapters. */\n  protected deserialize(raw: string): T[] {\n    return JSON.parse(raw);\n  }\n\n  // ── Error hook ──\n\n  /** Called when a storage operation fails. Override for custom error handling. */\n  protected onPersistError?(error: unknown): void;\n\n  // ── Internal state ──\n\n  private _hydrated = false;\n  private _hydrating = false;\n  private _persistenceReady = false;\n  private _preHydrationWarned = false;\n  private _pendingWrites = new Map<T['id'], T>();\n  private _pendingRemoves = new Set<T['id']>();\n  private _pendingClear = false;\n  private _flushTimer: ReturnType<typeof setTimeout> | null = null;\n\n  constructor(initialItems: T[] = []) {\n    super(initialItems);\n\n    // Self-subscribe to detect mutations via diff.\n    // storageKey may not be available yet (class field initializers run after super()),\n    // but that's fine — the subscriber only fires on mutations, not during construction.\n    const unsub = this.subscribe((current, prev) => {\n      if (this._hydrating) return;\n      this._ensurePersistenceReady();\n      this._diffAndQueue(current, prev);\n      this._scheduleSave();\n    });\n    this.addCleanup(unsub);\n  }\n\n  /**\n   * DEV check for duplicate storageKey. Called lazily since storageKey is an abstract\n   * field that isn't available during the parent constructor chain.\n   */\n  private _ensurePersistenceReady(): void {\n    if (this._persistenceReady) return;\n    this._persistenceReady = true;\n\n    if (__DEV__ && _registeredKeys) {\n      const className = this.constructor.name;\n      const existing = _registeredKeys.get(this.storageKey);\n      if (existing && existing !== className) {\n        console.warn(\n          `[mvc-kit] Duplicate storageKey \"${this.storageKey}\" used by \"${className}\" ` +\n            `and \"${existing}\". Each PersistentCollection should have a unique storageKey.`,\n        );\n      }\n      _registeredKeys.set(this.storageKey, className);\n    }\n  }\n\n  // ── Public API ──\n\n  /** Whether storage data has been loaded. */\n  get hydrated(): boolean {\n    return this._hydrated;\n  }\n\n  /**\n   * Load data from storage into the collection. Idempotent — subsequent calls return current items.\n   * Returns the items after hydration.\n   */\n  async hydrate(): Promise<readonly T[]> {\n    if (this._hydrated) return this.items;\n    this._ensurePersistenceReady();\n\n    this._hydrating = true;\n    try {\n      const stored = await this.persistGetAll();\n      if (stored.length > 0) {\n        super.reset(stored);\n      }\n      this._hydrated = true;\n      return this.items;\n    } catch (err) {\n      this._handlePersistError(err);\n      this._hydrated = true;\n      return this.items;\n    } finally {\n      this._hydrating = false;\n    }\n  }\n\n  /**\n   * Synchronous hydration for sync adapters (e.g., WebStorage).\n   * Call from the **leaf class** constructor (after field initializers have run).\n   */\n  protected _hydrateSync(): void {\n    if (this._hydrated) return;\n    this._ensurePersistenceReady();\n\n    this._hydrating = true;\n    try {\n      const stored = this.persistGetAll();\n      if (stored instanceof Promise) {\n        throw new Error('[mvc-kit] _hydrateSync called with async persistGetAll');\n      }\n      if (stored.length > 0) {\n        super.reset(stored);\n      }\n      this._hydrated = true;\n    } catch (err) {\n      this._handlePersistError(err);\n      this._hydrated = true;\n    } finally {\n      this._hydrating = false;\n    }\n  }\n\n  /**\n   * Clear all data from storage AND from the in-memory collection.\n   */\n  clearStorage(): void | Promise<void> {\n    this._ensurePersistenceReady();\n\n    // Clear pending queues — we're wiping everything\n    this._pendingWrites.clear();\n    this._pendingRemoves.clear();\n    this._pendingClear = false;\n    this._cancelSave();\n\n    // Clear in-memory\n    if (this.length > 0) {\n      super.clear();\n    }\n\n    try {\n      const result = this.persistClear();\n      if (result instanceof Promise) {\n        return result.catch((err) => this._handlePersistError(err));\n      }\n    } catch (err) {\n      this._handlePersistError(err);\n    }\n  }\n\n  // ── Overrides for clear/reset tracking ──\n\n  reset(items: T[]): void {\n    this._pendingClear = true;\n    this._pendingWrites.clear();\n    this._pendingRemoves.clear();\n    for (const item of items) {\n      this._pendingWrites.set(item.id, item);\n    }\n    this._hydrating = true; // Re-use flag to skip subscriber\n    try {\n      super.reset(items);\n    } finally {\n      this._hydrating = false;\n    }\n    this._scheduleSave();\n  }\n\n  clear(): void {\n    this._pendingClear = true;\n    this._pendingWrites.clear();\n    this._pendingRemoves.clear();\n    this._hydrating = true;\n    try {\n      super.clear();\n    } finally {\n      this._hydrating = false;\n    }\n    this._scheduleSave();\n  }\n\n  // ── Override items getter for DEV pre-hydration warning ──\n\n  get items(): readonly T[] {\n    if (__DEV__ && !this._hydrated && !this._hydrating && !this._preHydrationWarned) {\n      this._preHydrationWarned = true;\n      console.warn(\n        `[mvc-kit] Accessing items on \"${this.constructor.name}\" before hydrate() has been called. ` +\n          `Data may be incomplete. Call hydrate() first.`,\n      );\n    }\n    return super.items;\n  }\n\n  get state(): readonly T[] {\n    return this.items;\n  }\n\n  // ── Dispose ──\n\n  dispose(): void {\n    if (this.disposed) return;\n\n    // Flush any pending saves before disposing\n    this._cancelSave();\n    if (this._hasPending()) {\n      try {\n        const result = this._flush();\n        if (result instanceof Promise) {\n          result.catch((err) => this._handlePersistError(err));\n        }\n      } catch (err) {\n        this._handlePersistError(err);\n      }\n    }\n\n    // DEV: unregister storageKey\n    if (__DEV__ && _registeredKeys && this._persistenceReady) {\n      _registeredKeys.delete(this.storageKey);\n    }\n\n    super.dispose();\n  }\n\n  // ── Private: delta tracking ──\n\n  private _diffAndQueue(current: readonly T[], prev: readonly T[]): void {\n    const prevMap = new Map<T['id'], T>();\n    for (const item of prev) {\n      prevMap.set(item.id, item);\n    }\n\n    const currentMap = new Map<T['id'], T>();\n    for (const item of current) {\n      currentMap.set(item.id, item);\n    }\n\n    // Added or updated: in current but not in prev, or different reference\n    for (const item of current) {\n      const prevItem = prevMap.get(item.id);\n      if (!prevItem || prevItem !== item) {\n        this._pendingWrites.set(item.id, item);\n        this._pendingRemoves.delete(item.id);\n      }\n    }\n\n    // Removed: in prev but not in current\n    for (const item of prev) {\n      if (!currentMap.has(item.id)) {\n        this._pendingRemoves.add(item.id);\n        this._pendingWrites.delete(item.id);\n      }\n    }\n  }\n\n  private _hasPending(): boolean {\n    return this._pendingClear || this._pendingWrites.size > 0 || this._pendingRemoves.size > 0;\n  }\n\n  // ── Private: debounce + flush ──\n\n  private _scheduleSave(): void {\n    this._cancelSave();\n    const delay = (this.constructor as typeof PersistentCollection).WRITE_DELAY;\n    if (delay <= 0) {\n      this._doFlush();\n      return;\n    }\n    this._flushTimer = setTimeout(() => this._doFlush(), delay);\n  }\n\n  private _cancelSave(): void {\n    if (this._flushTimer !== null) {\n      clearTimeout(this._flushTimer);\n      this._flushTimer = null;\n    }\n  }\n\n  private _doFlush(): void {\n    if (!this._hasPending()) return;\n    try {\n      const result = this._flush();\n      if (result instanceof Promise) {\n        result.catch((err) => this._handlePersistError(err));\n      }\n    } catch (err) {\n      this._handlePersistError(err);\n    }\n  }\n\n  private _flush(): void | Promise<void> {\n    const doClear = this._pendingClear;\n    const writes = this._pendingWrites.size > 0 ? [...this._pendingWrites.values()] : null;\n    const removes = this._pendingRemoves.size > 0 ? [...this._pendingRemoves] : null;\n\n    // Clear queues\n    this._pendingClear = false;\n    this._pendingWrites.clear();\n    this._pendingRemoves.clear();\n\n    if (doClear) {\n      const clearResult = this.persistClear();\n      if (clearResult instanceof Promise) {\n        return clearResult.then(() => {\n          if (writes) return this.persistSet(writes);\n        });\n      }\n      if (writes) {\n        return this.persistSet(writes);\n      }\n      return;\n    }\n\n    // Non-clear: removes then writes\n    if (removes) {\n      const removeResult = this.persistRemove(removes);\n      if (removeResult instanceof Promise) {\n        return removeResult.then(() => {\n          if (writes) return this.persistSet(writes);\n        });\n      }\n    }\n    if (writes) {\n      return this.persistSet(writes);\n    }\n  }\n\n  // ── Private: error handling ──\n\n  private _handlePersistError(err: unknown): void {\n    if (this.onPersistError) {\n      this.onPersistError(err);\n      return;\n    }\n    if (__DEV__) {\n      console.warn('[mvc-kit] Storage error:', err);\n    }\n  }\n}\n"],"names":["__DEV__","Collection","initialItems","result","now","item","excess","evicted","items","seen","newItems","prev","incoming","changed","replaced","newArray","existing","replacement","id","ids","idSet","filtered","changes","idx","updated","key","callback","snapshot","timestampSnapshot","rolledBack","predicate","compareFn","fn","listener","candidates","toEvict","evictIds","reason","currentSize","candidateIds","c","ttl","expired","ts","earliest","delay","_registeredKeys","PersistentCollection","raw","unsub","current","className","stored","err","prevMap","currentMap","prevItem","doClear","writes","removes","clearResult","removeResult"],"mappings":"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"}
+{"version":3,"file":"PersistentCollection-B8kNECDj.cjs","sources":["../src/Collection.ts","../src/PersistentCollection.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","import { Collection } from './Collection';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// Track storageKey uniqueness in DEV\nconst _registeredKeys: Map<string, string> | null = __DEV__ ? new Map() : null;\n\n/**\n * Abstract base for Collections that persist to external storage.\n * Tracks deltas per mutation and flushes via debounced writes.\n * Subclasses implement the storage-specific `persist*` methods.\n */\nexport abstract class PersistentCollection<\n  T extends { id: string | number },\n> extends Collection<T> {\n  /** Debounce delay in ms for storage writes. 0 = immediate. */\n  static WRITE_DELAY = 100;\n\n  /** Unique key identifying this collection in storage. */\n  protected abstract readonly storageKey: string;\n\n  // ── Abstract persistence methods ──\n\n  protected abstract persistGet(id: T['id']): T | null | Promise<T | null>;\n  protected abstract persistGetAll(): T[] | Promise<T[]>;\n  /** Upsert semantics — insert or replace the given items. */\n  protected abstract persistSet(items: T[]): void | Promise<void>;\n  protected abstract persistRemove(ids: T['id'][]): void | Promise<void>;\n  protected abstract persistClear(): void | Promise<void>;\n\n  // ── Serialization hooks ──\n\n  /** Serialize items to a string. Used by string-based adapters (WebStorage, NativeCollection). */\n  protected serialize(items: T[]): string {\n    return JSON.stringify(items);\n  }\n\n  /** Deserialize a string back to items. Used by string-based adapters. */\n  protected deserialize(raw: string): T[] {\n    return JSON.parse(raw);\n  }\n\n  // ── Error hook ──\n\n  /** Called when a storage operation fails. Override for custom error handling. */\n  protected onPersistError?(error: unknown): void;\n\n  // ── Internal state ──\n\n  private _hydrated = false;\n  private _hydrating = false;\n  private _persistenceReady = false;\n  private _preHydrationWarned = false;\n  private _pendingWrites = new Map<T['id'], T>();\n  private _pendingRemoves = new Set<T['id']>();\n  private _pendingClear = false;\n  private _flushTimer: ReturnType<typeof setTimeout> | null = null;\n\n  constructor(initialItems: T[] = []) {\n    super(initialItems);\n\n    // Self-subscribe to detect mutations via diff.\n    // storageKey may not be available yet (class field initializers run after super()),\n    // but that's fine — the subscriber only fires on mutations, not during construction.\n    const unsub = this.subscribe((current, prev) => {\n      if (this._hydrating) return;\n      this._ensurePersistenceReady();\n      this._diffAndQueue(current, prev);\n      this._scheduleSave();\n    });\n    this.addCleanup(unsub);\n  }\n\n  /**\n   * DEV check for duplicate storageKey. Called lazily since storageKey is an abstract\n   * field that isn't available during the parent constructor chain.\n   */\n  private _ensurePersistenceReady(): void {\n    if (this._persistenceReady) return;\n    this._persistenceReady = true;\n\n    if (__DEV__ && _registeredKeys) {\n      const className = this.constructor.name;\n      const existing = _registeredKeys.get(this.storageKey);\n      if (existing && existing !== className) {\n        console.warn(\n          `[mvc-kit] Duplicate storageKey \"${this.storageKey}\" used by \"${className}\" ` +\n            `and \"${existing}\". Each PersistentCollection should have a unique storageKey.`,\n        );\n      }\n      _registeredKeys.set(this.storageKey, className);\n    }\n  }\n\n  // ── Public API ──\n\n  /** Whether storage data has been loaded. */\n  get hydrated(): boolean {\n    return this._hydrated;\n  }\n\n  /**\n   * Load data from storage into the collection. Idempotent — subsequent calls return current items.\n   * Returns the items after hydration.\n   */\n  async hydrate(): Promise<T[]> {\n    if (this._hydrated) return this.items;\n    this._ensurePersistenceReady();\n\n    this._hydrating = true;\n    try {\n      const stored = await this.persistGetAll();\n      if (stored.length > 0) {\n        super.reset(stored);\n      }\n      this._hydrated = true;\n      return this.items;\n    } catch (err) {\n      this._handlePersistError(err);\n      this._hydrated = true;\n      return this.items;\n    } finally {\n      this._hydrating = false;\n    }\n  }\n\n  /**\n   * Synchronous hydration for sync adapters (e.g., WebStorage).\n   * Call from the **leaf class** constructor (after field initializers have run).\n   */\n  protected _hydrateSync(): void {\n    if (this._hydrated) return;\n    this._ensurePersistenceReady();\n\n    this._hydrating = true;\n    try {\n      const stored = this.persistGetAll();\n      if (stored instanceof Promise) {\n        throw new Error('[mvc-kit] _hydrateSync called with async persistGetAll');\n      }\n      if (stored.length > 0) {\n        super.reset(stored);\n      }\n      this._hydrated = true;\n    } catch (err) {\n      this._handlePersistError(err);\n      this._hydrated = true;\n    } finally {\n      this._hydrating = false;\n    }\n  }\n\n  /**\n   * Clear all data from storage AND from the in-memory collection.\n   */\n  clearStorage(): void | Promise<void> {\n    this._ensurePersistenceReady();\n\n    // Clear pending queues — we're wiping everything\n    this._pendingWrites.clear();\n    this._pendingRemoves.clear();\n    this._pendingClear = false;\n    this._cancelSave();\n\n    // Clear in-memory\n    if (this.length > 0) {\n      super.clear();\n    }\n\n    try {\n      const result = this.persistClear();\n      if (result instanceof Promise) {\n        return result.catch((err) => this._handlePersistError(err));\n      }\n    } catch (err) {\n      this._handlePersistError(err);\n    }\n  }\n\n  // ── Overrides for clear/reset tracking ──\n\n  reset(items: T[]): void {\n    this._pendingClear = true;\n    this._pendingWrites.clear();\n    this._pendingRemoves.clear();\n    for (const item of items) {\n      this._pendingWrites.set(item.id, item);\n    }\n    this._hydrating = true; // Re-use flag to skip subscriber\n    try {\n      super.reset(items);\n    } finally {\n      this._hydrating = false;\n    }\n    this._scheduleSave();\n  }\n\n  clear(): void {\n    this._pendingClear = true;\n    this._pendingWrites.clear();\n    this._pendingRemoves.clear();\n    this._hydrating = true;\n    try {\n      super.clear();\n    } finally {\n      this._hydrating = false;\n    }\n    this._scheduleSave();\n  }\n\n  // ── Override items getter for DEV pre-hydration warning ──\n\n  get items(): T[] {\n    if (__DEV__ && !this._hydrated && !this._hydrating && !this._preHydrationWarned) {\n      this._preHydrationWarned = true;\n      console.warn(\n        `[mvc-kit] Accessing items on \"${this.constructor.name}\" before hydrate() has been called. ` +\n          `Data may be incomplete. Call hydrate() first.`,\n      );\n    }\n    return super.items;\n  }\n\n  get state(): T[] {\n    return this.items;\n  }\n\n  // ── Dispose ──\n\n  dispose(): void {\n    if (this.disposed) return;\n\n    // Flush any pending saves before disposing\n    this._cancelSave();\n    if (this._hasPending()) {\n      try {\n        const result = this._flush();\n        if (result instanceof Promise) {\n          result.catch((err) => this._handlePersistError(err));\n        }\n      } catch (err) {\n        this._handlePersistError(err);\n      }\n    }\n\n    // DEV: unregister storageKey\n    if (__DEV__ && _registeredKeys && this._persistenceReady) {\n      _registeredKeys.delete(this.storageKey);\n    }\n\n    super.dispose();\n  }\n\n  // ── Private: delta tracking ──\n\n  private _diffAndQueue(current: readonly T[], prev: readonly T[]): void {\n    const prevMap = new Map<T['id'], T>();\n    for (const item of prev) {\n      prevMap.set(item.id, item);\n    }\n\n    const currentMap = new Map<T['id'], T>();\n    for (const item of current) {\n      currentMap.set(item.id, item);\n    }\n\n    // Added or updated: in current but not in prev, or different reference\n    for (const item of current) {\n      const prevItem = prevMap.get(item.id);\n      if (!prevItem || prevItem !== item) {\n        this._pendingWrites.set(item.id, item);\n        this._pendingRemoves.delete(item.id);\n      }\n    }\n\n    // Removed: in prev but not in current\n    for (const item of prev) {\n      if (!currentMap.has(item.id)) {\n        this._pendingRemoves.add(item.id);\n        this._pendingWrites.delete(item.id);\n      }\n    }\n  }\n\n  private _hasPending(): boolean {\n    return this._pendingClear || this._pendingWrites.size > 0 || this._pendingRemoves.size > 0;\n  }\n\n  // ── Private: debounce + flush ──\n\n  private _scheduleSave(): void {\n    this._cancelSave();\n    const delay = (this.constructor as typeof PersistentCollection).WRITE_DELAY;\n    if (delay <= 0) {\n      this._doFlush();\n      return;\n    }\n    this._flushTimer = setTimeout(() => this._doFlush(), delay);\n  }\n\n  private _cancelSave(): void {\n    if (this._flushTimer !== null) {\n      clearTimeout(this._flushTimer);\n      this._flushTimer = null;\n    }\n  }\n\n  private _doFlush(): void {\n    if (!this._hasPending()) return;\n    try {\n      const result = this._flush();\n      if (result instanceof Promise) {\n        result.catch((err) => this._handlePersistError(err));\n      }\n    } catch (err) {\n      this._handlePersistError(err);\n    }\n  }\n\n  private _flush(): void | Promise<void> {\n    const doClear = this._pendingClear;\n    const writes = this._pendingWrites.size > 0 ? [...this._pendingWrites.values()] : null;\n    const removes = this._pendingRemoves.size > 0 ? [...this._pendingRemoves] : null;\n\n    // Clear queues\n    this._pendingClear = false;\n    this._pendingWrites.clear();\n    this._pendingRemoves.clear();\n\n    if (doClear) {\n      const clearResult = this.persistClear();\n      if (clearResult instanceof Promise) {\n        return clearResult.then(() => {\n          if (writes) return this.persistSet(writes);\n        });\n      }\n      if (writes) {\n        return this.persistSet(writes);\n      }\n      return;\n    }\n\n    // Non-clear: removes then writes\n    if (removes) {\n      const removeResult = this.persistRemove(removes);\n      if (removeResult instanceof Promise) {\n        return removeResult.then(() => {\n          if (writes) return this.persistSet(writes);\n        });\n      }\n    }\n    if (writes) {\n      return this.persistSet(writes);\n    }\n  }\n\n  // ── Private: error handling ──\n\n  private _handlePersistError(err: unknown): void {\n    if (this.onPersistError) {\n      this.onPersistError(err);\n      return;\n    }\n    if (__DEV__) {\n      console.warn('[mvc-kit] Storage error:', err);\n    }\n  }\n}\n"],"names":["__DEV__","Collection","initialItems","result","now","item","excess","evicted","items","seen","newItems","prev","incoming","changed","replaced","newArray","existing","replacement","id","ids","idSet","filtered","changes","idx","updated","key","callback","snapshot","timestampSnapshot","rolledBack","predicate","compareFn","fn","listener","candidates","toEvict","evictIds","reason","currentSize","candidateIds","c","ttl","expired","ts","earliest","delay","_registeredKeys","PersistentCollection","raw","unsub","current","className","stored","err","prevMap","currentMap","prevItem","doClear","writes","removes","clearResult","removeResult"],"mappings":"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"}

package/dist/{PersistentCollection-BFrgskju.js → PersistentCollection-CbYqzFHc.js}

@@ -34,7 +34,7 @@ class u {
   get state() {
     return this._items;
   }
-  /** The raw readonly array of items. */
+  /** The raw array of items. */
   get items() {
     return this._items;
   }
@@ -539,4 +539,4 @@ export {
   u as C,
   m as P
 };
-//# sourceMappingURL=PersistentCollection-BFrgskju.js.map
+//# sourceMappingURL=PersistentCollection-CbYqzFHc.js.map

package/dist/PersistentCollection-CbYqzFHc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersistentCollection-CbYqzFHc.js","sources":["../src/Collection.ts","../src/PersistentCollection.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","import { Collection } from './Collection';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// Track storageKey uniqueness in DEV\nconst _registeredKeys: Map<string, string> | null = __DEV__ ? new Map() : null;\n\n/**\n * Abstract base for Collections that persist to external storage.\n * Tracks deltas per mutation and flushes via debounced writes.\n * Subclasses implement the storage-specific `persist*` methods.\n */\nexport abstract class PersistentCollection<\n  T extends { id: string | number },\n> extends Collection<T> {\n  /** Debounce delay in ms for storage writes. 0 = immediate. */\n  static WRITE_DELAY = 100;\n\n  /** Unique key identifying this collection in storage. */\n  protected abstract readonly storageKey: string;\n\n  // ── Abstract persistence methods ──\n\n  protected abstract persistGet(id: T['id']): T | null | Promise<T | null>;\n  protected abstract persistGetAll(): T[] | Promise<T[]>;\n  /** Upsert semantics — insert or replace the given items. */\n  protected abstract persistSet(items: T[]): void | Promise<void>;\n  protected abstract persistRemove(ids: T['id'][]): void | Promise<void>;\n  protected abstract persistClear(): void | Promise<void>;\n\n  // ── Serialization hooks ──\n\n  /** Serialize items to a string. Used by string-based adapters (WebStorage, NativeCollection). */\n  protected serialize(items: T[]): string {\n    return JSON.stringify(items);\n  }\n\n  /** Deserialize a string back to items. Used by string-based adapters. */\n  protected deserialize(raw: string): T[] {\n    return JSON.parse(raw);\n  }\n\n  // ── Error hook ──\n\n  /** Called when a storage operation fails. Override for custom error handling. */\n  protected onPersistError?(error: unknown): void;\n\n  // ── Internal state ──\n\n  private _hydrated = false;\n  private _hydrating = false;\n  private _persistenceReady = false;\n  private _preHydrationWarned = false;\n  private _pendingWrites = new Map<T['id'], T>();\n  private _pendingRemoves = new Set<T['id']>();\n  private _pendingClear = false;\n  private _flushTimer: ReturnType<typeof setTimeout> | null = null;\n\n  constructor(initialItems: T[] = []) {\n    super(initialItems);\n\n    // Self-subscribe to detect mutations via diff.\n    // storageKey may not be available yet (class field initializers run after super()),\n    // but that's fine — the subscriber only fires on mutations, not during construction.\n    const unsub = this.subscribe((current, prev) => {\n      if (this._hydrating) return;\n      this._ensurePersistenceReady();\n      this._diffAndQueue(current, prev);\n      this._scheduleSave();\n    });\n    this.addCleanup(unsub);\n  }\n\n  /**\n   * DEV check for duplicate storageKey. Called lazily since storageKey is an abstract\n   * field that isn't available during the parent constructor chain.\n   */\n  private _ensurePersistenceReady(): void {\n    if (this._persistenceReady) return;\n    this._persistenceReady = true;\n\n    if (__DEV__ && _registeredKeys) {\n      const className = this.constructor.name;\n      const existing = _registeredKeys.get(this.storageKey);\n      if (existing && existing !== className) {\n        console.warn(\n          `[mvc-kit] Duplicate storageKey \"${this.storageKey}\" used by \"${className}\" ` +\n            `and \"${existing}\". Each PersistentCollection should have a unique storageKey.`,\n        );\n      }\n      _registeredKeys.set(this.storageKey, className);\n    }\n  }\n\n  // ── Public API ──\n\n  /** Whether storage data has been loaded. */\n  get hydrated(): boolean {\n    return this._hydrated;\n  }\n\n  /**\n   * Load data from storage into the collection. Idempotent — subsequent calls return current items.\n   * Returns the items after hydration.\n   */\n  async hydrate(): Promise<T[]> {\n    if (this._hydrated) return this.items;\n    this._ensurePersistenceReady();\n\n    this._hydrating = true;\n    try {\n      const stored = await this.persistGetAll();\n      if (stored.length > 0) {\n        super.reset(stored);\n      }\n      this._hydrated = true;\n      return this.items;\n    } catch (err) {\n      this._handlePersistError(err);\n      this._hydrated = true;\n      return this.items;\n    } finally {\n      this._hydrating = false;\n    }\n  }\n\n  /**\n   * Synchronous hydration for sync adapters (e.g., WebStorage).\n   * Call from the **leaf class** constructor (after field initializers have run).\n   */\n  protected _hydrateSync(): void {\n    if (this._hydrated) return;\n    this._ensurePersistenceReady();\n\n    this._hydrating = true;\n    try {\n      const stored = this.persistGetAll();\n      if (stored instanceof Promise) {\n        throw new Error('[mvc-kit] _hydrateSync called with async persistGetAll');\n      }\n      if (stored.length > 0) {\n        super.reset(stored);\n      }\n      this._hydrated = true;\n    } catch (err) {\n      this._handlePersistError(err);\n      this._hydrated = true;\n    } finally {\n      this._hydrating = false;\n    }\n  }\n\n  /**\n   * Clear all data from storage AND from the in-memory collection.\n   */\n  clearStorage(): void | Promise<void> {\n    this._ensurePersistenceReady();\n\n    // Clear pending queues — we're wiping everything\n    this._pendingWrites.clear();\n    this._pendingRemoves.clear();\n    this._pendingClear = false;\n    this._cancelSave();\n\n    // Clear in-memory\n    if (this.length > 0) {\n      super.clear();\n    }\n\n    try {\n      const result = this.persistClear();\n      if (result instanceof Promise) {\n        return result.catch((err) => this._handlePersistError(err));\n      }\n    } catch (err) {\n      this._handlePersistError(err);\n    }\n  }\n\n  // ── Overrides for clear/reset tracking ──\n\n  reset(items: T[]): void {\n    this._pendingClear = true;\n    this._pendingWrites.clear();\n    this._pendingRemoves.clear();\n    for (const item of items) {\n      this._pendingWrites.set(item.id, item);\n    }\n    this._hydrating = true; // Re-use flag to skip subscriber\n    try {\n      super.reset(items);\n    } finally {\n      this._hydrating = false;\n    }\n    this._scheduleSave();\n  }\n\n  clear(): void {\n    this._pendingClear = true;\n    this._pendingWrites.clear();\n    this._pendingRemoves.clear();\n    this._hydrating = true;\n    try {\n      super.clear();\n    } finally {\n      this._hydrating = false;\n    }\n    this._scheduleSave();\n  }\n\n  // ── Override items getter for DEV pre-hydration warning ──\n\n  get items(): T[] {\n    if (__DEV__ && !this._hydrated && !this._hydrating && !this._preHydrationWarned) {\n      this._preHydrationWarned = true;\n      console.warn(\n        `[mvc-kit] Accessing items on \"${this.constructor.name}\" before hydrate() has been called. ` +\n          `Data may be incomplete. Call hydrate() first.`,\n      );\n    }\n    return super.items;\n  }\n\n  get state(): T[] {\n    return this.items;\n  }\n\n  // ── Dispose ──\n\n  dispose(): void {\n    if (this.disposed) return;\n\n    // Flush any pending saves before disposing\n    this._cancelSave();\n    if (this._hasPending()) {\n      try {\n        const result = this._flush();\n        if (result instanceof Promise) {\n          result.catch((err) => this._handlePersistError(err));\n        }\n      } catch (err) {\n        this._handlePersistError(err);\n      }\n    }\n\n    // DEV: unregister storageKey\n    if (__DEV__ && _registeredKeys && this._persistenceReady) {\n      _registeredKeys.delete(this.storageKey);\n    }\n\n    super.dispose();\n  }\n\n  // ── Private: delta tracking ──\n\n  private _diffAndQueue(current: readonly T[], prev: readonly T[]): void {\n    const prevMap = new Map<T['id'], T>();\n    for (const item of prev) {\n      prevMap.set(item.id, item);\n    }\n\n    const currentMap = new Map<T['id'], T>();\n    for (const item of current) {\n      currentMap.set(item.id, item);\n    }\n\n    // Added or updated: in current but not in prev, or different reference\n    for (const item of current) {\n      const prevItem = prevMap.get(item.id);\n      if (!prevItem || prevItem !== item) {\n        this._pendingWrites.set(item.id, item);\n        this._pendingRemoves.delete(item.id);\n      }\n    }\n\n    // Removed: in prev but not in current\n    for (const item of prev) {\n      if (!currentMap.has(item.id)) {\n        this._pendingRemoves.add(item.id);\n        this._pendingWrites.delete(item.id);\n      }\n    }\n  }\n\n  private _hasPending(): boolean {\n    return this._pendingClear || this._pendingWrites.size > 0 || this._pendingRemoves.size > 0;\n  }\n\n  // ── Private: debounce + flush ──\n\n  private _scheduleSave(): void {\n    this._cancelSave();\n    const delay = (this.constructor as typeof PersistentCollection).WRITE_DELAY;\n    if (delay <= 0) {\n      this._doFlush();\n      return;\n    }\n    this._flushTimer = setTimeout(() => this._doFlush(), delay);\n  }\n\n  private _cancelSave(): void {\n    if (this._flushTimer !== null) {\n      clearTimeout(this._flushTimer);\n      this._flushTimer = null;\n    }\n  }\n\n  private _doFlush(): void {\n    if (!this._hasPending()) return;\n    try {\n      const result = this._flush();\n      if (result instanceof Promise) {\n        result.catch((err) => this._handlePersistError(err));\n      }\n    } catch (err) {\n      this._handlePersistError(err);\n    }\n  }\n\n  private _flush(): void | Promise<void> {\n    const doClear = this._pendingClear;\n    const writes = this._pendingWrites.size > 0 ? [...this._pendingWrites.values()] : null;\n    const removes = this._pendingRemoves.size > 0 ? [...this._pendingRemoves] : null;\n\n    // Clear queues\n    this._pendingClear = false;\n    this._pendingWrites.clear();\n    this._pendingRemoves.clear();\n\n    if (doClear) {\n      const clearResult = this.persistClear();\n      if (clearResult instanceof Promise) {\n        return clearResult.then(() => {\n          if (writes) return this.persistSet(writes);\n        });\n      }\n      if (writes) {\n        return this.persistSet(writes);\n      }\n      return;\n    }\n\n    // Non-clear: removes then writes\n    if (removes) {\n      const removeResult = this.persistRemove(removes);\n      if (removeResult instanceof Promise) {\n        return removeResult.then(() => {\n          if (writes) return this.persistSet(writes);\n        });\n      }\n    }\n    if (writes) {\n      return this.persistSet(writes);\n    }\n  }\n\n  // ── Private: error handling ──\n\n  private _handlePersistError(err: unknown): void {\n    if (this.onPersistError) {\n      this.onPersistError(err);\n      return;\n    }\n    if (__DEV__) {\n      console.warn('[mvc-kit] Storage error:', err);\n    }\n  }\n}\n"],"names":["__DEV__","Collection","initialItems","result","now","item","excess","evicted","items","seen","newItems","prev","incoming","changed","replaced","newArray","existing","replacement","id","ids","idSet","filtered","changes","idx","updated","key","callback","snapshot","timestampSnapshot","rolledBack","predicate","compareFn","fn","listener","candidates","toEvict","evictIds","reason","currentSize","candidateIds","c","ttl","expired","ts","earliest","delay","_registeredKeys","PersistentCollection","raw","unsub","current","className","stored","err","prevMap","currentMap","prevItem","doClear","writes","removes","clearResult","removeResult"],"mappings":"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"}

package/dist/PersistentCollection.d.ts

@@ -18,7 +18,7 @@ export declare abstract class PersistentCollection<T extends {
     protected abstract persistRemove(ids: T['id'][]): void | Promise<void>;
     protected abstract persistClear(): void | Promise<void>;
     /** Serialize items to a string. Used by string-based adapters (WebStorage, NativeCollection). */
-    protected serialize(items: readonly T[]): string;
+    protected serialize(items: T[]): string;
     /** Deserialize a string back to items. Used by string-based adapters. */
     protected deserialize(raw: string): T[];
     /** Called when a storage operation fails. Override for custom error handling. */
@@ -43,7 +43,7 @@ export declare abstract class PersistentCollection<T extends {
      * Load data from storage into the collection. Idempotent — subsequent calls return current items.
      * Returns the items after hydration.
      */
-    hydrate(): Promise<readonly T[]>;
+    hydrate(): Promise<T[]>;
     /**
      * Synchronous hydration for sync adapters (e.g., WebStorage).
      * Call from the **leaf class** constructor (after field initializers have run).
@@ -55,8 +55,8 @@ export declare abstract class PersistentCollection<T extends {
     clearStorage(): void | Promise<void>;
     reset(items: T[]): void;
     clear(): void;
-    get items(): readonly T[];
-    get state(): readonly T[];
+    get items(): T[];
+    get state(): T[];
     dispose(): void;
     private _diffAndQueue;
     private _hasPending;

package/dist/PersistentCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PersistentCollection.d.ts","sourceRoot":"","sources":["../src/PersistentCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO1C;;;;GAIG;AACH,8BAAsB,oBAAoB,CACxC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CACjC,SAAQ,UAAU,CAAC,CAAC,CAAC;IACrB,8DAA8D;IAC9D,MAAM,CAAC,WAAW,SAAO;IAEzB,yDAAyD;IACzD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAI/C,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IACxE,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IACtD,4DAA4D;IAC5D,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC/D,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IACtE,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,iGAAiG;IACjG,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,MAAM;IAIhD,yEAAyE;IACzE,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE;IAMvC,iFAAiF;IACjF,SAAS,CAAC,cAAc,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI/C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAA8C;gBAErD,YAAY,GAAE,CAAC,EAAO;IAelC;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAmB/B,4CAA4C;IAC5C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IAqBtC;;;OAGG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAsB9B;;OAEG;IACH,YAAY,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BpC,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAgBvB,KAAK,IAAI,IAAI;IAeb,IAAI,KAAK,IAAI,SAAS,CAAC,EAAE,CASxB;IAED,IAAI,KAAK,IAAI,SAAS,CAAC,EAAE,CAExB;IAID,OAAO,IAAI,IAAI;IA0Bf,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,MAAM;IAuCd,OAAO,CAAC,mBAAmB;CAS5B"}
+{"version":3,"file":"PersistentCollection.d.ts","sourceRoot":"","sources":["../src/PersistentCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO1C;;;;GAIG;AACH,8BAAsB,oBAAoB,CACxC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CACjC,SAAQ,UAAU,CAAC,CAAC,CAAC;IACrB,8DAA8D;IAC9D,MAAM,CAAC,WAAW,SAAO;IAEzB,yDAAyD;IACzD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAI/C,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IACxE,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IACtD,4DAA4D;IAC5D,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC/D,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IACtE,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,iGAAiG;IACjG,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,MAAM;IAIvC,yEAAyE;IACzE,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE;IAMvC,iFAAiF;IACjF,SAAS,CAAC,cAAc,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI/C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAA8C;gBAErD,YAAY,GAAE,CAAC,EAAO;IAelC;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAmB/B,4CAA4C;IAC5C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAqB7B;;;OAGG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAsB9B;;OAEG;IACH,YAAY,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BpC,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAgBvB,KAAK,IAAI,IAAI;IAeb,IAAI,KAAK,IAAI,CAAC,EAAE,CASf;IAED,IAAI,KAAK,IAAI,CAAC,EAAE,CAEf;IAID,OAAO,IAAI,IAAI;IA0Bf,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,MAAM;IAuCd,OAAO,CAAC,mBAAmB;CAS5B"}

package/dist/Resource.d.ts

@@ -30,8 +30,8 @@ export declare class Resource<T extends {
     init(): void | Promise<void>;
     /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */
     protected onInit?(): void | Promise<void>;
-    get state(): readonly T[];
-    get items(): readonly T[];
+    get state(): T[];
+    get items(): T[];
     get length(): number;
     add(...items: T[]): void;
     upsert(...items: T[]): void;
@@ -43,10 +43,10 @@ export declare class Resource<T extends {
     get(id: T['id']): T | undefined;
     has(id: T['id']): boolean;
     find(predicate: (item: T) => boolean): T | undefined;
-    filter(predicate: (item: T) => boolean): readonly T[];
-    sorted(compareFn: (a: T, b: T) => number): readonly T[];
-    map<U>(fn: (item: T) => U): readonly U[];
-    subscribe(listener: Listener<readonly T[]>): () => void;
+    filter(predicate: (item: T) => boolean): T[];
+    sorted(compareFn: (a: T, b: T) => number): T[];
+    map<U>(fn: (item: T) => U): U[];
+    subscribe(listener: Listener<T[]>): () => void;
     /** Proxy providing `TaskState` (loading, error, errorCode) per async method. */
     get async(): ResourceAsyncMap<this>;
     /** Subscribes to async state changes. Used by `useAsync` and `useInstance` for React integration. */