mvc-kit 2.11.1 → 2.12.0

package/README.md

@@ -781,9 +781,12 @@ function App() {
 | `Controller` | Stateless orchestrator (Disposable) |
 | `Service` | Non-reactive infrastructure service (Disposable) |
 | `EventBus<E>` | Typed pub/sub event bus |
+| `Trackable` | Base class for custom reactive objects (subscribable + disposable + auto-bind) |
 
 ### Composable Helpers
 
+All composable helpers extend `Trackable` — subscribable, disposable, and auto-bound.
+
 | Class | Description |
 |-------|-------------|
 | `Sorting<T>` | Multi-column sort state with 3-click toggle cycle and `apply()` pipeline |
@@ -890,6 +893,7 @@ Each core class and React hook has a dedicated reference doc with full API detai
 | [Service](src/Service.md) | Non-reactive infrastructure adapters (HTTP, storage, SDKs) |
 | [EventBus](src/EventBus.md) | Typed pub/sub for cross-cutting event communication |
 | [Channel](src/Channel.md) | Persistent connections (WebSocket, SSE) with auto-reconnect |
+| [Trackable](src/Trackable.md) | Base class for custom reactive objects (subscribable + disposable + auto-bind) |
 | [Singleton Registry](src/singleton.md) | Global instance management: `singleton()`, `teardown()`, `teardownAll()` |
 | [Sorting](src/Sorting.md) | Multi-column sort state with 3-click toggle cycle and apply pipeline |
 | [Pagination](src/Pagination.md) | Page/pageSize state with array slicing |

package/agent-config/claude-code/skills/guide/anti-patterns.md

@@ -526,6 +526,47 @@ this.pending.enqueue(id, 'delete', async (signal) => {
 
 ---
 
+## 25. Manually Reimplementing Subscribe/Notify/Dispose Boilerplate
+
+```typescript
+// BAD — hand-rolling what Trackable provides
+class QueryState {
+  private listeners = new Set<() => void>();
+  private _disposed = false;
+  private _data: Data | undefined;
+
+  subscribe(cb: () => void) {
+    this.listeners.add(cb);
+    return () => this.listeners.delete(cb);
+  }
+  private notify() {
+    for (const cb of this.listeners) cb();
+  }
+  dispose() {
+    this._disposed = true;
+    this.listeners.clear();
+  }
+  // ... more boilerplate
+}
+
+// GOOD — extend Trackable for subscribe, notify, dispose, disposeSignal, addCleanup, and auto-binding
+import { Trackable } from 'mvc-kit';
+
+class QueryState extends Trackable {
+  private _data: Data | undefined;
+  get data() { return this._data; }
+
+  async load() {
+    this._data = await fetchData(this.disposeSignal);
+    this.notify();
+  }
+}
+```
+
+Trackable is the base class for all composable helpers (Sorting, Selection, Feed, Pagination, Pending). Use it whenever you need a subscribable + disposable object.
+
+---
+
 ## 24. Using collection.optimistic() Rollback with Pending
 
 ```typescript

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

@@ -6,6 +6,7 @@
 // Core classes and utilities
 import { ViewModel, Model, Collection, PersistentCollection, Resource, Controller, Service, EventBus, Channel } from 'mvc-kit';
 import { Sorting, Pagination, Selection, Feed, Pending } from 'mvc-kit';
+import { Trackable, bindPublicMethods } from 'mvc-kit';
 import { singleton, hasSingleton, teardown, teardownAll } from 'mvc-kit';
 import { HttpError, isAbortError, classifyError } from 'mvc-kit';
 import type { Subscribable, Disposable, Initializable, Listener, Updater, ValidationErrors, TaskState, EventSource, EventPayload, AppError, AsyncMethodKeys, ResourceAsyncMethodKeys, ChannelStatus, SortDescriptor, FeedPage, PendingOperation, PendingEntry } from 'mvc-kit';
@@ -285,9 +286,50 @@ No state, no getters, no async tracking.
 
 ---
 
+## Trackable
+
+Base class for custom reactive objects. Provides subscribe/notify, disposal lifecycle (disposeSignal, addCleanup, onDispose), and auto-bound methods — the same building blocks used by Sorting, Selection, Feed, Pagination, and Pending (all extend Trackable).
+
+Use Trackable when integrating third-party SDKs, custom query objects, or any reactive state that doesn't fit ViewModel's state/getter model.
+
+### Subscribe & Notify
+- `subscribe(cb: () => void): () => void` — Subscribe to change notifications. Duck-typed contract recognized by ViewModel auto-tracking.
+- `notify(): void` — Protected. Notify all subscribers that state changed.
+
+### Lifecycle & Cleanup
+- `disposed: boolean` — Whether this instance has been disposed.
+- `disposeSignal: AbortSignal` — Lazily created, auto-aborted on `dispose()`.
+- `addCleanup(fn: () => void): void` — Protected. Register teardown callback.
+- `onDispose(): void` — Protected lifecycle hook called at the end of `dispose()`.
+- `dispose(): void` — Idempotent. Aborts signal, runs cleanups, clears subscribers, calls `onDispose`.
+
+### Auto-Binding
+Public methods are auto-bound in the constructor via `bindPublicMethods()`, so they can be passed point-free as callbacks.
+
+---
+
+## bindPublicMethods(instance, stopPrototype?, exclude?)
+
+Utility function that auto-binds all public methods on an instance. Used internally by Trackable, Collection, Service, EventBus, Channel, Controller, and Model. Available as a named export for custom classes that don't extend Trackable.
+
+```typescript
+import { bindPublicMethods } from 'mvc-kit';
+
+class MyClass {
+  constructor() {
+    bindPublicMethods(this);
+  }
+  greet() { return 'hello'; }
+}
+const { greet } = new MyClass();
+greet(); // 'hello' — no lost `this`
+```
+
+---
+
 ## Composable Helpers
 
-Plain classes with `subscribe()` — auto-tracked when declared as ViewModel instance properties. Each has an `apply()` method that transforms arrays. Helpers manage state; ViewModels compose them in getters.
+Plain classes that extend `Trackable` — auto-tracked when declared as ViewModel instance properties. Each has an `apply()` method that transforms arrays. Helpers manage state; ViewModels compose them in getters.
 
 ### Sorting\<T\>
 

package/agent-config/claude-code/skills/guide/patterns.md

@@ -387,6 +387,58 @@ Components and helpers are independent — use helpers without components, or co
 
 ---
 
+## Custom Trackable Pattern
+
+Extend `Trackable` when you need a reactive object that integrates with ViewModel auto-tracking but doesn't fit the state/getter model. Call `notify()` after mutating internal state. The object gets `subscribe()`, `dispose()`, `disposeSignal`, `addCleanup()`, and auto-bound methods for free.
+
+```typescript
+import { Trackable } from 'mvc-kit';
+
+class RPCQuery<Data> extends Trackable {
+  private _data: Data | undefined;
+  private _loading = false;
+  private _error: string | null = null;
+
+  get data() { return this._data; }
+  get loading() { return this._loading; }
+  get error() { return this._error; }
+
+  async execute(params: Record<string, unknown>): Promise<void> {
+    this._loading = true;
+    this._error = null;
+    this.notify();
+    try {
+      this._data = await rpcClient.call(params, { signal: this.disposeSignal });
+    } catch (e) {
+      this._error = (e as Error).message;
+      throw e;
+    } finally {
+      this._loading = false;
+      this.notify();
+    }
+  }
+}
+```
+
+Used as a ViewModel property — auto-tracked like any composable helper:
+
+```typescript
+class UsersVM extends ViewModel {
+  readonly query = new RPCQuery<User[]>();
+
+  get users() { return this.query.data ?? []; }
+  get loading() { return this.query.loading; }
+
+  protected onInit() { this.query.execute({ limit: 50 }); }
+}
+```
+
+**When to use Trackable vs ViewModel:**
+- Trackable: custom reactive object used as a ViewModel property (query wrapper, SDK adapter, animation state).
+- ViewModel: component-scoped reactive state with computed getters, async tracking, and lifecycle hooks.
+
+---
+
 ## Persistence Pattern
 
 ```typescript

package/agent-config/copilot/copilot-instructions.md

@@ -15,11 +15,12 @@ This project uses **mvc-kit**, a zero-dependency TypeScript-first reactive state
 | `EventBus<E>` | Typed pub/sub for cross-cutting events | Singleton |
 | `Channel<M>` | Persistent connection (WebSocket/SSE) with auto-reconnect | Singleton |
 | `Controller` | Stateless multi-ViewModel orchestrator (rare) | Component-scoped |
-| `Sorting<T>` | Multi-column sort state with 3-click toggle cycle and `apply()` pipeline | ViewModel property |
-| `Pagination` | Page/pageSize state with `apply()` slicing | ViewModel property |
-| `Selection<K>` | Key-based selection set with toggle/select-all semantics | ViewModel property |
-| `Feed<T>` | Cursor + hasMore + item accumulation for server-side pagination | ViewModel property |
-| `Pending<K, Meta?>` | Per-item operation queue with retry + status tracking + optional typed metadata | Resource property |
+| `Trackable` | Base class for custom reactive objects — subscribable + disposable + auto-bind | ViewModel property / `useLocal` |
+| `Sorting<T>` | Multi-column sort state with 3-click toggle cycle and `apply()` pipeline (extends Trackable) | ViewModel property |
+| `Pagination` | Page/pageSize state with `apply()` slicing (extends Trackable) | ViewModel property |
+| `Selection<K>` | Key-based selection set with toggle/select-all semantics (extends Trackable) | ViewModel property |
+| `Feed<T>` | Cursor + hasMore + item accumulation for server-side pagination (extends Trackable) | ViewModel property |
+| `Pending<K, Meta?>` | Per-item operation queue with retry + status tracking + optional typed metadata (extends Trackable) | Resource property |
 
 ## Headless React Components (`mvc-kit/react`)
 
@@ -34,6 +35,7 @@ This project uses **mvc-kit**, a zero-dependency TypeScript-first reactive state
 ```typescript
 import { ViewModel, Model, Collection, PersistentCollection, Resource, Controller, Service, EventBus, Channel } from 'mvc-kit';
 import { Sorting, Pagination, Selection, Feed, Pending } from 'mvc-kit';
+import { Trackable, bindPublicMethods } from 'mvc-kit';
 import { singleton, teardownAll, HttpError, isAbortError, classifyError } from 'mvc-kit';
 import { useLocal, useSingleton, useInstance, useModel, useModelRef, useField, useEvent, useEmit, useResolve, useTeardown, Provider } from 'mvc-kit/react';
 import { DataTable, CardList, InfiniteScroll } from 'mvc-kit/react';
@@ -288,6 +290,7 @@ test('example', () => {
 - Pass-through Service wrapping a typed API client → call the client directly from Resource
 - `addCleanup` for `channel.on()`/`bus.on()` subscriptions → use `listenTo()` (auto-cleanup on dispose and reset)
 - Missing `hydrate()` for async adapters (IndexedDB, NativeCollection) → call `hydrate()` in `onInit()` before accessing data
+- Manually reimplementing subscribe/notify/dispose boilerplate → extend `Trackable`
 
 ## Resource Pattern
 
@@ -325,6 +328,7 @@ class UsersVM extends ViewModel<{ search: string }> {
 - Cross-cutting events → **EventBus**
 - Persistent connection → **Channel**
 - Coordinates multiple ViewModels → **Controller** (rare)
+- Custom reactive object (SDK wrapper, query, animation) → **Trackable** (base class for helpers)
 - Sort/paginate/select on a list → **Sorting/Pagination/Selection** helpers
 - Cursor-based server pagination → **Feed** helper
 - Per-item operation retry with status → **Pending** helper (on Resource, not ViewModel)

package/agent-config/cursor/cursorrules

@@ -15,11 +15,12 @@ This project uses **mvc-kit**, a zero-dependency TypeScript-first reactive state
 | `EventBus<E>` | Typed pub/sub for cross-cutting events | Singleton |
 | `Channel<M>` | Persistent connection (WebSocket/SSE) with auto-reconnect | Singleton |
 | `Controller` | Stateless multi-ViewModel orchestrator (rare) | Component-scoped |
-| `Sorting<T>` | Multi-column sort state with 3-click toggle cycle and `apply()` pipeline | ViewModel property |
-| `Pagination` | Page/pageSize state with `apply()` slicing | ViewModel property |
-| `Selection<K>` | Key-based selection set with toggle/select-all semantics | ViewModel property |
-| `Feed<T>` | Cursor + hasMore + item accumulation for server-side pagination | ViewModel property |
-| `Pending<K, Meta?>` | Per-item operation queue with retry + status tracking + optional typed metadata | Resource property |
+| `Trackable` | Base class for custom reactive objects — subscribable + disposable + auto-bind | ViewModel property / `useLocal` |
+| `Sorting<T>` | Multi-column sort state with 3-click toggle cycle and `apply()` pipeline (extends Trackable) | ViewModel property |
+| `Pagination` | Page/pageSize state with `apply()` slicing (extends Trackable) | ViewModel property |
+| `Selection<K>` | Key-based selection set with toggle/select-all semantics (extends Trackable) | ViewModel property |
+| `Feed<T>` | Cursor + hasMore + item accumulation for server-side pagination (extends Trackable) | ViewModel property |
+| `Pending<K, Meta?>` | Per-item operation queue with retry + status tracking + optional typed metadata (extends Trackable) | Resource property |
 
 ## Headless React Components (`mvc-kit/react`)
 
@@ -34,6 +35,7 @@ This project uses **mvc-kit**, a zero-dependency TypeScript-first reactive state
 ```typescript
 import { ViewModel, Model, Collection, PersistentCollection, Resource, Controller, Service, EventBus, Channel } from 'mvc-kit';
 import { Sorting, Pagination, Selection, Feed, Pending } from 'mvc-kit';
+import { Trackable, bindPublicMethods } from 'mvc-kit';
 import { singleton, teardownAll, HttpError, isAbortError, classifyError } from 'mvc-kit';
 import { useLocal, useSingleton, useInstance, useModel, useModelRef, useField, useEvent, useEmit, useResolve, useTeardown, Provider } from 'mvc-kit/react';
 import { DataTable, CardList, InfiniteScroll } from 'mvc-kit/react';
@@ -288,6 +290,7 @@ test('example', () => {
 - Pass-through Service wrapping a typed API client → call the client directly from Resource
 - `addCleanup` for `channel.on()`/`bus.on()` subscriptions → use `listenTo()` (auto-cleanup on dispose and reset)
 - Missing `hydrate()` for async adapters (IndexedDB, NativeCollection) → call `hydrate()` in `onInit()` before accessing data
+- Manually reimplementing subscribe/notify/dispose boilerplate → extend `Trackable`
 
 ## Resource Pattern
 
@@ -325,6 +328,7 @@ class UsersVM extends ViewModel<{ search: string }> {
 - Cross-cutting events → **EventBus**
 - Persistent connection → **Channel**
 - Coordinates multiple ViewModels → **Controller** (rare)
+- Custom reactive object (SDK wrapper, query, animation) → **Trackable** (base class for helpers)
 - Sort/paginate/select on a list → **Sorting/Pagination/Selection** helpers
 - Cursor-based server pagination → **Feed** helper
 - Per-item operation retry with status → **Pending** helper (on Resource, not ViewModel)

package/dist/Feed.cjs

@@ -1,13 +1,12 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const bindPublicMethods = require("./bindPublicMethods.cjs");
-class Feed {
+const Trackable = require("./Trackable.cjs");
+class Feed extends Trackable.Trackable {
   _cursor = null;
   _hasMore = true;
   _items = Object.freeze([]);
-  _listeners = /* @__PURE__ */ new Set();
   constructor() {
-    bindPublicMethods.bindPublicMethods(this);
+    super();
   }
   // ── Readable state ──
   /** Current cursor position for the next page fetch, or null if at the beginning. */
@@ -31,59 +30,48 @@ class Feed {
   setResult(result) {
     this._hasMore = result.hasMore;
     this._cursor = result.cursor ?? null;
-    this._notify();
+    this.notify();
   }
   /** Append page items and update cursor/hasMore. */
   appendPage(page) {
     this._items = Object.freeze([...this._items, ...page.items]);
     this._hasMore = page.hasMore;
     this._cursor = page.cursor ?? null;
-    this._notify();
+    this.notify();
   }
   /** Prepend page items and update cursor/hasMore. */
   prependPage(page) {
     this._items = Object.freeze([...page.items, ...this._items]);
     this._hasMore = page.hasMore;
     this._cursor = page.cursor ?? null;
-    this._notify();
+    this.notify();
   }
   /** Add items without affecting cursor/hasMore. */
   push(...items) {
     if (items.length === 0) return;
     this._items = Object.freeze([...this._items, ...items]);
-    this._notify();
+    this.notify();
   }
   /** Remove items that don't match the predicate. No-op if nothing is filtered out. */
   filter(predicate) {
     const filtered = this._items.filter(predicate);
     if (filtered.length === this._items.length) return;
     this._items = Object.freeze(filtered);
-    this._notify();
+    this.notify();
   }
   /** Replace all items and update cursor/hasMore atomically. Ideal for pull-to-refresh. */
   replacePage(page) {
     this._items = Object.freeze([...page.items]);
     this._hasMore = page.hasMore;
     this._cursor = page.cursor ?? null;
-    this._notify();
+    this.notify();
   }
   /** Reset to initial empty state with hasMore=true. */
   reset() {
     this._cursor = null;
     this._hasMore = true;
     this._items = Object.freeze([]);
-    this._notify();
-  }
-  // ── Subscribable interface ──
-  /** Subscribe to feed state changes. Returns an unsubscribe function. */
-  subscribe(cb) {
-    this._listeners.add(cb);
-    return () => {
-      this._listeners.delete(cb);
-    };
-  }
-  _notify() {
-    for (const cb of this._listeners) cb();
+    this.notify();
   }
 }
 exports.Feed = Feed;

package/dist/Feed.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Feed.cjs","sources":["../src/Feed.ts"],"sourcesContent":["import { bindPublicMethods } from './bindPublicMethods';\n\n/** Represents a page of items from a paginated API response. */\nexport interface FeedPage<T> {\n  items: T[];\n  hasMore: boolean;\n  cursor?: string | null;\n}\n\n/**\n * Cursor-based pagination state for server-side paginated feeds.\n * Accumulates items across pages, tracks cursor position and hasMore flag.\n * Subscribable — auto-tracked when used as a ViewModel property.\n */\nexport class Feed<T = unknown> {\n  private _cursor: string | null = null;\n  private _hasMore: boolean = true;\n  private _items: readonly T[] = Object.freeze([] as T[]);\n  private _listeners = new Set<() => void>();\n\n  constructor() {\n    bindPublicMethods(this);\n  }\n\n  // ── Readable state ──\n\n  /** Current cursor position for the next page fetch, or null if at the beginning. */\n  get cursor(): string | null {\n    return this._cursor;\n  }\n\n  /** Whether more pages are available from the server. */\n  get hasMore(): boolean {\n    return this._hasMore;\n  }\n\n  /** Accumulated items across all loaded pages. */\n  get items(): readonly T[] {\n    return this._items;\n  }\n\n  /** Total number of accumulated items. */\n  get count(): number {\n    return this._items.length;\n  }\n\n  // ── Actions ──\n\n  /** Update cursor/hasMore only (backward-compatible, does NOT affect items). */\n  setResult(result: { hasMore: boolean; cursor?: string | null }): void {\n    this._hasMore = result.hasMore;\n    this._cursor = result.cursor ?? null;\n    this._notify();\n  }\n\n  /** Append page items and update cursor/hasMore. */\n  appendPage(page: FeedPage<T>): void {\n    this._items = Object.freeze([...this._items, ...page.items]);\n    this._hasMore = page.hasMore;\n    this._cursor = page.cursor ?? null;\n    this._notify();\n  }\n\n  /** Prepend page items and update cursor/hasMore. */\n  prependPage(page: FeedPage<T>): void {\n    this._items = Object.freeze([...page.items, ...this._items]);\n    this._hasMore = page.hasMore;\n    this._cursor = page.cursor ?? null;\n    this._notify();\n  }\n\n  /** Add items without affecting cursor/hasMore. */\n  push(...items: T[]): void {\n    if (items.length === 0) return;\n    this._items = Object.freeze([...this._items, ...items]);\n    this._notify();\n  }\n\n  /** Remove items that don't match the predicate. No-op if nothing is filtered out. */\n  filter(predicate: (item: T) => boolean): void {\n    const filtered = this._items.filter(predicate);\n    if (filtered.length === this._items.length) return;\n    this._items = Object.freeze(filtered);\n    this._notify();\n  }\n\n  /** Replace all items and update cursor/hasMore atomically. Ideal for pull-to-refresh. */\n  replacePage(page: FeedPage<T>): void {\n    this._items = Object.freeze([...page.items]);\n    this._hasMore = page.hasMore;\n    this._cursor = page.cursor ?? null;\n    this._notify();\n  }\n\n  /** Reset to initial empty state with hasMore=true. */\n  reset(): void {\n    this._cursor = null;\n    this._hasMore = true;\n    this._items = Object.freeze([] as T[]);\n    this._notify();\n  }\n\n  // ── Subscribable interface ──\n\n  /** Subscribe to feed state changes. Returns an unsubscribe function. */\n  subscribe(cb: () => void): () => void {\n    this._listeners.add(cb);\n    return () => { this._listeners.delete(cb); };\n  }\n\n  private _notify(): void {\n    for (const cb of this._listeners) cb();\n  }\n}\n"],"names":["bindPublicMethods"],"mappings":";;;AAcO,MAAM,KAAkB;AAAA,EACrB,UAAyB;AAAA,EACzB,WAAoB;AAAA,EACpB,SAAuB,OAAO,OAAO,EAAS;AAAA,EAC9C,iCAAiB,IAAA;AAAA,EAEzB,cAAc;AACZA,sBAAAA,kBAAkB,IAAI;AAAA,EACxB;AAAA;AAAA;AAAA,EAKA,IAAI,SAAwB;AAC1B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,UAAmB;AACrB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,QAAsB;AACxB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,QAAgB;AAClB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA;AAAA;AAAA,EAKA,UAAU,QAA4D;AACpE,SAAK,WAAW,OAAO;AACvB,SAAK,UAAU,OAAO,UAAU;AAChC,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,WAAW,MAAyB;AAClC,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,GAAG,KAAK,KAAK,CAAC;AAC3D,SAAK,WAAW,KAAK;AACrB,SAAK,UAAU,KAAK,UAAU;AAC9B,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,YAAY,MAAyB;AACnC,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,OAAO,GAAG,KAAK,MAAM,CAAC;AAC3D,SAAK,WAAW,KAAK;AACrB,SAAK,UAAU,KAAK,UAAU;AAC9B,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,QAAQ,OAAkB;AACxB,QAAI,MAAM,WAAW,EAAG;AACxB,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,GAAG,KAAK,CAAC;AACtD,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,OAAO,WAAuC;AAC5C,UAAM,WAAW,KAAK,OAAO,OAAO,SAAS;AAC7C,QAAI,SAAS,WAAW,KAAK,OAAO,OAAQ;AAC5C,SAAK,SAAS,OAAO,OAAO,QAAQ;AACpC,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,YAAY,MAAyB;AACnC,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,KAAK,CAAC;AAC3C,SAAK,WAAW,KAAK;AACrB,SAAK,UAAU,KAAK,UAAU;AAC9B,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,UAAU;AACf,SAAK,WAAW;AAChB,SAAK,SAAS,OAAO,OAAO,CAAA,CAAS;AACrC,SAAK,QAAA;AAAA,EACP;AAAA;AAAA;AAAA,EAKA,UAAU,IAA4B;AACpC,SAAK,WAAW,IAAI,EAAE;AACtB,WAAO,MAAM;AAAE,WAAK,WAAW,OAAO,EAAE;AAAA,IAAG;AAAA,EAC7C;AAAA,EAEQ,UAAgB;AACtB,eAAW,MAAM,KAAK,WAAY,IAAA;AAAA,EACpC;AACF;;"}
+{"version":3,"file":"Feed.cjs","sources":["../src/Feed.ts"],"sourcesContent":["import { Trackable } from './Trackable';\n\n/** Represents a page of items from a paginated API response. */\nexport interface FeedPage<T> {\n  items: T[];\n  hasMore: boolean;\n  cursor?: string | null;\n}\n\n/**\n * Cursor-based pagination state for server-side paginated feeds.\n * Accumulates items across pages, tracks cursor position and hasMore flag.\n * Subscribable — auto-tracked when used as a ViewModel property.\n */\nexport class Feed<T = unknown> extends Trackable {\n  private _cursor: string | null = null;\n  private _hasMore: boolean = true;\n  private _items: readonly T[] = Object.freeze([] as T[]);\n\n  constructor() {\n    super();\n  }\n\n  // ── Readable state ──\n\n  /** Current cursor position for the next page fetch, or null if at the beginning. */\n  get cursor(): string | null {\n    return this._cursor;\n  }\n\n  /** Whether more pages are available from the server. */\n  get hasMore(): boolean {\n    return this._hasMore;\n  }\n\n  /** Accumulated items across all loaded pages. */\n  get items(): readonly T[] {\n    return this._items;\n  }\n\n  /** Total number of accumulated items. */\n  get count(): number {\n    return this._items.length;\n  }\n\n  // ── Actions ──\n\n  /** Update cursor/hasMore only (backward-compatible, does NOT affect items). */\n  setResult(result: { hasMore: boolean; cursor?: string | null }): void {\n    this._hasMore = result.hasMore;\n    this._cursor = result.cursor ?? null;\n    this.notify();\n  }\n\n  /** Append page items and update cursor/hasMore. */\n  appendPage(page: FeedPage<T>): void {\n    this._items = Object.freeze([...this._items, ...page.items]);\n    this._hasMore = page.hasMore;\n    this._cursor = page.cursor ?? null;\n    this.notify();\n  }\n\n  /** Prepend page items and update cursor/hasMore. */\n  prependPage(page: FeedPage<T>): void {\n    this._items = Object.freeze([...page.items, ...this._items]);\n    this._hasMore = page.hasMore;\n    this._cursor = page.cursor ?? null;\n    this.notify();\n  }\n\n  /** Add items without affecting cursor/hasMore. */\n  push(...items: T[]): void {\n    if (items.length === 0) return;\n    this._items = Object.freeze([...this._items, ...items]);\n    this.notify();\n  }\n\n  /** Remove items that don't match the predicate. No-op if nothing is filtered out. */\n  filter(predicate: (item: T) => boolean): void {\n    const filtered = this._items.filter(predicate);\n    if (filtered.length === this._items.length) return;\n    this._items = Object.freeze(filtered);\n    this.notify();\n  }\n\n  /** Replace all items and update cursor/hasMore atomically. Ideal for pull-to-refresh. */\n  replacePage(page: FeedPage<T>): void {\n    this._items = Object.freeze([...page.items]);\n    this._hasMore = page.hasMore;\n    this._cursor = page.cursor ?? null;\n    this.notify();\n  }\n\n  /** Reset to initial empty state with hasMore=true. */\n  reset(): void {\n    this._cursor = null;\n    this._hasMore = true;\n    this._items = Object.freeze([] as T[]);\n    this.notify();\n  }\n}\n"],"names":["Trackable"],"mappings":";;;AAcO,MAAM,aAA0BA,UAAAA,UAAU;AAAA,EACvC,UAAyB;AAAA,EACzB,WAAoB;AAAA,EACpB,SAAuB,OAAO,OAAO,EAAS;AAAA,EAEtD,cAAc;AACZ,UAAA;AAAA,EACF;AAAA;AAAA;AAAA,EAKA,IAAI,SAAwB;AAC1B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,UAAmB;AACrB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,QAAsB;AACxB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,QAAgB;AAClB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA;AAAA;AAAA,EAKA,UAAU,QAA4D;AACpE,SAAK,WAAW,OAAO;AACvB,SAAK,UAAU,OAAO,UAAU;AAChC,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,WAAW,MAAyB;AAClC,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,GAAG,KAAK,KAAK,CAAC;AAC3D,SAAK,WAAW,KAAK;AACrB,SAAK,UAAU,KAAK,UAAU;AAC9B,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,YAAY,MAAyB;AACnC,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,OAAO,GAAG,KAAK,MAAM,CAAC;AAC3D,SAAK,WAAW,KAAK;AACrB,SAAK,UAAU,KAAK,UAAU;AAC9B,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,QAAQ,OAAkB;AACxB,QAAI,MAAM,WAAW,EAAG;AACxB,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,GAAG,KAAK,CAAC;AACtD,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,OAAO,WAAuC;AAC5C,UAAM,WAAW,KAAK,OAAO,OAAO,SAAS;AAC7C,QAAI,SAAS,WAAW,KAAK,OAAO,OAAQ;AAC5C,SAAK,SAAS,OAAO,OAAO,QAAQ;AACpC,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,YAAY,MAAyB;AACnC,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,KAAK,CAAC;AAC3C,SAAK,WAAW,KAAK;AACrB,SAAK,UAAU,KAAK,UAAU;AAC9B,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,UAAU;AACf,SAAK,WAAW;AAChB,SAAK,SAAS,OAAO,OAAO,CAAA,CAAS;AACrC,SAAK,OAAA;AAAA,EACP;AACF;;"}

package/dist/Feed.d.ts

@@ -1,3 +1,4 @@
+import { Trackable } from './Trackable';
 /** Represents a page of items from a paginated API response. */
 export interface FeedPage<T> {
     items: T[];
@@ -9,11 +10,10 @@ export interface FeedPage<T> {
  * Accumulates items across pages, tracks cursor position and hasMore flag.
  * Subscribable — auto-tracked when used as a ViewModel property.
  */
-export declare class Feed<T = unknown> {
+export declare class Feed<T = unknown> extends Trackable {
     private _cursor;
     private _hasMore;
     private _items;
-    private _listeners;
     constructor();
     /** Current cursor position for the next page fetch, or null if at the beginning. */
     get cursor(): string | null;
@@ -40,8 +40,5 @@ export declare class Feed<T = unknown> {
     replacePage(page: FeedPage<T>): void;
     /** Reset to initial empty state with hasMore=true. */
     reset(): void;
-    /** Subscribe to feed state changes. Returns an unsubscribe function. */
-    subscribe(cb: () => void): () => void;
-    private _notify;
 }
 //# sourceMappingURL=Feed.d.ts.map

package/dist/Feed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Feed.d.ts","sourceRoot":"","sources":["../src/Feed.ts"],"names":[],"mappings":"AAEA,gEAAgE;AAChE,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,IAAI,CAAC,CAAC,GAAG,OAAO;IAC3B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,UAAU,CAAyB;;IAQ3C,oFAAoF;IACpF,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED,wDAAwD;IACxD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,iDAAiD;IACjD,IAAI,KAAK,IAAI,SAAS,CAAC,EAAE,CAExB;IAED,yCAAyC;IACzC,IAAI,KAAK,IAAI,MAAM,CAElB;IAID,+EAA+E;IAC/E,SAAS,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI;IAMrE,mDAAmD;IACnD,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAOnC,oDAAoD;IACpD,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAOpC,kDAAkD;IAClD,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAMzB,qFAAqF;IACrF,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI;IAO7C,yFAAyF;IACzF,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAOpC,sDAAsD;IACtD,KAAK,IAAI,IAAI;IASb,wEAAwE;IACxE,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKrC,OAAO,CAAC,OAAO;CAGhB"}
+{"version":3,"file":"Feed.d.ts","sourceRoot":"","sources":["../src/Feed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,gEAAgE;AAChE,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,IAAI,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,SAAS;IAC9C,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,MAAM,CAA0C;;IAQxD,oFAAoF;IACpF,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED,wDAAwD;IACxD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,iDAAiD;IACjD,IAAI,KAAK,IAAI,SAAS,CAAC,EAAE,CAExB;IAED,yCAAyC;IACzC,IAAI,KAAK,IAAI,MAAM,CAElB;IAID,+EAA+E;IAC/E,SAAS,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI;IAMrE,mDAAmD;IACnD,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAOnC,oDAAoD;IACpD,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAOpC,kDAAkD;IAClD,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAMzB,qFAAqF;IACrF,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI;IAO7C,yFAAyF;IACzF,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAOpC,sDAAsD;IACtD,KAAK,IAAI,IAAI;CAMd"}

package/dist/Feed.js

@@ -1,11 +1,10 @@
-import { bindPublicMethods } from "./bindPublicMethods.js";
-class Feed {
+import { Trackable } from "./Trackable.js";
+class Feed extends Trackable {
   _cursor = null;
   _hasMore = true;
   _items = Object.freeze([]);
-  _listeners = /* @__PURE__ */ new Set();
   constructor() {
-    bindPublicMethods(this);
+    super();
   }
   // ── Readable state ──
   /** Current cursor position for the next page fetch, or null if at the beginning. */
@@ -29,59 +28,48 @@ class Feed {
   setResult(result) {
     this._hasMore = result.hasMore;
     this._cursor = result.cursor ?? null;
-    this._notify();
+    this.notify();
   }
   /** Append page items and update cursor/hasMore. */
   appendPage(page) {
     this._items = Object.freeze([...this._items, ...page.items]);
     this._hasMore = page.hasMore;
     this._cursor = page.cursor ?? null;
-    this._notify();
+    this.notify();
   }
   /** Prepend page items and update cursor/hasMore. */
   prependPage(page) {
     this._items = Object.freeze([...page.items, ...this._items]);
     this._hasMore = page.hasMore;
     this._cursor = page.cursor ?? null;
-    this._notify();
+    this.notify();
   }
   /** Add items without affecting cursor/hasMore. */
   push(...items) {
     if (items.length === 0) return;
     this._items = Object.freeze([...this._items, ...items]);
-    this._notify();
+    this.notify();
   }
   /** Remove items that don't match the predicate. No-op if nothing is filtered out. */
   filter(predicate) {
     const filtered = this._items.filter(predicate);
     if (filtered.length === this._items.length) return;
     this._items = Object.freeze(filtered);
-    this._notify();
+    this.notify();
   }
   /** Replace all items and update cursor/hasMore atomically. Ideal for pull-to-refresh. */
   replacePage(page) {
     this._items = Object.freeze([...page.items]);
     this._hasMore = page.hasMore;
     this._cursor = page.cursor ?? null;
-    this._notify();
+    this.notify();
   }
   /** Reset to initial empty state with hasMore=true. */
   reset() {
     this._cursor = null;
     this._hasMore = true;
     this._items = Object.freeze([]);
-    this._notify();
-  }
-  // ── Subscribable interface ──
-  /** Subscribe to feed state changes. Returns an unsubscribe function. */
-  subscribe(cb) {
-    this._listeners.add(cb);
-    return () => {
-      this._listeners.delete(cb);
-    };
-  }
-  _notify() {
-    for (const cb of this._listeners) cb();
+    this.notify();
   }
 }
 export {

package/dist/Feed.js.map

@@ -1 +1 @@
-{"version":3,"file":"Feed.js","sources":["../src/Feed.ts"],"sourcesContent":["import { bindPublicMethods } from './bindPublicMethods';\n\n/** Represents a page of items from a paginated API response. */\nexport interface FeedPage<T> {\n  items: T[];\n  hasMore: boolean;\n  cursor?: string | null;\n}\n\n/**\n * Cursor-based pagination state for server-side paginated feeds.\n * Accumulates items across pages, tracks cursor position and hasMore flag.\n * Subscribable — auto-tracked when used as a ViewModel property.\n */\nexport class Feed<T = unknown> {\n  private _cursor: string | null = null;\n  private _hasMore: boolean = true;\n  private _items: readonly T[] = Object.freeze([] as T[]);\n  private _listeners = new Set<() => void>();\n\n  constructor() {\n    bindPublicMethods(this);\n  }\n\n  // ── Readable state ──\n\n  /** Current cursor position for the next page fetch, or null if at the beginning. */\n  get cursor(): string | null {\n    return this._cursor;\n  }\n\n  /** Whether more pages are available from the server. */\n  get hasMore(): boolean {\n    return this._hasMore;\n  }\n\n  /** Accumulated items across all loaded pages. */\n  get items(): readonly T[] {\n    return this._items;\n  }\n\n  /** Total number of accumulated items. */\n  get count(): number {\n    return this._items.length;\n  }\n\n  // ── Actions ──\n\n  /** Update cursor/hasMore only (backward-compatible, does NOT affect items). */\n  setResult(result: { hasMore: boolean; cursor?: string | null }): void {\n    this._hasMore = result.hasMore;\n    this._cursor = result.cursor ?? null;\n    this._notify();\n  }\n\n  /** Append page items and update cursor/hasMore. */\n  appendPage(page: FeedPage<T>): void {\n    this._items = Object.freeze([...this._items, ...page.items]);\n    this._hasMore = page.hasMore;\n    this._cursor = page.cursor ?? null;\n    this._notify();\n  }\n\n  /** Prepend page items and update cursor/hasMore. */\n  prependPage(page: FeedPage<T>): void {\n    this._items = Object.freeze([...page.items, ...this._items]);\n    this._hasMore = page.hasMore;\n    this._cursor = page.cursor ?? null;\n    this._notify();\n  }\n\n  /** Add items without affecting cursor/hasMore. */\n  push(...items: T[]): void {\n    if (items.length === 0) return;\n    this._items = Object.freeze([...this._items, ...items]);\n    this._notify();\n  }\n\n  /** Remove items that don't match the predicate. No-op if nothing is filtered out. */\n  filter(predicate: (item: T) => boolean): void {\n    const filtered = this._items.filter(predicate);\n    if (filtered.length === this._items.length) return;\n    this._items = Object.freeze(filtered);\n    this._notify();\n  }\n\n  /** Replace all items and update cursor/hasMore atomically. Ideal for pull-to-refresh. */\n  replacePage(page: FeedPage<T>): void {\n    this._items = Object.freeze([...page.items]);\n    this._hasMore = page.hasMore;\n    this._cursor = page.cursor ?? null;\n    this._notify();\n  }\n\n  /** Reset to initial empty state with hasMore=true. */\n  reset(): void {\n    this._cursor = null;\n    this._hasMore = true;\n    this._items = Object.freeze([] as T[]);\n    this._notify();\n  }\n\n  // ── Subscribable interface ──\n\n  /** Subscribe to feed state changes. Returns an unsubscribe function. */\n  subscribe(cb: () => void): () => void {\n    this._listeners.add(cb);\n    return () => { this._listeners.delete(cb); };\n  }\n\n  private _notify(): void {\n    for (const cb of this._listeners) cb();\n  }\n}\n"],"names":[],"mappings":";AAcO,MAAM,KAAkB;AAAA,EACrB,UAAyB;AAAA,EACzB,WAAoB;AAAA,EACpB,SAAuB,OAAO,OAAO,EAAS;AAAA,EAC9C,iCAAiB,IAAA;AAAA,EAEzB,cAAc;AACZ,sBAAkB,IAAI;AAAA,EACxB;AAAA;AAAA;AAAA,EAKA,IAAI,SAAwB;AAC1B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,UAAmB;AACrB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,QAAsB;AACxB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,QAAgB;AAClB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA;AAAA;AAAA,EAKA,UAAU,QAA4D;AACpE,SAAK,WAAW,OAAO;AACvB,SAAK,UAAU,OAAO,UAAU;AAChC,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,WAAW,MAAyB;AAClC,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,GAAG,KAAK,KAAK,CAAC;AAC3D,SAAK,WAAW,KAAK;AACrB,SAAK,UAAU,KAAK,UAAU;AAC9B,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,YAAY,MAAyB;AACnC,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,OAAO,GAAG,KAAK,MAAM,CAAC;AAC3D,SAAK,WAAW,KAAK;AACrB,SAAK,UAAU,KAAK,UAAU;AAC9B,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,QAAQ,OAAkB;AACxB,QAAI,MAAM,WAAW,EAAG;AACxB,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,GAAG,KAAK,CAAC;AACtD,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,OAAO,WAAuC;AAC5C,UAAM,WAAW,KAAK,OAAO,OAAO,SAAS;AAC7C,QAAI,SAAS,WAAW,KAAK,OAAO,OAAQ;AAC5C,SAAK,SAAS,OAAO,OAAO,QAAQ;AACpC,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,YAAY,MAAyB;AACnC,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,KAAK,CAAC;AAC3C,SAAK,WAAW,KAAK;AACrB,SAAK,UAAU,KAAK,UAAU;AAC9B,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,UAAU;AACf,SAAK,WAAW;AAChB,SAAK,SAAS,OAAO,OAAO,CAAA,CAAS;AACrC,SAAK,QAAA;AAAA,EACP;AAAA;AAAA;AAAA,EAKA,UAAU,IAA4B;AACpC,SAAK,WAAW,IAAI,EAAE;AACtB,WAAO,MAAM;AAAE,WAAK,WAAW,OAAO,EAAE;AAAA,IAAG;AAAA,EAC7C;AAAA,EAEQ,UAAgB;AACtB,eAAW,MAAM,KAAK,WAAY,IAAA;AAAA,EACpC;AACF;"}
+{"version":3,"file":"Feed.js","sources":["../src/Feed.ts"],"sourcesContent":["import { Trackable } from './Trackable';\n\n/** Represents a page of items from a paginated API response. */\nexport interface FeedPage<T> {\n  items: T[];\n  hasMore: boolean;\n  cursor?: string | null;\n}\n\n/**\n * Cursor-based pagination state for server-side paginated feeds.\n * Accumulates items across pages, tracks cursor position and hasMore flag.\n * Subscribable — auto-tracked when used as a ViewModel property.\n */\nexport class Feed<T = unknown> extends Trackable {\n  private _cursor: string | null = null;\n  private _hasMore: boolean = true;\n  private _items: readonly T[] = Object.freeze([] as T[]);\n\n  constructor() {\n    super();\n  }\n\n  // ── Readable state ──\n\n  /** Current cursor position for the next page fetch, or null if at the beginning. */\n  get cursor(): string | null {\n    return this._cursor;\n  }\n\n  /** Whether more pages are available from the server. */\n  get hasMore(): boolean {\n    return this._hasMore;\n  }\n\n  /** Accumulated items across all loaded pages. */\n  get items(): readonly T[] {\n    return this._items;\n  }\n\n  /** Total number of accumulated items. */\n  get count(): number {\n    return this._items.length;\n  }\n\n  // ── Actions ──\n\n  /** Update cursor/hasMore only (backward-compatible, does NOT affect items). */\n  setResult(result: { hasMore: boolean; cursor?: string | null }): void {\n    this._hasMore = result.hasMore;\n    this._cursor = result.cursor ?? null;\n    this.notify();\n  }\n\n  /** Append page items and update cursor/hasMore. */\n  appendPage(page: FeedPage<T>): void {\n    this._items = Object.freeze([...this._items, ...page.items]);\n    this._hasMore = page.hasMore;\n    this._cursor = page.cursor ?? null;\n    this.notify();\n  }\n\n  /** Prepend page items and update cursor/hasMore. */\n  prependPage(page: FeedPage<T>): void {\n    this._items = Object.freeze([...page.items, ...this._items]);\n    this._hasMore = page.hasMore;\n    this._cursor = page.cursor ?? null;\n    this.notify();\n  }\n\n  /** Add items without affecting cursor/hasMore. */\n  push(...items: T[]): void {\n    if (items.length === 0) return;\n    this._items = Object.freeze([...this._items, ...items]);\n    this.notify();\n  }\n\n  /** Remove items that don't match the predicate. No-op if nothing is filtered out. */\n  filter(predicate: (item: T) => boolean): void {\n    const filtered = this._items.filter(predicate);\n    if (filtered.length === this._items.length) return;\n    this._items = Object.freeze(filtered);\n    this.notify();\n  }\n\n  /** Replace all items and update cursor/hasMore atomically. Ideal for pull-to-refresh. */\n  replacePage(page: FeedPage<T>): void {\n    this._items = Object.freeze([...page.items]);\n    this._hasMore = page.hasMore;\n    this._cursor = page.cursor ?? null;\n    this.notify();\n  }\n\n  /** Reset to initial empty state with hasMore=true. */\n  reset(): void {\n    this._cursor = null;\n    this._hasMore = true;\n    this._items = Object.freeze([] as T[]);\n    this.notify();\n  }\n}\n"],"names":[],"mappings":";AAcO,MAAM,aAA0B,UAAU;AAAA,EACvC,UAAyB;AAAA,EACzB,WAAoB;AAAA,EACpB,SAAuB,OAAO,OAAO,EAAS;AAAA,EAEtD,cAAc;AACZ,UAAA;AAAA,EACF;AAAA;AAAA;AAAA,EAKA,IAAI,SAAwB;AAC1B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,UAAmB;AACrB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,QAAsB;AACxB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,QAAgB;AAClB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA;AAAA;AAAA,EAKA,UAAU,QAA4D;AACpE,SAAK,WAAW,OAAO;AACvB,SAAK,UAAU,OAAO,UAAU;AAChC,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,WAAW,MAAyB;AAClC,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,GAAG,KAAK,KAAK,CAAC;AAC3D,SAAK,WAAW,KAAK;AACrB,SAAK,UAAU,KAAK,UAAU;AAC9B,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,YAAY,MAAyB;AACnC,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,OAAO,GAAG,KAAK,MAAM,CAAC;AAC3D,SAAK,WAAW,KAAK;AACrB,SAAK,UAAU,KAAK,UAAU;AAC9B,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,QAAQ,OAAkB;AACxB,QAAI,MAAM,WAAW,EAAG;AACxB,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,GAAG,KAAK,CAAC;AACtD,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,OAAO,WAAuC;AAC5C,UAAM,WAAW,KAAK,OAAO,OAAO,SAAS;AAC7C,QAAI,SAAS,WAAW,KAAK,OAAO,OAAQ;AAC5C,SAAK,SAAS,OAAO,OAAO,QAAQ;AACpC,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,YAAY,MAAyB;AACnC,SAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,KAAK,CAAC;AAC3C,SAAK,WAAW,KAAK;AACrB,SAAK,UAAU,KAAK,UAAU;AAC9B,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,UAAU;AACf,SAAK,WAAW;AAChB,SAAK,SAAS,OAAO,OAAO,CAAA,CAAS;AACrC,SAAK,OAAA;AAAA,EACP;AACF;"}

package/dist/Pagination.cjs

@@ -1,13 +1,12 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const bindPublicMethods = require("./bindPublicMethods.cjs");
-class Pagination {
+const Trackable = require("./Trackable.cjs");
+class Pagination extends Trackable.Trackable {
   _page = 1;
   _pageSize;
-  _listeners = /* @__PURE__ */ new Set();
   constructor(options) {
+    super();
     this._pageSize = options?.pageSize ?? 10;
-    bindPublicMethods.bindPublicMethods(this);
   }
   // ── Readable state ──
   /** Current page number (1-based). */
@@ -37,32 +36,32 @@ class Pagination {
     const clamped = Math.max(1, Math.floor(page));
     if (clamped === this._page) return;
     this._page = clamped;
-    this._notify();
+    this.notify();
   }
   /** Change the page size and reset to page 1. */
   setPageSize(size) {
     if (size < 1) return;
     this._pageSize = size;
     this._page = 1;
-    this._notify();
+    this.notify();
   }
   /** Advance to the next page. */
   nextPage() {
     this._page++;
-    this._notify();
+    this.notify();
   }
   /** Go back to the previous page. No-op if already on page 1. */
   prevPage() {
     if (this._page > 1) {
       this._page--;
-      this._notify();
+      this.notify();
     }
   }
   /** Reset to page 1. */
   reset() {
     if (this._page === 1) return;
     this._page = 1;
-    this._notify();
+    this.notify();
   }
   // ── Pipeline ──
   /** Slice an array to the current page window. Returns the page subset. */
@@ -70,17 +69,6 @@ class Pagination {
     const start = (this._page - 1) * this._pageSize;
     return items.slice(start, start + this._pageSize);
   }
-  // ── Subscribable interface ──
-  /** Subscribe to pagination state changes. Returns an unsubscribe function. */
-  subscribe(cb) {
-    this._listeners.add(cb);
-    return () => {
-      this._listeners.delete(cb);
-    };
-  }
-  _notify() {
-    for (const cb of this._listeners) cb();
-  }
 }
 exports.Pagination = Pagination;
 //# sourceMappingURL=Pagination.cjs.map

package/dist/Pagination.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Pagination.cjs","sources":["../src/Pagination.ts"],"sourcesContent":["import { bindPublicMethods } from './bindPublicMethods';\n\n/**\n * Page-based pagination state manager with array slicing pipeline.\n * Tracks current page and page size, provides navigation helpers.\n * Subscribable — auto-tracked when used as a ViewModel property.\n */\nexport class Pagination {\n  private _page: number = 1;\n  private _pageSize: number;\n  private _listeners = new Set<() => void>();\n\n  constructor(options?: { pageSize?: number }) {\n    this._pageSize = options?.pageSize ?? 10;\n    bindPublicMethods(this);\n  }\n\n  // ── Readable state ──\n\n  /** Current page number (1-based). */\n  get page(): number {\n    return this._page;\n  }\n\n  /** Number of items per page. */\n  get pageSize(): number {\n    return this._pageSize;\n  }\n\n  // ── Derived (require total) ──\n\n  /** Total number of pages for the given item count. */\n  pageCount(total: number): number {\n    return Math.max(1, Math.ceil(total / this._pageSize));\n  }\n\n  /** Whether there is a next page available. */\n  hasNext(total: number): boolean {\n    return this._page < this.pageCount(total);\n  }\n\n  /** Whether there is a previous page available. */\n  hasPrev(): boolean {\n    return this._page > 1;\n  }\n\n  // ── Actions ──\n\n  /** Navigate to a specific page (clamped to >= 1). */\n  setPage(page: number): void {\n    const clamped = Math.max(1, Math.floor(page));\n    if (clamped === this._page) return;\n    this._page = clamped;\n    this._notify();\n  }\n\n  /** Change the page size and reset to page 1. */\n  setPageSize(size: number): void {\n    if (size < 1) return;\n    this._pageSize = size;\n    this._page = 1;\n    this._notify();\n  }\n\n  /** Advance to the next page. */\n  nextPage(): void {\n    this._page++;\n    this._notify();\n  }\n\n  /** Go back to the previous page. No-op if already on page 1. */\n  prevPage(): void {\n    if (this._page > 1) {\n      this._page--;\n      this._notify();\n    }\n  }\n\n  /** Reset to page 1. */\n  reset(): void {\n    if (this._page === 1) return;\n    this._page = 1;\n    this._notify();\n  }\n\n  // ── Pipeline ──\n\n  /** Slice an array to the current page window. Returns the page subset. */\n  apply<T>(items: T[]): T[] {\n    const start = (this._page - 1) * this._pageSize;\n    return items.slice(start, start + this._pageSize);\n  }\n\n  // ── Subscribable interface ──\n\n  /** Subscribe to pagination state changes. Returns an unsubscribe function. */\n  subscribe(cb: () => void): () => void {\n    this._listeners.add(cb);\n    return () => { this._listeners.delete(cb); };\n  }\n\n  private _notify(): void {\n    for (const cb of this._listeners) cb();\n  }\n}\n"],"names":["bindPublicMethods"],"mappings":";;;AAOO,MAAM,WAAW;AAAA,EACd,QAAgB;AAAA,EAChB;AAAA,EACA,iCAAiB,IAAA;AAAA,EAEzB,YAAY,SAAiC;AAC3C,SAAK,YAAY,SAAS,YAAY;AACtCA,sBAAAA,kBAAkB,IAAI;AAAA,EACxB;AAAA;AAAA;AAAA,EAKA,IAAI,OAAe;AACjB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,WAAmB;AACrB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA,EAKA,UAAU,OAAuB;AAC/B,WAAO,KAAK,IAAI,GAAG,KAAK,KAAK,QAAQ,KAAK,SAAS,CAAC;AAAA,EACtD;AAAA;AAAA,EAGA,QAAQ,OAAwB;AAC9B,WAAO,KAAK,QAAQ,KAAK,UAAU,KAAK;AAAA,EAC1C;AAAA;AAAA,EAGA,UAAmB;AACjB,WAAO,KAAK,QAAQ;AAAA,EACtB;AAAA;AAAA;AAAA,EAKA,QAAQ,MAAoB;AAC1B,UAAM,UAAU,KAAK,IAAI,GAAG,KAAK,MAAM,IAAI,CAAC;AAC5C,QAAI,YAAY,KAAK,MAAO;AAC5B,SAAK,QAAQ;AACb,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,YAAY,MAAoB;AAC9B,QAAI,OAAO,EAAG;AACd,SAAK,YAAY;AACjB,SAAK,QAAQ;AACb,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,WAAiB;AACf,SAAK;AACL,SAAK,QAAA;AAAA,EACP;AAAA;AAAA,EAGA,WAAiB;AACf,QAAI,KAAK,QAAQ,GAAG;AAClB,WAAK;AACL,WAAK,QAAA;AAAA,IACP;AAAA,EACF;AAAA;AAAA,EAGA,QAAc;AACZ,QAAI,KAAK,UAAU,EAAG;AACtB,SAAK,QAAQ;AACb,SAAK,QAAA;AAAA,EACP;AAAA;AAAA;AAAA,EAKA,MAAS,OAAiB;AACxB,UAAM,SAAS,KAAK,QAAQ,KAAK,KAAK;AACtC,WAAO,MAAM,MAAM,OAAO,QAAQ,KAAK,SAAS;AAAA,EAClD;AAAA;AAAA;AAAA,EAKA,UAAU,IAA4B;AACpC,SAAK,WAAW,IAAI,EAAE;AACtB,WAAO,MAAM;AAAE,WAAK,WAAW,OAAO,EAAE;AAAA,IAAG;AAAA,EAC7C;AAAA,EAEQ,UAAgB;AACtB,eAAW,MAAM,KAAK,WAAY,IAAA;AAAA,EACpC;AACF;;"}
+{"version":3,"file":"Pagination.cjs","sources":["../src/Pagination.ts"],"sourcesContent":["import { Trackable } from './Trackable';\n\n/**\n * Page-based pagination state manager with array slicing pipeline.\n * Tracks current page and page size, provides navigation helpers.\n * Subscribable — auto-tracked when used as a ViewModel property.\n */\nexport class Pagination extends Trackable {\n  private _page: number = 1;\n  private _pageSize: number;\n\n  constructor(options?: { pageSize?: number }) {\n    super();\n    this._pageSize = options?.pageSize ?? 10;\n  }\n\n  // ── Readable state ──\n\n  /** Current page number (1-based). */\n  get page(): number {\n    return this._page;\n  }\n\n  /** Number of items per page. */\n  get pageSize(): number {\n    return this._pageSize;\n  }\n\n  // ── Derived (require total) ──\n\n  /** Total number of pages for the given item count. */\n  pageCount(total: number): number {\n    return Math.max(1, Math.ceil(total / this._pageSize));\n  }\n\n  /** Whether there is a next page available. */\n  hasNext(total: number): boolean {\n    return this._page < this.pageCount(total);\n  }\n\n  /** Whether there is a previous page available. */\n  hasPrev(): boolean {\n    return this._page > 1;\n  }\n\n  // ── Actions ──\n\n  /** Navigate to a specific page (clamped to >= 1). */\n  setPage(page: number): void {\n    const clamped = Math.max(1, Math.floor(page));\n    if (clamped === this._page) return;\n    this._page = clamped;\n    this.notify();\n  }\n\n  /** Change the page size and reset to page 1. */\n  setPageSize(size: number): void {\n    if (size < 1) return;\n    this._pageSize = size;\n    this._page = 1;\n    this.notify();\n  }\n\n  /** Advance to the next page. */\n  nextPage(): void {\n    this._page++;\n    this.notify();\n  }\n\n  /** Go back to the previous page. No-op if already on page 1. */\n  prevPage(): void {\n    if (this._page > 1) {\n      this._page--;\n      this.notify();\n    }\n  }\n\n  /** Reset to page 1. */\n  reset(): void {\n    if (this._page === 1) return;\n    this._page = 1;\n    this.notify();\n  }\n\n  // ── Pipeline ──\n\n  /** Slice an array to the current page window. Returns the page subset. */\n  apply<T>(items: T[]): T[] {\n    const start = (this._page - 1) * this._pageSize;\n    return items.slice(start, start + this._pageSize);\n  }\n}\n"],"names":["Trackable"],"mappings":";;;AAOO,MAAM,mBAAmBA,UAAAA,UAAU;AAAA,EAChC,QAAgB;AAAA,EAChB;AAAA,EAER,YAAY,SAAiC;AAC3C,UAAA;AACA,SAAK,YAAY,SAAS,YAAY;AAAA,EACxC;AAAA;AAAA;AAAA,EAKA,IAAI,OAAe;AACjB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,WAAmB;AACrB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA,EAKA,UAAU,OAAuB;AAC/B,WAAO,KAAK,IAAI,GAAG,KAAK,KAAK,QAAQ,KAAK,SAAS,CAAC;AAAA,EACtD;AAAA;AAAA,EAGA,QAAQ,OAAwB;AAC9B,WAAO,KAAK,QAAQ,KAAK,UAAU,KAAK;AAAA,EAC1C;AAAA;AAAA,EAGA,UAAmB;AACjB,WAAO,KAAK,QAAQ;AAAA,EACtB;AAAA;AAAA;AAAA,EAKA,QAAQ,MAAoB;AAC1B,UAAM,UAAU,KAAK,IAAI,GAAG,KAAK,MAAM,IAAI,CAAC;AAC5C,QAAI,YAAY,KAAK,MAAO;AAC5B,SAAK,QAAQ;AACb,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,YAAY,MAAoB;AAC9B,QAAI,OAAO,EAAG;AACd,SAAK,YAAY;AACjB,SAAK,QAAQ;AACb,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,WAAiB;AACf,SAAK;AACL,SAAK,OAAA;AAAA,EACP;AAAA;AAAA,EAGA,WAAiB;AACf,QAAI,KAAK,QAAQ,GAAG;AAClB,WAAK;AACL,WAAK,OAAA;AAAA,IACP;AAAA,EACF;AAAA;AAAA,EAGA,QAAc;AACZ,QAAI,KAAK,UAAU,EAAG;AACtB,SAAK,QAAQ;AACb,SAAK,OAAA;AAAA,EACP;AAAA;AAAA;AAAA,EAKA,MAAS,OAAiB;AACxB,UAAM,SAAS,KAAK,QAAQ,KAAK,KAAK;AACtC,WAAO,MAAM,MAAM,OAAO,QAAQ,KAAK,SAAS;AAAA,EAClD;AACF;;"}

package/dist/Pagination.d.ts

@@ -1,12 +1,12 @@
+import { Trackable } from './Trackable';
 /**
  * Page-based pagination state manager with array slicing pipeline.
  * Tracks current page and page size, provides navigation helpers.
  * Subscribable — auto-tracked when used as a ViewModel property.
  */
-export declare class Pagination {
+export declare class Pagination extends Trackable {
     private _page;
     private _pageSize;
-    private _listeners;
     constructor(options?: {
         pageSize?: number;
     });
@@ -32,8 +32,5 @@ export declare class Pagination {
     reset(): void;
     /** Slice an array to the current page window. Returns the page subset. */
     apply<T>(items: T[]): T[];
-    /** Subscribe to pagination state changes. Returns an unsubscribe function. */
-    subscribe(cb: () => void): () => void;
-    private _notify;
 }
 //# sourceMappingURL=Pagination.d.ts.map