@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,351 +1,351 @@
1
- /**
2
- * A2UI Schema Manager
3
- * Generates and validates component manifest for AI agent consumption
4
- *
5
- * This ensures AI agents only generate code using pre-approved, safe components
6
- * Prevents hallucination of raw HTML/JavaScript
7
- */
8
-
9
- import fs from 'fs';
10
- import path from 'path';
11
-
12
- export class A2UISchemaManager {
13
- constructor(componentDir = './components') {
14
- this.componentDir = componentDir;
15
- this.schema = {
16
- version: '5.0.0',
17
- timestamp: new Date().toISOString(),
18
- components: [],
19
- patterns: this.getEthnomathematicalPatterns(),
20
- forbiddenPatterns: [
21
- 'eval()',
22
- 'innerHTML = userInput',
23
- 'fetch without CORS headers',
24
- 'localStorage for sensitive data',
25
- 'document.domain manipulation',
26
- 'postMessage without origin check'
27
- ],
28
- constraintRules: [
29
- 'All dynamic content must use Web Components',
30
- 'No raw HTML generation outside of Shadow DOM',
31
- 'All user input must be validated with schemas',
32
- 'All network requests must include CORS headers',
33
- 'All fintech operations must call compliance middleware',
34
- 'All identity operations must use NIDA CIG endpoints',
35
- 'All payments must be processed through TIPS',
36
- 'All transactions must be logged for AML/FIU reporting'
37
- ]
38
- };
39
- }
40
-
41
- /**
42
- * Ethnomathematical pattern generation rules
43
- * Encodes African fractal geometry and cultural weaving algorithms
44
- */
45
- getEthnomathematicalPatterns() {
46
- return {
47
- kente: {
48
- name: 'Kente Weaving',
49
- algorithm: 'glide_reflection',
50
- parameters: {
51
- baseColor: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' },
52
- accentColor: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' },
53
- width: { type: 'number', min: 100, max: 1000 },
54
- height: { type: 'number', min: 100, max: 1000 },
55
- complexity: { type: 'number', min: 1, max: 5 }
56
- },
57
- rules: [
58
- 'Use glide reflection symmetry (translation + reflection)',
59
- 'Maintain golden ratio proportions',
60
- 'Alternate colors in checkerboard pattern',
61
- 'Apply fractal scaling for complexity levels'
62
- ],
63
- usage: 'Cultural textiles, ceremonial garments, digital art'
64
- },
65
- shuka: {
66
- name: 'Maasai Shuka Tartan',
67
- algorithm: 'strip_weaving',
68
- parameters: {
69
- primaryColor: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' },
70
- secondaryColor: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' },
71
- stripeWidth: { type: 'number', min: 5, max: 50 },
72
- pattern: { type: 'string', enum: ['horizontal', 'vertical', 'diagonal', 'plaid'] },
73
- borderWidth: { type: 'number', min: 1, max: 10 }
74
- },
75
- rules: [
76
- 'Use strip weaving technique with color alternation',
77
- 'Maintain consistent stripe proportions',
78
- 'Apply border framing for cultural authenticity',
79
- 'Use earthy color palettes (reds, blacks, whites)'
80
- ],
81
- usage: 'Traditional garments, cultural identity, modern fashion'
82
- },
83
- ndebele: {
84
- name: 'Ndebele Geometric Fractals',
85
- algorithm: 'recursive_geometry',
86
- parameters: {
87
- baseColor: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' },
88
- accentColors: { type: 'array', items: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' }, maxItems: 4 },
89
- recursionDepth: { type: 'number', min: 1, max: 4 },
90
- symmetry: { type: 'string', enum: ['rotational', 'reflection', 'translational'] },
91
- scale: { type: 'number', min: 0.1, max: 2.0 }
92
- },
93
- rules: [
94
- 'Apply recursive geometric subdivision',
95
- 'Use rotational symmetry around center points',
96
- 'Maintain fractal self-similarity at all scales',
97
- 'Incorporate traditional Ndebele color symbolism'
98
- ],
99
- usage: 'Wall art, beadwork, architectural decoration, digital design'
100
- },
101
- kitenge: {
102
- name: 'Kitenge Floral Patterns',
103
- algorithm: 'organic_growth',
104
- parameters: {
105
- backgroundColor: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' },
106
- floralColors: { type: 'array', items: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' }, minItems: 2, maxItems: 6 },
107
- density: { type: 'number', min: 0.1, max: 1.0 },
108
- scale: { type: 'number', min: 0.5, max: 2.0 },
109
- symmetry: { type: 'boolean', default: true }
110
- },
111
- rules: [
112
- 'Use organic growth algorithms for natural forms',
113
- 'Apply bilateral symmetry for traditional aesthetics',
114
- 'Vary density for different fabric weights',
115
- 'Maintain cultural color significance (greens, blues, earth tones)'
116
- ],
117
- usage: 'Textile printing, fashion design, home decor, cultural products'
118
- }
119
- };
120
- }
121
-
122
- /**
123
- * Scan components directory and extract metadata
124
- */
125
- async scanComponents() {
126
- const files = fs.readdirSync(this.componentDir).filter(f =>
127
- f.endsWith('.js') && !f.startsWith('.')
128
- );
129
-
130
- for (const file of files) {
131
- const filePath = path.join(this.componentDir, file);
132
- const content = fs.readFileSync(filePath, 'utf-8');
133
- const metadata = this.extractComponentMetadata(file, content);
134
-
135
- if (metadata) {
136
- this.schema.components.push(metadata);
137
- }
138
- }
139
-
140
- return this.schema;
141
- }
142
-
143
- /**
144
- * Extract component metadata from source code
145
- * Looks for JSDoc comments and Web Component definition
146
- */
147
- extractComponentMetadata(filename, content) {
148
- // Extract tagName
149
- const tagMatch = content.match(/(?:customElements\.define|registerComponent)\(['"]([a-z0-9-]+)['"]/);
150
- if (!tagMatch) return null;
151
-
152
- const tagName = tagMatch[1];
153
-
154
- // Extract slots
155
- const slotMatches = [...content.matchAll(/<slot[^>]*name=['"]([^'"]+)['"]/g)];
156
- const slots = slotMatches.map(m => m[1]);
157
-
158
- // Extract attributes from constructor/connectedCallback
159
- const attrMatches = [...content.matchAll(/this\.getAttribute\(['"]([^'"]+)['"]\)/g)];
160
- const attributes = {};
161
- attrMatches.forEach(m => {
162
- attributes[m[1]] = { type: 'string', required: false };
163
- });
164
-
165
- // Extract events from dispatchEvent calls
166
- const eventMatches = [...content.matchAll(/dispatchEvent\(\s*new\s+CustomEvent\(['"]([^'"]+)['"]/g)];
167
- const events = eventMatches.map(m => ({
168
- name: m[1],
169
- detail: { type: 'object' }
170
- }));
171
-
172
- // Extract CSS custom properties
173
- const cssMatches = [...content.matchAll(/var\(--([a-z0-9-]+)\)/g)];
174
- const cssCustomProperties = cssMatches.map(m => '--' + m[1]);
175
-
176
- // Extract JSDoc comments
177
- const jsdocMatch = content.match(/\/\*\*[\s\S]*?\*\//);
178
- const description = jsdocMatch ? jsdocMatch[0] : '';
179
-
180
- return {
181
- tagName,
182
- filePath: `components/${filename}`,
183
- description: description.substring(0, 200),
184
- slots,
185
- attributes,
186
- events,
187
- cssCustomProperties: [...new Set(cssCustomProperties)],
188
- example: `<${tagName}>Content</${tagName}>`,
189
- securityNotes: 'Sanitizes slot content'
190
- };
191
- }
192
-
193
- /**
194
- * Validate proposed HTML against schema
195
- * Ensures code only uses approved components
196
- */
197
- validateHTML(html) {
198
- const errors = [];
199
- const warnings = [];
200
-
201
- // Extract all custom elements used
202
- const componentMatches = [...html.matchAll(/<(af-[a-z0-9-]+)/g)];
203
- const usedComponents = new Set(componentMatches.map(m => m[1]));
204
-
205
- // Check against approved components
206
- const approvedTags = this.schema.components.map(c => c.tagName);
207
- for (const tag of usedComponents) {
208
- if (!approvedTags.includes(tag)) {
209
- errors.push(`Unknown component: <${tag}> — not in COMPONENT_SCHEMA`);
210
- }
211
- }
212
-
213
- // Check for forbidden patterns
214
- for (const pattern of this.schema.forbiddenPatterns) {
215
- if (pattern === 'eval()') {
216
- if (/eval\s*\(/i.test(html)) {
217
- errors.push('Forbidden: eval() detected');
218
- }
219
- } else if (pattern === 'innerHTML = userInput') {
220
- if (/innerHTML\s*=/i.test(html)) {
221
- warnings.push('Warning: innerHTML assignment detected — ensure content is sanitized');
222
- }
223
- }
224
- }
225
-
226
- return { valid: errors.length === 0, errors, warnings };
227
- }
228
-
229
- /**
230
- * Generate and save the complete A2UI catalog
231
- */
232
- async generateManifest(outputPath = './catalog.json') {
233
- console.log('🤖 Generating A2UI component catalog...');
234
-
235
- // Scan components
236
- await this.scanComponents();
237
-
238
- // Add pattern generation hints
239
- this.schema.usageHints = {
240
- components: {
241
- 'af-button': 'Use for primary/secondary actions, always include accessibility labels',
242
- 'af-card': 'Use for content containers, supports cultural card variants',
243
- 'af-form': 'Use for data collection, automatically validates with schemas',
244
- 'af-nida-verify': 'Use for identity verification, requires NIDA CIG compliance',
245
- 'af-payment-form': 'Use for payments, automatically handles TIPS processing',
246
- 'af-cultural-card': 'Use for cultural content, supports pattern overlays'
247
- },
248
- patterns: {
249
- 'kente': 'Use for formal/cultural contexts, high complexity for ceremonies',
250
- 'shuka': 'Use for traditional Maasai designs, earthy color palettes',
251
- 'ndebele': 'Use for geometric art, recursive depth for complexity',
252
- 'kitenge': 'Use for floral patterns, organic growth for natural feel'
253
- },
254
- constraints: [
255
- 'Always use af-* components instead of raw HTML',
256
- 'Validate all user input with schema rules',
257
- 'Include cultural context in component selection',
258
- 'Ensure fintech operations call compliance middleware',
259
- 'Use appropriate ethnomathematical patterns for cultural authenticity'
260
- ]
261
- };
262
-
263
- // Save catalog
264
- fs.writeFileSync(outputPath, JSON.stringify(this.schema, null, 2));
265
- console.log(`✅ A2UI catalog generated: ${outputPath}`);
266
-
267
- return this.schema;
268
- }
269
-
270
- /**
271
- * Validate component props against the generated schema
272
- */
273
- validateComponent(tagName, props = {}) {
274
- const component = this.schema.components.find(c => c.tagName === tagName);
275
- if (!component) {
276
- return { valid: false, error: `Component ${tagName} not found in schema` };
277
- }
278
-
279
- const errors = [];
280
-
281
- // Check required attributes
282
- for (const [attr, config] of Object.entries(component.attributes)) {
283
- if (config.required && !(attr in props)) {
284
- errors.push(`Missing required attribute: ${attr}`);
285
- }
286
-
287
- // Validate attribute value if needed
288
- if (attr in props && config.pattern) {
289
- const regex = new RegExp(config.pattern);
290
- if (!regex.test(props[attr])) {
291
- errors.push(`Attribute ${attr} does not match pattern: ${config.pattern}`);
292
- }
293
- }
294
- }
295
-
296
- return { valid: errors.length === 0, errors };
297
- }
298
-
299
- /**
300
- * Generate TypeScript type definitions for components
301
- */
302
- generateTypeDefinitions() {
303
- let defs = '// Auto-generated AfriCode Component Types\n\n';
304
-
305
- for (const component of this.schema.components) {
306
- defs += `export interface ${this.toCamelCase(component.tagName)}Props {\n`;
307
-
308
- for (const [attr, config] of Object.entries(component.attributes)) {
309
- const optional = !config.required ? '?' : '';
310
- defs += ` ${attr}${optional}: ${config.type};\n`;
311
- }
312
-
313
- defs += `}\n\n`;
314
- }
315
-
316
- return defs;
317
- }
318
-
319
- /**
320
- * Export schema to JSON file
321
- */
322
- async exportSchema(filePath = './COMPONENT_SCHEMA.json') {
323
- fs.writeFileSync(filePath, JSON.stringify(this.schema, null, 2));
324
- console.log(`✅ Component schema exported to ${filePath}`);
325
- }
326
-
327
- /**
328
- * Utility: Convert kebab-case to camelCase
329
- */
330
- toCamelCase(str) {
331
- return str.replace(/-./g, x => x[1].toUpperCase());
332
- }
333
- }
334
-
335
- export { A2UISchemaManager as A2uiSchemaManager };
336
-
337
- /**
338
- * CLI Usage
339
- * node core/a2ui-schema-manager.js generate
340
- */
341
- if (import.meta.main) {
342
- const manager = new A2UISchemaManager('./components');
343
-
344
- (async () => {
345
- await manager.scanComponents();
346
- await manager.exportSchema();
347
- console.log(`📋 Schema contains ${manager.schema.components.length} approved components`);
348
- })();
349
- }
350
-
351
- export default A2UISchemaManager;
1
+ /**
2
+ * A2UI Schema Manager
3
+ * Generates and validates component manifest for AI agent consumption
4
+ *
5
+ * This ensures AI agents only generate code using pre-approved, safe components
6
+ * Prevents hallucination of raw HTML/JavaScript
7
+ */
8
+
9
+ import fs from 'fs';
10
+ import path from 'path';
11
+
12
+ export class A2UISchemaManager {
13
+ constructor(componentDir = './components') {
14
+ this.componentDir = componentDir;
15
+ this.schema = {
16
+ version: '5.0.0',
17
+ timestamp: new Date().toISOString(),
18
+ components: [],
19
+ patterns: this.getEthnomathematicalPatterns(),
20
+ forbiddenPatterns: [
21
+ 'eval()',
22
+ 'innerHTML = userInput',
23
+ 'fetch without CORS headers',
24
+ 'localStorage for sensitive data',
25
+ 'document.domain manipulation',
26
+ 'postMessage without origin check'
27
+ ],
28
+ constraintRules: [
29
+ 'All dynamic content must use Web Components',
30
+ 'No raw HTML generation outside of Shadow DOM',
31
+ 'All user input must be validated with schemas',
32
+ 'All network requests must include CORS headers',
33
+ 'All fintech operations must call compliance middleware',
34
+ 'All identity operations must use NIDA CIG endpoints',
35
+ 'All payments must be processed through TIPS',
36
+ 'All transactions must be logged for AML/FIU reporting'
37
+ ]
38
+ };
39
+ }
40
+
41
+ /**
42
+ * Ethnomathematical pattern generation rules
43
+ * Encodes African fractal geometry and cultural weaving algorithms
44
+ */
45
+ getEthnomathematicalPatterns() {
46
+ return {
47
+ kente: {
48
+ name: 'Kente Weaving',
49
+ algorithm: 'glide_reflection',
50
+ parameters: {
51
+ baseColor: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' },
52
+ accentColor: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' },
53
+ width: { type: 'number', min: 100, max: 1000 },
54
+ height: { type: 'number', min: 100, max: 1000 },
55
+ complexity: { type: 'number', min: 1, max: 5 }
56
+ },
57
+ rules: [
58
+ 'Use glide reflection symmetry (translation + reflection)',
59
+ 'Maintain golden ratio proportions',
60
+ 'Alternate colors in checkerboard pattern',
61
+ 'Apply fractal scaling for complexity levels'
62
+ ],
63
+ usage: 'Cultural textiles, ceremonial garments, digital art'
64
+ },
65
+ shuka: {
66
+ name: 'Maasai Shuka Tartan',
67
+ algorithm: 'strip_weaving',
68
+ parameters: {
69
+ primaryColor: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' },
70
+ secondaryColor: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' },
71
+ stripeWidth: { type: 'number', min: 5, max: 50 },
72
+ pattern: { type: 'string', enum: ['horizontal', 'vertical', 'diagonal', 'plaid'] },
73
+ borderWidth: { type: 'number', min: 1, max: 10 }
74
+ },
75
+ rules: [
76
+ 'Use strip weaving technique with color alternation',
77
+ 'Maintain consistent stripe proportions',
78
+ 'Apply border framing for cultural authenticity',
79
+ 'Use earthy color palettes (reds, blacks, whites)'
80
+ ],
81
+ usage: 'Traditional garments, cultural identity, modern fashion'
82
+ },
83
+ ndebele: {
84
+ name: 'Ndebele Geometric Fractals',
85
+ algorithm: 'recursive_geometry',
86
+ parameters: {
87
+ baseColor: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' },
88
+ accentColors: { type: 'array', items: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' }, maxItems: 4 },
89
+ recursionDepth: { type: 'number', min: 1, max: 4 },
90
+ symmetry: { type: 'string', enum: ['rotational', 'reflection', 'translational'] },
91
+ scale: { type: 'number', min: 0.1, max: 2.0 }
92
+ },
93
+ rules: [
94
+ 'Apply recursive geometric subdivision',
95
+ 'Use rotational symmetry around center points',
96
+ 'Maintain fractal self-similarity at all scales',
97
+ 'Incorporate traditional Ndebele color symbolism'
98
+ ],
99
+ usage: 'Wall art, beadwork, architectural decoration, digital design'
100
+ },
101
+ kitenge: {
102
+ name: 'Kitenge Floral Patterns',
103
+ algorithm: 'organic_growth',
104
+ parameters: {
105
+ backgroundColor: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' },
106
+ floralColors: { type: 'array', items: { type: 'string', pattern: '^#[0-9a-fA-F]{6}$' }, minItems: 2, maxItems: 6 },
107
+ density: { type: 'number', min: 0.1, max: 1.0 },
108
+ scale: { type: 'number', min: 0.5, max: 2.0 },
109
+ symmetry: { type: 'boolean', default: true }
110
+ },
111
+ rules: [
112
+ 'Use organic growth algorithms for natural forms',
113
+ 'Apply bilateral symmetry for traditional aesthetics',
114
+ 'Vary density for different fabric weights',
115
+ 'Maintain cultural color significance (greens, blues, earth tones)'
116
+ ],
117
+ usage: 'Textile printing, fashion design, home decor, cultural products'
118
+ }
119
+ };
120
+ }
121
+
122
+ /**
123
+ * Scan components directory and extract metadata
124
+ */
125
+ async scanComponents() {
126
+ const files = fs.readdirSync(this.componentDir).filter(f =>
127
+ f.endsWith('.js') && !f.startsWith('.')
128
+ );
129
+
130
+ for (const file of files) {
131
+ const filePath = path.join(this.componentDir, file);
132
+ const content = fs.readFileSync(filePath, 'utf-8');
133
+ const metadata = this.extractComponentMetadata(file, content);
134
+
135
+ if (metadata) {
136
+ this.schema.components.push(metadata);
137
+ }
138
+ }
139
+
140
+ return this.schema;
141
+ }
142
+
143
+ /**
144
+ * Extract component metadata from source code
145
+ * Looks for JSDoc comments and Web Component definition
146
+ */
147
+ extractComponentMetadata(filename, content) {
148
+ // Extract tagName
149
+ const tagMatch = content.match(/(?:customElements\.define|registerComponent)\(['"]([a-z0-9-]+)['"]/);
150
+ if (!tagMatch) {return null;}
151
+
152
+ const tagName = tagMatch[1];
153
+
154
+ // Extract slots
155
+ const slotMatches = [...content.matchAll(/<slot[^>]*name=['"]([^'"]+)['"]/g)];
156
+ const slots = slotMatches.map(m => m[1]);
157
+
158
+ // Extract attributes from constructor/connectedCallback
159
+ const attrMatches = [...content.matchAll(/this\.getAttribute\(['"]([^'"]+)['"]\)/g)];
160
+ const attributes = {};
161
+ attrMatches.forEach(m => {
162
+ attributes[m[1]] = { type: 'string', required: false };
163
+ });
164
+
165
+ // Extract events from dispatchEvent calls
166
+ const eventMatches = [...content.matchAll(/dispatchEvent\(\s*new\s+CustomEvent\(['"]([^'"]+)['"]/g)];
167
+ const events = eventMatches.map(m => ({
168
+ name: m[1],
169
+ detail: { type: 'object' }
170
+ }));
171
+
172
+ // Extract CSS custom properties
173
+ const cssMatches = [...content.matchAll(/var\(--([a-z0-9-]+)\)/g)];
174
+ const cssCustomProperties = cssMatches.map(m => '--' + m[1]);
175
+
176
+ // Extract JSDoc comments
177
+ const jsdocMatch = content.match(/\/\*\*[\s\S]*?\*\//);
178
+ const description = jsdocMatch ? jsdocMatch[0] : '';
179
+
180
+ return {
181
+ tagName,
182
+ filePath: `components/${filename}`,
183
+ description: description.substring(0, 200),
184
+ slots,
185
+ attributes,
186
+ events,
187
+ cssCustomProperties: [...new Set(cssCustomProperties)],
188
+ example: `<${tagName}>Content</${tagName}>`,
189
+ securityNotes: 'Sanitizes slot content'
190
+ };
191
+ }
192
+
193
+ /**
194
+ * Validate proposed HTML against schema
195
+ * Ensures code only uses approved components
196
+ */
197
+ validateHTML(html) {
198
+ const errors = [];
199
+ const warnings = [];
200
+
201
+ // Extract all custom elements used
202
+ const componentMatches = [...html.matchAll(/<(af-[a-z0-9-]+)/g)];
203
+ const usedComponents = new Set(componentMatches.map(m => m[1]));
204
+
205
+ // Check against approved components
206
+ const approvedTags = this.schema.components.map(c => c.tagName);
207
+ for (const tag of usedComponents) {
208
+ if (!approvedTags.includes(tag)) {
209
+ errors.push(`Unknown component: <${tag}> — not in COMPONENT_SCHEMA`);
210
+ }
211
+ }
212
+
213
+ // Check for forbidden patterns
214
+ for (const pattern of this.schema.forbiddenPatterns) {
215
+ if (pattern === 'eval()') {
216
+ if (/eval\s*\(/i.test(html)) {
217
+ errors.push('Forbidden: eval() detected');
218
+ }
219
+ } else if (pattern === 'innerHTML = userInput') {
220
+ if (/innerHTML\s*=/i.test(html)) {
221
+ warnings.push('Warning: innerHTML assignment detected — ensure content is sanitized');
222
+ }
223
+ }
224
+ }
225
+
226
+ return { valid: errors.length === 0, errors, warnings };
227
+ }
228
+
229
+ /**
230
+ * Generate and save the complete A2UI catalog
231
+ */
232
+ async generateManifest(outputPath = './catalog.json') {
233
+ console.log('🤖 Generating A2UI component catalog...');
234
+
235
+ // Scan components
236
+ await this.scanComponents();
237
+
238
+ // Add pattern generation hints
239
+ this.schema.usageHints = {
240
+ components: {
241
+ 'af-button': 'Use for primary/secondary actions, always include accessibility labels',
242
+ 'af-card': 'Use for content containers, supports cultural card variants',
243
+ 'af-form': 'Use for data collection, automatically validates with schemas',
244
+ 'af-nida-verify': 'Use for identity verification, requires NIDA CIG compliance',
245
+ 'af-payment-form': 'Use for payments, automatically handles TIPS processing',
246
+ 'af-cultural-card': 'Use for cultural content, supports pattern overlays'
247
+ },
248
+ patterns: {
249
+ 'kente': 'Use for formal/cultural contexts, high complexity for ceremonies',
250
+ 'shuka': 'Use for traditional Maasai designs, earthy color palettes',
251
+ 'ndebele': 'Use for geometric art, recursive depth for complexity',
252
+ 'kitenge': 'Use for floral patterns, organic growth for natural feel'
253
+ },
254
+ constraints: [
255
+ 'Always use af-* components instead of raw HTML',
256
+ 'Validate all user input with schema rules',
257
+ 'Include cultural context in component selection',
258
+ 'Ensure fintech operations call compliance middleware',
259
+ 'Use appropriate ethnomathematical patterns for cultural authenticity'
260
+ ]
261
+ };
262
+
263
+ // Save catalog
264
+ fs.writeFileSync(outputPath, JSON.stringify(this.schema, null, 2));
265
+ console.log(`✅ A2UI catalog generated: ${outputPath}`);
266
+
267
+ return this.schema;
268
+ }
269
+
270
+ /**
271
+ * Validate component props against the generated schema
272
+ */
273
+ validateComponent(tagName, props = {}) {
274
+ const component = this.schema.components.find(c => c.tagName === tagName);
275
+ if (!component) {
276
+ return { valid: false, error: `Component ${tagName} not found in schema` };
277
+ }
278
+
279
+ const errors = [];
280
+
281
+ // Check required attributes
282
+ for (const [attr, config] of Object.entries(component.attributes)) {
283
+ if (config.required && !(attr in props)) {
284
+ errors.push(`Missing required attribute: ${attr}`);
285
+ }
286
+
287
+ // Validate attribute value if needed
288
+ if (attr in props && config.pattern) {
289
+ const regex = new RegExp(config.pattern);
290
+ if (!regex.test(props[attr])) {
291
+ errors.push(`Attribute ${attr} does not match pattern: ${config.pattern}`);
292
+ }
293
+ }
294
+ }
295
+
296
+ return { valid: errors.length === 0, errors };
297
+ }
298
+
299
+ /**
300
+ * Generate TypeScript type definitions for components
301
+ */
302
+ generateTypeDefinitions() {
303
+ let defs = '// Auto-generated AfriCode Component Types\n\n';
304
+
305
+ for (const component of this.schema.components) {
306
+ defs += `export interface ${this.toCamelCase(component.tagName)}Props {\n`;
307
+
308
+ for (const [attr, config] of Object.entries(component.attributes)) {
309
+ const optional = !config.required ? '?' : '';
310
+ defs += ` ${attr}${optional}: ${config.type};\n`;
311
+ }
312
+
313
+ defs += `}\n\n`;
314
+ }
315
+
316
+ return defs;
317
+ }
318
+
319
+ /**
320
+ * Export schema to JSON file
321
+ */
322
+ async exportSchema(filePath = './COMPONENT_SCHEMA.json') {
323
+ fs.writeFileSync(filePath, JSON.stringify(this.schema, null, 2));
324
+ console.log(`✅ Component schema exported to ${filePath}`);
325
+ }
326
+
327
+ /**
328
+ * Utility: Convert kebab-case to camelCase
329
+ */
330
+ toCamelCase(str) {
331
+ return str.replace(/-./g, x => x[1].toUpperCase());
332
+ }
333
+ }
334
+
335
+ export { A2UISchemaManager as A2uiSchemaManager };
336
+
337
+ /**
338
+ * CLI Usage
339
+ * node core/a2ui-schema-manager.js generate
340
+ */
341
+ if (import.meta.main) {
342
+ const manager = new A2UISchemaManager('./components');
343
+
344
+ (async () => {
345
+ await manager.scanComponents();
346
+ await manager.exportSchema();
347
+ console.log(`📋 Schema contains ${manager.schema.components.length} approved components`);
348
+ })();
349
+ }
350
+
351
+ export default A2UISchemaManager;