@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,234 +1,234 @@
1
- /**
2
- * AfriCode Base Component
3
- *
4
- * Abstract base class for all AfriCode Web Components.
5
- * Provides common utilities and enforces the Shadow DOM pattern.
6
- *
7
- * @module components/base
8
- */
9
-
10
- import { html } from '../core/html.js';
11
-
12
- const BaseHTMLElement = globalThis.HTMLElement ?? class {};
13
- const hasConstructableStylesheets = typeof CSSStyleSheet !== 'undefined';
14
-
15
- /**
16
- * Base class for AfriCode components
17
- * All components extend this to inherit common functionality
18
- */
19
- export class AfriCodeComponent extends BaseHTMLElement {
20
- constructor() {
21
- super();
22
- this.attachShadow({ mode: 'open' });
23
-
24
- // Native Web Component Error Boundary: intercept child render calls
25
- const originalRender = this.render;
26
- if (originalRender && typeof originalRender === 'function') {
27
- this.render = () => {
28
- try {
29
- originalRender.call(this);
30
- this.removeAttribute('has-error');
31
- } catch (error) {
32
- console.error(`[AfriCode] Rendering error in <${this.localName}>:`, error);
33
- this.setAttribute('has-error', 'true');
34
- this.shadowRoot.innerHTML = `
35
- <style>
36
- .af-local-error {
37
- padding: 1rem;
38
- border: 1px dashed rgba(220, 20, 60, 0.4);
39
- border-radius: 4px;
40
- color: #DC143C;
41
- font-family: 'Inter', system-ui, sans-serif;
42
- font-size: 0.85rem;
43
- display: flex;
44
- align-items: center;
45
- gap: 8px;
46
- background: rgba(220, 20, 60, 0.05);
47
- }
48
- </style>
49
- <div class="af-local-error">
50
- <span aria-hidden="true">⚠️</span>
51
- <span>Failed to render</span>
52
- </div>
53
- `;
54
- this.emit('af-component-error', {
55
- component: this.localName,
56
- message: error.message,
57
- stack: error.stack
58
- });
59
- }
60
- };
61
- }
62
- }
63
-
64
- /**
65
- * Component lifecycle - connected to DOM
66
- * Empty base implementation to support super calls in subclasses.
67
- */
68
- connectedCallback() { }
69
-
70
- /**
71
- * Load shared Africanity styles into Shadow DOM
72
- */
73
- // Static cache for Constructable Stylesheets to prevent fetch waterfall
74
- static styleCache = new Map();
75
-
76
- /**
77
- * Global stylesheets injected by adapters (e.g. Tailwind, custom design systems).
78
- * Each entry must be a CSSStyleSheet instance.
79
- * Usage: AfriCodeComponent.injectGlobalSheet(sheet)
80
- * @type {CSSStyleSheet[]}
81
- */
82
- static globalSheets = [];
83
-
84
- /**
85
- * Inject a global CSSStyleSheet into every AfriCode component's Shadow DOM.
86
- * This is the primary integration point for external CSS frameworks like Tailwind.
87
- * @param {CSSStyleSheet} sheet - A Constructable Stylesheet instance
88
- */
89
- static injectGlobalSheet(sheet) {
90
- if (!hasConstructableStylesheets) {
91
- return;
92
- }
93
-
94
- if (!(sheet instanceof CSSStyleSheet)) {
95
- return;
96
- }
97
- if (!AfriCodeComponent.globalSheets.includes(sheet)) {
98
- AfriCodeComponent.globalSheets.push(sheet);
99
- }
100
- }
101
-
102
- /**
103
- * Load shared Africanity styles into Shadow DOM.
104
- * Optimized to fetch only once per session.
105
- * Also adopts any globally injected sheets (e.g. Tailwind utilities).
106
- */
107
- async loadStyles(css = '') {
108
- const styleUrl = '/styles/africanity.css';
109
- if (!this.shadowRoot) {
110
- return;
111
- }
112
-
113
- const canAdoptStyleSheets = hasConstructableStylesheets && 'adoptedStyleSheets' in this.shadowRoot;
114
- const sourceKey = typeof css === 'string' && css.length > 0 ? css : styleUrl;
115
- const stylesheetText = typeof css === 'string' && css.length > 0 ? css : null;
116
-
117
- // 1. Check cache first
118
- if (AfriCodeComponent.styleCache.has(sourceKey)) {
119
- const cached = AfriCodeComponent.styleCache.get(sourceKey);
120
- if (canAdoptStyleSheets) {
121
- this.shadowRoot.adoptedStyleSheets = [
122
- cached,
123
- ...AfriCodeComponent.globalSheets
124
- ];
125
- } else {
126
- this._applyFallbackStyle(cached?.cssText || cached?.text || cached || '');
127
- }
128
- return;
129
- }
130
-
131
- // 2. Fetch if not cached (Single Request)
132
- try {
133
- let resolvedCss = stylesheetText;
134
-
135
- if (!resolvedCss) {
136
- const response = await fetch(styleUrl);
137
- if (!response.ok) {
138
- throw new Error(`Unable to load stylesheet: ${response.status}`);
139
- }
140
- resolvedCss = await response.text();
141
- }
142
-
143
- if (canAdoptStyleSheets) {
144
- const styleSheet = new CSSStyleSheet();
145
- styleSheet.replaceSync(resolvedCss);
146
-
147
- // Cache it
148
- AfriCodeComponent.styleCache.set(sourceKey, styleSheet);
149
-
150
- // Apply core + any global sheets
151
- this.shadowRoot.adoptedStyleSheets = [
152
- styleSheet,
153
- ...AfriCodeComponent.globalSheets
154
- ];
155
- return;
156
- }
157
-
158
- this._applyFallbackStyle(resolvedCss);
159
- AfriCodeComponent.styleCache.set(sourceKey, { text: resolvedCss });
160
- } catch (err) {
161
- this._applyFallbackStyle(stylesheetText || '');
162
- }
163
- }
164
-
165
- _applyFallbackStyle(css) {
166
- if (!this.shadowRoot) {
167
- return;
168
- }
169
-
170
- let style = this.shadowRoot.querySelector('style[data-africode-core-styles]');
171
- if (!style) {
172
- style = document.createElement('style');
173
- style.setAttribute('data-africode-core-styles', '');
174
- this.shadowRoot.prepend(style);
175
- }
176
-
177
- style.textContent = css;
178
- }
179
-
180
- /**
181
- * Get Fibonacci spacing value
182
- * @param {number} index - Fibonacci sequence index (1,2,3,5,8,13,21,34,55)
183
- * @returns {string} CSS variable reference
184
- */
185
- spacing(index) {
186
- return `var(--space-${index})`;
187
- }
188
-
189
- /**
190
- * Create element with classes and attributes
191
- * @param {string} tag - HTML tag name
192
- * @param {Object} options - Element options
193
- * @returns {HTMLElement}
194
- */
195
- createElement(tag, { classes = [], attributes = {}, text = '' } = {}) {
196
- const el = document.createElement(tag);
197
- if (classes.length) {el.classList.add(...classes);}
198
- Object.entries(attributes).forEach(([key, value]) => el.setAttribute(key, value));
199
- if (text) {el.textContent = text;}
200
- return el;
201
- }
202
-
203
-
204
- /**
205
- * Emit a custom event
206
- * @param {string} name - Event name
207
- * @param {*} detail - Event detail data
208
- */
209
- emit(name, detail) {
210
- this.dispatchEvent(new CustomEvent(name, {
211
- detail,
212
- bubbles: true,
213
- composed: true
214
- }));
215
- }
216
- }
217
-
218
- /**
219
- * Register a component with the Custom Elements registry
220
- * @param {string} name - Component tag name (must include hyphen)
221
- * @param {typeof HTMLElement} component - Component class
222
- */
223
- export function registerComponent(name, component) {
224
- if (typeof customElements === 'undefined') {
225
- return;
226
- }
227
-
228
- if (!customElements.get(name)) {
229
- customElements.define(name, component);
230
- }
231
- }
232
-
233
- export { html };
234
- export default { AfriCodeComponent, registerComponent, html };
1
+ /**
2
+ * AfriCode Base Component
3
+ *
4
+ * Abstract base class for all AfriCode Web Components.
5
+ * Provides common utilities and enforces the Shadow DOM pattern.
6
+ *
7
+ * @module components/base
8
+ */
9
+
10
+ import { html } from '../core/html.js';
11
+
12
+ const BaseHTMLElement = globalThis.HTMLElement ?? class {};
13
+ const hasConstructableStylesheets = typeof CSSStyleSheet !== 'undefined';
14
+
15
+ /**
16
+ * Base class for AfriCode components
17
+ * All components extend this to inherit common functionality
18
+ */
19
+ export class AfriCodeComponent extends BaseHTMLElement {
20
+ constructor() {
21
+ super();
22
+ this.attachShadow({ mode: 'open' });
23
+
24
+ // Native Web Component Error Boundary: intercept child render calls
25
+ const originalRender = this.render;
26
+ if (originalRender && typeof originalRender === 'function') {
27
+ this.render = () => {
28
+ try {
29
+ originalRender.call(this);
30
+ this.removeAttribute('has-error');
31
+ } catch (error) {
32
+ console.error(`[AfriCode] Rendering error in <${this.localName}>:`, error);
33
+ this.setAttribute('has-error', 'true');
34
+ this.shadowRoot.innerHTML = `
35
+ <style>
36
+ .af-local-error {
37
+ padding: 1rem;
38
+ border: 1px dashed rgba(220, 20, 60, 0.4);
39
+ border-radius: 4px;
40
+ color: #DC143C;
41
+ font-family: 'Inter', system-ui, sans-serif;
42
+ font-size: 0.85rem;
43
+ display: flex;
44
+ align-items: center;
45
+ gap: 8px;
46
+ background: rgba(220, 20, 60, 0.05);
47
+ }
48
+ </style>
49
+ <div class="af-local-error">
50
+ <span aria-hidden="true">⚠️</span>
51
+ <span>Failed to render</span>
52
+ </div>
53
+ `;
54
+ this.emit('af-component-error', {
55
+ component: this.localName,
56
+ message: error.message,
57
+ stack: error.stack
58
+ });
59
+ }
60
+ };
61
+ }
62
+ }
63
+
64
+ /**
65
+ * Component lifecycle - connected to DOM
66
+ * Empty base implementation to support super calls in subclasses.
67
+ */
68
+ connectedCallback() { }
69
+
70
+ /**
71
+ * Load shared Africanity styles into Shadow DOM
72
+ */
73
+ // Static cache for Constructable Stylesheets to prevent fetch waterfall
74
+ static styleCache = new Map();
75
+
76
+ /**
77
+ * Global stylesheets injected by adapters (e.g. Tailwind, custom design systems).
78
+ * Each entry must be a CSSStyleSheet instance.
79
+ * Usage: AfriCodeComponent.injectGlobalSheet(sheet)
80
+ * @type {CSSStyleSheet[]}
81
+ */
82
+ static globalSheets = [];
83
+
84
+ /**
85
+ * Inject a global CSSStyleSheet into every AfriCode component's Shadow DOM.
86
+ * This is the primary integration point for external CSS frameworks like Tailwind.
87
+ * @param {CSSStyleSheet} sheet - A Constructable Stylesheet instance
88
+ */
89
+ static injectGlobalSheet(sheet) {
90
+ if (!hasConstructableStylesheets) {
91
+ return;
92
+ }
93
+
94
+ if (!(sheet instanceof CSSStyleSheet)) {
95
+ return;
96
+ }
97
+ if (!AfriCodeComponent.globalSheets.includes(sheet)) {
98
+ AfriCodeComponent.globalSheets.push(sheet);
99
+ }
100
+ }
101
+
102
+ /**
103
+ * Load shared Africanity styles into Shadow DOM.
104
+ * Optimized to fetch only once per session.
105
+ * Also adopts any globally injected sheets (e.g. Tailwind utilities).
106
+ */
107
+ async loadStyles(css = '') {
108
+ const styleUrl = '/styles/africanity.css';
109
+ if (!this.shadowRoot) {
110
+ return;
111
+ }
112
+
113
+ const canAdoptStyleSheets = hasConstructableStylesheets && 'adoptedStyleSheets' in this.shadowRoot;
114
+ const sourceKey = typeof css === 'string' && css.length > 0 ? css : styleUrl;
115
+ const stylesheetText = typeof css === 'string' && css.length > 0 ? css : null;
116
+
117
+ // 1. Check cache first
118
+ if (AfriCodeComponent.styleCache.has(sourceKey)) {
119
+ const cached = AfriCodeComponent.styleCache.get(sourceKey);
120
+ if (canAdoptStyleSheets) {
121
+ this.shadowRoot.adoptedStyleSheets = [
122
+ cached,
123
+ ...AfriCodeComponent.globalSheets
124
+ ];
125
+ } else {
126
+ this._applyFallbackStyle(cached?.cssText || cached?.text || cached || '');
127
+ }
128
+ return;
129
+ }
130
+
131
+ // 2. Fetch if not cached (Single Request)
132
+ try {
133
+ let resolvedCss = stylesheetText;
134
+
135
+ if (!resolvedCss) {
136
+ const response = await fetch(styleUrl);
137
+ if (!response.ok) {
138
+ throw new Error(`Unable to load stylesheet: ${response.status}`);
139
+ }
140
+ resolvedCss = await response.text();
141
+ }
142
+
143
+ if (canAdoptStyleSheets) {
144
+ const styleSheet = new CSSStyleSheet();
145
+ styleSheet.replaceSync(resolvedCss);
146
+
147
+ // Cache it
148
+ AfriCodeComponent.styleCache.set(sourceKey, styleSheet);
149
+
150
+ // Apply core + any global sheets
151
+ this.shadowRoot.adoptedStyleSheets = [
152
+ styleSheet,
153
+ ...AfriCodeComponent.globalSheets
154
+ ];
155
+ return;
156
+ }
157
+
158
+ this._applyFallbackStyle(resolvedCss);
159
+ AfriCodeComponent.styleCache.set(sourceKey, { text: resolvedCss });
160
+ } catch {
161
+ this._applyFallbackStyle(stylesheetText || '');
162
+ }
163
+ }
164
+
165
+ _applyFallbackStyle(css) {
166
+ if (!this.shadowRoot) {
167
+ return;
168
+ }
169
+
170
+ let style = this.shadowRoot.querySelector('style[data-africode-core-styles]');
171
+ if (!style) {
172
+ style = document.createElement('style');
173
+ style.setAttribute('data-africode-core-styles', '');
174
+ this.shadowRoot.prepend(style);
175
+ }
176
+
177
+ style.textContent = css;
178
+ }
179
+
180
+ /**
181
+ * Get Fibonacci spacing value
182
+ * @param {number} index - Fibonacci sequence index (1,2,3,5,8,13,21,34,55)
183
+ * @returns {string} CSS variable reference
184
+ */
185
+ spacing(index) {
186
+ return `var(--space-${index})`;
187
+ }
188
+
189
+ /**
190
+ * Create element with classes and attributes
191
+ * @param {string} tag - HTML tag name
192
+ * @param {Object} options - Element options
193
+ * @returns {HTMLElement}
194
+ */
195
+ createElement(tag, { classes = [], attributes = {}, text = '' } = {}) {
196
+ const el = document.createElement(tag);
197
+ if (classes.length) {el.classList.add(...classes);}
198
+ Object.entries(attributes).forEach(([key, value]) => el.setAttribute(key, value));
199
+ if (text) {el.textContent = text;}
200
+ return el;
201
+ }
202
+
203
+
204
+ /**
205
+ * Emit a custom event
206
+ * @param {string} name - Event name
207
+ * @param {*} detail - Event detail data
208
+ */
209
+ emit(name, detail) {
210
+ this.dispatchEvent(new CustomEvent(name, {
211
+ detail,
212
+ bubbles: true,
213
+ composed: true
214
+ }));
215
+ }
216
+ }
217
+
218
+ /**
219
+ * Register a component with the Custom Elements registry
220
+ * @param {string} name - Component tag name (must include hyphen)
221
+ * @param {typeof HTMLElement} component - Component class
222
+ */
223
+ export function registerComponent(name, component) {
224
+ if (typeof customElements === 'undefined') {
225
+ return;
226
+ }
227
+
228
+ if (!customElements.get(name)) {
229
+ customElements.define(name, component);
230
+ }
231
+ }
232
+
233
+ export { html };
234
+ export default { AfriCodeComponent, registerComponent, html };
@@ -1,72 +1,76 @@
1
- /**
2
- * AfriCode Breadcrumb Component
3
- *
4
- * Simple breadcrumb trail for website navigation.
5
- * @module components/breadcrumb
6
- */
7
-
8
- import { AfriCodeComponent, registerComponent, html } from './base.js';
9
-
10
- export class AfriBreadcrumb extends AfriCodeComponent {
11
- static get observedAttributes() {
12
- return ['separator'];
13
- }
14
-
15
- constructor() {
16
- super();
17
- this.render();
18
- }
19
-
20
- attributeChangedCallback() {
21
- this.render();
22
- }
23
-
24
- render() {
25
- const separator = this.getAttribute('separator') || '/';
26
-
27
- this.shadowRoot.innerHTML = html`
28
- <style>
29
- :host {
30
- display: block;
31
- font-family: 'Inter', system-ui, sans-serif;
32
- color: #475569;
33
- font-size: 0.9rem;
34
- }
35
-
36
- nav {
37
- display: flex;
38
- flex-wrap: wrap;
39
- gap: 0.5rem;
40
- align-items: center;
41
- }
42
-
43
- .crumb {
44
- display: inline-flex;
45
- align-items: center;
46
- gap: 0.35rem;
47
- }
48
-
49
- .separator {
50
- color: #cbd5e1;
51
- }
52
-
53
- ::slotted(a) {
54
- color: #0f172a;
55
- text-decoration: none;
56
- font-weight: 600;
57
- }
58
-
59
- ::slotted(a:hover) {
60
- text-decoration: underline;
61
- }
62
- </style>
63
-
64
- <nav aria-label="Breadcrumb">
65
- <slot></slot>
66
- </nav>
67
- `;
68
- }
69
- }
70
-
71
- registerComponent('af-breadcrumb', AfriBreadcrumb);
72
- export default AfriBreadcrumb;
1
+ /**
2
+ * AfriCode Breadcrumb Component
3
+ *
4
+ * Simple breadcrumb trail for website navigation.
5
+ * @module components/breadcrumb
6
+ */
7
+
8
+ import { AfriCodeComponent, registerComponent, html } from './base.js';
9
+
10
+ export class AfriBreadcrumb extends AfriCodeComponent {
11
+ static get observedAttributes() {
12
+ return ['separator'];
13
+ }
14
+
15
+ constructor() {
16
+ super();
17
+ this.render();
18
+ }
19
+
20
+ attributeChangedCallback() {
21
+ this.render();
22
+ }
23
+
24
+ render() {
25
+ const separator = this.getAttribute('separator') || '/';
26
+
27
+ this.shadowRoot.innerHTML = html`
28
+ <style>
29
+ :host {
30
+ display: block;
31
+ font-family: 'Inter', system-ui, sans-serif;
32
+ color: #475569;
33
+ font-size: 0.9rem;
34
+ }
35
+
36
+ nav {
37
+ display: flex;
38
+ flex-wrap: wrap;
39
+ gap: 0.5rem;
40
+ align-items: center;
41
+ }
42
+
43
+ .crumb {
44
+ display: inline-flex;
45
+ align-items: center;
46
+ gap: 0.35rem;
47
+ }
48
+
49
+ .separator {
50
+ color: #cbd5e1;
51
+ }
52
+
53
+ nav {
54
+ --af-breadcrumb-separator: '${separator}';
55
+ }
56
+
57
+ ::slotted(a) {
58
+ color: #0f172a;
59
+ text-decoration: none;
60
+ font-weight: 600;
61
+ }
62
+
63
+ ::slotted(a:hover) {
64
+ text-decoration: underline;
65
+ }
66
+ </style>
67
+
68
+ <nav aria-label="Breadcrumb">
69
+ <slot></slot>
70
+ </nav>
71
+ `;
72
+ }
73
+ }
74
+
75
+ registerComponent('af-breadcrumb', AfriBreadcrumb);
76
+ export default AfriBreadcrumb;