@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
@@ -1,23 +1,23 @@
1
- /**
2
- * AfriCode Add Component Command
3
- */
4
- import { colors } from '../ui.js';
5
-
6
- export async function addComponent(name) {
7
- if (!name) {
8
- console.log(`${colors.red}✗ Please specify a component name${colors.reset}`);
9
- return;
10
- }
11
- const components = {
12
- sidebar: 'af-sidebar',
13
- tooltip: 'af-tooltip',
14
- toast: 'af-toast',
15
- skeleton: 'af-skeleton',
16
- dropdown: 'af-dropdown'
17
- };
18
- if (!components[name]) {
19
- console.log(`${colors.red}✗ Unknown component: ${name}${colors.reset}`);
20
- return;
21
- }
22
- console.log(`${colors.green}✓ Component ${colors.gold}${components[name]}${colors.green} is available in AfriCode!${colors.reset}`);
23
- }
1
+ /**
2
+ * AfriCode Add Component Command
3
+ */
4
+ import { colors } from '../ui.js';
5
+
6
+ export async function addComponent(name) {
7
+ if (!name) {
8
+ console.log(`${colors.red}✗ Please specify a component name${colors.reset}`);
9
+ return;
10
+ }
11
+ const components = {
12
+ sidebar: 'af-sidebar',
13
+ tooltip: 'af-tooltip',
14
+ toast: 'af-toast',
15
+ skeleton: 'af-skeleton',
16
+ dropdown: 'af-dropdown'
17
+ };
18
+ if (!components[name]) {
19
+ console.log(`${colors.red}✗ Unknown component: ${name}${colors.reset}`);
20
+ return;
21
+ }
22
+ console.log(`${colors.green}✓ Component ${colors.gold}${components[name]}${colors.green} is available in AfriCode!${colors.reset}`);
23
+ }
@@ -1,58 +1,58 @@
1
- import { readdirSync, readFileSync, statSync } from 'fs';
2
- import { join } from 'path';
3
-
4
- function scanDirectory(dir, issues = []) {
5
- try {
6
- const files = readdirSync(dir);
7
- for (const file of files) {
8
- const filePath = join(dir, file);
9
- if (statSync(filePath).isDirectory()) {
10
- scanDirectory(filePath, issues);
11
- } else if (file.endsWith('.js') || file.endsWith('.ts') || file.endsWith('.html')) {
12
- const content = readFileSync(filePath, 'utf-8');
13
-
14
- // Static heuristic checks
15
- if (content.includes('<img ') && !content.includes('alt=')) {
16
- issues.push(`[WARN] ${file}: <img> tag missing 'alt' attribute`);
17
- }
18
- if (content.includes('<af-button') && !content.includes('aria-label=') && content.includes('icon=')) {
19
- issues.push(`[HINT] ${file}: Icon-only button might need 'aria-label'`);
20
- }
21
- if (content.includes('<input ') && !content.includes('id=')) {
22
- issues.push(`[HINT] ${file}: Input missing 'id', cannot link to a <label>`);
23
- }
24
- }
25
- }
26
- } catch(e) {
27
- // Ignore if dir doesn't exist
28
- }
29
- return issues;
30
- }
31
-
32
- export async function audit() {
33
- console.log('\n🔍 AfriCode Static Accessibility Hints');
34
- console.log('Note: This is a static analysis heuristic, NOT a full WCAG certification tool.\n');
35
-
36
- const targets = [join(process.cwd(), 'components'), join(process.cwd(), 'pages')];
37
- const allIssues = [];
38
-
39
- for (const target of targets) {
40
- scanDirectory(target, allIssues);
41
- }
42
-
43
- if (allIssues.length > 0) {
44
- console.log('⚠️ Potential Concerns:\n');
45
- allIssues.forEach(issue => console.log(' ' + issue));
46
- } else {
47
- console.log('✨ No obvious static A11y issues detected in UI files.');
48
- }
49
-
50
- console.log('\n💡 Best Practices Check:');
51
- console.log(' - Are all interactive elements reachable by the <Tab> key?');
52
- console.log(' - Do visual icons have an invisible aria-label text?');
53
- console.log(' - Are you using role="dialog" and aria-modal="true" for popups?\n');
54
-
55
- console.log('For comprehensive testing, we recommend:');
56
- console.log(' 1. Axe DevTools browser extension');
57
- console.log(' 2. Screen reader manual testing (VoiceOver/TalkBack)');
58
- }
1
+ import { readdirSync, readFileSync, statSync } from 'fs';
2
+ import { join } from 'path';
3
+
4
+ function scanDirectory(dir, issues = []) {
5
+ try {
6
+ const files = readdirSync(dir);
7
+ for (const file of files) {
8
+ const filePath = join(dir, file);
9
+ if (statSync(filePath).isDirectory()) {
10
+ scanDirectory(filePath, issues);
11
+ } else if (file.endsWith('.js') || file.endsWith('.ts') || file.endsWith('.html')) {
12
+ const content = readFileSync(filePath, 'utf-8');
13
+
14
+ // Static heuristic checks
15
+ if (content.includes('<img ') && !content.includes('alt=')) {
16
+ issues.push(`[WARN] ${file}: <img> tag missing 'alt' attribute`);
17
+ }
18
+ if (content.includes('<af-button') && !content.includes('aria-label=') && content.includes('icon=')) {
19
+ issues.push(`[HINT] ${file}: Icon-only button might need 'aria-label'`);
20
+ }
21
+ if (content.includes('<input ') && !content.includes('id=')) {
22
+ issues.push(`[HINT] ${file}: Input missing 'id', cannot link to a <label>`);
23
+ }
24
+ }
25
+ }
26
+ } catch {
27
+ // Ignore if dir doesn't exist
28
+ }
29
+ return issues;
30
+ }
31
+
32
+ export async function audit() {
33
+ console.log('\n🔍 AfriCode Static Accessibility Hints');
34
+ console.log('Note: This is a static analysis heuristic, NOT a full WCAG certification tool.\n');
35
+
36
+ const targets = [join(process.cwd(), 'components'), join(process.cwd(), 'pages')];
37
+ const allIssues = [];
38
+
39
+ for (const target of targets) {
40
+ scanDirectory(target, allIssues);
41
+ }
42
+
43
+ if (allIssues.length > 0) {
44
+ console.log('⚠️ Potential Concerns:\n');
45
+ allIssues.forEach(issue => console.log(' ' + issue));
46
+ } else {
47
+ console.log('✨ No obvious static A11y issues detected in UI files.');
48
+ }
49
+
50
+ console.log('\n💡 Best Practices Check:');
51
+ console.log(' - Are all interactive elements reachable by the <Tab> key?');
52
+ console.log(' - Do visual icons have an invisible aria-label text?');
53
+ console.log(' - Are you using role="dialog" and aria-modal="true" for popups?\n');
54
+
55
+ console.log('For comprehensive testing, we recommend:');
56
+ console.log(' 1. Axe DevTools browser extension');
57
+ console.log(' 2. Screen reader manual testing (VoiceOver/TalkBack)');
58
+ }
@@ -1,193 +1,193 @@
1
- /**
2
- * AfriCode Build Command
3
- */
4
- import { logo, colors } from '../ui.js';
5
- import { rm, cp, mkdir, readdir, writeFile } from 'fs/promises';
6
- import { existsSync } from 'fs';
7
- import path from 'path';
8
- import { fileURLToPath } from 'url';
9
- import { RawHtml } from '../../html.js';
10
- import { actions } from '../../actions.js';
11
- import { sessionStore } from '../../session-store.js';
12
- import { getConfig } from '../../config.js';
13
-
14
- export async function normalizeRenderOutput(htmlContent) {
15
- if (htmlContent && typeof htmlContent.text === 'function') {
16
- return await htmlContent.text();
17
- }
18
-
19
- if (htmlContent instanceof RawHtml) {
20
- return htmlContent.toString();
21
- }
22
-
23
- if (typeof htmlContent === 'string') {
24
- return htmlContent;
25
- }
26
-
27
- if (htmlContent === null || htmlContent === undefined) {
28
- return '';
29
- }
30
-
31
- if (typeof htmlContent === 'object') {
32
- try {
33
- return JSON.stringify(htmlContent);
34
- } catch (err) {
35
- return String(htmlContent);
36
- }
37
- }
38
-
39
- return String(htmlContent);
40
- }
41
-
42
- export async function build() {
43
- logo();
44
- console.log(`${colors.green}▶ Building for production (SSG + Islands)...${colors.reset}\n`);
45
-
46
- const distDir = './dist';
47
- const cwd = process.cwd();
48
- const resolveProjectDir = (name) => {
49
- const candidates = [`./src/${name}`, `./${name}`];
50
- return candidates.find((candidate) => existsSync(path.join(cwd, candidate))) || candidates[0];
51
- };
52
- const pagesDir = resolveProjectDir('pages');
53
- const componentsDir = resolveProjectDir('components');
54
- const stylesDir = resolveProjectDir('styles');
55
-
56
- try {
57
- const buildStart = performance.now();
58
- await rm(distDir, { recursive: true, force: true });
59
- await mkdir(distDir);
60
-
61
- console.log(' Bundling JavaScript Islands...');
62
- const bundleStart = performance.now();
63
-
64
- // Resolve core paths relative to the framework - Robust for Windows
65
- const __filename = fileURLToPath(import.meta.url);
66
- const __dirname = path.dirname(__filename);
67
- const frameworkCoreDir = path.resolve(__dirname, '../../');
68
- // Use sdk-browser.js for browser builds to avoid server-only imports
69
- const sdkPath = path.join(frameworkCoreDir, 'sdk-browser.js');
70
- const projectComponentsPath = path.resolve(cwd, `${componentsDir}/index.js`);
71
-
72
- // Check if paths exist before building
73
- if (!await Bun.file(sdkPath).exists()) {throw new Error(`SDK not found at ${sdkPath}`);}
74
- if (!await Bun.file(projectComponentsPath).exists()) {throw new Error(`Project components not found at ${projectComponentsPath}`);}
75
-
76
- console.log(` SDK Entry: ${sdkPath}`);
77
- console.log(` Components Entry: ${projectComponentsPath}`);
78
-
79
- let buildResult;
80
- try {
81
- buildResult = await Bun.build({
82
- entrypoints: [sdkPath, projectComponentsPath],
83
- outdir: './dist/assets',
84
- minify: true,
85
- splitting: true,
86
- target: 'browser',
87
- naming: '[name]-[hash].[ext]'
88
- });
89
- } catch (bundleErr) {
90
- console.error(`${colors.red} ! Bun.build threw an exception:${colors.reset}`, bundleErr);
91
- throw bundleErr;
92
- }
93
-
94
- // Log all build output for debugging
95
- for (const log of buildResult.logs) {
96
- console.log(` ${log.level === 'error' ? colors.red : colors.blue} ${log.message}${colors.reset}`);
97
- }
98
-
99
- const bundleEnd = performance.now();
100
- console.log(` ${colors.blue}⚡ Bundled in ${(bundleEnd - bundleStart).toFixed(2)}ms${colors.reset}`);
101
-
102
- if (!buildResult.success) {
103
- throw new Error('Bundle failed');
104
- }
105
-
106
- console.log(' Pre-rendering Pages (SSG)...');
107
- const pageFiles = await readdir(pagesDir);
108
- const routes = [];
109
-
110
- for (const file of pageFiles) {
111
- if (!file.endsWith('.js')) {continue;}
112
-
113
- const name = file.replace('.js', '');
114
- const route = name === 'index' ? '/' : `/${name}`;
115
- routes.push(route);
116
-
117
- const renderStart = performance.now();
118
- console.log(` • Rendering ${route}...`);
119
- const pagePath = path.resolve(process.cwd(), pagesDir, file);
120
- const pageModule = await import(pagePath);
121
-
122
- let loaderData = {};
123
- if (typeof pageModule.loader === 'function') {
124
- loaderData = await pageModule.loader({ request: new Request(`http://localhost${route}`), params: {} });
125
- }
126
-
127
- if (typeof pageModule.default === 'function') {
128
- const sessionId = 'africode-ssg-build';
129
- const requestUrl = new URL(`http://localhost${route}`);
130
- const renderContext = {
131
- data: loaderData,
132
- req: new Request(requestUrl),
133
- url: requestUrl,
134
- method: 'GET',
135
- headers: new Headers(),
136
- pathname: route,
137
- params: {},
138
- config: getConfig(),
139
- projectRoot: cwd,
140
- sessionId,
141
- state: sessionStore.get(sessionId),
142
- actions,
143
- sessionStore,
144
- route: { path: route, params: {}, isDynamic: false, isApi: false }
145
- };
146
- let htmlContent = await pageModule.default(renderContext);
147
- htmlContent = await normalizeRenderOutput(htmlContent);
148
- const outputPath = path.join(distDir, `${name}.html`);
149
- await writeFile(outputPath, htmlContent);
150
- const renderEnd = performance.now();
151
- console.log(` ${colors.blue}⚡ ${name} pre-rendered in ${(renderEnd - renderStart).toFixed(2)}ms${colors.reset}`);
152
- }
153
- }
154
-
155
- console.log(' Generating Sitemap...');
156
- const seoPath = path.join(frameworkCoreDir, 'seo.js');
157
- const { generateSitemap } = await import(seoPath);
158
- const sitemapXml = generateSitemap('https://your-domain.com', routes);
159
- await writeFile(path.join(distDir, 'sitemap.xml'), sitemapXml);
160
-
161
- console.log(' Copying Assets...');
162
- if (await Bun.file(stylesDir).exists()) {await cp(stylesDir, `${distDir}/styles`, { recursive: true });}
163
-
164
- if (await Bun.file('./server.js').exists()) {
165
- console.log(' Bundling Production Server...');
166
- await Bun.build({
167
- entrypoints: ['./server.js'],
168
- outdir: './dist',
169
- target: 'bun'
170
- });
171
- }
172
-
173
- const buildEnd = performance.now();
174
- const totalTime = ((buildEnd - buildStart) / 1000).toFixed(2);
175
-
176
- // Write performance metrics
177
- await writeFile(path.join(distDir, 'performance.json'), JSON.stringify({
178
- totalBuildTime: totalTime,
179
- bundleTime: (bundleEnd - bundleStart).toFixed(2),
180
- pageCount: routes.length,
181
- timestamp: new Date().toISOString()
182
- }, null, 2));
183
-
184
- console.log(`\n${colors.green}✓ Build complete in ${totalTime}s!${colors.reset}`);
185
- console.log(` Output: ${colors.blue}./dist${colors.reset} (Ready to deploy)`);
186
- console.log(` Pages: ${colors.bold}${routes.length}${colors.reset} pre-rendered`);
187
- console.log(` Sitemap: ${colors.blue}./dist/sitemap.xml${colors.reset}\n`);
188
-
189
- } catch (err) {
190
- console.error(`${colors.red}✗ Build failed:${colors.reset}`, err.message || err);
191
- throw err;
192
- }
193
- }
1
+ /**
2
+ * AfriCode Build Command
3
+ */
4
+ import { logo, colors } from '../ui.js';
5
+ import { rm, cp, mkdir, readdir, writeFile } from 'fs/promises';
6
+ import { existsSync } from 'fs';
7
+ import path from 'path';
8
+ import { fileURLToPath } from 'url';
9
+ import { RawHtml } from '../../html.js';
10
+ import { actions } from '../../actions.js';
11
+ import { sessionStore } from '../../session-store.js';
12
+ import { getConfig } from '../../config.js';
13
+
14
+ export async function normalizeRenderOutput(htmlContent) {
15
+ if (htmlContent && typeof htmlContent.text === 'function') {
16
+ return await htmlContent.text();
17
+ }
18
+
19
+ if (htmlContent instanceof RawHtml) {
20
+ return htmlContent.toString();
21
+ }
22
+
23
+ if (typeof htmlContent === 'string') {
24
+ return htmlContent;
25
+ }
26
+
27
+ if (htmlContent === null || htmlContent === undefined) {
28
+ return '';
29
+ }
30
+
31
+ if (typeof htmlContent === 'object') {
32
+ try {
33
+ return JSON.stringify(htmlContent);
34
+ } catch {
35
+ return String(htmlContent);
36
+ }
37
+ }
38
+
39
+ return String(htmlContent);
40
+ }
41
+
42
+ export async function build() {
43
+ logo();
44
+ console.log(`${colors.green}▶ Building for production (SSG + Islands)...${colors.reset}\n`);
45
+
46
+ const distDir = './dist';
47
+ const cwd = process.cwd();
48
+ const resolveProjectDir = (name) => {
49
+ const candidates = [`./src/${name}`, `./${name}`];
50
+ return candidates.find((candidate) => existsSync(path.join(cwd, candidate))) || candidates[0];
51
+ };
52
+ const pagesDir = resolveProjectDir('pages');
53
+ const componentsDir = resolveProjectDir('components');
54
+ const stylesDir = resolveProjectDir('styles');
55
+
56
+ try {
57
+ const buildStart = performance.now();
58
+ await rm(distDir, { recursive: true, force: true });
59
+ await mkdir(distDir);
60
+
61
+ console.log(' Bundling JavaScript Islands...');
62
+ const bundleStart = performance.now();
63
+
64
+ // Resolve core paths relative to the framework - Robust for Windows
65
+ const __filename = fileURLToPath(import.meta.url);
66
+ const __dirname = path.dirname(__filename);
67
+ const frameworkCoreDir = path.resolve(__dirname, '../../');
68
+ // Use sdk-browser.js for browser builds to avoid server-only imports
69
+ const sdkPath = path.join(frameworkCoreDir, 'sdk-browser.js');
70
+ const projectComponentsPath = path.resolve(cwd, `${componentsDir}/index.js`);
71
+
72
+ // Check if paths exist before building
73
+ if (!await Bun.file(sdkPath).exists()) {throw new Error(`SDK not found at ${sdkPath}`);}
74
+ if (!await Bun.file(projectComponentsPath).exists()) {throw new Error(`Project components not found at ${projectComponentsPath}`);}
75
+
76
+ console.log(` SDK Entry: ${sdkPath}`);
77
+ console.log(` Components Entry: ${projectComponentsPath}`);
78
+
79
+ let buildResult;
80
+ try {
81
+ buildResult = await Bun.build({
82
+ entrypoints: [sdkPath, projectComponentsPath],
83
+ outdir: './dist/assets',
84
+ minify: true,
85
+ splitting: true,
86
+ target: 'browser',
87
+ naming: '[name]-[hash].[ext]'
88
+ });
89
+ } catch (bundleErr) {
90
+ console.error(`${colors.red} ! Bun.build threw an exception:${colors.reset}`, bundleErr);
91
+ throw bundleErr;
92
+ }
93
+
94
+ // Log all build output for debugging
95
+ for (const log of buildResult.logs) {
96
+ console.log(` ${log.level === 'error' ? colors.red : colors.blue} ${log.message}${colors.reset}`);
97
+ }
98
+
99
+ const bundleEnd = performance.now();
100
+ console.log(` ${colors.blue}⚡ Bundled in ${(bundleEnd - bundleStart).toFixed(2)}ms${colors.reset}`);
101
+
102
+ if (!buildResult.success) {
103
+ throw new Error('Bundle failed');
104
+ }
105
+
106
+ console.log(' Pre-rendering Pages (SSG)...');
107
+ const pageFiles = await readdir(pagesDir);
108
+ const routes = [];
109
+
110
+ for (const file of pageFiles) {
111
+ if (!file.endsWith('.js')) {continue;}
112
+
113
+ const name = file.replace('.js', '');
114
+ const route = name === 'index' ? '/' : `/${name}`;
115
+ routes.push(route);
116
+
117
+ const renderStart = performance.now();
118
+ console.log(` • Rendering ${route}...`);
119
+ const pagePath = path.resolve(process.cwd(), pagesDir, file);
120
+ const pageModule = await import(pagePath);
121
+
122
+ let loaderData = {};
123
+ if (typeof pageModule.loader === 'function') {
124
+ loaderData = await pageModule.loader({ request: new Request(`http://localhost${route}`), params: {} });
125
+ }
126
+
127
+ if (typeof pageModule.default === 'function') {
128
+ const sessionId = 'africode-ssg-build';
129
+ const requestUrl = new URL(`http://localhost${route}`);
130
+ const renderContext = {
131
+ data: loaderData,
132
+ req: new Request(requestUrl),
133
+ url: requestUrl,
134
+ method: 'GET',
135
+ headers: new Headers(),
136
+ pathname: route,
137
+ params: {},
138
+ config: getConfig(),
139
+ projectRoot: cwd,
140
+ sessionId,
141
+ state: sessionStore.get(sessionId),
142
+ actions,
143
+ sessionStore,
144
+ route: { path: route, params: {}, isDynamic: false, isApi: false }
145
+ };
146
+ let htmlContent = await pageModule.default(renderContext);
147
+ htmlContent = await normalizeRenderOutput(htmlContent);
148
+ const outputPath = path.join(distDir, `${name}.html`);
149
+ await writeFile(outputPath, htmlContent);
150
+ const renderEnd = performance.now();
151
+ console.log(` ${colors.blue}⚡ ${name} pre-rendered in ${(renderEnd - renderStart).toFixed(2)}ms${colors.reset}`);
152
+ }
153
+ }
154
+
155
+ console.log(' Generating Sitemap...');
156
+ const seoPath = path.join(frameworkCoreDir, 'seo.js');
157
+ const { generateSitemap } = await import(seoPath);
158
+ const sitemapXml = generateSitemap('https://your-domain.com', routes);
159
+ await writeFile(path.join(distDir, 'sitemap.xml'), sitemapXml);
160
+
161
+ console.log(' Copying Assets...');
162
+ if (await Bun.file(stylesDir).exists()) {await cp(stylesDir, `${distDir}/styles`, { recursive: true });}
163
+
164
+ if (await Bun.file('./server.js').exists()) {
165
+ console.log(' Bundling Production Server...');
166
+ await Bun.build({
167
+ entrypoints: ['./server.js'],
168
+ outdir: './dist',
169
+ target: 'bun'
170
+ });
171
+ }
172
+
173
+ const buildEnd = performance.now();
174
+ const totalTime = ((buildEnd - buildStart) / 1000).toFixed(2);
175
+
176
+ // Write performance metrics
177
+ await writeFile(path.join(distDir, 'performance.json'), JSON.stringify({
178
+ totalBuildTime: totalTime,
179
+ bundleTime: (bundleEnd - bundleStart).toFixed(2),
180
+ pageCount: routes.length,
181
+ timestamp: new Date().toISOString()
182
+ }, null, 2));
183
+
184
+ console.log(`\n${colors.green}✓ Build complete in ${totalTime}s!${colors.reset}`);
185
+ console.log(` Output: ${colors.blue}./dist${colors.reset} (Ready to deploy)`);
186
+ console.log(` Pages: ${colors.bold}${routes.length}${colors.reset} pre-rendered`);
187
+ console.log(` Sitemap: ${colors.blue}./dist/sitemap.xml${colors.reset}\n`);
188
+
189
+ } catch (err) {
190
+ console.error(`${colors.red}✗ Build failed:${colors.reset}`, err.message || err);
191
+ throw err;
192
+ }
193
+ }