@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/router.js CHANGED
@@ -1,387 +1,387 @@
1
- /**
2
- * FileSystemRouter - Next.js style file-based routing for AfriCode
3
- *
4
- * Maps URL paths to files in the pages directory:
5
- * - / → pages/index.html
6
- * - /about → pages/about.html
7
- * - /users/profile → pages/users/profile.html
8
- * - /users/[id] → pages/users/[id].js (dynamic route)
9
- * - /api/users → pages/api/users.js (API routes)
10
- * - /api/[...slug] → pages/api/[...slug].js (catch-all routes)
11
- */
12
-
13
- import { readdirSync, statSync } from 'fs';
14
- import { join, relative, extname } from 'path';
15
-
16
- export class FileSystemRouter {
17
- constructor(pagesDir = './pages') {
18
- this.pagesDir = pagesDir;
19
- this.routes = []; // Ordered routes (dynamic routes last)
20
- this.apiRoutes = []; // API routes
21
- this.routeMap = new Map(); // Static routes for fast lookup
22
- this.scanRoutes();
23
- }
24
-
25
- /**
26
- * Recursively scan the pages directory and build route mappings
27
- * @private
28
- */
29
- scanRoutes() {
30
- try {
31
- this._scanDirectory('', this.pagesDir);
32
-
33
- // Sort routes: exact matches first, then dynamic, then catch-all
34
- this.routes.sort((a, b) => {
35
- const aPriority = this._getRoutePriority(a.pattern);
36
- const bPriority = this._getRoutePriority(b.pattern);
37
- return aPriority - bPriority;
38
- });
39
-
40
- this.apiRoutes.sort((a, b) => {
41
- const aPriority = this._getRoutePriority(a.pattern);
42
- const bPriority = this._getRoutePriority(b.pattern);
43
- return aPriority - bPriority;
44
- });
45
- } catch (error) {
46
- console.warn(`[AfriCode Router] Failed to scan pages directory: ${error.message}`);
47
- }
48
- }
49
-
50
- /**
51
- * Recursively scan a directory for route files
52
- * @private
53
- */
54
- _scanDirectory(prefix, dirPath) {
55
- try {
56
- const entries = readdirSync(dirPath, { withFileTypes: true });
57
-
58
- for (const entry of entries) {
59
- // Skip special files/dirs
60
- if (entry.name.startsWith('.') || entry.name === 'node_modules') {
61
- continue;
62
- }
63
-
64
- const fullPath = join(dirPath, entry.name);
65
- const routePath = prefix ? `${prefix}/${entry.name}` : `/${entry.name}`;
66
-
67
- if (entry.isDirectory()) {
68
- // Recursively scan subdirectories
69
- this._scanDirectory(routePath, fullPath);
70
- } else if (this._isRouteFile(entry.name)) {
71
- this._addRoute(routePath, fullPath, entry.name);
72
- }
73
- }
74
- } catch (error) {
75
- console.warn(`[AfriCode Router] Failed to scan directory ${dirPath}: ${error.message}`);
76
- }
77
- }
78
-
79
- /**
80
- * Check if a file should be treated as a route
81
- * @private
82
- */
83
- _isRouteFile(filename) {
84
- const validExtensions = ['.js', '.jsx', '.ts', '.tsx', '.html'];
85
- return validExtensions.some(ext => filename.endsWith(ext)) &&
86
- filename !== 'package.json';
87
- }
88
-
89
- /**
90
- * Add a route from a file
91
- * @private
92
- */
93
- _addRoute(routePath, filePath, filename) {
94
- // Remove file extension and trailing index
95
- let pattern = routePath.replace(/\.(js|jsx|ts|tsx|html)$/, '');
96
-
97
- // Handle index.js → /
98
- if (pattern.endsWith('/index')) {
99
- pattern = pattern.replace(/\/index$/, '') || '/';
100
- }
101
-
102
- // Separate API routes from page routes
103
- const isApi = pattern.startsWith('/api');
104
-
105
- // Convert file path to route pattern with params
106
- const route = {
107
- pattern,
108
- filePath,
109
- isApi,
110
- isDynamic: pattern.includes('['),
111
- params: this._extractParams(pattern)
112
- };
113
-
114
- // Add to appropriate collection
115
- if (isApi) {
116
- this.apiRoutes.push(route);
117
- } else {
118
- this.routes.push(route);
119
- // Add exact matches to fast lookup map
120
- if (!route.isDynamic) {
121
- this.routeMap.set(pattern, route);
122
- }
123
- }
124
- }
125
-
126
- /**
127
- * Extract parameter names from route pattern
128
- * /users/[id] → ['id']
129
- * /posts/[...slug] → ['slug'] (with rest: true)
130
- * @private
131
- */
132
- _extractParams(pattern) {
133
- const params = {};
134
- const matches = pattern.match(/\[([^\]]+)\]/g) || [];
135
-
136
- matches.forEach((match, index) => {
137
- const name = match.slice(1, -1); // Remove [ and ]
138
- if (name.startsWith('...')) {
139
- params[name.slice(3)] = { rest: true, index };
140
- } else {
141
- params[name] = { rest: false, index };
142
- }
143
- });
144
-
145
- return params;
146
- }
147
-
148
- /**
149
- * Get route priority for sorting
150
- * Lower number = higher priority
151
- * @private
152
- */
153
- _getRoutePriority(pattern) {
154
- // Exact matches: priority 0
155
- if (!pattern.includes('[')) {
156
- return 0;
157
- }
158
-
159
- // Dynamic with rest params (catch-all): priority 2
160
- if (pattern.includes('[...')) {
161
- return 2;
162
- }
163
-
164
- // Regular dynamic params: priority 1
165
- return 1;
166
- }
167
-
168
- /**
169
- * Check if a route matches a URL pathname
170
- * @private
171
- */
172
- _matchRoute(route, pathname) {
173
- if (!route.isDynamic) {
174
- return route.pattern === pathname ? {} : null;
175
- }
176
-
177
- const patternParts = route.pattern.split('/').filter(Boolean);
178
- const pathParts = pathname.split('/').filter(Boolean);
179
-
180
- // Check if catch-all route
181
- const hasCatchAll = Object.values(route.params).some(p => p.rest);
182
-
183
- if (hasCatchAll) {
184
- // Catch-all must match at least as many segments (minus 1 for the catch-all param)
185
- if (pathParts.length < patternParts.length - 1) {
186
- return null;
187
- }
188
-
189
- // Verify static segments match and capture catch-all
190
- const params = {};
191
-
192
- for (let i = 0; i < patternParts.length; i++) {
193
- const part = patternParts[i];
194
-
195
- if (part.startsWith('[...')) {
196
- // Catch-all: capture remaining segments
197
- // [... is 4 chars to remove from start, ] is 1 char from end
198
- const paramName = part.slice(4, -1); // Remove [... and ]
199
- params[paramName] = pathParts.slice(i).join('/');
200
- return params; // IMPORTANT: Return immediately after matching catch-all
201
- } else if (part !== pathParts[i]) {
202
- // Static segment mismatch
203
- return null;
204
- }
205
- }
206
-
207
- return params;
208
- }
209
-
210
- // Not a catch-all route
211
- if (patternParts.length !== pathParts.length) {
212
- return null;
213
- }
214
-
215
- // Regular dynamic route matching (NOT catch-all)
216
- const params = {};
217
- for (let i = 0; i < patternParts.length; i++) {
218
- const part = patternParts[i];
219
-
220
- if (part.startsWith('[')) {
221
- // Dynamic segment
222
- const paramName = part.slice(1, -1);
223
- params[paramName] = pathParts[i];
224
- } else if (part !== pathParts[i]) {
225
- // Static segment mismatch
226
- return null;
227
- }
228
- }
229
-
230
- return params;
231
- }
232
-
233
- /**
234
- * Check which route should be used (prioritize based on specificity)
235
- * @private
236
- */
237
- _findBestMatch(pathname) {
238
- const exactMatches = [];
239
- const dynamicMatches = [];
240
- const catchAllMatches = [];
241
-
242
- // Try all routes
243
- for (const route of this.routes) {
244
- const params = this._matchRoute(route, pathname);
245
- if (params !== null) {
246
- if (!route.isDynamic) {
247
- exactMatches.push({ route, params });
248
- } else if (Object.values(route.params).some(p => p.rest)) {
249
- catchAllMatches.push({ route, params });
250
- } else {
251
- dynamicMatches.push({ route, params });
252
- }
253
- }
254
- }
255
-
256
- // Return best match: exact > dynamic > catch-all
257
- if (exactMatches.length > 0) return exactMatches[0];
258
- if (dynamicMatches.length > 0) return dynamicMatches[0];
259
- if (catchAllMatches.length > 0) return catchAllMatches[0];
260
- return null;
261
- }
262
-
263
- /**
264
- * Check which API route should be used (prioritize based on specificity)
265
- * @private
266
- */
267
- _findBestApiMatch(pathname) {
268
- const exactMatches = [];
269
- const dynamicMatches = [];
270
- const catchAllMatches = [];
271
-
272
- // Try all API routes
273
- for (const route of this.apiRoutes) {
274
- const params = this._matchRoute(route, pathname);
275
- if (params !== null) {
276
- if (!route.isDynamic) {
277
- exactMatches.push({ route, params });
278
- } else if (Object.values(route.params).some(p => p.rest)) {
279
- catchAllMatches.push({ route, params });
280
- } else {
281
- dynamicMatches.push({ route, params });
282
- }
283
- }
284
- }
285
-
286
- // Return best match: exact > dynamic > catch-all
287
- if (exactMatches.length > 0) return exactMatches[0];
288
- if (dynamicMatches.length > 0) return dynamicMatches[0];
289
- if (catchAllMatches.length > 0) return catchAllMatches[0];
290
- return null;
291
- }
292
-
293
- /**
294
- * Resolve a URL path to a file path and extract parameters
295
- * @param {string} pathname - The URL pathname
296
- * @returns {object|null} - { filePath, isApi, params, isDynamic } or null
297
- */
298
- resolve(pathname) {
299
- // Normalize pathname
300
- pathname = pathname.startsWith('/') ? pathname : `/${pathname}`;
301
- if (pathname.endsWith('/') && pathname !== '/') {
302
- pathname = pathname.slice(0, -1);
303
- }
304
-
305
- // Fast path for exact matches
306
- if (this.routeMap.has(pathname)) {
307
- const route = this.routeMap.get(pathname);
308
- return {
309
- filePath: route.filePath,
310
- isApi: route.isApi,
311
- params: {},
312
- isDynamic: false
313
- };
314
- }
315
-
316
- // Check API routes first
317
- const apiMatch = this._findBestApiMatch(pathname);
318
- if (apiMatch) {
319
- return {
320
- filePath: apiMatch.route.filePath,
321
- isApi: true,
322
- params: apiMatch.params,
323
- isDynamic: apiMatch.route.isDynamic
324
- };
325
- }
326
-
327
- // Check page routes
328
- const pageMatch = this._findBestMatch(pathname);
329
- if (pageMatch) {
330
- return {
331
- filePath: pageMatch.route.filePath,
332
- isApi: false,
333
- params: pageMatch.params,
334
- isDynamic: pageMatch.route.isDynamic
335
- };
336
- }
337
-
338
- return null;
339
- }
340
-
341
- /**
342
- * Get all registered routes for debugging/manifest
343
- */
344
- getRoutes() {
345
- return {
346
- pages: this.routes.map(r => ({
347
- pattern: r.pattern,
348
- file: r.filePath,
349
- isDynamic: r.isDynamic
350
- })),
351
- apis: this.apiRoutes.map(r => ({
352
- pattern: r.pattern,
353
- file: r.filePath,
354
- isDynamic: r.isDynamic
355
- }))
356
- };
357
- }
358
-
359
- /**
360
- * Get route manifest for build/analysis
361
- */
362
- getManifest() {
363
- const manifest = {
364
- timestamp: new Date().toISOString(),
365
- pages: {},
366
- apis: {}
367
- };
368
-
369
- for (const route of this.routes) {
370
- manifest.pages[route.pattern] = {
371
- file: relative(this.pagesDir, route.filePath),
372
- dynamic: route.isDynamic,
373
- params: route.params
374
- };
375
- }
376
-
377
- for (const route of this.apiRoutes) {
378
- manifest.apis[route.pattern] = {
379
- file: relative(this.pagesDir, route.filePath),
380
- dynamic: route.isDynamic,
381
- params: route.params
382
- };
383
- }
384
-
385
- return manifest;
386
- }
1
+ /**
2
+ * FileSystemRouter - Next.js style file-based routing for AfriCode
3
+ *
4
+ * Maps URL paths to files in the pages directory:
5
+ * - / → pages/index.html
6
+ * - /about → pages/about.html
7
+ * - /users/profile → pages/users/profile.html
8
+ * - /users/[id] → pages/users/[id].js (dynamic route)
9
+ * - /api/users → pages/api/users.js (API routes)
10
+ * - /api/[...slug] → pages/api/[...slug].js (catch-all routes)
11
+ */
12
+
13
+ import { readdirSync } from 'fs';
14
+ import { join, relative } from 'path';
15
+
16
+ export class FileSystemRouter {
17
+ constructor(pagesDir = './pages') {
18
+ this.pagesDir = pagesDir;
19
+ this.routes = []; // Ordered routes (dynamic routes last)
20
+ this.apiRoutes = []; // API routes
21
+ this.routeMap = new Map(); // Static routes for fast lookup
22
+ this.scanRoutes();
23
+ }
24
+
25
+ /**
26
+ * Recursively scan the pages directory and build route mappings
27
+ * @private
28
+ */
29
+ scanRoutes() {
30
+ try {
31
+ this._scanDirectory('', this.pagesDir);
32
+
33
+ // Sort routes: exact matches first, then dynamic, then catch-all
34
+ this.routes.sort((a, b) => {
35
+ const aPriority = this._getRoutePriority(a.pattern);
36
+ const bPriority = this._getRoutePriority(b.pattern);
37
+ return aPriority - bPriority;
38
+ });
39
+
40
+ this.apiRoutes.sort((a, b) => {
41
+ const aPriority = this._getRoutePriority(a.pattern);
42
+ const bPriority = this._getRoutePriority(b.pattern);
43
+ return aPriority - bPriority;
44
+ });
45
+ } catch (error) {
46
+ console.warn(`[AfriCode Router] Failed to scan pages directory: ${error.message}`);
47
+ }
48
+ }
49
+
50
+ /**
51
+ * Recursively scan a directory for route files
52
+ * @private
53
+ */
54
+ _scanDirectory(prefix, dirPath) {
55
+ try {
56
+ const entries = readdirSync(dirPath, { withFileTypes: true });
57
+
58
+ for (const entry of entries) {
59
+ // Skip special files/dirs
60
+ if (entry.name.startsWith('.') || entry.name === 'node_modules') {
61
+ continue;
62
+ }
63
+
64
+ const fullPath = join(dirPath, entry.name);
65
+ const routePath = prefix ? `${prefix}/${entry.name}` : `/${entry.name}`;
66
+
67
+ if (entry.isDirectory()) {
68
+ // Recursively scan subdirectories
69
+ this._scanDirectory(routePath, fullPath);
70
+ } else if (this._isRouteFile(entry.name)) {
71
+ this._addRoute(routePath, fullPath, entry.name);
72
+ }
73
+ }
74
+ } catch (error) {
75
+ console.warn(`[AfriCode Router] Failed to scan directory ${dirPath}: ${error.message}`);
76
+ }
77
+ }
78
+
79
+ /**
80
+ * Check if a file should be treated as a route
81
+ * @private
82
+ */
83
+ _isRouteFile(filename) {
84
+ const validExtensions = ['.js', '.jsx', '.ts', '.tsx', '.html'];
85
+ return validExtensions.some(ext => filename.endsWith(ext)) &&
86
+ filename !== 'package.json';
87
+ }
88
+
89
+ /**
90
+ * Add a route from a file
91
+ * @private
92
+ */
93
+ _addRoute(routePath, filePath, _filename) {
94
+ // Remove file extension and trailing index
95
+ let pattern = routePath.replace(/\.(js|jsx|ts|tsx|html)$/, '');
96
+
97
+ // Handle index.js → /
98
+ if (pattern.endsWith('/index')) {
99
+ pattern = pattern.replace(/\/index$/, '') || '/';
100
+ }
101
+
102
+ // Separate API routes from page routes
103
+ const isApi = pattern.startsWith('/api');
104
+
105
+ // Convert file path to route pattern with params
106
+ const route = {
107
+ pattern,
108
+ filePath,
109
+ isApi,
110
+ isDynamic: pattern.includes('['),
111
+ params: this._extractParams(pattern)
112
+ };
113
+
114
+ // Add to appropriate collection
115
+ if (isApi) {
116
+ this.apiRoutes.push(route);
117
+ } else {
118
+ this.routes.push(route);
119
+ // Add exact matches to fast lookup map
120
+ if (!route.isDynamic) {
121
+ this.routeMap.set(pattern, route);
122
+ }
123
+ }
124
+ }
125
+
126
+ /**
127
+ * Extract parameter names from route pattern
128
+ * /users/[id] → ['id']
129
+ * /posts/[...slug] → ['slug'] (with rest: true)
130
+ * @private
131
+ */
132
+ _extractParams(pattern) {
133
+ const params = {};
134
+ const matches = pattern.match(/\[([^\]]+)\]/g) || [];
135
+
136
+ matches.forEach((match, index) => {
137
+ const name = match.slice(1, -1); // Remove [ and ]
138
+ if (name.startsWith('...')) {
139
+ params[name.slice(3)] = { rest: true, index };
140
+ } else {
141
+ params[name] = { rest: false, index };
142
+ }
143
+ });
144
+
145
+ return params;
146
+ }
147
+
148
+ /**
149
+ * Get route priority for sorting
150
+ * Lower number = higher priority
151
+ * @private
152
+ */
153
+ _getRoutePriority(pattern) {
154
+ // Exact matches: priority 0
155
+ if (!pattern.includes('[')) {
156
+ return 0;
157
+ }
158
+
159
+ // Dynamic with rest params (catch-all): priority 2
160
+ if (pattern.includes('[...')) {
161
+ return 2;
162
+ }
163
+
164
+ // Regular dynamic params: priority 1
165
+ return 1;
166
+ }
167
+
168
+ /**
169
+ * Check if a route matches a URL pathname
170
+ * @private
171
+ */
172
+ _matchRoute(route, pathname) {
173
+ if (!route.isDynamic) {
174
+ return route.pattern === pathname ? {} : null;
175
+ }
176
+
177
+ const patternParts = route.pattern.split('/').filter(Boolean);
178
+ const pathParts = pathname.split('/').filter(Boolean);
179
+
180
+ // Check if catch-all route
181
+ const hasCatchAll = Object.values(route.params).some(p => p.rest);
182
+
183
+ if (hasCatchAll) {
184
+ // Catch-all must match at least as many segments (minus 1 for the catch-all param)
185
+ if (pathParts.length < patternParts.length - 1) {
186
+ return null;
187
+ }
188
+
189
+ // Verify static segments match and capture catch-all
190
+ const params = {};
191
+
192
+ for (let i = 0; i < patternParts.length; i++) {
193
+ const part = patternParts[i];
194
+
195
+ if (part.startsWith('[...')) {
196
+ // Catch-all: capture remaining segments
197
+ // [... is 4 chars to remove from start, ] is 1 char from end
198
+ const paramName = part.slice(4, -1); // Remove [... and ]
199
+ params[paramName] = pathParts.slice(i).join('/');
200
+ return params; // IMPORTANT: Return immediately after matching catch-all
201
+ } else if (part !== pathParts[i]) {
202
+ // Static segment mismatch
203
+ return null;
204
+ }
205
+ }
206
+
207
+ return params;
208
+ }
209
+
210
+ // Not a catch-all route
211
+ if (patternParts.length !== pathParts.length) {
212
+ return null;
213
+ }
214
+
215
+ // Regular dynamic route matching (NOT catch-all)
216
+ const params = {};
217
+ for (let i = 0; i < patternParts.length; i++) {
218
+ const part = patternParts[i];
219
+
220
+ if (part.startsWith('[')) {
221
+ // Dynamic segment
222
+ const paramName = part.slice(1, -1);
223
+ params[paramName] = pathParts[i];
224
+ } else if (part !== pathParts[i]) {
225
+ // Static segment mismatch
226
+ return null;
227
+ }
228
+ }
229
+
230
+ return params;
231
+ }
232
+
233
+ /**
234
+ * Check which route should be used (prioritize based on specificity)
235
+ * @private
236
+ */
237
+ _findBestMatch(pathname) {
238
+ const exactMatches = [];
239
+ const dynamicMatches = [];
240
+ const catchAllMatches = [];
241
+
242
+ // Try all routes
243
+ for (const route of this.routes) {
244
+ const params = this._matchRoute(route, pathname);
245
+ if (params !== null) {
246
+ if (!route.isDynamic) {
247
+ exactMatches.push({ route, params });
248
+ } else if (Object.values(route.params).some(p => p.rest)) {
249
+ catchAllMatches.push({ route, params });
250
+ } else {
251
+ dynamicMatches.push({ route, params });
252
+ }
253
+ }
254
+ }
255
+
256
+ // Return best match: exact > dynamic > catch-all
257
+ if (exactMatches.length > 0) {return exactMatches[0];}
258
+ if (dynamicMatches.length > 0) {return dynamicMatches[0];}
259
+ if (catchAllMatches.length > 0) {return catchAllMatches[0];}
260
+ return null;
261
+ }
262
+
263
+ /**
264
+ * Check which API route should be used (prioritize based on specificity)
265
+ * @private
266
+ */
267
+ _findBestApiMatch(pathname) {
268
+ const exactMatches = [];
269
+ const dynamicMatches = [];
270
+ const catchAllMatches = [];
271
+
272
+ // Try all API routes
273
+ for (const route of this.apiRoutes) {
274
+ const params = this._matchRoute(route, pathname);
275
+ if (params !== null) {
276
+ if (!route.isDynamic) {
277
+ exactMatches.push({ route, params });
278
+ } else if (Object.values(route.params).some(p => p.rest)) {
279
+ catchAllMatches.push({ route, params });
280
+ } else {
281
+ dynamicMatches.push({ route, params });
282
+ }
283
+ }
284
+ }
285
+
286
+ // Return best match: exact > dynamic > catch-all
287
+ if (exactMatches.length > 0) {return exactMatches[0];}
288
+ if (dynamicMatches.length > 0) {return dynamicMatches[0];}
289
+ if (catchAllMatches.length > 0) {return catchAllMatches[0];}
290
+ return null;
291
+ }
292
+
293
+ /**
294
+ * Resolve a URL path to a file path and extract parameters
295
+ * @param {string} pathname - The URL pathname
296
+ * @returns {object|null} - { filePath, isApi, params, isDynamic } or null
297
+ */
298
+ resolve(pathname) {
299
+ // Normalize pathname
300
+ pathname = pathname.startsWith('/') ? pathname : `/${pathname}`;
301
+ if (pathname.endsWith('/') && pathname !== '/') {
302
+ pathname = pathname.slice(0, -1);
303
+ }
304
+
305
+ // Fast path for exact matches
306
+ if (this.routeMap.has(pathname)) {
307
+ const route = this.routeMap.get(pathname);
308
+ return {
309
+ filePath: route.filePath,
310
+ isApi: route.isApi,
311
+ params: {},
312
+ isDynamic: false
313
+ };
314
+ }
315
+
316
+ // Check API routes first
317
+ const apiMatch = this._findBestApiMatch(pathname);
318
+ if (apiMatch) {
319
+ return {
320
+ filePath: apiMatch.route.filePath,
321
+ isApi: true,
322
+ params: apiMatch.params,
323
+ isDynamic: apiMatch.route.isDynamic
324
+ };
325
+ }
326
+
327
+ // Check page routes
328
+ const pageMatch = this._findBestMatch(pathname);
329
+ if (pageMatch) {
330
+ return {
331
+ filePath: pageMatch.route.filePath,
332
+ isApi: false,
333
+ params: pageMatch.params,
334
+ isDynamic: pageMatch.route.isDynamic
335
+ };
336
+ }
337
+
338
+ return null;
339
+ }
340
+
341
+ /**
342
+ * Get all registered routes for debugging/manifest
343
+ */
344
+ getRoutes() {
345
+ return {
346
+ pages: this.routes.map(r => ({
347
+ pattern: r.pattern,
348
+ file: r.filePath,
349
+ isDynamic: r.isDynamic
350
+ })),
351
+ apis: this.apiRoutes.map(r => ({
352
+ pattern: r.pattern,
353
+ file: r.filePath,
354
+ isDynamic: r.isDynamic
355
+ }))
356
+ };
357
+ }
358
+
359
+ /**
360
+ * Get route manifest for build/analysis
361
+ */
362
+ getManifest() {
363
+ const manifest = {
364
+ timestamp: new Date().toISOString(),
365
+ pages: {},
366
+ apis: {}
367
+ };
368
+
369
+ for (const route of this.routes) {
370
+ manifest.pages[route.pattern] = {
371
+ file: relative(this.pagesDir, route.filePath),
372
+ dynamic: route.isDynamic,
373
+ params: route.params
374
+ };
375
+ }
376
+
377
+ for (const route of this.apiRoutes) {
378
+ manifest.apis[route.pattern] = {
379
+ file: relative(this.pagesDir, route.filePath),
380
+ dynamic: route.isDynamic,
381
+ params: route.params
382
+ };
383
+ }
384
+
385
+ return manifest;
386
+ }
387
387
  }