@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/core/sdk-browser.js
CHANGED
|
@@ -1,140 +1,140 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* AfriCode Browser SDK
|
|
3
|
-
* Client-side only entry point. Does not include server-only APIs.
|
|
4
|
-
*
|
|
5
|
-
* Use this for Bun.build({ target: 'browser' })
|
|
6
|
-
* Use the full sdk.js for server/SSR contexts
|
|
7
|
-
*
|
|
8
|
-
* Philosophy: Browser-safe, tree-shakeable, zero server APIs
|
|
9
|
-
*/
|
|
10
|
-
|
|
11
|
-
import { createReactiveState, subscribe, createSignal, createEffect } from './state.js';
|
|
12
|
-
import { store, actions } from './store.js';
|
|
13
|
-
import patterns from './patterns.js';
|
|
14
|
-
import * as motion from './motion.js';
|
|
15
|
-
import { hydrate } from './hydration.js';
|
|
16
|
-
import { html, Layout } from './html.js';
|
|
17
|
-
import { schemas, Validation, rules, afri, AfriFieldBuilder, normalizeInput, buildSchema } from './validation.js';
|
|
18
|
-
import { createFramework, getConfig } from './config.js';
|
|
19
|
-
import { getRequestIdentity, parseCookieHeader, createSessionId, SESSION_COOKIE_NAME } from './request-identity.js';
|
|
20
|
-
import { sessionStore } from './session-store.js';
|
|
21
|
-
import { actions as runtimeActions } from './actions.js';
|
|
22
|
-
import { MiddlewareManager, loggerMiddleware, authMiddleware } from './middleware.js';
|
|
23
|
-
import {
|
|
24
|
-
AfriCodeError, ValidationError, InvalidUrlError,
|
|
25
|
-
SecurityError, CsrfError, RateLimitError,
|
|
26
|
-
DatabaseError, ComponentError
|
|
27
|
-
} from './errors.js';
|
|
28
|
-
|
|
29
|
-
// v5.0.0 Browser-safe exports (A2UI protocol)
|
|
30
|
-
import { initA2UI, A2UIRenderer, A2UIProtocol } from './a2ui.js';
|
|
31
|
-
|
|
32
|
-
import { componentMap as coreMap } from '../components/index.js';
|
|
33
|
-
|
|
34
|
-
// Utility to initialize the browser framework
|
|
35
|
-
export function init(projectComponentMap = {}) {
|
|
36
|
-
if (typeof window !== 'undefined') {
|
|
37
|
-
console.log('🌍 AfriCode Browser SDK Initialized');
|
|
38
|
-
|
|
39
|
-
// Merge project map with core map
|
|
40
|
-
const finalMap = { ...coreMap, ...projectComponentMap };
|
|
41
|
-
|
|
42
|
-
if (Object.keys(finalMap).length > 0) {
|
|
43
|
-
hydrate(finalMap);
|
|
44
|
-
}
|
|
45
|
-
}
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
// Browser-safe grouped exports
|
|
49
|
-
export {
|
|
50
|
-
createReactiveState,
|
|
51
|
-
subscribe,
|
|
52
|
-
createSignal,
|
|
53
|
-
createEffect
|
|
54
|
-
} from './state.js';
|
|
55
|
-
|
|
56
|
-
export {
|
|
57
|
-
store,
|
|
58
|
-
actions,
|
|
59
|
-
patterns,
|
|
60
|
-
motion,
|
|
61
|
-
html,
|
|
62
|
-
Layout,
|
|
63
|
-
schemas,
|
|
64
|
-
Validation,
|
|
65
|
-
rules,
|
|
66
|
-
afri,
|
|
67
|
-
AfriFieldBuilder,
|
|
68
|
-
normalizeInput,
|
|
69
|
-
buildSchema,
|
|
70
|
-
createFramework,
|
|
71
|
-
getConfig,
|
|
72
|
-
getRequestIdentity,
|
|
73
|
-
parseCookieHeader,
|
|
74
|
-
createSessionId,
|
|
75
|
-
SESSION_COOKIE_NAME,
|
|
76
|
-
sessionStore,
|
|
77
|
-
runtimeActions,
|
|
78
|
-
MiddlewareManager,
|
|
79
|
-
loggerMiddleware,
|
|
80
|
-
authMiddleware,
|
|
81
|
-
AfriCodeError,
|
|
82
|
-
ValidationError,
|
|
83
|
-
InvalidUrlError,
|
|
84
|
-
SecurityError,
|
|
85
|
-
CsrfError,
|
|
86
|
-
RateLimitError,
|
|
87
|
-
DatabaseError,
|
|
88
|
-
ComponentError
|
|
89
|
-
};
|
|
90
|
-
|
|
91
|
-
// Browser-only exports (A2UI for AI-safe rendering)
|
|
92
|
-
export {
|
|
93
|
-
initA2UI,
|
|
94
|
-
A2UIRenderer,
|
|
95
|
-
A2UIProtocol
|
|
96
|
-
};
|
|
97
|
-
|
|
98
|
-
// Default Export (Browser-safe)
|
|
99
|
-
export default {
|
|
100
|
-
createReactiveState,
|
|
101
|
-
subscribe,
|
|
102
|
-
createSignal,
|
|
103
|
-
createEffect,
|
|
104
|
-
store,
|
|
105
|
-
actions,
|
|
106
|
-
patterns,
|
|
107
|
-
motion,
|
|
108
|
-
html,
|
|
109
|
-
Layout,
|
|
110
|
-
schemas,
|
|
111
|
-
Validation,
|
|
112
|
-
rules,
|
|
113
|
-
afri,
|
|
114
|
-
AfriFieldBuilder,
|
|
115
|
-
normalizeInput,
|
|
116
|
-
buildSchema,
|
|
117
|
-
createFramework,
|
|
118
|
-
getConfig,
|
|
119
|
-
getRequestIdentity,
|
|
120
|
-
parseCookieHeader,
|
|
121
|
-
createSessionId,
|
|
122
|
-
SESSION_COOKIE_NAME,
|
|
123
|
-
sessionStore,
|
|
124
|
-
runtimeActions,
|
|
125
|
-
MiddlewareManager,
|
|
126
|
-
loggerMiddleware,
|
|
127
|
-
authMiddleware,
|
|
128
|
-
AfriCodeError,
|
|
129
|
-
ValidationError,
|
|
130
|
-
InvalidUrlError,
|
|
131
|
-
SecurityError,
|
|
132
|
-
CsrfError,
|
|
133
|
-
RateLimitError,
|
|
134
|
-
DatabaseError,
|
|
135
|
-
ComponentError,
|
|
136
|
-
initA2UI,
|
|
137
|
-
A2UIRenderer,
|
|
138
|
-
A2UIProtocol,
|
|
139
|
-
init
|
|
140
|
-
};
|
|
1
|
+
/**
|
|
2
|
+
* AfriCode Browser SDK
|
|
3
|
+
* Client-side only entry point. Does not include server-only APIs.
|
|
4
|
+
*
|
|
5
|
+
* Use this for Bun.build({ target: 'browser' })
|
|
6
|
+
* Use the full sdk.js for server/SSR contexts
|
|
7
|
+
*
|
|
8
|
+
* Philosophy: Browser-safe, tree-shakeable, zero server APIs
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
import { createReactiveState, subscribe, createSignal, createEffect } from './state.js';
|
|
12
|
+
import { store, actions } from './store.js';
|
|
13
|
+
import patterns from './patterns.js';
|
|
14
|
+
import * as motion from './motion.js';
|
|
15
|
+
import { hydrate } from './hydration.js';
|
|
16
|
+
import { html, Layout } from './html.js';
|
|
17
|
+
import { schemas, Validation, rules, afri, AfriFieldBuilder, normalizeInput, buildSchema } from './validation.js';
|
|
18
|
+
import { createFramework, getConfig } from './config.js';
|
|
19
|
+
import { getRequestIdentity, parseCookieHeader, createSessionId, SESSION_COOKIE_NAME } from './request-identity.js';
|
|
20
|
+
import { sessionStore } from './session-store.js';
|
|
21
|
+
import { actions as runtimeActions } from './actions.js';
|
|
22
|
+
import { MiddlewareManager, loggerMiddleware, authMiddleware } from './middleware.js';
|
|
23
|
+
import {
|
|
24
|
+
AfriCodeError, ValidationError, InvalidUrlError,
|
|
25
|
+
SecurityError, CsrfError, RateLimitError,
|
|
26
|
+
DatabaseError, ComponentError
|
|
27
|
+
} from './errors.js';
|
|
28
|
+
|
|
29
|
+
// v5.0.0 Browser-safe exports (A2UI protocol)
|
|
30
|
+
import { initA2UI, A2UIRenderer, A2UIProtocol } from './a2ui.js';
|
|
31
|
+
|
|
32
|
+
import { componentMap as coreMap } from '../components/index.js';
|
|
33
|
+
|
|
34
|
+
// Utility to initialize the browser framework
|
|
35
|
+
export function init(projectComponentMap = {}) {
|
|
36
|
+
if (typeof window !== 'undefined') {
|
|
37
|
+
console.log('🌍 AfriCode Browser SDK Initialized');
|
|
38
|
+
|
|
39
|
+
// Merge project map with core map
|
|
40
|
+
const finalMap = { ...coreMap, ...projectComponentMap };
|
|
41
|
+
|
|
42
|
+
if (Object.keys(finalMap).length > 0) {
|
|
43
|
+
hydrate(finalMap);
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
// Browser-safe grouped exports
|
|
49
|
+
export {
|
|
50
|
+
createReactiveState,
|
|
51
|
+
subscribe,
|
|
52
|
+
createSignal,
|
|
53
|
+
createEffect
|
|
54
|
+
} from './state.js';
|
|
55
|
+
|
|
56
|
+
export {
|
|
57
|
+
store,
|
|
58
|
+
actions,
|
|
59
|
+
patterns,
|
|
60
|
+
motion,
|
|
61
|
+
html,
|
|
62
|
+
Layout,
|
|
63
|
+
schemas,
|
|
64
|
+
Validation,
|
|
65
|
+
rules,
|
|
66
|
+
afri,
|
|
67
|
+
AfriFieldBuilder,
|
|
68
|
+
normalizeInput,
|
|
69
|
+
buildSchema,
|
|
70
|
+
createFramework,
|
|
71
|
+
getConfig,
|
|
72
|
+
getRequestIdentity,
|
|
73
|
+
parseCookieHeader,
|
|
74
|
+
createSessionId,
|
|
75
|
+
SESSION_COOKIE_NAME,
|
|
76
|
+
sessionStore,
|
|
77
|
+
runtimeActions,
|
|
78
|
+
MiddlewareManager,
|
|
79
|
+
loggerMiddleware,
|
|
80
|
+
authMiddleware,
|
|
81
|
+
AfriCodeError,
|
|
82
|
+
ValidationError,
|
|
83
|
+
InvalidUrlError,
|
|
84
|
+
SecurityError,
|
|
85
|
+
CsrfError,
|
|
86
|
+
RateLimitError,
|
|
87
|
+
DatabaseError,
|
|
88
|
+
ComponentError
|
|
89
|
+
};
|
|
90
|
+
|
|
91
|
+
// Browser-only exports (A2UI for AI-safe rendering)
|
|
92
|
+
export {
|
|
93
|
+
initA2UI,
|
|
94
|
+
A2UIRenderer,
|
|
95
|
+
A2UIProtocol
|
|
96
|
+
};
|
|
97
|
+
|
|
98
|
+
// Default Export (Browser-safe)
|
|
99
|
+
export default {
|
|
100
|
+
createReactiveState,
|
|
101
|
+
subscribe,
|
|
102
|
+
createSignal,
|
|
103
|
+
createEffect,
|
|
104
|
+
store,
|
|
105
|
+
actions,
|
|
106
|
+
patterns,
|
|
107
|
+
motion,
|
|
108
|
+
html,
|
|
109
|
+
Layout,
|
|
110
|
+
schemas,
|
|
111
|
+
Validation,
|
|
112
|
+
rules,
|
|
113
|
+
afri,
|
|
114
|
+
AfriFieldBuilder,
|
|
115
|
+
normalizeInput,
|
|
116
|
+
buildSchema,
|
|
117
|
+
createFramework,
|
|
118
|
+
getConfig,
|
|
119
|
+
getRequestIdentity,
|
|
120
|
+
parseCookieHeader,
|
|
121
|
+
createSessionId,
|
|
122
|
+
SESSION_COOKIE_NAME,
|
|
123
|
+
sessionStore,
|
|
124
|
+
runtimeActions,
|
|
125
|
+
MiddlewareManager,
|
|
126
|
+
loggerMiddleware,
|
|
127
|
+
authMiddleware,
|
|
128
|
+
AfriCodeError,
|
|
129
|
+
ValidationError,
|
|
130
|
+
InvalidUrlError,
|
|
131
|
+
SecurityError,
|
|
132
|
+
CsrfError,
|
|
133
|
+
RateLimitError,
|
|
134
|
+
DatabaseError,
|
|
135
|
+
ComponentError,
|
|
136
|
+
initA2UI,
|
|
137
|
+
A2UIRenderer,
|
|
138
|
+
A2UIProtocol,
|
|
139
|
+
init
|
|
140
|
+
};
|
package/core/sdk-client.js
CHANGED
|
@@ -1,62 +1,62 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* AfriCode Client SDK
|
|
3
|
-
* Browser-safe entry point for client-side bundling
|
|
4
|
-
*
|
|
5
|
-
* This excludes server-side code like database, auth, and server utilities
|
|
6
|
-
* that can't be bundled for browser use.
|
|
7
|
-
*/
|
|
8
|
-
|
|
9
|
-
import { createReactiveState, subscribe, createSignal, createEffect } from './state.js';
|
|
10
|
-
import { store, actions } from './store.js';
|
|
11
|
-
import patterns from './patterns.js';
|
|
12
|
-
import * as motion from './motion.js';
|
|
13
|
-
import { hydrate } from './hydration.js';
|
|
14
|
-
import { html, Layout } from './html.js';
|
|
15
|
-
|
|
16
|
-
import { componentMap as coreMap } from '../components/index.js';
|
|
17
|
-
|
|
18
|
-
// Utility to initialize the client-side framework
|
|
19
|
-
export function init(projectComponentMap = {}) {
|
|
20
|
-
if (typeof window !== 'undefined') {
|
|
21
|
-
console.log('🌍 AfriCode Client SDK Initialized (Zero-Config Mode)');
|
|
22
|
-
|
|
23
|
-
// Merge project map with core map
|
|
24
|
-
const finalMap = { ...coreMap, ...projectComponentMap };
|
|
25
|
-
|
|
26
|
-
if (Object.keys(finalMap).length > 0) {
|
|
27
|
-
hydrate(finalMap);
|
|
28
|
-
}
|
|
29
|
-
}
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
// Grouped exports for cleaner access (client-safe only)
|
|
33
|
-
export {
|
|
34
|
-
createReactiveState,
|
|
35
|
-
subscribe,
|
|
36
|
-
createSignal,
|
|
37
|
-
createEffect
|
|
38
|
-
} from './state.js';
|
|
39
|
-
|
|
40
|
-
export {
|
|
41
|
-
store,
|
|
42
|
-
actions,
|
|
43
|
-
patterns,
|
|
44
|
-
motion,
|
|
45
|
-
html,
|
|
46
|
-
Layout
|
|
47
|
-
};
|
|
48
|
-
|
|
49
|
-
// Default Export
|
|
50
|
-
export default {
|
|
51
|
-
createReactiveState,
|
|
52
|
-
subscribe,
|
|
53
|
-
createSignal,
|
|
54
|
-
createEffect,
|
|
55
|
-
store,
|
|
56
|
-
actions,
|
|
57
|
-
patterns,
|
|
58
|
-
motion,
|
|
59
|
-
html,
|
|
60
|
-
Layout,
|
|
61
|
-
init
|
|
1
|
+
/**
|
|
2
|
+
* AfriCode Client SDK
|
|
3
|
+
* Browser-safe entry point for client-side bundling
|
|
4
|
+
*
|
|
5
|
+
* This excludes server-side code like database, auth, and server utilities
|
|
6
|
+
* that can't be bundled for browser use.
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
import { createReactiveState, subscribe, createSignal, createEffect } from './state.js';
|
|
10
|
+
import { store, actions } from './store.js';
|
|
11
|
+
import patterns from './patterns.js';
|
|
12
|
+
import * as motion from './motion.js';
|
|
13
|
+
import { hydrate } from './hydration.js';
|
|
14
|
+
import { html, Layout } from './html.js';
|
|
15
|
+
|
|
16
|
+
import { componentMap as coreMap } from '../components/index.js';
|
|
17
|
+
|
|
18
|
+
// Utility to initialize the client-side framework
|
|
19
|
+
export function init(projectComponentMap = {}) {
|
|
20
|
+
if (typeof window !== 'undefined') {
|
|
21
|
+
console.log('🌍 AfriCode Client SDK Initialized (Zero-Config Mode)');
|
|
22
|
+
|
|
23
|
+
// Merge project map with core map
|
|
24
|
+
const finalMap = { ...coreMap, ...projectComponentMap };
|
|
25
|
+
|
|
26
|
+
if (Object.keys(finalMap).length > 0) {
|
|
27
|
+
hydrate(finalMap);
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
// Grouped exports for cleaner access (client-safe only)
|
|
33
|
+
export {
|
|
34
|
+
createReactiveState,
|
|
35
|
+
subscribe,
|
|
36
|
+
createSignal,
|
|
37
|
+
createEffect
|
|
38
|
+
} from './state.js';
|
|
39
|
+
|
|
40
|
+
export {
|
|
41
|
+
store,
|
|
42
|
+
actions,
|
|
43
|
+
patterns,
|
|
44
|
+
motion,
|
|
45
|
+
html,
|
|
46
|
+
Layout
|
|
47
|
+
};
|
|
48
|
+
|
|
49
|
+
// Default Export
|
|
50
|
+
export default {
|
|
51
|
+
createReactiveState,
|
|
52
|
+
subscribe,
|
|
53
|
+
createSignal,
|
|
54
|
+
createEffect,
|
|
55
|
+
store,
|
|
56
|
+
actions,
|
|
57
|
+
patterns,
|
|
58
|
+
motion,
|
|
59
|
+
html,
|
|
60
|
+
Layout,
|
|
61
|
+
init
|
|
62
62
|
};
|
package/core/sdk.d.ts
CHANGED
|
@@ -1,133 +1,133 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* AfriCode SDK - TypeScript Definitions
|
|
3
|
-
* Main entry point and API surface
|
|
4
|
-
*/
|
|
5
|
-
|
|
6
|
-
import {
|
|
7
|
-
createReactiveState,
|
|
8
|
-
subscribe,
|
|
9
|
-
createSignal,
|
|
10
|
-
createEffect
|
|
11
|
-
} from './state';
|
|
12
|
-
|
|
13
|
-
// State types
|
|
14
|
-
export interface ReactiveState<T extends Record<string, any>> {
|
|
15
|
-
[K in keyof T]: T[K];
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
export interface Signal<T> {
|
|
19
|
-
(): T;
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
export interface SignalSetter<T> {
|
|
23
|
-
(value: T | ((prev: T) => T)): void;
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
export interface Subscriber<T> {
|
|
27
|
-
(newValue: T, oldValue?: T): void;
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
export interface Effect {
|
|
31
|
-
(): void | (() => void);
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
// State management
|
|
35
|
-
export function createReactiveState<T extends Record<string, any>>(
|
|
36
|
-
initialState: T
|
|
37
|
-
): ReactiveState<T>;
|
|
38
|
-
|
|
39
|
-
export function subscribe<T extends Record<string, any>>(
|
|
40
|
-
state: ReactiveState<T>,
|
|
41
|
-
callback: Subscriber<T>
|
|
42
|
-
): () => void; // Unsubscribe function
|
|
43
|
-
|
|
44
|
-
export function createSignal<T>(initialValue: T): [Signal<T>, SignalSetter<T>];
|
|
45
|
-
|
|
46
|
-
export function createEffect(effect: Effect): () => void; // Cleanup function
|
|
47
|
-
|
|
48
|
-
// Patterns
|
|
49
|
-
export interface PatternOptions {
|
|
50
|
-
primaryColor?: string;
|
|
51
|
-
secondaryColor?: string;
|
|
52
|
-
accentColor?: string;
|
|
53
|
-
size?: number;
|
|
54
|
-
}
|
|
55
|
-
|
|
56
|
-
export const patterns: {
|
|
57
|
-
generateShuka: (options?: PatternOptions) => string;
|
|
58
|
-
generateKente: (options?: PatternOptions) => string;
|
|
59
|
-
generateKanga: (options?: PatternOptions) => string;
|
|
60
|
-
generateAdinkra: (options?: PatternOptions) => string;
|
|
61
|
-
generateKubaBorder: (options?: PatternOptions) => string;
|
|
62
|
-
generateZuluBeads: (options?: PatternOptions) => string;
|
|
63
|
-
generateMasaiShield: (options?: PatternOptions) => string;
|
|
64
|
-
generateNdebelePaint: (options?: PatternOptions) => string;
|
|
65
|
-
[key: string]: (options?: PatternOptions) => string;
|
|
66
|
-
};
|
|
67
|
-
|
|
68
|
-
// Motion/Animation
|
|
69
|
-
export const motion: {
|
|
70
|
-
fadeIn: animation config;
|
|
71
|
-
slideUp: animation config;
|
|
72
|
-
popIn: animation config;
|
|
73
|
-
[key: string]: any;
|
|
74
|
-
};
|
|
75
|
-
|
|
76
|
-
// HTML template engine
|
|
77
|
-
export function html(
|
|
78
|
-
strings: TemplateStringsArray,
|
|
79
|
-
...values: any[]
|
|
80
|
-
): string;
|
|
81
|
-
|
|
82
|
-
// Layout utilities
|
|
83
|
-
export interface LayoutProps {
|
|
84
|
-
vertical?: boolean;
|
|
85
|
-
gap?: number;
|
|
86
|
-
align?: 'start' | 'center' | 'end';
|
|
87
|
-
justify?: 'start' | 'center' | 'end' | 'between';
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
export class Layout {
|
|
91
|
-
constructor(props?: LayoutProps);
|
|
92
|
-
render(): HTMLElement;
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
// Hydration
|
|
96
|
-
export function hydrate(componentMap: Record<string, any>): void;
|
|
97
|
-
|
|
98
|
-
// Store
|
|
99
|
-
export interface GlobalStore {
|
|
100
|
-
theme: 'light' | 'dark' | string;
|
|
101
|
-
language: string;
|
|
102
|
-
[key: string]: any;
|
|
103
|
-
}
|
|
104
|
-
|
|
105
|
-
export interface StoreActions {
|
|
106
|
-
setTheme: (theme: string) => void;
|
|
107
|
-
setLanguage: (lang: string) => void;
|
|
108
|
-
[key: string]: any;
|
|
109
|
-
}
|
|
110
|
-
|
|
111
|
-
export const store: GlobalStore;
|
|
112
|
-
export const actions: StoreActions;
|
|
113
|
-
|
|
114
|
-
// Framework initialization
|
|
115
|
-
export function init(projectComponents?: Record<string, any>): void;
|
|
116
|
-
|
|
117
|
-
// Default export
|
|
118
|
-
declare const sdk: {
|
|
119
|
-
createReactiveState: typeof createReactiveState;
|
|
120
|
-
subscribe: typeof subscribe;
|
|
121
|
-
createSignal: typeof createSignal;
|
|
122
|
-
createEffect: typeof createEffect;
|
|
123
|
-
store: typeof store;
|
|
124
|
-
actions: typeof actions;
|
|
125
|
-
patterns: typeof patterns;
|
|
126
|
-
motion: typeof motion;
|
|
127
|
-
html: typeof html;
|
|
128
|
-
Layout: typeof Layout;
|
|
129
|
-
hydrate: typeof hydrate;
|
|
130
|
-
init: typeof init;
|
|
131
|
-
};
|
|
132
|
-
|
|
133
|
-
export default sdk;
|
|
1
|
+
/**
|
|
2
|
+
* AfriCode SDK - TypeScript Definitions
|
|
3
|
+
* Main entry point and API surface
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import {
|
|
7
|
+
createReactiveState,
|
|
8
|
+
subscribe,
|
|
9
|
+
createSignal,
|
|
10
|
+
createEffect
|
|
11
|
+
} from './state';
|
|
12
|
+
|
|
13
|
+
// State types
|
|
14
|
+
export interface ReactiveState<T extends Record<string, any>> {
|
|
15
|
+
[K in keyof T]: T[K];
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
export interface Signal<T> {
|
|
19
|
+
(): T;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export interface SignalSetter<T> {
|
|
23
|
+
(value: T | ((prev: T) => T)): void;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
export interface Subscriber<T> {
|
|
27
|
+
(newValue: T, oldValue?: T): void;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export interface Effect {
|
|
31
|
+
(): void | (() => void);
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
// State management
|
|
35
|
+
export function createReactiveState<T extends Record<string, any>>(
|
|
36
|
+
initialState: T
|
|
37
|
+
): ReactiveState<T>;
|
|
38
|
+
|
|
39
|
+
export function subscribe<T extends Record<string, any>>(
|
|
40
|
+
state: ReactiveState<T>,
|
|
41
|
+
callback: Subscriber<T>
|
|
42
|
+
): () => void; // Unsubscribe function
|
|
43
|
+
|
|
44
|
+
export function createSignal<T>(initialValue: T): [Signal<T>, SignalSetter<T>];
|
|
45
|
+
|
|
46
|
+
export function createEffect(effect: Effect): () => void; // Cleanup function
|
|
47
|
+
|
|
48
|
+
// Patterns
|
|
49
|
+
export interface PatternOptions {
|
|
50
|
+
primaryColor?: string;
|
|
51
|
+
secondaryColor?: string;
|
|
52
|
+
accentColor?: string;
|
|
53
|
+
size?: number;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
export const patterns: {
|
|
57
|
+
generateShuka: (options?: PatternOptions) => string;
|
|
58
|
+
generateKente: (options?: PatternOptions) => string;
|
|
59
|
+
generateKanga: (options?: PatternOptions) => string;
|
|
60
|
+
generateAdinkra: (options?: PatternOptions) => string;
|
|
61
|
+
generateKubaBorder: (options?: PatternOptions) => string;
|
|
62
|
+
generateZuluBeads: (options?: PatternOptions) => string;
|
|
63
|
+
generateMasaiShield: (options?: PatternOptions) => string;
|
|
64
|
+
generateNdebelePaint: (options?: PatternOptions) => string;
|
|
65
|
+
[key: string]: (options?: PatternOptions) => string;
|
|
66
|
+
};
|
|
67
|
+
|
|
68
|
+
// Motion/Animation
|
|
69
|
+
export const motion: {
|
|
70
|
+
fadeIn: animation config;
|
|
71
|
+
slideUp: animation config;
|
|
72
|
+
popIn: animation config;
|
|
73
|
+
[key: string]: any;
|
|
74
|
+
};
|
|
75
|
+
|
|
76
|
+
// HTML template engine
|
|
77
|
+
export function html(
|
|
78
|
+
strings: TemplateStringsArray,
|
|
79
|
+
...values: any[]
|
|
80
|
+
): string;
|
|
81
|
+
|
|
82
|
+
// Layout utilities
|
|
83
|
+
export interface LayoutProps {
|
|
84
|
+
vertical?: boolean;
|
|
85
|
+
gap?: number;
|
|
86
|
+
align?: 'start' | 'center' | 'end';
|
|
87
|
+
justify?: 'start' | 'center' | 'end' | 'between';
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
export class Layout {
|
|
91
|
+
constructor(props?: LayoutProps);
|
|
92
|
+
render(): HTMLElement;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
// Hydration
|
|
96
|
+
export function hydrate(componentMap: Record<string, any>): void;
|
|
97
|
+
|
|
98
|
+
// Store
|
|
99
|
+
export interface GlobalStore {
|
|
100
|
+
theme: 'light' | 'dark' | string;
|
|
101
|
+
language: string;
|
|
102
|
+
[key: string]: any;
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
export interface StoreActions {
|
|
106
|
+
setTheme: (theme: string) => void;
|
|
107
|
+
setLanguage: (lang: string) => void;
|
|
108
|
+
[key: string]: any;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
export const store: GlobalStore;
|
|
112
|
+
export const actions: StoreActions;
|
|
113
|
+
|
|
114
|
+
// Framework initialization
|
|
115
|
+
export function init(projectComponents?: Record<string, any>): void;
|
|
116
|
+
|
|
117
|
+
// Default export
|
|
118
|
+
declare const sdk: {
|
|
119
|
+
createReactiveState: typeof createReactiveState;
|
|
120
|
+
subscribe: typeof subscribe;
|
|
121
|
+
createSignal: typeof createSignal;
|
|
122
|
+
createEffect: typeof createEffect;
|
|
123
|
+
store: typeof store;
|
|
124
|
+
actions: typeof actions;
|
|
125
|
+
patterns: typeof patterns;
|
|
126
|
+
motion: typeof motion;
|
|
127
|
+
html: typeof html;
|
|
128
|
+
Layout: typeof Layout;
|
|
129
|
+
hydrate: typeof hydrate;
|
|
130
|
+
init: typeof init;
|
|
131
|
+
};
|
|
132
|
+
|
|
133
|
+
export default sdk;
|