mvc-kit 2.12.4 → 2.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agent-config/bin/postinstall.mjs +4 -3
- package/agent-config/bin/setup.mjs +5 -1
- package/agent-config/claude-code/agents/mvc-kit-architect.md +11 -8
- package/agent-config/claude-code/skills/guide/SKILL.md +20 -7
- package/agent-config/claude-code/skills/guide/patterns.md +12 -0
- package/agent-config/claude-code/skills/guide/recipes.md +510 -0
- package/agent-config/claude-code/skills/guide/testing.md +297 -0
- package/agent-config/claude-code/skills/review/SKILL.md +3 -13
- package/agent-config/claude-code/skills/review/checklist.md +30 -5
- package/agent-config/claude-code/skills/scaffold/SKILL.md +4 -13
- package/agent-config/lib/install-claude.mjs +84 -25
- package/dist/Channel.cjs +276 -300
- package/dist/Channel.cjs.map +1 -1
- package/dist/Channel.js +275 -299
- package/dist/Channel.js.map +1 -1
- package/dist/Collection.cjs +424 -504
- package/dist/Collection.cjs.map +1 -1
- package/dist/Collection.js +423 -503
- package/dist/Collection.js.map +1 -1
- package/dist/Controller.cjs +70 -67
- package/dist/Controller.cjs.map +1 -1
- package/dist/Controller.js +69 -66
- package/dist/Controller.js.map +1 -1
- package/dist/EventBus.cjs +77 -88
- package/dist/EventBus.cjs.map +1 -1
- package/dist/EventBus.js +76 -87
- package/dist/EventBus.js.map +1 -1
- package/dist/Feed.cjs +81 -77
- package/dist/Feed.cjs.map +1 -1
- package/dist/Feed.js +80 -76
- package/dist/Feed.js.map +1 -1
- package/dist/Model.cjs +181 -207
- package/dist/Model.cjs.map +1 -1
- package/dist/Model.js +179 -205
- package/dist/Model.js.map +1 -1
- package/dist/Pagination.cjs +75 -73
- package/dist/Pagination.cjs.map +1 -1
- package/dist/Pagination.js +74 -72
- package/dist/Pagination.js.map +1 -1
- package/dist/Pending.cjs +255 -287
- package/dist/Pending.cjs.map +1 -1
- package/dist/Pending.js +253 -285
- package/dist/Pending.js.map +1 -1
- package/dist/PersistentCollection.cjs +242 -285
- package/dist/PersistentCollection.cjs.map +1 -1
- package/dist/PersistentCollection.js +241 -284
- package/dist/PersistentCollection.js.map +1 -1
- package/dist/Resource.cjs +166 -174
- package/dist/Resource.cjs.map +1 -1
- package/dist/Resource.js +164 -172
- package/dist/Resource.js.map +1 -1
- package/dist/Selection.cjs +84 -94
- package/dist/Selection.cjs.map +1 -1
- package/dist/Selection.js +83 -93
- package/dist/Selection.js.map +1 -1
- package/dist/Service.cjs +54 -55
- package/dist/Service.cjs.map +1 -1
- package/dist/Service.js +53 -54
- package/dist/Service.js.map +1 -1
- package/dist/Sorting.cjs +102 -101
- package/dist/Sorting.cjs.map +1 -1
- package/dist/Sorting.js +102 -101
- package/dist/Sorting.js.map +1 -1
- package/dist/Trackable.cjs +112 -80
- package/dist/Trackable.cjs.map +1 -1
- package/dist/Trackable.js +111 -79
- package/dist/Trackable.js.map +1 -1
- package/dist/ViewModel.cjs +528 -576
- package/dist/ViewModel.cjs.map +1 -1
- package/dist/ViewModel.js +525 -573
- package/dist/ViewModel.js.map +1 -1
- package/dist/bindPublicMethods.cjs +43 -24
- package/dist/bindPublicMethods.cjs.map +1 -1
- package/dist/bindPublicMethods.js +43 -24
- package/dist/bindPublicMethods.js.map +1 -1
- package/dist/errors.cjs +67 -68
- package/dist/errors.cjs.map +1 -1
- package/dist/errors.js +68 -71
- package/dist/errors.js.map +1 -1
- package/dist/mvc-kit.cjs +44 -46
- package/dist/mvc-kit.js +5 -32
- package/dist/produceDraft.cjs +105 -95
- package/dist/produceDraft.cjs.map +1 -1
- package/dist/produceDraft.js +106 -97
- package/dist/produceDraft.js.map +1 -1
- package/dist/react/components/CardList.cjs +30 -40
- package/dist/react/components/CardList.cjs.map +1 -1
- package/dist/react/components/CardList.js +31 -41
- package/dist/react/components/CardList.js.map +1 -1
- package/dist/react/components/DataTable.cjs +146 -169
- package/dist/react/components/DataTable.cjs.map +1 -1
- package/dist/react/components/DataTable.js +147 -170
- package/dist/react/components/DataTable.js.map +1 -1
- package/dist/react/components/InfiniteScroll.cjs +51 -42
- package/dist/react/components/InfiniteScroll.cjs.map +1 -1
- package/dist/react/components/InfiniteScroll.js +52 -43
- package/dist/react/components/InfiniteScroll.js.map +1 -1
- package/dist/react/components/types.cjs +10 -6
- package/dist/react/components/types.cjs.map +1 -1
- package/dist/react/components/types.js +11 -9
- package/dist/react/components/types.js.map +1 -1
- package/dist/react/guards.cjs +10 -6
- package/dist/react/guards.cjs.map +1 -1
- package/dist/react/guards.js +11 -9
- package/dist/react/guards.js.map +1 -1
- package/dist/react/provider.cjs +23 -20
- package/dist/react/provider.cjs.map +1 -1
- package/dist/react/provider.js +23 -21
- package/dist/react/provider.js.map +1 -1
- package/dist/react/use-event-bus.cjs +24 -20
- package/dist/react/use-event-bus.cjs.map +1 -1
- package/dist/react/use-event-bus.js +24 -21
- package/dist/react/use-event-bus.js.map +1 -1
- package/dist/react/use-instance.cjs +43 -36
- package/dist/react/use-instance.cjs.map +1 -1
- package/dist/react/use-instance.js +43 -36
- package/dist/react/use-instance.js.map +1 -1
- package/dist/react/use-local.cjs +48 -64
- package/dist/react/use-local.cjs.map +1 -1
- package/dist/react/use-local.js +47 -63
- package/dist/react/use-local.js.map +1 -1
- package/dist/react/use-model.cjs +84 -98
- package/dist/react/use-model.cjs.map +1 -1
- package/dist/react/use-model.js +84 -100
- package/dist/react/use-model.js.map +1 -1
- package/dist/react/use-singleton.cjs +19 -23
- package/dist/react/use-singleton.cjs.map +1 -1
- package/dist/react/use-singleton.js +16 -20
- package/dist/react/use-singleton.js.map +1 -1
- package/dist/react/use-subscribe-only.cjs +28 -22
- package/dist/react/use-subscribe-only.cjs.map +1 -1
- package/dist/react/use-subscribe-only.js +28 -22
- package/dist/react/use-subscribe-only.js.map +1 -1
- package/dist/react/use-teardown.cjs +20 -19
- package/dist/react/use-teardown.cjs.map +1 -1
- package/dist/react/use-teardown.js +20 -19
- package/dist/react/use-teardown.js.map +1 -1
- package/dist/react-native/NativeCollection.cjs +98 -78
- package/dist/react-native/NativeCollection.cjs.map +1 -1
- package/dist/react-native/NativeCollection.js +97 -77
- package/dist/react-native/NativeCollection.js.map +1 -1
- package/dist/react-native.cjs +2 -4
- package/dist/react-native.js +1 -4
- package/dist/react.cjs +24 -26
- package/dist/react.js +1 -17
- package/dist/singleton.cjs +28 -22
- package/dist/singleton.cjs.map +1 -1
- package/dist/singleton.js +29 -26
- package/dist/singleton.js.map +1 -1
- package/dist/walkPrototypeChain.cjs +20 -12
- package/dist/walkPrototypeChain.cjs.map +1 -1
- package/dist/walkPrototypeChain.js +21 -13
- package/dist/walkPrototypeChain.js.map +1 -1
- package/dist/web/IndexedDBCollection.cjs +53 -36
- package/dist/web/IndexedDBCollection.cjs.map +1 -1
- package/dist/web/IndexedDBCollection.js +52 -35
- package/dist/web/IndexedDBCollection.js.map +1 -1
- package/dist/web/WebStorageCollection.cjs +82 -84
- package/dist/web/WebStorageCollection.cjs.map +1 -1
- package/dist/web/WebStorageCollection.js +81 -83
- package/dist/web/WebStorageCollection.js.map +1 -1
- package/dist/web/idb.cjs +107 -99
- package/dist/web/idb.cjs.map +1 -1
- package/dist/web/idb.js +108 -105
- package/dist/web/idb.js.map +1 -1
- package/dist/web.cjs +4 -6
- package/dist/web.js +1 -5
- package/dist/wrapAsyncMethods.cjs +141 -168
- package/dist/wrapAsyncMethods.cjs.map +1 -1
- package/dist/wrapAsyncMethods.js +141 -168
- package/dist/wrapAsyncMethods.js.map +1 -1
- package/package.json +8 -8
- package/src/Pending.test.ts +1 -2
- package/src/Sorting.test.ts +1 -1
- package/src/produceDraft.test.ts +3 -3
- package/src/react/components/CardList.test.tsx +1 -1
- package/src/react/components/DataTable.test.tsx +1 -1
- package/src/react/components/InfiniteScroll.test.tsx +5 -5
- package/dist/mvc-kit.cjs.map +0 -1
- package/dist/mvc-kit.js.map +0 -1
- package/dist/react-native.cjs.map +0 -1
- package/dist/react-native.js.map +0 -1
- package/dist/react.cjs.map +0 -1
- package/dist/react.js.map +0 -1
- package/dist/web.cjs.map +0 -1
- package/dist/web.js.map +0 -1
package/dist/Feed.js
CHANGED
|
@@ -1,78 +1,82 @@
|
|
|
1
1
|
import { Trackable } from "./Trackable.js";
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
2
|
+
//#region src/Feed.ts
|
|
3
|
+
/**
|
|
4
|
+
* Cursor-based pagination state for server-side paginated feeds.
|
|
5
|
+
* Accumulates items across pages, tracks cursor position and hasMore flag.
|
|
6
|
+
* Subscribable — auto-tracked when used as a ViewModel property.
|
|
7
|
+
*/
|
|
8
|
+
var Feed = class extends Trackable {
|
|
9
|
+
_cursor = null;
|
|
10
|
+
_hasMore = true;
|
|
11
|
+
_items = Object.freeze([]);
|
|
12
|
+
constructor() {
|
|
13
|
+
super();
|
|
14
|
+
}
|
|
15
|
+
/** Current cursor position for the next page fetch, or null if at the beginning. */
|
|
16
|
+
get cursor() {
|
|
17
|
+
return this._cursor;
|
|
18
|
+
}
|
|
19
|
+
/** Whether more pages are available from the server. */
|
|
20
|
+
get hasMore() {
|
|
21
|
+
return this._hasMore;
|
|
22
|
+
}
|
|
23
|
+
/** Accumulated items across all loaded pages. */
|
|
24
|
+
get items() {
|
|
25
|
+
return this._items;
|
|
26
|
+
}
|
|
27
|
+
/** Total number of accumulated items. */
|
|
28
|
+
get count() {
|
|
29
|
+
return this._items.length;
|
|
30
|
+
}
|
|
31
|
+
/** Update cursor/hasMore only (backward-compatible, does NOT affect items). */
|
|
32
|
+
setResult(result) {
|
|
33
|
+
this._hasMore = result.hasMore;
|
|
34
|
+
this._cursor = result.cursor ?? null;
|
|
35
|
+
this.notify();
|
|
36
|
+
}
|
|
37
|
+
/** Append page items and update cursor/hasMore. */
|
|
38
|
+
appendPage(page) {
|
|
39
|
+
this._items = Object.freeze([...this._items, ...page.items]);
|
|
40
|
+
this._hasMore = page.hasMore;
|
|
41
|
+
this._cursor = page.cursor ?? null;
|
|
42
|
+
this.notify();
|
|
43
|
+
}
|
|
44
|
+
/** Prepend page items and update cursor/hasMore. */
|
|
45
|
+
prependPage(page) {
|
|
46
|
+
this._items = Object.freeze([...page.items, ...this._items]);
|
|
47
|
+
this._hasMore = page.hasMore;
|
|
48
|
+
this._cursor = page.cursor ?? null;
|
|
49
|
+
this.notify();
|
|
50
|
+
}
|
|
51
|
+
/** Add items without affecting cursor/hasMore. */
|
|
52
|
+
push(...items) {
|
|
53
|
+
if (items.length === 0) return;
|
|
54
|
+
this._items = Object.freeze([...this._items, ...items]);
|
|
55
|
+
this.notify();
|
|
56
|
+
}
|
|
57
|
+
/** Remove items that don't match the predicate. No-op if nothing is filtered out. */
|
|
58
|
+
filter(predicate) {
|
|
59
|
+
const filtered = this._items.filter(predicate);
|
|
60
|
+
if (filtered.length === this._items.length) return;
|
|
61
|
+
this._items = Object.freeze(filtered);
|
|
62
|
+
this.notify();
|
|
63
|
+
}
|
|
64
|
+
/** Replace all items and update cursor/hasMore atomically. Ideal for pull-to-refresh. */
|
|
65
|
+
replacePage(page) {
|
|
66
|
+
this._items = Object.freeze([...page.items]);
|
|
67
|
+
this._hasMore = page.hasMore;
|
|
68
|
+
this._cursor = page.cursor ?? null;
|
|
69
|
+
this.notify();
|
|
70
|
+
}
|
|
71
|
+
/** Reset to initial empty state with hasMore=true. */
|
|
72
|
+
reset() {
|
|
73
|
+
this._cursor = null;
|
|
74
|
+
this._hasMore = true;
|
|
75
|
+
this._items = Object.freeze([]);
|
|
76
|
+
this.notify();
|
|
77
|
+
}
|
|
77
78
|
};
|
|
78
|
-
//#
|
|
79
|
+
//#endregion
|
|
80
|
+
export { Feed };
|
|
81
|
+
|
|
82
|
+
//# sourceMappingURL=Feed.js.map
|
package/dist/Feed.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"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"],"
|
|
1
|
+
{"version":3,"file":"Feed.js","names":[],"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"],"mappings":";;;;;;;AAcA,IAAa,OAAb,cAAuC,UAAU;CAC/C,UAAiC;CACjC,WAA4B;CAC5B,SAA+B,OAAO,OAAO,EAAE,CAAQ;CAEvD,cAAc;AACZ,SAAO;;;CAMT,IAAI,SAAwB;AAC1B,SAAO,KAAK;;;CAId,IAAI,UAAmB;AACrB,SAAO,KAAK;;;CAId,IAAI,QAAsB;AACxB,SAAO,KAAK;;;CAId,IAAI,QAAgB;AAClB,SAAO,KAAK,OAAO;;;CAMrB,UAAU,QAA4D;AACpE,OAAK,WAAW,OAAO;AACvB,OAAK,UAAU,OAAO,UAAU;AAChC,OAAK,QAAQ;;;CAIf,WAAW,MAAyB;AAClC,OAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,GAAG,KAAK,MAAM,CAAC;AAC5D,OAAK,WAAW,KAAK;AACrB,OAAK,UAAU,KAAK,UAAU;AAC9B,OAAK,QAAQ;;;CAIf,YAAY,MAAyB;AACnC,OAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,OAAO,GAAG,KAAK,OAAO,CAAC;AAC5D,OAAK,WAAW,KAAK;AACrB,OAAK,UAAU,KAAK,UAAU;AAC9B,OAAK,QAAQ;;;CAIf,KAAK,GAAG,OAAkB;AACxB,MAAI,MAAM,WAAW,EAAG;AACxB,OAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,GAAG,MAAM,CAAC;AACvD,OAAK,QAAQ;;;CAIf,OAAO,WAAuC;EAC5C,MAAM,WAAW,KAAK,OAAO,OAAO,UAAU;AAC9C,MAAI,SAAS,WAAW,KAAK,OAAO,OAAQ;AAC5C,OAAK,SAAS,OAAO,OAAO,SAAS;AACrC,OAAK,QAAQ;;;CAIf,YAAY,MAAyB;AACnC,OAAK,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,MAAM,CAAC;AAC5C,OAAK,WAAW,KAAK;AACrB,OAAK,UAAU,KAAK,UAAU;AAC9B,OAAK,QAAQ;;;CAIf,QAAc;AACZ,OAAK,UAAU;AACf,OAAK,WAAW;AAChB,OAAK,SAAS,OAAO,OAAO,EAAE,CAAQ;AACtC,OAAK,QAAQ"}
|
package/dist/Model.cjs
CHANGED
|
@@ -1,210 +1,184 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
1
|
+
const require_bindPublicMethods = require("./bindPublicMethods.cjs");
|
|
2
|
+
const require_produceDraft = require("./produceDraft.cjs");
|
|
3
|
+
//#region src/Model.ts
|
|
4
|
+
var __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
|
|
5
|
+
var PROTECTED_KEYS = new Set([
|
|
6
|
+
"set",
|
|
7
|
+
"validate",
|
|
8
|
+
"addCleanup",
|
|
9
|
+
"subscribeTo",
|
|
10
|
+
"listenTo"
|
|
11
|
+
]);
|
|
7
12
|
function freeze(obj) {
|
|
8
|
-
|
|
9
|
-
}
|
|
10
|
-
class Model {
|
|
11
|
-
_state;
|
|
12
|
-
_committed;
|
|
13
|
-
_disposed = false;
|
|
14
|
-
_initialized = false;
|
|
15
|
-
_listeners = /* @__PURE__ */ new Set();
|
|
16
|
-
_abortController = null;
|
|
17
|
-
_cleanups = null;
|
|
18
|
-
_cachedDirty = null;
|
|
19
|
-
_cachedErrors = null;
|
|
20
|
-
constructor(initialState) {
|
|
21
|
-
const frozen = freeze({ ...initialState });
|
|
22
|
-
this._state = frozen;
|
|
23
|
-
this._committed = frozen;
|
|
24
|
-
bindPublicMethods.bindPublicMethods(this, Object.prototype, PROTECTED_KEYS);
|
|
25
|
-
}
|
|
26
|
-
/** Current frozen state object. */
|
|
27
|
-
get state() {
|
|
28
|
-
return this._state;
|
|
29
|
-
}
|
|
30
|
-
/**
|
|
31
|
-
* The baseline state for dirty tracking.
|
|
32
|
-
*/
|
|
33
|
-
get committed() {
|
|
34
|
-
return this._committed;
|
|
35
|
-
}
|
|
36
|
-
/**
|
|
37
|
-
* True if current state differs from committed state.
|
|
38
|
-
*/
|
|
39
|
-
get dirty() {
|
|
40
|
-
if (this._cachedDirty === null) {
|
|
41
|
-
this._cachedDirty = !this._shallowEqual(this._state, this._committed);
|
|
42
|
-
}
|
|
43
|
-
return this._cachedDirty;
|
|
44
|
-
}
|
|
45
|
-
/**
|
|
46
|
-
* Validation errors for the current state.
|
|
47
|
-
*/
|
|
48
|
-
get errors() {
|
|
49
|
-
if (this._cachedErrors === null) {
|
|
50
|
-
this._cachedErrors = this.validate(this._state);
|
|
51
|
-
}
|
|
52
|
-
return this._cachedErrors;
|
|
53
|
-
}
|
|
54
|
-
/**
|
|
55
|
-
* True if there are no validation errors.
|
|
56
|
-
*/
|
|
57
|
-
get valid() {
|
|
58
|
-
return Object.keys(this.errors).length === 0;
|
|
59
|
-
}
|
|
60
|
-
/** Whether this instance has been disposed. */
|
|
61
|
-
get disposed() {
|
|
62
|
-
return this._disposed;
|
|
63
|
-
}
|
|
64
|
-
/** Whether init() has been called. */
|
|
65
|
-
get initialized() {
|
|
66
|
-
return this._initialized;
|
|
67
|
-
}
|
|
68
|
-
/** AbortSignal that fires when this instance is disposed. Lazily created. */
|
|
69
|
-
get disposeSignal() {
|
|
70
|
-
if (!this._abortController) {
|
|
71
|
-
this._abortController = new AbortController();
|
|
72
|
-
}
|
|
73
|
-
return this._abortController.signal;
|
|
74
|
-
}
|
|
75
|
-
/** Initializes the instance. Called automatically by React hooks after mount. */
|
|
76
|
-
init() {
|
|
77
|
-
if (this._initialized || this._disposed) return;
|
|
78
|
-
this._initialized = true;
|
|
79
|
-
return this.onInit?.();
|
|
80
|
-
}
|
|
81
|
-
/**
|
|
82
|
-
* Merges partial state with validation. No-op if no values changed by reference.
|
|
83
|
-
* @protected
|
|
84
|
-
*/
|
|
85
|
-
set(partialOrUpdater) {
|
|
86
|
-
if (this._disposed) {
|
|
87
|
-
throw new Error("Cannot set state on disposed Model");
|
|
88
|
-
}
|
|
89
|
-
let partial;
|
|
90
|
-
if (typeof partialOrUpdater === "function") {
|
|
91
|
-
const result = produceDraft.resolveDraftUpdater(this._state, partialOrUpdater);
|
|
92
|
-
if (!result) return;
|
|
93
|
-
partial = result;
|
|
94
|
-
} else {
|
|
95
|
-
partial = partialOrUpdater;
|
|
96
|
-
}
|
|
97
|
-
const keys = Object.keys(partial);
|
|
98
|
-
const hasChanges = keys.some(
|
|
99
|
-
(key) => partial[key] !== this._state[key]
|
|
100
|
-
);
|
|
101
|
-
if (!hasChanges) {
|
|
102
|
-
return;
|
|
103
|
-
}
|
|
104
|
-
const prev = this._state;
|
|
105
|
-
const next = freeze({ ...prev, ...partial });
|
|
106
|
-
this._state = next;
|
|
107
|
-
this._cachedDirty = null;
|
|
108
|
-
this._cachedErrors = null;
|
|
109
|
-
this.onSet?.(prev, next);
|
|
110
|
-
for (const listener of this._listeners) {
|
|
111
|
-
listener(next, prev);
|
|
112
|
-
}
|
|
113
|
-
}
|
|
114
|
-
/**
|
|
115
|
-
* Mark current state as the new baseline (not dirty).
|
|
116
|
-
*/
|
|
117
|
-
commit() {
|
|
118
|
-
if (this._disposed) {
|
|
119
|
-
throw new Error("Cannot commit on disposed Model");
|
|
120
|
-
}
|
|
121
|
-
this._committed = this._state;
|
|
122
|
-
this._cachedDirty = null;
|
|
123
|
-
this._cachedErrors = null;
|
|
124
|
-
}
|
|
125
|
-
/**
|
|
126
|
-
* Revert state to committed baseline.
|
|
127
|
-
*/
|
|
128
|
-
rollback() {
|
|
129
|
-
if (this._disposed) {
|
|
130
|
-
throw new Error("Cannot rollback on disposed Model");
|
|
131
|
-
}
|
|
132
|
-
if (this._shallowEqual(this._state, this._committed)) {
|
|
133
|
-
return;
|
|
134
|
-
}
|
|
135
|
-
const prev = this._state;
|
|
136
|
-
this._state = this._committed;
|
|
137
|
-
this._cachedDirty = null;
|
|
138
|
-
this._cachedErrors = null;
|
|
139
|
-
this.onSet?.(prev, this._state);
|
|
140
|
-
for (const listener of this._listeners) {
|
|
141
|
-
listener(this._state, prev);
|
|
142
|
-
}
|
|
143
|
-
}
|
|
144
|
-
/** Subscribes to state changes. Returns an unsubscribe function. */
|
|
145
|
-
subscribe(listener) {
|
|
146
|
-
if (this._disposed) {
|
|
147
|
-
return () => {
|
|
148
|
-
};
|
|
149
|
-
}
|
|
150
|
-
this._listeners.add(listener);
|
|
151
|
-
return () => {
|
|
152
|
-
this._listeners.delete(listener);
|
|
153
|
-
};
|
|
154
|
-
}
|
|
155
|
-
/** Tears down the instance, releasing all subscriptions and resources. */
|
|
156
|
-
dispose() {
|
|
157
|
-
if (this._disposed) {
|
|
158
|
-
return;
|
|
159
|
-
}
|
|
160
|
-
this._disposed = true;
|
|
161
|
-
this._abortController?.abort();
|
|
162
|
-
if (this._cleanups) {
|
|
163
|
-
for (const fn of this._cleanups) fn();
|
|
164
|
-
this._cleanups = null;
|
|
165
|
-
}
|
|
166
|
-
this.onDispose?.();
|
|
167
|
-
this._listeners.clear();
|
|
168
|
-
}
|
|
169
|
-
/**
|
|
170
|
-
* Override to provide validation logic.
|
|
171
|
-
* Return an object mapping field keys to error messages.
|
|
172
|
-
*/
|
|
173
|
-
validate(_state) {
|
|
174
|
-
return {};
|
|
175
|
-
}
|
|
176
|
-
/** Registers a cleanup function to be called on dispose. @protected */
|
|
177
|
-
addCleanup(fn) {
|
|
178
|
-
if (!this._cleanups) {
|
|
179
|
-
this._cleanups = [];
|
|
180
|
-
}
|
|
181
|
-
this._cleanups.push(fn);
|
|
182
|
-
}
|
|
183
|
-
/** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
|
|
184
|
-
subscribeTo(source, listener) {
|
|
185
|
-
const unsubscribe = source.subscribe(listener);
|
|
186
|
-
this.addCleanup(unsubscribe);
|
|
187
|
-
return unsubscribe;
|
|
188
|
-
}
|
|
189
|
-
/** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */
|
|
190
|
-
listenTo(source, event, handler) {
|
|
191
|
-
const unsubscribe = source.on(event, handler);
|
|
192
|
-
this.addCleanup(unsubscribe);
|
|
193
|
-
return unsubscribe;
|
|
194
|
-
}
|
|
195
|
-
_shallowEqual(a, b) {
|
|
196
|
-
const keysA = Object.keys(a);
|
|
197
|
-
const keysB = Object.keys(b);
|
|
198
|
-
if (keysA.length !== keysB.length) {
|
|
199
|
-
return false;
|
|
200
|
-
}
|
|
201
|
-
for (const key of keysA) {
|
|
202
|
-
if (a[key] !== b[key]) {
|
|
203
|
-
return false;
|
|
204
|
-
}
|
|
205
|
-
}
|
|
206
|
-
return true;
|
|
207
|
-
}
|
|
13
|
+
return __DEV__ ? Object.freeze(obj) : obj;
|
|
208
14
|
}
|
|
15
|
+
/**
|
|
16
|
+
* Reactive entity with validation and dirty tracking.
|
|
17
|
+
*/
|
|
18
|
+
var Model = class {
|
|
19
|
+
_state;
|
|
20
|
+
_committed;
|
|
21
|
+
_disposed = false;
|
|
22
|
+
_initialized = false;
|
|
23
|
+
_listeners = /* @__PURE__ */ new Set();
|
|
24
|
+
_abortController = null;
|
|
25
|
+
_cleanups = null;
|
|
26
|
+
_cachedDirty = null;
|
|
27
|
+
_cachedErrors = null;
|
|
28
|
+
constructor(initialState) {
|
|
29
|
+
const frozen = freeze({ ...initialState });
|
|
30
|
+
this._state = frozen;
|
|
31
|
+
this._committed = frozen;
|
|
32
|
+
require_bindPublicMethods.bindPublicMethods(this, Object.prototype, PROTECTED_KEYS);
|
|
33
|
+
}
|
|
34
|
+
/** Current frozen state object. */
|
|
35
|
+
get state() {
|
|
36
|
+
return this._state;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* The baseline state for dirty tracking.
|
|
40
|
+
*/
|
|
41
|
+
get committed() {
|
|
42
|
+
return this._committed;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* True if current state differs from committed state.
|
|
46
|
+
*/
|
|
47
|
+
get dirty() {
|
|
48
|
+
if (this._cachedDirty === null) this._cachedDirty = !this._shallowEqual(this._state, this._committed);
|
|
49
|
+
return this._cachedDirty;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Validation errors for the current state.
|
|
53
|
+
*/
|
|
54
|
+
get errors() {
|
|
55
|
+
if (this._cachedErrors === null) this._cachedErrors = this.validate(this._state);
|
|
56
|
+
return this._cachedErrors;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* True if there are no validation errors.
|
|
60
|
+
*/
|
|
61
|
+
get valid() {
|
|
62
|
+
return Object.keys(this.errors).length === 0;
|
|
63
|
+
}
|
|
64
|
+
/** Whether this instance has been disposed. */
|
|
65
|
+
get disposed() {
|
|
66
|
+
return this._disposed;
|
|
67
|
+
}
|
|
68
|
+
/** Whether init() has been called. */
|
|
69
|
+
get initialized() {
|
|
70
|
+
return this._initialized;
|
|
71
|
+
}
|
|
72
|
+
/** AbortSignal that fires when this instance is disposed. Lazily created. */
|
|
73
|
+
get disposeSignal() {
|
|
74
|
+
if (!this._abortController) this._abortController = new AbortController();
|
|
75
|
+
return this._abortController.signal;
|
|
76
|
+
}
|
|
77
|
+
/** Initializes the instance. Called automatically by React hooks after mount. */
|
|
78
|
+
init() {
|
|
79
|
+
if (this._initialized || this._disposed) return;
|
|
80
|
+
this._initialized = true;
|
|
81
|
+
return this.onInit?.();
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Merges partial state with validation. No-op if no values changed by reference.
|
|
85
|
+
* @protected
|
|
86
|
+
*/
|
|
87
|
+
set(partialOrUpdater) {
|
|
88
|
+
if (this._disposed) throw new Error("Cannot set state on disposed Model");
|
|
89
|
+
let partial;
|
|
90
|
+
if (typeof partialOrUpdater === "function") {
|
|
91
|
+
const result = require_produceDraft.resolveDraftUpdater(this._state, partialOrUpdater);
|
|
92
|
+
if (!result) return;
|
|
93
|
+
partial = result;
|
|
94
|
+
} else partial = partialOrUpdater;
|
|
95
|
+
if (!Object.keys(partial).some((key) => partial[key] !== this._state[key])) return;
|
|
96
|
+
const prev = this._state;
|
|
97
|
+
const next = freeze({
|
|
98
|
+
...prev,
|
|
99
|
+
...partial
|
|
100
|
+
});
|
|
101
|
+
this._state = next;
|
|
102
|
+
this._cachedDirty = null;
|
|
103
|
+
this._cachedErrors = null;
|
|
104
|
+
this.onSet?.(prev, next);
|
|
105
|
+
for (const listener of this._listeners) listener(next, prev);
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
* Mark current state as the new baseline (not dirty).
|
|
109
|
+
*/
|
|
110
|
+
commit() {
|
|
111
|
+
if (this._disposed) throw new Error("Cannot commit on disposed Model");
|
|
112
|
+
this._committed = this._state;
|
|
113
|
+
this._cachedDirty = null;
|
|
114
|
+
this._cachedErrors = null;
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* Revert state to committed baseline.
|
|
118
|
+
*/
|
|
119
|
+
rollback() {
|
|
120
|
+
if (this._disposed) throw new Error("Cannot rollback on disposed Model");
|
|
121
|
+
if (this._shallowEqual(this._state, this._committed)) return;
|
|
122
|
+
const prev = this._state;
|
|
123
|
+
this._state = this._committed;
|
|
124
|
+
this._cachedDirty = null;
|
|
125
|
+
this._cachedErrors = null;
|
|
126
|
+
this.onSet?.(prev, this._state);
|
|
127
|
+
for (const listener of this._listeners) listener(this._state, prev);
|
|
128
|
+
}
|
|
129
|
+
/** Subscribes to state changes. Returns an unsubscribe function. */
|
|
130
|
+
subscribe(listener) {
|
|
131
|
+
if (this._disposed) return () => {};
|
|
132
|
+
this._listeners.add(listener);
|
|
133
|
+
return () => {
|
|
134
|
+
this._listeners.delete(listener);
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
/** Tears down the instance, releasing all subscriptions and resources. */
|
|
138
|
+
dispose() {
|
|
139
|
+
if (this._disposed) return;
|
|
140
|
+
this._disposed = true;
|
|
141
|
+
this._abortController?.abort();
|
|
142
|
+
if (this._cleanups) {
|
|
143
|
+
for (const fn of this._cleanups) fn();
|
|
144
|
+
this._cleanups = null;
|
|
145
|
+
}
|
|
146
|
+
this.onDispose?.();
|
|
147
|
+
this._listeners.clear();
|
|
148
|
+
}
|
|
149
|
+
/**
|
|
150
|
+
* Override to provide validation logic.
|
|
151
|
+
* Return an object mapping field keys to error messages.
|
|
152
|
+
*/
|
|
153
|
+
validate(_state) {
|
|
154
|
+
return {};
|
|
155
|
+
}
|
|
156
|
+
/** Registers a cleanup function to be called on dispose. @protected */
|
|
157
|
+
addCleanup(fn) {
|
|
158
|
+
if (!this._cleanups) this._cleanups = [];
|
|
159
|
+
this._cleanups.push(fn);
|
|
160
|
+
}
|
|
161
|
+
/** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
|
|
162
|
+
subscribeTo(source, listener) {
|
|
163
|
+
const unsubscribe = source.subscribe(listener);
|
|
164
|
+
this.addCleanup(unsubscribe);
|
|
165
|
+
return unsubscribe;
|
|
166
|
+
}
|
|
167
|
+
/** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */
|
|
168
|
+
listenTo(source, event, handler) {
|
|
169
|
+
const unsubscribe = source.on(event, handler);
|
|
170
|
+
this.addCleanup(unsubscribe);
|
|
171
|
+
return unsubscribe;
|
|
172
|
+
}
|
|
173
|
+
_shallowEqual(a, b) {
|
|
174
|
+
const keysA = Object.keys(a);
|
|
175
|
+
const keysB = Object.keys(b);
|
|
176
|
+
if (keysA.length !== keysB.length) return false;
|
|
177
|
+
for (const key of keysA) if (a[key] !== b[key]) return false;
|
|
178
|
+
return true;
|
|
179
|
+
}
|
|
180
|
+
};
|
|
181
|
+
//#endregion
|
|
209
182
|
exports.Model = Model;
|
|
210
|
-
|
|
183
|
+
|
|
184
|
+
//# sourceMappingURL=Model.cjs.map
|
package/dist/Model.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Model.cjs","sources":["../src/Model.ts"],"sourcesContent":["import type { Listener, Updater, Subscribable, ValidationErrors, EventPayload } from './types';\nimport { bindPublicMethods } from './bindPublicMethods';\nimport { resolveDraftUpdater } from './produceDraft';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\nconst PROTECTED_KEYS = new Set(['set', 'validate', 'addCleanup', 'subscribeTo', 'listenTo']);\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 bindPublicMethods(this, Object.prototype, PROTECTED_KEYS);\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> | ((draft: S) => void)): void {\n if (this._disposed) {\n throw new Error('Cannot set state on disposed Model');\n }\n\n let partial: Partial<S>;\n if (typeof partialOrUpdater === 'function') {\n const result = resolveDraftUpdater<S>(this._state, partialOrUpdater as (s: S) => Partial<S> | void);\n if (!result) return;\n partial = result;\n } else {\n partial = partialOrUpdater;\n }\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":["bindPublicMethods","resolveDraftUpdater"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"Model.cjs","names":[],"sources":["../src/Model.ts"],"sourcesContent":["import type { Listener, Updater, Subscribable, ValidationErrors, EventPayload } from './types';\nimport { bindPublicMethods } from './bindPublicMethods';\nimport { resolveDraftUpdater } from './produceDraft';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\nconst PROTECTED_KEYS = new Set(['set', 'validate', 'addCleanup', 'subscribeTo', 'listenTo']);\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 bindPublicMethods(this, Object.prototype, PROTECTED_KEYS);\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> | ((draft: S) => void)): void {\n if (this._disposed) {\n throw new Error('Cannot set state on disposed Model');\n }\n\n let partial: Partial<S>;\n if (typeof partialOrUpdater === 'function') {\n const result = resolveDraftUpdater<S>(this._state, partialOrUpdater as (s: S) => Partial<S> | void);\n if (!result) return;\n partial = result;\n } else {\n partial = partialOrUpdater;\n }\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"],"mappings":"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"}
|