@africode/core 5.0.10 → 5.0.13

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.
Files changed (222) hide show
  1. package/AGENTS.md +585 -585
  2. package/AGENT_INSTRUCTIONS.md +595 -595
  3. package/COMPONENT_SCHEMA.json +1826 -1800
  4. package/LICENSE +623 -623
  5. package/README.md +476 -476
  6. package/bin/africode.js +73 -73
  7. package/bin/cli.ts +82 -82
  8. package/bin/create-africode.js +220 -220
  9. package/bin/scaffold.ts +218 -218
  10. package/components/accordion.js +183 -183
  11. package/components/alert.js +131 -131
  12. package/components/auth-form.js +154 -154
  13. package/components/auth.js +172 -172
  14. package/components/avatar.js +117 -117
  15. package/components/badge.js +104 -104
  16. package/components/base.d.ts +139 -139
  17. package/components/base.js +234 -234
  18. package/components/breadcrumb.js +76 -72
  19. package/components/button.js +164 -164
  20. package/components/card.js +144 -137
  21. package/components/carousel.js +32 -32
  22. package/components/cart-drawer.js +28 -28
  23. package/components/code-block.js +20 -20
  24. package/components/contact-form.js +25 -25
  25. package/components/cookie-consent.js +23 -23
  26. package/components/cta-banner.js +38 -38
  27. package/components/cultural-card.js +243 -243
  28. package/components/dashboard-activity-list.js +103 -103
  29. package/components/dashboard-card.js +85 -85
  30. package/components/dashboard-metric.js +81 -81
  31. package/components/dashboard-shell.js +85 -85
  32. package/components/dashboard-topbar.js +84 -84
  33. package/components/divider.js +83 -83
  34. package/components/dropdown.js +171 -171
  35. package/components/error-boundary.js +155 -155
  36. package/components/faq-accordion.js +23 -23
  37. package/components/feature-grid.js +85 -85
  38. package/components/file-uploader.js +22 -22
  39. package/components/filter-bar.js +19 -19
  40. package/components/footer.js +113 -113
  41. package/components/form.js +131 -131
  42. package/components/gallery.js +22 -22
  43. package/components/hero.js +140 -138
  44. package/components/icon.js +36 -36
  45. package/components/index.js +128 -128
  46. package/components/input.js +252 -256
  47. package/components/kanga-card.js +185 -185
  48. package/components/kyc-upload.js +173 -173
  49. package/components/language-switcher.js +108 -108
  50. package/components/loader.js +80 -80
  51. package/components/modal.js +262 -262
  52. package/components/motion.js +84 -84
  53. package/components/nav-drawer.js +216 -216
  54. package/components/navbar.js +243 -236
  55. package/components/newsletter-signup.js +24 -24
  56. package/components/pagination.js +31 -31
  57. package/components/pattern-showcase.js +225 -225
  58. package/components/pricing-card.js +100 -100
  59. package/components/product-card.js +41 -41
  60. package/components/progress.js +132 -134
  61. package/components/react.js +111 -111
  62. package/components/search-box.js +24 -24
  63. package/components/section.js +54 -54
  64. package/components/select.js +321 -322
  65. package/components/sidebar.js +180 -180
  66. package/components/simple-chart.js +22 -22
  67. package/components/skeleton.js +85 -85
  68. package/components/stepper.js +28 -28
  69. package/components/table.js +181 -181
  70. package/components/tabs.js +202 -202
  71. package/components/team-grid.js +23 -23
  72. package/components/testimonial.js +94 -94
  73. package/components/theme-toggle.js +82 -82
  74. package/components/toast.js +139 -139
  75. package/components/tooltip.js +167 -167
  76. package/components/transaction-ledger.js +138 -138
  77. package/components/ui-avatar.js +79 -79
  78. package/components/ui-badge.js +61 -61
  79. package/components/ui-button.js +149 -149
  80. package/components/ui-card.js +74 -75
  81. package/components/ui-chip.js +87 -87
  82. package/components/ui-input.js +110 -110
  83. package/components/ui-popover.js +84 -84
  84. package/components/ui-progress-ring.js +60 -60
  85. package/components/ui-select.js +85 -85
  86. package/components/ui-stat.js +75 -75
  87. package/components/ui-switch.js +85 -85
  88. package/components/ui-table.js +69 -69
  89. package/components/ui-tabs.js +99 -99
  90. package/components/ui-tag.js +64 -64
  91. package/components/ui-textarea.js +84 -84
  92. package/components/ui-tooltip.js +66 -66
  93. package/components/video-player.js +22 -22
  94. package/components/wallet-balance.js +114 -114
  95. package/core/a2ui-schema-manager.js +351 -351
  96. package/core/a2ui.js +696 -696
  97. package/core/actions.js +27 -27
  98. package/core/bun-runtime.js +398 -397
  99. package/core/cli/commands/add.js +23 -23
  100. package/core/cli/commands/audit.js +58 -58
  101. package/core/cli/commands/build.js +193 -193
  102. package/core/cli/commands/create-plugin.js +241 -241
  103. package/core/cli/commands/dev.js +252 -285
  104. package/core/cli/commands/lint.js +23 -23
  105. package/core/cli/commands/test.js +33 -34
  106. package/core/cli/migrator.js +71 -71
  107. package/core/cli/ui.js +56 -56
  108. package/core/compliance.js +823 -823
  109. package/core/config.js +265 -265
  110. package/core/db-advanced.js +478 -481
  111. package/core/db.js +282 -284
  112. package/core/enhanced-hmr.js +406 -406
  113. package/core/errors.js +222 -222
  114. package/core/file-router.js +52 -50
  115. package/core/hmr-client.js +203 -204
  116. package/core/hmr.js +205 -197
  117. package/core/html.d.ts +30 -30
  118. package/core/html.js +84 -84
  119. package/core/hydration.js +52 -52
  120. package/core/lipa-namba-journey.js +548 -605
  121. package/core/logging.js +14 -14
  122. package/core/middleware.js +145 -145
  123. package/core/motion.js +106 -106
  124. package/core/nida-cig-middleware.js +417 -460
  125. package/core/patterns.d.ts +124 -124
  126. package/core/patterns.js +947 -1001
  127. package/core/plugins/index.js +345 -345
  128. package/core/request-analytics.js +253 -253
  129. package/core/request-identity.js +93 -93
  130. package/core/router.js +386 -386
  131. package/core/sdk-browser.js +140 -140
  132. package/core/sdk-client.js +61 -61
  133. package/core/sdk.d.ts +133 -133
  134. package/core/sdk.js +148 -148
  135. package/core/seo.js +76 -76
  136. package/core/server/auth-endpoints.js +339 -339
  137. package/core/server/auth.js +180 -180
  138. package/core/server/csrf.js +200 -206
  139. package/core/server/db.js +39 -39
  140. package/core/server/middleware.js +324 -324
  141. package/core/server/rate-limit.js +238 -238
  142. package/core/server/render.js +67 -69
  143. package/core/server/router.js +102 -120
  144. package/core/session-store.js +68 -68
  145. package/core/shim.js +28 -28
  146. package/core/state.d.ts +86 -86
  147. package/core/state.js +276 -276
  148. package/core/store.d.ts +122 -122
  149. package/core/store.js +61 -61
  150. package/core/validation.d.ts +232 -232
  151. package/core/validation.js +602 -602
  152. package/core/websocket.js +656 -641
  153. package/dist/africode.js +233 -230
  154. package/dist/africode.js.map +83 -83
  155. package/dist/build-info.json +3 -3
  156. package/dist/components.js +195 -192
  157. package/dist/components.js.map +73 -73
  158. package/dist/styles/africanity.css +321 -321
  159. package/dist/styles/typography.css +140 -140
  160. package/docs/IDE-Guide.md +50 -50
  161. package/package.json +113 -113
  162. package/scripts/generate-component-schema.js +82 -79
  163. package/styles/africanity.css +321 -321
  164. package/styles/typography.css +140 -140
  165. package/templates/starter/.env.example +15 -15
  166. package/templates/starter/africode.config.js +40 -40
  167. package/templates/starter/package.json +13 -13
  168. package/templates/starter/src/index.js +18 -18
  169. package/templates/starter/src/pages/index.html +55 -55
  170. package/templates/starter/src/pages/index.js +17 -17
  171. package/templates/starter/src/styles/main.css +3 -3
  172. package/templates/starter-3d/.env.example +7 -7
  173. package/templates/starter-3d/africode.config.js +29 -29
  174. package/templates/starter-3d/components/af-model-viewer.js +125 -125
  175. package/templates/starter-3d/package.json +14 -14
  176. package/templates/starter-3d/src/pages/index.html +55 -55
  177. package/templates/starter-3d/src/pages/index.js +50 -50
  178. package/templates/starter-3d/src/styles/main.css +3 -3
  179. package/templates/starter-dashboard/.env.example +21 -21
  180. package/templates/starter-dashboard/africode.config.js +20 -20
  181. package/templates/starter-dashboard/package.json +14 -14
  182. package/templates/starter-dashboard/src/index.js +17 -17
  183. package/templates/starter-dashboard/src/pages/api/analytics.js +24 -24
  184. package/templates/starter-dashboard/src/pages/index.html +118 -118
  185. package/templates/starter-dashboard/src/pages/index.js +110 -110
  186. package/templates/starter-dashboard/src/styles/main.css +172 -172
  187. package/templates/starter-fintech/.env.example +28 -28
  188. package/templates/starter-fintech/africode.config.js +20 -20
  189. package/templates/starter-fintech/package.json +15 -15
  190. package/templates/starter-fintech/src/index.js +17 -17
  191. package/templates/starter-fintech/src/pages/api/auth.js +45 -45
  192. package/templates/starter-fintech/src/pages/api/dashboard.js +19 -0
  193. package/templates/starter-fintech/src/pages/api/transfer.js +65 -65
  194. package/templates/starter-fintech/src/pages/api/wallet.js +39 -39
  195. package/templates/starter-fintech/src/pages/api/webhooks/payment.js +32 -32
  196. package/templates/starter-fintech/src/pages/index.html +169 -169
  197. package/templates/starter-fintech/src/pages/index.js +161 -161
  198. package/templates/starter-fintech/src/styles/main.css +246 -246
  199. package/templates/starter-react/.env.example +15 -15
  200. package/templates/starter-react/africode.config.js +40 -40
  201. package/templates/starter-react/package.json +15 -15
  202. package/templates/starter-react/src/pages/index.html +55 -55
  203. package/templates/starter-react/src/pages/index.js +68 -68
  204. package/templates/starter-react/src/styles/main.css +3 -3
  205. package/templates/starter-tailwind/.env.example +15 -15
  206. package/templates/starter-tailwind/africode.config.js +40 -40
  207. package/templates/starter-tailwind/package.json +19 -19
  208. package/templates/starter-tailwind/src/pages/index.html +55 -55
  209. package/templates/starter-tailwind/src/pages/index.js +67 -67
  210. package/templates/starter-tailwind/src/styles/main.css +3 -3
  211. package/templates/starter-tailwind/src/styles/tailwind.css +1 -1
  212. package/templates/starter-tailwind/src/tailwind-loader.js +30 -30
  213. package/templates/starter-tailwind/tailwind.config.cjs +18 -18
  214. package/templates/starter-website/.env.example +18 -18
  215. package/templates/starter-website/africode.config.js +20 -20
  216. package/templates/starter-website/package.json +14 -14
  217. package/templates/starter-website/src/index.js +17 -17
  218. package/templates/starter-website/src/pages/index.html +124 -124
  219. package/templates/starter-website/src/pages/index.js +116 -116
  220. package/templates/starter-website/src/styles/main.css +195 -195
  221. package/bin/africode.js.1758507140 +0 -343
  222. package/core/heartbeat.js +0 -64
package/core/state.js CHANGED
@@ -1,276 +1,276 @@
1
- /**
2
- * AfriCode Reactive State System
3
- *
4
- * A lightweight, Proxy-based reactive state management system
5
- * following the African Fractal philosophy - simple at the core,
6
- * powerful through composition.
7
- *
8
- * @module core/state
9
- */
10
-
11
- // Store for all subscribers per state
12
- const stateSubscribers = new WeakMap();
13
-
14
- // Track nested proxies to avoid duplicates
15
- const proxyCache = new WeakMap();
16
-
17
- /**
18
- * Creates a deeply reactive state object using Proxy
19
- * State changes automatically notify all subscribers
20
- *
21
- * @param {Object} initialState - The initial state object
22
- * @returns {Proxy} A reactive proxy of the state
23
- *
24
- * @example
25
- * const state = createReactiveState({ count: 0, user: { name: 'Amara' } });
26
- * subscribe(() => console.log('State changed!'));
27
- * state.count++; // Logs: "State changed!"
28
- */
29
- export function createReactiveState(initialState) {
30
- // Return cached proxy if already created
31
- if (proxyCache.has(initialState)) {
32
- return proxyCache.get(initialState);
33
- }
34
-
35
- const handler = {
36
- get(target, property, receiver) {
37
- const value = Reflect.get(target, property, receiver);
38
-
39
- // Recursively wrap nested objects
40
- if (value !== null && typeof value === 'object') {
41
- return createReactiveState(value);
42
- }
43
-
44
- return value;
45
- },
46
-
47
- set(target, property, value, receiver) {
48
- const oldValue = Reflect.get(target, property, receiver);
49
-
50
- // Only notify if value actually changed
51
- if (oldValue !== value) {
52
- const result = Reflect.set(target, property, value, receiver);
53
-
54
- if (result) {
55
- notifySubscribers(receiver, value, oldValue, property);
56
- }
57
-
58
- return result;
59
- }
60
-
61
- return true;
62
- },
63
-
64
- deleteProperty(target, property) {
65
- const oldValue = Reflect.get(target, property);
66
- const result = Reflect.deleteProperty(target, property);
67
-
68
- if (result) {
69
- const proxy = proxyCache.get(target);
70
- notifySubscribers(proxy, undefined, oldValue, property);
71
- }
72
-
73
- return result;
74
- }
75
- };
76
-
77
- const proxy = new Proxy(initialState, handler);
78
- proxyCache.set(initialState, proxy);
79
-
80
- return proxy;
81
- }
82
-
83
- /**
84
- * Subscribe to state changes
85
- *
86
- * @param {Proxy} state - The reactive state to subscribe to
87
- * @param {Function} callback - Function to call when state changes
88
- * @returns {Function} Unsubscribe function
89
- *
90
- * @example
91
- * const state = createReactiveState({ count: 0 });
92
- * const unsubscribe = subscribe(state, () => updateUI());
93
- * // Later: unsubscribe();
94
- */
95
- export function subscribe(state, callback) {
96
- if (!stateSubscribers.has(state)) {
97
- stateSubscribers.set(state, new Set());
98
- }
99
-
100
- const subscribers = stateSubscribers.get(state);
101
- subscribers.add(callback);
102
-
103
- // Return unsubscribe function
104
- return () => {
105
- subscribers.delete(callback);
106
- };
107
- }
108
-
109
- /**
110
- * Notify all subscribers of state change
111
- * Uses microtask queue for batched updates
112
- */
113
- function notifySubscribers(state, newValue, oldValue, property) {
114
- // For testing, make synchronous. In production, use microtask
115
- const subscribers = stateSubscribers.get(state);
116
- if (!subscribers) {return;}
117
-
118
- subscribers.forEach(callback => {
119
- try {
120
- callback(newValue, oldValue, property);
121
- } catch (error) {
122
- console.error('[AfriCode State] Subscriber error:', error);
123
- }
124
- });
125
- }
126
-
127
- /**
128
- * Simple server-side state store for Phase 3A
129
- */
130
- export class GlobalState {
131
- constructor() {
132
- this.store = {};
133
- }
134
-
135
- get(path) {
136
- return path.split('/').reduce((obj, key) => obj?.[key], this.store);
137
- }
138
-
139
- set(path, value) {
140
- const keys = path.split('/');
141
- let obj = this.store;
142
-
143
- while (keys.length > 1) {
144
- const key = keys.shift();
145
- if (!obj[key] || typeof obj[key] !== 'object') {
146
- obj[key] = {};
147
- }
148
- obj = obj[key];
149
- }
150
-
151
- obj[keys[0]] = value;
152
- }
153
-
154
- getAll() {
155
- return this.store;
156
- }
157
- }
158
-
159
- export const globalState = new GlobalState();
160
-
161
- /**
162
- * Create a computed value that updates when dependencies change
163
- *
164
- * @param {Function} computeFn - Function that computes the derived value
165
- * @returns {Function} Getter function for the computed value
166
- *
167
- * @example
168
- * const state = createReactiveState({ price: 100, quantity: 2 });
169
- * const total = computed(() => state.price * state.quantity);
170
- * console.log(total()); // 200
171
- */
172
- export function computed(computeFn) {
173
- let cachedValue;
174
- let isDirty = true;
175
-
176
- subscribe(() => {
177
- isDirty = true;
178
- });
179
-
180
- return () => {
181
- if (isDirty) {
182
- cachedValue = computeFn();
183
- isDirty = false;
184
- }
185
- return cachedValue;
186
- };
187
- }
188
-
189
- /**
190
- * Batch multiple state changes into a single notification
191
- *
192
- * @param {Function} updateFn - Function containing multiple state updates
193
- *
194
- * @example
195
- * batch(() => {
196
- * state.name = 'Kwame';
197
- * state.age = 25;
198
- * state.country = 'Ghana';
199
- * }); // Only one notification
200
- */
201
- export function batch(state, updateFn) {
202
- const subscribers = stateSubscribers.get(state) || new Set();
203
- const originalSubscribers = new Set(subscribers);
204
- subscribers.clear();
205
-
206
- try {
207
- updateFn();
208
- } finally {
209
- originalSubscribers.forEach(sub => subscribers.add(sub));
210
- notifySubscribers(state);
211
- }
212
- }
213
-
214
- /**
215
- * Create a simple signal (getter/setter pair)
216
- *
217
- * @param {*} initialValue - The initial value
218
- * @returns {[Function, Function]} [getter, setter]
219
- *
220
- * @example
221
- * const [count, setCount] = createSignal(0);
222
- * console.log(count()); // 0
223
- * setCount(5);
224
- * console.log(count()); // 5
225
- */
226
- export function createSignal(initialValue) {
227
- let value = initialValue;
228
- const signalSubscribers = new Set();
229
-
230
- const getter = () => {
231
- return value;
232
- };
233
-
234
- const setter = (newValue) => {
235
- if (value !== newValue) {
236
- value = typeof newValue === 'function' ? newValue(value) : newValue;
237
- signalSubscribers.forEach(fn => fn());
238
- notifySubscribers();
239
- }
240
- };
241
-
242
- // Allow effects to subscribe to this signal
243
- getter.subscribe = (fn) => {
244
- signalSubscribers.add(fn);
245
- return () => signalSubscribers.delete(fn);
246
- };
247
-
248
- return [getter, setter];
249
- }
250
-
251
- /**
252
- * Create an effect that runs when reactive dependencies change
253
- *
254
- * @param {Function} effectFn - The effect function to run
255
- * @returns {Function} Cleanup function
256
- *
257
- * @example
258
- * const [count, setCount] = createSignal(0);
259
- * createEffect(() => console.log('Count is:', count()));
260
- */
261
- export function createEffect(effectFn) {
262
- // Run immediately
263
- effectFn();
264
- // Subscribe to future changes
265
- return subscribe(effectFn);
266
- }
267
-
268
- // Default export for convenience
269
- export default {
270
- createReactiveState,
271
- subscribe,
272
- computed,
273
- batch,
274
- createSignal,
275
- createEffect
276
- };
1
+ /**
2
+ * AfriCode Reactive State System
3
+ *
4
+ * A lightweight, Proxy-based reactive state management system
5
+ * following the African Fractal philosophy - simple at the core,
6
+ * powerful through composition.
7
+ *
8
+ * @module core/state
9
+ */
10
+
11
+ // Store for all subscribers per state
12
+ const stateSubscribers = new WeakMap();
13
+
14
+ // Track nested proxies to avoid duplicates
15
+ const proxyCache = new WeakMap();
16
+
17
+ /**
18
+ * Creates a deeply reactive state object using Proxy
19
+ * State changes automatically notify all subscribers
20
+ *
21
+ * @param {Object} initialState - The initial state object
22
+ * @returns {Proxy} A reactive proxy of the state
23
+ *
24
+ * @example
25
+ * const state = createReactiveState({ count: 0, user: { name: 'Amara' } });
26
+ * subscribe(() => console.log('State changed!'));
27
+ * state.count++; // Logs: "State changed!"
28
+ */
29
+ export function createReactiveState(initialState) {
30
+ // Return cached proxy if already created
31
+ if (proxyCache.has(initialState)) {
32
+ return proxyCache.get(initialState);
33
+ }
34
+
35
+ const handler = {
36
+ get(target, property, receiver) {
37
+ const value = Reflect.get(target, property, receiver);
38
+
39
+ // Recursively wrap nested objects
40
+ if (value !== null && typeof value === 'object') {
41
+ return createReactiveState(value);
42
+ }
43
+
44
+ return value;
45
+ },
46
+
47
+ set(target, property, value, receiver) {
48
+ const oldValue = Reflect.get(target, property, receiver);
49
+
50
+ // Only notify if value actually changed
51
+ if (oldValue !== value) {
52
+ const result = Reflect.set(target, property, value, receiver);
53
+
54
+ if (result) {
55
+ notifySubscribers(receiver, value, oldValue, property);
56
+ }
57
+
58
+ return result;
59
+ }
60
+
61
+ return true;
62
+ },
63
+
64
+ deleteProperty(target, property) {
65
+ const oldValue = Reflect.get(target, property);
66
+ const result = Reflect.deleteProperty(target, property);
67
+
68
+ if (result) {
69
+ const proxy = proxyCache.get(target);
70
+ notifySubscribers(proxy, undefined, oldValue, property);
71
+ }
72
+
73
+ return result;
74
+ }
75
+ };
76
+
77
+ const proxy = new Proxy(initialState, handler);
78
+ proxyCache.set(initialState, proxy);
79
+
80
+ return proxy;
81
+ }
82
+
83
+ /**
84
+ * Subscribe to state changes
85
+ *
86
+ * @param {Proxy} state - The reactive state to subscribe to
87
+ * @param {Function} callback - Function to call when state changes
88
+ * @returns {Function} Unsubscribe function
89
+ *
90
+ * @example
91
+ * const state = createReactiveState({ count: 0 });
92
+ * const unsubscribe = subscribe(state, () => updateUI());
93
+ * // Later: unsubscribe();
94
+ */
95
+ export function subscribe(state, callback) {
96
+ if (!stateSubscribers.has(state)) {
97
+ stateSubscribers.set(state, new Set());
98
+ }
99
+
100
+ const subscribers = stateSubscribers.get(state);
101
+ subscribers.add(callback);
102
+
103
+ // Return unsubscribe function
104
+ return () => {
105
+ subscribers.delete(callback);
106
+ };
107
+ }
108
+
109
+ /**
110
+ * Notify all subscribers of state change
111
+ * Uses microtask queue for batched updates
112
+ */
113
+ function notifySubscribers(state, newValue, oldValue, property) {
114
+ // For testing, make synchronous. In production, use microtask
115
+ const subscribers = stateSubscribers.get(state);
116
+ if (!subscribers) {return;}
117
+
118
+ subscribers.forEach(callback => {
119
+ try {
120
+ callback(newValue, oldValue, property);
121
+ } catch (error) {
122
+ console.error('[AfriCode State] Subscriber error:', error);
123
+ }
124
+ });
125
+ }
126
+
127
+ /**
128
+ * Simple server-side state store for Phase 3A
129
+ */
130
+ export class GlobalState {
131
+ constructor() {
132
+ this.store = {};
133
+ }
134
+
135
+ get(path) {
136
+ return path.split('/').reduce((obj, key) => obj?.[key], this.store);
137
+ }
138
+
139
+ set(path, value) {
140
+ const keys = path.split('/');
141
+ let obj = this.store;
142
+
143
+ while (keys.length > 1) {
144
+ const key = keys.shift();
145
+ if (!obj[key] || typeof obj[key] !== 'object') {
146
+ obj[key] = {};
147
+ }
148
+ obj = obj[key];
149
+ }
150
+
151
+ obj[keys[0]] = value;
152
+ }
153
+
154
+ getAll() {
155
+ return this.store;
156
+ }
157
+ }
158
+
159
+ export const globalState = new GlobalState();
160
+
161
+ /**
162
+ * Create a computed value that updates when dependencies change
163
+ *
164
+ * @param {Function} computeFn - Function that computes the derived value
165
+ * @returns {Function} Getter function for the computed value
166
+ *
167
+ * @example
168
+ * const state = createReactiveState({ price: 100, quantity: 2 });
169
+ * const total = computed(() => state.price * state.quantity);
170
+ * console.log(total()); // 200
171
+ */
172
+ export function computed(computeFn) {
173
+ let cachedValue;
174
+ let isDirty = true;
175
+
176
+ subscribe(() => {
177
+ isDirty = true;
178
+ });
179
+
180
+ return () => {
181
+ if (isDirty) {
182
+ cachedValue = computeFn();
183
+ isDirty = false;
184
+ }
185
+ return cachedValue;
186
+ };
187
+ }
188
+
189
+ /**
190
+ * Batch multiple state changes into a single notification
191
+ *
192
+ * @param {Function} updateFn - Function containing multiple state updates
193
+ *
194
+ * @example
195
+ * batch(() => {
196
+ * state.name = 'Kwame';
197
+ * state.age = 25;
198
+ * state.country = 'Ghana';
199
+ * }); // Only one notification
200
+ */
201
+ export function batch(state, updateFn) {
202
+ const subscribers = stateSubscribers.get(state) || new Set();
203
+ const originalSubscribers = new Set(subscribers);
204
+ subscribers.clear();
205
+
206
+ try {
207
+ updateFn();
208
+ } finally {
209
+ originalSubscribers.forEach(sub => subscribers.add(sub));
210
+ notifySubscribers(state);
211
+ }
212
+ }
213
+
214
+ /**
215
+ * Create a simple signal (getter/setter pair)
216
+ *
217
+ * @param {*} initialValue - The initial value
218
+ * @returns {[Function, Function]} [getter, setter]
219
+ *
220
+ * @example
221
+ * const [count, setCount] = createSignal(0);
222
+ * console.log(count()); // 0
223
+ * setCount(5);
224
+ * console.log(count()); // 5
225
+ */
226
+ export function createSignal(initialValue) {
227
+ let value = initialValue;
228
+ const signalSubscribers = new Set();
229
+
230
+ const getter = () => {
231
+ return value;
232
+ };
233
+
234
+ const setter = (newValue) => {
235
+ if (value !== newValue) {
236
+ value = typeof newValue === 'function' ? newValue(value) : newValue;
237
+ signalSubscribers.forEach(fn => fn());
238
+ notifySubscribers();
239
+ }
240
+ };
241
+
242
+ // Allow effects to subscribe to this signal
243
+ getter.subscribe = (fn) => {
244
+ signalSubscribers.add(fn);
245
+ return () => signalSubscribers.delete(fn);
246
+ };
247
+
248
+ return [getter, setter];
249
+ }
250
+
251
+ /**
252
+ * Create an effect that runs when reactive dependencies change
253
+ *
254
+ * @param {Function} effectFn - The effect function to run
255
+ * @returns {Function} Cleanup function
256
+ *
257
+ * @example
258
+ * const [count, setCount] = createSignal(0);
259
+ * createEffect(() => console.log('Count is:', count()));
260
+ */
261
+ export function createEffect(effectFn) {
262
+ // Run immediately
263
+ effectFn();
264
+ // Subscribe to future changes
265
+ return subscribe(effectFn);
266
+ }
267
+
268
+ // Default export for convenience
269
+ export default {
270
+ createReactiveState,
271
+ subscribe,
272
+ computed,
273
+ batch,
274
+ createSignal,
275
+ createEffect
276
+ };