@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,140 +1,140 @@
1
- /**
2
- * AfriCode Browser SDK
3
- * Client-side only entry point. Does not include server-only APIs.
4
- *
5
- * Use this for Bun.build({ target: 'browser' })
6
- * Use the full sdk.js for server/SSR contexts
7
- *
8
- * Philosophy: Browser-safe, tree-shakeable, zero server APIs
9
- */
10
-
11
- import { createReactiveState, subscribe, createSignal, createEffect } from './state.js';
12
- import { store, actions } from './store.js';
13
- import patterns from './patterns.js';
14
- import * as motion from './motion.js';
15
- import { hydrate } from './hydration.js';
16
- import { html, Layout } from './html.js';
17
- import { schemas, Validation, rules, afri, AfriFieldBuilder, normalizeInput, buildSchema } from './validation.js';
18
- import { createFramework, getConfig } from './config.js';
19
- import { getRequestIdentity, parseCookieHeader, createSessionId, SESSION_COOKIE_NAME } from './request-identity.js';
20
- import { sessionStore } from './session-store.js';
21
- import { actions as runtimeActions } from './actions.js';
22
- import { MiddlewareManager, loggerMiddleware, authMiddleware } from './middleware.js';
23
- import {
24
- AfriCodeError, ValidationError, InvalidUrlError,
25
- SecurityError, CsrfError, RateLimitError,
26
- DatabaseError, ComponentError
27
- } from './errors.js';
28
-
29
- // v5.0.0 Browser-safe exports (A2UI protocol)
30
- import { initA2UI, A2UIRenderer, A2UIProtocol } from './a2ui.js';
31
-
32
- import { componentMap as coreMap } from '../components/index.js';
33
-
34
- // Utility to initialize the browser framework
35
- export function init(projectComponentMap = {}) {
36
- if (typeof window !== 'undefined') {
37
- console.log('🌍 AfriCode Browser SDK Initialized');
38
-
39
- // Merge project map with core map
40
- const finalMap = { ...coreMap, ...projectComponentMap };
41
-
42
- if (Object.keys(finalMap).length > 0) {
43
- hydrate(finalMap);
44
- }
45
- }
46
- }
47
-
48
- // Browser-safe grouped exports
49
- export {
50
- createReactiveState,
51
- subscribe,
52
- createSignal,
53
- createEffect
54
- } from './state.js';
55
-
56
- export {
57
- store,
58
- actions,
59
- patterns,
60
- motion,
61
- html,
62
- Layout,
63
- schemas,
64
- Validation,
65
- rules,
66
- afri,
67
- AfriFieldBuilder,
68
- normalizeInput,
69
- buildSchema,
70
- createFramework,
71
- getConfig,
72
- getRequestIdentity,
73
- parseCookieHeader,
74
- createSessionId,
75
- SESSION_COOKIE_NAME,
76
- sessionStore,
77
- runtimeActions,
78
- MiddlewareManager,
79
- loggerMiddleware,
80
- authMiddleware,
81
- AfriCodeError,
82
- ValidationError,
83
- InvalidUrlError,
84
- SecurityError,
85
- CsrfError,
86
- RateLimitError,
87
- DatabaseError,
88
- ComponentError
89
- };
90
-
91
- // Browser-only exports (A2UI for AI-safe rendering)
92
- export {
93
- initA2UI,
94
- A2UIRenderer,
95
- A2UIProtocol
96
- };
97
-
98
- // Default Export (Browser-safe)
99
- export default {
100
- createReactiveState,
101
- subscribe,
102
- createSignal,
103
- createEffect,
104
- store,
105
- actions,
106
- patterns,
107
- motion,
108
- html,
109
- Layout,
110
- schemas,
111
- Validation,
112
- rules,
113
- afri,
114
- AfriFieldBuilder,
115
- normalizeInput,
116
- buildSchema,
117
- createFramework,
118
- getConfig,
119
- getRequestIdentity,
120
- parseCookieHeader,
121
- createSessionId,
122
- SESSION_COOKIE_NAME,
123
- sessionStore,
124
- runtimeActions,
125
- MiddlewareManager,
126
- loggerMiddleware,
127
- authMiddleware,
128
- AfriCodeError,
129
- ValidationError,
130
- InvalidUrlError,
131
- SecurityError,
132
- CsrfError,
133
- RateLimitError,
134
- DatabaseError,
135
- ComponentError,
136
- initA2UI,
137
- A2UIRenderer,
138
- A2UIProtocol,
139
- init
140
- };
1
+ /**
2
+ * AfriCode Browser SDK
3
+ * Client-side only entry point. Does not include server-only APIs.
4
+ *
5
+ * Use this for Bun.build({ target: 'browser' })
6
+ * Use the full sdk.js for server/SSR contexts
7
+ *
8
+ * Philosophy: Browser-safe, tree-shakeable, zero server APIs
9
+ */
10
+
11
+ import { createReactiveState, subscribe, createSignal, createEffect } from './state.js';
12
+ import { store, actions } from './store.js';
13
+ import patterns from './patterns.js';
14
+ import * as motion from './motion.js';
15
+ import { hydrate } from './hydration.js';
16
+ import { html, Layout } from './html.js';
17
+ import { schemas, Validation, rules, afri, AfriFieldBuilder, normalizeInput, buildSchema } from './validation.js';
18
+ import { createFramework, getConfig } from './config.js';
19
+ import { getRequestIdentity, parseCookieHeader, createSessionId, SESSION_COOKIE_NAME } from './request-identity.js';
20
+ import { sessionStore } from './session-store.js';
21
+ import { actions as runtimeActions } from './actions.js';
22
+ import { MiddlewareManager, loggerMiddleware, authMiddleware } from './middleware.js';
23
+ import {
24
+ AfriCodeError, ValidationError, InvalidUrlError,
25
+ SecurityError, CsrfError, RateLimitError,
26
+ DatabaseError, ComponentError
27
+ } from './errors.js';
28
+
29
+ // v5.0.0 Browser-safe exports (A2UI protocol)
30
+ import { initA2UI, A2UIRenderer, A2UIProtocol } from './a2ui.js';
31
+
32
+ import { componentMap as coreMap } from '../components/index.js';
33
+
34
+ // Utility to initialize the browser framework
35
+ export function init(projectComponentMap = {}) {
36
+ if (typeof window !== 'undefined') {
37
+ console.log('🌍 AfriCode Browser SDK Initialized');
38
+
39
+ // Merge project map with core map
40
+ const finalMap = { ...coreMap, ...projectComponentMap };
41
+
42
+ if (Object.keys(finalMap).length > 0) {
43
+ hydrate(finalMap);
44
+ }
45
+ }
46
+ }
47
+
48
+ // Browser-safe grouped exports
49
+ export {
50
+ createReactiveState,
51
+ subscribe,
52
+ createSignal,
53
+ createEffect
54
+ } from './state.js';
55
+
56
+ export {
57
+ store,
58
+ actions,
59
+ patterns,
60
+ motion,
61
+ html,
62
+ Layout,
63
+ schemas,
64
+ Validation,
65
+ rules,
66
+ afri,
67
+ AfriFieldBuilder,
68
+ normalizeInput,
69
+ buildSchema,
70
+ createFramework,
71
+ getConfig,
72
+ getRequestIdentity,
73
+ parseCookieHeader,
74
+ createSessionId,
75
+ SESSION_COOKIE_NAME,
76
+ sessionStore,
77
+ runtimeActions,
78
+ MiddlewareManager,
79
+ loggerMiddleware,
80
+ authMiddleware,
81
+ AfriCodeError,
82
+ ValidationError,
83
+ InvalidUrlError,
84
+ SecurityError,
85
+ CsrfError,
86
+ RateLimitError,
87
+ DatabaseError,
88
+ ComponentError
89
+ };
90
+
91
+ // Browser-only exports (A2UI for AI-safe rendering)
92
+ export {
93
+ initA2UI,
94
+ A2UIRenderer,
95
+ A2UIProtocol
96
+ };
97
+
98
+ // Default Export (Browser-safe)
99
+ export default {
100
+ createReactiveState,
101
+ subscribe,
102
+ createSignal,
103
+ createEffect,
104
+ store,
105
+ actions,
106
+ patterns,
107
+ motion,
108
+ html,
109
+ Layout,
110
+ schemas,
111
+ Validation,
112
+ rules,
113
+ afri,
114
+ AfriFieldBuilder,
115
+ normalizeInput,
116
+ buildSchema,
117
+ createFramework,
118
+ getConfig,
119
+ getRequestIdentity,
120
+ parseCookieHeader,
121
+ createSessionId,
122
+ SESSION_COOKIE_NAME,
123
+ sessionStore,
124
+ runtimeActions,
125
+ MiddlewareManager,
126
+ loggerMiddleware,
127
+ authMiddleware,
128
+ AfriCodeError,
129
+ ValidationError,
130
+ InvalidUrlError,
131
+ SecurityError,
132
+ CsrfError,
133
+ RateLimitError,
134
+ DatabaseError,
135
+ ComponentError,
136
+ initA2UI,
137
+ A2UIRenderer,
138
+ A2UIProtocol,
139
+ init
140
+ };
@@ -1,62 +1,62 @@
1
- /**
2
- * AfriCode Client SDK
3
- * Browser-safe entry point for client-side bundling
4
- *
5
- * This excludes server-side code like database, auth, and server utilities
6
- * that can't be bundled for browser use.
7
- */
8
-
9
- import { createReactiveState, subscribe, createSignal, createEffect } from './state.js';
10
- import { store, actions } from './store.js';
11
- import patterns from './patterns.js';
12
- import * as motion from './motion.js';
13
- import { hydrate } from './hydration.js';
14
- import { html, Layout } from './html.js';
15
-
16
- import { componentMap as coreMap } from '../components/index.js';
17
-
18
- // Utility to initialize the client-side framework
19
- export function init(projectComponentMap = {}) {
20
- if (typeof window !== 'undefined') {
21
- console.log('🌍 AfriCode Client SDK Initialized (Zero-Config Mode)');
22
-
23
- // Merge project map with core map
24
- const finalMap = { ...coreMap, ...projectComponentMap };
25
-
26
- if (Object.keys(finalMap).length > 0) {
27
- hydrate(finalMap);
28
- }
29
- }
30
- }
31
-
32
- // Grouped exports for cleaner access (client-safe only)
33
- export {
34
- createReactiveState,
35
- subscribe,
36
- createSignal,
37
- createEffect
38
- } from './state.js';
39
-
40
- export {
41
- store,
42
- actions,
43
- patterns,
44
- motion,
45
- html,
46
- Layout
47
- };
48
-
49
- // Default Export
50
- export default {
51
- createReactiveState,
52
- subscribe,
53
- createSignal,
54
- createEffect,
55
- store,
56
- actions,
57
- patterns,
58
- motion,
59
- html,
60
- Layout,
61
- init
1
+ /**
2
+ * AfriCode Client SDK
3
+ * Browser-safe entry point for client-side bundling
4
+ *
5
+ * This excludes server-side code like database, auth, and server utilities
6
+ * that can't be bundled for browser use.
7
+ */
8
+
9
+ import { createReactiveState, subscribe, createSignal, createEffect } from './state.js';
10
+ import { store, actions } from './store.js';
11
+ import patterns from './patterns.js';
12
+ import * as motion from './motion.js';
13
+ import { hydrate } from './hydration.js';
14
+ import { html, Layout } from './html.js';
15
+
16
+ import { componentMap as coreMap } from '../components/index.js';
17
+
18
+ // Utility to initialize the client-side framework
19
+ export function init(projectComponentMap = {}) {
20
+ if (typeof window !== 'undefined') {
21
+ console.log('🌍 AfriCode Client SDK Initialized (Zero-Config Mode)');
22
+
23
+ // Merge project map with core map
24
+ const finalMap = { ...coreMap, ...projectComponentMap };
25
+
26
+ if (Object.keys(finalMap).length > 0) {
27
+ hydrate(finalMap);
28
+ }
29
+ }
30
+ }
31
+
32
+ // Grouped exports for cleaner access (client-safe only)
33
+ export {
34
+ createReactiveState,
35
+ subscribe,
36
+ createSignal,
37
+ createEffect
38
+ } from './state.js';
39
+
40
+ export {
41
+ store,
42
+ actions,
43
+ patterns,
44
+ motion,
45
+ html,
46
+ Layout
47
+ };
48
+
49
+ // Default Export
50
+ export default {
51
+ createReactiveState,
52
+ subscribe,
53
+ createSignal,
54
+ createEffect,
55
+ store,
56
+ actions,
57
+ patterns,
58
+ motion,
59
+ html,
60
+ Layout,
61
+ init
62
62
  };
package/core/sdk.d.ts CHANGED
@@ -1,133 +1,133 @@
1
- /**
2
- * AfriCode SDK - TypeScript Definitions
3
- * Main entry point and API surface
4
- */
5
-
6
- import {
7
- createReactiveState,
8
- subscribe,
9
- createSignal,
10
- createEffect
11
- } from './state';
12
-
13
- // State types
14
- export interface ReactiveState<T extends Record<string, any>> {
15
- [K in keyof T]: T[K];
16
- }
17
-
18
- export interface Signal<T> {
19
- (): T;
20
- }
21
-
22
- export interface SignalSetter<T> {
23
- (value: T | ((prev: T) => T)): void;
24
- }
25
-
26
- export interface Subscriber<T> {
27
- (newValue: T, oldValue?: T): void;
28
- }
29
-
30
- export interface Effect {
31
- (): void | (() => void);
32
- }
33
-
34
- // State management
35
- export function createReactiveState<T extends Record<string, any>>(
36
- initialState: T
37
- ): ReactiveState<T>;
38
-
39
- export function subscribe<T extends Record<string, any>>(
40
- state: ReactiveState<T>,
41
- callback: Subscriber<T>
42
- ): () => void; // Unsubscribe function
43
-
44
- export function createSignal<T>(initialValue: T): [Signal<T>, SignalSetter<T>];
45
-
46
- export function createEffect(effect: Effect): () => void; // Cleanup function
47
-
48
- // Patterns
49
- export interface PatternOptions {
50
- primaryColor?: string;
51
- secondaryColor?: string;
52
- accentColor?: string;
53
- size?: number;
54
- }
55
-
56
- export const patterns: {
57
- generateShuka: (options?: PatternOptions) => string;
58
- generateKente: (options?: PatternOptions) => string;
59
- generateKanga: (options?: PatternOptions) => string;
60
- generateAdinkra: (options?: PatternOptions) => string;
61
- generateKubaBorder: (options?: PatternOptions) => string;
62
- generateZuluBeads: (options?: PatternOptions) => string;
63
- generateMasaiShield: (options?: PatternOptions) => string;
64
- generateNdebelePaint: (options?: PatternOptions) => string;
65
- [key: string]: (options?: PatternOptions) => string;
66
- };
67
-
68
- // Motion/Animation
69
- export const motion: {
70
- fadeIn: animation config;
71
- slideUp: animation config;
72
- popIn: animation config;
73
- [key: string]: any;
74
- };
75
-
76
- // HTML template engine
77
- export function html(
78
- strings: TemplateStringsArray,
79
- ...values: any[]
80
- ): string;
81
-
82
- // Layout utilities
83
- export interface LayoutProps {
84
- vertical?: boolean;
85
- gap?: number;
86
- align?: 'start' | 'center' | 'end';
87
- justify?: 'start' | 'center' | 'end' | 'between';
88
- }
89
-
90
- export class Layout {
91
- constructor(props?: LayoutProps);
92
- render(): HTMLElement;
93
- }
94
-
95
- // Hydration
96
- export function hydrate(componentMap: Record<string, any>): void;
97
-
98
- // Store
99
- export interface GlobalStore {
100
- theme: 'light' | 'dark' | string;
101
- language: string;
102
- [key: string]: any;
103
- }
104
-
105
- export interface StoreActions {
106
- setTheme: (theme: string) => void;
107
- setLanguage: (lang: string) => void;
108
- [key: string]: any;
109
- }
110
-
111
- export const store: GlobalStore;
112
- export const actions: StoreActions;
113
-
114
- // Framework initialization
115
- export function init(projectComponents?: Record<string, any>): void;
116
-
117
- // Default export
118
- declare const sdk: {
119
- createReactiveState: typeof createReactiveState;
120
- subscribe: typeof subscribe;
121
- createSignal: typeof createSignal;
122
- createEffect: typeof createEffect;
123
- store: typeof store;
124
- actions: typeof actions;
125
- patterns: typeof patterns;
126
- motion: typeof motion;
127
- html: typeof html;
128
- Layout: typeof Layout;
129
- hydrate: typeof hydrate;
130
- init: typeof init;
131
- };
132
-
133
- export default sdk;
1
+ /**
2
+ * AfriCode SDK - TypeScript Definitions
3
+ * Main entry point and API surface
4
+ */
5
+
6
+ import {
7
+ createReactiveState,
8
+ subscribe,
9
+ createSignal,
10
+ createEffect
11
+ } from './state';
12
+
13
+ // State types
14
+ export interface ReactiveState<T extends Record<string, any>> {
15
+ [K in keyof T]: T[K];
16
+ }
17
+
18
+ export interface Signal<T> {
19
+ (): T;
20
+ }
21
+
22
+ export interface SignalSetter<T> {
23
+ (value: T | ((prev: T) => T)): void;
24
+ }
25
+
26
+ export interface Subscriber<T> {
27
+ (newValue: T, oldValue?: T): void;
28
+ }
29
+
30
+ export interface Effect {
31
+ (): void | (() => void);
32
+ }
33
+
34
+ // State management
35
+ export function createReactiveState<T extends Record<string, any>>(
36
+ initialState: T
37
+ ): ReactiveState<T>;
38
+
39
+ export function subscribe<T extends Record<string, any>>(
40
+ state: ReactiveState<T>,
41
+ callback: Subscriber<T>
42
+ ): () => void; // Unsubscribe function
43
+
44
+ export function createSignal<T>(initialValue: T): [Signal<T>, SignalSetter<T>];
45
+
46
+ export function createEffect(effect: Effect): () => void; // Cleanup function
47
+
48
+ // Patterns
49
+ export interface PatternOptions {
50
+ primaryColor?: string;
51
+ secondaryColor?: string;
52
+ accentColor?: string;
53
+ size?: number;
54
+ }
55
+
56
+ export const patterns: {
57
+ generateShuka: (options?: PatternOptions) => string;
58
+ generateKente: (options?: PatternOptions) => string;
59
+ generateKanga: (options?: PatternOptions) => string;
60
+ generateAdinkra: (options?: PatternOptions) => string;
61
+ generateKubaBorder: (options?: PatternOptions) => string;
62
+ generateZuluBeads: (options?: PatternOptions) => string;
63
+ generateMasaiShield: (options?: PatternOptions) => string;
64
+ generateNdebelePaint: (options?: PatternOptions) => string;
65
+ [key: string]: (options?: PatternOptions) => string;
66
+ };
67
+
68
+ // Motion/Animation
69
+ export const motion: {
70
+ fadeIn: animation config;
71
+ slideUp: animation config;
72
+ popIn: animation config;
73
+ [key: string]: any;
74
+ };
75
+
76
+ // HTML template engine
77
+ export function html(
78
+ strings: TemplateStringsArray,
79
+ ...values: any[]
80
+ ): string;
81
+
82
+ // Layout utilities
83
+ export interface LayoutProps {
84
+ vertical?: boolean;
85
+ gap?: number;
86
+ align?: 'start' | 'center' | 'end';
87
+ justify?: 'start' | 'center' | 'end' | 'between';
88
+ }
89
+
90
+ export class Layout {
91
+ constructor(props?: LayoutProps);
92
+ render(): HTMLElement;
93
+ }
94
+
95
+ // Hydration
96
+ export function hydrate(componentMap: Record<string, any>): void;
97
+
98
+ // Store
99
+ export interface GlobalStore {
100
+ theme: 'light' | 'dark' | string;
101
+ language: string;
102
+ [key: string]: any;
103
+ }
104
+
105
+ export interface StoreActions {
106
+ setTheme: (theme: string) => void;
107
+ setLanguage: (lang: string) => void;
108
+ [key: string]: any;
109
+ }
110
+
111
+ export const store: GlobalStore;
112
+ export const actions: StoreActions;
113
+
114
+ // Framework initialization
115
+ export function init(projectComponents?: Record<string, any>): void;
116
+
117
+ // Default export
118
+ declare const sdk: {
119
+ createReactiveState: typeof createReactiveState;
120
+ subscribe: typeof subscribe;
121
+ createSignal: typeof createSignal;
122
+ createEffect: typeof createEffect;
123
+ store: typeof store;
124
+ actions: typeof actions;
125
+ patterns: typeof patterns;
126
+ motion: typeof motion;
127
+ html: typeof html;
128
+ Layout: typeof Layout;
129
+ hydrate: typeof hydrate;
130
+ init: typeof init;
131
+ };
132
+
133
+ export default sdk;