luxaura 1.0.0

package/bin/luxaura.js

@@ -0,0 +1,632 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Luxaura CLI
+ * Commands: new, run, build, install, generate, format, secure
+ */
+
+const { program } = require('commander');
+const chalk  = require('chalk');
+const fs     = require('fs-extra');
+const path   = require('path');
+const { execSync } = require('child_process');
+const chokidar = require('chokidar');
+
+const { LuxParser }   = require('../src/parser');
+const { LuxCompiler } = require('../src/compiler');
+const { VaultServer } = require('../src/vault/server');
+
+const VERSION = '1.0.0';
+
+// ─── Banner ──────────────────────────────────────────────────────────────────
+
+function banner() {
+  console.log(chalk.cyan(`
+  ██╗     ██╗   ██╗██╗  ██╗ █████╗ ██╗   ██╗██████╗  █████╗
+  ██║     ██║   ██║╚██╗██╔╝██╔══██╗██║   ██║██╔══██╗██╔══██╗
+  ██║     ██║   ██║ ╚███╔╝ ███████║██║   ██║██████╔╝███████║
+  ██║     ██║   ██║ ██╔██╗ ██╔══██║██║   ██║██╔══██╗██╔══██║
+  ███████╗╚██████╔╝██╔╝ ██╗██║  ██║╚██████╔╝██║  ██║██║  ██║
+  ╚══════╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝
+  `));
+  console.log(chalk.gray(`  Intent-Based Web Framework  v${VERSION}\n`));
+}
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+function log(msg)     { console.log(chalk.cyan('  ▸'), msg); }
+function success(msg) { console.log(chalk.green('  ✔'), msg); }
+function warn(msg)    { console.log(chalk.yellow('  ⚠'), msg); }
+function error(msg)   { console.error(chalk.red('  ✖'), msg); }
+function info(msg)    { console.log(chalk.gray('  ·'), msg); }
+
+function compileLuxFile(filePath, options = {}) {
+  const source   = fs.readFileSync(filePath, 'utf8');
+  const filename = path.basename(filePath);
+  const parser   = new LuxParser(source, filename);
+  const ast      = parser.parse();
+  const compiler = new LuxCompiler(ast, options);
+  return compiler.compile();
+}
+
+function getAllLuxFiles(dir) {
+  const results = [];
+  function walk(d) {
+    if (!fs.existsSync(d)) return;
+    for (const entry of fs.readdirSync(d, { withFileTypes: true })) {
+      const full = path.join(d, entry.name);
+      if (entry.isDirectory() && !['node_modules', 'dist', '.git'].includes(entry.name)) {
+        walk(full);
+      } else if (entry.isFile() && entry.name.endsWith('.lux')) {
+        results.push(full);
+      }
+    }
+  }
+  walk(dir);
+  return results;
+}
+
+// ─── Command: new ─────────────────────────────────────────────────────────────
+
+program
+  .command('new <name>')
+  .description('Create a new Luxaura project')
+  .action(async (name) => {
+    banner();
+    const projectDir = path.resolve(process.cwd(), name);
+
+    if (fs.existsSync(projectDir)) {
+      error(`Directory "${name}" already exists.`);
+      process.exit(1);
+    }
+
+    log(`Creating project: ${chalk.white(name)}`);
+
+    // Directory structure
+    const dirs = [
+      projectDir,
+      path.join(projectDir, 'pages'),
+      path.join(projectDir, 'modules'),
+      path.join(projectDir, 'assets'),
+      path.join(projectDir, 'server'),
+      path.join(projectDir, 'dist', 'client'),
+      path.join(projectDir, 'dist', 'server'),
+    ];
+    dirs.forEach(d => fs.mkdirpSync(d));
+
+    // luxaura.config
+    fs.writeFileSync(path.join(projectDir, 'luxaura.config'), `
+# Luxaura Configuration
+app.name: ${name}
+app.version: 1.0.0
+
+# theme: light | dark
+theme: light
+
+# mode: full | headless
+mode: full
+
+# Database (optional)
+# db.type: postgres
+# db.url: postgresql://localhost:5432/${name}
+
+# Headless proxy (only used when mode: headless)
+# proxy: http://localhost:8080
+`.trim() + '\n');
+
+    // pages/index.lux
+    fs.writeFileSync(path.join(projectDir, 'pages', 'index.lux'), `
+# ${name} — Home Page
+
+props
+    title: String = "Welcome to ${name}"
+
+state
+    count: 0
+
+style
+    self
+        padding: 8
+        background: #ffffff
+
+    Title
+        fontSize: 2xl
+        fontWeight: bold
+        color: #1a1a2e
+
+    Action
+        padding: 4
+        radius: medium
+        background: #6c63ff
+        color: #ffffff
+        cursor: pointer
+
+view
+    Container
+        Title "{title}"
+        Text "You have clicked the button {count} times."
+        Action "Click Me"
+            on click:
+                await server.logClick(count)
+`.trim() + '\n');
+
+    // modules/Navbar.lux
+    fs.writeFileSync(path.join(projectDir, 'modules', 'Navbar.lux'), `
+# Reusable Navbar Component
+
+props
+    brand: String = "${name}"
+
+style
+    self
+        padding: 4
+        background: #1a1a2e
+        shadow: soft
+
+    Title
+        color: #ffffff
+        fontSize: lg
+        fontWeight: bold
+
+view
+    Nav
+        Row
+            Title "{brand}"
+            Row
+                Action "Home"
+                Action "About"
+                Action "Contact"
+`.trim() + '\n');
+
+    // server/index.js
+    fs.writeFileSync(path.join(projectDir, 'server', 'index.js'), `
+'use strict';
+// Shared server utilities (imported by compiled server modules)
+
+async function logClick(count) {
+  console.log('[Server] Button clicked, count:', count);
+  return { ok: true, count };
+}
+
+module.exports = { logClick };
+`);
+
+    // package.json for project
+    fs.writeFileSync(path.join(projectDir, 'package.json'), JSON.stringify({
+      name,
+      version: '1.0.0',
+      description: `${name} — built with Luxaura`,
+      scripts: {
+        dev: 'luxaura run',
+        build: 'luxaura build',
+      },
+      dependencies: {
+        luxaura: `^${VERSION}`,
+      },
+    }, null, 2));
+
+    // .gitignore
+    fs.writeFileSync(path.join(projectDir, '.gitignore'), `node_modules/\ndist/\n.DS_Store\n`);
+
+    // Copy UI kit files if they exist (they'll be generated later)
+    const uiKitSrc = path.join(__dirname, '..', 'ui-kit');
+    const uiKitDst = path.join(projectDir, 'dist', 'client');
+    if (fs.existsSync(path.join(uiKitSrc, 'luxaura.min.css'))) {
+      fs.copySync(path.join(uiKitSrc, 'luxaura.min.css'), path.join(uiKitDst, 'luxaura.min.css'));
+      fs.copySync(path.join(uiKitSrc, 'luxaura.min.js'),  path.join(uiKitDst, 'luxaura.min.js'));
+    }
+
+    success(`Project "${name}" created!`);
+    info(`\n  cd ${name}`);
+    info(`  luxaura run\n`);
+  });
+
+// ─── Command: run ─────────────────────────────────────────────────────────────
+
+program
+  .command('run')
+  .description('Start development server with HMR')
+  .option('-p, --port <port>', 'Port number', '3000')
+  .action(async (opts) => {
+    banner();
+    const rootDir = process.cwd();
+    const port = parseInt(opts.port, 10);
+
+    log('Compiling .lux files...');
+    await buildAll(rootDir, { dev: true });
+
+    const vault = new VaultServer({ port, rootDir });
+    const actualPort = await vault.start();
+    success(`Dev server running at ${chalk.white(`http://localhost:${actualPort}`)}`);
+    info('Hot Module Replacement enabled. Watching for changes...\n');
+
+    // Inject HMR client script into index.html
+    _injectHMR(rootDir, actualPort);
+
+    const watcher = chokidar.watch(
+      [path.join(rootDir, 'pages'), path.join(rootDir, 'modules')],
+      { ignoreInitial: true }
+    );
+
+    watcher.on('change', async (filePath) => {
+      log(`Changed: ${chalk.yellow(path.relative(rootDir, filePath))}`);
+      try {
+        await buildFile(filePath, rootDir, { dev: true });
+        vault.triggerHMR(path.relative(rootDir, filePath));
+        success('Rebuilt and reloaded.');
+      } catch (e) {
+        error(`Compile error: ${e.message}`);
+      }
+    });
+
+    watcher.on('add', async (filePath) => {
+      log(`New file: ${chalk.yellow(path.relative(rootDir, filePath))}`);
+      await buildFile(filePath, rootDir, { dev: true });
+      vault.triggerHMR('new-file');
+    });
+  });
+
+function _injectHMR(rootDir, port) {
+  const indexPath = path.join(rootDir, 'dist', 'client', 'index.html');
+  if (!fs.existsSync(indexPath)) return;
+  let html = fs.readFileSync(indexPath, 'utf8');
+  if (html.includes('__lux_hmr__')) return;
+  const hmrScript = `
+<script id="__lux_hmr__">
+(function(){
+  const ws = new WebSocket('ws://localhost:${port}');
+  ws.onmessage = function(e) {
+    const msg = JSON.parse(e.data);
+    if (msg.type === 'hmr') {
+      console.log('[Luxaura HMR] Reloading:', msg.file);
+      location.reload();
+    }
+  };
+  ws.onclose = function() {
+    console.log('[Luxaura HMR] Connection lost. Reconnecting...');
+    setTimeout(() => location.reload(), 2000);
+  };
+})();
+</script>`;
+  html = html.replace('</body>', hmrScript + '</body>');
+  fs.writeFileSync(indexPath, html);
+}
+
+// ─── Command: build ───────────────────────────────────────────────────────────
+
+program
+  .command('build')
+  .description('Compile for production (splits client/server)')
+  .action(async () => {
+    banner();
+    const rootDir = process.cwd();
+    log('Building for production...');
+
+    const start = Date.now();
+    const stats  = await buildAll(rootDir, { dev: false });
+
+    success(`Build complete in ${Date.now() - start}ms`);
+    info(`  Client assets → ${chalk.white('dist/client/')}`);
+    info(`  Server modules → ${chalk.white('dist/server/')}`);
+    info(`  Files compiled: ${stats.count}`);
+    if (stats.errors.length) {
+      stats.errors.forEach(e => error(e));
+    }
+  });
+
+// ─── Command: install ─────────────────────────────────────────────────────────
+
+program
+  .command('install <lib>')
+  .description('Install and integrate a frontend library')
+  .action(async (lib) => {
+    banner();
+    log(`Installing ${chalk.yellow(lib)}...`);
+    try {
+      execSync(`npm install ${lib}`, { stdio: 'inherit', cwd: process.cwd() });
+      success(`${lib} installed.`);
+      info('Classes are now available in your .lux files via the class: attribute.');
+    } catch (e) {
+      error(`npm install failed: ${e.message}`);
+    }
+  });
+
+// ─── Command: generate ────────────────────────────────────────────────────────
+
+const TEMPLATES = {
+  component: (name) => `
+# ${name} Component
+
+props
+    label: String = "${name}"
+
+state
+    active: false
+
+style
+    self
+        padding: 4
+        radius: medium
+        shadow: soft
+
+view
+    Box
+        Title "{label}"
+        Text "Edit ${name}.lux to get started."
+`.trim() + '\n',
+
+  page: (name) => `
+# ${name} Page
+
+props
+    title: String = "${name}"
+
+state
+    loading: false
+
+style
+    self
+        padding: 8
+
+view
+    Container
+        Title "{title}"
+        Text "This is the ${name} page."
+`.trim() + '\n',
+
+  api: (name) => `
+# ${name} API Module (server-side only)
+# This file is compiled into dist/server and NEVER sent to the client.
+
+server
+    import db from "luxaura/db"
+
+    def get${name}(id):
+        return db.query("SELECT * FROM ${name.toLowerCase()}s WHERE id = ?", [id])
+
+    def create${name}(data):
+        return db.insert("${name.toLowerCase()}s", data)
+
+    def update${name}(id, data):
+        return db.update("${name.toLowerCase()}s", data, { id })
+`.trim() + '\n',
+};
+
+program
+  .command('generate <type> <name>')
+  .alias('g')
+  .description('Scaffold component, page, or api file')
+  .action((type, name) => {
+    banner();
+    const rootDir = process.cwd();
+    const template = TEMPLATES[type];
+    if (!template) {
+      error(`Unknown type "${type}". Use: component, page, api`);
+      process.exit(1);
+    }
+
+    const dirs = { component: 'modules', page: 'pages', api: 'pages' };
+    const dir = path.join(rootDir, dirs[type]);
+    fs.mkdirpSync(dir);
+
+    const filePath = path.join(dir, `${name}.lux`);
+    if (fs.existsSync(filePath)) {
+      warn(`File already exists: ${path.relative(rootDir, filePath)}`);
+      process.exit(0);
+    }
+
+    fs.writeFileSync(filePath, template(name));
+    success(`Generated: ${chalk.white(path.relative(rootDir, filePath))}`);
+  });
+
+// ─── Command: format ──────────────────────────────────────────────────────────
+
+program
+  .command('format')
+  .description('Auto-fix indentation and style in .lux files')
+  .action(() => {
+    banner();
+    const rootDir = process.cwd();
+    const files = getAllLuxFiles(rootDir);
+    let fixed = 0;
+
+    files.forEach(filePath => {
+      try {
+        const source  = fs.readFileSync(filePath, 'utf8');
+        const formatted = formatLux(source);
+        if (formatted !== source) {
+          fs.writeFileSync(filePath, formatted);
+          log(`Formatted: ${path.relative(rootDir, filePath)}`);
+          fixed++;
+        }
+      } catch (e) {
+        warn(`Could not format ${filePath}: ${e.message}`);
+      }
+    });
+
+    success(`Formatted ${fixed} file(s).`);
+  });
+
+function formatLux(source) {
+  const BLOCK_NAMES = ['props', 'state', 'server', 'style', 'view'];
+  const lines = source.split('\n');
+  const out = [];
+  let inBlock = false;
+
+  for (let i = 0; i < lines.length; i++) {
+    const raw = lines[i];
+    const trimmed = raw.trim();
+
+    if (!trimmed) { out.push(''); continue; }
+    if (trimmed.startsWith('#')) { out.push(trimmed); continue; }
+
+    if (BLOCK_NAMES.includes(trimmed)) {
+      if (i > 0) out.push('');
+      out.push(trimmed);
+      inBlock = true;
+      continue;
+    }
+
+    if (inBlock) {
+      // Normalize to 4-space indent per level
+      const indent = raw.match(/^(\s*)/)[1];
+      const spaces = indent.replace(/\t/g, '    ');
+      const level  = Math.round(spaces.length / 4);
+      out.push('    '.repeat(Math.max(1, level)) + trimmed);
+    } else {
+      out.push(raw);
+    }
+  }
+
+  return out.join('\n').trimEnd() + '\n';
+}
+
+// ─── Command: secure ──────────────────────────────────────────────────────────
+
+program
+  .command('secure')
+  .description('Scan codebase for security vulnerabilities')
+  .action(() => {
+    banner();
+    const rootDir = process.cwd();
+    const files = getAllLuxFiles(rootDir);
+    let issues = 0;
+
+    const XSS_PATTERNS = [
+      { re: /innerHTML\s*=/g,       msg: 'Unsafe innerHTML assignment (XSS risk)' },
+      { re: /document\.write\s*\(/g, msg: 'document.write() usage (XSS risk)' },
+      { re: /eval\s*\(/g,           msg: 'eval() usage (code injection risk)' },
+    ];
+
+    const SQL_PATTERNS = [
+      { re: /db\.query\s*\(\s*`[^`]*\$\{/g, msg: 'Possible SQL injection: template literal in query. Use parameterized queries.' },
+      { re: /db\.query\s*\(\s*"[^"]*"\s*\+/g, msg: 'Possible SQL injection: string concatenation in query. Use parameterized queries.' },
+    ];
+
+    const SERVER_LEAK = [
+      { re: /process\.env\.(DB_PASSWORD|SECRET|API_KEY)/gi, msg: 'Sensitive env var referenced — verify it is in server block only' },
+    ];
+
+    files.forEach(filePath => {
+      const source  = fs.readFileSync(filePath, 'utf8');
+      const relPath = path.relative(rootDir, filePath);
+
+      const allPatterns = [...XSS_PATTERNS, ...SQL_PATTERNS, ...SERVER_LEAK];
+      allPatterns.forEach(({ re, msg }) => {
+        const matches = source.match(re);
+        if (matches) {
+          warn(`${relPath}: ${msg}`);
+          issues++;
+        }
+      });
+
+      // Check for server code outside server block
+      const serverBlockMatch = source.match(/^server$([\s\S]*?)(?=^(?:props|state|style|view)$|\Z)/m);
+      if (!serverBlockMatch) {
+        const dbOutsideServer = /db\.(query|insert|update)/.test(source);
+        if (dbOutsideServer) {
+          error(`${relPath}: db access detected outside server block — this may leak to client`);
+          issues++;
+        }
+      }
+    });
+
+    if (issues === 0) {
+      success(`No issues found. ${files.length} files scanned.`);
+    } else {
+      warn(`Found ${issues} potential issue(s) across ${files.length} files.`);
+    }
+  });
+
+// ─── Build Helpers ─────────────────────────────────────────────────────────────
+
+async function buildAll(rootDir, opts = {}) {
+  const files  = getAllLuxFiles(rootDir);
+  const errors = [];
+  let count    = 0;
+
+  // Copy UI kit
+  const uiKitSrc = path.join(__dirname, '..', 'ui-kit');
+  const clientDir = path.join(rootDir, 'dist', 'client');
+  fs.mkdirpSync(clientDir);
+  fs.mkdirpSync(path.join(rootDir, 'dist', 'server'));
+
+  if (fs.existsSync(path.join(uiKitSrc, 'luxaura.min.css'))) {
+    fs.copySync(path.join(uiKitSrc, 'luxaura.min.css'), path.join(clientDir, 'luxaura.min.css'));
+    fs.copySync(path.join(uiKitSrc, 'luxaura.min.js'),  path.join(clientDir, 'luxaura.min.js'));
+  }
+
+  // Copy static assets
+  const assetsDir = path.join(rootDir, 'assets');
+  if (fs.existsSync(assetsDir)) {
+    fs.copySync(assetsDir, path.join(clientDir, 'assets'));
+  }
+
+  for (const f of files) {
+    try {
+      await buildFile(f, rootDir, opts);
+      count++;
+    } catch (e) {
+      errors.push(`${path.relative(rootDir, f)}: ${e.message}`);
+    }
+  }
+
+  return { count, errors };
+}
+
+async function buildFile(filePath, rootDir, opts = {}) {
+  const source  = fs.readFileSync(filePath, 'utf8');
+  const filename = path.basename(filePath);
+  const parser   = new LuxParser(source, filename);
+  const ast      = parser.parse();
+  const compiler = new LuxCompiler(ast);
+  const output   = compiler.compile();
+
+  const clientDir = path.join(rootDir, 'dist', 'client');
+  const serverDir = path.join(rootDir, 'dist', 'server');
+  const name = filename.replace('.lux', '');
+
+  fs.mkdirpSync(clientDir);
+  fs.mkdirpSync(serverDir);
+
+  // Client JS
+  fs.writeFileSync(path.join(clientDir, `${name}.component.js`), output.clientJS);
+
+  // Server JS (vault)
+  if (output.serverJS && output.serverJS !== `/* Luxaura Vault — ${name} | no server block */\nmodule.exports = {};`) {
+    fs.writeFileSync(path.join(serverDir, `${name}.js`), output.serverJS);
+  }
+
+  // Component CSS
+  if (output.css) {
+    const cssPath = path.join(clientDir, 'styles.css');
+    const existing = fs.existsSync(cssPath) ? fs.readFileSync(cssPath, 'utf8') : '';
+    if (!existing.includes(`/* Luxaura — ${name} Styles */`)) {
+      fs.appendFileSync(cssPath, '\n' + output.css);
+    }
+  }
+
+  // HTML shell (only for pages)
+  if (filePath.includes('/pages/')) {
+    const htmlPath = path.join(clientDir, name === 'index' ? 'index.html' : `${name}.html`);
+    fs.writeFileSync(htmlPath, output.html);
+
+    // Bundle app.js
+    const appJsPath = path.join(clientDir, 'app.js');
+    const componentFiles = fs.readdirSync(clientDir)
+      .filter(f => f.endsWith('.component.js'))
+      .map(f => `// Component: ${f}\n` + fs.readFileSync(path.join(clientDir, f), 'utf8'))
+      .join('\n\n');
+    fs.writeFileSync(appJsPath, componentFiles);
+  }
+}
+
+// ─── Run ─────────────────────────────────────────────────────────────────────
+
+program
+  .name('luxaura')
+  .version(VERSION)
+  .description('Luxaura Framework CLI');
+
+program.parse(process.argv);