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