@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/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
|
|
14
|
-
import { join, relative
|
|
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,
|
|
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
|
}
|