juxscript 1.0.89 → 1.0.91

package/machinery/compiler3.js

@@ -0,0 +1,638 @@
+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._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;
+    }
+
+    /**
+     * Get the components directory for CSS copying
+     */
+    getComponentsDir() {
+        const juxPath = this.findJuxscriptPath();
+        if (!juxPath) return null;
+        return path.resolve(path.dirname(juxPath), 'lib/componentsv2');
+    }
+
+    scanFiles() {
+        const files = fs.readdirSync(this.srcDir)
+            .filter(f => f.endsWith('.jux') || f.endsWith('.js'));
+
+        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 };
+    }
+
+    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, '_');
+    }
+
+    copyJuxscriptCss() {
+        const componentsDir = this.getComponentsDir();
+        if (!componentsDir) return [];
+
+        const cssFiles = [];
+
+        const walkDir = (dir, relativePath = '') => {
+            if (!fs.existsSync(dir)) return;
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                const relPath = path.join(relativePath, entry.name);
+                if (entry.isDirectory()) {
+                    walkDir(fullPath, relPath);
+                } else if (entry.name === 'structure.css') {
+                    cssFiles.push({ src: fullPath, dest: relPath, component: relativePath });
+                }
+            }
+        };
+
+        walkDir(componentsDir);
+
+        const cssDistDir = path.join(this.distDir, 'css');
+        fs.mkdirSync(cssDistDir, { recursive: true });
+
+        cssFiles.forEach(css => {
+            const destPath = path.join(cssDistDir, css.dest);
+            fs.mkdirSync(path.dirname(destPath), { recursive: true });
+            fs.copyFileSync(css.src, destPath);
+        });
+
+        console.log(`📄 Copied ${cssFiles.length} CSS files`);
+        return cssFiles;
+    }
+
+    generateCssLinks(cssFiles) {
+        return cssFiles.map(css => `    <link rel="stylesheet" href="./css/${css.dest}">`).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();
+
+                // Parse export statements
+                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 juxscriptImports = new Set();
+        const allImports = new Set();
+
+        walk(ast, {
+            ImportDeclaration(node) {
+                node.specifiers.forEach(spec => {
+                    allImports.add(spec.local.name);
+                    if (node.source.value === 'juxscript') {
+                        juxscriptImports.add(spec.local.name);
+                    }
+                });
+            }
+        });
+
+        const knownComponents = this._juxscriptExports || ['Element', 'Grid', 'Input', 'List'];
+
+        walk(ast, {
+            Identifier(node, parent) {
+                if (parent?.type === 'CallExpression' && parent.callee === node) {
+                    const name = node.name;
+                    if (/^[A-Z]/.test(name) && !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;
+    }
+
+    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);
+                });
+            }
+        });
+
+        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`;
+        }
+
+        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;
+        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`;
+        });
+
+        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;
+}
+
+// Find source file from error stack
+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] };
+            }
+        }
+    }
+    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; letter-spacing: 0.5px;
+        }
+        .__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; user-select: none;
+            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; transition: background 0.15s;
+        }
+        .__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 = '';
+        var 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 || 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 for this error.</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);
+        
+        // Trigger transition
+        requestAnimationFrame(function() {
+            overlay.classList.add('visible');
+        });
+        
+        console.error(title + ':', error);
+    }
+};
+
+// Global error handlers
+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}};
+
+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\n`);
+
+        const cssFiles = this.copyJuxscriptCss();
+
+        // 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);
+
+        // Write source snapshot for dev tools
+        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 index.html
+        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>
+${this.generateCssLinks(cssFiles)}
+    <script type="module" src="./bundle.js"></script>
+</head>
+<body>
+    <div id="app"></div>
+</body>
+</html>`;
+        fs.writeFileSync(path.join(this.distDir, 'index.html'), html);
+
+        // Cleanup temp files
+        fs.unlinkSync(entryPath);
+        fs.rmSync(juxDistDir, { recursive: true, force: true });
+
+        console.log(`\n✅ Build Complete!\n`);
+        return { success: true, errors: [], warnings: validation.warnings };
+    }
+}