@plasius/gpu-shared 0.1.11 → 0.1.14

package/CHANGELOG.md

@@ -5,13 +5,68 @@ All notable changes to this project will be documented in this file.
 ## [Unreleased]
 
 - **Added**
-  - (placeholder)
+  - Deterministic showcase asset generation for a richer shared brigantine,
+    cutter, lighthouse, and harbor-dock catalog.
+  - Fullscreen capture mode for slide-deck screenshots and video recording,
+    including scene-only layout and bounded 1080p canvas scaling.
+  - Bundled `en-GB` translation keys and dictionaries for shared showcase labels
+    that can be consumed through `@plasius/translations`.
+  - Added Product Studio mode routing for `mountGpuShowcase(...)`, including
+    Eames GLTF loading, source triangle mesh submission, and
+    delegation to the `@plasius/gpu-renderer` WebGPU wavefront renderer.
 
 - **Changed**
-  - (placeholder)
+  - Documented that project-wide display-quality path tracing requires renderer
+    mesh BVH intersections and triangle normals; bounded model proxies are now
+    disabled rather than exposed as a debug bridge.
+  - Product Studio now submits GLTF primitive mesh inputs to the renderer with
+    `displayQuality: true` instead of submitting analytic scene objects.
+  - Product Studio wavefront rendering now consumes
+    `@plasius/gpu-lighting` environment presets when available instead of
+    relying only on local hardcoded environment colours.
+  - Product Studio now defaults to 8 wavefront samples per pixel for the Eames
+    quality benchmark and uses a rough studio floor to avoid unresolved
+    low-sample reflection noise dominating the preview.
+  - Product Studio now preserves a 16:9 canvas presentation ratio inside
+    flexible host layouts so benchmark renders are not stretched by non-16:9
+    containers.
+  - Refactored feature loading so `@plasius/gpu-shared` uses injectable
+    `__showcaseFeatureLoaders` for cloth/fluid/lighting/performance/debug/
+    physics contracts and no longer imports sibling feature packages directly.
+  - Routed showcase chrome and debug allocation labels through package-owned
+    translation keys with an optional consumer translator override.
+  - Expanded the shared GLTF loader contract to preserve the legacy flattened
+    mesh fields while exposing transformed multi-primitive/material data for the
+    realistic showcase scene.
+  - The shared harbor runtime now renders distinct ship models and modeled
+    harbor structures instead of one tiny hull mesh plus placeholder boxes.
+  - Showcase lighting now adds local lantern response, a lighthouse beam pass,
+    and a subtle atmospheric grade for more realistic recorded frames.
+  - Declared `@plasius/gpu-renderer` as an optional Product Studio peer instead
+    of a harbor/showcase hard dependency.
 
 - **Fixed**
-  - (placeholder)
+  - Restored the package CD workflow so protected `main` releases are prepared by PR and published without direct branch pushes.
+  - The shared showcase now propagates the realistic-model feature flag into
+    scene state and initializes its DOM scaffold before canvas setup, allowing
+    the local realistic asset catalog to mount in browser demos.
+  - Generated cylindrical showcase geometry now emits outward-facing side
+    winding, so towers, posts, masts, and lanterns no longer carry inverted side
+    normals.
+  - Generated cylindrical showcase geometry now carries smooth radial side
+    normals, reducing the faceted placeholder look on lighthouse bands, masts,
+    posts, and lantern glass.
+  - The showcase renderer now culls with geometric face normals while shading
+    with smoothed asset normals, keeping curved surfaces stable at glancing
+    camera angles.
+  - The generated lighthouse, mast, lantern, and dock-post assets now use denser
+    radial geometry for cleaner silhouettes in recording shots.
+  - Showcase shading now applies subtle deterministic material grain and
+    lower-surface wear so wood, stone, painted hulls, and plaster read less like
+    flat placeholder fills.
+  - Low-lying ship triangles no longer pick up the water reflection term just
+    because they are near the shoreline plane, so hulls stop reading like
+    reflective water surfaces.
 
 - **Security**
   - (placeholder)

package/README.md

@@ -23,16 +23,22 @@ npm install @plasius/gpu-shared
 
 - Moves shared 3D showcase/demo runtime ownership out of `gpu-demo-viewer`.
 - Provides one package home for GLTF loading and harbor/showcase mounting.
-- Reuses `@plasius/gpu-cloth`, `@plasius/gpu-fluid`, `@plasius/gpu-lighting`,
-  `@plasius/gpu-performance`, `@plasius/gpu-debug`, and browser-safe physics
-  planning from `@plasius/gpu-physics/browser`.
+- Coordinates cloth, fluid, lighting, performance, debug, and physics integration
+  through explicit feature adapters supplied by family packages at mount time.
 - Keeps package demos aligned on the same family-owned scene contract instead of
   carrying duplicated runtime copies.
 - Preserves one shared fix point for cloth motion, visible water continuity, and
   occluded harbor-light reflections across GPU demo consumers.
+- Ships a package-owned showcase asset catalog with distinct brigantine,
+  cutter, lighthouse, and harbor-dock models instead of relying on one tiny
+  hull mesh plus placeholder box geometry.
 
 ## Usage
 
+The package remains feature-contract neutral at install time; family packages
+inject domain contracts through `__showcaseFeatureLoaders` so `gpu-shared` does
+not hard-reference package-private imports.
+
 ```js
 import { mountGpuShowcase } from "@plasius/gpu-shared";
 
@@ -47,6 +53,84 @@ const showcase = await mountGpuShowcase({
 showcase.destroy();
 ```
 
+```js
+await mountGpuShowcase({
+  packageName: "@plasius/gpu-cloth",
+  __showcaseFeatureLoaders: {
+    cloth: () => import("@plasius/gpu-cloth/dist/index.js"),
+  },
+});
+```
+
+### Showcase Translations
+
+The shared showcase owns its display keys and bundled `en-GB` defaults without
+making the browser runtime React-bound. Consumers that already use
+`@plasius/translations` can register the package dictionary and pass a
+translator into `mountGpuShowcase`:
+
+```js
+import { createI18n } from "@plasius/translations";
+import {
+  gpuSharedTranslationKeys,
+  gpuSharedTranslations,
+  mountGpuShowcase,
+} from "@plasius/gpu-shared";
+
+const i18n = createI18n({
+  language: "en-GB",
+  fallback: "en-GB",
+  translations: gpuSharedTranslations,
+});
+
+await mountGpuShowcase({
+  root: document.getElementById("app"),
+  translate: (key, args) => i18n.t(key, args),
+});
+
+console.log(i18n.t(gpuSharedTranslationKeys.debugMainColorBuffer));
+```
+
+### Product Studio Mode
+
+Consumers can route the shared showcase entrypoint to Product Studio by passing
+`demoMode: "product-studio"` and a Product Studio GLTF URL. This mode loads the
+model with the shared GLTF loader and delegates GPU execution to
+`@plasius/gpu-renderer`.
+Product Studio submits source triangle mesh data to the renderer. Display-quality
+path tracing anywhere in the project requires the renderer mesh BVH path so ray
+hits use source triangles, barycentric data, geometric normals, and interpolated
+vertex normals for bounce decisions.
+When `@plasius/gpu-lighting` exposes `createWavefrontEnvironmentLightingOptions`,
+Product Studio uses the lighting-owned `product-studio` environment preset;
+older installed lighting packages fall back to the previous local colours.
+The shared Product Studio adapter defaults to 8 samples per pixel for the
+Eames-quality benchmark render and uses a rough studio floor so the current
+single-frame preview is not dominated by unresolved low-sample reflection
+noise. The Product Studio canvas preserves a 16:9 presentation ratio inside
+flexible host layouts so the rendered product is not stretched by non-16:9
+containers.
+
+```js
+import { mountGpuShowcase } from "@plasius/gpu-shared";
+
+await mountGpuShowcase({
+  root: document.getElementById("app"),
+  demoMode: "product-studio",
+  productAssetUrl:
+    "/data/models/eames-lounge-chair-ottoman/Eames_Lounge_Chair_Ottoman.gltf",
+  samplesPerPixel: 8,
+});
+```
+
+The legacy analytic proxy scene-object path is disabled and is not a customer
+visible fallback. Stale callers must move to `createProductStudioMeshes(...)`
+or `mountGpuShowcase({ demoMode: "product-studio" })`, both of which use mesh
+inputs for renderer-owned BVH construction.
+
+Install `@plasius/gpu-renderer` alongside `@plasius/gpu-shared` when Product
+Studio mode is used. Harbor-only consumers do not need the renderer peer.
+
 For browser-only demos served without a bundler, keep the import surface on the
 published package name and resolve it with an import map rather than importing a
 viewer-private or workspace-private source file:
@@ -71,10 +155,13 @@ import {
 } from "@plasius/gpu-shared";
 
 const shipUrl = resolveShowcaseAssetUrl();
+const lighthouseUrl = resolveShowcaseAssetUrl("lighthouse");
 const shipModel = await loadGltfModel(shipUrl);
+const lighthouseModel = await loadGltfModel(lighthouseUrl);
 
 console.log(showcaseFocusModes);
 console.log(shipModel.physics);
+console.log(shipModel.primitives.length, lighthouseModel.primitives.length);
 ```
 
 ## Demo
@@ -95,6 +182,16 @@ the banded `@plasius/gpu-fluid` continuity envelope directly, so the default
 camera keeps finite, visibly animated near-band water motion instead of
 flattening or dropping the shared water mesh.
 
+The default showcase asset set now uses a multi-primitive brigantine, a
+distinct cutter profile, a modeled lighthouse, and a modeled dock/warehouse
+scene so the harbor reads closer to a believable coastal night view on high-end
+machines.
+
+For slide-deck screenshots or video capture, open the route with
+`?capture=1&renderScale=1`. Capture mode hides the validation chrome, fills the
+viewport with the scene canvas, and caps the backing buffer at 1080p by default
+so recording stays smooth on local machines.
+
 ## Current Boundary
 
 `@plasius/gpu-shared` owns the shared browser/demo orchestration surface. It
@@ -107,10 +204,19 @@ surface for these family demos.
 
 - `mountGpuShowcase(options)`
   - Returns `{ state, shipModel, canvas, destroy() }`
+  - `captureMode: true` enables fullscreen scene-only presentation for local
+    screenshots and video capture.
+  - `renderScale` overrides the canvas backing scale when a capture workflow
+    needs a specific quality/performance balance.
 - `loadGltfModel(url)`
-- `resolveShowcaseAssetUrl(baseUrl?)`
+- `resolveShowcaseAssetUrl(baseUrlOrAssetName?, assetName?)`
 - `showcaseFocusModes`
 
+`resolveShowcaseAssetUrl()` keeps consumers on the package-owned brigantine
+asset URL. If a host cannot actually serve that asset, `loadGltfModel()`
+lazily activates the built-in inline fallback instead of eagerly parsing that
+payload in the top-level package entrypoint.
+
 ## Development
 
 ```bash