@africode/core 5.0.11 → 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 (221) 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 +396 -396
  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 +248 -283
  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 +47 -47
  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 +23 -11
  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/transfer.js +65 -65
  193. package/templates/starter-fintech/src/pages/api/wallet.js +39 -39
  194. package/templates/starter-fintech/src/pages/api/webhooks/payment.js +32 -32
  195. package/templates/starter-fintech/src/pages/index.html +169 -169
  196. package/templates/starter-fintech/src/pages/index.js +161 -161
  197. package/templates/starter-fintech/src/styles/main.css +246 -246
  198. package/templates/starter-react/.env.example +15 -15
  199. package/templates/starter-react/africode.config.js +40 -40
  200. package/templates/starter-react/package.json +15 -15
  201. package/templates/starter-react/src/pages/index.html +55 -55
  202. package/templates/starter-react/src/pages/index.js +68 -68
  203. package/templates/starter-react/src/styles/main.css +3 -3
  204. package/templates/starter-tailwind/.env.example +15 -15
  205. package/templates/starter-tailwind/africode.config.js +40 -40
  206. package/templates/starter-tailwind/package.json +19 -19
  207. package/templates/starter-tailwind/src/pages/index.html +55 -55
  208. package/templates/starter-tailwind/src/pages/index.js +67 -67
  209. package/templates/starter-tailwind/src/styles/main.css +3 -3
  210. package/templates/starter-tailwind/src/styles/tailwind.css +1 -1
  211. package/templates/starter-tailwind/src/tailwind-loader.js +30 -30
  212. package/templates/starter-tailwind/tailwind.config.cjs +18 -18
  213. package/templates/starter-website/.env.example +18 -18
  214. package/templates/starter-website/africode.config.js +20 -20
  215. package/templates/starter-website/package.json +14 -14
  216. package/templates/starter-website/src/index.js +17 -17
  217. package/templates/starter-website/src/pages/index.html +124 -124
  218. package/templates/starter-website/src/pages/index.js +116 -116
  219. package/templates/starter-website/src/styles/main.css +195 -195
  220. package/bin/africode.js.1758507140 +0 -343
  221. package/core/heartbeat.js +0 -64
@@ -1,41 +1,41 @@
1
- /**
2
- * AfriCode Product Card
3
- *
4
- * Product display card for e-commerce pages.
5
- */
6
-
7
- import { AfriCodeComponent, registerComponent, html } from './base.js';
8
-
9
- export class AfriProductCard extends AfriCodeComponent {
10
- static get observedAttributes() { return ['title','price','image','currency']; }
11
- constructor(){ super(); this.render(); }
12
- attributeChangedCallback(){ this.render(); }
13
- render(){
14
- const title = this.getAttribute('title') || 'Product';
15
- const price = this.getAttribute('price') || '0';
16
- const image = this.getAttribute('image') || '';
17
- const currency = this.getAttribute('currency') || '$';
18
- this.shadowRoot.innerHTML = html`
19
- <style>
20
- :host{display:block;font-family:Inter,system-ui,sans-serif}
21
- .card{background:#fff;border-radius:12px;padding:12px;display:grid;gap:8px}
22
- .media{height:180px;border-radius:8px;background:#f3f4f6;overflow:hidden}
23
- .media img{width:100%;height:100%;object-fit:cover}
24
- .meta{display:flex;justify-content:space-between;align-items:center}
25
- .title{font-weight:700}
26
- .price{font-weight:800}
27
- .actions{display:flex;gap:8px}
28
- button{padding:8px 12px;border-radius:8px;border:none;background:#1EB53A;color:white;cursor:pointer}
29
- </style>
30
- <div class="card">
31
- <div class="media">${image?html`<img src="${image}" alt="${title}"/>` : ''}</div>
32
- <div class="meta"><div class="title">${title}</div><div class="price">${currency}${price}</div></div>
33
- <div class="actions"><button class="add">Add to cart</button><button class="view">View</button></div>
34
- </div>
35
- `;
36
- this.shadowRoot.querySelector('.add')?.addEventListener('click',()=>this.emit('add-to-cart',{title,price,currency}))
37
- }
38
- }
39
-
40
- registerComponent('af-product-card', AfriProductCard);
41
- export default AfriProductCard;
1
+ /**
2
+ * AfriCode Product Card
3
+ *
4
+ * Product display card for e-commerce pages.
5
+ */
6
+
7
+ import { AfriCodeComponent, registerComponent, html } from './base.js';
8
+
9
+ export class AfriProductCard extends AfriCodeComponent {
10
+ static get observedAttributes() { return ['title','price','image','currency']; }
11
+ constructor(){ super(); this.render(); }
12
+ attributeChangedCallback(){ this.render(); }
13
+ render(){
14
+ const title = this.getAttribute('title') || 'Product';
15
+ const price = this.getAttribute('price') || '0';
16
+ const image = this.getAttribute('image') || '';
17
+ const currency = this.getAttribute('currency') || '$';
18
+ this.shadowRoot.innerHTML = html`
19
+ <style>
20
+ :host{display:block;font-family:Inter,system-ui,sans-serif}
21
+ .card{background:#fff;border-radius:12px;padding:12px;display:grid;gap:8px}
22
+ .media{height:180px;border-radius:8px;background:#f3f4f6;overflow:hidden}
23
+ .media img{width:100%;height:100%;object-fit:cover}
24
+ .meta{display:flex;justify-content:space-between;align-items:center}
25
+ .title{font-weight:700}
26
+ .price{font-weight:800}
27
+ .actions{display:flex;gap:8px}
28
+ button{padding:8px 12px;border-radius:8px;border:none;background:#1EB53A;color:white;cursor:pointer}
29
+ </style>
30
+ <div class="card">
31
+ <div class="media">${image?html`<img src="${image}" alt="${title}"/>` : ''}</div>
32
+ <div class="meta"><div class="title">${title}</div><div class="price">${currency}${price}</div></div>
33
+ <div class="actions"><button class="add">Add to cart</button><button class="view">View</button></div>
34
+ </div>
35
+ `;
36
+ this.shadowRoot.querySelector('.add')?.addEventListener('click',()=>this.emit('add-to-cart',{title,price,currency}))
37
+ }
38
+ }
39
+
40
+ registerComponent('af-product-card', AfriProductCard);
41
+ export default AfriProductCard;
@@ -1,134 +1,132 @@
1
- /**
2
- * AfriCode Progress Bar Component
3
- *
4
- * Progress indicators for loading, completion, and metrics.
5
- * Suitable for: File uploads, Course progress, Health goals, Downloads
6
- *
7
- * @module components/progress
8
- */
9
-
10
- import { AfriCodeComponent, registerComponent } from './base.js';
11
-
12
- export class AfriProgress extends AfriCodeComponent {
13
- static get observedAttributes() {
14
- return ['value', 'max', 'theme', 'size', 'label', 'animated'];
15
- }
16
-
17
- constructor() {
18
- super();
19
- this.render();
20
- }
21
-
22
- attributeChangedCallback() {
23
- this.render();
24
- }
25
-
26
- render() {
27
- const value = parseFloat(this.getAttribute('value')) || 0;
28
- const max = parseFloat(this.getAttribute('max')) || 100;
29
- const theme = this.getAttribute('theme') || 'tanzania';
30
- const size = this.getAttribute('size') || 'md';
31
- const label = this.getAttribute('label');
32
- const animated = this.hasAttribute('animated');
33
-
34
- const percentage = Math.min(100, Math.max(0, (value / max) * 100));
35
-
36
- const themes = {
37
- tanzania: { bar: '#1EB53A', track: '#e9ecef' },
38
- maasai: { bar: '#FF0000', track: '#e9ecef' },
39
- ndebele: { bar: '#4169E1', track: '#e9ecef' },
40
- gold: { bar: '#FCD116', track: '#e9ecef' },
41
- gradient: { bar: 'linear-gradient(90deg, #1EB53A 0%, #FCD116 50%, #00A3DD 100%)', track: '#e9ecef' }
42
- };
43
- const t = themes[theme] || themes.tanzania;
44
-
45
- const sizes = {
46
- sm: '6px',
47
- md: '10px',
48
- lg: '16px'
49
- };
50
- const height = sizes[size] || sizes.md;
51
-
52
- this.shadowRoot.innerHTML = `
53
- <style>
54
- :host {
55
- display: block;
56
- font-family: 'Inter', system-ui, sans-serif;
57
- }
58
-
59
- .progress-container {
60
- width: 100%;
61
- }
62
-
63
- .progress-header {
64
- display: flex;
65
- justify-content: space-between;
66
- margin-bottom: 5px;
67
- font-size: 13px;
68
- }
69
-
70
- .progress-label {
71
- color: #333;
72
- font-weight: 500;
73
- }
74
-
75
- .progress-value {
76
- color: #666;
77
- }
78
-
79
- .progress-track {
80
- width: 100%;
81
- height: ${height};
82
- background: ${t.track};
83
- border-radius: 100px;
84
- overflow: hidden;
85
- }
86
-
87
- .progress-bar {
88
- height: 100%;
89
- width: ${percentage}%;
90
- background: ${t.bar};
91
- border-radius: 100px;
92
- transition: width 500ms ease-out;
93
- ${animated ? `
94
- background-size: 30px 30px;
95
- background-image: linear-gradient(
96
- 135deg,
97
- rgba(255,255,255,0.2) 25%,
98
- transparent 25%,
99
- transparent 50%,
100
- rgba(255,255,255,0.2) 50%,
101
- rgba(255,255,255,0.2) 75%,
102
- transparent 75%,
103
- transparent
104
- );
105
- animation: stripes 1s linear infinite;
106
- ` : ''}
107
- }
108
-
109
- @keyframes stripes {
110
- 0% { background-position: 0 0; }
111
- 100% { background-position: 30px 0; }
112
- }
113
- </style>
114
-
115
- <div class="progress-container">
116
- ${label || true ? `
117
- <div class="progress-header">
118
- <span class="progress-label">${label || ''}</span>
119
- <span class="progress-value">${percentage.toFixed(0)}%</span>
120
- </div>
121
- ` : ''}
122
- <div class="progress-track">
123
- <div class="progress-bar" role="progressbar"
124
- aria-valuenow="${value}"
125
- aria-valuemin="0"
126
- aria-valuemax="${max}"></div>
127
- </div>
128
- </div>
129
- `;
130
- }
131
- }
132
-
133
- registerComponent('af-progress', AfriProgress);
134
- export default AfriProgress;
1
+ /**
2
+ * AfriCode Progress Bar Component
3
+ *
4
+ * Progress indicators for loading, completion, and metrics.
5
+ * Suitable for: File uploads, Course progress, Health goals, Downloads
6
+ *
7
+ * @module components/progress
8
+ */
9
+
10
+ import { AfriCodeComponent, registerComponent } from './base.js';
11
+
12
+ export class AfriProgress extends AfriCodeComponent {
13
+ static get observedAttributes() {
14
+ return ['value', 'max', 'theme', 'size', 'label', 'animated'];
15
+ }
16
+
17
+ constructor() {
18
+ super();
19
+ this.render();
20
+ }
21
+
22
+ attributeChangedCallback() {
23
+ this.render();
24
+ }
25
+
26
+ render() {
27
+ const value = parseFloat(this.getAttribute('value')) || 0;
28
+ const max = parseFloat(this.getAttribute('max')) || 100;
29
+ const theme = this.getAttribute('theme') || 'tanzania';
30
+ const size = this.getAttribute('size') || 'md';
31
+ const label = this.getAttribute('label');
32
+ const animated = this.hasAttribute('animated');
33
+
34
+ const percentage = Math.min(100, Math.max(0, (value / max) * 100));
35
+
36
+ const themes = {
37
+ tanzania: { bar: '#1EB53A', track: '#e9ecef' },
38
+ maasai: { bar: '#FF0000', track: '#e9ecef' },
39
+ ndebele: { bar: '#4169E1', track: '#e9ecef' },
40
+ gold: { bar: '#FCD116', track: '#e9ecef' },
41
+ gradient: { bar: 'linear-gradient(90deg, #1EB53A 0%, #FCD116 50%, #00A3DD 100%)', track: '#e9ecef' }
42
+ };
43
+ const t = themes[theme] || themes.tanzania;
44
+
45
+ const sizes = {
46
+ sm: '6px',
47
+ md: '10px',
48
+ lg: '16px'
49
+ };
50
+ const height = sizes[size] || sizes.md;
51
+
52
+ this.shadowRoot.innerHTML = `
53
+ <style>
54
+ :host {
55
+ display: block;
56
+ font-family: 'Inter', system-ui, sans-serif;
57
+ }
58
+
59
+ .progress-container {
60
+ width: 100%;
61
+ }
62
+
63
+ .progress-header {
64
+ display: flex;
65
+ justify-content: space-between;
66
+ margin-bottom: 5px;
67
+ font-size: 13px;
68
+ }
69
+
70
+ .progress-label {
71
+ color: #333;
72
+ font-weight: 500;
73
+ }
74
+
75
+ .progress-value {
76
+ color: #666;
77
+ }
78
+
79
+ .progress-track {
80
+ width: 100%;
81
+ height: ${height};
82
+ background: ${t.track};
83
+ border-radius: 100px;
84
+ overflow: hidden;
85
+ }
86
+
87
+ .progress-bar {
88
+ height: 100%;
89
+ width: ${percentage}%;
90
+ background: ${t.bar};
91
+ border-radius: 100px;
92
+ transition: width 500ms ease-out;
93
+ ${animated ? `
94
+ background-size: 30px 30px;
95
+ background-image: linear-gradient(
96
+ 135deg,
97
+ rgba(255,255,255,0.2) 25%,
98
+ transparent 25%,
99
+ transparent 50%,
100
+ rgba(255,255,255,0.2) 50%,
101
+ rgba(255,255,255,0.2) 75%,
102
+ transparent 75%,
103
+ transparent
104
+ );
105
+ animation: stripes 1s linear infinite;
106
+ ` : ''}
107
+ }
108
+
109
+ @keyframes stripes {
110
+ 0% { background-position: 0 0; }
111
+ 100% { background-position: 30px 0; }
112
+ }
113
+ </style>
114
+
115
+ <div class="progress-container">
116
+ <div class="progress-header">
117
+ <span class="progress-label">${label || ''}</span>
118
+ <span class="progress-value">${percentage.toFixed(0)}%</span>
119
+ </div>
120
+ <div class="progress-track">
121
+ <div class="progress-bar" role="progressbar"
122
+ aria-valuenow="${value}"
123
+ aria-valuemin="0"
124
+ aria-valuemax="${max}"></div>
125
+ </div>
126
+ </div>
127
+ `;
128
+ }
129
+ }
130
+
131
+ registerComponent('af-progress', AfriProgress);
132
+ export default AfriProgress;
@@ -1,111 +1,111 @@
1
- /**
2
- * AfriCode React Interoperability Wrapper
3
- *
4
- * Mounts a React component tree inside an AfriCode Web Component's Shadow DOM.
5
- * This allows teams to embed React views within AfriCode pages without replacing
6
- * the framework's routing, build, or HMR systems.
7
- *
8
- * Usage:
9
- * import { AfriReact } from 'africode/components/react.js';
10
- * // or use declaratively after registration:
11
- * <af-react component="MyReactApp"></af-react>
12
- *
13
- * Programmatic mount:
14
- * const wrapper = document.querySelector('af-react');
15
- * wrapper.mount(MyReactComponent, { someProp: 'value' });
16
- *
17
- * @module components/react
18
- */
19
-
20
- import { AfriCodeComponent, registerComponent } from './base.js';
21
-
22
- export class AfriReact extends AfriCodeComponent {
23
- static get observedAttributes() {
24
- return ['component'];
25
- }
26
-
27
- constructor() {
28
- super();
29
- this._root = null; // React root instance
30
- this._mountPoint = null; // DOM node React renders into
31
- this._component = null; // The React component function/class
32
- this._props = {}; // Props passed to the React component
33
- }
34
-
35
- connectedCallback() {
36
- super.connectedCallback();
37
-
38
- // Create mount point inside Shadow DOM
39
- this._mountPoint = document.createElement('div');
40
- this._mountPoint.setAttribute('data-af-react-root', '');
41
- this.shadowRoot.appendChild(this._mountPoint);
42
- }
43
-
44
- disconnectedCallback() {
45
- // Clean unmount to prevent memory leaks
46
- this._unmount();
47
- }
48
-
49
- /**
50
- * Mount a React component into this wrapper.
51
- * @param {Function|Object} Component - React component (function or class)
52
- * @param {Object} [props={}] - Props to pass to the component
53
- */
54
- async mount(Component, props = {}) {
55
- if (!this._mountPoint) {
56
- console.error('[AfriCode/React] Cannot mount — component not connected to DOM.');
57
- return;
58
- }
59
-
60
- this._component = Component;
61
- this._props = props;
62
-
63
- try {
64
- const React = await import('react');
65
- const ReactDOM = await import('react-dom/client');
66
-
67
- // Unmount any previous tree
68
- this._unmount();
69
-
70
- this._root = ReactDOM.createRoot(this._mountPoint);
71
- this._root.render(React.createElement(Component, props));
72
- } catch (err) {
73
- console.error('[AfriCode/React] Failed to mount React component:', err);
74
- this._mountPoint.innerHTML = `
75
- <div style="padding: 12px; border: 1px dashed crimson; border-radius: 6px; color: crimson; font-size: 0.85rem;">
76
- React mount failed. Ensure <code>react</code> and <code>react-dom</code> are installed.
77
- </div>
78
- `;
79
- }
80
- }
81
-
82
- /**
83
- * Update props on the currently mounted React component.
84
- * @param {Object} nextProps - New props to merge and re-render with
85
- */
86
- async update(nextProps) {
87
- if (!this._root || !this._component) {
88
- console.warn('[AfriCode/React] No component mounted — call mount() first.');
89
- return;
90
- }
91
- this._props = { ...this._props, ...nextProps };
92
-
93
- const React = await import('react');
94
- this._root.render(React.createElement(this._component, this._props));
95
- }
96
-
97
- /** @private */
98
- _unmount() {
99
- if (this._root) {
100
- try {
101
- this._root.unmount();
102
- } catch (e) {
103
- // Already unmounted or root was invalid
104
- }
105
- this._root = null;
106
- }
107
- }
108
- }
109
-
110
- registerComponent('af-react', AfriReact);
111
- export default AfriReact;
1
+ /**
2
+ * AfriCode React Interoperability Wrapper
3
+ *
4
+ * Mounts a React component tree inside an AfriCode Web Component's Shadow DOM.
5
+ * This allows teams to embed React views within AfriCode pages without replacing
6
+ * the framework's routing, build, or HMR systems.
7
+ *
8
+ * Usage:
9
+ * import { AfriReact } from 'africode/components/react.js';
10
+ * // or use declaratively after registration:
11
+ * <af-react component="MyReactApp"></af-react>
12
+ *
13
+ * Programmatic mount:
14
+ * const wrapper = document.querySelector('af-react');
15
+ * wrapper.mount(MyReactComponent, { someProp: 'value' });
16
+ *
17
+ * @module components/react
18
+ */
19
+
20
+ import { AfriCodeComponent, registerComponent } from './base.js';
21
+
22
+ export class AfriReact extends AfriCodeComponent {
23
+ static get observedAttributes() {
24
+ return ['component'];
25
+ }
26
+
27
+ constructor() {
28
+ super();
29
+ this._root = null; // React root instance
30
+ this._mountPoint = null; // DOM node React renders into
31
+ this._component = null; // The React component function/class
32
+ this._props = {}; // Props passed to the React component
33
+ }
34
+
35
+ connectedCallback() {
36
+ super.connectedCallback();
37
+
38
+ // Create mount point inside Shadow DOM
39
+ this._mountPoint = document.createElement('div');
40
+ this._mountPoint.setAttribute('data-af-react-root', '');
41
+ this.shadowRoot.appendChild(this._mountPoint);
42
+ }
43
+
44
+ disconnectedCallback() {
45
+ // Clean unmount to prevent memory leaks
46
+ this._unmount();
47
+ }
48
+
49
+ /**
50
+ * Mount a React component into this wrapper.
51
+ * @param {Function|Object} Component - React component (function or class)
52
+ * @param {Object} [props={}] - Props to pass to the component
53
+ */
54
+ async mount(Component, props = {}) {
55
+ if (!this._mountPoint) {
56
+ console.error('[AfriCode/React] Cannot mount — component not connected to DOM.');
57
+ return;
58
+ }
59
+
60
+ this._component = Component;
61
+ this._props = props;
62
+
63
+ try {
64
+ const React = await import('react');
65
+ const ReactDOM = await import('react-dom/client');
66
+
67
+ // Unmount any previous tree
68
+ this._unmount();
69
+
70
+ this._root = ReactDOM.createRoot(this._mountPoint);
71
+ this._root.render(React.createElement(Component, props));
72
+ } catch (err) {
73
+ console.error('[AfriCode/React] Failed to mount React component:', err);
74
+ this._mountPoint.innerHTML = `
75
+ <div style="padding: 12px; border: 1px dashed crimson; border-radius: 6px; color: crimson; font-size: 0.85rem;">
76
+ React mount failed. Ensure <code>react</code> and <code>react-dom</code> are installed.
77
+ </div>
78
+ `;
79
+ }
80
+ }
81
+
82
+ /**
83
+ * Update props on the currently mounted React component.
84
+ * @param {Object} nextProps - New props to merge and re-render with
85
+ */
86
+ async update(nextProps) {
87
+ if (!this._root || !this._component) {
88
+ console.warn('[AfriCode/React] No component mounted — call mount() first.');
89
+ return;
90
+ }
91
+ this._props = { ...this._props, ...nextProps };
92
+
93
+ const React = await import('react');
94
+ this._root.render(React.createElement(this._component, this._props));
95
+ }
96
+
97
+ /** @private */
98
+ _unmount() {
99
+ if (this._root) {
100
+ try {
101
+ this._root.unmount();
102
+ } catch {
103
+ // Already unmounted or root was invalid
104
+ }
105
+ this._root = null;
106
+ }
107
+ }
108
+ }
109
+
110
+ registerComponent('af-react', AfriReact);
111
+ export default AfriReact;
@@ -1,24 +1,24 @@
1
- /**
2
- * AfriCode Search Box
3
- *
4
- * Search input with debounced emit for live search.
5
- */
6
-
7
- import { AfriCodeComponent, registerComponent, html } from './base.js';
8
-
9
- export class AfriSearchBox extends AfriCodeComponent {
10
- constructor(){ super(); this._deb=null; this.render(); }
11
- connectedCallback(){ this.shadowRoot.getElementById('q').addEventListener('input', (e)=>{ clearTimeout(this._deb); this._deb=setTimeout(()=>this.emit('search',{q:e.target.value}),300) }) }
12
- render(){ this.shadowRoot.innerHTML = html`
13
- <style>
14
- :host{display:block}
15
- .wrap{display:flex;gap:8px}
16
- input{padding:10px;border-radius:8px;border:1px solid #e5e7eb;flex:1}
17
- button{padding:10px;border-radius:8px;background:#0f172a;color:white;border:none}
18
- </style>
19
- <div class="wrap"><input id="q" placeholder="Search..."/><button aria-hidden>🔍</button></div>
20
- `}
21
- }
22
-
23
- registerComponent('af-search-box', AfriSearchBox);
24
- export default AfriSearchBox;
1
+ /**
2
+ * AfriCode Search Box
3
+ *
4
+ * Search input with debounced emit for live search.
5
+ */
6
+
7
+ import { AfriCodeComponent, registerComponent, html } from './base.js';
8
+
9
+ export class AfriSearchBox extends AfriCodeComponent {
10
+ constructor(){ super(); this._deb=null; this.render(); }
11
+ connectedCallback(){ this.shadowRoot.getElementById('q').addEventListener('input', (e)=>{ clearTimeout(this._deb); this._deb=setTimeout(()=>this.emit('search',{q:e.target.value}),300) }) }
12
+ render(){ this.shadowRoot.innerHTML = html`
13
+ <style>
14
+ :host{display:block}
15
+ .wrap{display:flex;gap:8px}
16
+ input{padding:10px;border-radius:8px;border:1px solid #e5e7eb;flex:1}
17
+ button{padding:10px;border-radius:8px;background:#0f172a;color:white;border:none}
18
+ </style>
19
+ <div class="wrap"><input id="q" placeholder="Search..."/><button aria-hidden>🔍</button></div>
20
+ `}
21
+ }
22
+
23
+ registerComponent('af-search-box', AfriSearchBox);
24
+ export default AfriSearchBox;