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/physics.html ADDED Viewed

@@ -0,0 +1,311 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Physics Engine - 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>⚛️ Physics Engine</h1>
+            <p class="subtitle">Simple physics simulation with gravity, velocity, and forces</p>
+        </header>
+      <section>
+        <h2>📋 Overview</h2>
+        <p>The Physics Engine provides basic 2D/3D physics simulation including gravity, velocity, acceleration, and force application perfect for platformers and arcade games.</p>
+        <div class="note">
+          <div class="note-title">💡 Key Features</div>
+          <ul><li><strong>Gravity</strong> - Automatic downward force</li><li><strong>Velocity</strong> - Object movement with speed and direction</li><li><strong>Acceleration</strong> - Force-based movement</li><li><strong>Particle Systems</strong> - Efficient multi-object physics</li></ul>
+        </div>
+      </section>
+      <section>
+        <h2>⚛️ Physics Functions</h2>
+        <div class="function">
+          <div class="function-sig">applyGravity(object, gravity)</div>
+          <p>Applies gravity force to an object.</p>
+          <div class="param-list">
+              <div class="param">
+                <span class="param-name">object</span>
+                <span class="param-type">object</span> - Object with velocityY property
+              </div>
+              <div class="param">
+                <span class="param-name">gravity</span>
+                <span class="param-type">number</span> - Gravity strength (e.g., 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>applyGravity(player, 0.8);</code></pre>
+          </div>
+        </div>
+        <div class="function">
+          <div class="function-sig">updateVelocity(object)</div>
+          <p>Updates object position based on velocity.</p>
+          <div class="param-list">
+              <div class="param">
+                <span class="param-name">object</span>
+                <span class="param-type">object</span> - Object with x, y, velocityX, velocityY
+              </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>updateVelocity(player);</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/screens.html ADDED Viewed

@@ -0,0 +1,311 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Screen Manager - 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>📺 Screen Manager</h1>
+            <p class="subtitle">Multi-screen game state management (title, gameplay, game over)</p>
+        </header>
+      <section>
+        <h2>�� Overview</h2>
+        <p>The Screen Manager handles transitions between different game states like title screen, gameplay, pause menu, and game over.</p>
+        <div class="note">
+          <div class="note-title">💡 Screen Lifecycle</div>
+          <ul><li><strong>init()</strong> - Called when screen is created</li><li><strong>enter()</strong> - Called when switching to this screen</li><li><strong>update()</strong> - Called every frame while active</li><li><strong>draw()</strong> - Render the screen</li><li><strong>exit()</strong> - Called when leaving screen</li></ul>
+        </div>
+      </section>
+      <section>
+        <h2>📺 Screen Functions</h2>
+        <div class="function">
+          <div class="function-sig">addScreen(name, screenObject)</div>
+          <p>Registers a new screen.</p>
+          <div class="param-list">
+              <div class="param">
+                <span class="param-name">name</span>
+                <span class="param-type">string</span> - Screen identifier
+              </div>
+              <div class="param">
+                <span class="param-name">screenObject</span>
+                <span class="param-type">object</span> - Object with init, update, draw methods
+              </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>addScreen("title", { update() {}, draw() {} });</code></pre>
+          </div>
+        </div>
+        <div class="function">
+          <div class="function-sig">switchScreen(name)</div>
+          <p>Switches to a different screen.</p>
+          <div class="param-list">
+              <div class="param">
+                <span class="param-name">name</span>
+                <span class="param-type">string</span> - Screen name to switch to
+              </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>if (btnp(12)) switchScreen("gameplay");</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>