@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.
- 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 +396 -396
- 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 +248 -283
- 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 +47 -47
- 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 +23 -11
- 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/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/server/router.js
CHANGED
|
@@ -12,9 +12,17 @@ import { pathToFileURL } from 'node:url';
|
|
|
12
12
|
|
|
13
13
|
const routerCache = new Map();
|
|
14
14
|
|
|
15
|
-
function
|
|
16
|
-
|
|
17
|
-
|
|
15
|
+
function getProjectRoot(options = {}) {
|
|
16
|
+
return resolve(options.projectRoot || process.cwd());
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
function getAbsolutePagesDir(projectRoot, pagesDir) {
|
|
20
|
+
return resolve(projectRoot, pagesDir || 'pages');
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
function getRouter(pagesDir, { reload = false } = {}) {
|
|
24
|
+
const absolutePagesDir = resolve(pagesDir);
|
|
25
|
+
let router = reload ? null : routerCache.get(absolutePagesDir);
|
|
18
26
|
|
|
19
27
|
if (!router) {
|
|
20
28
|
router = new FileSystemRouter(absolutePagesDir);
|
|
@@ -27,15 +35,15 @@ function getRouter(pagesDir) {
|
|
|
27
35
|
return router;
|
|
28
36
|
}
|
|
29
37
|
|
|
30
|
-
async function getConfiguredPagesDir() {
|
|
31
|
-
const configPath = resolve(
|
|
38
|
+
async function getConfiguredPagesDir(projectRoot) {
|
|
39
|
+
const configPath = resolve(projectRoot, 'africode.config.js');
|
|
32
40
|
|
|
33
41
|
try {
|
|
34
42
|
const config = (await import(configPath + '?t=' + Date.now())).default || {};
|
|
35
43
|
return config.directories?.pages || config.pagesDir ||
|
|
36
|
-
(existsSync(resolve(
|
|
44
|
+
(existsSync(resolve(projectRoot, 'src/pages')) ? 'src/pages' : 'pages');
|
|
37
45
|
} catch {
|
|
38
|
-
return existsSync(resolve(
|
|
46
|
+
return existsSync(resolve(projectRoot, 'src/pages')) ? 'src/pages' : 'pages';
|
|
39
47
|
}
|
|
40
48
|
}
|
|
41
49
|
|
|
@@ -56,12 +64,13 @@ async function executeHandler(module, req) {
|
|
|
56
64
|
export async function handleApiRequest(req, options = {}) {
|
|
57
65
|
const url = new URL(req.url);
|
|
58
66
|
const pathname = url.pathname;
|
|
67
|
+
const projectRoot = getProjectRoot(options);
|
|
59
68
|
|
|
60
69
|
if (pathname.startsWith('/api/auth/')) {
|
|
61
70
|
try {
|
|
62
71
|
const { handleAuthRequest } = await import('./auth-endpoints.js');
|
|
63
72
|
const authResponse = await handleAuthRequest(req, pathname);
|
|
64
|
-
if (authResponse) return authResponse;
|
|
73
|
+
if (authResponse) {return authResponse;}
|
|
65
74
|
} catch (err) {
|
|
66
75
|
console.error(`Auth endpoint error at ${pathname}:`, err);
|
|
67
76
|
return new Response(JSON.stringify({ error: err.message }), {
|
|
@@ -71,10 +80,13 @@ export async function handleApiRequest(req, options = {}) {
|
|
|
71
80
|
}
|
|
72
81
|
}
|
|
73
82
|
|
|
74
|
-
const pagesDir =
|
|
75
|
-
|
|
83
|
+
const pagesDir = getAbsolutePagesDir(
|
|
84
|
+
projectRoot,
|
|
85
|
+
options.pagesDir || await getConfiguredPagesDir(projectRoot)
|
|
86
|
+
);
|
|
87
|
+
const route = getRouter(pagesDir, { reload: options.reloadRoutes === true }).resolve(pathname);
|
|
76
88
|
|
|
77
|
-
if (!route?.isApi) return null;
|
|
89
|
+
if (!route?.isApi) {return null;}
|
|
78
90
|
|
|
79
91
|
try {
|
|
80
92
|
const moduleUrl = pathToFileURL(route.filePath).href + '?t=' + Date.now();
|
package/core/session-store.js
CHANGED
|
@@ -1,68 +1,68 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Server-side session state store for AfriCode.
|
|
3
|
-
*
|
|
4
|
-
* @module core/session-store
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
class SessionStore {
|
|
8
|
-
constructor() {
|
|
9
|
-
this.sessions = new Map();
|
|
10
|
-
}
|
|
11
|
-
|
|
12
|
-
ensure(sessionId) {
|
|
13
|
-
if (!this.sessions.has(sessionId)) {
|
|
14
|
-
this.sessions.set(sessionId, {
|
|
15
|
-
data: {
|
|
16
|
-
counter: { value: 0 }
|
|
17
|
-
},
|
|
18
|
-
meta: {
|
|
19
|
-
createdAt: new Date(),
|
|
20
|
-
lastSeenAt: new Date()
|
|
21
|
-
}
|
|
22
|
-
});
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
return this.sessions.get(sessionId);
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
touch(sessionId) {
|
|
29
|
-
const session = this.ensure(sessionId);
|
|
30
|
-
session.meta.lastSeenAt = new Date();
|
|
31
|
-
return session;
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
has(sessionId) {
|
|
35
|
-
return this.sessions.has(sessionId);
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
get(sessionId) {
|
|
39
|
-
return this.touch(sessionId).data;
|
|
40
|
-
}
|
|
41
|
-
|
|
42
|
-
set(sessionId, path, value) {
|
|
43
|
-
const session = this.get(sessionId);
|
|
44
|
-
const keys = path.split('/');
|
|
45
|
-
let obj = session;
|
|
46
|
-
|
|
47
|
-
while (keys.length > 1) {
|
|
48
|
-
const key = keys.shift();
|
|
49
|
-
if (!obj[key] || typeof obj[key] !== 'object') {
|
|
50
|
-
obj[key] = {};
|
|
51
|
-
}
|
|
52
|
-
obj = obj[key];
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
obj[keys[0]] = value;
|
|
56
|
-
return value;
|
|
57
|
-
}
|
|
58
|
-
|
|
59
|
-
delete(sessionId) {
|
|
60
|
-
return this.sessions.delete(sessionId);
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
clear() {
|
|
64
|
-
this.sessions.clear();
|
|
65
|
-
}
|
|
66
|
-
}
|
|
67
|
-
|
|
68
|
-
export const sessionStore = new SessionStore();
|
|
1
|
+
/**
|
|
2
|
+
* Server-side session state store for AfriCode.
|
|
3
|
+
*
|
|
4
|
+
* @module core/session-store
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
class SessionStore {
|
|
8
|
+
constructor() {
|
|
9
|
+
this.sessions = new Map();
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
ensure(sessionId) {
|
|
13
|
+
if (!this.sessions.has(sessionId)) {
|
|
14
|
+
this.sessions.set(sessionId, {
|
|
15
|
+
data: {
|
|
16
|
+
counter: { value: 0 }
|
|
17
|
+
},
|
|
18
|
+
meta: {
|
|
19
|
+
createdAt: new Date(),
|
|
20
|
+
lastSeenAt: new Date()
|
|
21
|
+
}
|
|
22
|
+
});
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
return this.sessions.get(sessionId);
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
touch(sessionId) {
|
|
29
|
+
const session = this.ensure(sessionId);
|
|
30
|
+
session.meta.lastSeenAt = new Date();
|
|
31
|
+
return session;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
has(sessionId) {
|
|
35
|
+
return this.sessions.has(sessionId);
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
get(sessionId) {
|
|
39
|
+
return this.touch(sessionId).data;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
set(sessionId, path, value) {
|
|
43
|
+
const session = this.get(sessionId);
|
|
44
|
+
const keys = path.split('/');
|
|
45
|
+
let obj = session;
|
|
46
|
+
|
|
47
|
+
while (keys.length > 1) {
|
|
48
|
+
const key = keys.shift();
|
|
49
|
+
if (!obj[key] || typeof obj[key] !== 'object') {
|
|
50
|
+
obj[key] = {};
|
|
51
|
+
}
|
|
52
|
+
obj = obj[key];
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
obj[keys[0]] = value;
|
|
56
|
+
return value;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
delete(sessionId) {
|
|
60
|
+
return this.sessions.delete(sessionId);
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
clear() {
|
|
64
|
+
this.sessions.clear();
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
export const sessionStore = new SessionStore();
|
package/core/shim.js
CHANGED
|
@@ -1,28 +1,28 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* AfriCode SSR DOM Shim
|
|
3
|
-
* Allows Web Components to be imported in Node/Bun environment.
|
|
4
|
-
*/
|
|
5
|
-
|
|
6
|
-
if (typeof globalThis.HTMLElement === 'undefined') {
|
|
7
|
-
globalThis.HTMLElement = class HTMLElement { };
|
|
8
|
-
globalThis.customElements = { define: () => { }, get: () => { } };
|
|
9
|
-
globalThis.document = {
|
|
10
|
-
createElement: () => ({
|
|
11
|
-
classList: { add: () => { } },
|
|
12
|
-
setAttribute: () => { },
|
|
13
|
-
style: {}
|
|
14
|
-
}),
|
|
15
|
-
head: { appendChild: () => { } },
|
|
16
|
-
body: { appendChild: () => { } }
|
|
17
|
-
};
|
|
18
|
-
globalThis.window = globalThis;
|
|
19
|
-
globalThis.CSSStyleSheet = class CSSStyleSheet { replaceSync() { } };
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
// Global scope support for certain libraries
|
|
23
|
-
if (typeof global !== 'undefined') {
|
|
24
|
-
global.HTMLElement = globalThis.HTMLElement;
|
|
25
|
-
global.customElements = globalThis.customElements;
|
|
26
|
-
global.document = globalThis.document;
|
|
27
|
-
global.window = globalThis;
|
|
28
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* AfriCode SSR DOM Shim
|
|
3
|
+
* Allows Web Components to be imported in Node/Bun environment.
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
if (typeof globalThis.HTMLElement === 'undefined') {
|
|
7
|
+
globalThis.HTMLElement = class HTMLElement { };
|
|
8
|
+
globalThis.customElements = { define: () => { }, get: () => { } };
|
|
9
|
+
globalThis.document = {
|
|
10
|
+
createElement: () => ({
|
|
11
|
+
classList: { add: () => { } },
|
|
12
|
+
setAttribute: () => { },
|
|
13
|
+
style: {}
|
|
14
|
+
}),
|
|
15
|
+
head: { appendChild: () => { } },
|
|
16
|
+
body: { appendChild: () => { } }
|
|
17
|
+
};
|
|
18
|
+
globalThis.window = globalThis;
|
|
19
|
+
globalThis.CSSStyleSheet = class CSSStyleSheet { replaceSync() { } };
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
// Global scope support for certain libraries
|
|
23
|
+
if (typeof global !== 'undefined') {
|
|
24
|
+
global.HTMLElement = globalThis.HTMLElement;
|
|
25
|
+
global.customElements = globalThis.customElements;
|
|
26
|
+
global.document = globalThis.document;
|
|
27
|
+
global.window = globalThis;
|
|
28
|
+
}
|
package/core/state.d.ts
CHANGED
|
@@ -1,86 +1,86 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* AfriCode State Management - TypeScript Definitions
|
|
3
|
-
* Reactive state, signals, and effects
|
|
4
|
-
*/
|
|
5
|
-
|
|
6
|
-
/**
|
|
7
|
-
* Creates a reactive state object with Proxy-based reactivity
|
|
8
|
-
* @template T - The shape of the state object
|
|
9
|
-
* @param initialState - Initial state values
|
|
10
|
-
* @returns Reactive proxy of the state
|
|
11
|
-
*/
|
|
12
|
-
export function createReactiveState<T extends Record<string, any>>(
|
|
13
|
-
initialState: T
|
|
14
|
-
): T & {
|
|
15
|
-
[K in keyof T]: T[K];
|
|
16
|
-
};
|
|
17
|
-
|
|
18
|
-
/**
|
|
19
|
-
* Subscriber callback type
|
|
20
|
-
*/
|
|
21
|
-
export type Subscriber<T extends Record<string, any>> = (
|
|
22
|
-
newValue: T,
|
|
23
|
-
oldValue?: T
|
|
24
|
-
) => void;
|
|
25
|
-
|
|
26
|
-
/**
|
|
27
|
-
* Subscribe to state changes
|
|
28
|
-
* @param state - Reactive state object to subscribe to
|
|
29
|
-
* @param callback - Called when state changes
|
|
30
|
-
* @returns Unsubscribe function
|
|
31
|
-
*/
|
|
32
|
-
export function subscribe<T extends Record<string, any>>(
|
|
33
|
-
state: T,
|
|
34
|
-
callback: Subscriber<T>
|
|
35
|
-
): () => void;
|
|
36
|
-
|
|
37
|
-
/**
|
|
38
|
-
* Signal getter function
|
|
39
|
-
*/
|
|
40
|
-
export type SignalGetter<T> = () => T;
|
|
41
|
-
|
|
42
|
-
/**
|
|
43
|
-
* Signal setter function - accepts value or updater function
|
|
44
|
-
*/
|
|
45
|
-
export type SignalSetter<T> = (value: T | ((prev: T) => T)) => void;
|
|
46
|
-
|
|
47
|
-
/**
|
|
48
|
-
* Signal tuple return type
|
|
49
|
-
*/
|
|
50
|
-
export type Signal<T> = [getter: SignalGetter<T>, setter: SignalSetter<T>];
|
|
51
|
-
|
|
52
|
-
/**
|
|
53
|
-
* Create a reactive signal with getter and setter
|
|
54
|
-
* @template T - Signal value type
|
|
55
|
-
* @param initialValue - Initial signal value
|
|
56
|
-
* @returns Tuple of [getter, setter]
|
|
57
|
-
*/
|
|
58
|
-
export function createSignal<T>(initialValue: T): Signal<T>;
|
|
59
|
-
|
|
60
|
-
/**
|
|
61
|
-
* Effect callback - can optionally return cleanup function
|
|
62
|
-
*/
|
|
63
|
-
export type EffectCallback = () => void | (() => void);
|
|
64
|
-
|
|
65
|
-
/**
|
|
66
|
-
* Effect cleanup function
|
|
67
|
-
*/
|
|
68
|
-
export type EffectCleanup = () => void;
|
|
69
|
-
|
|
70
|
-
/**
|
|
71
|
-
* Create an effect that runs side effects
|
|
72
|
-
* Effects track dependencies from signals and state
|
|
73
|
-
* @param effect - Effect function to run
|
|
74
|
-
* @returns Cleanup function
|
|
75
|
-
*/
|
|
76
|
-
export function createEffect(effect: EffectCallback): EffectCleanup;
|
|
77
|
-
|
|
78
|
-
/**
|
|
79
|
-
* Internal subscriber map (for advanced use)
|
|
80
|
-
*/
|
|
81
|
-
export const subscribers: WeakMap<object, Set<Subscriber<any>>>;
|
|
82
|
-
|
|
83
|
-
/**
|
|
84
|
-
* Internal signal registry (for advanced use)
|
|
85
|
-
*/
|
|
86
|
-
export const signals: WeakMap<object, any>;
|
|
1
|
+
/**
|
|
2
|
+
* AfriCode State Management - TypeScript Definitions
|
|
3
|
+
* Reactive state, signals, and effects
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Creates a reactive state object with Proxy-based reactivity
|
|
8
|
+
* @template T - The shape of the state object
|
|
9
|
+
* @param initialState - Initial state values
|
|
10
|
+
* @returns Reactive proxy of the state
|
|
11
|
+
*/
|
|
12
|
+
export function createReactiveState<T extends Record<string, any>>(
|
|
13
|
+
initialState: T
|
|
14
|
+
): T & {
|
|
15
|
+
[K in keyof T]: T[K];
|
|
16
|
+
};
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* Subscriber callback type
|
|
20
|
+
*/
|
|
21
|
+
export type Subscriber<T extends Record<string, any>> = (
|
|
22
|
+
newValue: T,
|
|
23
|
+
oldValue?: T
|
|
24
|
+
) => void;
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Subscribe to state changes
|
|
28
|
+
* @param state - Reactive state object to subscribe to
|
|
29
|
+
* @param callback - Called when state changes
|
|
30
|
+
* @returns Unsubscribe function
|
|
31
|
+
*/
|
|
32
|
+
export function subscribe<T extends Record<string, any>>(
|
|
33
|
+
state: T,
|
|
34
|
+
callback: Subscriber<T>
|
|
35
|
+
): () => void;
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* Signal getter function
|
|
39
|
+
*/
|
|
40
|
+
export type SignalGetter<T> = () => T;
|
|
41
|
+
|
|
42
|
+
/**
|
|
43
|
+
* Signal setter function - accepts value or updater function
|
|
44
|
+
*/
|
|
45
|
+
export type SignalSetter<T> = (value: T | ((prev: T) => T)) => void;
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* Signal tuple return type
|
|
49
|
+
*/
|
|
50
|
+
export type Signal<T> = [getter: SignalGetter<T>, setter: SignalSetter<T>];
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* Create a reactive signal with getter and setter
|
|
54
|
+
* @template T - Signal value type
|
|
55
|
+
* @param initialValue - Initial signal value
|
|
56
|
+
* @returns Tuple of [getter, setter]
|
|
57
|
+
*/
|
|
58
|
+
export function createSignal<T>(initialValue: T): Signal<T>;
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* Effect callback - can optionally return cleanup function
|
|
62
|
+
*/
|
|
63
|
+
export type EffectCallback = () => void | (() => void);
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* Effect cleanup function
|
|
67
|
+
*/
|
|
68
|
+
export type EffectCleanup = () => void;
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* Create an effect that runs side effects
|
|
72
|
+
* Effects track dependencies from signals and state
|
|
73
|
+
* @param effect - Effect function to run
|
|
74
|
+
* @returns Cleanup function
|
|
75
|
+
*/
|
|
76
|
+
export function createEffect(effect: EffectCallback): EffectCleanup;
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* Internal subscriber map (for advanced use)
|
|
80
|
+
*/
|
|
81
|
+
export const subscribers: WeakMap<object, Set<Subscriber<any>>>;
|
|
82
|
+
|
|
83
|
+
/**
|
|
84
|
+
* Internal signal registry (for advanced use)
|
|
85
|
+
*/
|
|
86
|
+
export const signals: WeakMap<object, any>;
|