juxscript 1.0.132 → 1.1.0

package/lib/componentsv2/plugins/ServerSQLitePlugin.d.ts

@@ -1,25 +0,0 @@
-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 declare const ServerSQLitePlugin: (config: ServerSQLiteConfig) => JuxServiceContract<BaseEngine<any>>;
-//# sourceMappingURL=ServerSQLitePlugin.d.ts.map

package/lib/componentsv2/plugins/ServerSQLitePlugin.js

@@ -1,70 +0,0 @@
-/**
- * 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/stubs/ComponentComposition.ts.stub

@@ -1,32 +0,0 @@
-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

@@ -1,36 +0,0 @@
-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

@@ -1,35 +0,0 @@
-import { BaseSkin } from '../base/BaseSkin.js';
-import { [% ComponentName %]Engine, [% ComponentName %]State } from './engine.js';
-import structureCss from './structure.css';
-
-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 structureCss;
-    }
-
-    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.d.ts.stub

@@ -1,2 +0,0 @@
-declare const styles: string;
-export default styles;

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

@@ -1,13 +0,0 @@
-.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);
-}

package/lib/utils/fetch.d.ts

@@ -1,176 +0,0 @@
-/**
- * Jux Fetch Utility
- *
- * A lightweight fetch wrapper with sensible defaults, error handling, and method chaining.
- * Includes configuration helpers for juxconfig.js integration.
- *
- * Usage:
- *   // Configure once (optional)
- *   jux.fetch.config({
- *     baseUrl: 'https://api.example.com',
- *     credentials: 'include',
- *     timeout: 10000,
- *     log: 'errors',
- *     onUnauthorized: () => window.location.href = '/login'
- *   });
- *
- *   // Simple GET
- *   const { data, error } = await jux.fetch('/users').send();
- *
- *   // Method chaining
- *   const { data, error } = await jux.fetch('/users')
- *     .method('POST')
- *     .body({ name: 'John' })
- *     .params({ limit: 10 })
- *     .timeout(5000)
- *     .log(true)
- *     .send();
- *
- *   // With juxconfig services
- *   const { data } = await jux.fetch('/users')
- *     .baseUrl(jux.fetch.getServiceUrl('database'))
- *     .send();
- *
- *   // Service client helper
- *   const db = jux.fetch.serviceClient('database');
- *   const { data } = await db.fetch('/users').send();
- */
-export type LogLevel = boolean | 'errors';
-export interface FetchConfig {
-    baseUrl?: string;
-    credentials?: RequestCredentials;
-    headers?: Record<string, string>;
-    timeout?: number;
-    log?: LogLevel;
-    onUnauthorized?: () => void;
-    onError?: (error: FetchError) => void;
-}
-export interface FetchOptions extends Omit<RequestInit, 'body'> {
-    params?: Record<string, any>;
-    body?: any;
-    timeout?: number;
-    log?: LogLevel;
-    onUnauthorized?: () => void;
-    onError?: (error: FetchError) => void;
-    parseResponse?: boolean;
-}
-export interface FetchError {
-    message: string;
-    status?: number;
-    statusText?: string;
-    data?: any;
-}
-export interface FetchResult<T = any> {
-    data: T | null;
-    error: FetchError | null;
-    status: number;
-    response: Response;
-}
-/**
- * Configure global fetch defaults
- */
-export declare function configureFetch(config: FetchConfig): void;
-/**
- * FetchBuilder class for method chaining
- */
-declare class FetchBuilder<T = any> {
-    url: string;
-    options: FetchOptions;
-    constructor(url: string, options?: FetchOptions);
-    method(value: string): this;
-    body(value: any): this;
-    params(value: Record<string, any>): this;
-    headers(value: Record<string, string>): this;
-    header(key: string, value: string): this;
-    timeout(value: number): this;
-    credentials(value: RequestCredentials): this;
-    log(value: LogLevel): this;
-    parseResponse(value: boolean): this;
-    onUnauthorized(callback: () => void): this;
-    onError(callback: (error: FetchError) => void): this;
-    /**
-     * Execute the fetch request
-     */
-    send(): Promise<FetchResult<T>>;
-    /**
-     * Alias for send()
-     */
-    fetch(): Promise<FetchResult<T>>;
-    /**
-     * Make the builder thenable (Promise-like) so it can be awaited directly
-     * This allows: await jux.fetch('/users') without needing .send()
-     */
-    then<TResult1 = FetchResult<T>, TResult2 = never>(onfulfilled?: ((value: FetchResult<T>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
-    /**
-     * Make the builder catchable for Promise.catch()
-     */
-    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null): Promise<FetchResult<T> | TResult>;
-    /**
-     * Make the builder finally-able for Promise.finally()
-     */
-    finally(onfinally?: (() => void) | null): Promise<FetchResult<T>>;
-}
-/**
- * Create a fetch builder
- */
-export declare function juxFetch<T = any>(url: string, options?: FetchOptions): FetchBuilder<T>;
-/**
- * Convenience methods for common HTTP verbs
- */
-export declare const fetchHelpers: {
-    get: <T = any>(url: string, options?: Omit<FetchOptions, "method">) => FetchBuilder<T>;
-    post: <T = any>(url: string, body?: any, options?: Omit<FetchOptions, "method" | "body">) => FetchBuilder<T>;
-    put: <T = any>(url: string, body?: any, options?: Omit<FetchOptions, "method" | "body">) => FetchBuilder<T>;
-    patch: <T = any>(url: string, body?: any, options?: Omit<FetchOptions, "method" | "body">) => FetchBuilder<T>;
-    delete: <T = any>(url: string, options?: Omit<FetchOptions, "method">) => FetchBuilder<T>;
-};
-/**
- * Fetch multiple URLs in parallel
- */
-export declare function fetchAll<T = any>(urls: string[], options?: FetchOptions): Promise<FetchResult<T>[]>;
-/**
- * Get a service URL from window.juxConfig
- */
-export declare function getServiceUrl(serviceName: string): string | null;
-/**
- * Create a fetch instance preconfigured for a specific service
- *
- * Usage:
- *   const api = jux.fetch.serviceClient('database');
- *   const { data } = await api.fetch('/users').send();
- */
-export declare function serviceClient(serviceName: string): {
-    fetch: (url: string, options?: any) => FetchBuilder<any>;
-    baseUrl: string | null;
-};
-/**
- * Setup fetch from juxconfig
- * Call this in your bootstrap function
- *
- * Usage:
- *   export default {
- *     bootstrap: [
- *       async function initFetch() {
- *         await jux.fetch.setupConfig();
- *       }
- *     ]
- *   };
- */
-export declare function setupConfig(): Promise<{
-    services: any;
-    getServiceUrl: typeof getServiceUrl;
-} | undefined>;
-export declare const fetchAPI: typeof juxFetch & {
-    all: typeof fetchAll;
-    get: <T = any>(url: string, options?: Omit<FetchOptions, "method">) => FetchBuilder<T>;
-    post: <T = any>(url: string, body?: any, options?: Omit<FetchOptions, "method" | "body">) => FetchBuilder<T>;
-    put: <T = any>(url: string, body?: any, options?: Omit<FetchOptions, "method" | "body">) => FetchBuilder<T>;
-    patch: <T = any>(url: string, body?: any, options?: Omit<FetchOptions, "method" | "body">) => FetchBuilder<T>;
-    delete: <T = any>(url: string, options?: Omit<FetchOptions, "method">) => FetchBuilder<T>;
-    config: typeof configureFetch;
-    setupConfig: typeof setupConfig;
-    getServiceUrl: typeof getServiceUrl;
-    serviceClient: typeof serviceClient;
-};
-export {};
-//# sourceMappingURL=fetch.d.ts.map

package/machinery/build3.js

@@ -1,159 +0,0 @@
-import { JuxCompiler } from './compiler3.js';
-import path from 'path';
-import fs from 'fs';
-
-const PROJECT_ROOT = process.cwd();
-
-// ═══════════════════════════════════════════════════════════════
-// LOAD CONFIG
-// ═══════════════════════════════════════════════════════════════
-const JUX_CONFIG_PATH = path.resolve(PROJECT_ROOT, 'juxconfig.js');
-let rawConfig = {};
-
-try {
-    rawConfig = (await import(JUX_CONFIG_PATH)).config;
-    console.log(`⚙️  Loaded config: ${JUX_CONFIG_PATH}`);
-} catch (err) {
-    console.warn(`⚠️  No juxconfig.js found, using defaults`);
-}
-
-// ═══════════════════════════════════════════════════════════════
-// EXPLODE CONFIG INTO NAMED OBJECTS
-// ═══════════════════════════════════════════════════════════════
-const directories = {
-    source: rawConfig.directories?.source || './jux',
-    distribution: rawConfig.directories?.distribution || './.jux-dist',
-    themes: rawConfig.directories?.themes || './themes',
-    layouts: rawConfig.directories?.layouts || './themes/layouts',
-    assets: rawConfig.directories?.assets || './themes/assets'
-};
-
-const defaults = {
-    httpPort: rawConfig.defaults?.httpPort || 3000,
-    wsPort: rawConfig.defaults?.wsPort || 3001,
-    autoRoute: rawConfig.defaults?.autoRoute ?? true,
-    layout: rawConfig.defaults?.layout || null,
-    theme: rawConfig.defaults?.theme || null
-};
-
-// Resolve absolute paths
-const paths = {
-    source: path.resolve(PROJECT_ROOT, directories.source),
-    distribution: path.resolve(PROJECT_ROOT, directories.distribution),
-    themes: path.resolve(PROJECT_ROOT, directories.source, directories.themes),
-    layouts: path.resolve(PROJECT_ROOT, directories.source, directories.layouts),
-    assets: path.resolve(PROJECT_ROOT, directories.source, directories.assets)
-};
-
-// ═══════════════════════════════════════════════════════════════
-// VALIDATE DIRECTORIES
-// ═══════════════════════════════════════════════════════════════
-console.log(`\n📁 Directory Check:`);
-
-const dirStatus = {};
-for (const [name, dirPath] of Object.entries(paths)) {
-    if (name === 'distribution') continue;
-
-    const exists = fs.existsSync(dirPath);
-    dirStatus[name] = exists;
-
-    const icon = exists ? '✓' : '✗';
-    const suffix = exists ? '' : ' (will be skipped)';
-    console.log(`   ${icon} ${name}: ${dirPath}${suffix}`);
-}
-
-// ═══════════════════════════════════════════════════════════════
-// RESOLVE DEFAULT LAYOUT & THEME
-// ═══════════════════════════════════════════════════════════════
-function resolveFile(filename, ...searchPaths) {
-    if (!filename) return null;
-
-    // First try the filename as-is
-    if (fs.existsSync(filename)) {
-        return path.resolve(filename);
-    }
-
-    // Try each search path
-    for (const searchPath of searchPaths) {
-        if (!searchPath || !fs.existsSync(searchPath)) continue;
-
-        const fullPath = path.resolve(searchPath, filename);
-        if (fs.existsSync(fullPath)) {
-            return fullPath;
-        }
-    }
-
-    return null;
-}
-
-console.log(`\n🎨 Defaults Resolution:`);
-
-// Resolve layout
-const layoutPath = defaults.layout ? resolveFile(
-    defaults.layout,
-    paths.layouts,
-    paths.source,
-    PROJECT_ROOT
-) : null;
-
-if (defaults.layout) {
-    if (layoutPath) {
-        console.log(`   ✓ layout: ${layoutPath}`);
-    } else {
-        console.log(`   ✗ layout: "${defaults.layout}" not found, will be skipped`);
-    }
-} else {
-    console.log(`   - layout: not configured`);
-}
-
-// Resolve theme
-const themePath = defaults.theme ? resolveFile(
-    defaults.theme,
-    paths.themes,
-    paths.source,
-    PROJECT_ROOT
-) : null;
-
-if (defaults.theme) {
-    if (themePath) {
-        console.log(`   ✓ theme: ${themePath}`);
-    } else {
-        console.log(`   ✗ theme: "${defaults.theme}" not found, will be skipped`);
-    }
-} else {
-    console.log(`   - theme: not configured`);
-}
-
-// ═══════════════════════════════════════════════════════════════
-// VALIDATE SOURCE DIRECTORY EXISTS
-// ═══════════════════════════════════════════════════════════════
-if (!dirStatus.source) {
-    console.error(`\n❌ Source directory not found: ${paths.source}`);
-    console.error(`   Create the directory or update juxconfig.js`);
-    process.exit(1);
-}
-
-// ═══════════════════════════════════════════════════════════════
-// RUN BUILD
-// ═══════════════════════════════════════════════════════════════
-console.log(`\n`);
-
-const compiler = new JuxCompiler({
-    srcDir: paths.source,
-    distDir: paths.distribution,
-    layoutPath,
-    themePath,
-    defaults,
-    paths
-});
-
-compiler.build()
-    .then(result => {
-        if (!result.success) {
-            process.exit(1);
-        }
-    })
-    .catch(err => {
-        console.error('❌ Build failed:', err.message);
-        process.exit(1);
-    });