mvc-kit 2.7.1 → 2.9.0

package/dist/Feed.cjs

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+class Feed {
+  _cursor = null;
+  _hasMore = true;
+  _items = Object.freeze([]);
+  _listeners = /* @__PURE__ */ new Set();
+  // ── Readable state ──
+  /** Current cursor position for the next page fetch, or null if at the beginning. */
+  get cursor() {
+    return this._cursor;
+  }
+  /** Whether more pages are available from the server. */
+  get hasMore() {
+    return this._hasMore;
+  }
+  /** Accumulated items across all loaded pages. */
+  get items() {
+    return this._items;
+  }
+  /** Total number of accumulated items. */
+  get count() {
+    return this._items.length;
+  }
+  // ── Actions ──
+  /** Update cursor/hasMore only (backward-compatible, does NOT affect items). */
+  setResult(result) {
+    this._hasMore = result.hasMore;
+    this._cursor = result.cursor ?? null;
+    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();
+  }
+  /** 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();
+  }
+  /** Add items without affecting cursor/hasMore. */
+  push(...items) {
+    if (items.length === 0) return;
+    this._items = Object.freeze([...this._items, ...items]);
+    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();
+  }
+  /** 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();
+  }
+  /** 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();
+  }
+}
+exports.Feed = Feed;
+//# sourceMappingURL=Feed.cjs.map

package/dist/Feed.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Feed.cjs","sources":["../src/Feed.ts"],"sourcesContent":["/** 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  // ── 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":";;AAYO,MAAM,KAAkB;AAAA,EACrB,UAAyB;AAAA,EACzB,WAAoB;AAAA,EACpB,SAAuB,OAAO,OAAO,EAAS;AAAA,EAC9C,iCAAiB,IAAA;AAAA;AAAA;AAAA,EAKzB,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;;"}

package/dist/Feed.d.ts

@@ -0,0 +1,46 @@
+/** Represents a page of items from a paginated API response. */
+export interface FeedPage<T> {
+    items: T[];
+    hasMore: boolean;
+    cursor?: string | null;
+}
+/**
+ * Cursor-based pagination state for server-side paginated feeds.
+ * 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> {
+    private _cursor;
+    private _hasMore;
+    private _items;
+    private _listeners;
+    /** Current cursor position for the next page fetch, or null if at the beginning. */
+    get cursor(): string | null;
+    /** Whether more pages are available from the server. */
+    get hasMore(): boolean;
+    /** Accumulated items across all loaded pages. */
+    get items(): readonly T[];
+    /** Total number of accumulated items. */
+    get count(): number;
+    /** Update cursor/hasMore only (backward-compatible, does NOT affect items). */
+    setResult(result: {
+        hasMore: boolean;
+        cursor?: string | null;
+    }): void;
+    /** Append page items and update cursor/hasMore. */
+    appendPage(page: FeedPage<T>): void;
+    /** Prepend page items and update cursor/hasMore. */
+    prependPage(page: FeedPage<T>): void;
+    /** Add items without affecting cursor/hasMore. */
+    push(...items: T[]): void;
+    /** Remove items that don't match the predicate. No-op if nothing is filtered out. */
+    filter(predicate: (item: T) => boolean): void;
+    /** Replace all items and update cursor/hasMore atomically. Ideal for pull-to-refresh. */
+    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

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

package/dist/Feed.js

@@ -0,0 +1,86 @@
+class Feed {
+  _cursor = null;
+  _hasMore = true;
+  _items = Object.freeze([]);
+  _listeners = /* @__PURE__ */ new Set();
+  // ── Readable state ──
+  /** Current cursor position for the next page fetch, or null if at the beginning. */
+  get cursor() {
+    return this._cursor;
+  }
+  /** Whether more pages are available from the server. */
+  get hasMore() {
+    return this._hasMore;
+  }
+  /** Accumulated items across all loaded pages. */
+  get items() {
+    return this._items;
+  }
+  /** Total number of accumulated items. */
+  get count() {
+    return this._items.length;
+  }
+  // ── Actions ──
+  /** Update cursor/hasMore only (backward-compatible, does NOT affect items). */
+  setResult(result) {
+    this._hasMore = result.hasMore;
+    this._cursor = result.cursor ?? null;
+    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();
+  }
+  /** 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();
+  }
+  /** Add items without affecting cursor/hasMore. */
+  push(...items) {
+    if (items.length === 0) return;
+    this._items = Object.freeze([...this._items, ...items]);
+    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();
+  }
+  /** 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();
+  }
+  /** 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();
+  }
+}
+export {
+  Feed
+};
+//# sourceMappingURL=Feed.js.map

package/dist/Feed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Feed.js","sources":["../src/Feed.ts"],"sourcesContent":["/** 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  // ── 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":"AAYO,MAAM,KAAkB;AAAA,EACrB,UAAyB;AAAA,EACzB,WAAoB;AAAA,EACpB,SAAuB,OAAO,OAAO,EAAS;AAAA,EAC9C,iCAAiB,IAAA;AAAA;AAAA;AAAA,EAKzB,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;"}

package/dist/Model.cjs

@@ -1,5 +1,9 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+function freeze(obj) {
+  return __DEV__ ? Object.freeze(obj) : obj;
+}
 class Model {
   _state;
   _committed;
@@ -8,8 +12,10 @@ class Model {
   _listeners = /* @__PURE__ */ new Set();
   _abortController = null;
   _cleanups = null;
+  _cachedDirty = null;
+  _cachedErrors = null;
   constructor(initialState) {
-    const frozen = Object.freeze({ ...initialState });
+    const frozen = freeze({ ...initialState });
     this._state = frozen;
     this._committed = frozen;
   }
@@ -27,13 +33,19 @@ class Model {
    * True if current state differs from committed state.
    */
   get dirty() {
-    return !this.shallowEqual(this._state, this._committed);
+    if (this._cachedDirty === null) {
+      this._cachedDirty = !this.shallowEqual(this._state, this._committed);
+    }
+    return this._cachedDirty;
   }
   /**
    * Validation errors for the current state.
    */
   get errors() {
-    return this.validate(this._state);
+    if (this._cachedErrors === null) {
+      this._cachedErrors = this.validate(this._state);
+    }
+    return this._cachedErrors;
   }
   /**
    * True if there are no validation errors.
@@ -79,8 +91,10 @@ class Model {
       return;
     }
     const prev = this._state;
-    const next = Object.freeze({ ...prev, ...partial });
+    const next = freeze({ ...prev, ...partial });
     this._state = next;
+    this._cachedDirty = null;
+    this._cachedErrors = null;
     this.onSet?.(prev, next);
     for (const listener of this._listeners) {
       listener(next, prev);
@@ -94,6 +108,8 @@ class Model {
       throw new Error("Cannot commit on disposed Model");
     }
     this._committed = this._state;
+    this._cachedDirty = null;
+    this._cachedErrors = null;
   }
   /**
    * Revert state to committed baseline.
@@ -107,6 +123,8 @@ class Model {
     }
     const prev = this._state;
     this._state = this._committed;
+    this._cachedDirty = null;
+    this._cachedErrors = null;
     this.onSet?.(prev, this._state);
     for (const listener of this._listeners) {
       listener(this._state, prev);

package/dist/Model.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Model.cjs","sources":["../src/Model.ts"],"sourcesContent":["import type { Listener, Updater, Subscribable, ValidationErrors, EventPayload } from './types';\n\n/**\n * Reactive entity with validation and dirty tracking.\n */\nexport abstract class Model<S extends object> implements Subscribable<S> {\n  private _state: Readonly<S>;\n  private _committed: Readonly<S>;\n  private _disposed = false;\n  private _initialized = false;\n  private _listeners = new Set<Listener<S>>();\n  private _abortController: AbortController | null = null;\n  private _cleanups: (() => void)[] | null = null;\n\n  constructor(initialState: S) {\n    const frozen = Object.freeze({ ...initialState });\n    this._state = frozen;\n    this._committed = frozen;\n  }\n\n  /** Current frozen state object. */\n  get state(): S {\n    return this._state;\n  }\n\n  /**\n   * The baseline state for dirty tracking.\n   */\n  get committed(): S {\n    return this._committed;\n  }\n\n  /**\n   * True if current state differs from committed state.\n   */\n  get dirty(): boolean {\n    return !this.shallowEqual(this._state, this._committed);\n  }\n\n  /**\n   * Validation errors for the current state.\n   */\n  get errors(): ValidationErrors<S> {\n    return this.validate(this._state);\n  }\n\n  /**\n   * True if there are no validation errors.\n   */\n  get valid(): boolean {\n    return Object.keys(this.errors).length === 0;\n  }\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /**\n   * Merges partial state with validation. No-op if no values changed by reference.\n   * @protected\n   */\n  protected set(partialOrUpdater: Partial<S> | Updater<S>): void {\n    if (this._disposed) {\n      throw new Error('Cannot set state on disposed Model');\n    }\n\n    const partial =\n      typeof partialOrUpdater === 'function'\n        ? partialOrUpdater(this._state)\n        : partialOrUpdater;\n\n    // Check if any values actually changed (shallow equality)\n    const keys = Object.keys(partial) as (keyof S)[];\n    const hasChanges = keys.some(\n      (key) => partial[key] !== this._state[key]\n    );\n\n    if (!hasChanges) {\n      return;\n    }\n\n    const prev = this._state;\n    const next = Object.freeze({ ...prev, ...partial });\n    this._state = next;\n\n    this.onSet?.(prev, next);\n\n    for (const listener of this._listeners) {\n      listener(next, prev);\n    }\n  }\n\n  /**\n   * Mark current state as the new baseline (not dirty).\n   */\n  commit(): void {\n    if (this._disposed) {\n      throw new Error('Cannot commit on disposed Model');\n    }\n    this._committed = this._state;\n  }\n\n  /**\n   * Revert state to committed baseline.\n   */\n  rollback(): void {\n    if (this._disposed) {\n      throw new Error('Cannot rollback on disposed Model');\n    }\n\n    if (this.shallowEqual(this._state, this._committed)) {\n      return;\n    }\n\n    const prev = this._state;\n    this._state = this._committed;\n\n    this.onSet?.(prev, this._state);\n\n    for (const listener of this._listeners) {\n      listener(this._state, prev);\n    }\n  }\n\n  /** Subscribes to state changes. Returns an unsubscribe function. */\n  subscribe(listener: Listener<S>): () => 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._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  }\n\n  /**\n   * Override to provide validation logic.\n   * Return an object mapping field keys to error messages.\n   */\n  protected validate(_state: S): ValidationErrors<S> {\n    return {};\n  }\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */\n  protected listenTo<K extends string, S extends { on(event: K, handler: (payload: any) => void): () => void }>(\n    source: S,\n    event: K,\n    handler: (payload: EventPayload<S, K>) => void,\n  ): () => void {\n    const unsubscribe = source.on(event, handler);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called after every set() with the previous state. @protected */\n  protected onSet?(prev: S, next: S): void;\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n\n  private shallowEqual(a: S, b: S): boolean {\n    const keysA = Object.keys(a) as (keyof S)[];\n    const keysB = Object.keys(b) as (keyof S)[];\n\n    if (keysA.length !== keysB.length) {\n      return false;\n    }\n\n    for (const key of keysA) {\n      if (a[key] !== b[key]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"Model.cjs","sources":["../src/Model.ts"],"sourcesContent":["import type { Listener, Updater, Subscribable, ValidationErrors, EventPayload } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\nfunction freeze<T>(obj: T): T {\n  return __DEV__ ? Object.freeze(obj) as T : obj;\n}\n\n/**\n * Reactive entity with validation and dirty tracking.\n */\nexport abstract class Model<S extends object> implements Subscribable<S> {\n  private _state: Readonly<S>;\n  private _committed: Readonly<S>;\n  private _disposed = false;\n  private _initialized = false;\n  private _listeners = new Set<Listener<S>>();\n  private _abortController: AbortController | null = null;\n  private _cleanups: (() => void)[] | null = null;\n  private _cachedDirty: boolean | null = null;\n  private _cachedErrors: ValidationErrors<S> | null = null;\n\n  constructor(initialState: S) {\n    const frozen = freeze({ ...initialState });\n    this._state = frozen;\n    this._committed = frozen;\n  }\n\n  /** Current frozen state object. */\n  get state(): S {\n    return this._state;\n  }\n\n  /**\n   * The baseline state for dirty tracking.\n   */\n  get committed(): S {\n    return this._committed;\n  }\n\n  /**\n   * True if current state differs from committed state.\n   */\n  get dirty(): boolean {\n    if (this._cachedDirty === null) {\n      this._cachedDirty = !this.shallowEqual(this._state, this._committed);\n    }\n    return this._cachedDirty;\n  }\n\n  /**\n   * Validation errors for the current state.\n   */\n  get errors(): ValidationErrors<S> {\n    if (this._cachedErrors === null) {\n      this._cachedErrors = this.validate(this._state);\n    }\n    return this._cachedErrors;\n  }\n\n  /**\n   * True if there are no validation errors.\n   */\n  get valid(): boolean {\n    return Object.keys(this.errors).length === 0;\n  }\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /**\n   * Merges partial state with validation. No-op if no values changed by reference.\n   * @protected\n   */\n  protected set(partialOrUpdater: Partial<S> | Updater<S>): void {\n    if (this._disposed) {\n      throw new Error('Cannot set state on disposed Model');\n    }\n\n    const partial =\n      typeof partialOrUpdater === 'function'\n        ? partialOrUpdater(this._state)\n        : partialOrUpdater;\n\n    // Check if any values actually changed (shallow equality)\n    const keys = Object.keys(partial) as (keyof S)[];\n    const hasChanges = keys.some(\n      (key) => partial[key] !== this._state[key]\n    );\n\n    if (!hasChanges) {\n      return;\n    }\n\n    const prev = this._state;\n    const next = freeze({ ...prev, ...partial });\n    this._state = next;\n    this._cachedDirty = null;\n    this._cachedErrors = null;\n\n    this.onSet?.(prev, next);\n\n    for (const listener of this._listeners) {\n      listener(next, prev);\n    }\n  }\n\n  /**\n   * Mark current state as the new baseline (not dirty).\n   */\n  commit(): void {\n    if (this._disposed) {\n      throw new Error('Cannot commit on disposed Model');\n    }\n    this._committed = this._state;\n    this._cachedDirty = null;\n    this._cachedErrors = null;\n  }\n\n  /**\n   * Revert state to committed baseline.\n   */\n  rollback(): void {\n    if (this._disposed) {\n      throw new Error('Cannot rollback on disposed Model');\n    }\n\n    if (this.shallowEqual(this._state, this._committed)) {\n      return;\n    }\n\n    const prev = this._state;\n    this._state = this._committed;\n    this._cachedDirty = null;\n    this._cachedErrors = null;\n\n    this.onSet?.(prev, this._state);\n\n    for (const listener of this._listeners) {\n      listener(this._state, prev);\n    }\n  }\n\n  /** Subscribes to state changes. Returns an unsubscribe function. */\n  subscribe(listener: Listener<S>): () => 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._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  }\n\n  /**\n   * Override to provide validation logic.\n   * Return an object mapping field keys to error messages.\n   */\n  protected validate(_state: S): ValidationErrors<S> {\n    return {};\n  }\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */\n  protected listenTo<K extends string, S extends { on(event: K, handler: (payload: any) => void): () => void }>(\n    source: S,\n    event: K,\n    handler: (payload: EventPayload<S, K>) => void,\n  ): () => void {\n    const unsubscribe = source.on(event, handler);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called after every set() with the previous state. @protected */\n  protected onSet?(prev: S, next: S): void;\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n\n  private shallowEqual(a: S, b: S): boolean {\n    const keysA = Object.keys(a) as (keyof S)[];\n    const keysB = Object.keys(b) as (keyof S)[];\n\n    if (keysA.length !== keysB.length) {\n      return false;\n    }\n\n    for (const key of keysA) {\n      if (a[key] !== b[key]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/Model.d.ts

@@ -10,6 +10,8 @@ export declare abstract class Model<S extends object> implements Subscribable<S>
     private _listeners;
     private _abortController;
     private _cleanups;
+    private _cachedDirty;
+    private _cachedErrors;
     constructor(initialState: S);
     /** Current frozen state object. */
     get state(): S;

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,YAAY,EAAE,MAAM,SAAS,CAAC;AAE/F;;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,yGAAyG;IACzG,SAAS,CAAC,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS;QAAE,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;KAAE,EAC1G,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,GAC7C,MAAM,IAAI;IAMb,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"}
+{"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,YAAY,EAAE,MAAM,SAAS,CAAC;AAQ/F;;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;IAChD,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,aAAa,CAAoC;gBAE7C,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,CAKnB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAKhC;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;IAiC9D;;OAEG;IACH,MAAM,IAAI,IAAI;IASd;;OAEG;IACH,QAAQ,IAAI,IAAI;IAqBhB,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,yGAAyG;IACzG,SAAS,CAAC,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS;QAAE,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;KAAE,EAC1G,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,GAC7C,MAAM,IAAI;IAMb,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/Model.js

@@ -1,3 +1,7 @@
+const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+function freeze(obj) {
+  return __DEV__ ? Object.freeze(obj) : obj;
+}
 class Model {
   _state;
   _committed;
@@ -6,8 +10,10 @@ class Model {
   _listeners = /* @__PURE__ */ new Set();
   _abortController = null;
   _cleanups = null;
+  _cachedDirty = null;
+  _cachedErrors = null;
   constructor(initialState) {
-    const frozen = Object.freeze({ ...initialState });
+    const frozen = freeze({ ...initialState });
     this._state = frozen;
     this._committed = frozen;
   }
@@ -25,13 +31,19 @@ class Model {
    * True if current state differs from committed state.
    */
   get dirty() {
-    return !this.shallowEqual(this._state, this._committed);
+    if (this._cachedDirty === null) {
+      this._cachedDirty = !this.shallowEqual(this._state, this._committed);
+    }
+    return this._cachedDirty;
   }
   /**
    * Validation errors for the current state.
    */
   get errors() {
-    return this.validate(this._state);
+    if (this._cachedErrors === null) {
+      this._cachedErrors = this.validate(this._state);
+    }
+    return this._cachedErrors;
   }
   /**
    * True if there are no validation errors.
@@ -77,8 +89,10 @@ class Model {
       return;
     }
     const prev = this._state;
-    const next = Object.freeze({ ...prev, ...partial });
+    const next = freeze({ ...prev, ...partial });
     this._state = next;
+    this._cachedDirty = null;
+    this._cachedErrors = null;
     this.onSet?.(prev, next);
     for (const listener of this._listeners) {
       listener(next, prev);
@@ -92,6 +106,8 @@ class Model {
       throw new Error("Cannot commit on disposed Model");
     }
     this._committed = this._state;
+    this._cachedDirty = null;
+    this._cachedErrors = null;
   }
   /**
    * Revert state to committed baseline.
@@ -105,6 +121,8 @@ class Model {
     }
     const prev = this._state;
     this._state = this._committed;
+    this._cachedDirty = null;
+    this._cachedErrors = null;
     this.onSet?.(prev, this._state);
     for (const listener of this._listeners) {
       listener(this._state, prev);

package/dist/Model.js.map

@@ -1 +1 @@
-{"version":3,"file":"Model.js","sources":["../src/Model.ts"],"sourcesContent":["import type { Listener, Updater, Subscribable, ValidationErrors, EventPayload } from './types';\n\n/**\n * Reactive entity with validation and dirty tracking.\n */\nexport abstract class Model<S extends object> implements Subscribable<S> {\n  private _state: Readonly<S>;\n  private _committed: Readonly<S>;\n  private _disposed = false;\n  private _initialized = false;\n  private _listeners = new Set<Listener<S>>();\n  private _abortController: AbortController | null = null;\n  private _cleanups: (() => void)[] | null = null;\n\n  constructor(initialState: S) {\n    const frozen = Object.freeze({ ...initialState });\n    this._state = frozen;\n    this._committed = frozen;\n  }\n\n  /** Current frozen state object. */\n  get state(): S {\n    return this._state;\n  }\n\n  /**\n   * The baseline state for dirty tracking.\n   */\n  get committed(): S {\n    return this._committed;\n  }\n\n  /**\n   * True if current state differs from committed state.\n   */\n  get dirty(): boolean {\n    return !this.shallowEqual(this._state, this._committed);\n  }\n\n  /**\n   * Validation errors for the current state.\n   */\n  get errors(): ValidationErrors<S> {\n    return this.validate(this._state);\n  }\n\n  /**\n   * True if there are no validation errors.\n   */\n  get valid(): boolean {\n    return Object.keys(this.errors).length === 0;\n  }\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /**\n   * Merges partial state with validation. No-op if no values changed by reference.\n   * @protected\n   */\n  protected set(partialOrUpdater: Partial<S> | Updater<S>): void {\n    if (this._disposed) {\n      throw new Error('Cannot set state on disposed Model');\n    }\n\n    const partial =\n      typeof partialOrUpdater === 'function'\n        ? partialOrUpdater(this._state)\n        : partialOrUpdater;\n\n    // Check if any values actually changed (shallow equality)\n    const keys = Object.keys(partial) as (keyof S)[];\n    const hasChanges = keys.some(\n      (key) => partial[key] !== this._state[key]\n    );\n\n    if (!hasChanges) {\n      return;\n    }\n\n    const prev = this._state;\n    const next = Object.freeze({ ...prev, ...partial });\n    this._state = next;\n\n    this.onSet?.(prev, next);\n\n    for (const listener of this._listeners) {\n      listener(next, prev);\n    }\n  }\n\n  /**\n   * Mark current state as the new baseline (not dirty).\n   */\n  commit(): void {\n    if (this._disposed) {\n      throw new Error('Cannot commit on disposed Model');\n    }\n    this._committed = this._state;\n  }\n\n  /**\n   * Revert state to committed baseline.\n   */\n  rollback(): void {\n    if (this._disposed) {\n      throw new Error('Cannot rollback on disposed Model');\n    }\n\n    if (this.shallowEqual(this._state, this._committed)) {\n      return;\n    }\n\n    const prev = this._state;\n    this._state = this._committed;\n\n    this.onSet?.(prev, this._state);\n\n    for (const listener of this._listeners) {\n      listener(this._state, prev);\n    }\n  }\n\n  /** Subscribes to state changes. Returns an unsubscribe function. */\n  subscribe(listener: Listener<S>): () => 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._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  }\n\n  /**\n   * Override to provide validation logic.\n   * Return an object mapping field keys to error messages.\n   */\n  protected validate(_state: S): ValidationErrors<S> {\n    return {};\n  }\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */\n  protected listenTo<K extends string, S extends { on(event: K, handler: (payload: any) => void): () => void }>(\n    source: S,\n    event: K,\n    handler: (payload: EventPayload<S, K>) => void,\n  ): () => void {\n    const unsubscribe = source.on(event, handler);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called after every set() with the previous state. @protected */\n  protected onSet?(prev: S, next: S): void;\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n\n  private shallowEqual(a: S, b: S): boolean {\n    const keysA = Object.keys(a) as (keyof S)[];\n    const keysB = Object.keys(b) as (keyof S)[];\n\n    if (keysA.length !== keysB.length) {\n      return false;\n    }\n\n    for (const key of keysA) {\n      if (a[key] !== b[key]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"Model.js","sources":["../src/Model.ts"],"sourcesContent":["import type { Listener, Updater, Subscribable, ValidationErrors, EventPayload } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\nfunction freeze<T>(obj: T): T {\n  return __DEV__ ? Object.freeze(obj) as T : obj;\n}\n\n/**\n * Reactive entity with validation and dirty tracking.\n */\nexport abstract class Model<S extends object> implements Subscribable<S> {\n  private _state: Readonly<S>;\n  private _committed: Readonly<S>;\n  private _disposed = false;\n  private _initialized = false;\n  private _listeners = new Set<Listener<S>>();\n  private _abortController: AbortController | null = null;\n  private _cleanups: (() => void)[] | null = null;\n  private _cachedDirty: boolean | null = null;\n  private _cachedErrors: ValidationErrors<S> | null = null;\n\n  constructor(initialState: S) {\n    const frozen = freeze({ ...initialState });\n    this._state = frozen;\n    this._committed = frozen;\n  }\n\n  /** Current frozen state object. */\n  get state(): S {\n    return this._state;\n  }\n\n  /**\n   * The baseline state for dirty tracking.\n   */\n  get committed(): S {\n    return this._committed;\n  }\n\n  /**\n   * True if current state differs from committed state.\n   */\n  get dirty(): boolean {\n    if (this._cachedDirty === null) {\n      this._cachedDirty = !this.shallowEqual(this._state, this._committed);\n    }\n    return this._cachedDirty;\n  }\n\n  /**\n   * Validation errors for the current state.\n   */\n  get errors(): ValidationErrors<S> {\n    if (this._cachedErrors === null) {\n      this._cachedErrors = this.validate(this._state);\n    }\n    return this._cachedErrors;\n  }\n\n  /**\n   * True if there are no validation errors.\n   */\n  get valid(): boolean {\n    return Object.keys(this.errors).length === 0;\n  }\n\n  /** Whether this instance has been disposed. */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** AbortSignal that fires when this instance is disposed. Lazily created. */\n  get disposeSignal(): AbortSignal {\n    if (!this._abortController) {\n      this._abortController = new AbortController();\n    }\n    return this._abortController.signal;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this._disposed) return;\n    this._initialized = true;\n    return this.onInit?.();\n  }\n\n  /**\n   * Merges partial state with validation. No-op if no values changed by reference.\n   * @protected\n   */\n  protected set(partialOrUpdater: Partial<S> | Updater<S>): void {\n    if (this._disposed) {\n      throw new Error('Cannot set state on disposed Model');\n    }\n\n    const partial =\n      typeof partialOrUpdater === 'function'\n        ? partialOrUpdater(this._state)\n        : partialOrUpdater;\n\n    // Check if any values actually changed (shallow equality)\n    const keys = Object.keys(partial) as (keyof S)[];\n    const hasChanges = keys.some(\n      (key) => partial[key] !== this._state[key]\n    );\n\n    if (!hasChanges) {\n      return;\n    }\n\n    const prev = this._state;\n    const next = freeze({ ...prev, ...partial });\n    this._state = next;\n    this._cachedDirty = null;\n    this._cachedErrors = null;\n\n    this.onSet?.(prev, next);\n\n    for (const listener of this._listeners) {\n      listener(next, prev);\n    }\n  }\n\n  /**\n   * Mark current state as the new baseline (not dirty).\n   */\n  commit(): void {\n    if (this._disposed) {\n      throw new Error('Cannot commit on disposed Model');\n    }\n    this._committed = this._state;\n    this._cachedDirty = null;\n    this._cachedErrors = null;\n  }\n\n  /**\n   * Revert state to committed baseline.\n   */\n  rollback(): void {\n    if (this._disposed) {\n      throw new Error('Cannot rollback on disposed Model');\n    }\n\n    if (this.shallowEqual(this._state, this._committed)) {\n      return;\n    }\n\n    const prev = this._state;\n    this._state = this._committed;\n    this._cachedDirty = null;\n    this._cachedErrors = null;\n\n    this.onSet?.(prev, this._state);\n\n    for (const listener of this._listeners) {\n      listener(this._state, prev);\n    }\n  }\n\n  /** Subscribes to state changes. Returns an unsubscribe function. */\n  subscribe(listener: Listener<S>): () => 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._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  }\n\n  /**\n   * Override to provide validation logic.\n   * Return an object mapping field keys to error messages.\n   */\n  protected validate(_state: S): ValidationErrors<S> {\n    return {};\n  }\n\n  /** Registers a cleanup function to be called on dispose. @protected */\n  protected addCleanup(fn: () => void): void {\n    if (!this._cleanups) {\n      this._cleanups = [];\n    }\n    this._cleanups.push(fn);\n  }\n\n  /** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */\n  protected subscribeTo<T>(source: Subscribable<T>, listener: Listener<T>): () => void {\n    const unsubscribe = source.subscribe(listener);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */\n  protected listenTo<K extends string, S extends { on(event: K, handler: (payload: any) => void): () => void }>(\n    source: S,\n    event: K,\n    handler: (payload: EventPayload<S, K>) => void,\n  ): () => void {\n    const unsubscribe = source.on(event, handler);\n    this.addCleanup(unsubscribe);\n    return unsubscribe;\n  }\n\n  /** Lifecycle hook called after every set() with the previous state. @protected */\n  protected onSet?(prev: S, next: S): void;\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n  /** Lifecycle hook called during dispose(). Override for custom teardown. @protected */\n  protected onDispose?(): void;\n\n  private shallowEqual(a: S, b: S): boolean {\n    const keysA = Object.keys(a) as (keyof S)[];\n    const keysB = Object.keys(b) as (keyof S)[];\n\n    if (keysA.length !== keysB.length) {\n      return false;\n    }\n\n    for (const key of keysA) {\n      if (a[key] !== b[key]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/Pagination.cjs

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+class Pagination {
+  _page = 1;
+  _pageSize;
+  _listeners = /* @__PURE__ */ new Set();
+  constructor(options) {
+    this._pageSize = options?.pageSize ?? 10;
+  }
+  // ── Readable state ──
+  /** Current page number (1-based). */
+  get page() {
+    return this._page;
+  }
+  /** Number of items per page. */
+  get pageSize() {
+    return this._pageSize;
+  }
+  // ── Derived (require total) ──
+  /** Total number of pages for the given item count. */
+  pageCount(total) {
+    return Math.max(1, Math.ceil(total / this._pageSize));
+  }
+  /** Whether there is a next page available. */
+  hasNext(total) {
+    return this._page < this.pageCount(total);
+  }
+  /** Whether there is a previous page available. */
+  hasPrev() {
+    return this._page > 1;
+  }
+  // ── Actions ──
+  /** Navigate to a specific page (clamped to >= 1). */
+  setPage(page) {
+    const clamped = Math.max(1, Math.floor(page));
+    if (clamped === this._page) return;
+    this._page = clamped;
+    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();
+  }
+  /** Advance to the next page. */
+  nextPage() {
+    this._page++;
+    this._notify();
+  }
+  /** Go back to the previous page. No-op if already on page 1. */
+  prevPage() {
+    if (this._page > 1) {
+      this._page--;
+      this._notify();
+    }
+  }
+  /** Reset to page 1. */
+  reset() {
+    if (this._page === 1) return;
+    this._page = 1;
+    this._notify();
+  }
+  // ── Pipeline ──
+  /** Slice an array to the current page window. Returns the page subset. */
+  apply(items) {
+    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

@@ -0,0 +1 @@
+{"version":3,"file":"Pagination.cjs","sources":["../src/Pagination.ts"],"sourcesContent":["/**\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  }\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":[],"mappings":";;AAKO,MAAM,WAAW;AAAA,EACd,QAAgB;AAAA,EAChB;AAAA,EACA,iCAAiB,IAAA;AAAA,EAEzB,YAAY,SAAiC;AAC3C,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,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;;"}

package/dist/Pagination.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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 {
+    private _page;
+    private _pageSize;
+    private _listeners;
+    constructor(options?: {
+        pageSize?: number;
+    });
+    /** Current page number (1-based). */
+    get page(): number;
+    /** Number of items per page. */
+    get pageSize(): number;
+    /** Total number of pages for the given item count. */
+    pageCount(total: number): number;
+    /** Whether there is a next page available. */
+    hasNext(total: number): boolean;
+    /** Whether there is a previous page available. */
+    hasPrev(): boolean;
+    /** Navigate to a specific page (clamped to >= 1). */
+    setPage(page: number): void;
+    /** Change the page size and reset to page 1. */
+    setPageSize(size: number): void;
+    /** Advance to the next page. */
+    nextPage(): void;
+    /** Go back to the previous page. No-op if already on page 1. */
+    prevPage(): void;
+    /** Reset to page 1. */
+    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

package/dist/Pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pagination.d.ts","sourceRoot":"","sources":["../src/Pagination.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAyB;gBAE/B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAM3C,qCAAqC;IACrC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,gCAAgC;IAChC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAID,sDAAsD;IACtD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIhC,8CAA8C;IAC9C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI/B,kDAAkD;IAClD,OAAO,IAAI,OAAO;IAMlB,qDAAqD;IACrD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO3B,gDAAgD;IAChD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO/B,gCAAgC;IAChC,QAAQ,IAAI,IAAI;IAKhB,gEAAgE;IAChE,QAAQ,IAAI,IAAI;IAOhB,uBAAuB;IACvB,KAAK,IAAI,IAAI;IAQb,0EAA0E;IAC1E,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAOzB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKrC,OAAO,CAAC,OAAO;CAGhB"}