@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.
- package/AGENTS.md +585 -585
- package/AGENT_INSTRUCTIONS.md +595 -595
- package/COMPONENT_SCHEMA.json +1826 -1800
- package/LICENSE +623 -623
- package/README.md +476 -476
- package/bin/africode.js +73 -73
- package/bin/cli.ts +82 -82
- package/bin/create-africode.js +220 -220
- package/bin/scaffold.ts +218 -218
- package/components/accordion.js +183 -183
- package/components/alert.js +131 -131
- package/components/auth-form.js +154 -154
- package/components/auth.js +172 -172
- package/components/avatar.js +117 -117
- package/components/badge.js +104 -104
- package/components/base.d.ts +139 -139
- package/components/base.js +234 -234
- package/components/breadcrumb.js +76 -72
- package/components/button.js +164 -164
- package/components/card.js +144 -137
- package/components/carousel.js +32 -32
- package/components/cart-drawer.js +28 -28
- package/components/code-block.js +20 -20
- package/components/contact-form.js +25 -25
- package/components/cookie-consent.js +23 -23
- package/components/cta-banner.js +38 -38
- package/components/cultural-card.js +243 -243
- package/components/dashboard-activity-list.js +103 -103
- package/components/dashboard-card.js +85 -85
- package/components/dashboard-metric.js +81 -81
- package/components/dashboard-shell.js +85 -85
- package/components/dashboard-topbar.js +84 -84
- package/components/divider.js +83 -83
- package/components/dropdown.js +171 -171
- package/components/error-boundary.js +155 -155
- package/components/faq-accordion.js +23 -23
- package/components/feature-grid.js +85 -85
- package/components/file-uploader.js +22 -22
- package/components/filter-bar.js +19 -19
- package/components/footer.js +113 -113
- package/components/form.js +131 -131
- package/components/gallery.js +22 -22
- package/components/hero.js +140 -138
- package/components/icon.js +36 -36
- package/components/index.js +128 -128
- package/components/input.js +252 -256
- package/components/kanga-card.js +185 -185
- package/components/kyc-upload.js +173 -173
- package/components/language-switcher.js +108 -108
- package/components/loader.js +80 -80
- package/components/modal.js +262 -262
- package/components/motion.js +84 -84
- package/components/nav-drawer.js +216 -216
- package/components/navbar.js +243 -236
- package/components/newsletter-signup.js +24 -24
- package/components/pagination.js +31 -31
- package/components/pattern-showcase.js +225 -225
- package/components/pricing-card.js +100 -100
- package/components/product-card.js +41 -41
- package/components/progress.js +132 -134
- package/components/react.js +111 -111
- package/components/search-box.js +24 -24
- package/components/section.js +54 -54
- package/components/select.js +321 -322
- package/components/sidebar.js +180 -180
- package/components/simple-chart.js +22 -22
- package/components/skeleton.js +85 -85
- package/components/stepper.js +28 -28
- package/components/table.js +181 -181
- package/components/tabs.js +202 -202
- package/components/team-grid.js +23 -23
- package/components/testimonial.js +94 -94
- package/components/theme-toggle.js +82 -82
- package/components/toast.js +139 -139
- package/components/tooltip.js +167 -167
- package/components/transaction-ledger.js +138 -138
- package/components/ui-avatar.js +79 -79
- package/components/ui-badge.js +61 -61
- package/components/ui-button.js +149 -149
- package/components/ui-card.js +74 -75
- package/components/ui-chip.js +87 -87
- package/components/ui-input.js +110 -110
- package/components/ui-popover.js +84 -84
- package/components/ui-progress-ring.js +60 -60
- package/components/ui-select.js +85 -85
- package/components/ui-stat.js +75 -75
- package/components/ui-switch.js +85 -85
- package/components/ui-table.js +69 -69
- package/components/ui-tabs.js +99 -99
- package/components/ui-tag.js +64 -64
- package/components/ui-textarea.js +84 -84
- package/components/ui-tooltip.js +66 -66
- package/components/video-player.js +22 -22
- package/components/wallet-balance.js +114 -114
- package/core/a2ui-schema-manager.js +351 -351
- package/core/a2ui.js +696 -696
- package/core/actions.js +27 -27
- package/core/bun-runtime.js +398 -397
- package/core/cli/commands/add.js +23 -23
- package/core/cli/commands/audit.js +58 -58
- package/core/cli/commands/build.js +193 -193
- package/core/cli/commands/create-plugin.js +241 -241
- package/core/cli/commands/dev.js +252 -285
- package/core/cli/commands/lint.js +23 -23
- package/core/cli/commands/test.js +33 -34
- package/core/cli/migrator.js +71 -71
- package/core/cli/ui.js +56 -56
- package/core/compliance.js +823 -823
- package/core/config.js +265 -265
- package/core/db-advanced.js +478 -481
- package/core/db.js +282 -284
- package/core/enhanced-hmr.js +406 -406
- package/core/errors.js +222 -222
- package/core/file-router.js +52 -50
- package/core/hmr-client.js +203 -204
- package/core/hmr.js +205 -197
- package/core/html.d.ts +30 -30
- package/core/html.js +84 -84
- package/core/hydration.js +52 -52
- package/core/lipa-namba-journey.js +548 -605
- package/core/logging.js +14 -14
- package/core/middleware.js +145 -145
- package/core/motion.js +106 -106
- package/core/nida-cig-middleware.js +417 -460
- package/core/patterns.d.ts +124 -124
- package/core/patterns.js +947 -1001
- package/core/plugins/index.js +345 -345
- package/core/request-analytics.js +253 -253
- package/core/request-identity.js +93 -93
- package/core/router.js +386 -386
- package/core/sdk-browser.js +140 -140
- package/core/sdk-client.js +61 -61
- package/core/sdk.d.ts +133 -133
- package/core/sdk.js +148 -148
- package/core/seo.js +76 -76
- package/core/server/auth-endpoints.js +339 -339
- package/core/server/auth.js +180 -180
- package/core/server/csrf.js +200 -206
- package/core/server/db.js +39 -39
- package/core/server/middleware.js +324 -324
- package/core/server/rate-limit.js +238 -238
- package/core/server/render.js +67 -69
- package/core/server/router.js +102 -120
- package/core/session-store.js +68 -68
- package/core/shim.js +28 -28
- package/core/state.d.ts +86 -86
- package/core/state.js +276 -276
- package/core/store.d.ts +122 -122
- package/core/store.js +61 -61
- package/core/validation.d.ts +232 -232
- package/core/validation.js +602 -602
- package/core/websocket.js +656 -641
- package/dist/africode.js +233 -230
- package/dist/africode.js.map +83 -83
- package/dist/build-info.json +3 -3
- package/dist/components.js +195 -192
- package/dist/components.js.map +73 -73
- package/dist/styles/africanity.css +321 -321
- package/dist/styles/typography.css +140 -140
- package/docs/IDE-Guide.md +50 -50
- package/package.json +113 -113
- package/scripts/generate-component-schema.js +82 -79
- package/styles/africanity.css +321 -321
- package/styles/typography.css +140 -140
- package/templates/starter/.env.example +15 -15
- package/templates/starter/africode.config.js +40 -40
- package/templates/starter/package.json +13 -13
- package/templates/starter/src/index.js +18 -18
- package/templates/starter/src/pages/index.html +55 -55
- package/templates/starter/src/pages/index.js +17 -17
- package/templates/starter/src/styles/main.css +3 -3
- package/templates/starter-3d/.env.example +7 -7
- package/templates/starter-3d/africode.config.js +29 -29
- package/templates/starter-3d/components/af-model-viewer.js +125 -125
- package/templates/starter-3d/package.json +14 -14
- package/templates/starter-3d/src/pages/index.html +55 -55
- package/templates/starter-3d/src/pages/index.js +50 -50
- package/templates/starter-3d/src/styles/main.css +3 -3
- package/templates/starter-dashboard/.env.example +21 -21
- package/templates/starter-dashboard/africode.config.js +20 -20
- package/templates/starter-dashboard/package.json +14 -14
- package/templates/starter-dashboard/src/index.js +17 -17
- package/templates/starter-dashboard/src/pages/api/analytics.js +24 -24
- package/templates/starter-dashboard/src/pages/index.html +118 -118
- package/templates/starter-dashboard/src/pages/index.js +110 -110
- package/templates/starter-dashboard/src/styles/main.css +172 -172
- package/templates/starter-fintech/.env.example +28 -28
- package/templates/starter-fintech/africode.config.js +20 -20
- package/templates/starter-fintech/package.json +15 -15
- package/templates/starter-fintech/src/index.js +17 -17
- package/templates/starter-fintech/src/pages/api/auth.js +45 -45
- package/templates/starter-fintech/src/pages/api/dashboard.js +19 -0
- package/templates/starter-fintech/src/pages/api/transfer.js +65 -65
- package/templates/starter-fintech/src/pages/api/wallet.js +39 -39
- package/templates/starter-fintech/src/pages/api/webhooks/payment.js +32 -32
- package/templates/starter-fintech/src/pages/index.html +169 -169
- package/templates/starter-fintech/src/pages/index.js +161 -161
- package/templates/starter-fintech/src/styles/main.css +246 -246
- package/templates/starter-react/.env.example +15 -15
- package/templates/starter-react/africode.config.js +40 -40
- package/templates/starter-react/package.json +15 -15
- package/templates/starter-react/src/pages/index.html +55 -55
- package/templates/starter-react/src/pages/index.js +68 -68
- package/templates/starter-react/src/styles/main.css +3 -3
- package/templates/starter-tailwind/.env.example +15 -15
- package/templates/starter-tailwind/africode.config.js +40 -40
- package/templates/starter-tailwind/package.json +19 -19
- package/templates/starter-tailwind/src/pages/index.html +55 -55
- package/templates/starter-tailwind/src/pages/index.js +67 -67
- package/templates/starter-tailwind/src/styles/main.css +3 -3
- package/templates/starter-tailwind/src/styles/tailwind.css +1 -1
- package/templates/starter-tailwind/src/tailwind-loader.js +30 -30
- package/templates/starter-tailwind/tailwind.config.cjs +18 -18
- package/templates/starter-website/.env.example +18 -18
- package/templates/starter-website/africode.config.js +20 -20
- package/templates/starter-website/package.json +14 -14
- package/templates/starter-website/src/index.js +17 -17
- package/templates/starter-website/src/pages/index.html +124 -124
- package/templates/starter-website/src/pages/index.js +116 -116
- package/templates/starter-website/src/styles/main.css +195 -195
- package/bin/africode.js.1758507140 +0 -343
- 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
|
+
};
|