@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.
- package/AGENTS.md +585 -585
- package/AGENT_INSTRUCTIONS.md +595 -595
- package/COMPONENT_SCHEMA.json +1826 -1800
- package/LICENSE +623 -623
- package/README.md +476 -476
- package/bin/africode.js +73 -73
- package/bin/cli.ts +82 -82
- package/bin/create-africode.js +220 -220
- package/bin/scaffold.ts +218 -218
- package/components/accordion.js +183 -183
- package/components/alert.js +131 -131
- package/components/auth-form.js +154 -154
- package/components/auth.js +172 -172
- package/components/avatar.js +117 -117
- package/components/badge.js +104 -104
- package/components/base.d.ts +139 -139
- package/components/base.js +234 -234
- package/components/breadcrumb.js +76 -72
- package/components/button.js +164 -164
- package/components/card.js +144 -137
- package/components/carousel.js +32 -32
- package/components/cart-drawer.js +28 -28
- package/components/code-block.js +20 -20
- package/components/contact-form.js +25 -25
- package/components/cookie-consent.js +23 -23
- package/components/cta-banner.js +38 -38
- package/components/cultural-card.js +243 -243
- package/components/dashboard-activity-list.js +103 -103
- package/components/dashboard-card.js +85 -85
- package/components/dashboard-metric.js +81 -81
- package/components/dashboard-shell.js +85 -85
- package/components/dashboard-topbar.js +84 -84
- package/components/divider.js +83 -83
- package/components/dropdown.js +171 -171
- package/components/error-boundary.js +155 -155
- package/components/faq-accordion.js +23 -23
- package/components/feature-grid.js +85 -85
- package/components/file-uploader.js +22 -22
- package/components/filter-bar.js +19 -19
- package/components/footer.js +113 -113
- package/components/form.js +131 -131
- package/components/gallery.js +22 -22
- package/components/hero.js +140 -138
- package/components/icon.js +36 -36
- package/components/index.js +128 -128
- package/components/input.js +252 -256
- package/components/kanga-card.js +185 -185
- package/components/kyc-upload.js +173 -173
- package/components/language-switcher.js +108 -108
- package/components/loader.js +80 -80
- package/components/modal.js +262 -262
- package/components/motion.js +84 -84
- package/components/nav-drawer.js +216 -216
- package/components/navbar.js +243 -236
- package/components/newsletter-signup.js +24 -24
- package/components/pagination.js +31 -31
- package/components/pattern-showcase.js +225 -225
- package/components/pricing-card.js +100 -100
- package/components/product-card.js +41 -41
- package/components/progress.js +132 -134
- package/components/react.js +111 -111
- package/components/search-box.js +24 -24
- package/components/section.js +54 -54
- package/components/select.js +321 -322
- package/components/sidebar.js +180 -180
- package/components/simple-chart.js +22 -22
- package/components/skeleton.js +85 -85
- package/components/stepper.js +28 -28
- package/components/table.js +181 -181
- package/components/tabs.js +202 -202
- package/components/team-grid.js +23 -23
- package/components/testimonial.js +94 -94
- package/components/theme-toggle.js +82 -82
- package/components/toast.js +139 -139
- package/components/tooltip.js +167 -167
- package/components/transaction-ledger.js +138 -138
- package/components/ui-avatar.js +79 -79
- package/components/ui-badge.js +61 -61
- package/components/ui-button.js +149 -149
- package/components/ui-card.js +74 -75
- package/components/ui-chip.js +87 -87
- package/components/ui-input.js +110 -110
- package/components/ui-popover.js +84 -84
- package/components/ui-progress-ring.js +60 -60
- package/components/ui-select.js +85 -85
- package/components/ui-stat.js +75 -75
- package/components/ui-switch.js +85 -85
- package/components/ui-table.js +69 -69
- package/components/ui-tabs.js +99 -99
- package/components/ui-tag.js +64 -64
- package/components/ui-textarea.js +84 -84
- package/components/ui-tooltip.js +66 -66
- package/components/video-player.js +22 -22
- package/components/wallet-balance.js +114 -114
- package/core/a2ui-schema-manager.js +351 -351
- package/core/a2ui.js +696 -696
- package/core/actions.js +27 -27
- package/core/bun-runtime.js +398 -397
- package/core/cli/commands/add.js +23 -23
- package/core/cli/commands/audit.js +58 -58
- package/core/cli/commands/build.js +193 -193
- package/core/cli/commands/create-plugin.js +241 -241
- package/core/cli/commands/dev.js +252 -285
- package/core/cli/commands/lint.js +23 -23
- package/core/cli/commands/test.js +33 -34
- package/core/cli/migrator.js +71 -71
- package/core/cli/ui.js +56 -56
- package/core/compliance.js +823 -823
- package/core/config.js +265 -265
- package/core/db-advanced.js +478 -481
- package/core/db.js +282 -284
- package/core/enhanced-hmr.js +406 -406
- package/core/errors.js +222 -222
- package/core/file-router.js +52 -50
- package/core/hmr-client.js +203 -204
- package/core/hmr.js +205 -197
- package/core/html.d.ts +30 -30
- package/core/html.js +84 -84
- package/core/hydration.js +52 -52
- package/core/lipa-namba-journey.js +548 -605
- package/core/logging.js +14 -14
- package/core/middleware.js +145 -145
- package/core/motion.js +106 -106
- package/core/nida-cig-middleware.js +417 -460
- package/core/patterns.d.ts +124 -124
- package/core/patterns.js +947 -1001
- package/core/plugins/index.js +345 -345
- package/core/request-analytics.js +253 -253
- package/core/request-identity.js +93 -93
- package/core/router.js +386 -386
- package/core/sdk-browser.js +140 -140
- package/core/sdk-client.js +61 -61
- package/core/sdk.d.ts +133 -133
- package/core/sdk.js +148 -148
- package/core/seo.js +76 -76
- package/core/server/auth-endpoints.js +339 -339
- package/core/server/auth.js +180 -180
- package/core/server/csrf.js +200 -206
- package/core/server/db.js +39 -39
- package/core/server/middleware.js +324 -324
- package/core/server/rate-limit.js +238 -238
- package/core/server/render.js +67 -69
- package/core/server/router.js +102 -120
- package/core/session-store.js +68 -68
- package/core/shim.js +28 -28
- package/core/state.d.ts +86 -86
- package/core/state.js +276 -276
- package/core/store.d.ts +122 -122
- package/core/store.js +61 -61
- package/core/validation.d.ts +232 -232
- package/core/validation.js +602 -602
- package/core/websocket.js +656 -641
- package/dist/africode.js +233 -230
- package/dist/africode.js.map +83 -83
- package/dist/build-info.json +3 -3
- package/dist/components.js +195 -192
- package/dist/components.js.map +73 -73
- package/dist/styles/africanity.css +321 -321
- package/dist/styles/typography.css +140 -140
- package/docs/IDE-Guide.md +50 -50
- package/package.json +113 -113
- package/scripts/generate-component-schema.js +82 -79
- package/styles/africanity.css +321 -321
- package/styles/typography.css +140 -140
- package/templates/starter/.env.example +15 -15
- package/templates/starter/africode.config.js +40 -40
- package/templates/starter/package.json +13 -13
- package/templates/starter/src/index.js +18 -18
- package/templates/starter/src/pages/index.html +55 -55
- package/templates/starter/src/pages/index.js +17 -17
- package/templates/starter/src/styles/main.css +3 -3
- package/templates/starter-3d/.env.example +7 -7
- package/templates/starter-3d/africode.config.js +29 -29
- package/templates/starter-3d/components/af-model-viewer.js +125 -125
- package/templates/starter-3d/package.json +14 -14
- package/templates/starter-3d/src/pages/index.html +55 -55
- package/templates/starter-3d/src/pages/index.js +50 -50
- package/templates/starter-3d/src/styles/main.css +3 -3
- package/templates/starter-dashboard/.env.example +21 -21
- package/templates/starter-dashboard/africode.config.js +20 -20
- package/templates/starter-dashboard/package.json +14 -14
- package/templates/starter-dashboard/src/index.js +17 -17
- package/templates/starter-dashboard/src/pages/api/analytics.js +24 -24
- package/templates/starter-dashboard/src/pages/index.html +118 -118
- package/templates/starter-dashboard/src/pages/index.js +110 -110
- package/templates/starter-dashboard/src/styles/main.css +172 -172
- package/templates/starter-fintech/.env.example +28 -28
- package/templates/starter-fintech/africode.config.js +20 -20
- package/templates/starter-fintech/package.json +15 -15
- package/templates/starter-fintech/src/index.js +17 -17
- package/templates/starter-fintech/src/pages/api/auth.js +45 -45
- package/templates/starter-fintech/src/pages/api/dashboard.js +19 -0
- package/templates/starter-fintech/src/pages/api/transfer.js +65 -65
- package/templates/starter-fintech/src/pages/api/wallet.js +39 -39
- package/templates/starter-fintech/src/pages/api/webhooks/payment.js +32 -32
- package/templates/starter-fintech/src/pages/index.html +169 -169
- package/templates/starter-fintech/src/pages/index.js +161 -161
- package/templates/starter-fintech/src/styles/main.css +246 -246
- package/templates/starter-react/.env.example +15 -15
- package/templates/starter-react/africode.config.js +40 -40
- package/templates/starter-react/package.json +15 -15
- package/templates/starter-react/src/pages/index.html +55 -55
- package/templates/starter-react/src/pages/index.js +68 -68
- package/templates/starter-react/src/styles/main.css +3 -3
- package/templates/starter-tailwind/.env.example +15 -15
- package/templates/starter-tailwind/africode.config.js +40 -40
- package/templates/starter-tailwind/package.json +19 -19
- package/templates/starter-tailwind/src/pages/index.html +55 -55
- package/templates/starter-tailwind/src/pages/index.js +67 -67
- package/templates/starter-tailwind/src/styles/main.css +3 -3
- package/templates/starter-tailwind/src/styles/tailwind.css +1 -1
- package/templates/starter-tailwind/src/tailwind-loader.js +30 -30
- package/templates/starter-tailwind/tailwind.config.cjs +18 -18
- package/templates/starter-website/.env.example +18 -18
- package/templates/starter-website/africode.config.js +20 -20
- package/templates/starter-website/package.json +14 -14
- package/templates/starter-website/src/index.js +17 -17
- package/templates/starter-website/src/pages/index.html +124 -124
- package/templates/starter-website/src/pages/index.js +116 -116
- package/templates/starter-website/src/styles/main.css +195 -195
- package/bin/africode.js.1758507140 +0 -343
- package/core/heartbeat.js +0 -64
package/components/base.js
CHANGED
|
@@ -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
|
|
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 };
|
package/components/breadcrumb.js
CHANGED
|
@@ -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
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
</
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
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;
|