@plasius/gpu-demo-viewer 0.1.0

package/viewer-manifest.js

@@ -0,0 +1,293 @@
+export const demos = [
+  {
+    id: "integration-showcase",
+    packageName: "@plasius/gpu-demo-viewer",
+    type: "browser",
+    mode: "Unified 3D integration showcase",
+    runtime: "3D canvas + GLTF rigid bodies",
+    launchLabel: "Open showcase",
+    launchPath: "./showcase/",
+    sourcePath: "./showcase/main.js",
+    docsPath: "./README.md",
+    command: "cd gpu-demo-viewer && npm run demo",
+    summary: "Flag-by-the-sea 3D validation scene combining moonlit GLTF ships, lantern lighting, cloth, fluid, lighting, debug telemetry, adaptive performance, and mass-aware collisions.",
+    notes: [
+      "This is the top-level cross-package validation surface.",
+      "The ships are loaded from GLTF and expose physics metadata used by the collision loop.",
+      "The shared showcase now uses moonlight, ship lanterns, and heavier-vs-lighter hull responses to make collision reads more realistic."
+    ],
+    tags: ["browser", "3d", "integration"]
+  },
+  {
+    id: "wavefront-path-tracing",
+    packageName: "@plasius/gpu-renderer",
+    type: "browser",
+    mode: "Experimental mesh BVH wavefront demo",
+    runtime: "WebGPU mesh BVH wavefront renderer",
+    launchLabel: "Open wavefront demo",
+    launchPath: "./wavefront/?experimental=wavefront",
+    sourcePath: "./wavefront/main.js",
+    docsPath: "./README.md",
+    command: "cd gpu-demo-viewer && npm run demo",
+    summary:
+      "Screen-pixel rays are processed by the renderer WebGPU mesh BVH path through hit records, material evaluation, emissive/skybox termination, reflection, refraction, fluid interaction, and max-depth dark paths.",
+    notes: [
+      "This demo uses the renderer mesh input contract and requires display-quality mesh BVH execution.",
+      "The scene includes emissive mesh geometry, skybox misses, reflective and refractive smooth triangle meshes, a transparent fluid surface, smooth normals, and a dark no-light target.",
+      "Use capture mode for deterministic 540p validation frames while the GPU shader implementation remains experimental."
+    ],
+    tags: ["browser", "3d", "integration", "experimental"]
+  },
+  {
+    id: "gpu-camera",
+    packageName: "@plasius/gpu-camera",
+    type: "browser",
+    mode: "3D camera orchestration demo",
+    runtime: "Shared 3D harbor scene + camera overlays",
+    launchLabel: "Open browser demo",
+    launchPath: "../gpu-camera/demo/",
+    sourcePath: "../gpu-camera/demo/main.js",
+    docsPath: "../gpu-camera/README.md",
+    command: "cd gpu-camera && npm run demo",
+    summary: "Camera registration, switching, and multiview planning validated against a mounted 3D harbor scene.",
+    notes: [
+      "The scene is family-owned through gpu-shared while gpu-camera controls active-view and multiview planning state.",
+      "Use it to validate camera transitions on a real 3D surface instead of a state-only page."
+    ],
+    tags: ["browser", "3d"]
+  },
+  {
+    id: "gpu-cloth",
+    packageName: "@plasius/gpu-cloth",
+    type: "browser",
+    mode: "3D continuity demo",
+    runtime: "3D harbor scene",
+    launchLabel: "Open browser demo",
+    launchPath: "../gpu-cloth/demo/",
+    sourcePath: "../gpu-cloth/demo/main.js",
+    docsPath: "../gpu-cloth/README.md",
+    command: "cd gpu-cloth && npm run demo",
+    summary: "Cloth continuity preview in the shared 3D harbor scene with the flag as the primary near-field hero asset.",
+    notes: [
+      "This browser demo reuses the shared 3D showcase runtime for consistent visual validation.",
+      "The flag cloth remains the package focus while ships, water, and lighting provide context."
+    ],
+    tags: ["browser", "3d"]
+  },
+  {
+    id: "gpu-debug",
+    packageName: "@plasius/gpu-debug",
+    type: "browser",
+    mode: "3D telemetry demo",
+    runtime: "3D harbor scene + debug overlays",
+    launchLabel: "Open browser demo",
+    launchPath: "../gpu-debug/demo/",
+    sourcePath: "../gpu-debug/demo/main.js",
+    docsPath: "../gpu-debug/README.md",
+    command: "cd gpu-debug && npm run demo",
+    summary: "Live debug telemetry surfaced alongside the same 3D harbor scene it is measuring.",
+    notes: [
+      "Queue depth, dispatch timing, frame cadence, and pipeline stages update against the active 3D scene.",
+      "Use this when you want the telemetry to be tied to visible scene pressure."
+    ],
+    tags: ["browser", "3d"]
+  },
+  {
+    id: "gpu-fluid",
+    packageName: "@plasius/gpu-fluid",
+    type: "browser",
+    mode: "3D continuity demo",
+    runtime: "3D harbor scene",
+    launchLabel: "Open browser demo",
+    launchPath: "../gpu-fluid/demo/",
+    sourcePath: "../gpu-fluid/demo/main.js",
+    docsPath: "../gpu-fluid/README.md",
+    command: "cd gpu-fluid && npm run demo",
+    summary: "Fluid continuity preview in the shared 3D harbor scene with distance-banded water surfaces and consistent wave motion.",
+    notes: [
+      "The water surface stays continuous across near, mid, far, and horizon bands in the same scene.",
+      "This replaces the earlier flat preview with a real 3D validation surface."
+    ],
+    tags: ["browser", "3d"]
+  },
+  {
+    id: "gpu-lighting",
+    packageName: "@plasius/gpu-lighting",
+    type: "browser",
+    mode: "3D lighting demo",
+    runtime: "3D harbor scene + lighting overlays",
+    launchLabel: "Open browser demo",
+    launchPath: "../gpu-lighting/demo/",
+    sourcePath: "../gpu-lighting/demo/main.js",
+    docsPath: "../gpu-lighting/README.md",
+    command: "cd gpu-lighting && npm run demo",
+    summary: "Distance-banded lighting preview in a 3D harbor scene with GLTF ships and live lighting policy overlays.",
+    notes: [
+      "The lighting package now presents a 3D canvas rather than a catalog-only page.",
+      "Use it to validate lighting band behavior in visible context."
+    ],
+    tags: ["browser", "3d"]
+  },
+  {
+    id: "gpu-lock-free-queue",
+    packageName: "@plasius/gpu-lock-free-queue",
+    type: "browser",
+    mode: "3D DAG queue demo",
+    runtime: "Shared 3D harbor scene + scheduler overlays",
+    launchLabel: "Open browser demo",
+    launchPath: "../gpu-lock-free-queue/demo/",
+    sourcePath: "../gpu-lock-free-queue/demo/main.js",
+    docsPath: "../gpu-lock-free-queue/README.md",
+    command: "cd gpu-lock-free-queue && npm run demo",
+    summary: "Priority-aware DAG queue validation surfaced on top of the shared 3D harbor scene.",
+    notes: [
+      "The package now validates roots, lanes, and dependency joins on the same 3D family-owned scene used elsewhere.",
+      "Use it to inspect the queue architecture without dropping back to a 2D-only visualizer."
+    ],
+    tags: ["browser", "3d"]
+  },
+  {
+    id: "gpu-particles",
+    packageName: "@plasius/gpu-particles",
+    type: "browser",
+    mode: "3D particle contract demo",
+    runtime: "Shared 3D harbor scene + particle overlays",
+    launchLabel: "Open browser demo",
+    launchPath: "../gpu-particles/demo/",
+    sourcePath: "../gpu-particles/demo/main.js",
+    docsPath: "../gpu-particles/README.md",
+    command: "cd gpu-particles && npm run demo",
+    summary: "Particle effect manifests and snapshot policy visualized against the shared 3D harbor scene.",
+    notes: [
+      "The visual surface is shared, while the particle package still owns effect selection and worker-manifest policy.",
+      "Use it to inspect effect roots and stable-world-snapshot requirements on a mounted 3D canvas."
+    ],
+    tags: ["browser", "3d"]
+  },
+  {
+    id: "gpu-performance",
+    packageName: "@plasius/gpu-performance",
+    type: "browser",
+    mode: "3D adaptive-performance demo",
+    runtime: "3D harbor scene + governor overlays",
+    launchLabel: "Open browser demo",
+    launchPath: "../gpu-performance/demo/",
+    sourcePath: "../gpu-performance/demo/main.js",
+    docsPath: "../gpu-performance/README.md",
+    command: "cd gpu-performance && npm run demo",
+    summary: "Adaptive frame-budget governor shown against a live 3D harbor scene instead of a synthetic chart.",
+    notes: [
+      "Quality changes now have visible 3D consequences across cloth, fluid, and lighting.",
+      "Stress mode lets you watch the governor step detail down and recover."
+    ],
+    tags: ["browser", "3d"]
+  },
+  {
+    id: "gpu-physics",
+    packageName: "@plasius/gpu-physics",
+    type: "browser",
+    mode: "3D physics demo",
+    runtime: "3D harbor scene + stable snapshot overlays",
+    launchLabel: "Open browser demo",
+    launchPath: "../gpu-physics/demo/",
+    sourcePath: "../gpu-physics/demo/main.js",
+    docsPath: "../gpu-physics/README.md",
+    command: "cd gpu-physics && npm run demo",
+    summary: "Stable-world-snapshot physics validation in a 3D harbor scene with GLTF ships, authoritative collisions, and visual follow-up context.",
+    notes: [
+      "The demo now mounts a 3D browser scene instead of a CLI-only example.",
+      "Use it to inspect authoritative collision ordering, snapshot handoff, and downstream visual consumers."
+    ],
+    tags: ["browser", "3d"]
+  },
+  {
+    id: "gpu-renderer",
+    packageName: "@plasius/gpu-renderer",
+    type: "browser",
+    mode: "3D canvas demo",
+    runtime: "WebGPU canvas renderer",
+    launchLabel: "Open browser demo",
+    launchPath: "../gpu-renderer/demo/",
+    sourcePath: "../gpu-renderer/demo/main.js",
+    docsPath: "../gpu-renderer/README.md",
+    command: "cd gpu-renderer && npm run demo",
+    summary: "Mounted WebGPU canvas demo for the renderer runtime with live start, stop, and step controls.",
+    notes: [
+      "Requires localhost or HTTPS because the renderer depends on WebGPU.",
+      "This is the baseline mounted 3D canvas demo for renderer validation."
+    ],
+    tags: ["browser", "3d"]
+  },
+  {
+    id: "gpu-shared",
+    packageName: "@plasius/gpu-shared",
+    type: "browser",
+    mode: "3D shared runtime demo",
+    runtime: "Shared 3D harbor scene",
+    launchLabel: "Open browser demo",
+    launchPath: "../gpu-shared/demo/",
+    sourcePath: "../gpu-shared/demo/main.js",
+    docsPath: "../gpu-shared/README.md",
+    command: "cd gpu-shared && npm run demo",
+    summary: "The shared 3D harbor runtime demo that the family-owned browser showcases build on top of.",
+    notes: [
+      "Use this to validate the core shared scene without package-specific overlays layered on top.",
+      "This is the common 3D runtime surface used by the migrated family demos."
+    ],
+    tags: ["browser", "3d"]
+  },
+  {
+    id: "gpu-worker",
+    packageName: "@plasius/gpu-worker",
+    type: "browser",
+    mode: "3D canvas demo",
+    runtime: "WebGPU compute + 3D canvas",
+    launchLabel: "Open browser demo",
+    launchPath: "../gpu-worker/demo/",
+    sourcePath: "../gpu-worker/demo/main.js",
+    docsPath: "../gpu-worker/README.md",
+    command: "cd gpu-worker && npm run demo",
+    summary: "Instanced simulation demo showing GPU queue-driven worker jobs feeding a mounted 3D scene.",
+    notes: [
+      "Requires localhost or HTTPS because the worker pipeline depends on WebGPU.",
+      "Use it to validate high-throughput worker execution and scene output together."
+    ],
+    tags: ["browser", "3d"]
+  },
+  {
+    id: "gpu-world-generator",
+    packageName: "@plasius/gpu-world-generator",
+    type: "browser",
+    mode: "3D representation-band demo",
+    runtime: "Shared 3D harbor scene + world overlays",
+    launchLabel: "Open browser demo",
+    launchPath: "../gpu-world-generator/demo/",
+    sourcePath: "../gpu-world-generator/demo/main.js",
+    docsPath: "../gpu-world-generator/demo/README.md",
+    command: "cd gpu-world-generator && npm run demo",
+    summary: "Chunk representation and worker-manifest policy validated on a mounted 3D harbor scene.",
+    notes: [
+      "The demo is now static-server friendly and no longer relies on a bundler-only browser entry.",
+      "Use it to validate near/mid/far/horizon representation policy on the shared showcase surface."
+    ],
+    tags: ["browser", "3d"]
+  },
+  {
+    id: "gpu-xr",
+    packageName: "@plasius/gpu-xr",
+    type: "browser",
+    mode: "3D XR target demo",
+    runtime: "Shared 3D harbor scene + XR pacing overlays",
+    launchLabel: "Open browser demo",
+    launchPath: "../gpu-xr/demo/",
+    sourcePath: "../gpu-xr/demo/main.js",
+    docsPath: "../gpu-xr/README.md",
+    command: "cd gpu-xr && npm run demo",
+    summary: "XR frame-target negotiation and worker-budget hints shown against a mounted 3D harbor scene.",
+    notes: [
+      "The demo now mounts a 3D scene while gpu-xr remains responsible for target negotiation, not rendering.",
+      "Use it to compare inline versus immersive pacing policy on the family showcase."
+    ],
+    tags: ["browser", "3d"]
+  }
+];

package/wavefront/index.html

@@ -0,0 +1,112 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Wavefront Path Tracing Demo</title>
+    <link rel="icon" href="data:," />
+    <link rel="stylesheet" href="./styles.css" />
+    <script type="importmap">
+      {
+        "imports": {
+          "@plasius/gpu-renderer": "../node_modules/@plasius/gpu-renderer/dist/index.js"
+        }
+      }
+    </script>
+  </head>
+  <body>
+    <main class="wavefront-shell">
+      <section class="render-panel" aria-label="Wavefront path tracing render">
+        <div class="render-toolbar">
+          <div>
+            <p class="eyebrow">Experimental renderer path</p>
+            <h1>Wavefront Path Tracing</h1>
+          </div>
+          <div class="toolbar-actions">
+            <button id="toggleLoopButton" type="button">Pause loop</button>
+            <button id="renderButton" type="button">Render once</button>
+            <a id="captureLink" href="./?experimental=wavefront&capture=1">Capture mode</a>
+          </div>
+        </div>
+        <canvas
+          id="renderCanvas"
+          class="render-canvas"
+          width="1280"
+          height="720"
+          aria-label="WebGPU mesh BVH wavefront path tracing output"
+        ></canvas>
+        <div class="render-strip" aria-live="polite">
+          <p id="renderStatus">Preparing mesh BVH wavefront scene.</p>
+          <p id="renderMode">Feature flag: gpu.wavefrontPathTracingDemo</p>
+        </div>
+      </section>
+
+      <aside class="debug-panel" aria-label="Wavefront debug overlay">
+        <section>
+          <p class="eyebrow">Controls</p>
+          <div class="control-grid">
+            <label>
+              Max depth
+              <select id="maxDepthSelect">
+                <option value="3">3 bounces</option>
+                <option value="4">4 bounces</option>
+                <option value="5" selected>5 bounces</option>
+                <option value="6">6 bounces</option>
+                <option value="8">8 bounces</option>
+              </select>
+            </label>
+            <label>
+              Resolution
+              <select id="resolutionSelect">
+                <option value="capture">Capture</option>
+                <option value="balanced" selected>Balanced</option>
+                <option value="detail">Detail</option>
+                <option value="uhd">4K target</option>
+              </select>
+            </label>
+            <label>
+              Samples
+              <select id="samplesSelect">
+                <option value="1">1 spp</option>
+                <option value="4">4 spp</option>
+                <option value="8" selected>8 spp</option>
+                <option value="16">16 spp</option>
+              </select>
+            </label>
+            <label>
+              Post pass
+              <select id="denoiseSelect">
+                <option value="on" selected>Denoise on</option>
+                <option value="off">Raw samples</option>
+              </select>
+            </label>
+          </div>
+        </section>
+        <section>
+          <p class="eyebrow">Performance</p>
+          <div
+            id="timingStack"
+            class="timing-stack"
+            role="img"
+            aria-label="Frame timing breakdown"
+          ></div>
+          <ol id="timingLegend" class="timing-legend"></ol>
+          <dl id="performanceStats" class="metric-grid performance-grid"></dl>
+        </section>
+        <section>
+          <p class="eyebrow">Termination</p>
+          <dl id="terminationStats" class="metric-grid"></dl>
+        </section>
+        <section>
+          <p class="eyebrow">Bounce queue</p>
+          <div id="bounceRows" class="bounce-list"></div>
+        </section>
+        <section>
+          <p class="eyebrow">Renderer contract</p>
+          <dl id="contractStats" class="contract-list"></dl>
+        </section>
+      </aside>
+    </main>
+    <script type="module" src="./main.js?v=mesh-bvh-renderer-performance-2"></script>
+  </body>
+</html>