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/Model.js
CHANGED
|
@@ -1,210 +1,184 @@
|
|
|
1
1
|
import { bindPublicMethods } from "./bindPublicMethods.js";
|
|
2
2
|
import { resolveDraftUpdater } from "./produceDraft.js";
|
|
3
|
-
|
|
4
|
-
|
|
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
|
+
]);
|
|
5
12
|
function freeze(obj) {
|
|
6
|
-
|
|
13
|
+
return __DEV__ ? Object.freeze(obj) : obj;
|
|
7
14
|
}
|
|
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
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
}
|
|
174
|
-
/** Registers a cleanup function to be called on dispose. @protected */
|
|
175
|
-
addCleanup(fn) {
|
|
176
|
-
if (!this._cleanups) {
|
|
177
|
-
this._cleanups = [];
|
|
178
|
-
}
|
|
179
|
-
this._cleanups.push(fn);
|
|
180
|
-
}
|
|
181
|
-
/** Subscribes to an external Subscribable with automatic cleanup on dispose. @protected */
|
|
182
|
-
subscribeTo(source, listener) {
|
|
183
|
-
const unsubscribe = source.subscribe(listener);
|
|
184
|
-
this.addCleanup(unsubscribe);
|
|
185
|
-
return unsubscribe;
|
|
186
|
-
}
|
|
187
|
-
/** Subscribes to a typed event on a Channel or EventBus with automatic cleanup on dispose. @protected */
|
|
188
|
-
listenTo(source, event, handler) {
|
|
189
|
-
const unsubscribe = source.on(event, handler);
|
|
190
|
-
this.addCleanup(unsubscribe);
|
|
191
|
-
return unsubscribe;
|
|
192
|
-
}
|
|
193
|
-
_shallowEqual(a, b) {
|
|
194
|
-
const keysA = Object.keys(a);
|
|
195
|
-
const keysB = Object.keys(b);
|
|
196
|
-
if (keysA.length !== keysB.length) {
|
|
197
|
-
return false;
|
|
198
|
-
}
|
|
199
|
-
for (const key of keysA) {
|
|
200
|
-
if (a[key] !== b[key]) {
|
|
201
|
-
return false;
|
|
202
|
-
}
|
|
203
|
-
}
|
|
204
|
-
return true;
|
|
205
|
-
}
|
|
206
|
-
}
|
|
207
|
-
export {
|
|
208
|
-
Model
|
|
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
|
+
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 = 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
|
+
}
|
|
209
180
|
};
|
|
210
|
-
//#
|
|
181
|
+
//#endregion
|
|
182
|
+
export { Model };
|
|
183
|
+
|
|
184
|
+
//# sourceMappingURL=Model.js.map
|
package/dist/Model.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Model.js","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":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"Model.js","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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"}
|
package/dist/Pagination.cjs
CHANGED
|
@@ -1,74 +1,76 @@
|
|
|
1
|
-
|
|
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
|
-
}
|
|
1
|
+
const require_Trackable = require("./Trackable.cjs");
|
|
2
|
+
//#region src/Pagination.ts
|
|
3
|
+
/**
|
|
4
|
+
* Page-based pagination state manager with array slicing pipeline.
|
|
5
|
+
* Tracks current page and page size, provides navigation helpers.
|
|
6
|
+
* Subscribable — auto-tracked when used as a ViewModel property.
|
|
7
|
+
*/
|
|
8
|
+
var Pagination = class extends require_Trackable.Trackable {
|
|
9
|
+
_page = 1;
|
|
10
|
+
_pageSize;
|
|
11
|
+
constructor(options) {
|
|
12
|
+
super();
|
|
13
|
+
this._pageSize = options?.pageSize ?? 10;
|
|
14
|
+
}
|
|
15
|
+
/** Current page number (1-based). */
|
|
16
|
+
get page() {
|
|
17
|
+
return this._page;
|
|
18
|
+
}
|
|
19
|
+
/** Number of items per page. */
|
|
20
|
+
get pageSize() {
|
|
21
|
+
return this._pageSize;
|
|
22
|
+
}
|
|
23
|
+
/** Total number of pages for the given item count. */
|
|
24
|
+
pageCount(total) {
|
|
25
|
+
return Math.max(1, Math.ceil(total / this._pageSize));
|
|
26
|
+
}
|
|
27
|
+
/** Whether there is a next page available. */
|
|
28
|
+
hasNext(total) {
|
|
29
|
+
return this._page < this.pageCount(total);
|
|
30
|
+
}
|
|
31
|
+
/** Whether there is a previous page available. */
|
|
32
|
+
hasPrev() {
|
|
33
|
+
return this._page > 1;
|
|
34
|
+
}
|
|
35
|
+
/** Navigate to a specific page (clamped to >= 1). */
|
|
36
|
+
setPage(page) {
|
|
37
|
+
const clamped = Math.max(1, Math.floor(page));
|
|
38
|
+
if (clamped === this._page) return;
|
|
39
|
+
this._page = clamped;
|
|
40
|
+
this.notify();
|
|
41
|
+
}
|
|
42
|
+
/** Change the page size and reset to page 1. */
|
|
43
|
+
setPageSize(size) {
|
|
44
|
+
if (size < 1) return;
|
|
45
|
+
this._pageSize = size;
|
|
46
|
+
this._page = 1;
|
|
47
|
+
this.notify();
|
|
48
|
+
}
|
|
49
|
+
/** Advance to the next page. */
|
|
50
|
+
nextPage() {
|
|
51
|
+
this._page++;
|
|
52
|
+
this.notify();
|
|
53
|
+
}
|
|
54
|
+
/** Go back to the previous page. No-op if already on page 1. */
|
|
55
|
+
prevPage() {
|
|
56
|
+
if (this._page > 1) {
|
|
57
|
+
this._page--;
|
|
58
|
+
this.notify();
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
/** Reset to page 1. */
|
|
62
|
+
reset() {
|
|
63
|
+
if (this._page === 1) return;
|
|
64
|
+
this._page = 1;
|
|
65
|
+
this.notify();
|
|
66
|
+
}
|
|
67
|
+
/** Slice an array to the current page window. Returns the page subset. */
|
|
68
|
+
apply(items) {
|
|
69
|
+
const start = (this._page - 1) * this._pageSize;
|
|
70
|
+
return items.slice(start, start + this._pageSize);
|
|
71
|
+
}
|
|
72
|
+
};
|
|
73
|
+
//#endregion
|
|
73
74
|
exports.Pagination = Pagination;
|
|
74
|
-
|
|
75
|
+
|
|
76
|
+
//# sourceMappingURL=Pagination.cjs.map
|
package/dist/Pagination.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Pagination.cjs","sources":["../src/Pagination.ts"],"sourcesContent":["import { Trackable } from './Trackable';\n\n/**\n * Page-based pagination state manager with array slicing pipeline.\n * Tracks current page and page size, provides navigation helpers.\n * Subscribable — auto-tracked when used as a ViewModel property.\n */\nexport class Pagination extends Trackable {\n private _page: number = 1;\n private _pageSize: number;\n\n constructor(options?: { pageSize?: number }) {\n super();\n this._pageSize = options?.pageSize ?? 10;\n }\n\n // ── Readable state ──\n\n /** Current page number (1-based). */\n get page(): number {\n return this._page;\n }\n\n /** Number of items per page. */\n get pageSize(): number {\n return this._pageSize;\n }\n\n // ── Derived (require total) ──\n\n /** Total number of pages for the given item count. */\n pageCount(total: number): number {\n return Math.max(1, Math.ceil(total / this._pageSize));\n }\n\n /** Whether there is a next page available. */\n hasNext(total: number): boolean {\n return this._page < this.pageCount(total);\n }\n\n /** Whether there is a previous page available. */\n hasPrev(): boolean {\n return this._page > 1;\n }\n\n // ── Actions ──\n\n /** Navigate to a specific page (clamped to >= 1). */\n setPage(page: number): void {\n const clamped = Math.max(1, Math.floor(page));\n if (clamped === this._page) return;\n this._page = clamped;\n this.notify();\n }\n\n /** Change the page size and reset to page 1. */\n setPageSize(size: number): void {\n if (size < 1) return;\n this._pageSize = size;\n this._page = 1;\n this.notify();\n }\n\n /** Advance to the next page. */\n nextPage(): void {\n this._page++;\n this.notify();\n }\n\n /** Go back to the previous page. No-op if already on page 1. */\n prevPage(): void {\n if (this._page > 1) {\n this._page--;\n this.notify();\n }\n }\n\n /** Reset to page 1. */\n reset(): void {\n if (this._page === 1) return;\n this._page = 1;\n this.notify();\n }\n\n // ── Pipeline ──\n\n /** Slice an array to the current page window. Returns the page subset. */\n apply<T>(items: T[]): T[] {\n const start = (this._page - 1) * this._pageSize;\n return items.slice(start, start + this._pageSize);\n }\n}\n"],"
|
|
1
|
+
{"version":3,"file":"Pagination.cjs","names":[],"sources":["../src/Pagination.ts"],"sourcesContent":["import { Trackable } from './Trackable';\n\n/**\n * Page-based pagination state manager with array slicing pipeline.\n * Tracks current page and page size, provides navigation helpers.\n * Subscribable — auto-tracked when used as a ViewModel property.\n */\nexport class Pagination extends Trackable {\n private _page: number = 1;\n private _pageSize: number;\n\n constructor(options?: { pageSize?: number }) {\n super();\n this._pageSize = options?.pageSize ?? 10;\n }\n\n // ── Readable state ──\n\n /** Current page number (1-based). */\n get page(): number {\n return this._page;\n }\n\n /** Number of items per page. */\n get pageSize(): number {\n return this._pageSize;\n }\n\n // ── Derived (require total) ──\n\n /** Total number of pages for the given item count. */\n pageCount(total: number): number {\n return Math.max(1, Math.ceil(total / this._pageSize));\n }\n\n /** Whether there is a next page available. */\n hasNext(total: number): boolean {\n return this._page < this.pageCount(total);\n }\n\n /** Whether there is a previous page available. */\n hasPrev(): boolean {\n return this._page > 1;\n }\n\n // ── Actions ──\n\n /** Navigate to a specific page (clamped to >= 1). */\n setPage(page: number): void {\n const clamped = Math.max(1, Math.floor(page));\n if (clamped === this._page) return;\n this._page = clamped;\n this.notify();\n }\n\n /** Change the page size and reset to page 1. */\n setPageSize(size: number): void {\n if (size < 1) return;\n this._pageSize = size;\n this._page = 1;\n this.notify();\n }\n\n /** Advance to the next page. */\n nextPage(): void {\n this._page++;\n this.notify();\n }\n\n /** Go back to the previous page. No-op if already on page 1. */\n prevPage(): void {\n if (this._page > 1) {\n this._page--;\n this.notify();\n }\n }\n\n /** Reset to page 1. */\n reset(): void {\n if (this._page === 1) return;\n this._page = 1;\n this.notify();\n }\n\n // ── Pipeline ──\n\n /** Slice an array to the current page window. Returns the page subset. */\n apply<T>(items: T[]): T[] {\n const start = (this._page - 1) * this._pageSize;\n return items.slice(start, start + this._pageSize);\n }\n}\n"],"mappings":";;;;;;;AAOA,IAAa,aAAb,cAAgC,kBAAA,UAAU;CACxC,QAAwB;CACxB;CAEA,YAAY,SAAiC;AAC3C,SAAO;AACP,OAAK,YAAY,SAAS,YAAY;;;CAMxC,IAAI,OAAe;AACjB,SAAO,KAAK;;;CAId,IAAI,WAAmB;AACrB,SAAO,KAAK;;;CAMd,UAAU,OAAuB;AAC/B,SAAO,KAAK,IAAI,GAAG,KAAK,KAAK,QAAQ,KAAK,UAAU,CAAC;;;CAIvD,QAAQ,OAAwB;AAC9B,SAAO,KAAK,QAAQ,KAAK,UAAU,MAAM;;;CAI3C,UAAmB;AACjB,SAAO,KAAK,QAAQ;;;CAMtB,QAAQ,MAAoB;EAC1B,MAAM,UAAU,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,CAAC;AAC7C,MAAI,YAAY,KAAK,MAAO;AAC5B,OAAK,QAAQ;AACb,OAAK,QAAQ;;;CAIf,YAAY,MAAoB;AAC9B,MAAI,OAAO,EAAG;AACd,OAAK,YAAY;AACjB,OAAK,QAAQ;AACb,OAAK,QAAQ;;;CAIf,WAAiB;AACf,OAAK;AACL,OAAK,QAAQ;;;CAIf,WAAiB;AACf,MAAI,KAAK,QAAQ,GAAG;AAClB,QAAK;AACL,QAAK,QAAQ;;;;CAKjB,QAAc;AACZ,MAAI,KAAK,UAAU,EAAG;AACtB,OAAK,QAAQ;AACb,OAAK,QAAQ;;;CAMf,MAAS,OAAiB;EACxB,MAAM,SAAS,KAAK,QAAQ,KAAK,KAAK;AACtC,SAAO,MAAM,MAAM,OAAO,QAAQ,KAAK,UAAU"}
|