juxscript 1.1.0 → 1.1.3

package/machinery/compiler3.js

@@ -0,0 +1,628 @@
+import * as esbuild from 'esbuild';
+import * as acorn from 'acorn';
+import { walk } from 'astray';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export class JuxCompiler {
+    constructor(config = {}) {
+        this.config = config;
+        this.srcDir = config.srcDir || './jux';
+        this.distDir = config.distDir || './.jux-dist';
+        this.layoutPath = config.layoutPath || null;
+        this.themePath = config.themePath || null;
+        this.defaults = config.defaults || {};
+        this.paths = config.paths || {};
+        this._juxscriptExports = null;
+        this._juxscriptPath = null;
+    }
+
+    /**
+     * Locate juxscript package - simplified resolution
+     */
+    findJuxscriptPath() {
+        if (this._juxscriptPath) return this._juxscriptPath;
+
+        const projectRoot = process.cwd();
+
+        // Priority 1: User's node_modules (when used as dependency)
+        const userPath = path.resolve(projectRoot, 'node_modules/juxscript/index.js');
+        if (fs.existsSync(userPath)) {
+            this._juxscriptPath = userPath;
+            return userPath;
+        }
+
+        // Priority 2: Package root (when developing juxscript itself)
+        const packageRoot = path.resolve(__dirname, '..');
+        const devPath = path.resolve(packageRoot, 'index.js');
+        if (fs.existsSync(devPath)) {
+            this._juxscriptPath = devPath;
+            return devPath;
+        }
+
+        // Priority 3: Sibling in monorepo
+        const monoPath = path.resolve(projectRoot, '../jux/index.js');
+        if (fs.existsSync(monoPath)) {
+            this._juxscriptPath = monoPath;
+            return monoPath;
+        }
+
+        return null;
+    }
+
+    scanFiles() {
+        const files = fs.readdirSync(this.srcDir)
+            .filter(f => (f.endsWith('.jux') || f.endsWith('.js')) && !this.isAssetFile(f));
+
+        const views = [], dataModules = [], sharedModules = [];
+
+        files.forEach(file => {
+            const content = fs.readFileSync(path.join(this.srcDir, file), 'utf8');
+            const name = file.replace(/\.[^/.]+$/, '');
+
+            if (file.includes('data')) {
+                dataModules.push({ name, file, content });
+            } else if (/export\s+(function|const|let|var|class)\s+/.test(content)) {
+                sharedModules.push({ name, file, content });
+            } else {
+                views.push({ name, file, content });
+            }
+        });
+
+        return { views, dataModules, sharedModules };
+    }
+
+    isAssetFile(filename) {
+        const assetExtensions = ['.css', '.png', '.jpg', '.jpeg', '.gif', '.svg', '.woff', '.woff2', '.ttf', '.eot'];
+        return assetExtensions.some(ext => filename.endsWith(ext));
+    }
+
+    removeImports(code) {
+        return code
+            .replace(/^\s*import\s+.*?from\s+['"][^'"]+['"][\s;]*$/gm, '')
+            .replace(/^\s*import\s*\{[\s\S]*?\}\s*from\s*['"][^'"]+['"][\s;]*/gm, '')
+            .replace(/^\s*import\s+\w+\s+from\s+['"][^'"]+['"][\s;]*$/gm, '')
+            .replace(/^\s*import\s*;?\s*$/gm, '');
+    }
+
+    sanitizeName(name) {
+        return name.replace(/[^a-zA-Z0-9]/g, '_');
+    }
+
+    /**
+     * Copy all source assets (themes, layouts, assets folders) to dist
+     */
+    copySourceAssets() {
+        const copied = { themes: 0, layouts: 0, assets: 0, other: 0 };
+
+        const copyDir = (srcDir, destDir, category) => {
+            if (!fs.existsSync(srcDir)) return 0;
+
+            let count = 0;
+            fs.mkdirSync(destDir, { recursive: true });
+
+            const entries = fs.readdirSync(srcDir, { withFileTypes: true });
+            for (const entry of entries) {
+                const srcPath = path.join(srcDir, entry.name);
+                const destPath = path.join(destDir, entry.name);
+
+                if (entry.isDirectory()) {
+                    count += copyDir(srcPath, destPath, category);
+                } else {
+                    fs.copyFileSync(srcPath, destPath);
+                    count++;
+                }
+            }
+            return count;
+        };
+
+        // Copy themes folder
+        if (this.paths.themes && fs.existsSync(this.paths.themes)) {
+            copied.themes = copyDir(this.paths.themes, path.join(this.distDir, 'themes'), 'themes');
+        }
+
+        // Copy layouts folder (if separate from themes)
+        if (this.paths.layouts && fs.existsSync(this.paths.layouts) && this.paths.layouts !== this.paths.themes) {
+            copied.layouts = copyDir(this.paths.layouts, path.join(this.distDir, 'layouts'), 'layouts');
+        }
+
+        // Copy assets folder
+        if (this.paths.assets && fs.existsSync(this.paths.assets)) {
+            copied.assets = copyDir(this.paths.assets, path.join(this.distDir, 'assets'), 'assets');
+        }
+
+        const total = copied.themes + copied.layouts + copied.assets;
+        if (total > 0) {
+            console.log(`📂 Copied source assets: ${copied.themes} themes, ${copied.layouts} layouts, ${copied.assets} assets`);
+        }
+
+        return copied;
+    }
+
+    /**
+     * Generate CSS links including theme if configured
+     */
+    generateCssLinks() {
+        const links = [];
+
+        // Note: Component CSS is no longer bundled (handled by Styler)
+
+        // User theme CSS
+        if (this.themePath) {
+            const themeName = path.basename(this.themePath);
+            links.push(`    <link rel="stylesheet" href="./themes/${themeName}" id="jux-theme">`);
+            console.log(`🎨 🎨 🎨 🎨 Included theme: ${themeName} 🎨 🎨 🎨 🎨 `);
+        }
+
+        return links.join('\n');
+    }
+
+    async loadJuxscriptExports() {
+        if (this._juxscriptExports) return this._juxscriptExports;
+
+        try {
+            const juxscriptPath = this.findJuxscriptPath();
+            if (juxscriptPath) {
+                const indexContent = fs.readFileSync(juxscriptPath, 'utf8');
+                const exports = new Set();
+
+                for (const match of indexContent.matchAll(/export\s*\{\s*([^}]+)\s*\}/g)) {
+                    match[1].split(',').forEach(exp => {
+                        const name = exp.trim().split(/\s+as\s+/)[0].trim();
+                        if (name) exports.add(name);
+                    });
+                }
+
+                this._juxscriptExports = [...exports];
+                if (this._juxscriptExports.length > 0) {
+                    console.log(`📦 juxscript exports: ${this._juxscriptExports.join(', ')}`);
+                }
+            }
+        } catch (err) {
+            this._juxscriptExports = [];
+        }
+
+        return this._juxscriptExports;
+    }
+
+    validateViewCode(viewName, code) {
+        const issues = [];
+
+        let ast;
+        try {
+            ast = acorn.parse(code, { ecmaVersion: 'latest', sourceType: 'module', locations: true });
+        } catch (parseError) {
+            issues.push({
+                type: 'error',
+                view: viewName,
+                line: parseError.loc?.line || 0,
+                message: `Syntax error: ${parseError.message}`,
+                code: ''
+            });
+            return issues;
+        }
+
+        const allImports = new Set();
+
+        walk(ast, {
+            ImportDeclaration(node) {
+                node.specifiers.forEach(spec => {
+                    allImports.add(spec.local.name);
+                });
+            }
+        });
+
+        // Default known facades/components if load fails
+        const knownComponents = this._juxscriptExports || ['element', 'input', 'buttonGroup'];
+
+        walk(ast, {
+            Identifier(node, parent) {
+                if (parent?.type === 'CallExpression' && parent.callee === node) {
+                    const name = node.name;
+                    // Updated: Removed strict Capitalization check to allow facades (lowercase)
+                    if (!allImports.has(name) && knownComponents.includes(name)) {
+                        issues.push({
+                            type: 'warning',
+                            view: viewName,
+                            line: node.loc?.start?.line || 0,
+                            message: `"${name}" is used but not imported from juxscript`,
+                            code: ''
+                        });
+                    }
+                }
+            }
+        });
+
+        return issues;
+    }
+
+    /**
+     * Extract layout function name from layout file
+     */
+    getLayoutFunctionName() {
+        if (!this.layoutPath || !fs.existsSync(this.layoutPath)) return null;
+
+        const content = fs.readFileSync(this.layoutPath, 'utf8');
+        const match = content.match(/export\s+function\s+(\w+)/);
+        return match ? match[1] : null;
+    }
+
+    generateEntryPoint(views, dataModules, sharedModules) {
+        let entry = `// Auto-generated JUX entry point\n\n`;
+        const allIssues = [];
+        const sourceSnapshot = {};
+
+        const juxImports = new Set();
+        [...views, ...dataModules, ...sharedModules].forEach(m => {
+            for (const match of m.content.matchAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*['"]juxscript['"]/g)) {
+                match[1].split(',').map(s => s.trim()).forEach(imp => {
+                    if (imp) juxImports.add(imp);
+                });
+            }
+        });
+
+        // Check layout file for juxscript imports too
+        if (this.layoutPath && fs.existsSync(this.layoutPath)) {
+            const layoutContent = fs.readFileSync(this.layoutPath, 'utf8');
+            for (const match of layoutContent.matchAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*['"]juxscript['"]/g)) {
+                match[1].split(',').map(s => s.trim()).forEach(imp => {
+                    if (imp) juxImports.add(imp);
+                });
+            }
+        }
+
+        if (juxImports.size > 0) {
+            entry += `import { ${[...juxImports].sort().join(', ')} } from 'juxscript';\n\n`;
+        }
+
+        dataModules.forEach(m => {
+            entry += `import * as ${this.sanitizeName(m.name)}Data from './jux/${m.file}';\n`;
+        });
+        sharedModules.forEach(m => {
+            entry += `import * as ${this.sanitizeName(m.name)}Shared from './jux/${m.file}';\n`;
+        });
+
+        entry += `\n// Expose to window\n`;
+        dataModules.forEach(m => entry += `Object.assign(window, ${this.sanitizeName(m.name)}Data);\n`);
+        sharedModules.forEach(m => entry += `Object.assign(window, ${this.sanitizeName(m.name)}Shared);\n`);
+
+        if (juxImports.size > 0) {
+            entry += `\nObject.assign(window, { ${[...juxImports].join(', ')} });\n`;
+        }
+
+        // Add layout function if configured
+        const layoutFnName = this.getLayoutFunctionName();
+        if (layoutFnName && this.layoutPath) {
+            const layoutContent = fs.readFileSync(this.layoutPath, 'utf8');
+            const layoutCode = this.removeImports(layoutContent);
+            entry += `\n// --- DEFAULT LAYOUT ---\n`;
+            entry += layoutCode;
+            entry += `\n`;
+
+            // Store in source snapshot
+            const layoutFile = path.basename(this.layoutPath);
+            sourceSnapshot[layoutFile] = {
+                name: 'layout',
+                file: layoutFile,
+                content: layoutContent,
+                lines: layoutContent.split('\n')
+            };
+        }
+
+        entry += `\n// --- VIEW FUNCTIONS ---\n`;
+
+        views.forEach(v => {
+            const capitalized = v.name.charAt(0).toUpperCase() + v.name.slice(1);
+            allIssues.push(...this.validateViewCode(v.name, v.content));
+
+            sourceSnapshot[v.file] = {
+                name: v.name,
+                file: v.file,
+                content: v.content,
+                lines: v.content.split('\n')
+            };
+
+            let viewCode = this.removeImports(v.content).replace(/^\s*export\s+default\s+.*$/gm, '');
+            const asyncPrefix = viewCode.includes('await ') ? 'async ' : '';
+
+            entry += `\n${asyncPrefix}function render${capitalized}() {\n${viewCode}\n}\n`;
+        });
+
+        dataModules.forEach(m => {
+            sourceSnapshot[m.file] = { name: m.name, file: m.file, content: m.content, lines: m.content.split('\n') };
+        });
+        sharedModules.forEach(m => {
+            sourceSnapshot[m.file] = { name: m.name, file: m.file, content: m.content, lines: m.content.split('\n') };
+        });
+
+        this._sourceSnapshot = sourceSnapshot;
+        this._validationIssues = allIssues;
+        this._layoutFnName = layoutFnName;
+        entry += this._generateRouter(views);
+        return entry;
+    }
+
+    reportValidationIssues() {
+        const issues = this._validationIssues || [];
+        const errors = issues.filter(i => i.type === 'error');
+        const warnings = issues.filter(i => i.type === 'warning');
+
+        if (issues.length > 0) {
+            console.log('\n⚠️  Validation Issues:\n');
+            issues.forEach(issue => {
+                const icon = issue.type === 'error' ? '❌' : '⚠️';
+                console.log(`${icon} [${issue.view}:${issue.line}] ${issue.message}`);
+            });
+            console.log('');
+        }
+
+        return { isValid: errors.length === 0, errors, warnings };
+    }
+
+    _generateRouter(views) {
+        let routeMap = '';
+        views.forEach(v => {
+            const cap = v.name.charAt(0).toUpperCase() + v.name.slice(1);
+            if (v.name.toLowerCase() === 'index') routeMap += `  '/': render${cap},\n`;
+            routeMap += `  '/${v.name.toLowerCase()}': render${cap},\n`;
+        });
+
+        // Initialize layout call if configured
+        const layoutInit = this._layoutFnName
+            ? `\n// Initialize default layout\nif (typeof ${this._layoutFnName} === 'function') {\n    ${this._layoutFnName}();\n}\n`
+            : '';
+
+        return `
+// --- JUX SOURCE LOADER ---
+var __juxSources = null;
+async function __juxLoadSources() {
+    if (__juxSources) return __juxSources;
+    try {
+        var res = await fetch('/__jux_sources.json');
+        __juxSources = await res.json();
+    } catch (e) {
+        __juxSources = {};
+    }
+    return __juxSources;
+}
+
+function __juxFindSource(stack) {
+    var match = stack.match(/render(\\w+)/);
+    if (match) {
+        var viewName = match[1].toLowerCase();
+        for (var file in __juxSources || {}) {
+            if (__juxSources[file].name.toLowerCase() === viewName) {
+                return { file: file, source: __juxSources[file], viewName: match[1] };
+            }
+        }
+    }
+    // Also check for layout
+    if (stack.indexOf('Layout') > -1) {
+        for (var file in __juxSources || {}) {
+            if (file.indexOf('layout') > -1) {
+                return { file: file, source: __juxSources[file] };
+            }
+        }
+    }
+    return null;
+}
+
+// --- JUX RUNTIME ERROR OVERLAY ---
+var __juxErrorOverlay = {
+    styles: \`
+        #__jux-error-overlay {
+            position: fixed; inset: 0; z-index: 99999;
+            background: rgba(0, 0, 0, 0.4);
+            display: flex; align-items: center; justify-content: center;
+            font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, monospace;
+            opacity: 0; transition: opacity 0.2s ease-out; backdrop-filter: blur(2px);
+        }
+        #__jux-error-overlay.visible { opacity: 1; }
+        #__jux-error-overlay * { box-sizing: border-box; }
+        .__jux-modal {
+            background: #f8f9fa; border-radius: 4px;
+            box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.4);
+            max-width: 80vw; width: 90%; max-height: 90vh;
+            overflow: hidden; display: flex; flex-direction: column;
+            transform: translateY(10px); transition: transform 0.2s ease-out;
+        }
+        #__jux-error-overlay.visible .__jux-modal { transform: translateY(0); }
+        .__jux-header { background: #fff; padding: 20px 24px; border-bottom: 1px solid #e5e7eb; }
+        .__jux-header h3 { margin: 0 0 6px; font-weight: 600; font-size: 11px; color: #9ca3af; text-transform: uppercase; }
+        .__jux-header h1 { margin: 0 0 8px; font-size: 18px; font-weight: 600; color: #dc2626; line-height: 1.3; }
+        .__jux-header .file-info { color: #6b7280; font-size: 13px; }
+        .__jux-header .file-info strong { color: #dc2626; font-weight: 600; }
+        .__jux-source { padding: 16px 24px; overflow: auto; flex: 1; background: #f8f9fa; }
+        .__jux-code { background: #fff; border-radius: 8px; overflow: hidden; border: 1px solid #e5e7eb; }
+        .__jux-code-line { display: flex; font-size: 13px; line-height: 1.7; }
+        .__jux-code-line.error { background: #fef2f2; }
+        .__jux-code-line.error .__jux-line-code { color: #dc2626; font-weight: 500; }
+        .__jux-code-line.context { background: #fefce8; }
+        .__jux-line-num { min-width: 44px; padding: 4px 12px; text-align: right; color: #9ca3af; background: #f9fafb; border-right: 1px solid #e5e7eb; font-size: 12px; }
+        .__jux-code-line.error .__jux-line-num { background: #fef2f2; color: #dc2626; }
+        .__jux-line-code { flex: 1; padding: 4px 16px; color: #374151; white-space: pre; overflow-x: auto; }
+        .__jux-footer { padding: 16px 24px; background: #fff; border-top: 1px solid #e5e7eb; display: flex; justify-content: space-between; align-items: center; }
+        .__jux-tip { color: #6b7280; font-size: 12px; }
+        .__jux-dismiss { background: #f3f4f6; color: #374151; border: 1px solid #d1d5db; padding: 8px 16px; border-radius: 6px; cursor: pointer; font-size: 13px; font-weight: 500; }
+        .__jux-dismiss:hover { background: #e5e7eb; }
+        .__jux-no-source { color: #6b7280; padding: 24px; text-align: center; }
+        .__jux-no-source pre { background: #fff; padding: 16px; border-radius: 8px; margin-top: 16px; font-size: 11px; color: #6b7280; overflow-x: auto; text-align: left; border: 1px solid #e5e7eb; }
+    \`,
+
+    show: async function(error, title) {
+        title = title || 'Runtime Error';
+        var existing = document.getElementById('__jux-error-overlay');
+        if (existing) existing.remove();
+        await __juxLoadSources();
+        
+        var overlay = document.createElement('div');
+        overlay.id = '__jux-error-overlay';
+        var stack = error && error.stack ? error.stack : '';
+        var msg = error && error.message ? error.message : String(error);
+        var found = __juxFindSource(stack);
+        var sourceHtml = '', fileInfo = '';
+        
+        if (found && found.source && found.source.lines) {
+            var lines = found.source.lines;
+            fileInfo = '<span class="file-info">in <strong>' + found.file + '</strong></span>';
+            var errorLineIndex = -1;
+            var errorMethod = msg.match(/\\.([a-zA-Z]+)\\s*is not a function/);
+            if (errorMethod) {
+                for (var i = 0; i < lines.length; i++) {
+                    if (lines[i].indexOf('.' + errorMethod[1]) > -1) { errorLineIndex = i; break; }
+                }
+            }
+            if (errorLineIndex === -1) {
+                for (var i = 0; i < lines.length; i++) {
+                    if (lines[i].indexOf('throw ') > -1) { errorLineIndex = i; break; }
+                }
+            }
+            var contextStart = Math.max(0, errorLineIndex - 3);
+            var contextEnd = Math.min(lines.length - 1, errorLineIndex + 5);
+            if (errorLineIndex === -1) { contextStart = 0; contextEnd = Math.min(14, lines.length - 1); }
+            
+            for (var i = contextStart; i <= contextEnd; i++) {
+                var isError = (i === errorLineIndex);
+                var isContext = !isError && errorLineIndex > -1 && Math.abs(i - errorLineIndex) <= 2;
+                var lineClass = isError ? ' error' : (isContext ? ' context' : '');
+                var lineCode = lines[i].replace(/</g, '&lt;').replace(/>/g, '&gt;') || ' ';
+                sourceHtml += '<div class="__jux-code-line' + lineClass + '"><span class="__jux-line-num">' + (i + 1) + '</span><span class="__jux-line-code">' + lineCode + '</span></div>';
+            }
+        } else {
+            sourceHtml = '<div class="__jux-no-source"><p>Could not locate source file.</p><pre>' + stack + '</pre></div>';
+        }
+        
+        overlay.innerHTML = '<style>' + this.styles + '</style><div class="__jux-modal"><div class="__jux-header"><h3>' + title + '</h3><h1>' + msg + '</h1>' + fileInfo + '</div><div class="__jux-source"><div class="__jux-code">' + sourceHtml + '</div></div><div class="__jux-footer"><span class="__jux-tip">💡 Fix the error and save to reload</span><button class="__jux-dismiss" onclick="document.getElementById(\\'__jux-error-overlay\\').remove()">Dismiss</button></div></div>';
+        document.body.appendChild(overlay);
+        requestAnimationFrame(function() { overlay.classList.add('visible'); });
+        console.error(title + ':', error);
+    }
+};
+
+window.addEventListener('error', function(e) { __juxErrorOverlay.show(e.error || new Error(e.message), 'Uncaught Error'); }, true);
+window.addEventListener('unhandledrejection', function(e) { __juxErrorOverlay.show(e.reason || new Error('Promise rejected'), 'Unhandled Promise Rejection'); }, true);
+
+// --- JUX ROUTER ---
+const routes = {\n${routeMap}};
+${layoutInit}
+async function navigate(path) {
+    const view = routes[path];
+    if (!view) {
+        document.getElementById('app').innerHTML = '<h1 style="padding:40px;">404 - Not Found</h1>';
+        return;
+    }
+    document.getElementById('app').innerHTML = '';
+    var overlay = document.getElementById('__jux-error-overlay');
+    if (overlay) overlay.remove();
+    try { await view(); } catch (err) { __juxErrorOverlay.show(err, 'Jux Render Error'); }
+}
+
+document.addEventListener('click', e => {
+    const a = e.target.closest('a');
+    if (!a || a.dataset.router === 'false') return;
+    try { if (new URL(a.href, location.origin).origin !== location.origin) return; } catch { return; }
+    e.preventDefault();
+    history.pushState({}, '', a.href);
+    navigate(new URL(a.href, location.origin).pathname);
+});
+
+window.addEventListener('popstate', () => navigate(location.pathname));
+navigate(location.pathname);
+`;
+    }
+
+    async build() {
+        console.log('🚀 JUX Build\n');
+
+        const juxscriptPath = this.findJuxscriptPath();
+        if (!juxscriptPath) {
+            console.error('❌ Could not locate juxscript package');
+            return { success: false, errors: [{ message: 'juxscript not found' }], warnings: [] };
+        }
+        console.log(`📦 Using: ${juxscriptPath}`);
+
+        await this.loadJuxscriptExports();
+
+        if (fs.existsSync(this.distDir)) {
+            fs.rmSync(this.distDir, { recursive: true, force: true });
+        }
+        fs.mkdirSync(this.distDir, { recursive: true });
+
+        const { views, dataModules, sharedModules } = this.scanFiles();
+        console.log(`📁 Found ${views.length} views, ${sharedModules.length} shared, ${dataModules.length} data`);
+
+        // Copy source assets (themes, layouts, assets)
+        this.copySourceAssets();
+
+        // Copy data/shared modules to dist
+        const juxDistDir = path.join(this.distDir, 'jux');
+        fs.mkdirSync(juxDistDir, { recursive: true });
+        [...dataModules, ...sharedModules].forEach(m => {
+            fs.writeFileSync(path.join(juxDistDir, m.file), m.content);
+        });
+
+        const entryContent = this.generateEntryPoint(views, dataModules, sharedModules);
+        const entryPath = path.join(this.distDir, 'entry.js');
+        fs.writeFileSync(entryPath, entryContent);
+
+        const snapshotPath = path.join(this.distDir, '__jux_sources.json');
+        fs.writeFileSync(snapshotPath, JSON.stringify(this._sourceSnapshot, null, 2));
+        console.log(`📸 Source snapshot written`);
+
+        const validation = this.reportValidationIssues();
+        if (!validation.isValid) {
+            console.log('🛑 BUILD FAILED\n');
+            return { success: false, errors: validation.errors, warnings: validation.warnings };
+        }
+
+        try {
+            await esbuild.build({
+                entryPoints: [entryPath],
+                bundle: true,
+                outfile: path.join(this.distDir, 'bundle.js'),
+                format: 'esm',
+                platform: 'browser',
+                target: 'esnext',
+                sourcemap: true,
+                loader: { '.jux': 'js', '.css': 'empty' },
+                plugins: [{
+                    name: 'juxscript-resolver',
+                    setup: (build) => {
+                        build.onResolve({ filter: /^juxscript$/ }, () => ({ path: juxscriptPath }));
+                    }
+                }],
+            });
+            console.log('✅ esbuild complete');
+        } catch (err) {
+            console.error('❌ esbuild failed:', err);
+            return { success: false, errors: [{ message: err.message }], warnings: [] };
+        }
+
+        // Generate HTML with layout container sibling to app
+        const html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>JUX App</title>
+    <script type="module" src="./bundle.js"></script>
+</head>
+<body>
+     <div id="jux-layout">
+        <div id="app"></div>
+     </div>
+</body>
+</html>`;
+        fs.writeFileSync(path.join(this.distDir, 'index.html'), html);
+
+        fs.unlinkSync(entryPath);
+        fs.rmSync(juxDistDir, { recursive: true, force: true });
+
+        console.log(`\n✅ Build Complete!\n`);
+        return { success: true, errors: [], warnings: validation.warnings };
+    }
+}