@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,322 +1,321 @@
1
- /**
2
- * AfriCode Select/Dropdown Component
3
- *
4
- * Custom styled select dropdown for forms.
5
- * Suitable for: Forms, Filters, Settings, Language selection
6
- *
7
- * @module components/select
8
- */
9
-
10
- import { AfriCodeComponent, registerComponent } from './base.js';
11
-
12
- export class AfriSelect extends AfriCodeComponent {
13
- static get observedAttributes() {
14
- return ['label', 'placeholder', 'theme', 'error', 'required', 'aria-label', 'aria-describedby'];
15
- }
16
-
17
- constructor() {
18
- super();
19
- this._uniqueId = Math.random().toString(36).substr(2, 9);
20
- this._isOpen = false;
21
- this._selectedIndex = -1;
22
- this._options = [];
23
- this.render();
24
- }
25
-
26
- get value() {
27
- return this._selectedIndex >= 0 ? this._options[this._selectedIndex]?.value : '';
28
- }
29
-
30
- connectedCallback() {
31
- this._options = Array.from(this.querySelectorAll('option')).map(opt => ({
32
- value: opt.value,
33
- label: opt.textContent
34
- }));
35
- this.render();
36
- this._setupListeners();
37
- }
38
-
39
- _setupListeners() {
40
- const trigger = this.shadowRoot.querySelector('.select-trigger');
41
- const dropdown = this.shadowRoot.querySelector('.select-dropdown');
42
-
43
- trigger?.addEventListener('click', () => {
44
- this._toggleDropdown();
45
- });
46
-
47
- trigger?.addEventListener('keydown', (e) => {
48
- this._handleKeydown(e);
49
- });
50
-
51
- this.shadowRoot.querySelectorAll('.select-option').forEach((opt, i) => {
52
- opt.addEventListener('click', () => {
53
- this._selectOption(i);
54
- });
55
- });
56
-
57
- document.addEventListener('click', (e) => {
58
- if (!this.contains(e.target) && this._isOpen) {
59
- this._closeDropdown();
60
- }
61
- });
62
- }
63
-
64
- _toggleDropdown() {
65
- this._isOpen = !this._isOpen;
66
- const trigger = this.shadowRoot.querySelector('.select-trigger');
67
- const dropdown = this.shadowRoot.querySelector('.select-dropdown');
68
-
69
- dropdown?.classList.toggle('open', this._isOpen);
70
- trigger?.classList.toggle('open', this._isOpen);
71
-
72
- if (this._isOpen) {
73
- trigger?.setAttribute('aria-expanded', 'true');
74
- dropdown?.setAttribute('aria-hidden', 'false');
75
- } else {
76
- trigger?.setAttribute('aria-expanded', 'false');
77
- dropdown?.setAttribute('aria-hidden', 'true');
78
- }
79
- }
80
-
81
- _closeDropdown() {
82
- this._isOpen = false;
83
- const trigger = this.shadowRoot.querySelector('.select-trigger');
84
- const dropdown = this.shadowRoot.querySelector('.select-dropdown');
85
-
86
- dropdown?.classList.remove('open');
87
- trigger?.classList.remove('open');
88
- trigger?.setAttribute('aria-expanded', 'false');
89
- dropdown?.setAttribute('aria-hidden', 'true');
90
- }
91
-
92
- _selectOption(index) {
93
- this._selectedIndex = index;
94
- this._closeDropdown();
95
- this.render();
96
- this._setupListeners();
97
- this.emit('af-change', { value: this.value, label: this._options[index].label });
98
- }
99
-
100
- _handleKeydown(e) {
101
- const trigger = this.shadowRoot.querySelector('.select-trigger');
102
-
103
- switch (e.key) {
104
- case 'Enter':
105
- case ' ':
106
- e.preventDefault();
107
- this._toggleDropdown();
108
- break;
109
- case 'Escape':
110
- if (this._isOpen) {
111
- e.preventDefault();
112
- this._closeDropdown();
113
- trigger.focus();
114
- }
115
- break;
116
- case 'ArrowDown':
117
- if (!this._isOpen) {
118
- e.preventDefault();
119
- this._toggleDropdown();
120
- } else {
121
- e.preventDefault();
122
- this._navigateOptions(1);
123
- }
124
- break;
125
- case 'ArrowUp':
126
- if (this._isOpen) {
127
- e.preventDefault();
128
- this._navigateOptions(-1);
129
- }
130
- break;
131
- }
132
- }
133
-
134
- _navigateOptions(direction) {
135
- const options = this.shadowRoot.querySelectorAll('.select-option');
136
- if (options.length === 0) {return;}
137
-
138
- let newIndex = this._selectedIndex + direction;
139
- if (newIndex < 0) {newIndex = options.length - 1;}
140
- if (newIndex >= options.length) {newIndex = 0;}
141
-
142
- this._selectedIndex = newIndex;
143
- this.render();
144
- this._setupListeners();
145
-
146
- // Focus the selected option
147
- const selectedOption = this.shadowRoot.querySelector('.select-option.selected');
148
- selectedOption?.scrollIntoView({ block: 'nearest' });
149
- }
150
-
151
- attributeChangedCallback() {
152
- this.render();
153
- this._setupListeners();
154
- }
155
-
156
- render() {
157
- const label = this.getAttribute('label') || '';
158
- const placeholder = this.getAttribute('placeholder') || 'Select an option';
159
- const theme = this.getAttribute('theme') || 'tanzania';
160
- const error = this.getAttribute('error') || '';
161
- const required = this.hasAttribute('required');
162
- const ariaLabel = this.getAttribute('aria-label');
163
- const ariaDescribedBy = this.getAttribute('aria-describedby');
164
-
165
- const themes = {
166
- tanzania: { focus: '#1EB53A', error: '#DC3545' },
167
- maasai: { focus: '#FF0000', error: '#8B0000' },
168
- ndebele: { focus: '#4169E1', error: '#DC143C' }
169
- };
170
- const t = themes[theme] || themes.tanzania;
171
-
172
- const describedByList = [];
173
- if (error) {describedByList.push(`error-${this._uniqueId}`);}
174
- if (ariaDescribedBy) {describedByList.push(...ariaDescribedBy.split(' '));}
175
- const combinedDescribedBy = describedByList.length > 0 ? `aria-describedby="${describedByList.join(' ')}"` : '';
176
-
177
- const selectedLabel = this._selectedIndex >= 0
178
- ? this._options[this._selectedIndex]?.label
179
- : placeholder;
180
-
181
- this.shadowRoot.innerHTML = `
182
- <style>
183
- :host {
184
- display: block;
185
- font-family: 'Inter', system-ui, sans-serif;
186
- position: relative;
187
- }
188
-
189
- label {
190
- display: block;
191
- font-weight: 500;
192
- margin-bottom: 5px;
193
- color: #333;
194
- font-size: 14px;
195
- }
196
-
197
- .required-star {
198
- color: ${t.error};
199
- margin-left: 2px;
200
- }
201
-
202
- .select-container {
203
- position: relative;
204
- }
205
-
206
- .select-trigger {
207
- width: 100%;
208
- padding: 10px 40px 10px 13px;
209
- font-size: 15px;
210
- border: 2px solid ${error ? t.error : '#ddd'};
211
- border-radius: 5px;
212
- background: white;
213
- cursor: pointer;
214
- text-align: left;
215
- font-family: inherit;
216
- transition: all 200ms ease;
217
- color: ${this._selectedIndex >= 0 ? '#333' : '#888'};
218
- }
219
-
220
- .select-trigger:focus,
221
- .select-trigger.open {
222
- outline: none;
223
- border-color: ${error ? t.error : t.focus};
224
- box-shadow: 0 0 0 3px ${error ? t.error + '20' : t.focus + '20'};
225
- }
226
-
227
- .select-arrow {
228
- position: absolute;
229
- right: 13px;
230
- top: 50%;
231
- transform: translateY(-50%);
232
- pointer-events: none;
233
- transition: transform 200ms ease;
234
- }
235
-
236
- .select-trigger.open + .select-arrow {
237
- transform: translateY(-50%) rotate(180deg);
238
- }
239
-
240
- .select-dropdown {
241
- position: absolute;
242
- top: 100%;
243
- left: 0;
244
- right: 0;
245
- background: white;
246
- border: 2px solid #ddd;
247
- border-radius: 5px;
248
- margin-top: 4px;
249
- max-height: 0;
250
- overflow: hidden;
251
- opacity: 0;
252
- transition: all 200ms ease;
253
- z-index: 1000;
254
- box-shadow: 0 4px 12px rgba(0,0,0,0.15);
255
- }
256
-
257
- .select-dropdown.open {
258
- max-height: 200px;
259
- overflow-y: auto;
260
- opacity: 1;
261
- }
262
-
263
- .select-option {
264
- padding: 10px 13px;
265
- cursor: pointer;
266
- transition: background 150ms ease;
267
- }
268
-
269
- .select-option:hover {
270
- background: ${t.focus}15;
271
- }
272
-
273
- .select-option.selected {
274
- background: ${t.focus};
275
- color: white;
276
- }
277
-
278
- .error-text {
279
- font-size: 12px;
280
- margin-top: 4px;
281
- color: ${t.error};
282
- }
283
-
284
- ::slotted(option) {
285
- display: none;
286
- }
287
- </style>
288
-
289
- ${label ? `<label for="select-${this._uniqueId}">${label}${required ? '<span class="required-star">*</span>' : ''}</label>` : ''}
290
- <div class="select-container">
291
- <button type="button"
292
- id="select-${this._uniqueId}"
293
- class="select-trigger ${this._isOpen ? 'open' : ''}"
294
- aria-expanded="${this._isOpen}"
295
- aria-haspopup="listbox"
296
- ${ariaLabel ? `aria-label="${ariaLabel}"` : ''}
297
- ${error ? 'aria-invalid="true"' : ''}
298
- ${combinedDescribedBy}>
299
- ${selectedLabel}
300
- </button>
301
- <span class="select-arrow" aria-hidden="true">▼</span>
302
- <div class="select-dropdown ${this._isOpen ? 'open' : ''}"
303
- role="listbox"
304
- aria-hidden="${!this._isOpen}">
305
- ${this._options.map((opt, i) => `
306
- <div class="select-option ${i === this._selectedIndex ? 'selected' : ''}"
307
- data-index="${i}"
308
- role="option"
309
- aria-selected="${i === this._selectedIndex}">
310
- ${opt.label}
311
- </div>
312
- `).join('')}
313
- </div>
314
- </div>
315
- ${error ? `<div id="error-${this._uniqueId}" class="error-text" role="alert">${error}</div>` : ''}
316
- <slot></slot>
317
- `;
318
- }
319
- }
320
-
321
- registerComponent('af-select', AfriSelect);
322
- export default AfriSelect;
1
+ /**
2
+ * AfriCode Select/Dropdown Component
3
+ *
4
+ * Custom styled select dropdown for forms.
5
+ * Suitable for: Forms, Filters, Settings, Language selection
6
+ *
7
+ * @module components/select
8
+ */
9
+
10
+ import { AfriCodeComponent, registerComponent } from './base.js';
11
+
12
+ export class AfriSelect extends AfriCodeComponent {
13
+ static get observedAttributes() {
14
+ return ['label', 'placeholder', 'theme', 'error', 'required', 'aria-label', 'aria-describedby'];
15
+ }
16
+
17
+ constructor() {
18
+ super();
19
+ this._uniqueId = Math.random().toString(36).substr(2, 9);
20
+ this._isOpen = false;
21
+ this._selectedIndex = -1;
22
+ this._options = [];
23
+ this.render();
24
+ }
25
+
26
+ get value() {
27
+ return this._selectedIndex >= 0 ? this._options[this._selectedIndex]?.value : '';
28
+ }
29
+
30
+ connectedCallback() {
31
+ this._options = Array.from(this.querySelectorAll('option')).map(opt => ({
32
+ value: opt.value,
33
+ label: opt.textContent
34
+ }));
35
+ this.render();
36
+ this._setupListeners();
37
+ }
38
+
39
+ _setupListeners() {
40
+ const trigger = this.shadowRoot.querySelector('.select-trigger');
41
+
42
+ trigger?.addEventListener('click', () => {
43
+ this._toggleDropdown();
44
+ });
45
+
46
+ trigger?.addEventListener('keydown', (e) => {
47
+ this._handleKeydown(e);
48
+ });
49
+
50
+ this.shadowRoot.querySelectorAll('.select-option').forEach((opt, i) => {
51
+ opt.addEventListener('click', () => {
52
+ this._selectOption(i);
53
+ });
54
+ });
55
+
56
+ document.addEventListener('click', (e) => {
57
+ if (!this.contains(e.target) && this._isOpen) {
58
+ this._closeDropdown();
59
+ }
60
+ });
61
+ }
62
+
63
+ _toggleDropdown() {
64
+ this._isOpen = !this._isOpen;
65
+ const trigger = this.shadowRoot.querySelector('.select-trigger');
66
+ const dropdown = this.shadowRoot.querySelector('.select-dropdown');
67
+
68
+ dropdown?.classList.toggle('open', this._isOpen);
69
+ trigger?.classList.toggle('open', this._isOpen);
70
+
71
+ if (this._isOpen) {
72
+ trigger?.setAttribute('aria-expanded', 'true');
73
+ dropdown?.setAttribute('aria-hidden', 'false');
74
+ } else {
75
+ trigger?.setAttribute('aria-expanded', 'false');
76
+ dropdown?.setAttribute('aria-hidden', 'true');
77
+ }
78
+ }
79
+
80
+ _closeDropdown() {
81
+ this._isOpen = false;
82
+ const trigger = this.shadowRoot.querySelector('.select-trigger');
83
+ const dropdown = this.shadowRoot.querySelector('.select-dropdown');
84
+
85
+ dropdown?.classList.remove('open');
86
+ trigger?.classList.remove('open');
87
+ trigger?.setAttribute('aria-expanded', 'false');
88
+ dropdown?.setAttribute('aria-hidden', 'true');
89
+ }
90
+
91
+ _selectOption(index) {
92
+ this._selectedIndex = index;
93
+ this._closeDropdown();
94
+ this.render();
95
+ this._setupListeners();
96
+ this.emit('af-change', { value: this.value, label: this._options[index].label });
97
+ }
98
+
99
+ _handleKeydown(e) {
100
+ const trigger = this.shadowRoot.querySelector('.select-trigger');
101
+
102
+ switch (e.key) {
103
+ case 'Enter':
104
+ case ' ':
105
+ e.preventDefault();
106
+ this._toggleDropdown();
107
+ break;
108
+ case 'Escape':
109
+ if (this._isOpen) {
110
+ e.preventDefault();
111
+ this._closeDropdown();
112
+ trigger.focus();
113
+ }
114
+ break;
115
+ case 'ArrowDown':
116
+ if (!this._isOpen) {
117
+ e.preventDefault();
118
+ this._toggleDropdown();
119
+ } else {
120
+ e.preventDefault();
121
+ this._navigateOptions(1);
122
+ }
123
+ break;
124
+ case 'ArrowUp':
125
+ if (this._isOpen) {
126
+ e.preventDefault();
127
+ this._navigateOptions(-1);
128
+ }
129
+ break;
130
+ }
131
+ }
132
+
133
+ _navigateOptions(direction) {
134
+ const options = this.shadowRoot.querySelectorAll('.select-option');
135
+ if (options.length === 0) {return;}
136
+
137
+ let newIndex = this._selectedIndex + direction;
138
+ if (newIndex < 0) {newIndex = options.length - 1;}
139
+ if (newIndex >= options.length) {newIndex = 0;}
140
+
141
+ this._selectedIndex = newIndex;
142
+ this.render();
143
+ this._setupListeners();
144
+
145
+ // Focus the selected option
146
+ const selectedOption = this.shadowRoot.querySelector('.select-option.selected');
147
+ selectedOption?.scrollIntoView({ block: 'nearest' });
148
+ }
149
+
150
+ attributeChangedCallback() {
151
+ this.render();
152
+ this._setupListeners();
153
+ }
154
+
155
+ render() {
156
+ const label = this.getAttribute('label') || '';
157
+ const placeholder = this.getAttribute('placeholder') || 'Select an option';
158
+ const theme = this.getAttribute('theme') || 'tanzania';
159
+ const error = this.getAttribute('error') || '';
160
+ const required = this.hasAttribute('required');
161
+ const ariaLabel = this.getAttribute('aria-label');
162
+ const ariaDescribedBy = this.getAttribute('aria-describedby');
163
+
164
+ const themes = {
165
+ tanzania: { focus: '#1EB53A', error: '#DC3545' },
166
+ maasai: { focus: '#FF0000', error: '#8B0000' },
167
+ ndebele: { focus: '#4169E1', error: '#DC143C' }
168
+ };
169
+ const t = themes[theme] || themes.tanzania;
170
+
171
+ const describedByList = [];
172
+ if (error) {describedByList.push(`error-${this._uniqueId}`);}
173
+ if (ariaDescribedBy) {describedByList.push(...ariaDescribedBy.split(' '));}
174
+ const combinedDescribedBy = describedByList.length > 0 ? `aria-describedby="${describedByList.join(' ')}"` : '';
175
+
176
+ const selectedLabel = this._selectedIndex >= 0
177
+ ? this._options[this._selectedIndex]?.label
178
+ : placeholder;
179
+
180
+ this.shadowRoot.innerHTML = `
181
+ <style>
182
+ :host {
183
+ display: block;
184
+ font-family: 'Inter', system-ui, sans-serif;
185
+ position: relative;
186
+ }
187
+
188
+ label {
189
+ display: block;
190
+ font-weight: 500;
191
+ margin-bottom: 5px;
192
+ color: #333;
193
+ font-size: 14px;
194
+ }
195
+
196
+ .required-star {
197
+ color: ${t.error};
198
+ margin-left: 2px;
199
+ }
200
+
201
+ .select-container {
202
+ position: relative;
203
+ }
204
+
205
+ .select-trigger {
206
+ width: 100%;
207
+ padding: 10px 40px 10px 13px;
208
+ font-size: 15px;
209
+ border: 2px solid ${error ? t.error : '#ddd'};
210
+ border-radius: 5px;
211
+ background: white;
212
+ cursor: pointer;
213
+ text-align: left;
214
+ font-family: inherit;
215
+ transition: all 200ms ease;
216
+ color: ${this._selectedIndex >= 0 ? '#333' : '#888'};
217
+ }
218
+
219
+ .select-trigger:focus,
220
+ .select-trigger.open {
221
+ outline: none;
222
+ border-color: ${error ? t.error : t.focus};
223
+ box-shadow: 0 0 0 3px ${error ? t.error + '20' : t.focus + '20'};
224
+ }
225
+
226
+ .select-arrow {
227
+ position: absolute;
228
+ right: 13px;
229
+ top: 50%;
230
+ transform: translateY(-50%);
231
+ pointer-events: none;
232
+ transition: transform 200ms ease;
233
+ }
234
+
235
+ .select-trigger.open + .select-arrow {
236
+ transform: translateY(-50%) rotate(180deg);
237
+ }
238
+
239
+ .select-dropdown {
240
+ position: absolute;
241
+ top: 100%;
242
+ left: 0;
243
+ right: 0;
244
+ background: white;
245
+ border: 2px solid #ddd;
246
+ border-radius: 5px;
247
+ margin-top: 4px;
248
+ max-height: 0;
249
+ overflow: hidden;
250
+ opacity: 0;
251
+ transition: all 200ms ease;
252
+ z-index: 1000;
253
+ box-shadow: 0 4px 12px rgba(0,0,0,0.15);
254
+ }
255
+
256
+ .select-dropdown.open {
257
+ max-height: 200px;
258
+ overflow-y: auto;
259
+ opacity: 1;
260
+ }
261
+
262
+ .select-option {
263
+ padding: 10px 13px;
264
+ cursor: pointer;
265
+ transition: background 150ms ease;
266
+ }
267
+
268
+ .select-option:hover {
269
+ background: ${t.focus}15;
270
+ }
271
+
272
+ .select-option.selected {
273
+ background: ${t.focus};
274
+ color: white;
275
+ }
276
+
277
+ .error-text {
278
+ font-size: 12px;
279
+ margin-top: 4px;
280
+ color: ${t.error};
281
+ }
282
+
283
+ ::slotted(option) {
284
+ display: none;
285
+ }
286
+ </style>
287
+
288
+ ${label ? `<label for="select-${this._uniqueId}">${label}${required ? '<span class="required-star">*</span>' : ''}</label>` : ''}
289
+ <div class="select-container">
290
+ <button type="button"
291
+ id="select-${this._uniqueId}"
292
+ class="select-trigger ${this._isOpen ? 'open' : ''}"
293
+ aria-expanded="${this._isOpen}"
294
+ aria-haspopup="listbox"
295
+ ${ariaLabel ? `aria-label="${ariaLabel}"` : ''}
296
+ ${error ? 'aria-invalid="true"' : ''}
297
+ ${combinedDescribedBy}>
298
+ ${selectedLabel}
299
+ </button>
300
+ <span class="select-arrow" aria-hidden="true">▼</span>
301
+ <div class="select-dropdown ${this._isOpen ? 'open' : ''}"
302
+ role="listbox"
303
+ aria-hidden="${!this._isOpen}">
304
+ ${this._options.map((opt, i) => `
305
+ <div class="select-option ${i === this._selectedIndex ? 'selected' : ''}"
306
+ data-index="${i}"
307
+ role="option"
308
+ aria-selected="${i === this._selectedIndex}">
309
+ ${opt.label}
310
+ </div>
311
+ `).join('')}
312
+ </div>
313
+ </div>
314
+ ${error ? `<div id="error-${this._uniqueId}" class="error-text" role="alert">${error}</div>` : ''}
315
+ <slot></slot>
316
+ `;
317
+ }
318
+ }
319
+
320
+ registerComponent('af-select', AfriSelect);
321
+ export default AfriSelect;