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

nova64 0.2.5 → 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 +20 -0
package/public/os9-shell/assets/index-B1Uvacma.js +0 -32825
package/public/os9-shell/assets/index-B1Uvacma.js.map +0 -1

package/dist/docs/api-effects.html ADDED Viewed

@@ -0,0 +1,385 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Visual Effects - Nova64 Documentation</title>
+    <style>
+        :root {
+            --bg-primary: #0f1115;
+            --bg-secondary: #151822;
+            --bg-tertiary: #1a1d2e;
+            --text-primary: #dcdfe4;
+            --text-secondary: #99a1b3;
+            --accent-cyan: #00ffff;
+            --accent-magenta: #ff0080;
+            --accent-yellow: #ffff00;
+            --border: #2a324a;
+            --code-bg: #1a1d2e;
+        }
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+        body {
+            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+            background: linear-gradient(135deg, var(--bg-primary) 0%, #1a1625 50%, var(--bg-primary) 100%);
+            background-attachment: fixed;
+            color: var(--text-primary);
+            line-height: 1.6;
+        }
+        .container {
+            max-width: 1200px;
+            margin: 0 auto;
+            padding: 20px;
+        }
+        header {
+            background: var(--bg-secondary);
+            border: 2px solid var(--accent-cyan);
+            border-radius: 12px;
+            padding: 30px;
+            margin-bottom: 30px;
+            box-shadow: 0 0 30px rgba(0, 255, 255, 0.3);
+        }
+        h1 {
+            color: var(--accent-cyan);
+            font-size: 2.5em;
+            text-shadow: 0 0 20px rgba(0, 255, 255, 0.6);
+            margin-bottom: 10px;
+        }
+        .back-link {
+            display: inline-block;
+            color: var(--accent-cyan);
+            text-decoration: none;
+            margin-bottom: 15px;
+            transition: color 0.3s ease;
+        }
+        .back-link:hover {
+            color: #33ffff;
+            text-decoration: underline;
+        }
+        .subtitle {
+            color: var(--text-secondary);
+            font-size: 1.1em;
+        }
+        section {
+            background: var(--bg-secondary);
+            border-left: 4px solid var(--accent-cyan);
+            padding: 25px;
+            margin-bottom: 30px;
+            border-radius: 8px;
+        }
+        h2 {
+            color: var(--accent-magenta);
+            font-size: 2em;
+            margin-bottom: 15px;
+            text-shadow: 0 0 10px rgba(255, 0, 128, 0.5);
+        }
+        h3 {
+            color: var(--accent-cyan);
+            font-size: 1.4em;
+            margin: 25px 0 15px 0;
+        }
+        .function {
+            background: var(--bg-tertiary);
+            border: 1px solid var(--border);
+            border-radius: 8px;
+            padding: 20px;
+            margin-bottom: 25px;
+        }
+        .function-sig {
+            font-family: 'Courier New', Courier, monospace;
+            font-size: 1.2em;
+            color: var(--accent-yellow);
+            margin-bottom: 15px;
+            padding: 10px;
+            background: var(--code-bg);
+            border-radius: 4px;
+            border-left: 3px solid var(--accent-yellow);
+        }
+        .param-list, .return-info {
+            margin: 15px 0;
+        }
+        .param {
+            padding: 8px 0;
+            border-bottom: 1px solid var(--border);
+        }
+        .param:last-child {
+            border-bottom: none;
+        }
+        .param-name {
+            color: var(--accent-cyan);
+            font-weight: bold;
+            font-family: 'Courier New', Courier, monospace;
+        }
+        .param-type {
+            color: var(--accent-magenta);
+            font-style: italic;
+            font-size: 0.9em;
+        }
+        .example {
+            background: var(--code-bg);
+            border: 1px solid var(--border);
+            border-radius: 8px;
+            padding: 20px;
+            margin: 15px 0;
+            overflow-x: auto;
+        }
+        .example-title {
+            color: var(--accent-yellow);
+            font-weight: bold;
+            margin-bottom: 10px;
+        }
+        pre {
+            margin: 0;
+            font-family: 'Courier New', Courier, monospace;
+            line-height: 1.5;
+        }
+        code {
+            color: var(--text-primary);
+        }
+        .note {
+            background: var(--bg-tertiary);
+            border-left: 4px solid var(--accent-yellow);
+            padding: 15px;
+            margin: 15px 0;
+            border-radius: 4px;
+        }
+        .note-title {
+            color: var(--accent-yellow);
+            font-weight: bold;
+            margin-bottom: 10px;
+        }
+        table {
+            width: 100%;
+            border-collapse: collapse;
+            margin: 15px 0;
+        }
+        th, td {
+            padding: 12px;
+            text-align: left;
+            border: 1px solid var(--border);
+        }
+        th {
+            background: var(--bg-tertiary);
+            color: var(--accent-cyan);
+            font-weight: bold;
+        }
+        tr:nth-child(even) {
+            background: var(--bg-tertiary);
+        }
+        footer {
+            text-align: center;
+            padding: 30px 20px;
+            color: var(--text-secondary);
+            border-top: 1px solid var(--border);
+            margin-top: 40px;
+        }
+        ul {
+            margin-left: 20px;
+            margin-top: 10px;
+        }
+        li {
+            margin: 5px 0;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <a href="index.html" class="back-link">← Back to Documentation Index</a>
+        <header>
+            <h1>✨ Visual Effects</h1>
+            <p class="subtitle">Post-processing effects like bloom, chromatic aberration, and CRT scanlines</p>
+        </header>
+      <section>
+        <h2>📋 Overview</h2>
+        <p>The Effects API provides stunning post-processing effects to enhance your game's visual style, from retro CRT effects to modern bloom and color grading.</p>
+        <div class="note">
+          <div class="note-title">💡 Available Effects</div>
+          <ul><li><strong>Bloom</strong> - Glow effect for lights and bright objects</li><li><strong>Chromatic Aberration</strong> - RGB color split for retro/glitch aesthetic</li><li><strong>CRT Scanlines</strong> - Classic monitor effect</li><li><strong>FXAA</strong> - Fast anti-aliasing for smooth edges</li><li><strong>Color Grading</strong> - Adjust brightness, contrast, saturation</li></ul>
+        </div>
+      </section>
+      <section>
+        <h2>✨ Effect Functions</h2>
+        <div class="function">
+          <div class="function-sig">enableBloom(intensity, threshold)</div>
+          <p>Enables bloom glow effect.</p>
+          <div class="param-list">
+              <div class="param">
+                <span class="param-name">intensity</span>
+                <span class="param-type">number</span> - Bloom strength (0-3, default: 1)
+              </div>
+              <div class="param">
+                <span class="param-name">threshold</span>
+                <span class="param-type">number</span> - Brightness threshold (0-1, default: 0.8)
+              </div>
+          </div>
+          <div class="return-info">
+            <strong>Returns:</strong> <span class="param-type">void</span> - No return value
+          </div>
+          <div class="example">
+            <div class="example-title">Example:</div>
+            <pre><code>enableBloom(1.5, 0.7); // Strong bloom effect</code></pre>
+          </div>
+        </div>
+        <div class="function">
+          <div class="function-sig">enableChromaticAberration(strength)</div>
+          <p>Enables RGB color split effect.</p>
+          <div class="param-list">
+              <div class="param">
+                <span class="param-name">strength</span>
+                <span class="param-type">number</span> - Effect intensity (0-0.05, default: 0.002)
+              </div>
+          </div>
+          <div class="return-info">
+            <strong>Returns:</strong> <span class="param-type">void</span> - No return value
+          </div>
+          <div class="example">
+            <div class="example-title">Example:</div>
+            <pre><code>enableChromaticAberration(0.005);</code></pre>
+          </div>
+        </div>
+        <div class="function">
+          <div class="function-sig">enableGlitch(intensity)</div>
+          <p>Enables screen glitch post-processing effect with scanline displacement, RGB channel split, block artifacts, and random color corruption. Great for damage feedback or digital distortion effects.</p>
+          <div class="param-list">
+              <div class="param">
+                <span class="param-name">intensity</span>
+                <span class="param-type">number</span> - Glitch intensity (0-1, default: 0.5)
+              </div>
+          </div>
+          <div class="return-info">
+            <strong>Returns:</strong> <span class="param-type">void</span> - No return value
+          </div>
+          <div class="example">
+            <div class="example-title">Example:</div>
+            <pre><code>// Trigger glitch on damage, then fade out
+enableGlitch(0.6);
+// Later, adjust intensity
+setGlitchIntensity(0.2);
+// When done
+disableGlitch();</code></pre>
+          </div>
+        </div>
+        <div class="function">
+          <div class="function-sig">disableGlitch()</div>
+          <p>Disables the screen glitch effect.</p>
+        </div>
+        <div class="function">
+          <div class="function-sig">setGlitchIntensity(intensity)</div>
+          <p>Adjusts glitch intensity without recreating the shader pass. Useful for smooth fade-out effects.</p>
+          <div class="param-list">
+              <div class="param">
+                <span class="param-name">intensity</span>
+                <span class="param-type">number</span> - Glitch intensity (0-1)
+              </div>
+          </div>
+        </div>
+        <div class="function">
+          <div class="function-sig">enableScanlines(intensity)</div>
+          <p>Enables CRT scanline effect.</p>
+          <div class="param-list">
+              <div class="param">
+                <span class="param-name">intensity</span>
+                <span class="param-type">number</span> - Scanline darkness (0-1, default: 0.3)
+              </div>
+          </div>
+          <div class="return-info">
+            <strong>Returns:</strong> <span class="param-type">void</span> - No return value
+          </div>
+          <div class="example">
+            <div class="example-title">Example:</div>
+            <pre><code>enableScanlines(0.5); // Retro CRT look</code></pre>
+          </div>
+        </div>
+      </section>
+        <footer>
+            <p>Nova64 Fantasy Console © 2025 | <a href="index.html" style="color: var(--accent-cyan);">Back to Documentation</a></p>
+        </footer>
+    </div>
+</body>
+</html>

package/dist/docs/api-improvements.md ADDED Viewed

@@ -0,0 +1,121 @@
+# Nova64 API Improvement Roadmap
+A prioritized list of bugs, gaps, and enhancements to make the Nova64 API easier for cart authors to use.
+---
+## 🔴 Bugs — Broken Right Now
+### 1. `createCylinder()` produces a box
+**File:** `runtime/api-3d.js`
+`createCylinder()` calls `gpu.createCylinderGeometry()` which does not exist on `GpuThreeJS`. It silently falls back to `createBoxGeometry`, so every cylinder is a box.
+**Fix:** Add `createCylinderGeometry(rt, rb, h, segs)` to `gpu-threejs.js` using `THREE.CylinderGeometry`.
+### 2. Game-studio code uses wrong skybox API names
+**File:** `src/main.js` lines 318–319
+The `EXECUTE_CODE` message handler passes `skyApi.createSkybox`, `skyApi.updateSkybox`, and `skyApi.removeSkybox` — none of which exist. The actual names are `createSpaceSkybox`, `animateSkybox`, and `clearSkybox`. Skybox is silently broken in the game-studio execution path.
+**Fix:** Update those three references to the correct names.
+### 3. `galaxySpiral` option is accepted but does nothing
+**File:** `runtime/api-skybox.js`
+`createSpaceSkybox({ galaxySpiral: true })` destructures the option but never uses it in the geometry.
+**Fix:** Either implement a spiral star-field variant or remove the option entirely to avoid confusion.
+---
+## 🟡 Missing Features — Hard to Use Without
+### 4. Skybox rotation speed is hardcoded
+**File:** `runtime/api-skybox.js`
+`animateSkybox(dt)` always rotates at `dt * 0.01`. There is no way for a cart to slow it down, speed it up, pause it, or reverse it.
+**Add:**
+```js
+setSkyboxSpeed(multiplier); // e.g. 0 = frozen, 2.0 = double speed, -1 = reverse
+```
+### 5. Cart authors must manually call `animateSkybox(dt)` every frame
+**File:** `runtime/api-skybox.js`
+Forgetting to call it in `update()` is the most common skybox mistake. The engine already has a frame loop — skybox animation should be opt-in automatic.
+**Add:**
+```js
+enableSkyboxAutoAnimate((speed = 1.0)); // engine calls animateSkybox internally
+disableSkyboxAutoAnimate();
+```
+### 6. Only one skybox type (procedural space)
+**File:** `runtime/api-skybox.js`
+There is no way to create a daytime sky, sunset, cave, or interior environment. Only the star-field + nebula preset exists.
+**Add:**
+```js
+createGradientSkybox(topColor, bottomColor, horizonColor?)
+// e.g. createGradientSkybox(0x1a6aa8, 0xf4a460)  → sunset
+createSolidSkybox(color)
+// e.g. createSolidSkybox(0x000000)  → cave / indoor
+createImageSkybox([px, nx, py, ny, pz, nz])
+// cube-face textures for full photorealistic environments
+```
+### 7. `removeMesh` vs `destroyMesh` mismatch
+**Files:** `runtime/api-3d.js`, `CLAUDE.md`, demos
+`CLAUDE.md` and several demos reference `removeMesh()` but the exposed function is `destroyMesh()`. This causes silent no-ops when cart authors follow the documentation.
+**Fix:** Add `removeMesh` as an alias for `destroyMesh`, or rename throughout and update docs.
+### 8. Missing 3D primitives
+Useful shapes absent from the API:
+- `createCone(radius, height, color, position, opts)` — projectiles, trees, hat shapes
+- `createCapsule(radius, height, color, position, opts)` — humanoid character bodies
+---
+## 🟢 Quality-of-Life Improvements
+### 9. `printCentered` is not discoverable
+**File:** `runtime/api-2d.js`
+`printCentered(text, y, color)` exists and works well, but many demos re-implement text centering manually because `print()` dominates examples. The function should be demonstrated in at least one prominent demo.
+### 10. `createPointLight` signature unclear
+**File:** `runtime/api-3d.js`
+`createPointLight` exists but its signature (does it take intensity? color? range?) is not documented and not obvious from usage in demos. Add clear JSDoc and a usage example.
+### 11. `print()` has no size parameter — requires `setFont()` call first
+Cart authors wanting larger HUD text must call `setFont('large')` before `print()` and reset it after. A convenience overload `print(text, x, y, color, size?)` would reduce boilerplate.
+### 12. No built-in crosshair / reticle helper
+Several FPS and space-shooter demos manually draw a crosshair using `line()` or `rect()`. A simple `drawCrosshair(x, y, size, color, style?)` in `api-2d.js` would reduce copy-paste code.
+---
+## Summary Priority Order
+| #   | Issue                                   | Priority   | Effort |
+| --- | --------------------------------------- | ---------- | ------ |
+| 1   | `createCylinder()` broken               | 🔴 Bug     | Low    |
+| 2   | Game-studio skybox API names wrong      | 🔴 Bug     | Low    |
+| 3   | `galaxySpiral` no-op                    | 🔴 Bug     | Low    |
+| 4   | Skybox speed control                    | 🟡 Missing | Low    |
+| 5   | Auto-animate skybox                     | 🟡 Missing | Medium |
+| 6   | More skybox types                       | 🟡 Missing | High   |
+| 7   | `removeMesh` alias                      | 🟡 Missing | Low    |
+| 8   | Cone + Capsule primitives               | 🟡 Missing | Medium |
+| 9   | Improve `printCentered` discoverability | 🟢 QoL     | Low    |
+| 10  | Document `createPointLight` signature   | 🟢 QoL     | Low    |
+| 11  | `print()` size shorthand                | 🟢 QoL     | Low    |
+| 12  | `drawCrosshair()` helper                | 🟢 QoL     | Low    |