@africode/core 5.0.11 → 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 (221) 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 +396 -396
  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 +248 -283
  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 +47 -47
  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 +23 -11
  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/transfer.js +65 -65
  193. package/templates/starter-fintech/src/pages/api/wallet.js +39 -39
  194. package/templates/starter-fintech/src/pages/api/webhooks/payment.js +32 -32
  195. package/templates/starter-fintech/src/pages/index.html +169 -169
  196. package/templates/starter-fintech/src/pages/index.js +161 -161
  197. package/templates/starter-fintech/src/styles/main.css +246 -246
  198. package/templates/starter-react/.env.example +15 -15
  199. package/templates/starter-react/africode.config.js +40 -40
  200. package/templates/starter-react/package.json +15 -15
  201. package/templates/starter-react/src/pages/index.html +55 -55
  202. package/templates/starter-react/src/pages/index.js +68 -68
  203. package/templates/starter-react/src/styles/main.css +3 -3
  204. package/templates/starter-tailwind/.env.example +15 -15
  205. package/templates/starter-tailwind/africode.config.js +40 -40
  206. package/templates/starter-tailwind/package.json +19 -19
  207. package/templates/starter-tailwind/src/pages/index.html +55 -55
  208. package/templates/starter-tailwind/src/pages/index.js +67 -67
  209. package/templates/starter-tailwind/src/styles/main.css +3 -3
  210. package/templates/starter-tailwind/src/styles/tailwind.css +1 -1
  211. package/templates/starter-tailwind/src/tailwind-loader.js +30 -30
  212. package/templates/starter-tailwind/tailwind.config.cjs +18 -18
  213. package/templates/starter-website/.env.example +18 -18
  214. package/templates/starter-website/africode.config.js +20 -20
  215. package/templates/starter-website/package.json +14 -14
  216. package/templates/starter-website/src/index.js +17 -17
  217. package/templates/starter-website/src/pages/index.html +124 -124
  218. package/templates/starter-website/src/pages/index.js +116 -116
  219. package/templates/starter-website/src/styles/main.css +195 -195
  220. package/bin/africode.js.1758507140 +0 -343
  221. package/core/heartbeat.js +0 -64
package/core/hmr.js CHANGED
@@ -1,197 +1,205 @@
1
- /**
2
- * HMR Server - Hot Module Replacement for AfriCode
3
- *
4
- * Provides:
5
- * - WebSocket server for dev clients
6
- * - File watcher for source changes
7
- * - Module update broadcasting
8
- * - Graceful reload handling
9
- */
10
-
11
- import * as nodePath from 'node:path';
12
- import { watch } from 'node:fs';
13
- import { frameworkLog } from './logging.js';
14
-
15
- export class HMRServer {
16
- constructor(port = 3001) {
17
- this.port = port;
18
- this.clients = new Set();
19
- this.watchers = new Map();
20
- this.fileChanges = new Map();
21
- }
22
-
23
- /**
24
- * Start HMR WebSocket server
25
- */
26
- start(devServer) {
27
- const hmrPort = this.port;
28
-
29
- // Upgrade HTTP connections to WebSocket
30
- devServer.upgrade({
31
- open(ws) {
32
- frameworkLog('log', `[HMR] Client connected from ${ws.remoteAddress}`);
33
- this.clients.add(ws);
34
- },
35
- message(ws, message) {
36
- // Handle ping/pong and client messages
37
- try {
38
- const data = JSON.parse(message);
39
- if (data.type === 'ping') {
40
- ws.send(JSON.stringify({ type: 'pong' }));
41
- }
42
- } catch (e) {
43
- // Invalid message, ignore
44
- }
45
- },
46
- close(ws) {
47
- this.clients.delete(ws);
48
- frameworkLog('log', `[HMR] Client disconnected`);
49
- }
50
- });
51
-
52
- // Start file watching
53
- this.watchDirectory(process.cwd());
54
- frameworkLog('log', `[HMR] Watching for changes...`);
55
- }
56
-
57
- /**
58
- * Watch directory for changes recursively
59
- */
60
- watchDirectory(dir, prefix = '') {
61
- const ignoreDirs = new Set([
62
- 'node_modules', '.git', 'dist', '.bun', 'build',
63
- '.next', 'coverage', 'test-results'
64
- ]);
65
-
66
- try {
67
- const watcher = watch(dir, { recursive: true }, (eventType, filename) => {
68
- if (!filename) return;
69
-
70
- const fullPath = nodePath.join(dir, filename);
71
- const dirName = nodePath.dirname(filename);
72
-
73
- // Ignore node_modules, build files, etc.
74
- if (ignoreDirs.has(dirName.split(nodePath.sep)[0])) return;
75
- if (filename.includes('node_modules')) return;
76
- if (filename.endsWith('.test.js')) return;
77
-
78
- // Only watch JS, JSX, TS, TSX, CSS, HTML
79
- const validExts = ['.js', '.jsx', '.ts', '.tsx', '.css', '.html'];
80
- if (!validExts.some(ext => filename.endsWith(ext))) return;
81
-
82
- // Debounce rapid changes
83
- const changeKey = fullPath;
84
- if (this.fileChanges.has(changeKey)) {
85
- clearTimeout(this.fileChanges.get(changeKey));
86
- }
87
-
88
- const timeoutId = setTimeout(() => {
89
- this.handleFileChange(filename, fullPath);
90
- this.fileChanges.delete(changeKey);
91
- }, 100);
92
-
93
- this.fileChanges.set(changeKey, timeoutId);
94
- });
95
-
96
- this.watchers.set(dir, watcher);
97
- } catch (err) {
98
- frameworkLog('error', `[HMR] Failed to watch ${dir}:`, err.message);
99
- }
100
- }
101
-
102
- /**
103
- * Handle file change - determine type and broadcast update
104
- */
105
- handleFileChange(filename, fullPath) {
106
- const ext = nodePath.extname(filename);
107
- const relativePath = nodePath.relative(process.cwd(), fullPath);
108
- const normalizedPath = relativePath.replace(/\\/g, '/'); // Normalize Windows paths
109
-
110
- // Filter out ignored files
111
- if (normalizedPath.includes('node_modules')) return;
112
- if (normalizedPath.includes('.test.')) return;
113
- if (normalizedPath.includes('test/')) return;
114
-
115
- frameworkLog('log', `[HMR] File changed: ${normalizedPath}`);
116
-
117
- // Determine module type and extract clean path
118
- let moduleType = 'unknown';
119
- let modulePath = normalizedPath;
120
-
121
- if (normalizedPath.includes('pages/') && (ext === '.js' || ext === '.html')) {
122
- moduleType = 'page';
123
- // Extract just the page name from the path
124
- const match = normalizedPath.match(/pages\/([^/]+)/);
125
- modulePath = match ? match[1].replace(ext, '') : normalizedPath;
126
- } else if (normalizedPath.includes('components/') && ext === '.js') {
127
- moduleType = 'component';
128
- // Extract just the component name
129
- const match = normalizedPath.match(/components\/([^/]+)/);
130
- modulePath = match ? match[1].replace(ext, '') : normalizedPath;
131
- } else if (normalizedPath.includes('core/') && ext === '.js') {
132
- moduleType = 'core';
133
- // Extract just the module name
134
- const match = normalizedPath.match(/core\/([^/]+)/);
135
- modulePath = match ? match[1].replace(ext, '') : normalizedPath;
136
- } else if (ext === '.css') {
137
- moduleType = 'style';
138
- } else if (ext === '.html') {
139
- moduleType = 'markup';
140
- }
141
-
142
- // Broadcast change to all connected clients
143
- this.broadcast({
144
- type: 'update',
145
- moduleType,
146
- modulePath,
147
- filename: normalizedPath,
148
- timestamp: Date.now()
149
- });
150
- }
151
-
152
- /**
153
- * Broadcast message to all connected clients
154
- */
155
- broadcast(message) {
156
- const payload = JSON.stringify(message);
157
- let successCount = 0;
158
-
159
- for (const client of this.clients) {
160
- try {
161
- client.send(payload);
162
- successCount++;
163
- } catch (err) {
164
- // Client disconnected, will be cleaned up on next event
165
- }
166
- }
167
-
168
- if (successCount > 0) {
169
- frameworkLog('log', `[HMR] Broadcasted update to ${successCount} client(s)`);
170
- }
171
- }
172
-
173
- /**
174
- * Stop all watchers and close WebSocket connections
175
- */
176
- stop() {
177
- for (const watcher of this.watchers.values()) {
178
- try {
179
- watcher.close();
180
- } catch (err) {
181
- // Ignore close errors
182
- }
183
- }
184
- this.watchers.clear();
185
- this.clients.clear();
186
- frameworkLog('log', `[HMR] Server stopped`);
187
- }
188
- }
189
-
190
- /**
191
- * Create HMR server instance
192
- */
193
- export function createHMRServer(port = 3001) {
194
- return new HMRServer(port);
195
- }
196
-
197
- export default HMRServer;
1
+ /**
2
+ * HMR Server - Hot Module Replacement for AfriCode
3
+ *
4
+ * Provides:
5
+ * - WebSocket server for dev clients
6
+ * - File watcher for source changes
7
+ * - Module update broadcasting
8
+ * - Graceful reload handling
9
+ */
10
+
11
+ import * as nodePath from 'node:path';
12
+ import { watch } from 'node:fs';
13
+ import { frameworkLog } from './logging.js';
14
+
15
+ export class HMRServer {
16
+ constructor(port = 3001) {
17
+ this.port = port;
18
+ this.clients = new Set();
19
+ this.watchers = new Map();
20
+ this.fileChanges = new Map();
21
+ }
22
+
23
+ /**
24
+ * Start HMR WebSocket server
25
+ */
26
+ start(devServer) {
27
+ const hmrPort = this.port;
28
+ void hmrPort;
29
+
30
+ // Upgrade HTTP connections to WebSocket
31
+ devServer.upgrade({
32
+ open(ws) {
33
+ frameworkLog('log', `[HMR] Client connected from ${ws.remoteAddress}`);
34
+ this.clients.add(ws);
35
+ },
36
+ message(ws, message) {
37
+ // Handle ping/pong and client messages
38
+ try {
39
+ const data = JSON.parse(message);
40
+ if (data.type === 'ping') {
41
+ ws.send(JSON.stringify({ type: 'pong' }));
42
+ }
43
+ } catch {
44
+ // Invalid message, ignore
45
+ }
46
+ },
47
+ close(ws) {
48
+ this.clients.delete(ws);
49
+ frameworkLog('log', `[HMR] Client disconnected`);
50
+ }
51
+ });
52
+
53
+ // Start file watching
54
+ this.watchDirectory(process.cwd());
55
+ frameworkLog('log', `[HMR] Watching for changes...`);
56
+ }
57
+
58
+ /**
59
+ * Watch directory for changes recursively
60
+ */
61
+ watchDirectory(dir, prefix = '') {
62
+ void prefix;
63
+ const ignoreDirs = new Set([
64
+ 'node_modules', '.git', 'dist', '.bun', 'build',
65
+ '.next', 'coverage', 'test-results'
66
+ ]);
67
+
68
+ try {
69
+ const watcher = watch(dir, { recursive: true }, (eventType, filename) => {
70
+ if (!filename) {return;}
71
+
72
+ const fullPath = nodePath.join(dir, filename);
73
+ const dirName = nodePath.dirname(filename);
74
+
75
+ // Ignore node_modules, build files, etc.
76
+ if (ignoreDirs.has(dirName.split(nodePath.sep)[0])) {return;}
77
+ if (filename.includes('node_modules')) {return;}
78
+ if (filename.endsWith('.test.js')) {return;}
79
+
80
+ // Only watch JS, JSX, TS, TSX, CSS, HTML
81
+ const validExts = ['.js', '.jsx', '.ts', '.tsx', '.css', '.html'];
82
+ if (!validExts.some(ext => filename.endsWith(ext))) {return;}
83
+
84
+ // Debounce rapid changes
85
+ const changeKey = fullPath;
86
+ if (this.fileChanges.has(changeKey)) {
87
+ clearTimeout(this.fileChanges.get(changeKey));
88
+ }
89
+
90
+ const timeoutId = setTimeout(() => {
91
+ this.handleFileChange(filename, fullPath);
92
+ this.fileChanges.delete(changeKey);
93
+ }, 100);
94
+
95
+ this.fileChanges.set(changeKey, timeoutId);
96
+ });
97
+
98
+ this.watchers.set(dir, watcher);
99
+ } catch (err) {
100
+ frameworkLog('error', `[HMR] Failed to watch ${dir}:`, err.message);
101
+ }
102
+ }
103
+
104
+ /**
105
+ * Handle file change - determine type and broadcast update
106
+ */
107
+ handleFileChange(filename, fullPath) {
108
+ const ext = nodePath.extname(filename);
109
+ const relativePath = nodePath.relative(process.cwd(), fullPath);
110
+ const normalizedPath = relativePath.replace(/\\/g, '/'); // Normalize Windows paths
111
+
112
+ // Filter out ignored files
113
+ if (normalizedPath.includes('node_modules')) {return;}
114
+ if (normalizedPath.includes('.test.')) {return;}
115
+ if (normalizedPath.includes('test/')) {return;}
116
+
117
+ frameworkLog('log', `[HMR] File changed: ${normalizedPath}`);
118
+
119
+ // Determine module type and extract clean path
120
+ let moduleType = 'unknown';
121
+ let modulePath = normalizedPath;
122
+
123
+ if (normalizedPath.includes('pages/') && (ext === '.js' || ext === '.html')) {
124
+ moduleType = 'page';
125
+ // Extract just the page name from the path
126
+ const match = normalizedPath.match(/pages\/([^/]+)/);
127
+ modulePath = match ? match[1].replace(ext, '') : normalizedPath;
128
+ } else if (normalizedPath.includes('components/') && ext === '.js') {
129
+ moduleType = 'component';
130
+ // Extract just the component name
131
+ const match = normalizedPath.match(/components\/([^/]+)/);
132
+ modulePath = match ? match[1].replace(ext, '') : normalizedPath;
133
+ } else if (normalizedPath.includes('core/') && ext === '.js') {
134
+ moduleType = 'core';
135
+ // Extract just the module name
136
+ const match = normalizedPath.match(/core\/([^/]+)/);
137
+ modulePath = match ? match[1].replace(ext, '') : normalizedPath;
138
+ } else if (ext === '.css') {
139
+ moduleType = 'style';
140
+ } else if (ext === '.html') {
141
+ moduleType = 'markup';
142
+ }
143
+
144
+ // Broadcast change to all connected clients
145
+ this.broadcast({
146
+ type: 'update',
147
+ moduleType,
148
+ modulePath,
149
+ filename: normalizedPath,
150
+ timestamp: Date.now()
151
+ });
152
+ }
153
+
154
+ /**
155
+ * Broadcast message to all connected clients
156
+ */
157
+ broadcast(message) {
158
+ const payload = JSON.stringify(message);
159
+ let successCount = 0;
160
+
161
+ for (const client of this.clients) {
162
+ try {
163
+ client.send(payload);
164
+ successCount++;
165
+ } catch {
166
+ // Client disconnected, will be cleaned up on next event
167
+ }
168
+ }
169
+
170
+ if (successCount > 0) {
171
+ frameworkLog('log', `[HMR] Broadcasted update to ${successCount} client(s)`);
172
+ }
173
+ }
174
+
175
+ /**
176
+ * Stop all watchers and close WebSocket connections
177
+ */
178
+ stop() {
179
+ // Clear pending debounce timers
180
+ for (const timeoutId of this.fileChanges.values()) {
181
+ clearTimeout(timeoutId);
182
+ }
183
+ this.fileChanges.clear();
184
+
185
+ for (const watcher of this.watchers.values()) {
186
+ try {
187
+ watcher.close();
188
+ } catch {
189
+ // Ignore close errors
190
+ }
191
+ }
192
+ this.watchers.clear();
193
+ this.clients.clear();
194
+ frameworkLog('log', `[HMR] Server stopped`);
195
+ }
196
+ }
197
+
198
+ /**
199
+ * Create HMR server instance
200
+ */
201
+ export function createHMRServer(port = 3001) {
202
+ return new HMRServer(port);
203
+ }
204
+
205
+ export default HMRServer;
package/core/html.d.ts CHANGED
@@ -1,30 +1,30 @@
1
- /**
2
- * AfriCode HTML Template Engine - TypeScript Definitions
3
- * JSX-free template literal engine
4
- */
5
-
6
- export class RawHtml {
7
- constructor(value: string);
8
- toString(): string;
9
- valueOf(): string;
10
- }
11
-
12
- /**
13
- * HTML template tag function.
14
- * Returns a RawHtml wrapper so callers can opt into trusted output.
15
- */
16
- export function html(
17
- strings: TemplateStringsArray,
18
- ...values: any[]
19
- ): RawHtml;
20
-
21
- export interface LayoutProps {
22
- title?: string;
23
- meta?: string;
24
- stylesheet?: string | false;
25
- children?: RawHtml | string;
26
- }
27
-
28
- export function Layout(props?: LayoutProps): RawHtml;
29
-
30
- export default html;
1
+ /**
2
+ * AfriCode HTML Template Engine - TypeScript Definitions
3
+ * JSX-free template literal engine
4
+ */
5
+
6
+ export class RawHtml {
7
+ constructor(value: string);
8
+ toString(): string;
9
+ valueOf(): string;
10
+ }
11
+
12
+ /**
13
+ * HTML template tag function.
14
+ * Returns a RawHtml wrapper so callers can opt into trusted output.
15
+ */
16
+ export function html(
17
+ strings: TemplateStringsArray,
18
+ ...values: any[]
19
+ ): RawHtml;
20
+
21
+ export interface LayoutProps {
22
+ title?: string;
23
+ meta?: string;
24
+ stylesheet?: string | false;
25
+ children?: RawHtml | string;
26
+ }
27
+
28
+ export function Layout(props?: LayoutProps): RawHtml;
29
+
30
+ export default html;
package/core/html.js CHANGED
@@ -1,84 +1,84 @@
1
- /**
2
- * AfriCode HTML Template Engine
3
- * Phase 2: Defined Rendering System
4
- *
5
- * @module core/html
6
- */
7
-
8
- export class RawHtml {
9
- constructor(value) {
10
- this.value = value;
11
- this.__type = 'RawHtml';
12
- Object.freeze(this);
13
- }
14
-
15
- toString() {
16
- return this.value;
17
- }
18
-
19
- valueOf() {
20
- return this.value;
21
- }
22
- }
23
-
24
- // 🔒 Escape unsafe values
25
- function escapeHtml(value) {
26
- return String(value)
27
- .replace(/&/g, "&")
28
- .replace(/</g, "&lt;")
29
- .replace(/>/g, "&gt;")
30
- .replace(/"/g, "&quot;")
31
- .replace(/'/g, "&#039;");
32
- }
33
-
34
- // 🧠 Main rendering function
35
- export const html = (strings, ...values) => {
36
- let result = "";
37
-
38
- for (let i = 0; i < strings.length; i++) {
39
- result += strings[i];
40
-
41
- if (i < values.length) {
42
- result += interpolateValue(values[i]);
43
- }
44
- }
45
-
46
- return new RawHtml(result);
47
- };
48
-
49
- export function Layout({ title = 'AfriCode App', meta = '', stylesheet = '/styles/africanity.css', children } = {}) {
50
- return html`<!DOCTYPE html>
51
- <html lang="en">
52
- <head>
53
- <meta charset="UTF-8">
54
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
55
- <title>${title}</title>
56
- ${meta}
57
- ${stylesheet ? html`<link rel="stylesheet" href="${stylesheet}">` : ''}
58
- <script type="module" src="/core/sdk.js"></script>
59
- </head>
60
- <body>
61
- ${children}
62
- </body>
63
- </html>`;
64
- }
65
-
66
- function interpolateValue(value) {
67
- if (value instanceof RawHtml) {
68
- return value.toString();
69
- }
70
-
71
- if (Array.isArray(value)) {
72
- return value.map(interpolateValue).join('');
73
- }
74
-
75
- if (value === null || value === undefined || value === false) {
76
- return '';
77
- }
78
-
79
- if (value === true) {
80
- return 'true';
81
- }
82
-
83
- return escapeHtml(value);
84
- }
1
+ /**
2
+ * AfriCode HTML Template Engine
3
+ * Phase 2: Defined Rendering System
4
+ *
5
+ * @module core/html
6
+ */
7
+
8
+ export class RawHtml {
9
+ constructor(value) {
10
+ this.value = value;
11
+ this.__type = 'RawHtml';
12
+ Object.freeze(this);
13
+ }
14
+
15
+ toString() {
16
+ return this.value;
17
+ }
18
+
19
+ valueOf() {
20
+ return this.value;
21
+ }
22
+ }
23
+
24
+ // 🔒 Escape unsafe values
25
+ function escapeHtml(value) {
26
+ return String(value)
27
+ .replace(/&/g, "&amp;")
28
+ .replace(/</g, "&lt;")
29
+ .replace(/>/g, "&gt;")
30
+ .replace(/"/g, "&quot;")
31
+ .replace(/'/g, "&#039;");
32
+ }
33
+
34
+ // 🧠 Main rendering function
35
+ export const html = (strings, ...values) => {
36
+ let result = "";
37
+
38
+ for (let i = 0; i < strings.length; i++) {
39
+ result += strings[i];
40
+
41
+ if (i < values.length) {
42
+ result += interpolateValue(values[i]);
43
+ }
44
+ }
45
+
46
+ return new RawHtml(result);
47
+ };
48
+
49
+ export function Layout({ title = 'AfriCode App', meta = '', stylesheet = '/styles/africanity.css', children } = {}) {
50
+ return html`<!DOCTYPE html>
51
+ <html lang="en">
52
+ <head>
53
+ <meta charset="UTF-8">
54
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
55
+ <title>${title}</title>
56
+ ${meta}
57
+ ${stylesheet ? html`<link rel="stylesheet" href="${stylesheet}">` : ''}
58
+ <script type="module" src="/core/sdk.js"></script>
59
+ </head>
60
+ <body>
61
+ ${children}
62
+ </body>
63
+ </html>`;
64
+ }
65
+
66
+ function interpolateValue(value) {
67
+ if (value instanceof RawHtml) {
68
+ return value.toString();
69
+ }
70
+
71
+ if (Array.isArray(value)) {
72
+ return value.map(interpolateValue).join('');
73
+ }
74
+
75
+ if (value === null || value === undefined || value === false) {
76
+ return '';
77
+ }
78
+
79
+ if (value === true) {
80
+ return 'true';
81
+ }
82
+
83
+ return escapeHtml(value);
84
+ }