@plasius/gpu-demo-viewer 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -18,6 +18,20 @@ The format is based on Keep a Changelog and this project adheres to SemVer.
 - **Security**
   - (placeholder)
 
+## [0.2.3] - 2026-10-21
+
+- **Added**
+  - Relic collection and tool-chest composite studies using five credited originals each, with shared camera and render-quality controls.
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
 ## [0.2.2] - 2026-10-21
 
 - **Added**
@@ -323,3 +337,4 @@ The format is based on Keep a Changelog and this project adheres to SemVer.
 [0.2.0]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.2.0
 [0.2.1]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.2.1
 [0.2.2]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.2.2
+[0.2.3]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.2.3

package/README.md

@@ -63,15 +63,19 @@ or enabled on the production site. The download helper admits only configured
 resources and keeps two workers, a 100 MiB per-file limit and a 200 MiB batch limit.
 Source, creator, licence and review notes appear beside each model.
 
-Two composite studies appear after the individual models in **Choose a model or
-study**: a furnished interior and a workshop still life. They arrange four and
-five credited originals under shared lighting and one camera. They are additional
+Four composite studies appear after the individual models in **Choose a model or
+study**: a furnished interior, workshop still life, relic collection and tool-chest
+arrangement. They arrange four or five credited originals under shared lighting
+and one camera. They are additional
 views of existing models rather than additional source assets. Each
 study lists its sources, licences and chosen dimensions; these are static review
 arrangements, not verified physical-scale scenes. See the
 [composite study guide](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/docs/composite-model-studies.md).
 Keep `?review=first-twelve` in the local URL and append
-`&model=study-furnished-interior` or `&model=study-workshop` to bookmark a study.
+`&model=study-furnished-interior`, `&model=study-workshop`,
+`&model=study-relic-collection` or `&model=study-tool-chest` to bookmark a study.
+The [relic and tool study guide](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/docs/relic-and-tool-composites.md)
+describes the newer arrangements and their qualification.
 
 ## Camera and render quality
 

package/docs/relic-and-tool-composites.md

@@ -0,0 +1,59 @@
+# Relic collection and tool-chest studies
+
+Tracked work: site Story #2316 and viewer Task #80.
+
+Extend the local model workshop with two arrangements of qualified originals
+from the 61-model catalogue. Reuse `gpu-shared` 1.2.0 `createSceneInspection`
+and renderer 0.2.54; ADR 0006 continues to apply. No new renderer, material
+substitution, asset acquisition or architecture boundary is required.
+
+The relic collection brings Gothic Statue, Marble Bust, Chess Set, Kite Shield
+and Antique Estoc into shared light to compare stone, carved detail and metal.
+The tool-chest arrangement brings Metal Tool Chest, Hand Plane, Vintage Hand
+Drill, Rusted Spade and Rusted Can together to compare painted metal, rust,
+wood and small contact shadows. Chosen dimensions and placement are illustrative,
+not surveyed physical dimensions. Both arrangements use the shared neutral floor.
+
+Feature site#1170 and Epic site#2271 govern this work. Inherit the remotely
+controlled `gpu-demo.scene-fidelity.enabled` flag and existing localhost-only
+review override. No public-site navigation is introduced by these local studies.
+Rollback is selection of an individual model, disabling the existing review
+entry, or reverting this viewer release; source originals remain available.
+
+Before implementation, test both exact source sets, complete integrity manifests,
+source attribution, safe incomplete-catalogue exclusion, and continued existing
+scene selection. Keep shared six-source, geometry and texture budgets unchanged.
+Exercise the existing shared camera, sampling, denoising, cancellation and cleanup
+through the viewer tests and real WebGPU review. Require fixed64, camera reset
+and refinement, denoising off/on, native UHD1, and a 320px reflow check. Record
+failures honestly; completed UHD1 is not optical or real-time qualification.
+
+Update consumer README and Unreleased changelog, maintain >=80% coverage and
+changed-source LCOV, and pass tests, types/lint, build, package and audit checks.
+Publish only through main `cd.yml` with the production environment after CI.
+Verify the exact npm artifact before closing tracked work. The separate site
+61-model deployment and original-model holds remain tracked independently.
+
+## Registry-based review, 21 October 2026
+
+Both arrangements rendered with released shared 1.2.0 and renderer 0.2.54,
+without source overrides. The relic collection has 140,669 triangles, 44 mesh
+primitives and eight source materials; the tool scene has 44,876 triangles,
+16 primitives and five materials. Both totals include the shared ground.
+
+Both completed fixed64 at 800 × 282, keyboard camera movement followed by
+refinement, denoising off/on and native 3840 × 2160 at one sample. Both returned
+to balanced resolution. At a 320px viewport each completed fixed64 at 800 × 601,
+with all five originals visible and no horizontal document overflow, including
+expanded source credits. The viewport was reset afterwards. Mouse orbit and
+keyboard Home were also checked on the relic arrangement.
+
+One DOM keyboard action immediately after viewport restoration exceeded the
+automation input deadline; the page remained responsive, native Home input
+restarted sampling and refinement completed. Quality changes still rebuild the
+scene for several seconds. No renderer console warnings/errors were recorded.
+These are functional static-scene checks, not reference optical fidelity,
+animation playback, physical-touch or screen-reader-speech qualification.
+
+All 59 viewer tests pass; line coverage and changed `scenes.js` coverage are
+100%. Types/lint, build, package validation and the full dependency audit pass.

package/model-library/scenes.js

@@ -22,6 +22,26 @@ const definitions = [
       // uniformly scaled to its chosen 1.2-unit longest dimension.
       ['brass_blowtorch', [0, .47735, .7], .55, 0],
     ] },
+  { key: 'study-relic-collection', name: 'Relic collection',
+    renderer_target: 'Compare carved stone, chess pieces and aged metal under shared light.',
+    preparation: 'Inspect silhouette, surface detail and contact shadows across five originals. Dimensions are illustrative scene units.',
+    placements: [
+      ['gothic_statue', [-1.2, 0, -.7], 1.8, .15],
+      ['marble_bust_01', [.65, 0, -.7], .85, -.25],
+      ['chess_set', [0, 0, .8], 1.15, .1],
+      ['kite_shield', [1.5, 0, .15], 1.15, -.4],
+      ['antique_estoc', [-1.5, 0, .8], 1.25, .25],
+    ] },
+  { key: 'study-tool-chest', name: 'Tool-chest arrangement',
+    renderer_target: 'Compare painted metal, rust and wooden handles in one working collection.',
+    preparation: 'Inspect relative scale, worn surfaces and small contact shadows. These are static originals placed on a shared inspection floor.',
+    placements: [
+      ['metal_tool_chest', [0, 0, -.8], 1.7, 0],
+      ['hand_plane_no4', [-.65, 0, .8], .5, -.25],
+      ['vintage_hand_drill', [.25, 0, .9], .55, .3],
+      ['rusted_spade_01', [1.25, 0, .05], 1.5, -.3],
+      ['can_rusted', [-1.25, 0, .2], .4, 0],
+    ] },
 ];
 
 export function compositeStudies(assets) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasius/gpu-demo-viewer",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "type": "module",
   "description": "Root validation viewer for Plasius gpu-* demos.",
   "license": "Apache-2.0",