kuhul-es 1.0.0

package/@kuhul-es.html

@@ -0,0 +1,5 @@
+<script src="https://unpkg.com/@kuhul/es"></script>
+<script>
+  const runtime = new KUHULRuntime();
+  runtime.execute('π gravity = [0, 9.81, 0];');
+</script>

package/README.md

@@ -0,0 +1,11 @@
+@'
+# @kuhul/es
+
+**KUHUL-ES: ECMAScript syntax with KUHUL semantics**
+
+The Trojan Horse that brings deterministic, physics-first programming to JavaScript developers.
+
+## 🚀 Quick Start
+
+```bash
+npm install @kuhul/es

package/bin/kuhul-es.js

@@ -0,0 +1,43 @@
+# Create bin directory
+New-Item -ItemType Directory -Force -Path bin
+
+# Create the CLI file
+@'
+#!/usr/bin/env node
+
+console.log(`
+╔══════════════════════════════════════╗
+║        KUHUL-ES v1.0.0               ║
+║  ECMAScript syntax, KUHUL semantics  ║
+╚══════════════════════════════════════╝
+`);
+
+const { program } = require('commander');
+
+program
+  .name('kuhul-es')
+  .description('KUHUL-ES - The Trojan Horse for KUHUL semantics')
+  .version('1.0.0');
+
+program
+  .command('init [project-name]')
+  .description('Initialize a new KUHUL-ES project')
+  .action((projectName = 'my-kuhul-app') => {
+    console.log(`Creating project: ${projectName}`);
+    // Implementation would go here
+  });
+
+program
+  .command('compile <file>')
+  .description('Compile KUHUL-ES source file')
+  .action((file) => {
+    console.log(`Compiling: ${file}`);
+    // Implementation would go here
+  });
+
+program.parse(process.argv);
+
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}
+'@ | Out-File bin/kuhul-es.js -Encoding UTF8

package/cli/cli.sh

@@ -0,0 +1,3 @@
+npx @kuhul/es init my-project
+cd my-project
+npm start

package/cli/src/main.ts

@@ -0,0 +1,358 @@
+// kuhul-es/cli/src/main.ts
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { KUHULParser } from '../compiler/src/parser';
+import * as fs from 'fs';
+import * as path from 'path';
+import chalk from 'chalk';
+
+const program = new Command();
+
+program
+  .name('kuhul-es')
+  .description('KUHUL-ES Compiler - ECMAScript syntax with KUHUL semantics')
+  .version('1.0.0');
+
+program
+  .command('compile <input>')
+  .description('Compile KUHUL-ES source file')
+  .option('-o, --output <file>', 'Output file')
+  .option('-w, --watch', 'Watch for changes')
+  .action(async (input, options) => {
+    try {
+      const source = fs.readFileSync(input, 'utf-8');
+      const parser = new KUHULParser(source, input);
+      const result = parser.parse();
+      
+      const outputFile = options.output || input.replace('.kuhules', '.js');
+      fs.writeFileSync(outputFile, result.transformedCode);
+      
+      console.log(chalk.green('✓ Compiled successfully!'));
+      console.log(chalk.cyan(`  Input: ${input}`));
+      console.log(chalk.cyan(`  Output: ${outputFile}`));
+      console.log(chalk.cyan(`  π-Bindings: ${result.πBindings.size}`));
+      console.log(chalk.cyan(`  τ-Bindings: ${result.τBindings.size}`));
+      console.log(chalk.cyan(`  Glyph Calls: ${result.glyphCalls.length}`));
+      
+      if (options.watch) {
+        console.log(chalk.yellow('👁️  Watching for changes...'));
+        fs.watch(input, (eventType) => {
+          if (eventType === 'change') {
+            console.log(chalk.blue('\n🔄 File changed, recompiling...'));
+            const newSource = fs.readFileSync(input, 'utf-8');
+            const newParser = new KUHULParser(newSource, input);
+            const newResult = newParser.parse();
+            fs.writeFileSync(outputFile, newResult.transformedCode);
+            console.log(chalk.green('✓ Recompiled!'));
+          }
+        });
+      }
+    } catch (error) {
+      console.error(chalk.red('✗ Compilation failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('init [project-name]')
+  .description('Initialize a new KUHUL-ES project')
+  .action((projectName = 'my-kuhul-app') => {
+    const projectDir = path.resolve(projectName);
+    
+    if (fs.existsSync(projectDir)) {
+      console.error(chalk.red(`Directory ${projectName} already exists!`));
+      process.exit(1);
+    }
+    
+    // Create project structure
+    fs.mkdirSync(projectDir, { recursive: true });
+    fs.mkdirSync(path.join(projectDir, 'src'), { recursive: true });
+    
+    // Create package.json
+    const packageJson = {
+      name: projectName,
+      version: '1.0.0',
+      type: 'module',
+      scripts: {
+        'dev': 'kuhul-es compile src/main.kuhules -w',
+        'build': 'kuhul-es compile src/main.kuhules -o dist/bundle.js',
+        'start': 'node dist/bundle.js'
+      },
+      dependencies: {
+        '@kuhul/es-runtime': '^1.0.0'
+      },
+      devDependencies: {
+        '@kuhul/es-compiler': '^1.0.0'
+      }
+    };
+    
+    fs.writeFileSync(
+      path.join(projectDir, 'package.json'),
+      JSON.stringify(packageJson, null, 2)
+    );
+    
+    // Create example KUHUL-ES file
+    const exampleCode = `
+// main.kuhules - KUHUL-ES Example
+π gravity = [0, 9.81, 0];
+π world = {
+  bodies: [],
+  fields: []
+};
+
+τ currentFrame = 0;
+
+function* initializeWorld() {
+  yield* Sek('log', 'Initializing KUHUL-ES world...');
+  
+  @if (gravity[1] > 0) {
+    yield* Sek('add_field', world, {
+      type: 'gravity',
+      strength: gravity[1]
+    });
+  }
+  
+  @for (let i = 0; i < 5; i++) {
+    π body = {
+      id: 'body_' + i,
+      position: [i * 10, 0, 0],
+      mass: 1.0
+    };
+    yield* Sek('add_body', world, body);
+  }
+  
+  yield* Sek('start_physics', world, 60);
+}
+
+function* physicsLoop() {
+  @while (world.active) {
+    yield* Sek('physics_tick', world);
+    currentFrame += 1;
+    
+    @if (currentFrame % 60 === 0) {
+      yield* Sek('log', \`Second: \${currentFrame / 60}\`);
+    }
+  }
+}
+
+function* main() {
+  yield* initializeWorld();
+  yield* physicsLoop();
+}
+
+// Start execution
+main();
+`;
+    
+    fs.writeFileSync(
+      path.join(projectDir, 'src/main.kuhules'),
+      exampleCode.trim()
+    );
+    
+    // Create HTML example
+    const htmlExample = `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${projectName} - KUHUL-ES</title>
+  <style>
+    body {
+      margin: 0;
+      padding: 20px;
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif;
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      color: white;
+      min-height: 100vh;
+    }
+    
+    .container {
+      max-width: 800px;
+      margin: 0 auto;
+      background: rgba(255, 255, 255, 0.1);
+      backdrop-filter: blur(10px);
+      border-radius: 20px;
+      padding: 40px;
+      box-shadow: 0 20px 60px rgba(0, 0, 0, 0.3);
+    }
+    
+    h1 {
+      margin-top: 0;
+      font-size: 2.5em;
+      background: linear-gradient(45deg, #f093fb 0%, #f5576c 100%);
+      -webkit-background-clip: text;
+      -webkit-text-fill-color: transparent;
+    }
+    
+    .physics-canvas {
+      width: 100%;
+      height: 400px;
+      background: rgba(0, 0, 0, 0.2);
+      border-radius: 10px;
+      margin: 20px 0;
+    }
+    
+    .stats {
+      display: grid;
+      grid-template-columns: repeat(3, 1fr);
+      gap: 20px;
+      margin-top: 30px;
+    }
+    
+    .stat {
+      background: rgba(255, 255, 255, 0.1);
+      padding: 20px;
+      border-radius: 10px;
+      text-align: center;
+    }
+    
+    .stat-value {
+      font-size: 2em;
+      font-weight: bold;
+      color: #4fd1c5;
+    }
+    
+    .console {
+      background: rgba(0, 0, 0, 0.3);
+      border-radius: 10px;
+      padding: 20px;
+      margin-top: 30px;
+      font-family: 'Courier New', monospace;
+      height: 200px;
+      overflow-y: auto;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h1>🧠 ${projectName}</h1>
+    <p>KUHUL-ES Physics Simulation Running</p>
+    
+    <div class="physics-canvas" id="physics-canvas"></div>
+    
+    <div class="stats">
+      <div class="stat">
+        <div class="stat-label">π-Bindings</div>
+        <div class="stat-value" id="pi-count">0</div>
+      </div>
+      <div class="stat">
+        <div class="stat-label">τ-Bindings</div>
+        <div class="stat-value" id="tau-count">0</div>
+      </div>
+      <div class="stat">
+        <div class="stat-label">Frame</div>
+        <div class="stat-value" id="frame-count">0</div>
+      </div>
+    </div>
+    
+    <div class="console" id="console"></div>
+  </div>
+  
+  <script type="module">
+    import { KUHULRuntime } from 'https://unpkg.com/@kuhul/es-runtime@1.0.0/dist/browser.js';
+    
+    // Example KUHUL-ES code
+    const source = \`
+π gravity = [0, 9.81, 0];
+π world = { bodies: [], active: true };
+τ frame = 0;
+
+function* main() {
+  yield* Sek('log', '🚀 KUHUL-ES Starting...');
+  
+  // Create some physics bodies
+  @for (let i = 0; i < 10; i++) {
+    π body = {
+      id: 'body_' + i,
+      x: Math.random() * 800,
+      y: Math.random() * 400,
+      vx: (Math.random() - 0.5) * 10,
+      vy: (Math.random() - 0.5) * 10
+    };
+    yield* Sek('create_body', body);
+  }
+  
+  // Physics loop
+  @while (world.active) {
+    yield* Sek('update_physics', 0.016);
+    frame += 1;
+    yield* Sek('render_frame');
+    
+    @if (frame % 60 === 0) {
+      yield* Sek('log', \`Frame: \${frame}\`);
+    }
+  }
+}
+
+main();
+\`;
+    
+    const runtime = new KUHULRuntime();
+    runtime.on('log', (message) => {
+      const consoleEl = document.getElementById('console');
+      consoleEl.innerHTML += '<div>' + message + '</div>';
+      consoleEl.scrollTop = consoleEl.scrollHeight;
+    });
+    
+    runtime.on('frame_update', (frame) => {
+      document.getElementById('frame-count').textContent = frame;
+    });
+    
+    runtime.on('stat_update', (stats) => {
+      document.getElementById('pi-count').textContent = stats.piBindings;
+      document.getElementById('tau-count').textContent = stats.tauBindings;
+    });
+    
+    // Start the runtime
+    runtime.execute(source);
+    
+    // Canvas rendering
+    const canvas = document.createElement('canvas');
+    const ctx = canvas.getContext('2d');
+    const container = document.getElementById('physics-canvas');
+    canvas.width = container.clientWidth;
+    canvas.height = container.clientHeight;
+    container.appendChild(canvas);
+    
+    // Simple physics visualization
+    function renderBodies(bodies) {
+      ctx.clearRect(0, 0, canvas.width, canvas.height);
+      
+      bodies.forEach(body => {
+        ctx.beginPath();
+        ctx.arc(body.x, body.y, 10, 0, Math.PI * 2);
+        ctx.fillStyle = '#4fd1c5';
+        ctx.fill();
+        
+        // Velocity vector
+        ctx.beginPath();
+        ctx.moveTo(body.x, body.y);
+        ctx.lineTo(body.x + body.vx, body.y + body.vy);
+        ctx.strokeStyle = '#f56565';
+        ctx.lineWidth = 2;
+        ctx.stroke();
+      });
+    }
+    
+    runtime.on('render', renderBodies);
+  </script>
+</body>
+</html>
+`;
+    
+    fs.writeFileSync(
+      path.join(projectDir, 'index.html'),
+      htmlExample.trim()
+    );
+    
+    console.log(chalk.green(`✓ Created KUHUL-ES project: ${projectName}`));
+    console.log(chalk.cyan('\nNext steps:'));
+    console.log(chalk.cyan(`  cd ${projectName}`));
+    console.log(chalk.cyan('  npm install'));
+    console.log(chalk.cyan('  npm run dev'));
+    console.log(chalk.cyan('\nThen open index.html in your browser!'));
+  });
+
+program.parse(process.argv);