npm - nova64 - Versions diffs - 0.2.4 → 0.2.6 - Mend

nova64 0.2.4 → 0.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (140) hide show

package/README.md +25 -8
package/bin/nova64.js +165 -0
package/dist/assets/console-CY_kygm3.js +14 -0
package/dist/assets/console-CY_kygm3.js.map +1 -0
package/dist/assets/main-l0sNRNKZ.js.map +1 -0
package/dist/assets/sky/studio/nx.png +0 -0
package/dist/assets/sky/studio/ny.png +0 -0
package/dist/assets/sky/studio/nz.png +0 -0
package/dist/assets/sky/studio/px.png +0 -0
package/dist/assets/sky/studio/py.png +0 -0
package/dist/assets/sky/studio/pz.png +0 -0
package/dist/assets/vanilla-Dcuy32gi.js +2 -0
package/dist/assets/vanilla-Dcuy32gi.js.map +1 -0
package/dist/console.html +899 -0
package/dist/docs/BENCHMARK.md +77 -0
package/dist/docs/CHEATSHEET.md +255 -0
package/dist/docs/EFFECTS_API_GUIDE.md +577 -0
package/dist/docs/EFFECTS_QUICK_REFERENCE.md +331 -0
package/dist/docs/FONT_CHARACTER_REFERENCE.md +219 -0
package/dist/docs/FREE_GLB_ASSETS.md +330 -0
package/dist/docs/FULLSCREEN_BUTTON_FEATURE.md +296 -0
package/dist/docs/GAMEPAD_SUPPORT.md +348 -0
package/dist/docs/GAME_IMPROVEMENTS.md +278 -0
package/dist/docs/GAME_QUALITY_STATUS.md +300 -0
package/dist/docs/MIGRATION_GUIDE.md +553 -0
package/dist/docs/NOVA64_3D_API.md +356 -0
package/dist/docs/NOVA64_API_REFERENCE.md +1406 -0
package/dist/docs/NOVA64_UI_API.md +503 -0
package/dist/docs/UI_SYSTEM_SUMMARY.md +445 -0
package/dist/docs/VOXEL_ENGINE_GUIDE.md +662 -0
package/dist/docs/VOXEL_QUICK_REFERENCE.md +386 -0
package/dist/docs/api-3d.html +750 -0
package/dist/docs/api-effects.html +385 -0
package/dist/docs/api-improvements.md +121 -0
package/dist/docs/api-skybox.html +407 -0
package/dist/docs/api-sprites.html +321 -0
package/dist/docs/api-voxel.html +337 -0
package/dist/docs/api.html +543 -0
package/dist/docs/assets.html +306 -0
package/dist/docs/audio.html +340 -0
package/dist/docs/blogs.html +286 -0
package/dist/docs/collision.html +316 -0
package/dist/docs/console.html +247 -0
package/dist/docs/editor.html +297 -0
package/dist/docs/font.html +247 -0
package/dist/docs/framebuffer.html +247 -0
package/dist/docs/fullscreen-button.html +297 -0
package/dist/docs/gpu-systems.html +247 -0
package/dist/docs/index.html +580 -0
package/dist/docs/input.html +491 -0
package/dist/docs/physics.html +311 -0
package/dist/docs/screens.html +311 -0
package/dist/docs/storage.html +311 -0
package/dist/docs/textinput.html +332 -0
package/dist/docs/ui.html +488 -0
package/dist/examples/3d-advanced/code.js +695 -0
package/dist/examples/adventure-comic-3d/code.js +342 -0
package/dist/examples/audio-lab/code.js +150 -0
package/dist/examples/boids-flocking/code.js +270 -0
package/dist/examples/crystal-cathedral-3d/code.js +706 -0
package/dist/examples/cyberpunk-city-3d/code.js +1383 -0
package/dist/examples/demoscene/README.md +192 -0
package/dist/examples/demoscene/code.js +1081 -0
package/dist/examples/demoscene/meta.json +21 -0
package/dist/examples/dungeon-crawler-3d/code.js +1117 -0
package/dist/examples/f-zero-nova-3d/code.js +865 -0
package/dist/examples/f-zero-nova-3d/code_old.js +1555 -0
package/dist/examples/fps-demo-3d/code.js +744 -0
package/dist/examples/game-of-life-3d/code.js +338 -0
package/dist/examples/generative-art/code.js +632 -0
package/dist/examples/hello-3d/code.js +325 -0
package/dist/examples/hello-skybox/code.js +183 -0
package/dist/examples/hello-world/code.js +19 -0
package/dist/examples/input-showcase/code.js +109 -0
package/dist/examples/instancing-demo/code.js +315 -0
package/dist/examples/minecraft-demo/code.js +387 -0
package/dist/examples/model-viewer-3d/code.js +114 -0
package/dist/examples/mystical-realm-3d/code.js +1203 -0
package/dist/examples/nature-explorer-3d/code.js +1318 -0
package/dist/examples/particles-demo/code.js +522 -0
package/dist/examples/pbr-showcase/code.js +140 -0
package/dist/examples/physics-demo-3d/code.js +948 -0
package/dist/examples/screen-demo/code.js +267 -0
package/dist/examples/shooter-demo-3d/code.js +1286 -0
package/dist/examples/space-combat-3d/IMPLEMENTATION_SUMMARY.md +109 -0
package/dist/examples/space-combat-3d/README.md +135 -0
package/dist/examples/space-combat-3d/code.js +1332 -0
package/dist/examples/space-harrier-3d/code.js +923 -0
package/dist/examples/star-fox-nova-3d/code.js +1116 -0
package/dist/examples/star-fox-nova-3d/code_backup.js +410 -0
package/dist/examples/star-fox-nova-3d/code_broken.js +1821 -0
package/dist/examples/storage-quest/code.js +209 -0
package/dist/examples/strider-demo-3d/IMPROVEMENT_OPTIONS.md +285 -0
package/dist/examples/strider-demo-3d/cache-test.html +132 -0
package/dist/examples/strider-demo-3d/code-fixed.js +582 -0
package/dist/examples/strider-demo-3d/code-old.js +1537 -0
package/dist/examples/strider-demo-3d/code.js +1462 -0
package/dist/examples/strider-demo-3d/code.js.bak2 +1169 -0
package/dist/examples/strider-demo-3d/fix-game.sh +53 -0
package/dist/examples/super-plumber-64/README.md +128 -0
package/dist/examples/super-plumber-64/code.js +1185 -0
package/dist/examples/super-plumber-64/index.html +88 -0
package/dist/examples/test-2d-overlay/code.js +32 -0
package/dist/examples/test-font/code.js +51 -0
package/dist/examples/test-minimal/code.js +21 -0
package/dist/examples/ui-demo/code.js +306 -0
package/dist/examples/wing-commander-space/README.md +180 -0
package/dist/examples/wing-commander-space/code.js +1285 -0
package/dist/examples/wizardry-3d/CHANGELOG.md +366 -0
package/dist/examples/wizardry-3d/code.js +3928 -0
package/dist/index.html +666 -0
package/dist/os9-shell/assets/index-DIHfrTaW.css +1 -0
package/dist/os9-shell/assets/index-KchE_ngx.js +483 -0
package/dist/os9-shell/assets/index-KchE_ngx.js.map +1 -0
package/dist/os9-shell/index.html +23 -0
package/dist/os9-shell/nova-icon.svg +12 -0
package/index.html +6 -1
package/package.json +37 -32
package/public/assets/sky/studio/nx.png +0 -0
package/public/assets/sky/studio/ny.png +0 -0
package/public/assets/sky/studio/nz.png +0 -0
package/public/assets/sky/studio/px.png +0 -0
package/public/assets/sky/studio/py.png +0 -0
package/public/assets/sky/studio/pz.png +0 -0
package/public/os9-shell/assets/index-KchE_ngx.js +483 -0
package/public/os9-shell/assets/index-KchE_ngx.js.map +1 -0
package/public/os9-shell/index.html +10 -1
package/runtime/api-2d.js +301 -21
package/runtime/api-3d/pbr.js +45 -1
package/runtime/api-3d.js +1 -0
package/runtime/api-effects.js +90 -3
package/runtime/api-gameutils.js +476 -0
package/runtime/api-generative.js +610 -0
package/runtime/api-skybox.js +54 -0
package/runtime/api-voxel.js +139 -28
package/runtime/gpu-threejs.js +13 -9
package/runtime/ui.js +2 -2
package/src/main.js +24 -1
package/public/os9-shell/assets/index-B1Uvacma.js +0 -32825
package/public/os9-shell/assets/index-B1Uvacma.js.map +0 -1

package/dist/examples/super-plumber-64/index.html ADDED Viewed

@@ -0,0 +1,88 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Super Plumber 64 - Nova64</title>
+  <style>
+    body {
+      margin: 0;
+      padding: 0;
+      background: #111;
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      min-height: 100vh;
+      font-family: 'Courier New', monospace;
+      color: white;
+    }
+    #game-container {
+      position: relative;
+      max-width: 100vw;
+      max-height: 100vh;
+    }
+    canvas {
+      display: block;
+      image-rendering: pixelated;
+      image-rendering: crisp-edges;
+    }
+    #loading {
+      position: absolute;
+      top: 50%;
+      left: 50%;
+      transform: translate(-50%, -50%);
+      text-align: center;
+      font-size: 24px;
+      color: #ff0000;
+      text-shadow: 2px 2px 4px #000;
+    }
+  </style>
+</head>
+<body>
+  <div id="game-container">
+    <div id="loading">🎮 Loading Super Plumber 64...</div>
+    <canvas id="screen"></canvas>
+  </div>
+  <script type="module">
+    import { createRuntime } from '../../runtime/core.js';
+    const loadingEl = document.getElementById('loading');
+    async function startGame() {
+      try {
+        loadingEl.textContent = '🎮 Initializing Nova64...';
+        const gameModule = await import('./code.js');
+        loadingEl.textContent = '🎮 Starting Super Plumber 64...';
+        const runtime = createRuntime({
+          canvas: document.getElementById('screen'),
+          width: 640,
+          height: 360,
+          scale: 2,
+          game: gameModule
+        });
+        runtime.start();
+        loadingEl.style.display = 'none';
+        console.log('🎮 SUPER PLUMBER 64 - Ready!');
+        console.log('Controls:');
+        console.log('  Arrow Keys / WASD - Move');
+        console.log('  Space / Z - Jump (triple jump!)');
+        console.log('  Down + Jump in air - Ground Pound');
+        console.log('  Q/E - Rotate Camera');
+        console.log('  Gamepad supported!');
+      } catch (error) {
+        console.error('Failed to start game:', error);
+        loadingEl.textContent = '❌ Error loading game. Check console.';
+        loadingEl.style.color = '#ff0000';
+      }
+    }
+    startGame();
+  </script>
+</body>
+</html>

package/dist/examples/test-2d-overlay/code.js ADDED Viewed

@@ -0,0 +1,32 @@
+// MINIMAL 2D OVERLAY TEST - Tests if 2D rendering works AT ALL
+let testTime = 0;
+export async function init() {
+  console.log('🧪 MINIMAL 2D OVERLAY TEST - Starting...');
+  // Just setup a basic 3D scene so we have something
+  setCameraPosition(0, 5, 15);
+  setCameraTarget(0, 0, 0);
+  // Create one cube so we know 3D works
+  const cube = createCube(2, 0xff0000, [0, 0, 0]);
+  console.log('✅ Created test cube');
+}
+export function update(dt) {
+  testTime += dt;
+}
+export function draw() {
+  // ABSOLUTE SIMPLEST 2D DRAWING - Just a filled rectangle
+  console.log('🎨 Drawing 2D overlay...');
+  // Try to draw a big red rectangle
+  rect(100, 100, 400, 200, rgba8(255, 0, 0, 255), true);
+  // Try to draw text
+  print('HELLO 2D OVERLAY', 150, 150, rgba8(255, 255, 0, 255), 1);
+  console.log('✅ Draw calls completed');
+}

package/dist/examples/test-font/code.js ADDED Viewed

@@ -0,0 +1,51 @@
+// Font Test - Complete Character Set Demo
+// Testing uppercase, lowercase, symbols, arrows, and emoji handling
+export async function init() {
+  console.log('🔤 Font Test - Complete Character Set');
+}
+export function update() {}
+export function draw() {
+  cls(rgba8(20, 20, 40, 255));
+  // Title
+  print('NOVA64 FONT - COMPLETE TEST', 140, 10, rgba8(255, 200, 0, 255), 1);
+  // Uppercase
+  print('UPPERCASE: ABCDEFGHIJKLMNOPQRSTUVWXYZ', 20, 35, rgba8(255, 255, 255, 255), 1);
+  // Lowercase
+  print('lowercase: abcdefghijklmnopqrstuvwxyz', 20, 52, rgba8(0, 255, 200, 255), 1);
+  // Numbers
+  print('Numbers:   0123456789', 20, 69, rgba8(255, 255, 100, 255), 1);
+  // Punctuation
+  print("Symbols:   !?.,;:'-_()[]{}", 20, 86, rgba8(255, 150, 255, 255), 1);
+  print('           <>=+*&%$#@^~`"|\\/', 20, 103, rgba8(255, 150, 255, 255), 1);
+  // Arrows (Unicode)
+  print('Arrows:    ← → ↑ ↓ ↔ ↕', 20, 120, rgba8(100, 255, 100, 255), 1);
+  print('Controls:  ↑↓ UP/DOWN  ←→ LEFT/RIGHT', 20, 137, rgba8(200, 200, 255, 255), 1);
+  // Mixed case examples
+  print('Mixed:     Hello World! The Quick Brown Fox', 20, 154, rgba8(255, 200, 150, 255), 1);
+  print('           Jumps Over The Lazy Dog 123!', 20, 171, rgba8(255, 200, 150, 255), 1);
+  // Emoji handling (should strip or replace)
+  print('Emoji Test: 🎮 🚀 ⚡ ✨ (cleaned automatically)', 20, 195, rgba8(255, 100, 100, 255), 1);
+  // Game-style text examples
+  print('Game Text:', 20, 219, rgba8(0, 255, 255, 255), 1);
+  print('  SCORE: 1234567890', 20, 236, rgba8(255, 255, 0, 255), 1);
+  print('  HEALTH: [##########] 100%', 20, 253, rgba8(0, 255, 0, 255), 1);
+  print('  Press X to Fire! Press Z for Boost!', 20, 270, rgba8(200, 200, 200, 255), 1);
+  // Status
+  rect(20, 295, 600, 50, rgba8(0, 0, 0, 200), true);
+  rect(20, 295, 600, 50, rgba8(0, 255, 0, 255), false);
+  print('✅ All Characters Rendering Correctly!', 35, 303, rgba8(0, 255, 100, 255), 1);
+  print('No more ??? for lowercase, arrows, or emojis!', 35, 320, rgba8(150, 255, 150, 255), 1);
+}

package/dist/examples/test-minimal/code.js ADDED Viewed

@@ -0,0 +1,21 @@
+// ABSOLUTE MINIMUM TEST - Does 2D work at all?
+export async function init() {
+  console.log('⚡ ULTRA SIMPLE TEST');
+}
+export function update(dt) {
+  // Nothing
+}
+export function draw() {
+  // Draw ONE red rectangle - simplest possible test
+  console.log('🎨 Attempting to draw red rectangle...');
+  rect(50, 50, 200, 100, rgba8(255, 0, 0, 255), true);
+  console.log('✅ rect() called successfully');
+  // Draw text
+  console.log('🎨 Attempting to draw text...');
+  print('TEST TEXT', 100, 100, rgba8(255, 255, 0, 255), 1);
+  console.log('✅ print() called successfully');
+}

package/dist/examples/ui-demo/code.js ADDED Viewed

@@ -0,0 +1,306 @@
+// 🎨 Nova64 UI System Demo - First Class Interface
+// Showcases all professional UI components
+let demo = {
+  panel1: null,
+  panel2: null,
+  panel3: null,
+  buttons: [],
+  health: 75,
+  mana: 50,
+  exp: 380,
+  maxExp: 1000,
+  score: 12345,
+  time: 0,
+};
+export async function init() {
+  console.log('🎨 Nova64 UI System Demo - Loading...');
+  // Create demo panels
+  demo.panel1 = createPanel(20, 20, 280, 200, {
+    title: 'Player Stats',
+    borderColor: uiColors.primary,
+    shadow: true,
+    gradient: true,
+  });
+  demo.panel2 = createPanel(320, 20, 300, 150, {
+    title: 'Control Panel',
+    borderColor: uiColors.success,
+    shadow: true,
+    bgColor: rgba8(20, 40, 60, 220),
+  });
+  demo.panel3 = createPanel(20, 240, 600, 100, {
+    title: 'Button Showcase',
+    borderColor: uiColors.warning,
+    shadow: true,
+  });
+  // Create demo buttons
+  demo.buttons.push(
+    createButton(
+      40,
+      270,
+      120,
+      35,
+      'PRIMARY',
+      () => {
+        console.log('Primary clicked!');
+        demo.health = Math.min(100, demo.health + 10);
+      },
+      { normalColor: uiColors.primary }
+    )
+  );
+  demo.buttons.push(
+    createButton(
+      170,
+      270,
+      120,
+      35,
+      'SUCCESS',
+      () => {
+        console.log('Success clicked!');
+        demo.mana = Math.min(100, demo.mana + 15);
+      },
+      { normalColor: uiColors.success }
+    )
+  );
+  demo.buttons.push(
+    createButton(
+      300,
+      270,
+      120,
+      35,
+      'WARNING',
+      () => {
+        console.log('Warning clicked!');
+        demo.exp += 50;
+      },
+      { normalColor: uiColors.warning }
+    )
+  );
+  demo.buttons.push(
+    createButton(
+      430,
+      270,
+      120,
+      35,
+      'DANGER',
+      () => {
+        console.log('Danger clicked!');
+        demo.health = Math.max(0, demo.health - 20);
+      },
+      { normalColor: uiColors.danger }
+    )
+  );
+  demo.buttons.push(
+    createButton(
+      560,
+      270,
+      50,
+      35,
+      'X',
+      () => {
+        console.log('Close clicked!');
+      },
+      {
+        normalColor: rgba8(100, 100, 100, 255),
+        textColor: uiColors.white,
+      }
+    )
+  );
+  console.log('✅ UI Demo Ready!');
+  console.log('🖱️  Click buttons to interact');
+}
+export function update(dt) {
+  demo.time += dt;
+  // Simulate mouse position from keyboard for demo
+  // In real game, you'd use actual mouse input
+  if (isKeyDown('arrowleft')) {
+    setMousePosition(Math.max(0, getMousePosition().x - 200 * dt), getMousePosition().y);
+  }
+  if (isKeyDown('arrowright')) {
+    setMousePosition(Math.min(640, getMousePosition().x + 200 * dt), getMousePosition().y);
+  }
+  if (isKeyDown('arrowup')) {
+    setMousePosition(getMousePosition().x, Math.max(0, getMousePosition().y - 200 * dt));
+  }
+  if (isKeyDown('arrowdown')) {
+    setMousePosition(getMousePosition().x, Math.min(360, getMousePosition().y + 200 * dt));
+  }
+  // Space to click
+  setMouseButton(isKeyDown('space'));
+  // Update all buttons
+  updateAllButtons();
+  // Animate values
+  if (demo.health < 100) demo.health += dt * 2;
+  if (demo.mana < 100) demo.mana += dt * 3;
+}
+export function draw() {
+  // Clear background
+  cls();
+  // Draw gradient background
+  drawGradientRect(0, 0, 640, 360, rgba8(10, 10, 30, 255), rgba8(30, 10, 50, 255), true);
+  // Draw all panels
+  drawAllPanels();
+  // ============================================
+  // Panel 1: Player Stats
+  // ============================================
+  setFont('normal');
+  setTextAlign('left');
+  setTextBaseline('top');
+  // Health bar
+  drawText('HEALTH', 40, 50, uiColors.danger, 1);
+  uiProgressBar(40, 70, 240, 20, demo.health, 100, {
+    fillColor:
+      demo.health > 50 ? uiColors.success : demo.health > 25 ? uiColors.warning : uiColors.danger,
+    showText: true,
+  });
+  // Mana bar
+  drawText('MANA', 40, 100, uiColors.primary, 1);
+  uiProgressBar(40, 120, 240, 20, demo.mana, 100, {
+    fillColor: uiColors.primary,
+    showText: true,
+  });
+  // Experience bar
+  drawText('EXPERIENCE', 40, 150, uiColors.warning, 1);
+  uiProgressBar(40, 170, 240, 20, demo.exp, demo.maxExp, {
+    fillColor: uiColors.warning,
+    showText: true,
+  });
+  // Level indicator
+  setFont('large');
+  setTextAlign('center');
+  setTextBaseline('middle');
+  const level = Math.floor(demo.exp / 1000) + 1;
+  drawTextShadow('LVL ' + level, 280, 200, uiColors.white, rgba8(0, 0, 0, 200), 3, 1);
+  // ============================================
+  // Panel 2: Control Panel
+  // ============================================
+  setFont('normal');
+  setTextAlign('left');
+  setTextBaseline('top');
+  // Score with outline
+  setFont('large');
+  const scoreText = 'SCORE: ' + demo.score.toString().padStart(8, '0');
+  drawTextOutline(scoreText, 340, 50, uiColors.warning, rgba8(0, 0, 0, 255), 1);
+  // Time
+  setFont('normal');
+  const minutes = Math.floor(demo.time / 60);
+  const seconds = Math.floor(demo.time % 60);
+  const timeText = `TIME: ${minutes}:${seconds.toString().padStart(2, '0')}`;
+  drawText(timeText, 340, 90, uiColors.light, 1);
+  // Status indicators
+  drawText('STATUS: ACTIVE', 340, 115, uiColors.success, 1);
+  // Pulsing indicator
+  const pulse = Math.sin(demo.time * 3) * 0.5 + 0.5;
+  const pulseColor = rgba8(0, 255, 0, Math.floor(pulse * 255));
+  circle(560, 125, 5, pulseColor, true);
+  // ============================================
+  // Panel 3: Buttons
+  // ============================================
+  drawAllButtons();
+  // ============================================
+  // Header Title
+  // ============================================
+  setFont('huge');
+  setTextAlign('center');
+  setTextBaseline('top');
+  const titleY = 5 + Math.sin(demo.time * 2) * 2;
+  drawTextOutline('NOVA64 UI SYSTEM', 320, titleY, uiColors.primary, rgba8(0, 0, 0, 255), 1);
+  // ============================================
+  // Instructions
+  // ============================================
+  setFont('small');
+  setTextAlign('center');
+  setTextBaseline('bottom');
+  drawText(
+    'ARROW KEYS: Move Cursor  |  SPACE: Click  |  Buttons: Test UI',
+    320,
+    355,
+    rgba8(200, 200, 200, 255),
+    1
+  );
+  // ============================================
+  // Cursor
+  // ============================================
+  const mouse = getMousePosition();
+  // Cursor shadow
+  line(mouse.x + 2, mouse.y + 2, mouse.x + 12, mouse.y + 12, rgba8(0, 0, 0, 150));
+  line(mouse.x + 2, mouse.y + 2, mouse.x + 7, mouse.y + 12, rgba8(0, 0, 0, 150));
+  // Cursor
+  line(mouse.x, mouse.y, mouse.x + 10, mouse.y + 10, uiColors.white);
+  line(mouse.x, mouse.y, mouse.x + 5, mouse.y + 10, uiColors.white);
+  line(mouse.x + 5, mouse.y + 10, mouse.x + 10, mouse.y + 10, uiColors.white);
+  // Cursor highlight
+  if (isMouseDown()) {
+    circle(mouse.x, mouse.y, 15, rgba8(255, 255, 0, 100), false);
+  } else {
+    circle(mouse.x, mouse.y, 12, rgba8(255, 255, 255, 80), false);
+  }
+  // ============================================
+  // Font Showcase (bottom right)
+  // ============================================
+  setTextAlign('right');
+  setTextBaseline('bottom');
+  let fontY = 340;
+  setFont('tiny');
+  drawText('Tiny Font', 630, fontY, uiColors.light, 1);
+  fontY -= 10;
+  setFont('small');
+  drawText('Small Font', 630, fontY, uiColors.light, 1);
+  fontY -= 12;
+  setFont('normal');
+  drawText('Normal Font', 630, fontY, uiColors.light, 1);
+  fontY -= 14;
+  setFont('large');
+  drawText('Large Font', 630, fontY, uiColors.light, 1);
+  fontY -= 18;
+  setFont('huge');
+  drawText('Huge Font', 630, fontY, uiColors.light, 1);
+}

package/dist/examples/wing-commander-space/README.md ADDED Viewed

@@ -0,0 +1,180 @@
+# Wing Commander Space Combat
+A first-person space combat game inspired by Wing Commander, featuring asteroid field combat and enemy fighters.
+## Features
+### ✅ First-Person Cockpit View
+- True first-person camera from pilot perspective
+- 6-degrees of freedom flight (pitch, yaw, roll)
+- Camera stays at origin, world moves around you
+- Smooth camera shake on hits
+### ✅ Flight Controls
+- **Arrow Keys**: Pitch and Yaw (up/down/left/right)
+- **Q/E**: Roll (barrel roll left/right)
+- **W/S**: Speed up/slow down
+- **SHIFT**: Boost (drains energy)
+- **Z/SPACE**: Fire lasers
+- **X**: Fire homing missile
+### ✅ Combat System
+- **Dual lasers** firing from wing positions
+- **Homing missiles** that track enemies
+- **Enemy fighters** with AI attack patterns:
+  - Straight attack
+  - Weaving maneuvers
+  - Circle strafing
+- **Asteroids** to dodge and destroy
+### ✅ Game Mechanics
+- Health and shield system
+- Energy management (regenerates when not boosting)
+- Weapon cooldowns
+- Limited missiles (20 per mission)
+- Score and kill tracking
+- Progressive difficulty (more enemies spawn)
+### ✅ Visual Effects
+- Star field background
+- Explosion effects with particles
+- Laser trails
+- Missile smoke trails
+- Screen shake on impacts
+- HUD with all vital information
+### ✅ Fixed Start Button Issue
+- **ENTER key** works to start game
+- **SPACE key** works to start game
+- **Mouse click** on START button works
+- Uses `isKeyDown()` instead of `isKeyPressed()` for reliable detection
+## HUD Information
+### Top Left Panel
+- **SCORE**: Points earned
+- **KILLS**: Enemies destroyed
+- **HULL**: Ship health (red bar)
+- **SHIELD**: Shield energy (blue bar)
+### Top Right Panel
+- **ENERGY**: Boost and weapon energy (green bar)
+- **SPEED**: Current velocity
+### Center Top Panel
+- **WEAPONS**: Laser and missile status
+- Shows cooldown and ammo count
+### Bottom Center (When Targeting)
+- **TARGET**: Distance to nearest enemy
+### Center
+- **Crosshair**: Green targeting reticle with corner brackets
+## Gameplay Tips
+1. **Keep Moving**: Stationary targets are easy to hit
+2. **Manage Energy**: Boost when needed, regenerate when safe
+3. **Use Missiles Wisely**: Only 20 missiles, save for tough enemies
+4. **Shield First**: Shields regenerate, hull damage doesn't
+5. **Aim Ahead**: Lasers have travel time
+6. **Dodge Asteroids**: They do massive damage
+7. **Roll and Weave**: Use Q/E to barrel roll out of danger
+## Enemy Patterns
+### Fighter Types
+1. **Straight Attackers**: Rush directly at you
+2. **Weavers**: Zigzag while approaching
+3. **Circle Strafers**: Orbit around you while firing
+### Strategy
+- Missiles work best on straight attackers
+- Lead your shots against weavers
+- Circle strafers require prediction
+## Technical Details
+### Camera System
+```javascript
+// First-person view - camera at origin, world moves
+setCameraPosition(0, 0, 0);
+setCameraTarget(lookX, lookY, lookZ); // Based on ship rotation
+```
+### Movement System
+```javascript
+// Ship rotation affects forward direction
+forward.x = -sin(yaw) * cos(pitch);
+forward.y = sin(pitch);
+forward.z = -cos(yaw) * cos(pitch);
+// World moves opposite to player velocity
+worldPos -= playerVelocity * deltaTime;
+```
+### Collision Detection
+- Sphere-sphere collision for all objects
+- Distance checks for laser hits
+- Proximity detection for player collisions
+## Configuration
+Edit `CONFIG` object to tune gameplay:
+```javascript
+const CONFIG = {
+  SHIP_SPEED: 20, // Base speed
+  SHIP_TURN_SPEED: 2.5, // Rotation speed
+  SHIP_BOOST_MULTIPLIER: 2, // Boost factor
+  LASER_SPEED: 80, // Laser velocity
+  LASER_COOLDOWN: 0.15, // Seconds between shots
+  MISSILE_SPEED: 40, // Missile velocity
+  MISSILE_COOLDOWN: 1.0, // Seconds between launches
+  ASTEROID_SPAWN_DISTANCE: 100, // Spawn distance
+};
+```
+## Future Enhancements
+- [ ] Cockpit frame overlay
+- [ ] Power-up pickups (health, missiles, energy)
+- [ ] Multiple weapon types
+- [ ] Boss battles
+- [ ] Mission objectives
+- [ ] Wingman AI allies
+- [ ] Capital ship battles
+- [ ] Hyperspace jumps between sectors
+- [ ] Saving/loading progress
+- [ ] Sound effects and music
+## Known Issues
+- None currently!
+## Credits
+Inspired by:
+- Wing Commander series
+- X-Wing vs TIE Fighter
+- Freespace 2
+- Elite Dangerous
+Built with Nova64 fantasy console.