@plasius/gpu-shared 0.1.11 → 0.1.13

package/CHANGELOG.md

@@ -5,13 +5,46 @@ 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`.
 
 - **Changed**
-  - (placeholder)
+  - 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.
 
 - **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

@@ -30,6 +30,9 @@ npm install @plasius/gpu-shared
   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
 
@@ -47,6 +50,35 @@ const showcase = await mountGpuShowcase({
 showcase.destroy();
 ```
 
+### 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));
+```
+
 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 +103,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 +130,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 +152,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