@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,120 +1,102 @@
1
- /**
2
- * AfriCode Server-Side Router
3
- *
4
- * Handles dynamic API routing by mapping URLs to the file system.
5
- * Edge-Ready: Uses strictly standard Request/Response objects.
6
- */
7
-
8
- const fs = require('fs');
9
- const path = require('path');
10
-
11
- // Cache routes in memory for performance
12
- const routeCache = new Map();
13
-
14
- /**
15
- * Discovers API routes in the /pages/api directory
16
- * Note: In a pure Edge environment (Cloudflare), this would be replaced
17
- * by a build-time manifest injection.
18
- */
19
- async function loadRoutes() {
20
- const apiDir = path.join(process.cwd(), 'pages', 'api');
21
-
22
- if (!fs.existsSync(apiDir)) {return;}
23
-
24
- const files = fs.readdirSync(apiDir);
25
-
26
- for (const file of files) {
27
- if (file.endsWith('.js')) {
28
- const routeName = '/api/' + file.replace('.js', '');
29
- const modulePath = path.join(apiDir, file);
30
- routeCache.set(routeName, modulePath);
31
- console.log(`✓ Registered Route: ${routeName}`);
32
- }
33
- }
34
- }
35
-
36
- /**
37
- * HTTP Method Handler
38
- * @param {object} module - The imported API module
39
- * @param {Request} req - The incoming request
40
- * @returns {Promise<Response>}
41
- */
42
- async function executeHandler(module, req) {
43
- const method = req.method.toUpperCase();
44
-
45
- if (module[method]) {
46
- return await module[method](req);
47
- } else if (module.default) {
48
- return await module.default(req);
49
- }
50
-
51
- return new Response('Method Not Allowed', { status: 405 });
52
- }
53
-
54
- /**
55
- * Router Handler
56
- * @param {Request} req
57
- * @returns {Promise<Response|null>}
58
- */
59
- export async function handleApiRequest(req) {
60
- const url = new URL(req.url);
61
- const pathname = url.pathname;
62
-
63
- // 0. Handle built-in auth endpoints
64
- if (pathname.startsWith('/api/auth/')) {
65
- try {
66
- const { handleAuthRequest } = await import('./auth-endpoints.js');
67
- const authResponse = await handleAuthRequest(req, pathname);
68
- if (authResponse) {
69
- return authResponse;
70
- }
71
- } catch (err) {
72
- console.error(`Auth endpoint error at ${pathname}:`, err);
73
- return new Response(JSON.stringify({ error: err.message }), {
74
- status: 500,
75
- headers: { 'Content-Type': 'application/json' }
76
- });
77
- }
78
- }
79
-
80
- // Load routes lazily
81
- if (routeCache.size === 0) {
82
- await loadRoutes();
83
- }
84
-
85
- // 1. Exact Match
86
- let modulePath = routeCache.get(pathname);
87
-
88
- // 2. Dynamic Match (Basic implementation)
89
- // If no exact match, look for dynamic routes [id].js?
90
- if (!modulePath) {
91
- for (const [route, path] of routeCache.entries()) {
92
- if (route.includes('[') && matchDynamicRoute(route, pathname)) {
93
- modulePath = path;
94
- // We would inject params into request here
95
- break;
96
- }
97
- }
98
- }
99
-
100
- if (modulePath) {
101
- try {
102
- // Import the module
103
- const module = await import(modulePath);
104
- return await executeHandler(module, req);
105
- } catch (err) {
106
- console.error(`Status 500 at ${pathname}:`, err);
107
- return new Response(JSON.stringify({ error: err.message }), {
108
- status: 500,
109
- headers: { 'Content-Type': 'application/json' }
110
- });
111
- }
112
- }
113
-
114
- return null; // Not captured -> 404 handled by server.js
115
- }
116
-
117
- function matchDynamicRoute(routePattern, actualPath) {
118
- // Placeholder logic for future expansion
119
- return false;
120
- }
1
+ /**
2
+ * AfriCode development API router.
3
+ *
4
+ * Uses the same recursive FileSystemRouter as the production runtime so
5
+ * `src/pages/api` and nested API routes work in `africode dev` too.
6
+ */
7
+
8
+ import { FileSystemRouter } from '../router.js';
9
+ import { existsSync } from 'node:fs';
10
+ import { resolve } from 'node:path';
11
+ import { pathToFileURL } from 'node:url';
12
+
13
+ const routerCache = new Map();
14
+
15
+ function getProjectRoot(options = {}) {
16
+ return resolve(options.projectRoot || process.cwd());
17
+ }
18
+
19
+ function getAbsolutePagesDir(projectRoot, pagesDir) {
20
+ return resolve(projectRoot, pagesDir || 'pages');
21
+ }
22
+
23
+ function getRouter(pagesDir, { reload = false } = {}) {
24
+ const absolutePagesDir = resolve(pagesDir);
25
+ let router = reload ? null : routerCache.get(absolutePagesDir);
26
+
27
+ if (!router) {
28
+ router = new FileSystemRouter(absolutePagesDir);
29
+ routerCache.set(absolutePagesDir, router);
30
+ for (const route of router.getRoutes().apis) {
31
+ console.log(`[AfriCode] Registered API route: ${route.pattern}`);
32
+ }
33
+ }
34
+
35
+ return router;
36
+ }
37
+
38
+ async function getConfiguredPagesDir(projectRoot) {
39
+ const configPath = resolve(projectRoot, 'africode.config.js');
40
+
41
+ try {
42
+ const config = (await import(configPath + '?t=' + Date.now())).default || {};
43
+ return config.directories?.pages || config.pagesDir ||
44
+ (existsSync(resolve(projectRoot, 'src/pages')) ? 'src/pages' : 'pages');
45
+ } catch {
46
+ return existsSync(resolve(projectRoot, 'src/pages')) ? 'src/pages' : 'pages';
47
+ }
48
+ }
49
+
50
+ async function executeHandler(module, req) {
51
+ const method = req.method.toUpperCase();
52
+
53
+ if (module[method]) {
54
+ return await module[method](req);
55
+ }
56
+
57
+ if (module.default) {
58
+ return await module.default(req);
59
+ }
60
+
61
+ return new Response('Method Not Allowed', { status: 405 });
62
+ }
63
+
64
+ export async function handleApiRequest(req, options = {}) {
65
+ const url = new URL(req.url);
66
+ const pathname = url.pathname;
67
+ const projectRoot = getProjectRoot(options);
68
+
69
+ if (pathname.startsWith('/api/auth/')) {
70
+ try {
71
+ const { handleAuthRequest } = await import('./auth-endpoints.js');
72
+ const authResponse = await handleAuthRequest(req, pathname);
73
+ if (authResponse) {return authResponse;}
74
+ } catch (err) {
75
+ console.error(`Auth endpoint error at ${pathname}:`, err);
76
+ return new Response(JSON.stringify({ error: err.message }), {
77
+ status: 500,
78
+ headers: { 'Content-Type': 'application/json' }
79
+ });
80
+ }
81
+ }
82
+
83
+ const pagesDir = getAbsolutePagesDir(
84
+ projectRoot,
85
+ options.pagesDir || await getConfiguredPagesDir(projectRoot)
86
+ );
87
+ const route = getRouter(pagesDir, { reload: options.reloadRoutes === true }).resolve(pathname);
88
+
89
+ if (!route?.isApi) {return null;}
90
+
91
+ try {
92
+ const moduleUrl = pathToFileURL(route.filePath).href + '?t=' + Date.now();
93
+ const module = await import(moduleUrl);
94
+ return await executeHandler(module, req);
95
+ } catch (err) {
96
+ console.error(`Status 500 at ${pathname}:`, err);
97
+ return new Response(JSON.stringify({ error: err.message }), {
98
+ status: 500,
99
+ headers: { 'Content-Type': 'application/json' }
100
+ });
101
+ }
102
+ }
@@ -1,68 +1,68 @@
1
- /**
2
- * Server-side session state store for AfriCode.
3
- *
4
- * @module core/session-store
5
- */
6
-
7
- class SessionStore {
8
- constructor() {
9
- this.sessions = new Map();
10
- }
11
-
12
- ensure(sessionId) {
13
- if (!this.sessions.has(sessionId)) {
14
- this.sessions.set(sessionId, {
15
- data: {
16
- counter: { value: 0 }
17
- },
18
- meta: {
19
- createdAt: new Date(),
20
- lastSeenAt: new Date()
21
- }
22
- });
23
- }
24
-
25
- return this.sessions.get(sessionId);
26
- }
27
-
28
- touch(sessionId) {
29
- const session = this.ensure(sessionId);
30
- session.meta.lastSeenAt = new Date();
31
- return session;
32
- }
33
-
34
- has(sessionId) {
35
- return this.sessions.has(sessionId);
36
- }
37
-
38
- get(sessionId) {
39
- return this.touch(sessionId).data;
40
- }
41
-
42
- set(sessionId, path, value) {
43
- const session = this.get(sessionId);
44
- const keys = path.split('/');
45
- let obj = session;
46
-
47
- while (keys.length > 1) {
48
- const key = keys.shift();
49
- if (!obj[key] || typeof obj[key] !== 'object') {
50
- obj[key] = {};
51
- }
52
- obj = obj[key];
53
- }
54
-
55
- obj[keys[0]] = value;
56
- return value;
57
- }
58
-
59
- delete(sessionId) {
60
- return this.sessions.delete(sessionId);
61
- }
62
-
63
- clear() {
64
- this.sessions.clear();
65
- }
66
- }
67
-
68
- export const sessionStore = new SessionStore();
1
+ /**
2
+ * Server-side session state store for AfriCode.
3
+ *
4
+ * @module core/session-store
5
+ */
6
+
7
+ class SessionStore {
8
+ constructor() {
9
+ this.sessions = new Map();
10
+ }
11
+
12
+ ensure(sessionId) {
13
+ if (!this.sessions.has(sessionId)) {
14
+ this.sessions.set(sessionId, {
15
+ data: {
16
+ counter: { value: 0 }
17
+ },
18
+ meta: {
19
+ createdAt: new Date(),
20
+ lastSeenAt: new Date()
21
+ }
22
+ });
23
+ }
24
+
25
+ return this.sessions.get(sessionId);
26
+ }
27
+
28
+ touch(sessionId) {
29
+ const session = this.ensure(sessionId);
30
+ session.meta.lastSeenAt = new Date();
31
+ return session;
32
+ }
33
+
34
+ has(sessionId) {
35
+ return this.sessions.has(sessionId);
36
+ }
37
+
38
+ get(sessionId) {
39
+ return this.touch(sessionId).data;
40
+ }
41
+
42
+ set(sessionId, path, value) {
43
+ const session = this.get(sessionId);
44
+ const keys = path.split('/');
45
+ let obj = session;
46
+
47
+ while (keys.length > 1) {
48
+ const key = keys.shift();
49
+ if (!obj[key] || typeof obj[key] !== 'object') {
50
+ obj[key] = {};
51
+ }
52
+ obj = obj[key];
53
+ }
54
+
55
+ obj[keys[0]] = value;
56
+ return value;
57
+ }
58
+
59
+ delete(sessionId) {
60
+ return this.sessions.delete(sessionId);
61
+ }
62
+
63
+ clear() {
64
+ this.sessions.clear();
65
+ }
66
+ }
67
+
68
+ export const sessionStore = new SessionStore();
package/core/shim.js CHANGED
@@ -1,28 +1,28 @@
1
- /**
2
- * AfriCode SSR DOM Shim
3
- * Allows Web Components to be imported in Node/Bun environment.
4
- */
5
-
6
- if (typeof globalThis.HTMLElement === 'undefined') {
7
- globalThis.HTMLElement = class HTMLElement { };
8
- globalThis.customElements = { define: () => { }, get: () => { } };
9
- globalThis.document = {
10
- createElement: () => ({
11
- classList: { add: () => { } },
12
- setAttribute: () => { },
13
- style: {}
14
- }),
15
- head: { appendChild: () => { } },
16
- body: { appendChild: () => { } }
17
- };
18
- globalThis.window = globalThis;
19
- globalThis.CSSStyleSheet = class CSSStyleSheet { replaceSync() { } };
20
- }
21
-
22
- // Global scope support for certain libraries
23
- if (typeof global !== 'undefined') {
24
- global.HTMLElement = globalThis.HTMLElement;
25
- global.customElements = globalThis.customElements;
26
- global.document = globalThis.document;
27
- global.window = globalThis;
28
- }
1
+ /**
2
+ * AfriCode SSR DOM Shim
3
+ * Allows Web Components to be imported in Node/Bun environment.
4
+ */
5
+
6
+ if (typeof globalThis.HTMLElement === 'undefined') {
7
+ globalThis.HTMLElement = class HTMLElement { };
8
+ globalThis.customElements = { define: () => { }, get: () => { } };
9
+ globalThis.document = {
10
+ createElement: () => ({
11
+ classList: { add: () => { } },
12
+ setAttribute: () => { },
13
+ style: {}
14
+ }),
15
+ head: { appendChild: () => { } },
16
+ body: { appendChild: () => { } }
17
+ };
18
+ globalThis.window = globalThis;
19
+ globalThis.CSSStyleSheet = class CSSStyleSheet { replaceSync() { } };
20
+ }
21
+
22
+ // Global scope support for certain libraries
23
+ if (typeof global !== 'undefined') {
24
+ global.HTMLElement = globalThis.HTMLElement;
25
+ global.customElements = globalThis.customElements;
26
+ global.document = globalThis.document;
27
+ global.window = globalThis;
28
+ }
package/core/state.d.ts CHANGED
@@ -1,86 +1,86 @@
1
- /**
2
- * AfriCode State Management - TypeScript Definitions
3
- * Reactive state, signals, and effects
4
- */
5
-
6
- /**
7
- * Creates a reactive state object with Proxy-based reactivity
8
- * @template T - The shape of the state object
9
- * @param initialState - Initial state values
10
- * @returns Reactive proxy of the state
11
- */
12
- export function createReactiveState<T extends Record<string, any>>(
13
- initialState: T
14
- ): T & {
15
- [K in keyof T]: T[K];
16
- };
17
-
18
- /**
19
- * Subscriber callback type
20
- */
21
- export type Subscriber<T extends Record<string, any>> = (
22
- newValue: T,
23
- oldValue?: T
24
- ) => void;
25
-
26
- /**
27
- * Subscribe to state changes
28
- * @param state - Reactive state object to subscribe to
29
- * @param callback - Called when state changes
30
- * @returns Unsubscribe function
31
- */
32
- export function subscribe<T extends Record<string, any>>(
33
- state: T,
34
- callback: Subscriber<T>
35
- ): () => void;
36
-
37
- /**
38
- * Signal getter function
39
- */
40
- export type SignalGetter<T> = () => T;
41
-
42
- /**
43
- * Signal setter function - accepts value or updater function
44
- */
45
- export type SignalSetter<T> = (value: T | ((prev: T) => T)) => void;
46
-
47
- /**
48
- * Signal tuple return type
49
- */
50
- export type Signal<T> = [getter: SignalGetter<T>, setter: SignalSetter<T>];
51
-
52
- /**
53
- * Create a reactive signal with getter and setter
54
- * @template T - Signal value type
55
- * @param initialValue - Initial signal value
56
- * @returns Tuple of [getter, setter]
57
- */
58
- export function createSignal<T>(initialValue: T): Signal<T>;
59
-
60
- /**
61
- * Effect callback - can optionally return cleanup function
62
- */
63
- export type EffectCallback = () => void | (() => void);
64
-
65
- /**
66
- * Effect cleanup function
67
- */
68
- export type EffectCleanup = () => void;
69
-
70
- /**
71
- * Create an effect that runs side effects
72
- * Effects track dependencies from signals and state
73
- * @param effect - Effect function to run
74
- * @returns Cleanup function
75
- */
76
- export function createEffect(effect: EffectCallback): EffectCleanup;
77
-
78
- /**
79
- * Internal subscriber map (for advanced use)
80
- */
81
- export const subscribers: WeakMap<object, Set<Subscriber<any>>>;
82
-
83
- /**
84
- * Internal signal registry (for advanced use)
85
- */
86
- export const signals: WeakMap<object, any>;
1
+ /**
2
+ * AfriCode State Management - TypeScript Definitions
3
+ * Reactive state, signals, and effects
4
+ */
5
+
6
+ /**
7
+ * Creates a reactive state object with Proxy-based reactivity
8
+ * @template T - The shape of the state object
9
+ * @param initialState - Initial state values
10
+ * @returns Reactive proxy of the state
11
+ */
12
+ export function createReactiveState<T extends Record<string, any>>(
13
+ initialState: T
14
+ ): T & {
15
+ [K in keyof T]: T[K];
16
+ };
17
+
18
+ /**
19
+ * Subscriber callback type
20
+ */
21
+ export type Subscriber<T extends Record<string, any>> = (
22
+ newValue: T,
23
+ oldValue?: T
24
+ ) => void;
25
+
26
+ /**
27
+ * Subscribe to state changes
28
+ * @param state - Reactive state object to subscribe to
29
+ * @param callback - Called when state changes
30
+ * @returns Unsubscribe function
31
+ */
32
+ export function subscribe<T extends Record<string, any>>(
33
+ state: T,
34
+ callback: Subscriber<T>
35
+ ): () => void;
36
+
37
+ /**
38
+ * Signal getter function
39
+ */
40
+ export type SignalGetter<T> = () => T;
41
+
42
+ /**
43
+ * Signal setter function - accepts value or updater function
44
+ */
45
+ export type SignalSetter<T> = (value: T | ((prev: T) => T)) => void;
46
+
47
+ /**
48
+ * Signal tuple return type
49
+ */
50
+ export type Signal<T> = [getter: SignalGetter<T>, setter: SignalSetter<T>];
51
+
52
+ /**
53
+ * Create a reactive signal with getter and setter
54
+ * @template T - Signal value type
55
+ * @param initialValue - Initial signal value
56
+ * @returns Tuple of [getter, setter]
57
+ */
58
+ export function createSignal<T>(initialValue: T): Signal<T>;
59
+
60
+ /**
61
+ * Effect callback - can optionally return cleanup function
62
+ */
63
+ export type EffectCallback = () => void | (() => void);
64
+
65
+ /**
66
+ * Effect cleanup function
67
+ */
68
+ export type EffectCleanup = () => void;
69
+
70
+ /**
71
+ * Create an effect that runs side effects
72
+ * Effects track dependencies from signals and state
73
+ * @param effect - Effect function to run
74
+ * @returns Cleanup function
75
+ */
76
+ export function createEffect(effect: EffectCallback): EffectCleanup;
77
+
78
+ /**
79
+ * Internal subscriber map (for advanced use)
80
+ */
81
+ export const subscribers: WeakMap<object, Set<Subscriber<any>>>;
82
+
83
+ /**
84
+ * Internal signal registry (for advanced use)
85
+ */
86
+ export const signals: WeakMap<object, any>;