@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
package/core/logging.js CHANGED
@@ -1,14 +1,14 @@
1
- const isTestEnvironment = () => Boolean(globalThis.__AFRICODE_TEST__ || globalThis.__AFRICODE_SILENT_LOGS__);
2
-
3
- export function frameworkLog(level, ...args) {
4
- if (isTestEnvironment()) {
5
- return;
6
- }
7
-
8
- const logger = console[level] || console.log;
9
- logger.call(console, ...args);
10
- }
11
-
12
- export function isFrameworkLoggingMuted() {
13
- return isTestEnvironment();
14
- }
1
+ const isTestEnvironment = () => Boolean(globalThis.__AFRICODE_TEST__ || globalThis.__AFRICODE_SILENT_LOGS__);
2
+
3
+ export function frameworkLog(level, ...args) {
4
+ if (isTestEnvironment()) {
5
+ return;
6
+ }
7
+
8
+ const logger = console[level] || console.log;
9
+ logger.call(console, ...args);
10
+ }
11
+
12
+ export function isFrameworkLoggingMuted() {
13
+ return isTestEnvironment();
14
+ }
@@ -1,145 +1,145 @@
1
- /**
2
- * AfriCode Middleware System
3
- * Core request interception pipeline
4
- *
5
- * @module core/middleware
6
- */
7
-
8
- import { frameworkLog } from './logging.js';
9
- import { AfriCodeError } from './errors.js';
10
-
11
- export class MiddlewareManager {
12
- constructor() {
13
- this.middlewares = [];
14
- this.isRunning = false;
15
- }
16
-
17
- /**
18
- * Add middleware to the pipeline
19
- * @param {Function} fn - Middleware function
20
- * @param {string} [name] - Optional name for debugging
21
- * @returns {MiddlewareManager}
22
- */
23
- use(fn, name = null) {
24
- if (typeof fn !== 'function') {
25
- throw new AfriCodeError('Middleware must be a function', 'MIDDLEWARE_INVALID', {}, 500);
26
- }
27
-
28
- // Wrap with name and error handling
29
- const wrappedFn = async (context) => {
30
- const startTime = Date.now();
31
- try {
32
- frameworkLog('debug', `[Middleware] Running ${name || 'anonymous'} middleware`);
33
- const result = await fn(context);
34
-
35
- const duration = Date.now() - startTime;
36
- frameworkLog('debug', `[Middleware] ${name || 'anonymous'} completed in ${duration}ms`);
37
-
38
- return result;
39
- } catch (error) {
40
- frameworkLog('error', `[Middleware] Error in ${name || 'anonymous'}: ${error.message}`);
41
- throw new AfriCodeError(`Middleware error in ${name || 'anonymous'}: ${error.message}`, 'MIDDLEWARE_EXECUTION_ERROR', { cause: error }, 500);
42
- }
43
- };
44
-
45
- // Store metadata in a WeakMap to avoid modifying the function object
46
- this.middlewareMeta = this.middlewareMeta || new WeakMap();
47
- this.middlewareMeta.set(wrappedFn, {
48
- original: fn,
49
- name: name || fn.name || 'anonymous'
50
- });
51
-
52
- this.middlewares.push(wrappedFn);
53
- return this;
54
- }
55
-
56
- /**
57
- * Run middleware pipeline
58
- * @param {Object} context - Request context
59
- * @returns {Promise<Response|null>}
60
- */
61
- async run(context) {
62
- if (this.isRunning) {
63
- throw new MiddlewareError('Middleware pipeline is already running');
64
- }
65
-
66
- this.isRunning = true;
67
-
68
- try {
69
- for (const mw of this.middlewares) {
70
- const result = await mw(context);
71
-
72
- if (result instanceof Response) {
73
- return result;
74
- }
75
-
76
- // middleware can short-circuit request
77
- if (result?.response) {
78
- return result.response;
79
- }
80
-
81
- // allow mutation of context
82
- if (result?.context) {
83
- Object.assign(context, result.context);
84
- }
85
- }
86
-
87
- return null;
88
- } finally {
89
- this.isRunning = false;
90
- }
91
- }
92
-
93
- /**
94
- * Get middleware count
95
- * @returns {number}
96
- */
97
- count() {
98
- return this.middlewares.length;
99
- }
100
-
101
- /**
102
- * Clear all middlewares
103
- */
104
- clear() {
105
- this.middlewares = [];
106
- return this;
107
- }
108
- }
109
-
110
- /**
111
- * Logging middleware - logs all requests
112
- */
113
- export function loggerMiddleware() {
114
- return async (ctx) => {
115
- frameworkLog('log', `[AfriCode] ${ctx.req.method} ${ctx.pathname}`);
116
- return {};
117
- };
118
- }
119
-
120
- /**
121
- * Opt-in auth guard middleware for protected routes.
122
- */
123
- export function authMiddleware(options = {}) {
124
- return async (ctx) => {
125
- const {
126
- protectedPaths = [],
127
- authorize = () => false,
128
- unauthorizedResponse = () => new Response('Unauthorized', { status: 401 })
129
- } = options;
130
-
131
- const isProtected = protectedPaths.some((path) => ctx.pathname.startsWith(path));
132
-
133
- if (isProtected) {
134
- const isAllowed = await authorize(ctx);
135
-
136
- if (!isAllowed) {
137
- return {
138
- response: unauthorizedResponse(ctx)
139
- };
140
- }
141
- }
142
-
143
- return {};
144
- };
145
- }
1
+ /**
2
+ * AfriCode Middleware System
3
+ * Core request interception pipeline
4
+ *
5
+ * @module core/middleware
6
+ */
7
+
8
+ import { frameworkLog } from './logging.js';
9
+ import { AfriCodeError } from './errors.js';
10
+
11
+ export class MiddlewareManager {
12
+ constructor() {
13
+ this.middlewares = [];
14
+ this.isRunning = false;
15
+ }
16
+
17
+ /**
18
+ * Add middleware to the pipeline
19
+ * @param {Function} fn - Middleware function
20
+ * @param {string} [name] - Optional name for debugging
21
+ * @returns {MiddlewareManager}
22
+ */
23
+ use(fn, name = null) {
24
+ if (typeof fn !== 'function') {
25
+ throw new AfriCodeError('Middleware must be a function', 'MIDDLEWARE_INVALID', {}, 500);
26
+ }
27
+
28
+ // Wrap with name and error handling
29
+ const wrappedFn = async (context) => {
30
+ const startTime = Date.now();
31
+ try {
32
+ frameworkLog('debug', `[Middleware] Running ${name || 'anonymous'} middleware`);
33
+ const result = await fn(context);
34
+
35
+ const duration = Date.now() - startTime;
36
+ frameworkLog('debug', `[Middleware] ${name || 'anonymous'} completed in ${duration}ms`);
37
+
38
+ return result;
39
+ } catch (error) {
40
+ frameworkLog('error', `[Middleware] Error in ${name || 'anonymous'}: ${error.message}`);
41
+ throw new AfriCodeError(`Middleware error in ${name || 'anonymous'}: ${error.message}`, 'MIDDLEWARE_EXECUTION_ERROR', { cause: error }, 500);
42
+ }
43
+ };
44
+
45
+ // Store metadata in a WeakMap to avoid modifying the function object
46
+ this.middlewareMeta = this.middlewareMeta || new WeakMap();
47
+ this.middlewareMeta.set(wrappedFn, {
48
+ original: fn,
49
+ name: name || fn.name || 'anonymous'
50
+ });
51
+
52
+ this.middlewares.push(wrappedFn);
53
+ return this;
54
+ }
55
+
56
+ /**
57
+ * Run middleware pipeline
58
+ * @param {Object} context - Request context
59
+ * @returns {Promise<Response|null>}
60
+ */
61
+ async run(context) {
62
+ if (this.isRunning) {
63
+ throw new AfriCodeError('Middleware pipeline is already running', 'MIDDLEWARE_ALREADY_RUNNING', {}, 500);
64
+ }
65
+
66
+ this.isRunning = true;
67
+
68
+ try {
69
+ for (const mw of this.middlewares) {
70
+ const result = await mw(context);
71
+
72
+ if (result instanceof Response) {
73
+ return result;
74
+ }
75
+
76
+ // middleware can short-circuit request
77
+ if (result?.response) {
78
+ return result.response;
79
+ }
80
+
81
+ // allow mutation of context
82
+ if (result?.context) {
83
+ Object.assign(context, result.context);
84
+ }
85
+ }
86
+
87
+ return null;
88
+ } finally {
89
+ this.isRunning = false;
90
+ }
91
+ }
92
+
93
+ /**
94
+ * Get middleware count
95
+ * @returns {number}
96
+ */
97
+ count() {
98
+ return this.middlewares.length;
99
+ }
100
+
101
+ /**
102
+ * Clear all middlewares
103
+ */
104
+ clear() {
105
+ this.middlewares = [];
106
+ return this;
107
+ }
108
+ }
109
+
110
+ /**
111
+ * Logging middleware - logs all requests
112
+ */
113
+ export function loggerMiddleware() {
114
+ return async (ctx) => {
115
+ frameworkLog('log', `[AfriCode] ${ctx.req.method} ${ctx.pathname}`);
116
+ return {};
117
+ };
118
+ }
119
+
120
+ /**
121
+ * Opt-in auth guard middleware for protected routes.
122
+ */
123
+ export function authMiddleware(options = {}) {
124
+ return async (ctx) => {
125
+ const {
126
+ protectedPaths = [],
127
+ authorize = () => false,
128
+ unauthorizedResponse = () => new Response('Unauthorized', { status: 401 })
129
+ } = options;
130
+
131
+ const isProtected = protectedPaths.some((path) => ctx.pathname.startsWith(path));
132
+
133
+ if (isProtected) {
134
+ const isAllowed = await authorize(ctx);
135
+
136
+ if (!isAllowed) {
137
+ return {
138
+ response: unauthorizedResponse(ctx)
139
+ };
140
+ }
141
+ }
142
+
143
+ return {};
144
+ };
145
+ }
package/core/motion.js CHANGED
@@ -1,106 +1,106 @@
1
- /**
2
- * AfriCode Rhythmic Motion Engine
3
- *
4
- * Implements polyrhythmic easing and staggered animations
5
- * inspired by traditional African drumming and musical structures.
6
- *
7
- * Core concepts:
8
- * - "Call and Response": Interlocking animations
9
- * - "Strain and Release": Custom drum-beat easing
10
- *
11
- * @module core/motion
12
- */
13
-
14
- // Custom cubic-bezier mimicking the tension and release of a drum beat
15
- // Rapid attack, slight hold (tension), and natural release
16
- export const Easing = {
17
- DrumBeat: 'cubic-bezier(0.1, 0.9, 0.2, 1.0)', // Percussive snap
18
- KoraPluck: 'cubic-bezier(0.34, 1.56, 0.64, 1)', // Elastic bounce
19
- RiverFlow: 'cubic-bezier(0.4, 0.0, 0.2, 1)', // Smooth continuous
20
- };
21
-
22
- /**
23
- * Animate elements with a "Call and Response" staggered effect
24
- *
25
- * @param {string|NodeList|Array} selector - Elements to animate
26
- * @param {Object} options - Animation configuration
27
- */
28
- export function animateStaggered(selector, {
29
- delay = 50, // ms between items (polyrhythmic tick)
30
- duration = 600,
31
- easing = Easing.DrumBeat,
32
- y = 20, // Slide up distance
33
- scale = 0.95
34
- } = {}) {
35
- const elements = typeof selector === 'string'
36
- ? document.querySelectorAll(selector)
37
- : selector;
38
-
39
- if (!elements || elements.length === 0) {return;}
40
-
41
- const observer = new IntersectionObserver((entries) => {
42
- entries.forEach((entry, index) => {
43
- if (entry.isIntersecting) {
44
- // Calculate staggered delay based on 12/8 time signature feel
45
- // We use a slight fluctuation to mimic human timing imperfections (groove)
46
- const groove = Math.random() * 10;
47
- const stagger = (index * delay) + groove;
48
-
49
- const el = entry.target;
50
-
51
- // Use Web Animations API for performance
52
- el.animate(
53
- [
54
- { opacity: 0, transform: `translateY(${y}px) scale(${scale})` },
55
- { opacity: 1, transform: 'translateY(0) scale(1)' }
56
- ],
57
- {
58
- duration: duration,
59
- delay: stagger,
60
- easing: easing,
61
- fill: 'forwards'
62
- }
63
- );
64
-
65
- // Stop observing once animated
66
- observer.unobserve(el);
67
- el.style.opacity = '1'; // Ensure final state
68
- }
69
- });
70
- }, { threshold: 0.1 });
71
-
72
- elements.forEach(el => {
73
- el.style.opacity = '0'; // Initial state
74
- observer.observe(el);
75
- });
76
- }
77
-
78
- /**
79
- * Apply "Vibe" transition to page navigation
80
- * Mimics a rhythmic "wipe" or "beat" transition
81
- */
82
- export function transitionPage(nextPageFn) {
83
- // Simple example of a beat-match transition
84
- document.body.animate(
85
- [
86
- { opacity: 1, transform: 'scale(1)' },
87
- { opacity: 0, transform: 'scale(0.98)' } // "Strain" (Inhale)
88
- ],
89
- { duration: 200, easing: 'ease-in' }
90
- ).onfinish = () => {
91
- nextPageFn(); // Change content
92
- document.body.animate(
93
- [
94
- { opacity: 0, transform: 'scale(1.02)' },
95
- { opacity: 1, transform: 'scale(1)' } // "Release" (Exhale)
96
- ],
97
- { duration: 400, easing: Easing.DrumBeat }
98
- );
99
- };
100
- }
101
-
102
- export default {
103
- Easing,
104
- animateStaggered,
105
- transitionPage
106
- };
1
+ /**
2
+ * AfriCode Rhythmic Motion Engine
3
+ *
4
+ * Implements polyrhythmic easing and staggered animations
5
+ * inspired by traditional African drumming and musical structures.
6
+ *
7
+ * Core concepts:
8
+ * - "Call and Response": Interlocking animations
9
+ * - "Strain and Release": Custom drum-beat easing
10
+ *
11
+ * @module core/motion
12
+ */
13
+
14
+ // Custom cubic-bezier mimicking the tension and release of a drum beat
15
+ // Rapid attack, slight hold (tension), and natural release
16
+ export const Easing = {
17
+ DrumBeat: 'cubic-bezier(0.1, 0.9, 0.2, 1.0)', // Percussive snap
18
+ KoraPluck: 'cubic-bezier(0.34, 1.56, 0.64, 1)', // Elastic bounce
19
+ RiverFlow: 'cubic-bezier(0.4, 0.0, 0.2, 1)', // Smooth continuous
20
+ };
21
+
22
+ /**
23
+ * Animate elements with a "Call and Response" staggered effect
24
+ *
25
+ * @param {string|NodeList|Array} selector - Elements to animate
26
+ * @param {Object} options - Animation configuration
27
+ */
28
+ export function animateStaggered(selector, {
29
+ delay = 50, // ms between items (polyrhythmic tick)
30
+ duration = 600,
31
+ easing = Easing.DrumBeat,
32
+ y = 20, // Slide up distance
33
+ scale = 0.95
34
+ } = {}) {
35
+ const elements = typeof selector === 'string'
36
+ ? document.querySelectorAll(selector)
37
+ : selector;
38
+
39
+ if (!elements || elements.length === 0) {return;}
40
+
41
+ const observer = new IntersectionObserver((entries) => {
42
+ entries.forEach((entry, index) => {
43
+ if (entry.isIntersecting) {
44
+ // Calculate staggered delay based on 12/8 time signature feel
45
+ // We use a slight fluctuation to mimic human timing imperfections (groove)
46
+ const groove = Math.random() * 10;
47
+ const stagger = (index * delay) + groove;
48
+
49
+ const el = entry.target;
50
+
51
+ // Use Web Animations API for performance
52
+ el.animate(
53
+ [
54
+ { opacity: 0, transform: `translateY(${y}px) scale(${scale})` },
55
+ { opacity: 1, transform: 'translateY(0) scale(1)' }
56
+ ],
57
+ {
58
+ duration: duration,
59
+ delay: stagger,
60
+ easing: easing,
61
+ fill: 'forwards'
62
+ }
63
+ );
64
+
65
+ // Stop observing once animated
66
+ observer.unobserve(el);
67
+ el.style.opacity = '1'; // Ensure final state
68
+ }
69
+ });
70
+ }, { threshold: 0.1 });
71
+
72
+ elements.forEach(el => {
73
+ el.style.opacity = '0'; // Initial state
74
+ observer.observe(el);
75
+ });
76
+ }
77
+
78
+ /**
79
+ * Apply "Vibe" transition to page navigation
80
+ * Mimics a rhythmic "wipe" or "beat" transition
81
+ */
82
+ export function transitionPage(nextPageFn) {
83
+ // Simple example of a beat-match transition
84
+ document.body.animate(
85
+ [
86
+ { opacity: 1, transform: 'scale(1)' },
87
+ { opacity: 0, transform: 'scale(0.98)' } // "Strain" (Inhale)
88
+ ],
89
+ { duration: 200, easing: 'ease-in' }
90
+ ).onfinish = () => {
91
+ nextPageFn(); // Change content
92
+ document.body.animate(
93
+ [
94
+ { opacity: 0, transform: 'scale(1.02)' },
95
+ { opacity: 1, transform: 'scale(1)' } // "Release" (Exhale)
96
+ ],
97
+ { duration: 400, easing: Easing.DrumBeat }
98
+ );
99
+ };
100
+ }
101
+
102
+ export default {
103
+ Easing,
104
+ animateStaggered,
105
+ transitionPage
106
+ };