@africode/core 5.0.0

package/core/sdk-client.js

@@ -0,0 +1,62 @@
+/**
+ * AfriCode Client SDK
+ * Browser-safe entry point for client-side bundling
+ *
+ * This excludes server-side code like database, auth, and server utilities
+ * that can't be bundled for browser use.
+ */
+
+import { createReactiveState, subscribe, createSignal, createEffect } from './state.js';
+import { store, actions } from './store.js';
+import patterns from './patterns.js';
+import * as motion from './motion.js';
+import { hydrate } from './hydration.js';
+import { html, Layout } from './html.js';
+
+import { componentMap as coreMap } from '../components/index.js';
+
+// Utility to initialize the client-side framework
+export function init(projectComponentMap = {}) {
+    if (typeof window !== 'undefined') {
+        console.log('🌍 AfriCode Client SDK Initialized (Zero-Config Mode)');
+
+        // Merge project map with core map
+        const finalMap = { ...coreMap, ...projectComponentMap };
+
+        if (Object.keys(finalMap).length > 0) {
+            hydrate(finalMap);
+        }
+    }
+}
+
+// Grouped exports for cleaner access (client-safe only)
+export {
+    createReactiveState,
+    subscribe,
+    createSignal,
+    createEffect
+} from './state.js';
+
+export {
+    store,
+    actions,
+    patterns,
+    motion,
+    html,
+    Layout
+};
+
+// Default Export
+export default {
+    createReactiveState,
+    subscribe,
+    createSignal,
+    createEffect,
+    store,
+    actions,
+    patterns,
+    motion,
+    html,
+    Layout,
+    init
+};

package/core/sdk.d.ts

@@ -0,0 +1,133 @@
+/**
+ * AfriCode SDK - TypeScript Definitions
+ * Main entry point and API surface
+ */
+
+import { 
+  createReactiveState, 
+  subscribe, 
+  createSignal, 
+  createEffect 
+} from './state';
+
+// State types
+export interface ReactiveState<T extends Record<string, any>> {
+  [K in keyof T]: T[K];
+}
+
+export interface Signal<T> {
+  (): T;
+}
+
+export interface SignalSetter<T> {
+  (value: T | ((prev: T) => T)): void;
+}
+
+export interface Subscriber<T> {
+  (newValue: T, oldValue?: T): void;
+}
+
+export interface Effect {
+  (): void | (() => void);
+}
+
+// State management
+export function createReactiveState<T extends Record<string, any>>(
+  initialState: T
+): ReactiveState<T>;
+
+export function subscribe<T extends Record<string, any>>(
+  state: ReactiveState<T>,
+  callback: Subscriber<T>
+): () => void; // Unsubscribe function
+
+export function createSignal<T>(initialValue: T): [Signal<T>, SignalSetter<T>];
+
+export function createEffect(effect: Effect): () => void; // Cleanup function
+
+// Patterns
+export interface PatternOptions {
+  primaryColor?: string;
+  secondaryColor?: string;
+  accentColor?: string;
+  size?: number;
+}
+
+export const patterns: {
+  generateShuka: (options?: PatternOptions) => string;
+  generateKente: (options?: PatternOptions) => string;
+  generateKanga: (options?: PatternOptions) => string;
+  generateAdinkra: (options?: PatternOptions) => string;
+  generateKubaBorder: (options?: PatternOptions) => string;
+  generateZuluBeads: (options?: PatternOptions) => string;
+  generateMasaiShield: (options?: PatternOptions) => string;
+  generateNdebelePaint: (options?: PatternOptions) => string;
+  [key: string]: (options?: PatternOptions) => string;
+};
+
+// Motion/Animation
+export const motion: {
+  fadeIn: animation config;
+  slideUp: animation config;
+  popIn: animation config;
+  [key: string]: any;
+};
+
+// HTML template engine
+export function html(
+  strings: TemplateStringsArray,
+  ...values: any[]
+): string;
+
+// Layout utilities
+export interface LayoutProps {
+  vertical?: boolean;
+  gap?: number;
+  align?: 'start' | 'center' | 'end';
+  justify?: 'start' | 'center' | 'end' | 'between';
+}
+
+export class Layout {
+  constructor(props?: LayoutProps);
+  render(): HTMLElement;
+}
+
+// Hydration
+export function hydrate(componentMap: Record<string, any>): void;
+
+// Store
+export interface GlobalStore {
+  theme: 'light' | 'dark' | string;
+  language: string;
+  [key: string]: any;
+}
+
+export interface StoreActions {
+  setTheme: (theme: string) => void;
+  setLanguage: (lang: string) => void;
+  [key: string]: any;
+}
+
+export const store: GlobalStore;
+export const actions: StoreActions;
+
+// Framework initialization
+export function init(projectComponents?: Record<string, any>): void;
+
+// Default export
+declare const sdk: {
+  createReactiveState: typeof createReactiveState;
+  subscribe: typeof subscribe;
+  createSignal: typeof createSignal;
+  createEffect: typeof createEffect;
+  store: typeof store;
+  actions: typeof actions;
+  patterns: typeof patterns;
+  motion: typeof motion;
+  html: typeof html;
+  Layout: typeof Layout;
+  hydrate: typeof hydrate;
+  init: typeof init;
+};
+
+export default sdk;

package/core/sdk.js

@@ -0,0 +1,123 @@
+/**
+ * AfriCode SDK
+ * The unified entry point for the AfriCode Framework.
+ *
+ * Philosophy: Strict by default. Convenient by composition. Secure early.
+ */
+
+import { createReactiveState, subscribe, createSignal, createEffect } from './state.js';
+import { store, actions } from './store.js';
+import patterns from './patterns.js';
+import * as motion from './motion.js';
+import { hydrate } from './hydration.js';
+import { html, Layout } from './html.js';
+import { schemas, Validation, rules, afri, AfriFieldBuilder, normalizeInput, buildSchema } from './validation.js';
+import { createFramework, getConfig } from './config.js';
+import {
+    AfriCodeError, ValidationError, InvalidUrlError,
+    SecurityError, CsrfError, RateLimitError,
+    DatabaseError, ComponentError
+} from './errors.js';
+
+// v5.0.0 additions
+import { initA2UI, A2UIRenderer, A2UIProtocol } from './a2ui.js';
+import { NIDAClient, TIPSClient, AMLComplianceEngine, ComplianceMiddleware } from './compliance.js';
+import { initBunRuntime, HotReloadEngine, BunHTTPServer, BunDatabase, PerformanceMonitor } from './bun-runtime.js';
+
+import { componentMap as coreMap } from '../components/index.js';
+
+// Utility to initialize the full framework
+export function init(projectComponentMap = {}) {
+    if (typeof window !== 'undefined') {
+        console.log('🌍 AfriCode SDK Initialized (Zero-Config Mode)');
+
+        // Merge project map with core map
+        const finalMap = { ...coreMap, ...projectComponentMap };
+
+        if (Object.keys(finalMap).length > 0) {
+            hydrate(finalMap);
+        }
+    }
+}
+
+// Grouped exports for cleaner access
+export {
+    createReactiveState,
+    subscribe,
+    createSignal,
+    createEffect
+} from './state.js';
+
+export {
+    store,
+    actions,
+    patterns,
+    motion,
+    html,
+    Layout,
+    schemas,
+    Validation,
+    rules,
+    afri,
+    AfriFieldBuilder,
+    normalizeInput,
+    buildSchema,
+    createFramework,
+    getConfig,
+    AfriCodeError,
+    ValidationError,
+    InvalidUrlError,
+    SecurityError,
+    CsrfError,
+    RateLimitError,
+    DatabaseError,
+    ComponentError
+};
+
+// v5.0.0 exports
+export {
+    initA2UI,
+    A2UIRenderer,
+    A2UIProtocol,
+    NIDAClient,
+    TIPSClient,
+    AMLComplianceEngine,
+    ComplianceMiddleware,
+    initBunRuntime,
+    HotReloadEngine,
+    BunHTTPServer,
+    BunDatabase,
+    PerformanceMonitor
+};
+
+// Default Export
+export default {
+    createReactiveState,
+    subscribe,
+    createSignal,
+    createEffect,
+    store,
+    actions,
+    patterns,
+    motion,
+    html,
+    Layout,
+    schemas,
+    Validation,
+    rules,
+    afri,
+    AfriFieldBuilder,
+    normalizeInput,
+    buildSchema,
+    createFramework,
+    getConfig,
+    AfriCodeError,
+    ValidationError,
+    InvalidUrlError,
+    SecurityError,
+    CsrfError,
+    RateLimitError,
+    DatabaseError,
+    ComponentError,
+    init
+};

package/core/seo.js

@@ -0,0 +1,76 @@
+/**
+ * AfriCode SEO Engine 🔍
+ * 
+ * Utilities for metadata management, Open Graph tags, and Sitemap generation.
+ * Ensures "African Code" is discoverable by search engines.
+ * 
+ * @module core/seo
+ */
+
+import { html } from './html.js';
+
+/**
+ * Generate standard SEO Metadata
+ * @param {Object} options 
+ * @param {string} options.title - Page title
+ * @param {string} options.description - Meta description (150-160 chars)
+ * @param {string} options.image - URL to Open Graph image (social banner)
+ * @param {string} options.url - Canonical URL
+ * @param {string} options.type - 'website' or 'article'
+ * @returns {string} HTML string of meta tags
+ */
+export function generateMetadata({
+    title = 'AfriCode App',
+    description = 'Built with the Rhythmic Web Framework.',
+    image = '/assets/og-default.png',
+    url = '',
+    type = 'website'
+} = {}) {
+    return html`
+        <!-- Standard -->
+        <title>${title}</title>
+        <meta name="description" content="${description}">
+        <link rel="canonical" href="${url}">
+
+        <!-- Open Graph / Facebook -->
+        <meta property="og:type" content="${type}">
+        <meta property="og:url" content="${url}">
+        <meta property="og:title" content="${title}">
+        <meta property="og:description" content="${description}">
+        <meta property="og:image" content="${image}">
+
+        <!-- Twitter -->
+        <meta property="twitter:card" content="summary_large_image">
+        <meta property="twitter:url" content="${url}">
+        <meta property="twitter:title" content="${title}">
+        <meta property="twitter:description" content="${description}">
+        <meta property="twitter:image" content="${image}">
+    `;
+}
+
+/**
+ * Generate XML Sitemap
+ * @param {string} baseUrl - Domain (e.g., https://africode.dev)
+ * @param {string[]} routes - List of page routes (e.g., ['/', '/docs', '/about'])
+ * @returns {string} XML Sitemap content
+ */
+export function generateSitemap(baseUrl, routes) {
+    const cleanUrl = (url) => url.replace(/\/$/, ''); // Remove trailing slash
+    const date = new Date().toISOString().split('T')[0];
+
+    const urls = routes.map(route => `
+    <url>
+        <loc>${cleanUrl(baseUrl)}${route}</loc>
+        <lastmod>${date}</lastmod>
+        <changefreq>weekly</changefreq>
+        <priority>${route === '/' ? '1.0' : '0.8'}</priority>
+    </url>
+    `).join('');
+
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urls}
+</urlset>`;
+}
+
+export default { generateMetadata, generateSitemap };