juxscript 1.0.61 → 1.0.63

package/lib/componentsv2/plugins/IndexedDBPlugin.js

@@ -0,0 +1,75 @@
+/**
+ * IndexedDB Plugin
+ * Asynchronous persistence for larger datasets.
+ */
+export const IndexedDBPlugin = (config) => ({
+    name: 'indexed-db-persist',
+    version: '1.0.0',
+    targetEnv: 'client',
+    install: (engine) => {
+        // @ts-ignore
+        const initialState = engine.state[config.bindTo];
+        if (initialState !== undefined && !Array.isArray(initialState)) {
+            console.error(`[IndexedDBPlugin] 🛑 Configuration Error: bindTo='${config.bindTo}' is not an Array. This plugin is designed for List/Collection data.`);
+            return;
+        }
+        let db = null;
+        const request = indexedDB.open(config.dbName, 1);
+        // 1. Schema Setup
+        request.onupgradeneeded = (e) => {
+            const d = e.target.result;
+            if (!d.objectStoreNames.contains(config.storeName)) {
+                d.createObjectStore(config.storeName);
+            }
+        };
+        // 2. IO Operations
+        const save = (data) => {
+            if (!db)
+                return;
+            const tx = db.transaction([config.storeName], 'readwrite');
+            const store = tx.objectStore(config.storeName);
+            store.put(data, 'state_snapshot'); // Storing entire bound state as one blob for simplicity
+        };
+        const load = () => {
+            if (!db)
+                return;
+            // @ts-ignore
+            if (typeof engine.loading === 'function')
+                engine.loading(true);
+            const tx = db.transaction([config.storeName], 'readonly');
+            const store = tx.objectStore(config.storeName);
+            const req = store.get('state_snapshot');
+            req.onsuccess = () => {
+                if (req.result) {
+                    // @ts-ignore
+                    engine.updateState({ [config.bindTo]: req.result });
+                    // @ts-ignore
+                    if (engine.emit)
+                        engine.emit('plugin:hydrated', { source: 'IndexedDB' });
+                }
+                // @ts-ignore
+                if (typeof engine.loading === 'function')
+                    engine.loading(false);
+            };
+            req.onerror = () => {
+                // @ts-ignore
+                if (typeof engine.loading === 'function')
+                    engine.loading(false);
+            };
+        };
+        // 3. Initialization
+        request.onsuccess = (e) => {
+            db = e.target.result;
+            if (config.autoLoad) {
+                load();
+            }
+            // Auto-save subscription (debounced slightly in real world, direct here)
+            engine.subscribe((state) => {
+                if (db)
+                    save(state[config.bindTo]);
+            });
+        };
+        request.onerror = (e) => console.error('[IndexedDBPlugin] Open Error', e);
+    }
+});
+//# sourceMappingURL=IndexedDBPlugin.js.map

package/lib/componentsv2/plugins/IndexedDBPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDBPlugin.js","sourceRoot":"","sources":["IndexedDBPlugin.ts"],"names":[],"mappings":"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"}

package/lib/componentsv2/plugins/IndexedDBPlugin.ts

@@ -0,0 +1,96 @@
+import { JuxServiceContract, BaseEngine } from '../base/BaseEngine.js';
+
+export interface IndexedDBConfig {
+    dbName: string;
+    storeName: string;
+
+    /** 
+     * State Binding: The property key on the Engine's state to persist.
+     * e.g., 'items'
+     */
+    bindTo: string;
+
+    /** If true, loads data immediately on install */
+    autoLoad?: boolean;
+}
+
+/**
+ * IndexedDB Plugin
+ * Asynchronous persistence for larger datasets.
+ */
+export const IndexedDBPlugin = (config: IndexedDBConfig): JuxServiceContract<BaseEngine<any>> => ({
+    name: 'indexed-db-persist',
+    version: '1.0.0',
+    targetEnv: 'client',
+
+    install: (engine) => {
+
+        // @ts-ignore
+        const initialState = engine.state[config.bindTo];
+        if (initialState !== undefined && !Array.isArray(initialState)) {
+            console.error(`[IndexedDBPlugin] 🛑 Configuration Error: bindTo='${config.bindTo}' is not an Array. This plugin is designed for List/Collection data.`);
+            return;
+        }
+
+        let db: IDBDatabase | null = null;
+        const request = indexedDB.open(config.dbName, 1);
+
+        // 1. Schema Setup
+        request.onupgradeneeded = (e: any) => {
+            const d = e.target.result;
+            if (!d.objectStoreNames.contains(config.storeName)) {
+                d.createObjectStore(config.storeName);
+            }
+        };
+
+        // 2. IO Operations
+        const save = (data: any) => {
+            if (!db) return;
+            const tx = db.transaction([config.storeName], 'readwrite');
+            const store = tx.objectStore(config.storeName);
+            store.put(data, 'state_snapshot'); // Storing entire bound state as one blob for simplicity
+        };
+
+        const load = () => {
+            if (!db) return;
+            // @ts-ignore
+            if (typeof engine.loading === 'function') engine.loading(true);
+
+            const tx = db.transaction([config.storeName], 'readonly');
+            const store = tx.objectStore(config.storeName);
+            const req = store.get('state_snapshot');
+
+            req.onsuccess = () => {
+                if (req.result) {
+                    // @ts-ignore
+                    engine.updateState({ [config.bindTo]: req.result });
+                    // @ts-ignore
+                    if (engine.emit) engine.emit('plugin:hydrated', { source: 'IndexedDB' });
+                }
+                // @ts-ignore
+                if (typeof engine.loading === 'function') engine.loading(false);
+            };
+
+            req.onerror = () => {
+                // @ts-ignore
+                if (typeof engine.loading === 'function') engine.loading(false);
+            };
+        };
+
+        // 3. Initialization
+        request.onsuccess = (e: any) => {
+            db = e.target.result;
+
+            if (config.autoLoad) {
+                load();
+            }
+
+            // Auto-save subscription (debounced slightly in real world, direct here)
+            engine.subscribe((state) => {
+                if (db) save(state[config.bindTo]);
+            });
+        };
+
+        request.onerror = (e) => console.error('[IndexedDBPlugin] Open Error', e);
+    }
+});

package/lib/componentsv2/plugins/LocalStoragePlugin.js

@@ -0,0 +1,65 @@
+/**
+ * LocalStorage Plugin
+ * Persists a slice of Engine State to Browser LocalStorage.
+ */
+export const LocalStoragePlugin = (config) => ({
+    name: 'local-storage-persist',
+    version: '1.0.0',
+    targetEnv: 'client',
+    install: (engine) => {
+        // @ts-ignore
+        const initialState = engine.state[config.bindTo];
+        if (initialState !== undefined && !Array.isArray(initialState)) {
+            console.error(`[LocalStoragePlugin] 🛑 Configuration Error: bindTo='${config.bindTo}' is not an Array. This plugin is designed for List/Collection data.`);
+            return;
+        }
+        const storageKey = `jux:${config.key}`;
+        // 1. Hydrate (Load from Storage)
+        const load = () => {
+            try {
+                const raw = localStorage.getItem(storageKey);
+                if (raw) {
+                    const data = JSON.parse(raw);
+                    // @ts-ignore - Generic update
+                    engine.updateState({ [config.bindTo]: data });
+                    // @ts-ignore
+                    if (engine.emit)
+                        engine.emit('plugin:hydrated', { source: 'localStorage', count: Array.isArray(data) ? data.length : 1 });
+                }
+            }
+            catch (e) {
+                console.error('[LocalStoragePlugin] Load Failed', e);
+            }
+        };
+        // 2. Persist (Save to Storage)
+        const save = (state) => {
+            try {
+                const value = state[config.bindTo];
+                localStorage.setItem(storageKey, JSON.stringify(value));
+            }
+            catch (e) {
+                console.error('[LocalStoragePlugin] Save Failed', e);
+            }
+        };
+        // Logic
+        if (config.clearOnInstall) {
+            localStorage.removeItem(storageKey);
+        }
+        else {
+            load();
+        }
+        if (config.autoSave !== false) {
+            engine.subscribe((state) => save(state));
+        }
+        // Expose manual triggers
+        engine.on('storage:save', () => save(engine.state));
+        engine.on('storage:load', load);
+        engine.on('storage:clear', () => {
+            localStorage.removeItem(storageKey);
+            // @ts-ignore
+            if (engine.emit)
+                engine.emit('plugin:cleared', { source: 'localStorage' });
+        });
+    }
+});
+//# sourceMappingURL=LocalStoragePlugin.js.map

package/lib/componentsv2/plugins/LocalStoragePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalStoragePlugin.js","sourceRoot":"","sources":["LocalStoragePlugin.ts"],"names":[],"mappings":"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"}

package/lib/componentsv2/plugins/LocalStoragePlugin.ts

@@ -0,0 +1,86 @@
+import { JuxServiceContract, BaseEngine } from '../base/BaseEngine.js';
+
+export interface LocalStorageConfig {
+    /** Unique key for storage (e.g. 'my-app-list-v1') */
+    key: string;
+
+    /** 
+     * State Binding: The property key on the Engine's state to persist.
+     * e.g., 'items' for a ListEngine.
+     */
+    bindTo: string;
+
+    /** If true, clears storage on install (fresh start) */
+    clearOnInstall?: boolean;
+
+    /** If true, automatically saves to storage when state changes */
+    autoSave?: boolean;
+}
+
+/**
+ * LocalStorage Plugin
+ * Persists a slice of Engine State to Browser LocalStorage.
+ */
+export const LocalStoragePlugin = (config: LocalStorageConfig): JuxServiceContract<BaseEngine<any>> => ({
+    name: 'local-storage-persist',
+    version: '1.0.0',
+    targetEnv: 'client',
+
+    install: (engine) => {
+
+        // @ts-ignore
+        const initialState = engine.state[config.bindTo];
+        if (initialState !== undefined && !Array.isArray(initialState)) {
+            console.error(`[LocalStoragePlugin] 🛑 Configuration Error: bindTo='${config.bindTo}' is not an Array. This plugin is designed for List/Collection data.`);
+            return;
+        }
+
+        const storageKey = `jux:${config.key}`;
+
+        // 1. Hydrate (Load from Storage)
+        const load = () => {
+            try {
+                const raw = localStorage.getItem(storageKey);
+                if (raw) {
+                    const data = JSON.parse(raw);
+                    // @ts-ignore - Generic update
+                    engine.updateState({ [config.bindTo]: data });
+                    // @ts-ignore
+                    if (engine.emit) engine.emit('plugin:hydrated', { source: 'localStorage', count: Array.isArray(data) ? data.length : 1 });
+                }
+            } catch (e) {
+                console.error('[LocalStoragePlugin] Load Failed', e);
+            }
+        };
+
+        // 2. Persist (Save to Storage)
+        const save = (state: any) => {
+            try {
+                const value = state[config.bindTo];
+                localStorage.setItem(storageKey, JSON.stringify(value));
+            } catch (e) {
+                console.error('[LocalStoragePlugin] Save Failed', e);
+            }
+        };
+
+        // Logic
+        if (config.clearOnInstall) {
+            localStorage.removeItem(storageKey);
+        } else {
+            load();
+        }
+
+        if (config.autoSave !== false) {
+            engine.subscribe((state) => save(state));
+        }
+
+        // Expose manual triggers
+        engine.on('storage:save', () => save(engine.state));
+        engine.on('storage:load', load);
+        engine.on('storage:clear', () => {
+            localStorage.removeItem(storageKey);
+            // @ts-ignore
+            if (engine.emit) engine.emit('plugin:cleared', { source: 'localStorage' });
+        });
+    }
+});

package/lib/componentsv2/plugins/ServerSQLitePlugin.js

@@ -0,0 +1,70 @@
+/**
+ * Server-Side SQLite Plugin
+ * Decoupled Service that injects SQL capabilities and binds data to ANY Engine state.
+ */
+export const ServerSQLitePlugin = (config) => ({
+    name: 'server-sqlite-driver',
+    version: '2.0.0',
+    targetEnv: 'server',
+    install: (engine) => {
+        // 1. Expose SQL Capability (Mixin)
+        // Adds a .query() method to the engine instance
+        Object.assign(engine, {
+            query: (sql, params = []) => {
+                if (!config.database || typeof config.database.prepare !== 'function') {
+                    throw new Error('Invalid Database Driver provided to ServerSQLitePlugin.');
+                }
+                const stmt = config.database.prepare(sql);
+                const rows = stmt.all(params);
+                // Emit audit event for queries
+                // @ts-ignore - access protected emit
+                if (typeof engine.emit === 'function')
+                    engine.emit('sql:query', { sql, rows: rows.length });
+                return rows;
+            }
+        });
+        // 2. Hydration Logic
+        const hydrate = () => {
+            if (!config.query)
+                return;
+            try {
+                // Use the newly injected capability
+                // @ts-ignore
+                const rows = engine.query(config.query);
+                if (config.bindTo) {
+                    const data = config.mapRow ? rows.map(config.mapRow) : rows;
+                    // Generic State Update (Decoupled from ListEngine)
+                    // @ts-ignore - access protected updateState
+                    if (typeof engine.updateState === 'function') {
+                        // @ts-ignore
+                        engine.updateState({ [config.bindTo]: data });
+                    }
+                    // Optional: Update loading state if the engine supports it
+                    // @ts-ignore
+                    if (typeof engine.loading === 'function')
+                        engine.loading(false);
+                    // Emit data event for loose coupling
+                    // @ts-ignore
+                    if (typeof engine.emit === 'function')
+                        engine.emit('plugin:data', { source: 'sqlite', count: data.length });
+                }
+            }
+            catch (err) {
+                console.error('[ServerSQLitePlugin] Hydration Error:', err.message);
+                // @ts-ignore
+                if (typeof engine.loading === 'function')
+                    engine.loading(false);
+            }
+        };
+        // 3. Auto-Start
+        if (config.autoLoad) {
+            // @ts-ignore
+            if (typeof engine.loading === 'function')
+                engine.loading(true);
+            hydrate();
+        }
+        // 4. Listen for Reload Signal
+        engine.on('db:reload', hydrate);
+    }
+});
+//# sourceMappingURL=ServerSQLitePlugin.js.map

package/lib/componentsv2/plugins/ServerSQLitePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerSQLitePlugin.js","sourceRoot":"","sources":["ServerSQLitePlugin.ts"],"names":[],"mappings":"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"}

package/lib/componentsv2/plugins/ServerSQLitePlugin.ts

@@ -0,0 +1,99 @@
+import { JuxServiceContract, BaseEngine } from '../base/BaseEngine.js';
+
+export interface ServerSQLiteConfig {
+    /** The Database Driver Instance (e.g. better-sqlite3) */
+    database: any;
+
+    /** Optional: SQL Query to fetch data automatically */
+    query?: string;
+
+    /** 
+     * State Binding: The property key on the Engine's state to populate.
+     * e.g., 'items' for a ListEngine, or 'rows' for a GridEngine.
+     */
+    bindTo?: string;
+
+    /**
+     * Transformation Strategy:
+     * Converts a raw DB row into the shape expected by the Engine's state.
+     */
+    mapRow?: (row: any) => any;
+
+    /** If true, runs the query immediately on install */
+    autoLoad?: boolean;
+}
+
+/**
+ * Server-Side SQLite Plugin
+ * Decoupled Service that injects SQL capabilities and binds data to ANY Engine state.
+ */
+export const ServerSQLitePlugin = (config: ServerSQLiteConfig): JuxServiceContract<BaseEngine<any>> => ({
+    name: 'server-sqlite-driver',
+    version: '2.0.0',
+    targetEnv: 'server',
+
+    install: (engine) => {
+        // 1. Expose SQL Capability (Mixin)
+        // Adds a .query() method to the engine instance
+        Object.assign(engine, {
+            query: (sql: string, params: any[] = []) => {
+                if (!config.database || typeof config.database.prepare !== 'function') {
+                    throw new Error('Invalid Database Driver provided to ServerSQLitePlugin.');
+                }
+                const stmt = config.database.prepare(sql);
+                const rows = stmt.all(params);
+
+                // Emit audit event for queries
+                // @ts-ignore - access protected emit
+                if (typeof engine.emit === 'function') engine.emit('sql:query', { sql, rows: rows.length });
+
+                return rows;
+            }
+        });
+
+        // 2. Hydration Logic
+        const hydrate = () => {
+            if (!config.query) return;
+
+            try {
+                // Use the newly injected capability
+                // @ts-ignore
+                const rows = engine.query(config.query);
+
+                if (config.bindTo) {
+                    const data = config.mapRow ? rows.map(config.mapRow) : rows;
+
+                    // Generic State Update (Decoupled from ListEngine)
+                    // @ts-ignore - access protected updateState
+                    if (typeof engine.updateState === 'function') {
+                        // @ts-ignore
+                        engine.updateState({ [config.bindTo]: data });
+                    }
+
+                    // Optional: Update loading state if the engine supports it
+                    // @ts-ignore
+                    if (typeof engine.loading === 'function') engine.loading(false);
+
+                    // Emit data event for loose coupling
+                    // @ts-ignore
+                    if (typeof engine.emit === 'function') engine.emit('plugin:data', { source: 'sqlite', count: data.length });
+                }
+
+            } catch (err: any) {
+                console.error('[ServerSQLitePlugin] Hydration Error:', err.message);
+                // @ts-ignore
+                if (typeof engine.loading === 'function') engine.loading(false);
+            }
+        };
+
+        // 3. Auto-Start
+        if (config.autoLoad) {
+            // @ts-ignore
+            if (typeof engine.loading === 'function') engine.loading(true);
+            hydrate();
+        }
+
+        // 4. Listen for Reload Signal
+        engine.on('db:reload', hydrate);
+    }
+});

package/lib/componentsv2/stubs/ComponentComposition.ts.stub

@@ -0,0 +1,32 @@
+import { [% ComponentName %]Engine, [% ComponentName %]Options } from './engine.js';
+import { [% ComponentName %]Skin } from './skin.js';
+
+export type [% ComponentName %]Component = [% ComponentName %]Engine & {
+    render: (targetId: string | HTMLElement) => [% ComponentName %]Component;
+    injectCSS: (id: string, cssContent: string) => void;
+};
+
+export function [% ComponentName %](id: string, options: [% ComponentName %]Options = {}): [% ComponentName %]Component {
+    const engine = new [% ComponentName %]Engine(id, options);
+
+    if (typeof window !== 'undefined') {
+        // @ts-ignore
+        window.juxEngines = window.juxEngines || {};
+        // @ts-ignore
+        window.juxEngines[id] = engine;
+    }
+
+    const skin = new [% ComponentName %]Skin(engine);
+
+    // @ts-ignore
+    engine.render = (targetId: string | HTMLElement) => {
+        const target = typeof targetId === 'string' ? document.getElementById(targetId) : targetId;
+        if (target) skin.renderSkin(target);
+        return engine as [% ComponentName %]Component;
+    };
+
+    // @ts-ignore
+    engine.injectCSS = (id, css) => skin.injectCSS(id, css);
+
+    return engine as [% ComponentName %]Component;
+}

package/lib/componentsv2/stubs/ComponentEngine.ts.stub

@@ -0,0 +1,36 @@
+import { BaseEngine, BaseState } from '../base/BaseEngine.js';
+
+export interface [% ComponentName %]State extends BaseState {
+    // TODO: Define your state properties
+    text: string;
+}
+
+export interface [% ComponentName %]Options {
+    // TODO: Define configuration options
+    text?: string;
+}
+
+export class [% ComponentName %]Engine extends BaseEngine<[% ComponentName %]State, [% ComponentName %]Options> {
+    constructor(id: string, options: [% ComponentName %]Options = {}) {
+        super(id, options);
+    }
+
+    protected prepareState(id: string, options: [% ComponentName %]Options): [% ComponentName %]State {
+        return {
+            id,
+            classes: ['jux-[% component-name %]'],
+            visible: true,
+            disabled: false,
+            loading: false,
+            attributes: {},
+            text: options.text || 'Hello World'
+        };
+    }
+
+    // Example Mutator
+    setText(value: string): this {
+        this.updateState({ text: value });
+        this.emit('textChange', { value });
+        return this;
+    }
+}

package/lib/componentsv2/stubs/ComponentSkin.ts.stub

@@ -0,0 +1,34 @@
+import { BaseSkin } from '../base/BaseSkin.js';
+import { [% ComponentName %]Engine, [% ComponentName %]State } from './engine.js';
+
+export class [% ComponentName %]Skin extends BaseSkin<[% ComponentName %]State, [% ComponentName %]Engine> {
+    constructor(engine: [% ComponentName %]Engine) {
+        super(engine);
+    }
+
+    /**
+     * Define the structural CSS for this component.
+     */
+    protected get structureCss(): string {
+        return new URL('./structure.css', import.meta.url).href;
+    }
+
+    protected bindEvents(root: HTMLElement): void {
+        // TODO: Bind DOM events to Engine methods
+        root.addEventListener('click', () => {
+            console.log('[% ComponentName %] clicked');
+        });
+    }
+
+    protected updateSkin(state: [% ComponentName %]State): void {
+        if (!this.root) return;
+        this.applySkinAttributes(this.root, state);
+        
+        // TODO: Render state to DOM
+        this.root.textContent = state.text;
+    }
+
+    protected createRoot(): HTMLElement {
+        return document.createElement('div');
+    }
+}

package/lib/componentsv2/stubs/ComponentStructure.css.stub

@@ -0,0 +1,13 @@
+.jux-[% component-name %] {
+    display: block;
+    padding: var(--space-md);
+    border: 1px solid var(--color-border);
+    border-radius: var(--radius-sm);
+    background-color: var(--color-surface-base);
+    color: var(--color-text-primary);
+    transition: all var(--transition-fast);
+}
+
+.jux-[% component-name %]:hover {
+    background-color: var(--color-surface-hover);
+}